@fractary/core 0.3.3 → 0.5.0

package/dist/factories.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * @fractary/core - Manager Factories
+ *
+ * Factory functions for creating authenticated managers.
+ * Provides a convenient way to create WorkManager and RepoManager
+ * with automatic configuration loading and authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkManager = createWorkManager;
+exports.createRepoManager = createRepoManager;
+exports.createManagers = createManagers;
+const work_1 = require("./work");
+const repo_1 = require("./repo");
+const loader_1 = require("./config/loader");
+const errors_1 = require("./common/errors");
+/** Regex pattern for valid GitHub owner/repo format */
+const PROJECT_FORMAT_REGEX = /^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/;
+/**
+ * Validate and parse project string into owner/repo
+ *
+ * @param project Project string in "owner/repo" format
+ * @returns Tuple of [owner, repo] or null if invalid
+ * @throws ConfigurationError if format is invalid
+ */
+function parseProject(project) {
+    if (!project || typeof project !== 'string') {
+        throw new errors_1.ConfigurationError('Invalid project configuration: project must be a non-empty string', { project });
+    }
+    const trimmed = project.trim();
+    if (!PROJECT_FORMAT_REGEX.test(trimmed)) {
+        throw new errors_1.ConfigurationError(`Invalid project format: "${project}". Expected "owner/repo" format (e.g., "fractary/core")`, { project });
+    }
+    const parts = trimmed.split('/');
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new errors_1.ConfigurationError(`Invalid project format: "${project}". Expected exactly one "/" separator`, { project });
+    }
+    return [parts[0], parts[1]];
+}
+/**
+ * Build WorkConfig from LoadedConfig
+ *
+ * @param config Loaded configuration
+ * @param token Token from token provider (if available)
+ * @returns WorkConfig for WorkManager
+ * @throws ConfigurationError if project format is invalid
+ */
+function buildWorkConfig(config, token) {
+    // Get platform from work config or default to github
+    const workConfig = config.work;
+    const activeHandler = workConfig?.active_handler || 'github';
+    // Map active_handler to platform
+    const platform = activeHandler;
+    // Get handler-specific config
+    const handlerConfig = workConfig?.handlers?.[activeHandler] || {};
+    // Extract owner/repo from project string if needed
+    let owner = handlerConfig.owner;
+    let repo = handlerConfig.repo;
+    const project = handlerConfig.project || config.github?.project;
+    // Parse and validate project format if we need to extract owner/repo
+    if (!owner && !repo && project) {
+        [owner, repo] = parseProject(project);
+    }
+    return {
+        platform,
+        owner,
+        repo,
+        project: project,
+        token: token || handlerConfig.token || config.github?.token,
+    };
+}
+/**
+ * Build RepoConfig from LoadedConfig
+ *
+ * @param config Loaded configuration
+ * @param token Token from token provider (if available)
+ * @returns RepoConfig for RepoManager
+ * @throws ConfigurationError if project format is invalid
+ */
+function buildRepoConfig(config, token) {
+    // Get platform from repo config or default to github
+    const repoConfig = config.repo;
+    const activeHandler = repoConfig?.active_handler || 'github';
+    // Map active_handler to platform
+    const platform = activeHandler;
+    // Get handler-specific config
+    const handlerConfig = repoConfig?.handlers?.[activeHandler] || {};
+    // Get defaults
+    const defaults = repoConfig?.defaults || {};
+    // Extract owner/repo from project string if needed
+    let owner = handlerConfig.owner;
+    let repo = handlerConfig.repo;
+    const project = handlerConfig.project || config.github?.project;
+    // Parse and validate project format if we need to extract owner/repo
+    if (!owner && !repo && project) {
+        [owner, repo] = parseProject(project);
+    }
+    return {
+        platform,
+        owner,
+        repo,
+        defaultBranch: defaults.default_branch || handlerConfig.default_branch,
+        token: token || handlerConfig.token || config.github?.token,
+        branchPrefixes: defaults.branch_naming?.prefixes,
+    };
+}
+/**
+ * Create an authenticated WorkManager
+ *
+ * Loads configuration automatically and creates a WorkManager
+ * with proper authentication.
+ *
+ * @param options Creation options
+ * @returns Configured WorkManager instance
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - auto-loads config and auth
+ * const workManager = await createWorkManager();
+ * const issues = await workManager.searchIssues('bug');
+ *
+ * // With pre-loaded config
+ * const config = await loadConfig();
+ * const workManager = await createWorkManager({ config });
+ * ```
+ */
+async function createWorkManager(options = {}) {
+    const { config: providedConfig, skipAuth = false } = options;
+    // Load config if not provided
+    const config = providedConfig || await (0, loader_1.loadConfig)({ skipAuth });
+    // Get token from provider if available
+    let token;
+    if (!skipAuth && config.tokenProvider) {
+        try {
+            token = await config.tokenProvider.getToken();
+        }
+        catch {
+            // Token provider failed - continue without token
+            // The manager will fall back to gh CLI auth
+        }
+    }
+    // Build WorkConfig
+    const workConfig = buildWorkConfig(config, token);
+    return new work_1.WorkManager(workConfig);
+}
+/**
+ * Create an authenticated RepoManager
+ *
+ * Loads configuration automatically and creates a RepoManager
+ * with proper authentication.
+ *
+ * @param options Creation options
+ * @returns Configured RepoManager instance
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - auto-loads config and auth
+ * const repoManager = await createRepoManager();
+ * const status = repoManager.getStatus();
+ *
+ * // With explicit working directory
+ * const repoManager = await createRepoManager({ cwd: '/path/to/repo' });
+ *
+ * // With pre-loaded config
+ * const config = await loadConfig();
+ * const repoManager = await createRepoManager({ config });
+ * ```
+ */
+async function createRepoManager(options = {}) {
+    const { config: providedConfig, cwd, skipAuth = false } = options;
+    // Load config if not provided
+    const config = providedConfig || await (0, loader_1.loadConfig)({ skipAuth });
+    // Get token from provider if available
+    let token;
+    if (!skipAuth && config.tokenProvider) {
+        try {
+            token = await config.tokenProvider.getToken();
+        }
+        catch {
+            // Token provider failed - continue without token
+            // The manager will fall back to gh CLI auth
+        }
+    }
+    // Build RepoConfig
+    const repoConfig = buildRepoConfig(config, token);
+    return new repo_1.RepoManager(repoConfig, cwd);
+}
+/**
+ * Create both WorkManager and RepoManager with shared config
+ *
+ * Useful when you need both managers and want to share
+ * configuration and authentication.
+ *
+ * @param options Creation options
+ * @returns Object with both managers
+ *
+ * @example
+ * ```typescript
+ * const { work, repo } = await createManagers();
+ *
+ * // Fetch issue and create branch
+ * const issue = await work.fetchIssue(123);
+ * await repo.createBranch(`feature/${issue.number}-${slug(issue.title)}`);
+ * ```
+ */
+async function createManagers(options = {}) {
+    const { config: providedConfig, cwd, skipAuth = false } = options;
+    // Load config once
+    const config = providedConfig || await (0, loader_1.loadConfig)({ skipAuth });
+    // Get token once
+    let token;
+    if (!skipAuth && config.tokenProvider) {
+        try {
+            token = await config.tokenProvider.getToken();
+        }
+        catch {
+            // Token provider failed - continue without token
+        }
+    }
+    // Build configs
+    const workConfig = buildWorkConfig(config, token);
+    const repoConfig = buildRepoConfig(config, token);
+    return {
+        work: new work_1.WorkManager(workConfig),
+        repo: new repo_1.RepoManager(repoConfig, cwd),
+    };
+}
+//# sourceMappingURL=factories.js.map

