feat: blobs fetch

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

src/services/entityService.ts

@@ -28,6 +28,9 @@ import type {
   EntityPatchResponse,
   EntityPatchRequest,
   EntityDownloadRequest,
+  EntityBlobsRequest,
+  EntityBlobsResponse,
+  EntityBlobsWireResponse,
 } from '../types/entity';
 import { useIntegrationStore } from '@KTXC/stores/integrationStore';
 import { EntityObject } from '../models';
@@ -227,6 +230,36 @@ export const entityService = {
   download(request: EntityDownloadRequest): { transaction: string } {
     return transceiveDownload<EntityDownloadRequest>('entity.download', request);
   },
+
+  /**
+   * Fetch one or more message parts (attachments) inline for rendering.
+   *
+   * Returns JSON with base64-encoded bytes; each result is decoded into a Blob
+   * so callers can create object URLs for preview.
+   */
+  async blobs(request: EntityBlobsRequest): Promise<EntityBlobsResponse> {
+    const wire = await transceivePost<EntityBlobsRequest, EntityBlobsWireResponse>(
+      'entity.blobs',
+      request,
+    );
+    return wire.map((result) => ({
+      source: result.source,
+      part: result.part,
+      mime: result.mime,
+      filename: result.filename,
+      blob: base64ToBlob(result.bytes, result.mime),
+    }));
+  },
 };
 
+/** Decode base64 content into a Blob of the given MIME type. */
+function base64ToBlob(base64: string, mime: string): Blob {
+  const binary = atob(base64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return new Blob([bytes], { type: mime });
+}
+
 export default entityService;

src/stores/entitiesStore.ts

@@ -8,6 +8,7 @@ import { entityService } from '../services'
 import { EntityObject, MessageObject } from '../models'
 import type {
   EntityBlobSelector,
+  EntityBlobsResponse,
   EntityDownloadRequest,
   EntityTransmitRequest,
   EntityTransmitResponse,
@@ -508,6 +509,21 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
     }
   }
 
+  /**
+   * Fetch one or more message parts (attachments) inline as Blobs, for preview.
+   */
+  async function blobs(
+    target: EntityIdentifier,
+    parts: EntityBlobSelector[],
+  ): Promise<EntityBlobsResponse> {
+    try {
+      return await entityService.blobs({ target, parts })
+    } catch (error: any) {
+      console.error('[Mail Manager][Store] - Failed to fetch attachment blobs:', error)
+      throw error
+    }
+  }
+
   // Return public API
   return {
     // State (readonly)
@@ -530,5 +546,6 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
     move,
     transmit,
     download,
+    blobs,
   }
 })

src/types/entity.ts

@@ -227,9 +227,17 @@ export interface EntityBlobsRequest {
   parts: EntityBlobSelector[];
 }
 
-export interface EntityBlobsResult {
+export interface EntityBlobsWireResult {
   source: EntityIdentifier;
   part: EntityBlobSelector;
+  mime: string;
+  filename: string;
+  bytes: string;
+}
+
+export interface EntityBlobsWireResponse extends Array<EntityBlobsWireResult> {}
+
+export interface EntityBlobsResult extends Omit<EntityBlobsWireResult, 'bytes'> {
   blob: Blob;
 }