@fractary/core 0.3.3 → 0.5.0

package/dist/file/index.js

@@ -3,6 +3,13 @@
  * @fractary/core - File Module
  *
  * File storage operations across local and cloud storage backends.
+ *
+ * Supported backends:
+ * - LocalStorage: Local filesystem
+ * - S3Storage: AWS S3 (requires @aws-sdk/client-s3)
+ * - R2Storage: Cloudflare R2 (requires @aws-sdk/client-s3)
+ * - GCSStorage: Google Cloud Storage (requires @google-cloud/storage)
+ * - GDriveStorage: Google Drive (requires googleapis)
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -19,10 +26,27 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocalStorage = exports.FileManager = void 0;
+exports.getDefaultStorageType = exports.sourceConfigToStorageConfig = exports.createStorageFromSource = exports.createStorage = exports.GDriveStorage = exports.GCSStorage = exports.R2Storage = exports.S3Storage = exports.LocalStorage = exports.FileManager = void 0;
+// Core exports
 var manager_1 = require("./manager");
 Object.defineProperty(exports, "FileManager", { enumerable: true, get: function () { return manager_1.FileManager; } });
 var local_1 = require("./local");
 Object.defineProperty(exports, "LocalStorage", { enumerable: true, get: function () { return local_1.LocalStorage; } });
+// Cloud storage implementations (lazy loaded)
+var s3_1 = require("./s3");
+Object.defineProperty(exports, "S3Storage", { enumerable: true, get: function () { return s3_1.S3Storage; } });
+var r2_1 = require("./r2");
+Object.defineProperty(exports, "R2Storage", { enumerable: true, get: function () { return r2_1.R2Storage; } });
+var gcs_1 = require("./gcs");
+Object.defineProperty(exports, "GCSStorage", { enumerable: true, get: function () { return gcs_1.GCSStorage; } });
+var gdrive_1 = require("./gdrive");
+Object.defineProperty(exports, "GDriveStorage", { enumerable: true, get: function () { return gdrive_1.GDriveStorage; } });
+// Factory functions
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "createStorage", { enumerable: true, get: function () { return factory_1.createStorage; } });
+Object.defineProperty(exports, "createStorageFromSource", { enumerable: true, get: function () { return factory_1.createStorageFromSource; } });
+Object.defineProperty(exports, "sourceConfigToStorageConfig", { enumerable: true, get: function () { return factory_1.sourceConfigToStorageConfig; } });
+Object.defineProperty(exports, "getDefaultStorageType", { enumerable: true, get: function () { return factory_1.getDefaultStorageType; } });
+// Type exports
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/file/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;AAEH,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AACpB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,qCAA4D;AAAnD,sGAAA,WAAW,OAAA;AACpB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AAErB,8CAA8C;AAC9C,2BAAiC;AAAxB,+FAAA,SAAS,OAAA;AAClB,2BAAiC;AAAxB,+FAAA,SAAS,OAAA;AAClB,6BAAmC;AAA1B,iGAAA,UAAU,OAAA;AACnB,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AAEtB,oBAAoB;AACpB,qCAKmB;AAJjB,wGAAA,aAAa,OAAA;AACb,kHAAA,uBAAuB,OAAA;AACvB,sHAAA,2BAA2B,OAAA;AAC3B,gHAAA,qBAAqB,OAAA;AAGvB,eAAe;AACf,0CAAwB"}

package/dist/file/manager.d.ts

@@ -2,41 +2,122 @@
  * @fractary/core - File Manager
  *
  * Unified interface for file storage operations.
+ * Supports multiple storage backends: local, S3, R2, GCS, Google Drive.
  */