package/dist/factories.js.map

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

package/dist/file/factory.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fractary/core - Storage Factory
+ *
+ * Factory function for creating storage backends based on configuration.
+ * Supports automatic configuration loading from .fractary/config.yaml.
+ */
+import { Storage, StorageConfig, StorageType, SourceConfig } from './types';
+/**
+ * Create a storage backend from configuration
+ *
+ * @param config - Storage configuration
+ * @returns Storage instance
+ */
+export declare function createStorage(config: StorageConfig): Storage;
+/**
+ * Convert a source configuration from config.yaml to a StorageConfig
+ *
+ * @param source - Source configuration from config.yaml
+ * @returns StorageConfig for creating a storage backend
+ */
+export declare function sourceConfigToStorageConfig(source: SourceConfig): StorageConfig;
+/**
+ * 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
+ */
+export declare function createStorageFromSource(sourceName: string, fileConfig: {
+    sources?: Record<string, SourceConfig>;
+}): Storage;
+/**
+ * Get the default storage type based on configuration
+ *
+ * @param fileConfig - File plugin configuration
+ * @returns Default storage type
+ */
+export declare function getDefaultStorageType(fileConfig?: {
+    sources?: Record<string, SourceConfig>;
+}): StorageType;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/file/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EAMX,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAqB5D;AA8ED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAsD/E;AAiBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GACrD,OAAO,CAaT;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GACtD,WAAW,CAQb"}

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