vintasend-medplum 0.4.19 → 0.5.0

package/dist/medplum-attachment-manager.d.ts

@@ -1,6 +1,6 @@
 import { MedplumClient } from '@medplum/core';
 import { BaseAttachmentManager } from 'vintasend/dist/services/attachment-manager/base-attachment-manager';
-import type { AttachmentFileRecord, AttachmentFile, FileAttachment } from 'vintasend/dist/types/attachment';
+import type { AttachmentFileRecord, AttachmentFile, FileAttachment, StorageIdentifiers } from 'vintasend/dist/types/attachment';
 /**
  * Medplum AttachmentManager implementation.
  *
@@ -38,12 +38,16 @@ export declare class MedplumAttachmentManager extends BaseAttachmentManager {
      */
     deleteFile(fileId: string): Promise<void>;
     /**
-     * Reconstruct an AttachmentFile from storage metadata.
+     * Delete a file from Medplum storage using storage identifiers.
+     */
+    deleteFileByIdentifiers(storageIdentifiers: StorageIdentifiers): Promise<void>;
+    /**
+     * Reconstruct an AttachmentFile from storage identifiers.
      *
-     * @param storageMetadata - Metadata containing 'binaryId' or 'url'
+     * @param storageIdentifiers - MedplumStorageIdentifiers containing 'medplumBinaryId' or 'url'
      * @returns AttachmentFile instance for accessing the file
      */
-    reconstructAttachmentFile(storageMetadata: Record<string, unknown>): AttachmentFile;
+    reconstructAttachmentFile(storageIdentifiers: StorageIdentifiers): AttachmentFile;
 }
 /**
  * Medplum AttachmentFile implementation.

package/dist/medplum-attachment-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"medplum-attachment-manager.d.ts","sourceRoot":"","sources":["../src/medplum-attachment-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAC3G,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,cAAc,EACf,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,qBAAqB;IACrD,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAI1C;;;;;;;OAOG;IACG,UAAU,CACd,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAkEhC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA+CnE;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/C;;;;;OAKG;IACH,yBAAyB,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;CAiBpF;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAExD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM;IAG1B;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IA4C7B;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAUvC;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}
+{"version":3,"file":"medplum-attachment-manager.d.ts","sourceRoot":"","sources":["../src/medplum-attachment-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAC3G,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AAGzC;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,qBAAqB;IACrD,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAI1C;;;;;;;OAOG;IACG,UAAU,CACd,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAqEhC;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAkDnE;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB/C;;OAEG;IACG,uBAAuB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IASpF;;;;;OAKG;IACH,yBAAyB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,cAAc;CAiBlF;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAExD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM;IAG1B;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IA4C7B;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAUvC;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAWtC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B"}

package/dist/medplum-attachment-manager.js

@@ -64,17 +64,19 @@ export class MedplumAttachmentManager extends BaseAttachmentManager {
             },
         };
         const createdMedia = await this.medplum.createResource(media);
+        const storageIdentifiers = {
+            id: createdMedia.id,
+            medplumBinaryId: createdBinary.id,
+            medplumMediaId: createdMedia.id,
+            url: binaryUrl,
+        };
         return {
             id: createdMedia.id,
             filename,
             contentType: finalContentType,
             size: buffer.length,
             checksum,
-            storageMetadata: {
-                url: binaryUrl,
-                binaryId: createdBinary.id,
-                creation: createdMedia.content.creation,
-            },
+            storageIdentifiers,
             createdAt: createdMedia.meta?.lastUpdated ? new Date(createdMedia.meta.lastUpdated) : new Date(),
             updatedAt: createdMedia.meta?.lastUpdated ? new Date(createdMedia.meta.lastUpdated) : new Date(),
         };
@@ -104,17 +106,19 @@ export class MedplumAttachmentManager extends BaseAttachmentManager {
             // Extract checksum from identifier
             const checksumIdentifier = media.identifier?.find((id) => id.system === 'http://vintasend.com/fhir/attachment-checksum');
             const checksum = checksumIdentifier?.value || '';
+            const storageIdentifiers = {
+                id: media.id,
+                medplumBinaryId: binaryId || '',
+                medplumMediaId: media.id,
+                url: media.content.url || '',
+            };
             return {
                 id: media.id,
                 filename: media.content.title || 'untitled',
                 contentType: media.content.contentType || 'application/octet-stream',
                 size: media.content.size || 0,
                 checksum,
-                storageMetadata: {
-                    url: media.content.url,
-                    binaryId: binaryId,
-                    creation: media.content.creation,
-                },
+                storageIdentifiers,
                 createdAt: media.meta?.lastUpdated ? new Date(media.meta.lastUpdated) : new Date(),
                 updatedAt: media.meta?.lastUpdated ? new Date(media.meta.lastUpdated) : new Date(),
             };
@@ -153,22 +157,32 @@ export class MedplumAttachmentManager extends BaseAttachmentManager {
         await this.medplum.deleteResource('Media', fileId);
     }
     /**
-     * Reconstruct an AttachmentFile from storage metadata.
+     * Delete a file from Medplum storage using storage identifiers.
+     */
+    async deleteFileByIdentifiers(storageIdentifiers) {
+        if (storageIdentifiers.id && typeof storageIdentifiers.id === 'string') {
+            await this.deleteFile(storageIdentifiers.id);
+            return;
+        }
+        throw new Error('Invalid storage identifiers: missing id');
+    }
+    /**
+     * Reconstruct an AttachmentFile from storage identifiers.
      *
-     * @param storageMetadata - Metadata containing 'binaryId' or 'url'
+     * @param storageIdentifiers - MedplumStorageIdentifiers containing 'medplumBinaryId' or 'url'
      * @returns AttachmentFile instance for accessing the file
      */
