opkg 0.9.0 → 0.9.2

package/packages/core/dist/core/auth.js

@@ -0,0 +1,132 @@
+import { profileManager } from './profiles.js';
+import { logger } from '../utils/logger.js';
+import { ConfigError } from '../utils/errors.js';
+import { getVersion } from '../utils/package.js';
+/**
+ * Authentication management for OpenPackage CLI
+ * Handles credential resolution and validation
+ */
+class AuthManager {
+    /**
+     * Get API key following credential precedence:
+     * 1. Command line options (--api-key)
+     * 2. Profile credentials file (explicit profile, env var, or default)
+     *
+     * If an explicit profile is requested via options.profile but doesn't exist
+     * or has no credentials, an error is thrown instead of falling back to default.
+     */
+    async getApiKey(options = {}) {
+        try {
+            if (options.apiKey !== undefined) {
+                if (!options.apiKey || options.apiKey.trim() === '') {
+                    throw new ConfigError('API key provided via --api-key is empty. Please provide a valid API key.');
+                }
+                logger.debug('Using API key from command line options');
+                return options.apiKey;
+            }
+            const profileName = options.profile || process.env.OPENPACKAGEPROFILE || 'default';
+            const isExplicitProfile = !!options.profile;
+            logger.debug(`Using profile: ${profileName}${isExplicitProfile ? ' (explicit)' : ''}`);
+            const profile = await profileManager.getProfile(profileName);
+            if (profile?.credentials?.api_key) {
+                logger.debug(`Using API key from profile: ${profileName}`);
+                return profile.credentials.api_key;
+            }
+            if (isExplicitProfile) {
+                if (!profile) {
+                    throw new ConfigError(`Profile '${profileName}' not found. Please configure it with "opkg configure --profile ${profileName}"`);
+                }
+                if (!profile.credentials?.api_key) {
+                    throw new ConfigError(`Profile '${profileName}' has no API key configured. Please configure it with "opkg configure --profile ${profileName}"`);
+                }
+            }
+            if (profileName !== 'default') {
+                const defaultProfile = await profileManager.getProfile('default');
+                if (defaultProfile?.credentials?.api_key) {
+                    logger.debug('Using API key from default profile');
+                    return defaultProfile.credentials.api_key;
+                }
+            }
+            logger.warn('No API key found in any credential source');
+            return null;
+        }
+        catch (error) {
+            logger.error('Failed to get API key', { error });
+            if (error instanceof ConfigError) {
+                throw error;
+            }
+            throw new ConfigError(`Failed to get API key: ${error}`);
+        }
+    }
+    getRegistryUrl() {
+        const registryUrl = 'https://backend.openpackage.dev/v1';
+        // const registryUrl = 'http://localhost:3000/v1'
+        logger.debug(`Using registry URL: ${registryUrl}`);
+        return registryUrl;
+    }
+    async validateAuth(options = {}) {
+        const registryUrl = this.getRegistryUrl();
+        const apiKey = await this.getApiKey(options);
+        if (!apiKey) {
+            throw new ConfigError('No authentication found. Run "opkg login" to configure a profile API key.');
+        }
+        return { registryUrl };
+    }
+    getCurrentProfile(options = {}) {
+        if (options.apiKey !== undefined && options.apiKey) {
+            return '<api-key>';
+        }
+        return options.profile || process.env.OPENPACKAGEPROFILE || 'default';
+    }
+    async isAuthenticated(options = {}) {
+        try {
+            const registryUrl = this.getRegistryUrl();
+            if (!registryUrl) {
+                return false;
+            }
+            const apiKey = await this.getApiKey(options);
+            return !!apiKey;
+        }
+        catch (error) {
+            logger.debug('Authentication check failed', { error });
+            return false;
+        }
+    }
+    async getAuthHeaders(options = {}) {
+        const registryUrl = this.getRegistryUrl();
+        if (!registryUrl) {
+            throw new ConfigError('Registry URL is not configured');
+        }
+        const apiKey = await this.getApiKey(options);
+        if (apiKey) {
+            return {
+                'X-API-Key': apiKey,
+                'User-Agent': `openpackage-cli/${getVersion()}`,
+            };
+        }
+        throw new ConfigError('No authentication found. Run "opkg login" to configure a profile API key.');
+    }
+    async getAuthInfo(options = {}) {
+        const profile = this.getCurrentProfile(options);
+        const apiKey = await this.getApiKey(options);
+        const registryUrl = this.getRegistryUrl();
+        let source = 'none';
+        if (options.apiKey) {
+            source = 'command-line';
+        }
+        else if (apiKey) {
+            source = 'profile';
+        }
+        return {
+            profile,
+            hasApiKey: !!apiKey,
+            hasRegistryUrl: !!registryUrl,
+            source,
+        };
+    }
+}
+// Create and export a singleton instance
+export const authManager = new AuthManager();
+// Export the class for testing purposes
+export { AuthManager };
+//# sourceMappingURL=auth.js.map

