@teamflojo/floimg 0.4.0 → 0.6.0

package/dist/providers/save/S3SaveProvider.js

@@ -1,17 +1,29 @@
-import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
+import { S3Client, PutObjectCommand, GetObjectCommand } from "@aws-sdk/client-s3";
+import { getSignedUrl } from "@aws-sdk/s3-request-presigner";
 /**
  * S3 save provider - saves images to AWS S3 or S3-compatible storage
+ *
+ * Supports:
+ * - AWS S3
+ * - Hetzner Object Storage
+ * - Cloudflare R2
+ * - Any S3-compatible service
  */
 export default class S3SaveProvider {
     name = "s3";
     s3Client;
     bucket;
+    region;
+    endpoint;
     constructor(config) {
         this.bucket = config.bucket;
+        this.region = config.region;
+        this.endpoint = config.endpoint;
         this.s3Client = new S3Client({
             region: config.region,
             endpoint: config.endpoint,
             credentials: config.credentials,
+            forcePathStyle: !!config.endpoint, // Required for S3-compatible services
         });
     }
     async save(input) {
@@ -23,9 +35,7 @@ export default class S3SaveProvider {
             ...(input.headers && { Metadata: input.headers }),
         });
         const result = await this.s3Client.send(command);
-        const url = input.headers?.endpoint
-            ? `${input.headers.endpoint}/${this.bucket}/${input.path}`
-            : `https://${this.bucket}.s3.amazonaws.com/${input.path}`;
+        const url = this.getPublicUrl(input.path);
         return {
             provider: "s3",
             location: url,
@@ -38,5 +48,49 @@ export default class S3SaveProvider {
             },
         };
     }
+    /**
+     * Generate a presigned URL for temporary access to a private object
+     *
+     * @param key - The S3 object key (path)
+     * @param options - Presign options (expiry time)
+     * @returns Presigned URL string
+     *
+     * @example
+     * ```typescript
+     * const provider = new S3SaveProvider({ bucket: 'my-bucket', region: 'us-east-1' });
+     * const url = await provider.getPresignedUrl('images/photo.png', { expiresIn: 3600 });
+     * // Returns: https://my-bucket.s3.us-east-1.amazonaws.com/images/photo.png?X-Amz-...
+     * ```
+     */
+    async getPresignedUrl(key, options) {
+        const command = new GetObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+        });
+        const expiresIn = options?.expiresIn ?? 3600; // Default 1 hour
+        return getSignedUrl(this.s3Client, command, { expiresIn });
+    }
+    /**
+     * Get the public URL for an object (assumes bucket is publicly readable)
+     *
+     * @param key - The S3 object key (path)
+     * @returns Public URL string
+     */
+    getPublicUrl(key) {
+        if (this.endpoint) {
+            // S3-compatible service (Hetzner, R2, etc.)
+            // Format: https://endpoint/bucket/key
+            return `${this.endpoint}/${this.bucket}/${key}`;
+        }
+        // AWS S3
+        // Format: https://bucket.s3.region.amazonaws.com/key
+        return `https://${this.bucket}.s3.${this.region}.amazonaws.com/${key}`;
+    }
+    /**
+     * Get the bucket name
+     */
+    getBucket() {
+        return this.bucket;
+    }
 }
 //# sourceMappingURL=S3SaveProvider.js.map

package/dist/providers/save/S3SaveProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"S3SaveProvider.js","sourceRoot":"","sources":["../../../src/providers/save/S3SaveProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAahE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,IAAI,GAAG,IAAI,CAAC;IACJ,QAAQ,CAAW;IACnB,MAAM,CAAS;IAEvB,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAKV;QACC,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;YACtB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;YAC5B,GAAG,CAAE,KAAK,CAAC,OAAO,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACnD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,QAAQ;YACjC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE;YAC1D,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,qBAAqB,KAAK,CAAC,IAAI,EAAE,CAAC;QAE5D,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE;gBACR,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,KAAK,CAAC,IAAI;aAChB;SACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"S3SaveProvider.js","sourceRoot":"","sources":["../../../src/providers/save/S3SaveProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAkB7D;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,IAAI,GAAG,IAAI,CAAC;IACJ,QAAQ,CAAW;IACnB,MAAM,CAAS;IACf,MAAM,CAAS;IACf,QAAQ,CAAU;IAE1B,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,sCAAsC;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAKV;QACC,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;YACtB,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;YAC5B,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SAClD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE1C,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;YACrB,QAAQ,EAAE;gBACR,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,EAAE,KAAK,CAAC,IAAI;aAChB;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,eAAe,CAAC,GAAW,EAAE,OAAwB;QACzD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,GAAG;SACT,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,iBAAiB;QAE/D,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,GAAW;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,4CAA4C;YAC5C,sCAAsC;YACtC,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAClD,CAAC;QACD,SAAS;QACT,qDAAqD;QACrD,OAAO,WAAW,IAAI,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teamflojo/floimg",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Universal image workflow engine for developers and AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -56,6 +56,7 @@
   "homepage": "https://github.com/TeamFlojo/floimg#readme",
   "dependencies": {
     "@aws-sdk/client-s3": "^3.709.0",
+    "@aws-sdk/s3-request-presigner": "^3.958.0",
     "@modelcontextprotocol/sdk": "^1.20.0",
     "@napi-rs/canvas": "^0.1.80",
     "@resvg/resvg-js": "^2.6.2",