-import { FileManagerConfig } from './types';
+import { Storage, FileManagerConfig, StorageConfig } from './types';
+/**
+ * Extended configuration options for FileManager
+ */
+export interface FileManagerOptions extends FileManagerConfig {
+    /**
+     * Storage configuration for automatic backend selection
+     * If provided, this takes precedence over storage and basePath
+     */
+    storageConfig?: StorageConfig;
+}
 /**
  * File Manager - Unified interface for file operations
+ *
+ * Provides a consistent API for file operations across different storage backends.
+ * Supports local filesystem, AWS S3, Cloudflare R2, Google Cloud Storage,
+ * and Google Drive.
+ *
+ * @example
+ * // Local storage (default)
+ * const localManager = new FileManager({ basePath: '.fractary/files' });
+ *
+ * @example
+ * // S3 storage with configuration
+ * const s3Manager = new FileManager({
+ *   storageConfig: {
+ *     type: 's3',
+ *     bucket: 'my-bucket',
+ *     region: 'us-east-1',
+ *     prefix: 'files/',
+ *     auth: { profile: 'default' }
+ *   }
+ * });
+ *
+ * @example
+ * // Custom storage backend
+ * const customManager = new FileManager({
+ *   storage: myCustomStorage
+ * });
  */
 export declare class FileManager {
     private storage;
-    constructor(config: FileManagerConfig);
+    constructor(config?: FileManagerOptions);
+    /**
+     * Validate a file path for security issues
+     *
+     * @param path - Path to validate
+     * @throws Error if path is invalid or contains security issues
+     */
+    private validatePath;
     /**
      * Write file content
+     *
+     * @param path - Path/identifier for the file
+     * @param content - Content to write
+     * @returns URI or path where the content was written
      */
     write(path: string, content: string): Promise<string>;
     /**
      * Read file content
+     *
+     * @param path - Path/identifier for the file
+     * @returns File content or null if not found
      */
     read(path: string): Promise<string | null>;
     /**
      * Check if file exists
+     *
+     * @param path - Path/identifier for the file
+     * @returns True if the file exists
      */
     exists(path: string): Promise<boolean>;
     /**
      * List files (optionally with prefix)
+     *
+     * @param prefix - Optional prefix to filter results
+     * @returns List of file paths/identifiers
      */
     list(prefix?: string): Promise<string[]>;
     /**
      * Delete file
+     *
+     * @param path - Path/identifier for the file
      */
     delete(path: string): Promise<void>;
     /**
      * Copy file from one location to another
+     *
+     * @param sourcePath - Source path/identifier
+     * @param destPath - Destination path/identifier
+     * @returns URI or path where the content was copied
      */
     copy(sourcePath: string, destPath: string): Promise<string>;
     /**
      * Move file from one location to another
+     *
+     * @param sourcePath - Source path/identifier
+     * @param destPath - Destination path/identifier
+     * @returns URI or path where the content was moved
      */
     move(sourcePath: string, destPath: string): Promise<string>;
+    /**
+     * Get a URL for the file (if supported by the storage backend)
+     *
+     * @param path - Path/identifier for the file
+     * @param expiresIn - Expiration time in seconds (for presigned URLs)
+     * @returns URL or null if not supported
+     */
+    getUrl(path: string, expiresIn?: number): Promise<string | null>;
+    /**
+     * Get the underlying storage backend
+     *
+     * @returns The storage instance
+     */
+    getStorage(): Storage;
 }
 //# sourceMappingURL=manager.d.ts.map

package/dist/file/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/file/manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGrD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,EAAE,iBAAiB;IAIrC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIhD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9C;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAKlE"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/file/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;gBAEb,MAAM,CAAC,EAAE,kBAAkB;IAYvC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA0BpB;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3D;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKhD;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO9C;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjE;;;;;;OAMG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;;;;;OAMG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQtE;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/file/manager.js

@@ -3,66 +3,187 @@
  * @fractary/core - File Manager
  *
  * Unified interface for file storage operations.
+ * Supports multiple storage backends: local, S3, R2, GCS, Google Drive.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileManager = void 0;
 const local_1 = require("./local");