package/packages/core/dist/core/auth.js.map

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

package/packages/core/dist/core/cache-manager.d.ts

@@ -0,0 +1,22 @@
+export interface CachedRefEntry {
+    commit: string;
+    fetchedAt: string;
+}
+export interface GitRefCache {
+    refs: Record<string, CachedRefEntry>;
+}
+export interface CachedMetadata {
+    versions: string[];
+    fetchedAt: string;
+    etag?: string;
+}
+export interface CacheManager {
+    getCachedCommitForRef(url: string, ref: string): Promise<string | null>;
+    cacheRefCommit(url: string, ref: string, commit: string): Promise<void>;
+    getLocalPackagePath(name: string, version: string): Promise<string | null>;
+    hasLocalPackage(name: string, version: string): Promise<boolean>;
+    getCachedMetadata(name: string): Promise<CachedMetadata | null>;
+    cacheMetadata(name: string, versions: string[], etag?: string): Promise<void>;
+}
+export declare function createCacheManager(): CacheManager;
+//# sourceMappingURL=cache-manager.d.ts.map

package/packages/core/dist/core/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/core/cache-manager.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxE,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AA6CD,wBAAgB,kBAAkB,IAAI,YAAY,CA4EjD"}

package/packages/core/dist/core/cache-manager.js