-    reconstructAttachmentFile(storageMetadata) {
-        let binaryId = storageMetadata.binaryId;
-        // If binaryId not provided directly, try to extract from url
-        if (!binaryId && storageMetadata.url && typeof storageMetadata.url === 'string') {
-            const match = storageMetadata.url.match(/Binary\/([^/]+)/);
+    reconstructAttachmentFile(storageIdentifiers) {
+        let binaryId = storageIdentifiers.medplumBinaryId;
+        // If medplumBinaryId not provided directly, try to extract from url
+        if (!binaryId && storageIdentifiers.url && typeof storageIdentifiers.url === 'string') {
+            const match = storageIdentifiers.url.match(/Binary\/([^/]+)/);
             if (match) {
                 binaryId = match[1];
             }
         }
         if (!binaryId) {
-            throw new Error('Storage metadata must contain binaryId or a url with Binary reference');
+            throw new Error('Storage identifiers must contain medplumBinaryId or a url with Binary reference');
         }
         return new MedplumAttachmentFile(this.medplum, binaryId);
     }

package/dist/medplum-backend.d.ts

@@ -55,9 +55,16 @@ export declare class MedplumNotificationBackend<Config extends BaseNotificationT
     getAllOneOffNotifications(): Promise<DatabaseOneOffNotification<Config>[]>;
     getOneOffNotifications(page: number, pageSize: number): Promise<DatabaseOneOffNotification<Config>[]>;
     /**
-     * Helper: Convert FileAttachment to Buffer
+     * Store an attachment file record in the backend's database (Media resource).
+     * This is called after the AttachmentManager uploads a file and returns storageIdentifiers.
+     * The backend stores file metadata along with the storageIdentifiers for later retrieval.
      */
-    private fileToBuffer;
+    storeAttachmentFileRecord(record: AttachmentFileRecord): Promise<void>;
+    /**
+     * Get an attachment file record from the backend's database.
+     * Reads the Media resource created by storeAttachmentFileRecord().
+     */
+    getAttachmentFileRecord(fileId: string): Promise<AttachmentFileRecord | null>;
     /**
      * Helper: Convert FHIR Media resource to AttachmentFileRecord
      * Extracts metadata directly from the Media resource using the same logic as MedplumAttachmentManager.getFile
@@ -68,10 +75,9 @@ export declare class MedplumNotificationBackend<Config extends BaseNotificationT
      */
     private createFhirAttachment;
     /**
-     * Helper: Create MedplumAttachmentFile from storage metadata
+     * Helper: Create MedplumAttachmentFile from storage identifiers
      */
     private createMedplumAttachmentFile;
-    getAttachmentFile(fileId: string): Promise<AttachmentFileRecord | null>;
     findAttachmentFileByChecksum(checksum: string): Promise<AttachmentFileRecord | null>;
     /**
      * Find multiple attachment files by their checksums in a single query
@@ -80,9 +86,14 @@ export declare class MedplumNotificationBackend<Config extends BaseNotificationT
     /**
      * Helper: Process attachments and return payload items
      * Optimizes by batching checksum lookups
+     * Works with any AttachmentManager implementation
      */
     private processAttachments;
     deleteAttachmentFile(fileId: string): Promise<void>;
+    /**
+     * Check if a file is referenced by any active notifications
+     */
+    private isFileReferencedByNotifications;
     getOrphanedAttachmentFiles(): Promise<AttachmentFileRecord[]>;
     getAttachments(notificationId: Config['NotificationIdType']): Promise<StoredAttachment[]>;
     deleteNotificationAttachment(notificationId: Config['NotificationIdType'], attachmentId: string): Promise<void>;

package/dist/medplum-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"medplum-backend.d.ts","sourceRoot":"","sources":["../src/medplum-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAChH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yEAAyE,CAAC;AACvH,OAAO,KAAK,EAEV,oBAAoB,EAGpB,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,2CAA2C,CAAC;AAEnD,KAAK,iCAAiC,GAAG;IACvC,oCAAoC,CAAC,EAAE,MAAM,CAAC;CAC/C,CAAC;AAGF,qBAAa,0BAA0B,CAAC,MAAM,SAAS,0BAA0B,CAAE,YAAW,uBAAuB,CAAC,MAAM,CAAC;IAI/G,OAAO,CAAC,OAAO;IAAiB,OAAO,CAAC,OAAO;IAH3D,OAAO,CAAC,iBAAiB,CAAC,CAAwB;IAClD,OAAO,CAAC,MAAM,CAAC,CAAa;gBAER,OAAO,EAAE,aAAa,EAAU,OAAO,GAAE,iCAE5D;IAED;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI7D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAItC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,yBAAyB;IA8D3B,0BAA0B,IAAI,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;IAQxE,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;IAYnG,yBAAyB,IAAI,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;IAUvE,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;IAYlG,iCAAiC,CACrC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,GACpC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IAapC,8BAA8B,CAClC,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IAepC,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAmDnG,yBAAyB,CAC7B,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GAC9D,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAiBlC,mBAAmB,IAAI,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;IAOjE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;IAS5F,wBAAwB,CAC5B,aAAa,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,GACrD,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC;IAqCpC,UAAU,CACd,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,cAAc,UAAO,GACpB,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAmBrC,YAAY,CAChB,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,cAAc,UAAO,GACpB,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAmBrC,UAAU,CACd,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,WAAW,UAAO,GACjB,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAYlC,kBAAkB,CAAC,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,eAAe,CACnB,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAE5C,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAS5C,iCAAiC,CACrC,gBAAgB,EAAE,MAAM,CAAC,YAAY,CAAC,GACrC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IAWpC,8BAA8B,CAClC,gBAAgB,EAAE,MAAM,CAAC,YAAY,CAAC,EACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IAapC,4BAA4B,CAAC,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA0BvG,gBAAgB,CAAC,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtG,yBAAyB,CAC7B,YAAY,EAAE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GACxD,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAsDxC,+BAA+B,CACnC,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GACpE,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAiBxC,qBAAqB,CACzB,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAU/C,yBAAyB,IAAI,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;IAO1E,sBAAsB,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;IAWhD;;OAEG;YACW,YAAY;IAoC1B;;;OAGG;YACW,2BAA2B;IA6CzC;;OAEG;YACW,oBAAoB;IAWlC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAK7B,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IASvE,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAkB1F;;OAEG;YACW,8BAA8B;IA+B5C;;;OAGG;YACW,kBAAkB;IAiH1B,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCnD,0BAA0B,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAgC7D,cAAc,CAAC,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA8EzF,4BAA4B,CAChC,cAAc,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAC5C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;CA2BjB;AAED,qBAAa,iCAAiC,CAAC,MAAM,SAAS,0BAA0B;IACtF,MAAM,CAAC,OAAO,EAAE,aAAa;CAG9B"}
+{"version":3,"file":"medplum-backend.d.ts","sourceRoot":"","sources":["../src/medplum-backend.ts"],"names":[],"mappings":"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"}

package/dist/medplum-backend.js

@@ -444,47 +444,65 @@ export class MedplumNotificationBackend {
     }
     /* Attachment management methods */
     /**
-     * Helper: Convert FileAttachment to Buffer
+     * Store an attachment file record in the backend's database (Media resource).
+     * This is called after the AttachmentManager uploads a file and returns storageIdentifiers.
+     * The backend stores file metadata along with the storageIdentifiers for later retrieval.
      */
-    async fileToBuffer(file, filename) {
-        if (Buffer.isBuffer(file)) {
-            return file;
-        }
-        if (typeof file === 'string') {
-            // File path - read from filesystem
-            const fs = await import('node:fs/promises');
-            return await fs.readFile(file);
-        }
-        // ReadableStream or Readable
-        const chunks = [];
-        if ('getReader' in file) {
-            // Web ReadableStream
-            const reader = file.getReader();
-            try {
-                while (true) {
-                    const { done, value } = await reader.read();
-                    if (done)
-                        break;
-                    chunks.push(Buffer.from(value));
-                }
-            }
-            finally {
-                reader.releaseLock();
-            }
+    async storeAttachmentFileRecord(record) {
+        const storageIds = record.storageIdentifiers;
+        // Create a Media resource in Medplum to store file metadata
+        // This is the backend's database record for the file
+        const media = {
+            resourceType: 'Media',
+            status: 'completed',
+            meta: {
+                tag: [{ code: 'vintasend-backend-attachment-metadata' }],
+            },
+            content: {
+                contentType: record.contentType,
+                url: storageIds.url,
+                size: record.size,
+                title: record.filename,
+                creation: record.createdAt.toISOString(),
+            },
+            identifier: [
+                {
+                    system: 'http://vintasend.com/fhir/attachment-checksum',
+                    value: record.checksum,
+                },
+                {
+                    system: 'http://vintasend.com/fhir/binary-id',
+                    value: storageIds.medplumBinaryId,
+                },
+            ],
+        };
+        // Store storageIdentifiers as JSON string in an extension
+        // This keeps identifiers opaque - backend doesn't inspect specific fields
+        media.extension = media.extension || [];
+        media.extension.push({
+            url: 'http://vintasend.com/fhir/StructureDefinition/storage-identifiers',
+            valueString: JSON.stringify(storageIds),
+        });
+        await this.medplum.createResource(media);
+    }
+    /**
+     * Get an attachment file record from the backend's database.
+     * Reads the Media resource created by storeAttachmentFileRecord().
+     */
+    async getAttachmentFileRecord(fileId) {
+        try {
+            const media = await this.medplum.readResource('Media', fileId);
+            return this.mediaToAttachmentFileRecord(media);
         }
-        else {
-            // Node.js Readable
-            for await (const chunk of file) {
-                chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-            }
+        catch {
+            return null;
         }
-        return Buffer.concat(chunks);
     }
     /**
      * Helper: Convert FHIR Media resource to AttachmentFileRecord
      * Extracts metadata directly from the Media resource using the same logic as MedplumAttachmentManager.getFile
      */
-    async mediaToAttachmentFileRecord(media) {
+    mediaToAttachmentFileRecord(media) {
         if (!media.id) {
             throw new Error('Invalid Media resource: missing id');
         }
@@ -504,17 +522,20 @@ export class MedplumNotificationBackend {
         // Extract checksum from identifier
         const checksumIdentifier = media.identifier?.find((id) => id.system === 'http://vintasend.com/fhir/attachment-checksum');
         const checksum = checksumIdentifier?.value || '';
+        // Create proper MedplumStorageIdentifiers with correct field names
+        const storageIdentifiers = {
+            id: media.id,
+            medplumBinaryId: binaryId || '',
+            medplumMediaId: media.id,
+            url: media.content.url || '',
+        };
         return {
             id: media.id,
             filename: media.content.title || 'untitled',
             contentType: media.content.contentType || 'application/octet-stream',
             size: media.content.size || 0,
             checksum,
-            storageMetadata: {
-                url: media.content.url,
-                binaryId: binaryId,
-                creation: media.content.creation,
-            },
+            storageIdentifiers,
             createdAt: media.meta?.lastUpdated ? new Date(media.meta.lastUpdated) : new Date(),
             updatedAt: media.meta?.lastUpdated ? new Date(media.meta.lastUpdated) : new Date(),
         };
@@ -523,7 +544,7 @@ export class MedplumNotificationBackend {
      * Helper: Create FHIR Attachment from file record
      */
     async createFhirAttachment(fileRecord) {
-        const url = fileRecord.storageMetadata?.url;
+        const url = fileRecord.storageIdentifiers?.url;
         return {
             contentType: fileRecord.contentType,
             url: url,
@@ -533,28 +554,19 @@ export class MedplumNotificationBackend {
         };
     }
     /**
-     * Helper: Create MedplumAttachmentFile from storage metadata
+     * Helper: Create MedplumAttachmentFile from storage identifiers
      */
     createMedplumAttachmentFile(fileRecord) {
         const manager = this.getAttachmentManager();
-        return manager.reconstructAttachmentFile(fileRecord.storageMetadata);
-    }
-    async getAttachmentFile(fileId) {
-        try {
-            const media = await this.medplum.readResource('Media', fileId);
-            return this.mediaToAttachmentFileRecord(media);
-        }
-        catch {
-            return null;
-        }
+        return manager.reconstructAttachmentFile(fileRecord.storageIdentifiers);
     }
     async findAttachmentFileByChecksum(checksum) {
         try {
-            const results = await this.medplum.searchResources('Media', `identifier=${checksum}&_tag=attachment-file`);
+            const results = await this.medplum.searchResources('Media', `identifier=${checksum}&_tag=vintasend-backend-attachment-metadata`);
             if (results.length === 0) {
                 return null;
             }
-            const fileRecord = await this.mediaToAttachmentFileRecord(results[0]);
+            const fileRecord = this.mediaToAttachmentFileRecord(results[0]);
             return fileRecord;
         }
         catch {
@@ -571,13 +583,13 @@ export class MedplumNotificationBackend {
         try {
             // Build query with all checksums
             const identifierQuery = checksums.join(',');
-            const results = await this.medplum.searchResources('Media', `identifier=${identifierQuery}&_tag=attachment-file`);
+            const results = await this.medplum.searchResources('Media', `identifier=${identifierQuery}&_tag=vintasend-backend-attachment-metadata`);
             // Map results by checksum
             const filesByChecksum = new Map();
             for (const media of results) {
-                const checksum = media.identifier?.[0]?.value;
+                const checksum = media.identifier?.find((id) => id.system === 'http://vintasend.com/fhir/attachment-checksum')?.value;
                 if (checksum) {
-                    const fileRecord = await this.mediaToAttachmentFileRecord(media);
+                    const fileRecord = this.mediaToAttachmentFileRecord(media);
                     if (fileRecord) {
                         filesByChecksum.set(checksum, fileRecord);
                     }
@@ -592,6 +604,7 @@ export class MedplumNotificationBackend {
     /**
      * Helper: Process attachments and return payload items
      * Optimizes by batching checksum lookups
+     * Works with any AttachmentManager implementation
      */
     async processAttachments(attachments) {
         const manager = this.getAttachmentManager();
@@ -621,11 +634,11 @@ export class MedplumNotificationBackend {
         // Fetch all referenced files in parallel
         const referencedFiles = await Promise.all(fileReferences.map(async ({ fileId }) => ({
             fileId,
-            record: await this.getAttachmentFile(fileId)
+            record: await this.getAttachmentFileRecord(fileId)
         })));
-        // Calculate checksums for new uploads
+        // Calculate checksums for new uploads using manager's fileToBuffer
         const uploadsWithChecksums = await Promise.all(newUploads.map(async (upload) => {
-            const buffer = await this.fileToBuffer(upload.file, upload.filename);
+            const buffer = await manager.fileToBuffer(upload.file);
             const checksum = await manager.calculateChecksum(buffer);
             return { ...upload, buffer, checksum };
         }));
@@ -655,8 +668,10 @@ export class MedplumNotificationBackend {
                 fileRecord = existingFile;
             }
             else {
-                // Upload new file
+                // Upload new file to the manager
                 fileRecord = await manager.uploadFile(upload.file, upload.filename, upload.contentType);
+                // Store the record in the backend's database
+                await this.storeAttachmentFileRecord(fileRecord);
             }
             fileRecords.push({
                 index: upload.index,
@@ -679,41 +694,40 @@ export class MedplumNotificationBackend {
         return payload;
     }
     async deleteAttachmentFile(fileId) {
+        const manager = this.getAttachmentManager();
         // Check if file exists first
-        const fileRecord = await this.getAttachmentFile(fileId);
+        const fileRecord = await this.getAttachmentFileRecord(fileId);
         if (!fileRecord) {
             // File not found, return early
             return;
         }
         // Check if file is still referenced by any notifications
-        const communications = await this.medplum.searchResources('Communication', {
-            _tag: 'notification',
-        });
-        const isReferenced = communications.some((comm) => comm.payload?.some((p) => p.contentAttachment?.url?.includes(fileId)));
-        if (isReferenced) {
+        if (await this.isFileReferencedByNotifications(fileId)) {
             throw new Error('Cannot delete attachment file: still referenced by notifications');
         }
-        // Delete from storage backend
-        if (fileRecord && this.attachmentManager) {
-            await this.attachmentManager.deleteFile(fileId);
+        // Delete from storage backend using storageIdentifiers
+        await manager.deleteFileByIdentifiers(fileRecord.storageIdentifiers);
+        // Delete backend's database record (Media resource)
+        await this.medplum.deleteResource('Media', fileId);
+    }
+    /**
+     * Check if a file is referenced by any active notifications
+     */
+    async isFileReferencedByNotifications(fileId) {
+        try {
+            const communications = await this.medplum.searchResources('Communication', {
+                _tag: 'notification',
+            });
+            return communications.some((comm) => comm.payload?.some((p) => p.contentAttachment?.url?.includes(fileId)));
         }
-        // Delete Binary resource if it exists
-        if (fileRecord.storageMetadata?.url) {
-            const binaryId = fileRecord.storageMetadata.url.replace('Binary/', '');
-            try {
-                await this.medplum.deleteResource('Binary', binaryId);
-            }
-            catch {
-                // Binary may not exist or already deleted
-            }
+        catch {
+            return false;
         }
-        // Delete Media resource
-        await this.medplum.deleteResource('Media', fileId);
     }
     async getOrphanedAttachmentFiles() {
-        // Get all Media resources tagged as attachment-files
+        // Get all backend's file metadata records (Media resources tagged as backend metadata)
         const allMedia = await this.medplum.searchResources('Media', {
-            _tag: 'attachment-file',
+            _tag: 'vintasend-backend-attachment-metadata',
         });
         // Get all notifications
         const communications = await this.medplum.searchResources('Communication', {
@@ -734,7 +748,10 @@ export class MedplumNotificationBackend {
         }
         // Filter orphaned media
         const orphaned = allMedia.filter((media) => media.id && !referencedIds.has(media.id));
-        const fileRecords = await Promise.all(orphaned.map((media) => this.mediaToAttachmentFileRecord(media)));
+        const fileRecords = [];
+        for (const media of orphaned) {
+            fileRecords.push(this.mediaToAttachmentFileRecord(media));
+        }
         return fileRecords.filter((record) => record !== null);
     }
     async getAttachments(notificationId) {
@@ -793,7 +810,7 @@ export class MedplumNotificationBackend {
                     createdAt: fileRecord.createdAt,
                     file: attachmentFile,
                     description: payloadData?.description,
-                    storageMetadata: fileRecord.storageMetadata,
+                    storageMetadata: fileRecord.storageIdentifiers,
                 });
                 this.logger?.info(`[MedplumBackend.getAttachments] Added attachment ${media.id} to list`);
             }

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+import type { StorageIdentifiers } from 'vintasend/dist/types/attachment';
+/**
+ * Medplum-specific storage identifiers.
+ * Contains references to FHIR Binary and Media resources.
+ *
+ * Used when MedplumAttachmentManager uploads files:
+ * - Creates a Binary resource to store the file data
+ * - Creates a Media resource to store metadata
+ * - Returns both IDs so backend can reconstruct file access later
+ */
+export interface MedplumStorageIdentifiers extends StorageIdentifiers {
+    id: string;
+    medplumBinaryId: string;
+    medplumMediaId: string;
+    url: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IAEnE,EAAE,EAAE,MAAM,CAAC;IAGX,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IAGZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vintasend-medplum",
-  "version": "0.4.19",
+  "version": "0.5.0",
   "description": "",
   "main": "dist/index.js",
   "scripts": {
@@ -25,7 +25,7 @@
     "@medplum/fhirtypes": "^5.0.10",
     "pdfmake": "^0.2.23",
     "pug": "^3.0.3",
-    "vintasend": "^0.4.17"
+    "vintasend": "^0.5.0"
   },
   "devDependencies": {
     "@medplum/definitions": "^5.0.10",