vintasend-aws-s3-attachments 0.4.3 → 0.4.17

package/dist/aws-s3-attachment-manager.d.ts

@@ -58,6 +58,19 @@ export declare class S3AttachmentManager extends BaseAttachmentManager {
      * @returns AttachmentFileRecord with S3 storage metadata
      */
     uploadFile(file: FileAttachment, filename: string, contentType?: string): Promise<AttachmentFileRecord>;
+    /**
+     * Get file metadata by ID.
+     *
+     * For S3, this requires fetching the object metadata from S3.
+     * The fileId is used to reconstruct the S3 key.
+     *
+     * Note: This implementation retrieves basic metadata from S3.
+     * The checksum is retrieved from object metadata if available.
+     *
+     * @param fileId - The unique identifier of the file
+     * @returns The file metadata or null if not found
+     */
+    getFile(fileId: string): Promise<AttachmentFileRecord | null>;
     /**
      * Reconstruct an AttachmentFile accessor from storage metadata.
      *
@@ -98,3 +111,4 @@ export declare class S3AttachmentManager extends BaseAttachmentManager {
      */
     private buildS3Key;
 }
+//# sourceMappingURL=aws-s3-attachment-manager.d.ts.map

package/dist/aws-s3-attachment-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-s3-attachment-manager.d.ts","sourceRoot":"","sources":["../src/aws-s3-attachment-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oEAAoE,CAAC;AAC3G,OAAO,KAAK,EACX,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,MAAM,iCAAiC,CAAC;AAWzC,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,qBAAqB;IAC7D,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,yBAAyB;IAc7C;;;;;;;OAOG;IACG,UAAU,CACf,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC;IA6ChC;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAyDnE;;;;;;;;OAQG;IACH,yBAAyB,CACxB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,cAAc;IAcjB;;;;;;;;;;OAUG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;;;OAOG;IACG,sBAAsB,CAC3B,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;IAehB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;CAMlB"}

package/dist/aws-s3-attachment-manager.js

@@ -1,11 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.S3AttachmentManager = void 0;
-const base_attachment_manager_1 = require("vintasend/dist/services/attachment-manager/base-attachment-manager");
-const client_s3_1 = require("@aws-sdk/client-s3");
-const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
-const node_stream_1 = require("node:stream");
-const node_crypto_1 = require("node:crypto");
+import { BaseAttachmentManager } from 'vintasend/dist/services/attachment-manager/base-attachment-manager';
+import { S3Client, PutObjectCommand, GetObjectCommand, DeleteObjectCommand, } from '@aws-sdk/client-s3';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { Readable } from 'node:stream';
+import { randomUUID } from 'node:crypto';
 /**
  * AWS S3 AttachmentManager implementation for VintaSend.
  *
@@ -18,12 +15,12 @@ const node_crypto_1 = require("node:crypto");
  * is stored by the Backend in its database. The Backend calls this manager's
  * uploadFile() method and stores the returned metadata.
  */