+const factory_1 = require("./factory");
 /**
  * File Manager - Unified interface for file operations
+ *
+ * Provides a consistent API for file operations across different storage backends.
+ * Supports local filesystem, AWS S3, Cloudflare R2, Google Cloud Storage,
+ * and Google Drive.
+ *
+ * @example
+ * // Local storage (default)
+ * const localManager = new FileManager({ basePath: '.fractary/files' });
+ *
+ * @example
+ * // S3 storage with configuration
+ * const s3Manager = new FileManager({
+ *   storageConfig: {
+ *     type: 's3',
+ *     bucket: 'my-bucket',
+ *     region: 'us-east-1',
+ *     prefix: 'files/',
+ *     auth: { profile: 'default' }
+ *   }
+ * });
+ *
+ * @example
+ * // Custom storage backend
+ * const customManager = new FileManager({
+ *   storage: myCustomStorage
+ * });
  */
 class FileManager {
     storage;
     constructor(config) {
-        this.storage = config.storage || new local_1.LocalStorage(config.basePath);
+        // Priority: storageConfig > storage > LocalStorage with basePath
+        if (config?.storageConfig) {
+            this.storage = (0, factory_1.createStorage)(config.storageConfig);
+        }
+        else if (config?.storage) {
+            this.storage = config.storage;
+        }
+        else {
+            const basePath = config?.basePath || '.fractary/files';
+            this.storage = new local_1.LocalStorage(basePath);
+        }
+    }
+    /**
+     * Validate a file path for security issues
+     *
+     * @param path - Path to validate
+     * @throws Error if path is invalid or contains security issues
+     */
+    validatePath(path) {
+        if (!path || path.trim() === '') {
+            throw new Error('Path cannot be empty');
+        }
+        // Check for directory traversal sequences
+        if (path.includes('..')) {
+            throw new Error('Path cannot contain directory traversal sequences (..)');
+        }
+        // Check for null bytes (potential security issue)
+        if (path.includes('\0')) {
+            throw new Error('Path cannot contain null bytes');
+        }
+        // Check for absolute paths on Windows
+        if (/^[a-zA-Z]:/.test(path)) {
+            throw new Error('Absolute Windows paths are not allowed');
+        }
+        // Check for absolute Unix paths (starting with /)
+        if (path.startsWith('/')) {
+            throw new Error('Absolute paths are not allowed');
+        }
     }
     /**
      * Write file content
+     *
+     * @param path - Path/identifier for the file
+     * @param content - Content to write
+     * @returns URI or path where the content was written
      */
     async write(path, content) {
+        this.validatePath(path);
         return this.storage.write(path, content);
     }
     /**
      * Read file content
+     *
+     * @param path - Path/identifier for the file
+     * @returns File content or null if not found
      */
     async read(path) {
+        this.validatePath(path);
         return this.storage.read(path);
     }
     /**
      * Check if file exists
+     *
+     * @param path - Path/identifier for the file
+     * @returns True if the file exists
      */
     async exists(path) {
+        this.validatePath(path);
         return this.storage.exists(path);
     }
     /**
      * List files (optionally with prefix)
+     *
+     * @param prefix - Optional prefix to filter results
+     * @returns List of file paths/identifiers
      */
     async list(prefix) {
+        if (prefix) {
+            this.validatePath(prefix);
+        }
         return this.storage.list(prefix);
     }
     /**
      * Delete file
+     *
+     * @param path - Path/identifier for the file
      */
     async delete(path) {
+        this.validatePath(path);
         return this.storage.delete(path);
     }
     /**
      * Copy file from one location to another
+     *
+     * @param sourcePath - Source path/identifier
+     * @param destPath - Destination path/identifier
+     * @returns URI or path where the content was copied
      */
     async copy(sourcePath, destPath) {
-        const content = await this.read(sourcePath);
+        this.validatePath(sourcePath);
+        this.validatePath(destPath);
+        const content = await this.storage.read(sourcePath);
         if (!content) {
             throw new Error(`Source file not found: ${sourcePath}`);
         }
-        return this.write(destPath, content);
+        return this.storage.write(destPath, content);
     }
     /**
      * Move file from one location to another
+     *
+     * @param sourcePath - Source path/identifier
+     * @param destPath - Destination path/identifier
+     * @returns URI or path where the content was moved
      */
     async move(sourcePath, destPath) {
+        this.validatePath(sourcePath);
+        this.validatePath(destPath);
         const result = await this.copy(sourcePath, destPath);
-        await this.delete(sourcePath);
+        await this.storage.delete(sourcePath);
         return result;
     }
+    /**
+     * Get a URL for the file (if supported by the storage backend)
+     *
+     * @param path - Path/identifier for the file
+     * @param expiresIn - Expiration time in seconds (for presigned URLs)
+     * @returns URL or null if not supported
+     */
+    async getUrl(path, expiresIn) {
+        this.validatePath(path);
+        if (this.storage.getUrl) {
+            return this.storage.getUrl(path, expiresIn);
+        }
+        return null;
+    }
+    /**
+     * Get the underlying storage backend
+     *
+     * @returns The storage instance
+     */
+    getStorage() {
+        return this.storage;
+    }
 }
 exports.FileManager = FileManager;
 //# sourceMappingURL=manager.js.map

