@xcrawl/cli 0.2.0

package/dist/commands/shared.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCommandRuntimeConfig = resolveCommandRuntimeConfig;
+exports.resolveOutputPath = resolveOutputPath;
+exports.isRunApiBaseUrl = isRunApiBaseUrl;
+exports.isAccountEndpointUnavailable = isAccountEndpointUnavailable;
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../core/errors");
+const config_1 = require("../core/config");
+const env_1 = require("../core/env");
+async function resolveCommandRuntimeConfig(context, flags = {}) {
+    const localConfig = await (0, config_1.readLocalConfig)(context.homeDir);
+    const envConfig = (0, env_1.readEnvConfig)(context.env);
+    return (0, config_1.resolveRuntimeConfig)({
+        flags,
+        env: envConfig,
+        local: localConfig
+    });
+}
+function resolveOutputPath(context, outputPath) {
+    if (!outputPath) {
+        return undefined;
+    }
+    return node_path_1.default.isAbsolute(outputPath) ? outputPath : node_path_1.default.resolve(context.cwd, outputPath);
+}
+function isRunApiBaseUrl(baseUrl) {
+    try {
+        const parsed = new URL(baseUrl);
+        return parsed.hostname === 'run.xcrawl.com';
+    }
+    catch {
+        return false;
+    }
+}
+function isAccountEndpointUnavailable(error, baseUrl) {
+    return isRunApiBaseUrl(baseUrl) && error instanceof errors_1.ApiError && error.status === 404;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":";;;;;AAgBA,kEAYC;AAED,8CAMC;AAED,0CAOC;AAED,oEAEC;AAjDD,0DAA6B;AAG7B,2CAA0C;AAC1C,2CAAuE;AACvE,qCAA4C;AAWrC,KAAK,UAAU,2BAA2B,CAC/C,OAAmB,EACnB,QAAsB,EAAE;IAExB,MAAM,WAAW,GAAG,MAAM,IAAA,wBAAe,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAA,mBAAa,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7C,OAAO,IAAA,6BAAoB,EAAC;QAC1B,KAAK;QACL,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,WAAW;KACnB,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,iBAAiB,CAAC,OAAmB,EAAE,UAA8B;IACnF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,mBAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AAC1F,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,QAAQ,KAAK,gBAAgB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAgB,4BAA4B,CAAC,KAAc,EAAE,OAAe;IAC1E,OAAO,eAAe,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,iBAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC;AACvF,CAAC"}

package/dist/commands/whoami.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+import type { CliContext } from '../types/cli';
+export declare function registerWhoamiCommand(program: Command, context: CliContext): void;

package/dist/commands/whoami.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWhoamiCommand = registerWhoamiCommand;
+const whoami_1 = require("../api/whoami");
+const auth_1 = require("../core/auth");
+const output_1 = require("../core/output");
+const text_1 = require("../formatters/text");
+const validate_1 = require("../utils/validate");
+const shared_1 = require("./shared");
+function registerWhoamiCommand(program, context) {
+    program
+        .command('whoami')
+        .description('Show the current account info')
+        .option('--api-key <key>', 'Override API key')
+        .option('--api-base-url <url>', 'Override API base URL')
+        .option('--timeout <ms>', 'Request timeout in milliseconds')
+        .option('--debug', 'Enable debug output')
+        .option('--json', 'Output result as JSON')
+        .option('--output <path>', 'Save output to a file')
+        .action(async (options) => {
+        const runtime = await (0, shared_1.resolveCommandRuntimeConfig)(context, {
+            apiKey: options.apiKey,
+            apiBaseUrl: options.apiBaseUrl,
+            timeoutMs: (0, validate_1.parsePositiveInt)(options.timeout, 'timeout'),
+            debug: options.debug
+        });
+        runtime.apiKey = (0, auth_1.requireApiKey)(runtime.apiKey);
+        const client = context.createApiClient(runtime);
+        const outputPath = (0, shared_1.resolveOutputPath)(context, options.output);
+        try {
+            const result = await (0, whoami_1.fetchWhoAmI)(client);
+            await (0, output_1.renderOutput)({
+                ctx: { stdout: context.stdout },
+                data: result,
+                json: options.json,
+                outputPath,
+                renderText: text_1.formatWhoami
+            });
+            return;
+        }
+        catch (error) {
+            if (!(0, shared_1.isAccountEndpointUnavailable)(error, runtime.apiBaseUrl)) {
+                throw error;
+            }
+            const fallback = {
+                apiBaseUrl: runtime.apiBaseUrl,
+                apiKeyConfigured: true,
+                supported: false,
+                note: 'Public API does not provide a whoami endpoint. Use dashboard for account details.'
+            };
+            await (0, output_1.renderOutput)({
+                ctx: { stdout: context.stdout },
+                data: fallback,
+                json: options.json,
+                outputPath,
+                renderText: (data) => `Whoami endpoint unavailable on ${data.apiBaseUrl}. ${data.note}`
+            });
+        }
+    });
+}
+//# sourceMappingURL=whoami.js.map

package/dist/commands/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":";;AAuBA,sDAsDC;AA3ED,0CAA4C;AAC5C,uCAA6C;AAC7C,2CAA8C;AAC9C,6CAAkD;AAElD,gDAAqD;AACrD,qCAIkB;AAWlB,SAAgB,qBAAqB,CAAC,OAAgB,EAAE,OAAmB;IACzE,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;SAC7C,MAAM,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;SACvD,MAAM,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;SAC3D,MAAM,CAAC,SAAS,EAAE,qBAAqB,CAAC;SACxC,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,OAAsB,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,MAAM,IAAA,oCAA2B,EAAC,OAAO,EAAE;YACzD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,SAAS,EAAE,IAAA,2BAAgB,EAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;YACvD,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,GAAG,IAAA,oBAAa,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAA,0BAAiB,EAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAW,EAAC,MAAM,CAAC,CAAC;YAEzC,MAAM,IAAA,qBAAY,EAAC;gBACjB,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC/B,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,UAAU;gBACV,UAAU,EAAE,mBAAY;aACzB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAA,qCAA4B,EAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC7D,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,QAAQ,GAAG;gBACf,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,gBAAgB,EAAE,IAAI;gBACtB,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,mFAAmF;aAC1F,CAAC;YAEF,MAAM,IAAA,qBAAY,EAAC;gBACjB,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC/B,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,UAAU;gBACV,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kCAAkC,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,IAAI,EAAE;aACxF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/core/auth.d.ts

@@ -0,0 +1 @@
+export declare function requireApiKey(apiKey: string | undefined): string;

package/dist/core/auth.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireApiKey = requireApiKey;
+const errors_1 = require("./errors");
+function requireApiKey(apiKey) {
+    if (apiKey && apiKey.trim().length > 0) {
+        return apiKey;
+    }
+    throw new errors_1.AuthError('Missing API key.', 'Run `xcrawl login --api-key <key>` first, or set `XCRAWL_API_KEY`.');
+}
+//# sourceMappingURL=auth.js.map

package/dist/core/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":";;AAEA,sCASC;AAXD,qCAAqC;AAErC,SAAgB,aAAa,CAAC,MAA0B;IACtD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,kBAAS,CACjB,kBAAkB,EAClB,oEAAoE,CACrE,CAAC;AACJ,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,20 @@
+import type { ConfigField, ConfigKey, RuntimeConfig, XCrawlConfig } from '../types/config';
+export declare function getConfigPath(homeDir?: string): string;
+export declare function readLocalConfig(homeDir?: string): Promise<XCrawlConfig>;
+export declare function saveLocalConfig(nextConfig: XCrawlConfig, homeDir?: string): Promise<string>;
+export interface ResolveRuntimeConfigInput {
+    flags?: XCrawlConfig;
+    env?: XCrawlConfig;
+    local?: XCrawlConfig;
+    defaults?: RuntimeConfig;
+}
+export declare function resolveRuntimeConfig(input: ResolveRuntimeConfigInput): RuntimeConfig;
+export declare function isConfigKey(value: string): value is ConfigKey;
+export declare function resolveConfigField(key: string): ConfigField;
+export declare function parseConfigValue(field: ConfigField, rawValue: string): XCrawlConfig[ConfigField];
+export declare function getConfigValue(key: string, homeDir?: string): Promise<unknown>;
+export declare function setConfigValue(key: string, rawValue: string, homeDir?: string): Promise<{
+    configPath: string;
+    field: ConfigField;
+    value: unknown;
+}>;

package/dist/core/config.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfigPath = getConfigPath;
+exports.readLocalConfig = readLocalConfig;
+exports.saveLocalConfig = saveLocalConfig;
+exports.resolveRuntimeConfig = resolveRuntimeConfig;
+exports.isConfigKey = isConfigKey;
+exports.resolveConfigField = resolveConfigField;
+exports.parseConfigValue = parseConfigValue;
+exports.getConfigValue = getConfigValue;
+exports.setConfigValue = setConfigValue;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const CONFIG_KEY_TO_FIELD = {
+    'api-key': 'apiKey',
+    'api-base-url': 'apiBaseUrl',
+    'default-format': 'defaultFormat',
+    'output-dir': 'outputDir',
+    'timeout-ms': 'timeoutMs',
+    debug: 'debug'
+};
+const ALLOWED_DEFAULT_FORMATS = new Set(['markdown', 'json', 'html', 'screenshot', 'text']);
+function getConfigPath(homeDir = node_os_1.default.homedir()) {
+    return node_path_1.default.join(homeDir, '.xcrawl', 'config.json');
+}
+async function readLocalConfig(homeDir) {
+    const configPath = getConfigPath(homeDir);
+    try {
+        await (0, promises_1.access)(configPath);
+    }
+    catch {
+        return {};
+    }
+    try {
+        const raw = await (0, promises_1.readFile)(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed;
+    }
+    catch (error) {
+        throw new errors_1.ConfigError(`Failed to read config file: ${configPath}`, 'Please verify the JSON format is valid.', error);
+    }
+}
+async function saveLocalConfig(nextConfig, homeDir) {
+    const configPath = getConfigPath(homeDir);
+    const configDir = node_path_1.default.dirname(configPath);
+    const existing = await readLocalConfig(homeDir);
+    const merged = { ...existing, ...nextConfig };
+    try {
+        await (0, promises_1.mkdir)(configDir, { recursive: true });
+        await (0, promises_1.writeFile)(configPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8');
+        return configPath;
+    }
+    catch (error) {
+        throw new errors_1.ConfigError(`Failed to write config file: ${configPath}`, 'Please check directory permissions.', error);
+    }
+}
+function resolveRuntimeConfig(input) {
+    const defaults = input.defaults ?? constants_1.DEFAULT_RUNTIME_CONFIG;
+    const flags = input.flags ?? {};
+    const env = input.env ?? {};
+    const local = input.local ?? {};
+    return {
+        apiKey: flags.apiKey ?? env.apiKey ?? local.apiKey,
+        apiBaseUrl: flags.apiBaseUrl ?? env.apiBaseUrl ?? local.apiBaseUrl ?? defaults.apiBaseUrl,
+        defaultFormat: flags.defaultFormat ?? env.defaultFormat ?? local.defaultFormat ?? defaults.defaultFormat,
+        outputDir: flags.outputDir ?? env.outputDir ?? local.outputDir ?? defaults.outputDir,
+        timeoutMs: flags.timeoutMs ?? env.timeoutMs ?? local.timeoutMs ?? defaults.timeoutMs,
+        debug: flags.debug ?? env.debug ?? local.debug ?? defaults.debug
+    };
+}
+function isConfigKey(value) {
+    return Object.prototype.hasOwnProperty.call(CONFIG_KEY_TO_FIELD, value);
+}
+function resolveConfigField(key) {
+    if (!isConfigKey(key)) {
+        throw new errors_1.ValidationError(`Unsupported config key: ${key}`, 'Use one of: api-key, api-base-url, default-format, output-dir, timeout-ms, debug.');
+    }
+    return CONFIG_KEY_TO_FIELD[key];
+}
+function parseBoolean(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'true' || normalized === '1') {
+        return true;
+    }
+    if (normalized === 'false' || normalized === '0') {
+        return false;
+    }
+    throw new errors_1.ValidationError('Invalid boolean value.', 'Use true/false or 1/0.');
+}
+function parseDefaultFormat(value) {
+    if (ALLOWED_DEFAULT_FORMATS.has(value)) {
+        return value;
+    }
+    throw new errors_1.ValidationError(`Invalid default format: ${value}`, 'Use one of: markdown, json, html, screenshot, text.');
+}
+function parseConfigValue(field, rawValue) {
+    switch (field) {
+        case 'timeoutMs': {
+            const timeoutMs = Number.parseInt(rawValue, 10);
+            if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+                throw new errors_1.ValidationError('Invalid timeout-ms value.', 'Use a positive integer for timeout-ms.');
+            }
+            return timeoutMs;
+        }
+        case 'debug':
+            return parseBoolean(rawValue);
+        case 'defaultFormat':
+            return parseDefaultFormat(rawValue);
+        default:
+            return rawValue;
+    }
+}
+async function getConfigValue(key, homeDir) {
+    const field = resolveConfigField(key);
+    const config = await readLocalConfig(homeDir);
+    return config[field];
+}
+async function setConfigValue(key, rawValue, homeDir) {
+    const field = resolveConfigField(key);
+    const value = parseConfigValue(field, rawValue);
+    const configPath = await saveLocalConfig({ [field]: value }, homeDir);
+    return {
+        configPath,
+        field,
+        value
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/constants.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeConfig } from '../types/config';
+export declare const DEFAULT_API_BASE_URL = "https://run.xcrawl.com";
+export declare const DEFAULT_RUNTIME_CONFIG: RuntimeConfig;

package/dist/core/constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RUNTIME_CONFIG = exports.DEFAULT_API_BASE_URL = void 0;
+exports.DEFAULT_API_BASE_URL = 'https://run.xcrawl.com';
+exports.DEFAULT_RUNTIME_CONFIG = {
+    apiBaseUrl: exports.DEFAULT_API_BASE_URL,
+    defaultFormat: 'markdown',
+    outputDir: '.xcrawl',
+    timeoutMs: 30000,
+    debug: false
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAG,wBAAwB,CAAC;AAEhD,QAAA,sBAAsB,GAAkB;IACnD,UAAU,EAAE,4BAAoB;IAChC,aAAa,EAAE,UAAU;IACzB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,KAAK;CACb,CAAC"}

package/dist/core/env.d.ts

@@ -0,0 +1,2 @@
+import type { XCrawlConfig } from '../types/config';
+export declare function readEnvConfig(env?: NodeJS.ProcessEnv): XCrawlConfig;

package/dist/core/env.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readEnvConfig = readEnvConfig;
+function parseBoolean(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(normalized)) {
+        return true;
+    }
+    if (['0', 'false', 'no', 'off'].includes(normalized)) {
+        return false;
+    }
+    return undefined;
+}
+function parseNumber(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function readEnvConfig(env = process.env) {
+    return {
+        apiKey: env.XCRAWL_API_KEY,
+        apiBaseUrl: env.XCRAWL_API_BASE_URL,
+        defaultFormat: env.XCRAWL_DEFAULT_FORMAT,
+        outputDir: env.XCRAWL_OUTPUT_DIR,
+        timeoutMs: parseNumber(env.XCRAWL_TIMEOUT_MS),
+        debug: parseBoolean(env.XCRAWL_DEBUG)
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/core/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":";;AA4BA,sCASC;AAnCD,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,SAAgB,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,cAAc;QAC1B,UAAU,EAAE,GAAG,CAAC,mBAAmB;QACnC,aAAa,EAAE,GAAG,CAAC,qBAAsD;QACzE,SAAS,EAAE,GAAG,CAAC,iBAAiB;QAChC,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC7C,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,33 @@
+export interface CliErrorShape {
+    code: string;
+    message: string;
+    hint?: string;
+    cause?: unknown;
+}
+export declare class CliError extends Error implements CliErrorShape {
+    code: string;
+    hint?: string;
+    cause?: unknown;
+    constructor(code: string, message: string, hint?: string, cause?: unknown);
+}
+export declare class ConfigError extends CliError {
+    constructor(message: string, hint?: string, cause?: unknown);
+}
+export declare class AuthError extends CliError {
+    constructor(message: string, hint?: string, cause?: unknown);
+}
+export declare class ApiError extends CliError {
+    status?: number;
+    constructor(message: string, hint?: string, status?: number, cause?: unknown);
+}
+export declare class ValidationError extends CliError {
+    constructor(message: string, hint?: string, cause?: unknown);
+}
+export declare class OutputError extends CliError {
+    constructor(message: string, hint?: string, cause?: unknown);
+}
+export declare class NetworkError extends CliError {
+    constructor(message: string, hint?: string, cause?: unknown);
+}
+export declare function toCliError(error: unknown): CliError;
+export declare function formatErrorForUser(error: unknown): string;

package/dist/core/errors.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.OutputError = exports.ValidationError = exports.ApiError = exports.AuthError = exports.ConfigError = exports.CliError = void 0;
+exports.toCliError = toCliError;
+exports.formatErrorForUser = formatErrorForUser;
+class CliError extends Error {
+    constructor(code, message, hint, cause) {
+        super(message);
+        this.code = code;
+        this.hint = hint;
+        this.cause = cause;
+    }
+}
+exports.CliError = CliError;
+class ConfigError extends CliError {
+    constructor(message, hint, cause) {
+        super('CONFIG_ERROR', message, hint, cause);
+    }
+}
+exports.ConfigError = ConfigError;
+class AuthError extends CliError {
+    constructor(message, hint, cause) {
+        super('AUTH_ERROR', message, hint, cause);
+    }
+}
+exports.AuthError = AuthError;
+class ApiError extends CliError {
+    constructor(message, hint, status, cause) {
+        super('API_ERROR', message, hint, cause);
+        this.status = status;
+    }
+}
+exports.ApiError = ApiError;
+class ValidationError extends CliError {
+    constructor(message, hint, cause) {
+        super('VALIDATION_ERROR', message, hint, cause);
+    }
+}
+exports.ValidationError = ValidationError;
+class OutputError extends CliError {
+    constructor(message, hint, cause) {
+        super('OUTPUT_ERROR', message, hint, cause);
+    }
+}
+exports.OutputError = OutputError;
+class NetworkError extends CliError {
+    constructor(message, hint, cause) {
+        super('NETWORK_ERROR', message, hint, cause);
+    }
+}
+exports.NetworkError = NetworkError;
+function toCliError(error) {
+    if (error instanceof CliError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new CliError('UNKNOWN_ERROR', error.message, 'Please retry, or run with --debug for more details.', error);
+    }
+    return new CliError('UNKNOWN_ERROR', 'An unknown error occurred.', 'Please retry, or verify your input arguments.', error);
+}
+function formatErrorForUser(error) {
+    const cliError = toCliError(error);
+    const hintText = cliError.hint ? `\nHint: ${cliError.hint}` : '';
+    return `[${cliError.code}] ${cliError.message}${hintText}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":";;;AA2DA,gCAUC;AAED,gDAIC;AApED,MAAa,QAAS,SAAQ,KAAK;IAKjC,YAAY,IAAY,EAAE,OAAe,EAAE,IAAa,EAAE,KAAe;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAXD,4BAWC;AAED,MAAa,WAAY,SAAQ,QAAQ;IACvC,YAAY,OAAe,EAAE,IAAa,EAAE,KAAe;QACzD,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF;AAJD,kCAIC;AAED,MAAa,SAAU,SAAQ,QAAQ;IACrC,YAAY,OAAe,EAAE,IAAa,EAAE,KAAe;QACzD,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;CACF;AAJD,8BAIC;AAED,MAAa,QAAS,SAAQ,QAAQ;IAGpC,YAAY,OAAe,EAAE,IAAa,EAAE,MAAe,EAAE,KAAe;QAC1E,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAPD,4BAOC;AAED,MAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe,EAAE,IAAa,EAAE,KAAe;QACzD,KAAK,CAAC,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;CACF;AAJD,0CAIC;AAED,MAAa,WAAY,SAAQ,QAAQ;IACvC,YAAY,OAAe,EAAE,IAAa,EAAE,KAAe;QACzD,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF;AAJD,kCAIC;AAED,MAAa,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAe,EAAE,IAAa,EAAE,KAAe;QACzD,KAAK,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF;AAJD,oCAIC;AAED,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,OAAO,EAAE,qDAAqD,EAAE,KAAK,CAAC,CAAC;IACpH,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,eAAe,EAAE,4BAA4B,EAAE,+CAA+C,EAAE,KAAK,CAAC,CAAC;AAC7H,CAAC;AAED,SAAgB,kBAAkB,CAAC,KAAc;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;AAC7D,CAAC"}

package/dist/core/files.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function writeUtf8File(filePath: string, content: string): Promise<void>;
+export declare function toSafeFileName(input: string): string;

package/dist/core/files.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDir = ensureDir;
+exports.writeUtf8File = writeUtf8File;
+exports.toSafeFileName = toSafeFileName;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("./errors");
+async function ensureDir(dirPath) {
+    try {
+        await (0, promises_1.mkdir)(dirPath, { recursive: true });
+    }
+    catch (error) {
+        throw new errors_1.OutputError(`Failed to create directory: ${dirPath}`, 'Please check permissions or the output path.', error);
+    }
+}
+async function writeUtf8File(filePath, content) {
+    const dirPath = node_path_1.default.dirname(filePath);
+    await ensureDir(dirPath);
+    try {
+        await (0, promises_1.writeFile)(filePath, content, 'utf8');
+    }
+    catch (error) {
+        throw new errors_1.OutputError(`Failed to write file: ${filePath}`, 'Please check the file path or disk permissions.', error);
+    }
+}
+function toSafeFileName(input) {
+    return input
+        .replace(/^https?:\/\//i, '')
+        .replace(/[^a-zA-Z0-9._-]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, 120) || 'result';
+}
+//# sourceMappingURL=files.js.map

package/dist/core/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":";;;;;AAKA,8BAMC;AAED,sCASC;AAED,wCAMC;AA9BD,+CAAoD;AACpD,0DAA6B;AAE7B,qCAAuC;AAEhC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,MAAM,IAAA,gBAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,oBAAW,CAAC,+BAA+B,OAAO,EAAE,EAAE,8CAA8C,EAAE,KAAK,CAAC,CAAC;IACzH,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IACnE,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,oBAAW,CAAC,yBAAyB,QAAQ,EAAE,EAAE,iDAAiD,EAAE,KAAK,CAAC,CAAC;IACvH,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK;SACT,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,QAAQ,CAAC;AAC/B,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,14 @@
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    success(message: string): void;
+    debug(message: string): void;
+}
+interface LoggerOptions {
+    stdout?: NodeJS.WritableStream;
+    stderr?: NodeJS.WritableStream;
+    debug?: boolean;
+}
+export declare function createLogger(options?: LoggerOptions): Logger;
+export {};

package/dist/core/logger.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const chalk_1 = __importDefault(require("chalk"));
+function createLogger(options = {}) {
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const debugEnabled = options.debug ?? false;
+    return {
+        info(message) {
+            stdout.write(`${message}\n`);
+        },
+        warn(message) {
+            stderr.write(`${chalk_1.default.yellow('WARN')} ${message}\n`);
+        },
+        error(message) {
+            stderr.write(`${chalk_1.default.red('ERROR')} ${message}\n`);
+        },
+        success(message) {
+            stdout.write(`${chalk_1.default.green('OK')} ${message}\n`);
+        },
+        debug(message) {
+            if (debugEnabled) {
+                stderr.write(`${chalk_1.default.gray('DEBUG')} ${message}\n`);
+            }
+        }
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":";;;;;AAgBA,oCAwBC;AAxCD,kDAA0B;AAgB1B,SAAgB,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAE5C,OAAO;QACL,IAAI,CAAC,OAAe;YAClB,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,OAAe;YAClB,MAAM,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,OAAe;YACnB,MAAM,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,CAAC,OAAe;YACrB,MAAM,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,OAAe;YACnB,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,KAAK,CAAC,GAAG,eAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,17 @@
+export interface OutputContext {
+    stdout: NodeJS.WritableStream;
+}
+export interface RenderOutputInput<T> {
+    ctx: OutputContext;
+    data: T;
+    json?: boolean;
+    outputPath?: string;
+    renderText: (data: T) => string;
+}
+export declare function renderOutput<T>(input: RenderOutputInput<T>): Promise<void>;
+interface BatchOutputItem {
+    fileName: string;
+    content: string;
+}
+export declare function writeBatchOutput(dirPath: string, items: BatchOutputItem[], stdout: NodeJS.WritableStream): Promise<void>;
+export {};

package/dist/core/output.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderOutput = renderOutput;
+exports.writeBatchOutput = writeBatchOutput;
+const node_path_1 = __importDefault(require("node:path"));
+const json_1 = require("../formatters/json");
+const files_1 = require("./files");
+async function renderOutput(input) {
+    const json = input.json ?? false;
+    const content = json ? (0, json_1.toStableJson)(input.data) : `${input.renderText(input.data)}\n`;
+    if (input.outputPath) {
+        await (0, files_1.writeUtf8File)(input.outputPath, content);
+        input.ctx.stdout.write(`Saved output: ${input.outputPath}\n`);
+        return;
+    }
+    input.ctx.stdout.write(content);
+}
+async function writeBatchOutput(dirPath, items, stdout) {
+    await (0, files_1.ensureDir)(dirPath);
+    for (const item of items) {
+        const fullPath = node_path_1.default.join(dirPath, item.fileName);
+        await (0, files_1.writeUtf8File)(fullPath, item.content);
+        stdout.write(`Saved output: ${fullPath}\n`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/core/output.ts"],"names":[],"mappings":";;;;;AAiBA,oCAWC;AAOD,4CAQC;AA3CD,0DAA6B;AAE7B,6CAAkD;AAClD,mCAAmD;AAc5C,KAAK,UAAU,YAAY,CAAI,KAA2B;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,mBAAY,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAEtF,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAA,qBAAa,EAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/C,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAOM,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,KAAwB,EAAE,MAA6B;IAC7G,MAAM,IAAA,iBAAS,EAAC,OAAO,CAAC,CAAC;IAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,IAAA,qBAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,iBAAiB,QAAQ,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/formatters/json.d.ts

@@ -0,0 +1 @@
+export declare function toStableJson(input: unknown, pretty?: boolean): string;