Media, Storage, and Artifacts

Delivery outputs depend on reliable access to proposal media. Ghloria uses scoped storage and artifact routes so images, templates, and supporting files can be reused across proposal editing, email export, and PowerPoint export.

Media Manager

The proposal builder includes a media manager for image-based blocks. It supports:

• Uploading image files
• Drag-and-drop image upload
• Pasting images from the clipboard
• Searching Unsplash when configured
• Adding image URLs directly
• Selecting one or multiple images depending on the block
• Choosing display modes for image blocks, including carousel and bento-style layouts

Uploaded images are stored as proposal version artifacts when the block is connected to a proposal and version. The editor keeps a storage reference so the same image can be resolved later for export.

Artifact Scopes

Ghloria exposes artifact routes for several operational scopes:

• Proposal version artifacts
• Client artifacts
• Trip artifacts
• Supplier artifacts

Artifacts can be listed, uploaded, deleted, and moved between folders. Proposal version artifacts are especially important for delivery because they provide image and file references used by the proposal builder and export services.

Storage Object Access

Storage object routes support authenticated read and delete operations for scoped objects. Supported object kinds include:

• user
• company
• client
• template
• proposal

The object route returns files inline with inferred image content types when possible. It can also proxy an external image source for inline use when a valid source URL is supplied.

Upload Initialization

For direct storage uploads, Ghloria requests an upload target using file name, size, MIME type, object kind, and path. The returned upload transport is then used to send the file to storage before the backend finalizes the related record.

This pattern is used for template uploads and is also available for other storage-backed workflows.

Unsplash and External Images

When Unsplash is configured, users can search for images from the media manager. Selected Unsplash assets can be downloaded, tracked through the Unsplash API, uploaded into proposal version artifacts, and then referenced by the proposal content.

Direct image URLs can also be selected in the media manager. For generated outputs, images are resolved from stored artifacts or URLs where the export path supports them.

How Media Reaches Exports

Email export resolves cover images, company logos, and agent photos before rendering. PowerPoint export can collect image artifact references from proposal content, fetch current version artifact URLs, convert eligible images to base64, and include them in the PPTX generation payload.

This keeps delivery files aligned with the proposal content instead of relying on manual image replacement after export.