@trikhub/cli 0.2.0

package/dist/lib/config.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Configuration resolution for TrikHub CLI
+ *
+ * Supports both local (project-level) and global configurations.
+ *
+ * Resolution order:
+ * 1. Local: .trikhub/config.json in current directory
+ * 2. Global: ~/.trikhub/config.json in home directory
+ *
+ * If neither exists, user is prompted to choose where to set up.
+ */
+import { TrikConfig } from '../types.js';
+/**
+ * Configuration scope - where the config lives
+ */
+export type ConfigScope = 'local' | 'global';
+/**
+ * Resolved configuration context
+ */
+export interface ConfigContext {
+    /** The scope of this config (local or global) */
+    scope: ConfigScope;
+    /** Base directory where .trikhub folder lives */
+    baseDir: string;
+    /** Full path to the .trikhub directory */
+    trikhubDir: string;
+    /** Full path to config.json */
+    configPath: string;
+    /** Full path to triks.lock */
+    lockfilePath: string;
+    /** Full path to triks/ directory */
+    triksDir: string;
+    /** The loaded configuration */
+    config: TrikConfig;
+}
+/**
+ * Get the local trikhub directory path (in current working directory)
+ */
+export declare function getLocalTrikhubDir(): string;
+/**
+ * Get the global trikhub directory path (in home directory)
+ */
+export declare function getGlobalTrikhubDir(): string;
+/**
+ * Check if a local config exists in the current directory
+ */
+export declare function hasLocalConfig(): boolean;
+/**
+ * Check if a global config exists in the home directory
+ */
+export declare function hasGlobalConfig(): boolean;
+/**
+ * Initialize a new configuration at the specified location
+ */
+export declare function initializeConfig(scope: ConfigScope): ConfigContext;
+/**
+ * Resolve configuration - find the appropriate config to use
+ *
+ * This is the main entry point for config resolution.
+ * It checks local first, then global, then prompts if neither exists.
+ *
+ * @param options - Resolution options
+ * @param options.interactive - If false, don't prompt user (use global by default)
+ */
+export declare function resolveConfig(options?: {
+    interactive?: boolean;
+}): Promise<ConfigContext>;
+/**
+ * Get the current config context without prompting
+ *
+ * Returns local if it exists, otherwise global.
+ * Creates global if neither exists (for backwards compatibility).
+ */
+export declare function getConfigContext(): ConfigContext;
+/**
+ * Save configuration to the context's config path
+ */
+export declare function saveConfig(ctx: ConfigContext, config: TrikConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAIzD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,KAAK,EAAE,WAAW,CAAC;IAEnB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAmDD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAuBlE;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CA6DzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAWhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAOvE"}

package/dist/lib/config.js

@@ -0,0 +1,202 @@
+/**
+ * Configuration resolution for TrikHub CLI
+ *
+ * Supports both local (project-level) and global configurations.
+ *
+ * Resolution order:
+ * 1. Local: .trikhub/config.json in current directory
+ * 2. Global: ~/.trikhub/config.json in home directory
+ *
+ * If neither exists, user is prompted to choose where to set up.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { DEFAULT_CONFIG } from '../types.js';
+import chalk from 'chalk';
+import { select, confirm } from '@inquirer/prompts';
+/**
+ * Get the local trikhub directory path (in current working directory)
+ */
+export function getLocalTrikhubDir() {
+    return join(process.cwd(), '.trikhub');
+}
+/**
+ * Get the global trikhub directory path (in home directory)
+ */
+export function getGlobalTrikhubDir() {
+    return join(homedir(), '.trikhub');
+}
+/**
+ * Check if a local config exists in the current directory
+ */
+export function hasLocalConfig() {
+    const localConfigPath = join(getLocalTrikhubDir(), 'config.json');
+    return existsSync(localConfigPath);
+}
+/**
+ * Check if a global config exists in the home directory
+ */
+export function hasGlobalConfig() {
+    const globalConfigPath = join(getGlobalTrikhubDir(), 'config.json');
+    return existsSync(globalConfigPath);
+}
+/**
+ * Load a config file from a path, merging with defaults
+ */
+function loadConfigFromPath(configPath) {
+    if (!existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        return { ...DEFAULT_CONFIG, ...config };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+/**
+ * Create a ConfigContext from a base directory
+ */
+function createContext(baseDir, scope) {
+    const trikhubDir = join(baseDir, '.trikhub');
+    const configPath = join(trikhubDir, 'config.json');
+    const config = loadConfigFromPath(configPath);
+    // For local configs, triksDirectory is relative to the .trikhub folder
+    // For global configs, it uses the config value (which may be absolute)
+    let triksDir;
+    if (scope === 'local') {
+        // Local triks are stored in .trikhub/triks/
+        triksDir = join(trikhubDir, 'triks');
+    }
+    else {
+        // Global uses the configured path (default: ~/.trikhub/triks)
+        triksDir = config.triksDirectory.startsWith('~')
+            ? config.triksDirectory.replace('~', homedir())
+            : config.triksDirectory;
+    }
+    return {
+        scope,
+        baseDir,
+        trikhubDir,
+        configPath,
+        lockfilePath: join(trikhubDir, 'triks.lock'),
+        triksDir,
+        config,
+    };
+}
+/**
+ * Initialize a new configuration at the specified location
+ */
+export function initializeConfig(scope) {
+    const baseDir = scope === 'local' ? process.cwd() : homedir();
+    const trikhubDir = join(baseDir, '.trikhub');
+    const triksDir = join(trikhubDir, 'triks');
+    const configPath = join(trikhubDir, 'config.json');
+    // Create directories
+    if (!existsSync(trikhubDir)) {
+        mkdirSync(trikhubDir, { recursive: true });
+    }
+    if (!existsSync(triksDir)) {
+        mkdirSync(triksDir, { recursive: true });
+    }
+    // Create config file with defaults
+    const config = {
+        ...DEFAULT_CONFIG,
+        // For local configs, use relative path
+        triksDirectory: scope === 'local' ? '.trikhub/triks' : DEFAULT_CONFIG.triksDirectory,
+    };
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+    return createContext(baseDir, scope);
+}
+/**
+ * Resolve configuration - find the appropriate config to use
+ *
+ * This is the main entry point for config resolution.
+ * It checks local first, then global, then prompts if neither exists.
+ *
+ * @param options - Resolution options
+ * @param options.interactive - If false, don't prompt user (use global by default)
+ */
+export async function resolveConfig(options) {
+    const interactive = options?.interactive ?? true;
+    // 1. Check for local config first
+    if (hasLocalConfig()) {
+        return createContext(process.cwd(), 'local');
+    }
+    // 2. Check for global config
+    if (hasGlobalConfig()) {
+        if (!interactive) {
+            // Non-interactive mode: just use global
+            return createContext(homedir(), 'global');
+        }
+        // Interactive mode: ask user if they want to use global
+        console.log(chalk.cyan('\nNo local .trikhub configuration found.'));
+        console.log(chalk.dim(`Global configuration exists at ${getGlobalTrikhubDir()}\n`));
+        const useGlobal = await confirm({
+            message: 'Use global configuration?',
+            default: true,
+        });
+        if (useGlobal) {
+            return createContext(homedir(), 'global');
+        }
+        // User wants local - create it
+        console.log(chalk.dim('\nInitializing local configuration...'));
+        return initializeConfig('local');
+    }
+    // 3. No config exists anywhere - prompt user to set up
+    if (!interactive) {
+        // Non-interactive mode: create global by default
+        return initializeConfig('global');
+    }
+    console.log(chalk.cyan('\nNo TrikHub configuration found.'));
+    console.log(chalk.dim('Triks need a place to be installed.\n'));
+    const scope = await select({
+        message: 'Where would you like to set up TrikHub?',
+        choices: [
+            {
+                value: 'global',
+                name: `Global (${chalk.dim('~/.trikhub')})`,
+                description: 'Install triks in your home directory. Available to all projects.',
+            },
+            {
+                value: 'local',
+                name: `Local (${chalk.dim('./.trikhub')})`,
+                description: 'Install triks in this project directory. Project-specific configuration.',
+            },
+        ],
+        default: 'global',
+    });
+    console.log(chalk.dim(`\nInitializing ${scope} configuration...`));
+    return initializeConfig(scope);
+}
+/**
+ * Get the current config context without prompting
+ *
+ * Returns local if it exists, otherwise global.
+ * Creates global if neither exists (for backwards compatibility).
+ */
+export function getConfigContext() {
+    if (hasLocalConfig()) {
+        return createContext(process.cwd(), 'local');
+    }
+    if (hasGlobalConfig()) {
+        return createContext(homedir(), 'global');
+    }
+    // Fallback: create global config for backwards compatibility
+    return initializeConfig('global');
+}
+/**
+ * Save configuration to the context's config path
+ */
+export function saveConfig(ctx, config) {
+    // Ensure directory exists
+    if (!existsSync(ctx.trikhubDir)) {
+        mkdirSync(ctx.trikhubDir, { recursive: true });
+    }
+    writeFileSync(ctx.configPath, JSON.stringify(config, null, 2));
+    ctx.config = config;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/registry.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Registry client for TrikHub
+ *
+ * Connects to the TrikHub registry API to search and fetch triks.
+ */
+import { TrikInfo, TrikVersion, SearchResult, DeviceAuthResponse, AuthResult, Publisher } from '../types.js';
+/**
+ * Registry client class
+ */
+export declare class RegistryClient {
+    private baseUrl;
+    private authToken?;
+    constructor(baseUrl?: string, authToken?: string);
+    /**
+     * Make an API request
+     */
+    private fetch;
+    /**
+     * Search for triks in the registry
+     */
+    search(query: string, options?: {
+        page?: number;
+        perPage?: number;
+    }): Promise<SearchResult>;
+    /**
+     * Get detailed information about a specific trik
+     */
+    getTrik(fullName: string): Promise<TrikInfo | null>;
+    /**
+     * Get a specific version of a trik
+     */
+    getTrikVersion(fullName: string, version: string): Promise<TrikVersion | null>;
+    /**
+     * Get the latest version of a trik
+     */
+    getLatestVersion(fullName: string): Promise<TrikVersion | null>;
+    /**
+     * List all available triks (paginated)
+     */
+    listTriks(options?: {
+        page?: number;
+        perPage?: number;
+    }): Promise<SearchResult>;
+    /**
+     * Report a download (for analytics)
+     */
+    reportDownload(fullName: string, version: string): Promise<void>;
+    /**
+     * Start device authorization flow
+     * Returns device_code for polling and user_code for user to enter
+     */
+    startDeviceAuth(): Promise<DeviceAuthResponse>;
+    /**
+     * Poll for device authorization completion
+     * Returns null if still pending, AuthResult when complete
+     */
+    pollDeviceAuth(deviceCode: string): Promise<AuthResult | null>;
+    /**
+     * Get the current authenticated user
+     */
+    getCurrentUser(): Promise<Publisher>;
+    /**
+     * Logout (invalidate session)
+     */
+    logout(): Promise<void>;
+    /**
+     * Register a new trik in the registry
+     */
+    registerTrik(data: {
+        githubRepo: string;
+        name?: string;
+        description?: string;
+        categories?: string[];
+        keywords?: string[];
+    }): Promise<TrikInfo>;
+    /**
+     * Publish a new version of a trik
+     */
+    publishVersion(fullName: string, data: {
+        version: string;
+        tarballUrl: string;
+        sha256?: string;
+        manifest: Record<string, unknown>;
+    }): Promise<TrikVersion>;
+}
+/**
+ * Default registry client instance
+ */
+export declare const registry: RegistryClient;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lib/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,SAAS,EACV,MAAM,aAAa,CAAC;AA2FrB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAOhD;;OAEG;YACW,KAAK;IAkCnB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBrG;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAezD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAOpF;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAOrE;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAkBzF;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAmBpD;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA2BpE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC;IAO1C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAW7B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWrB;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GACA,OAAO,CAAC,WAAW,CAAC;CAiBxB;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,gBAAuB,CAAC"}

package/dist/lib/registry.js

@@ -0,0 +1,294 @@
+/**
+ * Registry client for TrikHub
+ *
+ * Connects to the TrikHub registry API to search and fetch triks.
+ */
+import { loadConfig } from './storage.js';
+/**
+ * Convert API response to CLI TrikInfo type
+ */
+function apiToTrikInfo(api, versions = []) {
+    return {
+        fullName: api.name,
+        scope: api.scope,
+        name: api.shortName,
+        githubRepo: api.githubRepo,
+        latestVersion: api.latestVersion,
+        description: api.description,
+        categories: api.categories,
+        keywords: api.keywords,
+        downloads: api.totalDownloads,
+        stars: api.githubStars,
+        verified: api.verified,
+        discussionsUrl: `https://github.com/${api.githubRepo}/discussions`,
+        versions,
+        createdAt: api.createdAt,
+        updatedAt: api.updatedAt,
+    };
+}
+/**
+ * Convert API version to CLI TrikVersion type
+ */
+function apiToTrikVersion(api, githubRepo) {
+    return {
+        version: api.version,
+        releaseUrl: `https://github.com/${githubRepo}/releases/tag/v${api.version}`,
+        tarballUrl: api.tarballUrl,
+        sha256: api.sha256,
+        publishedAt: api.publishedAt,
+        downloads: api.downloads,
+    };
+}
+/**
+ * Build a trik path from full name (e.g., "@Muffles/article-search" -> "@Muffles/article-search")
+ * Used to construct API paths with scope and name as separate segments
+ */
+function trikPath(fullName) {
+    // fullName format: @scope/name
+    // We need to return: @scope/name (scope and name as path segments)
+    // The URL will be: /api/v1/triks/@scope/name
+    return fullName;
+}
+/**
+ * Registry client class
+ */
+export class RegistryClient {
+    baseUrl;
+    authToken;
+    constructor(baseUrl, authToken) {
+        const config = loadConfig();
+        // Priority: explicit param > env var > config file
+        this.baseUrl = baseUrl ?? process.env.TRIKHUB_REGISTRY ?? config.registry;
+        this.authToken = authToken ?? config.authToken;
+    }
+    /**
+     * Make an API request
+     */
+    async fetch(path, options = {}) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            ...options.headers,
+        };
+        if (this.authToken) {
+            headers['Authorization'] = `Bearer ${this.authToken}`;
+        }
+        const response = await fetch(url, { ...options, headers });
+        if (!response.ok) {
+            if (response.status === 401) {
+                throw new Error('Authentication failed. Please run `trik login`');
+            }
+            if (response.status === 404) {
+                throw new Error(`Not found: ${path}`);
+            }
+            const body = await response.text();
+            let message = `Registry API error: ${response.status} ${response.statusText}`;
+            try {
+                const json = JSON.parse(body);
+                if (json.error)
+                    message = json.error;
+            }
+            catch {
+                // Use default message
+            }
+            throw new Error(message);
+        }
+        return response.json();
+    }
+    /**
+     * Search for triks in the registry
+     */
+    async search(query, options = {}) {
+        const { page = 1, perPage = 10 } = options;
+        const params = new URLSearchParams({
+            q: query,
+            page: String(page),
+            pageSize: String(perPage),
+        });
+        const result = await this.fetch(`/api/v1/triks?${params}`);
+        return {
+            total: result.total,
+            page: result.page,
+            perPage: result.pageSize,
+            results: result.triks.map((t) => apiToTrikInfo(t)),
+        };
+    }
+    /**
+     * Get detailed information about a specific trik
+     */
+    async getTrik(fullName) {
+        try {
+            // Use path directly - routes expect /api/v1/triks/:scope/:trikName
+            const result = await this.fetch(`/api/v1/triks/${trikPath(fullName)}`);
+            const versions = result.versions.map((v) => apiToTrikVersion(v, result.githubRepo));
+            return apiToTrikInfo(result, versions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Not found')) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get a specific version of a trik
+     */
+    async getTrikVersion(fullName, version) {
+        const trik = await this.getTrik(fullName);
+        if (!trik)
+            return null;
+        return trik.versions.find((v) => v.version === version) ?? null;
+    }
+    /**
+     * Get the latest version of a trik
+     */
+    async getLatestVersion(fullName) {
+        const trik = await this.getTrik(fullName);
+        if (!trik)
+            return null;
+        return trik.versions[0] ?? null;
+    }
+    /**
+     * List all available triks (paginated)
+     */
+    async listTriks(options = {}) {
+        const { page = 1, perPage = 10 } = options;
+        const params = new URLSearchParams({
+            page: String(page),
+            pageSize: String(perPage),
+        });
+        const result = await this.fetch(`/api/v1/triks?${params}`);
+        return {
+            total: result.total,
+            page: result.page,
+            perPage: result.pageSize,
+            results: result.triks.map((t) => apiToTrikInfo(t)),
+        };
+    }
+    /**
+     * Report a download (for analytics)
+     */
+    async reportDownload(fullName, version) {
+        try {
+            // Use path directly - routes expect /api/v1/triks/:scope/:trikName/download
+            await fetch(`${this.baseUrl}/api/v1/triks/${trikPath(fullName)}/download`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ version }),
+            });
+        }
+        catch {
+            // Silently fail analytics - don't break the install
+        }
+    }
+    // ============================================
+    // Authentication Methods
+    // ============================================
+    /**
+     * Start device authorization flow
+     * Returns device_code for polling and user_code for user to enter
+     */
+    async startDeviceAuth() {
+        const response = await fetch(`${this.baseUrl}/auth/device`);
+        if (!response.ok) {
+            const body = await response.text();
+            let message = `Failed to start authentication: ${response.status}`;
+            try {
+                const json = JSON.parse(body);
+                if (json.error)
+                    message = json.error;
+                if (json.message)
+                    message = json.message;
+            }
+            catch {
+                // Use default message
+            }
+            throw new Error(message);
+        }
+        return response.json();
+    }
+    /**
+     * Poll for device authorization completion
+     * Returns null if still pending, AuthResult when complete
+     */
+    async pollDeviceAuth(deviceCode) {
+        const response = await fetch(`${this.baseUrl}/auth/device/poll`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ deviceCode }),
+        });
+        if (response.status === 202) {
+            // Still pending
+            return null;
+        }
+        if (!response.ok) {
+            const body = await response.text();
+            let message = `Authentication failed: ${response.status}`;
+            try {
+                const json = JSON.parse(body);
+                if (json.error)
+                    message = json.error;
+            }
+            catch {
+                // Use default message
+            }
+            throw new Error(message);
+        }
+        return response.json();
+    }
+    /**
+     * Get the current authenticated user
+     */
+    async getCurrentUser() {
+        if (!this.authToken) {
+            throw new Error('Not authenticated. Please run `trik login`');
+        }
+        return this.fetch('/auth/me');
+    }
+    /**
+     * Logout (invalidate session)
+     */
+    async logout() {
+        if (!this.authToken) {
+            return;
+        }
+        await this.fetch('/auth/logout', { method: 'POST' });
+    }
+    // ============================================
+    // Publishing Methods
+    // ============================================
+    /**
+     * Register a new trik in the registry
+     */
+    async registerTrik(data) {
+        if (!this.authToken) {
+            throw new Error('Not authenticated. Please run `trik login`');
+        }
+        return this.fetch('/api/v1/triks', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    /**
+     * Publish a new version of a trik
+     */
+    async publishVersion(fullName, data) {
+        if (!this.authToken) {
+            throw new Error('Not authenticated. Please run `trik login`');
+        }
+        // Use path directly - routes expect /api/v1/triks/:scope/:trikName/versions
+        const result = await this.fetch(`/api/v1/triks/${trikPath(fullName)}/versions`, {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+        // Get the github repo for the release URL
+        const trik = await this.getTrik(fullName);
+        const githubRepo = trik?.githubRepo ?? '';
+        return apiToTrikVersion(result, githubRepo);
+    }
+}
+/**
+ * Default registry client instance
+ */
+export const registry = new RegistryClient();
+//# sourceMappingURL=registry.js.map