@fractary/core 0.3.2 → 0.4.0

package/dist/file/factory.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * @fractary/core - Storage Factory
+ *
+ * Factory function for creating storage backends based on configuration.
+ * Supports automatic configuration loading from .fractary/config.yaml.
+ */
+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.createStorage = createStorage;
+exports.sourceConfigToStorageConfig = sourceConfigToStorageConfig;
+exports.createStorageFromSource = createStorageFromSource;
+exports.getDefaultStorageType = getDefaultStorageType;
+const local_1 = require("./local");
+/**
+ * Create a storage backend from configuration
+ *
+ * @param config - Storage configuration
+ * @returns Storage instance
+ */
+function createStorage(config) {
+    switch (config.type) {
+        case 'local':
+            return new local_1.LocalStorage(config.basePath);
+        case 's3':
+            // Lazy load to avoid hard dependency
+            return createS3Storage(config);
+        case 'r2':
+            return createR2Storage(config);
+        case 'gcs':
+            return createGCSStorage(config);
+        case 'gdrive':
+            return createGDriveStorage(config);
+        default:
+            throw new Error(`Unsupported storage type: ${config.type}`);
+    }
+}
+/**
+ * Create S3 storage (with lazy module loading and instance caching)
+ */
+function createS3Storage(config) {
+    let cachedStorage = null;
+    return new Proxy({}, {
+        get(_target, prop) {
+            return async (...args) => {
+                if (!cachedStorage) {
+                    const { S3Storage } = await Promise.resolve().then(() => __importStar(require('./s3')));
+                    cachedStorage = new S3Storage(config);
+                }
+                return cachedStorage[prop](...args);
+            };
+        },
+    });
+}
+/**
+ * Create R2 storage (with lazy module loading and instance caching)
+ */
+function createR2Storage(config) {
+    let cachedStorage = null;
+    return new Proxy({}, {
+        get(_target, prop) {
+            return async (...args) => {
+                if (!cachedStorage) {
+                    const { R2Storage } = await Promise.resolve().then(() => __importStar(require('./r2')));
+                    cachedStorage = new R2Storage(config);
+                }
+                return cachedStorage[prop](...args);
+            };
+        },
+    });
+}
+/**
+ * Create GCS storage (with lazy module loading and instance caching)
+ */
+function createGCSStorage(config) {
+    let cachedStorage = null;
+    return new Proxy({}, {
+        get(_target, prop) {
+            return async (...args) => {
+                if (!cachedStorage) {
+                    const { GCSStorage } = await Promise.resolve().then(() => __importStar(require('./gcs')));
+                    cachedStorage = new GCSStorage(config);
+                }
+                return cachedStorage[prop](...args);
+            };
+        },
+    });
+}
+/**
+ * Create Google Drive storage (with lazy module loading and instance caching)
+ */
+function createGDriveStorage(config) {
+    let cachedStorage = null;
+    return new Proxy({}, {
+        get(_target, prop) {
+            return async (...args) => {
+                if (!cachedStorage) {
+                    const { GDriveStorage } = await Promise.resolve().then(() => __importStar(require('./gdrive')));
+                    cachedStorage = new GDriveStorage(config);
+                }
+                return cachedStorage[prop](...args);
+            };
+        },
+    });
+}
+/**
+ * Convert a source configuration from config.yaml to a StorageConfig
+ *
+ * @param source - Source configuration from config.yaml
+ * @returns StorageConfig for creating a storage backend
+ */
+function sourceConfigToStorageConfig(source) {
+    switch (source.type) {
+        case 'local':
+            return {
+                type: 'local',
+                basePath: source.local?.basePath || '.',
+            };
+        case 's3':
+            return {
+                type: 's3',
+                bucket: source.bucket,
+                region: source.region || 'us-east-1',
+                prefix: source.prefix,
+                auth: source.auth
+                    ? {
+                        profile: source.auth.profile,
+                        accessKeyId: expandEnvVar(source.auth.accessKeyId),
+                        secretAccessKey: expandEnvVar(source.auth.secretAccessKey),
+                    }
+                    : undefined,
+                publicUrl: source.publicUrl,
+            };
+        case 'r2':
+            return {
+                type: 'r2',
+                bucket: source.bucket,
+                accountId: expandEnvVar(source.accountId) || '',
+                accessKeyId: expandEnvVar(source.auth?.accessKeyId) || '',
+                secretAccessKey: expandEnvVar(source.auth?.secretAccessKey) || '',
+                prefix: source.prefix,
+                publicUrl: source.publicUrl,
+            };
+        case 'gcs':
+            return {
+                type: 'gcs',
+                bucket: source.bucket,
+                projectId: source.projectId || '',
+                prefix: source.prefix,
+                keyFilePath: expandEnvVar(source.auth?.keyFilePath),
+                region: source.region,
+            };
+        case 'gdrive':
+            return {
+                type: 'gdrive',
+                folderId: source.folderId,
+            };
+        default:
+            throw new Error(`Unsupported source type: ${source.type}`);
+    }
+}
+/**
+ * Expand environment variable references in a string
+ *
+ * @param value - String potentially containing ${VAR_NAME} references
+ * @returns Expanded string with environment variable values
+ */
+function expandEnvVar(value) {
+    if (!value)
+        return value;
+    // Match ${VAR_NAME} pattern
+    return value.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+        return process.env[varName] || '';
+    });
+}
+/**
+ * Create a storage backend from a named source in config.yaml
+ *
+ * @param sourceName - Name of the source (e.g., 'specs', 'logs')
+ * @param fileConfig - File plugin configuration from config.yaml
+ * @returns Storage instance
+ */
+function createStorageFromSource(sourceName, fileConfig) {
+    const source = fileConfig.sources?.[sourceName];
+    if (!source) {
+        throw new Error(`Source '${sourceName}' not found in configuration. Available sources: ${Object.keys(fileConfig.sources || {}).join(', ') || 'none'}`);
+    }
+    const storageConfig = sourceConfigToStorageConfig(source);
+    return createStorage(storageConfig);
+}
+/**
+ * Get the default storage type based on configuration
+ *
+ * @param fileConfig - File plugin configuration
+ * @returns Default storage type
+ */
+function getDefaultStorageType(fileConfig) {
+    if (!fileConfig?.sources) {
+        return 'local';
+    }
+    // Return the type of the first source, or 'local' if none
+    const sources = Object.values(fileConfig.sources);
+    return sources.length > 0 ? sources[0].type : 'local';
+}
+//# sourceMappingURL=factory.js.map