package/dist/file/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/file/manager.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,mCAAuC;AAEvC;;GAEG;AACH,MAAa,WAAW;IACd,OAAO,CAAU;IAEzB,YAAY,MAAyB;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,oBAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAe;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAe;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,QAAgB;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,QAAgB;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA7DD,kCA6DC"}
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/file/manager.ts"],"names":[],"mappings":"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"}

package/dist/file/r2.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fractary/core - R2 Storage Implementation
+ *
+ * Cloudflare R2 storage backend for file operations.
+ * R2 is S3-compatible, so this uses the AWS SDK with R2 endpoint.
+ */
+import { Storage, R2StorageConfig } from './types';
+/**
+ * Cloudflare R2 storage implementation
+ *
+ * Uses S3Storage internally with R2-specific endpoint configuration.
+ */
+export declare class R2Storage implements Storage {
+    private s3Storage;
+    private config;
+    constructor(config: R2StorageConfig);
+    /**
+     * Write content to R2
+     */
+    write(id: string, content: string): Promise<string>;
+    /**
+     * Read content from R2
+     */
+    read(id: string): Promise<string | null>;
+    /**
+     * Check if object exists in R2
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * List objects in R2 with optional prefix
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Delete object from R2
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get a URL for the object
+     *
+     * R2 supports presigned URLs, and can also use public bucket URLs.
+     */
+    getUrl(id: string, expiresIn?: number): Promise<string | null>;
+    /**
+     * Get the bucket name
+     */
+    getBucket(): string;
+    /**
+     * Get the account ID
+     */
+    getAccountId(): string;
+    /**
+     * Get the configured prefix
+     */
+    getPrefix(): string | undefined;
+}
+//# sourceMappingURL=r2.d.ts.map

package/dist/file/r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../src/file/r2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,eAAe,EAAmB,MAAM,SAAS,CAAC;AAGpE;;;;GAIG;AACH,qBAAa,SAAU,YAAW,OAAO;IACvC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAoBnC;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMzD;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;OAIG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI3E;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;CAGhC"}