-class S3AttachmentManager extends base_attachment_manager_1.BaseAttachmentManager {
+export class S3AttachmentManager extends BaseAttachmentManager {
     constructor(config) {
         super();
         this.bucket = config.bucket;
         this.keyPrefix = config.keyPrefix || '';
-        this.s3Client = new client_s3_1.S3Client({
+        this.s3Client = new S3Client({
             region: config.region,
             credentials: config.credentials,
             endpoint: config.endpoint,
@@ -46,10 +43,10 @@ class S3AttachmentManager extends base_attachment_manager_1.BaseAttachmentManage
         // Detect content type if not provided
         const finalContentType = contentType || this.detectContentType(filename);
         // Generate unique S3 key
-        const fileId = (0, node_crypto_1.randomUUID)();
+        const fileId = randomUUID();
         const key = this.buildS3Key(fileId, filename);
         // Upload to S3
-        const putCommand = new client_s3_1.PutObjectCommand({
+        const putCommand = new PutObjectCommand({
             Bucket: this.bucket,
             Key: key,
             Body: buffer,
@@ -76,6 +73,66 @@ class S3AttachmentManager extends base_attachment_manager_1.BaseAttachmentManage
             updatedAt: new Date(),
         };
     }
+    /**
+     * Get file metadata by ID.
+     *
+     * For S3, this requires fetching the object metadata from S3.
+     * The fileId is used to reconstruct the S3 key.
+     *
+     * Note: This implementation retrieves basic metadata from S3.
+     * The checksum is retrieved from object metadata if available.
+     *
+     * @param fileId - The unique identifier of the file
+     * @returns The file metadata or null if not found
+     */
+    async getFile(fileId) {
+        try {
+            // For S3, we need to list objects with the fileId prefix to find the actual key
+            const prefix = `${this.keyPrefix}${fileId}/`;
+            // Import HeadObjectCommand for metadata retrieval
+            const { HeadObjectCommand } = await import('@aws-sdk/client-s3');
+            const { ListObjectsV2Command } = await import('@aws-sdk/client-s3');
+            // List objects with the fileId prefix
+            const listCommand = new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: prefix,
+                MaxKeys: 1,
+            });
+            const listResponse = await this.s3Client.send(listCommand);
+            if (!listResponse.Contents || listResponse.Contents.length === 0) {
+                return null;
+            }
+            const key = listResponse.Contents[0].Key;
+            if (!key) {
+                return null;
+            }
+            // Get detailed metadata
+            const headCommand = new HeadObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            });
+            const headResponse = await this.s3Client.send(headCommand);
+            const filename = headResponse.Metadata?.originalFilename || key.split('/').pop() || 'unknown';
+            const checksum = headResponse.Metadata?.checksum || '';
+            return {
+                id: fileId,
+                filename,
+                contentType: headResponse.ContentType || 'application/octet-stream',
+                size: headResponse.ContentLength || 0,
+                checksum,
+                storageMetadata: {
+                    bucket: this.bucket,
+                    key,
+                    region: this.s3Client.config.region,
+                },
+                createdAt: headResponse.LastModified || new Date(),
+                updatedAt: headResponse.LastModified || new Date(),
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
     /**
      * Reconstruct an AttachmentFile accessor from storage metadata.
      *
@@ -117,7 +174,7 @@ class S3AttachmentManager extends base_attachment_manager_1.BaseAttachmentManage
         if (!storageMetadata.key) {
             throw new Error('Storage metadata must contain key for S3 file deletion');
         }
-        const deleteCommand = new client_s3_1.DeleteObjectCommand({
+        const deleteCommand = new DeleteObjectCommand({
             Bucket: this.bucket,
             Key: storageMetadata.key,
         });
@@ -137,7 +194,6 @@ class S3AttachmentManager extends base_attachment_manager_1.BaseAttachmentManage
         return `${this.keyPrefix}${fileId}/${sanitizedFilename}`;
     }
 }
-exports.S3AttachmentManager = S3AttachmentManager;
 /**
  * S3 AttachmentFile implementation.
  *
@@ -158,7 +214,7 @@ class S3AttachmentFile {
      * Use this for small files. For large files, prefer streaming.
      */
     async read() {
-        const getCommand = new client_s3_1.GetObjectCommand({
+        const getCommand = new GetObjectCommand({
             Bucket: this.bucket,
             Key: this.key,
         });
@@ -175,7 +231,7 @@ class S3AttachmentFile {
      * Use this for large files to avoid loading everything into memory.
      */
     async stream() {
-        const getCommand = new client_s3_1.GetObjectCommand({
+        const getCommand = new GetObjectCommand({
             Bucket: this.bucket,
             Key: this.key,
         });
@@ -185,7 +241,7 @@ class S3AttachmentFile {
         }
         // Convert Node.js Readable to Web ReadableStream
         const nodeStream = response.Body;
-        return node_stream_1.Readable.toWeb(nodeStream);
+        return Readable.toWeb(nodeStream);
     }
     /**
      * Generate a presigned URL for accessing the file.
@@ -194,11 +250,11 @@ class S3AttachmentFile {
      * @returns A presigned URL for secure file access
      */
     async url(expiresIn = 3600) {
-        const getCommand = new client_s3_1.GetObjectCommand({
+        const getCommand = new GetObjectCommand({
             Bucket: this.bucket,
             Key: this.key,
         });
-        return (0, s3_request_presigner_1.getSignedUrl)(this.s3Client, getCommand, { expiresIn });
+        return getSignedUrl(this.s3Client, getCommand, { expiresIn });
     }
     /**
      * Delete this file from S3.
@@ -206,7 +262,7 @@ class S3AttachmentFile {
      * Note: This is typically called by the AttachmentManager, not directly.
      */
     async delete() {
-        const deleteCommand = new client_s3_1.DeleteObjectCommand({
+        const deleteCommand = new DeleteObjectCommand({
             Bucket: this.bucket,
             Key: this.key,
         });

package/dist/index.d.ts

@@ -1 +1,2 @@
 export { S3AttachmentManager, type S3AttachmentManagerConfig, } from './aws-s3-attachment-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,KAAK,yBAAyB,GAC9B,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,5 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.S3AttachmentManager = void 0;
-var aws_s3_attachment_manager_1 = require("./aws-s3-attachment-manager");
-Object.defineProperty(exports, "S3AttachmentManager", { enumerable: true, get: function () { return aws_s3_attachment_manager_1.S3AttachmentManager; } });
+export { S3AttachmentManager, } from './aws-s3-attachment-manager';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vintasend-aws-s3-attachments",
-  "version": "0.4.3",
+  "version": "0.4.17",
   "description": "Implementation of AWS S3 Attachments for VintaSend",
   "main": "dist/index.js",
   "scripts": {
@@ -16,14 +16,14 @@
   "author": "Hugo Bessa",
   "license": "MIT",
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.967.0",
-    "@aws-sdk/s3-request-presigner": "^3.967.0",
-    "vintasend": "^0.4.3"
+    "@aws-sdk/client-s3": "^3.981.0",
+    "@aws-sdk/s3-request-presigner": "^3.981.0",
+    "vintasend": "^0.4.17"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.2.6",
-    "typescript": "^5.8.2"
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
   }
 }