package/dist/file/factory.js.map

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

package/dist/file/gcs.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fractary/core - GCS Storage Implementation
+ *
+ * Google Cloud Storage backend for file operations.
+ * Uses @google-cloud/storage with lazy loading.
+ */
+import { Storage, GCSStorageConfig } from './types';
+/**
+ * Google Cloud Storage implementation
+ */
+export declare class GCSStorage implements Storage {
+    private config;
+    private storageClient;
+    private bucket;
+    constructor(config: GCSStorageConfig);
+    /**
+     * Get or create the GCS client (lazy loaded)
+     */
+    private getClient;
+    /**
+     * Get the full GCS path with optional prefix
+     */
+    private getPath;
+    /**
+     * Check if an error is a "not found" error
+     * Google Cloud SDK uses error.code (number) or error.errors[].reason
+     */
+    private isNotFoundError;
+    /**
+     * Write content to GCS
+     */
+    write(id: string, content: string): Promise<string>;
+    /**
+     * Read content from GCS
+     */
+    read(id: string): Promise<string | null>;
+    /**
+     * Check if object exists in GCS
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * List objects in GCS with optional prefix
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Delete object from GCS
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get a signed URL for the object
+     */
+    getUrl(id: string, expiresIn?: number): Promise<string | null>;
+    /**
+     * Get the bucket name
+     */
+    getBucket(): string;
+    /**
+     * Get the project ID
+     */
+    getProjectId(): string;
+    /**
+     * Get the configured prefix
+     */
+    getPrefix(): string | undefined;
+}
+//# sourceMappingURL=gcs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/file/gcs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAMpD;;GAEG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,MAAM,CAA0B;gBAE5B,MAAM,EAAE,gBAAgB;IAIpC;;OAEG;YACW,SAAS;IA8BvB;;OAEG;IACH,OAAO,CAAC,OAAO;IAOf;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAazD;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqB9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1C;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevC;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkB3E;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;CAGhC"}