@@ -0,0 +1,104 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { exists, ensureDir, readTextFile, writeTextFile } from '../utils/fs.js';
+import { computeGitUrlHash } from '../utils/git-cache.js';
+import { logger } from '../utils/logger.js';
+import { getPackageVersionPath } from './directory.js';
+const METADATA_TTL_MS = 10 * 60 * 1000; // 10 minutes
+function getGitRefsCacheDir() {
+    return join(homedir(), '.openpackage', 'cache', 'git-refs');
+}
+function getMetadataCacheDir() {
+    return join(homedir(), '.openpackage', 'cache', 'metadata');
+}
+function getGitRefCachePath(url) {
+    const urlHash = computeGitUrlHash(url);
+    return join(getGitRefsCacheDir(), `${urlHash}.json`);
+}
+function getMetadataCachePath(name) {
+    const safeName = name.replace(/\//g, '__');
+    return join(getMetadataCacheDir(), `${safeName}.json`);
+}
+function isExpired(fetchedAt, ttlMs) {
+    const fetchedTime = new Date(fetchedAt).getTime();
+    return Date.now() - fetchedTime > ttlMs;
+}
+async function readJsonFile(filePath) {
+    if (!(await exists(filePath))) {
+        return null;
+    }
+    try {
+        const content = await readTextFile(filePath);
+        return JSON.parse(content);
+    }
+    catch (error) {
+        logger.warn(`Failed to read cache file at ${filePath}`, { error });
+        return null;
+    }
+}
+async function writeJsonFile(filePath, data) {
+    const dir = join(filePath, '..');
+    await ensureDir(dir);
+    await writeTextFile(filePath, JSON.stringify(data, null, 2));
+}
+export function createCacheManager() {
+    return {
+        async getCachedCommitForRef(url, ref) {
+            const cachePath = getGitRefCachePath(url);
+            const cache = await readJsonFile(cachePath);
+            if (!cache?.refs?.[ref]) {
+                return null;
+            }
+            // Return cached commit - caller decides whether to trust based on ref immutability
+            // (git-clone.ts only uses this for immutable refs like semver tags)
+            return cache.refs[ref].commit;
+        },
+        async cacheRefCommit(url, ref, commit) {
+            const cachePath = getGitRefCachePath(url);
+            let cache = await readJsonFile(cachePath);
+            if (!cache) {
+                cache = { refs: {} };
+            }
+            cache.refs[ref] = {
+                commit,
+                fetchedAt: new Date().toISOString(),
+            };
+            await writeJsonFile(cachePath, cache);
+            logger.debug(`Cached git ref ${ref} -> ${commit.substring(0, 7)}`, { url });
+        },
+        async getLocalPackagePath(name, version) {
+            const packagePath = getPackageVersionPath(name, version);
+            if (await exists(packagePath)) {
+                return packagePath;
+            }
+            return null;
+        },
+        async hasLocalPackage(name, version) {
+            const packagePath = getPackageVersionPath(name, version);
+            return await exists(packagePath);
+        },
+        async getCachedMetadata(name) {
+            const cachePath = getMetadataCachePath(name);
+            const cache = await readJsonFile(cachePath);
+            if (!cache) {
+                return null;
+            }
+            if (isExpired(cache.fetchedAt, METADATA_TTL_MS)) {
+                logger.debug(`Metadata cache expired for ${name}`, { fetchedAt: cache.fetchedAt });
+                return null;
+            }
+            return cache;
+        },
+        async cacheMetadata(name, versions, etag) {
+            const cachePath = getMetadataCachePath(name);
+            const cache = {
+                versions,
+                fetchedAt: new Date().toISOString(),
+                ...(etag && { etag }),
+            };
+            await writeJsonFile(cachePath, cache);
+            logger.debug(`Cached metadata for ${name}`, { versionCount: versions.length });
+        },
+    };
+}
+//# sourceMappingURL=cache-manager.js.map

package/packages/core/dist/core/cache-manager.js.map

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

package/packages/core/dist/core/config.d.ts

@@ -0,0 +1,64 @@
+import { OpenPackageConfig, OpenPackageDirectories } from '../types/index.js';
+declare class ConfigManager {
+    private config;
+    private configPath;
+    private openPackageDirs;
+    constructor();
+    /**
+     * Find the existing config file (supports both .json and .jsonc)
+     * Returns the path to the existing config file, or null if none exists
+     */
+    private findConfigFile;
+    /**
+     * Get the config path to use for saving
+     * If a config file already exists, use that format
+     * Otherwise, use the default format (JSONC)
+     */
+    private getConfigPath;
+    /**
+     * Load configuration from file, create default if it doesn't exist
+     */
+    load(): Promise<OpenPackageConfig>;
+    /**
+     * Save current configuration to file
+     * Uses JSONC format for new files, preserves existing format
+     */
+    save(): Promise<void>;
+    /**
+     * Get a configuration value
+     */
+    get<K extends keyof OpenPackageConfig>(key: K): Promise<OpenPackageConfig[K]>;
+    /**
+     * Set a configuration value
+     */
+    set<K extends keyof OpenPackageConfig>(key: K, value: OpenPackageConfig[K]): Promise<void>;
+    /**
+     * Get all configuration values
+     */
+    getAll(): Promise<OpenPackageConfig>;
+    /**
+     * Reset configuration to defaults
+     */
+    reset(): Promise<void>;
+    /**
+     * Validate configuration
+     */
+    validate(): Promise<boolean>;
+    /**
+     * Get the configuration file path
+     * Returns the path that will be used for the config file
+     */
+    getConfigFilePath(): Promise<string>;
+    /**
+     * Get OpenPackage directories
+     */
+    getDirectories(): OpenPackageDirectories;
+    /**
+     * Get telemetry disabled setting
+     * Returns undefined if not set in config
+     */
+    getTelemetryDisabled(): Promise<boolean | undefined>;
+}
+export declare const configManager: ConfigManager;
+export { ConfigManager };
+//# sourceMappingURL=config.d.ts.map

package/packages/core/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAqB9E,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAyB;;IAMhD;;;OAGG;YACW,cAAc;IAU5B;;;;OAIG;YACW,aAAa;IAiB3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiCxC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAKnF;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,MAAM,iBAAiB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhG;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAI1C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBlC;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1C;;OAEG;IACH,cAAc,IAAI,sBAAsB;IAIxC;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;CAK3D;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/packages/core/dist/core/config.js

@@ -0,0 +1,189 @@
+import { join, extname } from 'path';
+import { readJsonOrJsoncFile, writeJsoncFile, writeJsonFile, exists } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+import { ConfigError } from '../utils/errors.js';
+import { getOpenPackageDirectories } from './directory.js';
+/**
+ * Configuration management for the OpenPackage CLI
+ * Supports both JSON and JSONC formats
+ */
+const CONFIG_FILE_NAMES = ['config.jsonc', 'config.json'];
+const DEFAULT_CONFIG_FILE = 'config.jsonc'; // Use JSONC by default for new configs
+// Default configuration values
+const DEFAULT_CONFIG = {
+    defaults: {
+        license: 'MIT'
+    }
+};
+class ConfigManager {
+    constructor() {
+        this.config = null;
+        this.configPath = null;
+        this.openPackageDirs = getOpenPackageDirectories();
+    }
+    /**
+     * Find the existing config file (supports both .json and .jsonc)
+     * Returns the path to the existing config file, or null if none exists
+     */
+    async findConfigFile() {
+        for (const fileName of CONFIG_FILE_NAMES) {
+            const path = join(this.openPackageDirs.config, fileName);
+            if (await exists(path)) {
+                return path;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get the config path to use for saving
+     * If a config file already exists, use that format
+     * Otherwise, use the default format (JSONC)
+     */
+    async getConfigPath() {
+        if (this.configPath) {
+            return this.configPath;
+        }
+        // Check if a config file already exists
+        const existingPath = await this.findConfigFile();
+        if (existingPath) {
+            this.configPath = existingPath;
+            return existingPath;
+        }
+        // No existing config, use default
+        this.configPath = join(this.openPackageDirs.config, DEFAULT_CONFIG_FILE);
+        return this.configPath;
+    }
+    /**
+     * Load configuration from file, create default if it doesn't exist
+     */
+    async load() {
+        if (this.config) {
+            return this.config;
+        }
+        try {
+            const configPath = await this.findConfigFile();
+            if (configPath) {
+                logger.debug(`Loading config from: ${configPath}`);
+                const fileConfig = await readJsonOrJsoncFile(configPath);
+                this.configPath = configPath;
+                this.config = {
+                    ...DEFAULT_CONFIG,
+                    ...fileConfig,
+                    defaults: {
+                        ...DEFAULT_CONFIG.defaults,
+                        ...(fileConfig.defaults ?? {})
+                    }
+                };
+            }
+            else {
+                logger.debug('Config file not found, using defaults');
+                this.config = { ...DEFAULT_CONFIG };
+                await this.save(); // Create the config file with defaults
+            }
+            return this.config;
+        }
+        catch (error) {
+            logger.error('Failed to load configuration', { error });
+            throw new ConfigError(`Failed to load configuration: ${error}`);
+        }
+    }
+    /**
+     * Save current configuration to file
+     * Uses JSONC format for new files, preserves existing format
+     */
+    async save() {
+        if (!this.config) {
+            throw new ConfigError('No configuration loaded to save');
+        }
+        try {
+            const configPath = await this.getConfigPath();
+            const ext = extname(configPath);
+            logger.debug(`Saving config to: ${configPath}`);
+            // Write in JSONC format if the extension is .jsonc, otherwise use JSON
+            if (ext === '.jsonc') {
+                await writeJsoncFile(configPath, this.config);
+            }
+            else {
+                await writeJsonFile(configPath, this.config);
+            }
+        }
+        catch (error) {
+            logger.error('Failed to save configuration', { error, configPath: this.configPath });
+            throw new ConfigError(`Failed to save configuration: ${error}`);
+        }
+    }
+    /**
+     * Get a configuration value
+     */
+    async get(key) {
+        const config = await this.load();
+        return config[key];
+    }
+    /**
+     * Set a configuration value
+     */
+    async set(key, value) {
+        const config = await this.load();
+        config[key] = value;
+        this.config = config;
+        await this.save();
+        logger.info(`Configuration updated: ${key} = ${value}`);
+    }
+    /**
+     * Get all configuration values
+     */
+    async getAll() {
+        return await this.load();
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    async reset() {
+        this.config = { ...DEFAULT_CONFIG };
+        await this.save();
+        logger.info('Configuration reset to defaults');
+    }
+    /**
+     * Validate configuration
+     */
+    async validate() {
+        try {
+            const config = await this.load();
+            // Basic validation - config structure is valid
+            if (typeof config !== 'object' || config === null) {
+                throw new ConfigError('Invalid configuration structure');
+            }
+            return true;
+        }
+        catch (error) {
+            logger.error('Configuration validation failed', { error });
+            return false;
+        }
+    }
+    /**
+     * Get the configuration file path
+     * Returns the path that will be used for the config file
+     */
+    async getConfigFilePath() {
+        return await this.getConfigPath();
+    }
+    /**
+     * Get OpenPackage directories
+     */
+    getDirectories() {
+        return this.openPackageDirs;
+    }
+    /**
+     * Get telemetry disabled setting
+     * Returns undefined if not set in config
+     */
+    async getTelemetryDisabled() {
+        const config = await this.load();
+        return config.telemetry?.disabled;
+    }
+}
+// Create and export a singleton instance
+export const configManager = new ConfigManager();
+// Export the class for testing purposes
+export { ConfigManager };
+//# sourceMappingURL=config.js.map

package/packages/core/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;GAGG;AAEH,MAAM,iBAAiB,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;AAC1D,MAAM,mBAAmB,GAAG,cAAc,CAAC,CAAC,uCAAuC;AAEnF,+BAA+B;AAC/B,MAAM,cAAc,GAAsB;IACxC,QAAQ,EAAE;QACR,OAAO,EAAE,KAAK;KACf;CACF,CAAC;AAEF,MAAM,aAAa;IAKjB;QAJQ,WAAM,GAA6B,IAAI,CAAC;QACxC,eAAU,GAAkB,IAAI,CAAC;QAIvC,IAAI,CAAC,eAAe,GAAG,yBAAyB,EAAE,CAAC;IACrD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc;QAC1B,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACzD,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,UAAU,CAAC;QACzB,CAAC;QAED,wCAAwC;QACxC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QACjD,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,kCAAkC;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAE/C,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;gBACnD,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAoB,UAAU,CAAC,CAAC;gBAC5E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;gBAC7B,IAAI,CAAC,MAAM,GAAG;oBACZ,GAAG,cAAc;oBACjB,GAAG,UAAU;oBACb,QAAQ,EAAE;wBACR,GAAG,cAAc,CAAC,QAAQ;wBAC1B,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;qBAC/B;iBACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBACtD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;gBACpC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,uCAAuC;YAC5D,CAAC;YAED,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,WAAW,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,WAAW,CAAC,iCAAiC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YAEhC,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;YAEhD,uEAAuE;YACvE,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACrB,MAAM,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,MAAM,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACrF,MAAM,IAAI,WAAW,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAoC,GAAM;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAoC,GAAM,EAAE,KAA2B;QAC9E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAEjC,+CAA+C;YAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,MAAM,IAAI,WAAW,CAAC,iCAAiC,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB;QACrB,OAAO,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;IACpC,CAAC;CAEF;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/packages/core/dist/core/conversion-context/creation.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Conversion Context Creation
+ *
+ * Functions for creating PackageConversionContext instances from various sources.
+ */
+import type { PackageConversionContext, FormatState } from '../../types/conversion-context.js';
+import type { Platform } from '../platforms.js';
+import type { PackageFormat } from '../install/format-detector.js';
+import type { Package } from '../../types/index.js';
+/**
+ * Create context from detected package format
+ *
+ * Use this at package discovery/loading time when format is detected.
+ */
+export declare function createContextFromFormat(format: PackageFormat): PackageConversionContext;
+/**
+ * Create context from package (detects format first)
+ *
+ * Use this when loading a package without prior format information.
+ * Fallback for backward compatibility during migration.
+ */
+export declare function createContextFromPackage(pkg: Package): PackageConversionContext;
+/**
+ * Create context for a known platform-specific package
+ *
+ * Use this when you know definitively what platform a package is for
+ * (e.g., when transforming a claude-plugin).
+ */
+export declare function createPlatformContext(platform: Platform, confidence?: number): PackageConversionContext;
+/**
+ * Create context for universal format package
+ *
+ * Use this when loading a package that's already in universal format.
+ */
+export declare function createUniversalContext(confidence?: number): PackageConversionContext;
+/**
+ * Update context with target platform
+ *
+ * Sets the target platform for the current operation.
+ * Returns a new context object (does not mutate).
+ */
+export declare function withTargetPlatform(context: PackageConversionContext, targetPlatform: Platform): PackageConversionContext;
+/**
+ * Update context after successful conversion
+ *
+ * Records the conversion in history and updates current format.
+ * Returns a new context object (does not mutate).
+ */
+export declare function updateContextAfterConversion(context: PackageConversionContext, newFormat: FormatState, targetPlatform: Platform): PackageConversionContext;
+//# sourceMappingURL=creation.d.ts.map

package/packages/core/dist/core/conversion-context/creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation.d.ts","sourceRoot":"","sources":["../../../src/core/conversion-context/creation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,wBAAwB,EAExB,WAAW,EACZ,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,wBAAwB,CA2BvF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,wBAAwB,CAY/E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,UAAU,GAAE,MAAY,GACvB,wBAAwB,CAuB1B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,GAAE,MAAY,GACvB,wBAAwB,CAuB1B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,wBAAwB,EACjC,cAAc,EAAE,QAAQ,GACvB,wBAAwB,CAK1B;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,EACjC,SAAS,EAAE,WAAW,EACtB,cAAc,EAAE,QAAQ,GACvB,wBAAwB,CAgC1B"}