August 2023

🔍 Summary

August delivered key architectural upgrades, improved helper documentation and usability, and aligned macro tooling more closely with modern API and UX standards. This month also brought fixes for serious errors affecting macro creation, saving, and dynamic content loading.

✨ New Features & Enhancements

• Helpers Tree Structure + Documentation
  Helpers are now organized into a structured tree with categories like arrays, strings, confluence, and jira. All embedded helpers are documented and displayed within the Helper panel for easier discovery.

• Helper Renaming and Search Optimization
  Helpers were renamed to follow camelCase and Atlassian-style conventions (e.g., findPagesByLabel → getPagesForLabel). Search is now case-insensitive for improved usability.

• Library Tab Now Uses Library Application
  The Macro Library tab was refactored to communicate with the standalone Macro Library App, improving performance, decoupling logic, and aligning with future scalability plans.

• Smart Value Copy-Paste UX Fix
  User parameters now copy using the correct syntax: {{parameters.userParameter}} instead of the ambiguous {{userParameter}}.

• Expanded Helper Display Area
  Increased the width of the helper block to make long or complex helper documentation easier to read.

• Get Space Permissions Helper
  Implemented getSpacePermissions, based on Confluence Cloud’s new v2 REST API, enabling macro authors to retrieve detailed space-level access information dynamically.

• User-Facing UI Refinements

  • Ctrl+S Saves Templates: You can now use Ctrl+S to save templates directly, mimicking common IDE shortcuts.

  • My Macros Ordered by Last Updated: Macros are now sorted by updatedAt for better visibility into recent edits.

  • Hide Macro Size Fields: Removed fields related to width/height size from the macro creation form to streamline the experience.

🛠 Bug Fixes & Improvements

• Fix: 500 Error on Macro Save
  Resolved a crash when saving complex macros like Health Check, particularly those using advanced template logic and external icon rendering.

• Fix: Request Helper Failing (400 Error)
  Resolved issues where the request helper failed with valid URLs due to improper input validation or header processing.

• Fix: Request Helper Crashes on Non-JSON Response
  Added fallback handling when API responses are not in JSON format (e.g., XML). These now display as raw content instead of crashing the render.

• Fix: updatedAt Field Should Not Change on View
  Ensured macro metadata like updatedAt is only updated on actual edits — not passive page views — to maintain accuracy.

• Fix: Missing Helpers (e.compileTemplate Error)
  Addressed a loading issue during macro creation/editing where helper functions failed to load due to a e.compileTemplate error.

• Fix: UI/UX Issues on Import Dialog
  Improved the macro import UI to prevent submission without a selected file and enhanced user feedback during file interactions.