package/dist/file/gcs.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * @fractary/core - GCS Storage Implementation
+ *
+ * Google Cloud Storage backend for file operations.
+ * Uses @google-cloud/storage with lazy loading.
+ */
+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.GCSStorage = void 0;
+/**
+ * Google Cloud Storage implementation
+ */
+class GCSStorage {
+    config;
+    storageClient = null;
+    bucket = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get or create the GCS client (lazy loaded)
+     */
+    async getClient() {
+        if (this.storageClient && this.bucket) {
+            return { storage: this.storageClient, bucket: this.bucket };
+        }
+        try {
+            // Dynamic import to avoid hard dependency
+            const { Storage: GCStorage } = await Promise.resolve().then(() => __importStar(require('@google-cloud/storage')));
+            const clientConfig = {
+                projectId: this.config.projectId,
+            };
+            // Use key file if provided
+            if (this.config.keyFilePath) {
+                clientConfig.keyFilename = this.config.keyFilePath;
+            }
+            // Otherwise, use Application Default Credentials (ADC)
+            this.storageClient = new GCStorage(clientConfig);
+            this.bucket = this.storageClient.bucket(this.config.bucket);
+            return { storage: this.storageClient, bucket: this.bucket };
+        }
+        catch (error) {
+            throw new Error('Google Cloud Storage SDK not available. Install with: npm install @google-cloud/storage');
+        }
+    }
+    /**
+     * Get the full GCS path with optional prefix
+     */
+    getPath(id) {
+        if (this.config.prefix) {
+            return `${this.config.prefix.replace(/\/$/, '')}/${id}`;
+        }
+        return id;
+    }
+    /**
+     * Check if an error is a "not found" error
+     * Google Cloud SDK uses error.code (number) or error.errors[].reason
+     */
+    isNotFoundError(error) {
+        return (error.code === 404 ||
+            error.code === 'ENOENT' ||
+            error.errors?.some((e) => e.reason === 'notFound'));
+    }
+    /**
+     * Write content to GCS
+     */
+    async write(id, content) {
+        const { bucket } = await this.getClient();
+        const path = this.getPath(id);
+        const file = bucket.file(path);
+        await file.save(content, {
+            contentType: 'text/plain; charset=utf-8',
+            resumable: false,
+        });
+        return `gs://${this.config.bucket}/${path}`;
+    }
+    /**
+     * Read content from GCS
+     */
+    async read(id) {
+        const { bucket } = await this.getClient();
+        const path = this.getPath(id);
+        const file = bucket.file(path);
+        try {
+            const [exists] = await file.exists();
+            if (!exists) {
+                return null;
+            }
+            const [contents] = await file.download();
+            return contents.toString('utf-8');
+        }
+        catch (error) {
+            if (this.isNotFoundError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if object exists in GCS
+     */
+    async exists(id) {
+        const { bucket } = await this.getClient();
+        const path = this.getPath(id);
+        const file = bucket.file(path);
+        try {
+            const [exists] = await file.exists();
+            return exists;
+        }
+        catch (error) {
+            // Only treat "not found" as false, rethrow other errors
+            if (this.isNotFoundError(error)) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /**
+     * List objects in GCS with optional prefix
+     */
+    async list(prefix) {
+        const { bucket } = await this.getClient();
+        const fullPrefix = prefix ? this.getPath(prefix) : this.config.prefix || '';
+        const [files] = await bucket.getFiles({
+            prefix: fullPrefix,
+        });
+        return files.map((file) => {
+            let name = file.name;
+            // Remove the configured prefix from the path for consistency
+            if (this.config.prefix && name.startsWith(this.config.prefix)) {
+                name = name.slice(this.config.prefix.length).replace(/^\//, '');
+            }
+            return name;
+        });
+    }
+    /**
+     * Delete object from GCS
+     */
+    async delete(id) {
+        const { bucket } = await this.getClient();
+        const path = this.getPath(id);
+        const file = bucket.file(path);
+        try {
+            await file.delete();
+        }
+        catch (error) {
+            // Ignore if file doesn't exist
+            if (!this.isNotFoundError(error)) {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Get a signed URL for the object
+     */
+    async getUrl(id, expiresIn = 86400) {
+        const { bucket } = await this.getClient();
+        const path = this.getPath(id);
+        const file = bucket.file(path);
+        try {
+            const [url] = await file.getSignedUrl({
+                version: 'v4',
+                action: 'read',
+                expires: Date.now() + expiresIn * 1000,
+            });
+            return url;
+        }
+        catch (error) {
+            // Fall back to gs:// URI if signing fails (e.g., no key file)
+            return `gs://${this.config.bucket}/${path}`;
+        }
+    }
+    /**
+     * Get the bucket name
+     */
+    getBucket() {
+        return this.config.bucket;
+    }
+    /**
+     * Get the project ID
+     */
+    getProjectId() {
+        return this.config.projectId;
+    }
+    /**
+     * Get the configured prefix
+     */
+    getPrefix() {
+        return this.config.prefix;
+    }
+}
+exports.GCSStorage = GCSStorage;
+//# sourceMappingURL=gcs.js.map

package/dist/file/gcs.js.map

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

package/dist/file/gdrive.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @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.
+ */
+import { Storage, GDriveStorageConfig } from './types';
+/**
+ * Google Drive storage implementation
+ */
+export declare class GDriveStorage implements Storage {
+    private config;
+    private driveClient;
+    constructor(config: GDriveStorageConfig);
+    /**
+     * Get or create the Google Drive client (lazy loaded)
+     */
+    private getClient;
+    /**
+     * Get the parent folder ID (internal helper)
+     */
+    private getParentFolderId;
+    /**
+     * Extract file name from path-like ID
+     */
+    private getFileName;
+    /**
+     * Escape a string for use in Google Drive query syntax
+     * Single quotes must be escaped with backslash
+     */
+    private escapeQueryString;
+    /**
+     * Check if a string looks like a Google Drive file ID
+     * Drive file IDs are typically 28-44 characters, alphanumeric with - and _
+     */
+    private isFileId;
+    /**
+     * Check if an error is a "not found" error
+     * Google APIs uses error.code (number) or error.errors[].reason
+     */
+    private isNotFoundError;
+    /**
+     * Find a file by name in the configured folder
+     */
+    private findFile;
+    /**
+     * Write content to Google Drive
+     */
+    write(id: string, content: string): Promise<string>;
+    /**
+     * Read content from Google Drive
+     */
+    read(id: string): Promise<string | null>;
+    /**
+     * Check if file exists in Google Drive
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * List files in the configured Google Drive folder
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Delete file from Google Drive
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get a shareable URL for the file
+     */
+    getUrl(id: string, _expiresIn?: number): Promise<string | null>;
+    /**
+     * Get the configured folder ID
+     */
+    getFolderId(): string;
+}
+//# sourceMappingURL=gdrive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gdrive.d.ts","sourceRoot":"","sources":["../../src/file/gdrive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAMvD;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,EAAE,mBAAmB;IAIvC;;OAEG;YACW,SAAS;IA0CvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAKhB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;YACW,QAAQ;IAmBtB;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+CzD;;OAEG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyB9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1C;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkC9C;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvC;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWrE;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}