package/dist/file/r2.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * @fractary/core - R2 Storage Implementation
+ *
+ * Cloudflare R2 storage backend for file operations.
+ * R2 is S3-compatible, so this uses the AWS SDK with R2 endpoint.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R2Storage = void 0;
+const s3_1 = require("./s3");
+/**
+ * Cloudflare R2 storage implementation
+ *
+ * Uses S3Storage internally with R2-specific endpoint configuration.
+ */
+class R2Storage {
+    s3Storage;
+    config;
+    constructor(config) {
+        this.config = config;
+        // Convert R2 config to S3-compatible config
+        const s3Config = {
+            type: 's3',
+            bucket: config.bucket,
+            region: 'auto', // R2 uses 'auto' region
+            prefix: config.prefix,
+            endpoint: `https://${config.accountId}.r2.cloudflarestorage.com`,
+            publicUrl: config.publicUrl,
+            auth: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+        };
+        this.s3Storage = new s3_1.S3Storage(s3Config);
+    }
+    /**
+     * Write content to R2
+     */
+    async write(id, content) {
+        const result = await this.s3Storage.write(id, content);
+        // Return R2-style URI
+        return result.replace('s3://', 'r2://');
+    }
+    /**
+     * Read content from R2
+     */
+    async read(id) {
+        return this.s3Storage.read(id);
+    }
+    /**
+     * Check if object exists in R2
+     */
+    async exists(id) {
+        return this.s3Storage.exists(id);
+    }
+    /**
+     * List objects in R2 with optional prefix
+     */
+    async list(prefix) {
+        return this.s3Storage.list(prefix);
+    }
+    /**
+     * Delete object from R2
+     */
+    async delete(id) {
+        return this.s3Storage.delete(id);
+    }
+    /**
+     * Get a URL for the object
+     *
+     * R2 supports presigned URLs, and can also use public bucket URLs.
+     */
+    async getUrl(id, expiresIn = 86400) {
+        return this.s3Storage.getUrl(id, expiresIn);
+    }
+    /**
+     * Get the bucket name
+     */
+    getBucket() {
+        return this.config.bucket;
+    }
+    /**
+     * Get the account ID
+     */
+    getAccountId() {
+        return this.config.accountId;
+    }
+    /**
+     * Get the configured prefix
+     */
+    getPrefix() {
+        return this.config.prefix;
+    }
+}
+exports.R2Storage = R2Storage;
+//# sourceMappingURL=r2.js.map

package/dist/file/r2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.js","sourceRoot":"","sources":["../../src/file/r2.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6BAAiC;AAEjC;;;;GAIG;AACH,MAAa,SAAS;IACZ,SAAS,CAAY;IACrB,MAAM,CAAkB;IAEhC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,4CAA4C;QAC5C,MAAM,QAAQ,GAAoB;YAChC,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,EAAE,wBAAwB;YACxC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,WAAW,MAAM,CAAC,SAAS,2BAA2B;YAChE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE;gBACJ,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC;SACF,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,cAAS,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,EAAU,EAAE,OAAe;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvD,sBAAsB;QACtB,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAe;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,YAAoB,KAAK;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;CACF;AA1FD,8BA0FC"}

package/dist/file/s3.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fractary/core - S3 Storage Implementation
+ *
+ * AWS S3 storage backend for file operations.
+ * Uses AWS SDK v3 with lazy loading to avoid hard dependencies.
+ */
+import { Storage, S3StorageConfig } from './types';
+/**
+ * AWS S3 storage implementation
+ */
+export declare class S3Storage implements Storage {
+    private config;
+    private s3Client;
+    constructor(config: S3StorageConfig);
+    /**
+     * Get or create the S3 client (lazy loaded)
+     */
+    private getClient;
+    /**
+     * Get the full S3 key with optional prefix
+     */
+    private getKey;
+    /**
+     * Check if an error is a "not found" error
+     * AWS SDK v3 uses error.name and error.$metadata.httpStatusCode
+     */
+    private isNotFoundError;
+    /**
+     * Write content to S3
+     */
+    write(id: string, content: string): Promise<string>;
+    /**
+     * Read content from S3
+     */
+    read(id: string): Promise<string | null>;
+    /**
+     * Check if object exists in S3
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * List objects in S3 with optional prefix
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Delete object from S3
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get a presigned URL for the object
+     */
+    getUrl(id: string, expiresIn?: number): Promise<string | null>;
+    /**
+     * Get the bucket name
+     */
+    getBucket(): string;
+    /**
+     * Get the configured prefix
+     */
+    getPrefix(): string | undefined;
+}
+//# sourceMappingURL=s3.d.ts.map

package/dist/file/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/file/s3.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAKnD;;GAEG;AACH,qBAAa,SAAU,YAAW,OAAO;IACvC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,MAAM,EAAE,eAAe;IAInC;;OAEG;YACW,SAAS;IAwCvB;;OAEG;IACH,OAAO,CAAC,MAAM;IAOd;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBzD;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4B9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB1C;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoC9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavC;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4B3E;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;CAGhC"}