@fractary/core 0.3.2 → 0.4.0

package/dist/file/gdrive.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * @fractary/core - Google Drive Storage Implementation
+ *
+ * Google Drive storage backend for file operations.
+ * Uses googleapis with lazy loading.
+ *
+ * Note: Google Drive doesn't use traditional file paths. This implementation
+ * maps path-like identifiers to Google Drive files by name within a folder.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GDriveStorage = void 0;
+/**
+ * Google Drive storage implementation
+ */
+class GDriveStorage {
+    config;
+    driveClient = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get or create the Google Drive client (lazy loaded)
+     */
+    async getClient() {
+        if (this.driveClient) {
+            return this.driveClient;
+        }
+        try {
+            // Dynamic import to avoid hard dependency
+            const { google } = await Promise.resolve().then(() => __importStar(require('googleapis')));
+            // Check if we have OAuth credentials
+            if (this.config.clientId && this.config.clientSecret && this.config.refreshToken) {
+                const oauth2Client = new google.auth.OAuth2(this.config.clientId, this.config.clientSecret);
+                oauth2Client.setCredentials({
+                    refresh_token: this.config.refreshToken,
+                });
+                this.driveClient = google.drive({ version: 'v3', auth: oauth2Client });
+            }
+            else {
+                // Use Application Default Credentials
+                const googleAuth = new google.auth.GoogleAuth({
+                    scopes: ['https://www.googleapis.com/auth/drive'],
+                });
+                const authClient = await googleAuth.getClient();
+                this.driveClient = google.drive({
+                    version: 'v3',
+                    auth: authClient,
+                });
+            }
+            return this.driveClient;
+        }
+        catch (error) {
+            throw new Error('Google APIs SDK not available. Install with: npm install googleapis');
+        }
+    }
+    /**
+     * Get the parent folder ID (internal helper)
+     */
+    getParentFolderId() {
+        return this.config.folderId || 'root';
+    }
+    /**
+     * Extract file name from path-like ID
+     */
+    getFileName(id) {
+        // Take the last part of the path as the file name
+        const parts = id.split('/');
+        return parts[parts.length - 1];
+    }
+    /**
+     * Escape a string for use in Google Drive query syntax
+     * Single quotes must be escaped with backslash
+     */
+    escapeQueryString(str) {
+        return str.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    }
+    /**
+     * Check if a string looks like a Google Drive file ID
+     * Drive file IDs are typically 28-44 characters, alphanumeric with - and _
+     */
+    isFileId(id) {
+        // More permissive regex to handle various Google Drive ID formats
+        return /^[a-zA-Z0-9_-]{20,50}$/.test(id) && !id.includes('/');
+    }
+    /**
+     * Check if an error is a "not found" error
+     * Google APIs uses error.code (number) or error.errors[].reason
+     */
+    isNotFoundError(error) {
+        return (error.code === 404 ||
+            error.status === 404 ||
+            error.errors?.some((e) => e.reason === 'notFound'));
+    }
+    /**
+     * Find a file by name in the configured folder
+     */
+    async findFile(id) {
+        const drive = await this.getClient();
+        const fileName = this.getFileName(id);
+        const escapedFileName = this.escapeQueryString(fileName);
+        const folderId = this.getParentFolderId();
+        const response = await drive.files.list({
+            q: `name = '${escapedFileName}' and '${folderId}' in parents and trashed = false`,
+            fields: 'files(id, name)',
+            spaces: 'drive',
+        });
+        if (response.data.files && response.data.files.length > 0) {
+            return response.data.files[0].id ?? null;
+        }
+        return null;
+    }
+    /**
+     * Write content to Google Drive
+     */
+    async write(id, content) {
+        const drive = await this.getClient();
+        const fileName = this.getFileName(id);
+        const folderId = this.getParentFolderId();
+        // Check if file already exists
+        const existingFileId = await this.findFile(id);
+        const media = {
+            mimeType: 'text/plain',
+            body: content,
+        };
+        let fileId;
+        if (existingFileId) {
+            // Update existing file
+            const response = await drive.files.update({
+                fileId: existingFileId,
+                media,
+                fields: 'id',
+            });
+            if (!response.data.id) {
+                throw new Error('Failed to update file: no file ID returned');
+            }
+            fileId = response.data.id;
+        }
+        else {
+            // Create new file
+            const fileMetadata = {
+                name: fileName,
+                parents: [folderId],
+            };
+            const response = await drive.files.create({
+                requestBody: fileMetadata,
+                media,
+                fields: 'id',
+            });
+            if (!response.data.id) {
+                throw new Error('Failed to create file: no file ID returned');
+            }
+            fileId = response.data.id;
+        }
+        return `gdrive://${fileId}`;
+    }
+    /**
+     * Read content from Google Drive
+     */
+    async read(id) {
+        const drive = await this.getClient();
+        // Check if id is a direct file ID or a path-like name
+        let fileId = id;
+        if (!this.isFileId(id)) {
+            // Looks like a path, search for the file
+            fileId = (await this.findFile(id)) || id;
+        }
+        try {
+            const response = await drive.files.get({
+                fileId,
+                alt: 'media',
+            });
+            return response.data;
+        }
+        catch (error) {
+            if (this.isNotFoundError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if file exists in Google Drive
+     */
+    async exists(id) {
+        try {
+            const fileId = await this.findFile(id);
+            return fileId !== null;
+        }
+        catch (error) {
+            // Only treat "not found" as false, rethrow other errors
+            if (this.isNotFoundError(error)) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /**
+     * List files in the configured Google Drive folder
+     */
+    async list(prefix) {
+        const drive = await this.getClient();
+        const folderId = this.getParentFolderId();
+        const results = [];
+        let pageToken;
+        do {
+            let query = `'${folderId}' in parents and trashed = false`;
+            if (prefix) {
+                const escapedPrefix = this.escapeQueryString(prefix);
+                query += ` and name contains '${escapedPrefix}'`;
+            }
+            const response = await drive.files.list({
+                q: query,
+                fields: 'nextPageToken, files(id, name)',
+                spaces: 'drive',
+                pageToken,
+            });
+            if (response.data.files) {
+                for (const file of response.data.files) {
+                    if (file.name) {
+                        results.push(file.name);
+                    }
+                }
+            }
+            pageToken = response.data.nextPageToken ?? undefined;
+        } while (pageToken);
+        return results;
+    }
+    /**
+     * Delete file from Google Drive
+     */
+    async delete(id) {
+        const drive = await this.getClient();
+        // Check if id is a direct file ID or a path-like name
+        let fileId = id;
+        if (!this.isFileId(id)) {
+            fileId = (await this.findFile(id)) || id;
+        }
+        try {
+            await drive.files.delete({ fileId });
+        }
+        catch (error) {
+            // Ignore if file doesn't exist
+            if (!this.isNotFoundError(error)) {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Get a shareable URL for the file
+     */
+    async getUrl(id, _expiresIn) {
+        // Check if id is a direct file ID or a path-like name
+        let fileId = id;
+        if (!this.isFileId(id)) {
+            fileId = (await this.findFile(id)) || id;
+        }
+        // Return the standard Google Drive view URL
+        return `https://drive.google.com/file/d/${fileId}/view`;
+    }
+    /**
+     * Get the configured folder ID
+     */
+    getFolderId() {
+        return this.config.folderId || 'root';
+    }
+}
+exports.GDriveStorage = GDriveStorage;
+//# sourceMappingURL=gdrive.js.map

package/dist/file/gdrive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdrive.js","sourceRoot":"","sources":["../../src/file/gdrive.ts"],"names":[],"mappings":"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"}

package/dist/file/index.d.ts

@@ -2,8 +2,20 @@
  * @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)
  */
-export { FileManager } from './manager';
+export { FileManager, FileManagerOptions } from './manager';
 export { LocalStorage } from './local';
+export { S3Storage } from './s3';
+export { R2Storage } from './r2';
+export { GCSStorage } from './gcs';
+export { GDriveStorage } from './gdrive';
+export { createStorage, createStorageFromSource, sourceConfigToStorageConfig, getDefaultStorageType, } from './factory';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,cAAc,SAAS,CAAC"}

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"}