@xcrawl/cli 0.2.0

package/dist/commands/crawl.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCrawlCommand = registerCrawlCommand;
+const crawl_1 = require("../api/crawl");
+const auth_1 = require("../core/auth");
+const errors_1 = require("../core/errors");
+const output_1 = require("../core/output");
+const text_1 = require("../formatters/text");
+const validate_1 = require("../utils/validate");
+const shared_1 = require("./shared");
+function addCommonCrawlOptions(command) {
+    return command
+        .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');
+}
+function registerCrawlCommand(program, context) {
+    const crawl = program.command('crawl').description('Start crawl jobs and query job status');
+    addCommonCrawlOptions(crawl
+        .command('start')
+        .description('Start a crawl job for a target URL')
+        .argument('<url>', 'Target URL')
+        .option('--wait', 'Wait until the job reaches a terminal status')
+        .option('--interval <ms>', 'Polling interval in milliseconds (default: 2000)')
+        .option('--wait-timeout <ms>', 'Polling timeout in milliseconds (default: 60000)')
+        .option('--max-pages <n>', 'Maximum pages to crawl')).action(async (url, options) => {
+        (0, validate_1.assertHttpUrl)(url);
+        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);
+        const started = await (0, crawl_1.startCrawl)(client, {
+            url,
+            maxPages: (0, validate_1.parsePositiveInt)(options.maxPages, 'max-pages')
+        });
+        if (!options.wait) {
+            await (0, output_1.renderOutput)({
+                ctx: { stdout: context.stdout },
+                data: started,
+                json: options.json,
+                outputPath,
+                renderText: text_1.formatCrawlStart
+            });
+            return;
+        }
+        const intervalMs = (0, validate_1.parsePositiveInt)(options.interval, 'interval') ?? 2000;
+        const waitTimeoutMs = (0, validate_1.parsePositiveInt)(options.waitTimeout, 'wait-timeout') ?? 60000;
+        const status = await (0, crawl_1.waitForCrawlCompletion)(client, started.jobId, intervalMs, waitTimeoutMs);
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: status,
+            json: options.json,
+            outputPath,
+            renderText: text_1.formatCrawlStatus
+        });
+    });
+    addCommonCrawlOptions(crawl
+        .command('status')
+        .description('Fetch crawl job status by job id')
+        .argument('<job-id>', 'Crawl job id')).action(async (jobId, 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);
+        const status = await (0, crawl_1.fetchCrawlStatus)(client, jobId);
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: status,
+            json: options.json,
+            outputPath,
+            renderText: text_1.formatCrawlStatus
+        });
+    });
+    crawl.action(() => {
+        throw new errors_1.ValidationError('Missing crawl action.', 'Run `xcrawl crawl <url>` (shorthand) or `xcrawl crawl start <url>`, or check `xcrawl crawl --help`.');
+    });
+}
+//# sourceMappingURL=crawl.js.map

package/dist/commands/crawl.js.map

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

package/dist/commands/credits.d.ts

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

package/dist/commands/credits.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCreditsCommand = registerCreditsCommand;
+const credits_1 = require("../api/credits");
+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 registerCreditsCommand(program, context) {
+    program
+        .command('credits')
+        .description('Show account credits and usage')
+        .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, credits_1.fetchCredits)(client);
+            await (0, output_1.renderOutput)({
+                ctx: { stdout: context.stdout },
+                data: result,
+                json: options.json,
+                outputPath,
+                renderText: text_1.formatCredits
+            });
+            return;
+        }
+        catch (error) {
+            if (!(0, shared_1.isAccountEndpointUnavailable)(error, runtime.apiBaseUrl)) {
+                throw error;
+            }
+            const fallback = {
+                apiBaseUrl: runtime.apiBaseUrl,
+                supported: false,
+                note: 'Public API does not expose a standalone credits endpoint. Read total_credits_used from task responses.'
+            };
+            await (0, output_1.renderOutput)({
+                ctx: { stdout: context.stdout },
+                data: fallback,
+                json: options.json,
+                outputPath,
+                renderText: (data) => `Credits endpoint unavailable on ${data.apiBaseUrl}. ${data.note}`
+            });
+        }
+    });
+}
+//# sourceMappingURL=credits.js.map

package/dist/commands/credits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credits.js","sourceRoot":"","sources":["../../src/commands/credits.ts"],"names":[],"mappings":";;AAuBA,wDAoDC;AAzED,4CAA8C;AAC9C,uCAA6C;AAC7C,2CAA8C;AAC9C,6CAAmD;AAEnD,gDAAqD;AACrD,qCAIkB;AAWlB,SAAgB,sBAAsB,CAAC,OAAgB,EAAE,OAAmB;IAC1E,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,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,OAAuB,EAAE,EAAE;QACxC,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;QAC/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,sBAAY,EAAC,MAAM,CAAC,CAAC;YAE1C,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,oBAAa;aAC1B,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,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,wGAAwG;aAC/G,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,mCAAmC,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,IAAI,EAAE;aACzF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/doctor.d.ts

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

package/dist/commands/doctor.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDoctorCommand = registerDoctorCommand;
+const whoami_1 = require("../api/whoami");
+const config_1 = require("../core/config");
+const output_1 = require("../core/output");
+const text_1 = require("../formatters/text");
+const validate_1 = require("../utils/validate");
+const shared_1 = require("./shared");
+function checkNodeVersion() {
+    const raw = process.versions.node;
+    const major = Number.parseInt(raw.split('.')[0], 10);
+    if (major >= 18) {
+        return { ok: true, detail: raw };
+    }
+    return { ok: false, detail: `${raw} (requires Node >= 18)` };
+}
+function registerDoctorCommand(program, context) {
+    program
+        .command('doctor')
+        .description('Run local diagnostics and connectivity checks')
+        .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
+        });
+        const configPath = (0, config_1.getConfigPath)(context.homeDir);
+        const node = checkNodeVersion();
+        const report = {
+            version: context.version,
+            checks: [
+                {
+                    name: 'node_version',
+                    ok: node.ok,
+                    detail: node.detail
+                }
+            ]
+        };
+        try {
+            await (0, config_1.saveLocalConfig)({}, context.homeDir);
+            report.checks.push({
+                name: 'config_rw',
+                ok: true,
+                detail: configPath
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unable to access config file';
+            report.checks.push({
+                name: 'config_rw',
+                ok: false,
+                detail: message
+            });
+        }
+        if (runtime.apiKey) {
+            try {
+                const client = context.createApiClient(runtime);
+                await (0, whoami_1.fetchWhoAmI)(client);
+                report.checks.push({
+                    name: 'api_connectivity',
+                    ok: true,
+                    detail: 'whoami check passed'
+                });
+            }
+            catch (error) {
+                if ((0, shared_1.isAccountEndpointUnavailable)(error, runtime.apiBaseUrl)) {
+                    report.checks.push({
+                        name: 'api_connectivity',
+                        ok: true,
+                        detail: 'Authenticated API reachable (public account endpoint is unavailable on run API).'
+                    });
+                    const outputPath = (0, shared_1.resolveOutputPath)(context, options.output);
+                    await (0, output_1.renderOutput)({
+                        ctx: { stdout: context.stdout },
+                        data: report,
+                        json: options.json,
+                        outputPath,
+                        renderText: text_1.formatDoctorReport
+                    });
+                    return;
+                }
+                const message = error instanceof Error ? error.message : 'whoami check failed';
+                report.checks.push({
+                    name: 'api_connectivity',
+                    ok: false,
+                    detail: message
+                });
+            }
+        }
+        else {
+            report.checks.push({
+                name: 'api_key',
+                ok: false,
+                detail: 'API key not found (configure via login or XCRAWL_API_KEY)'
+            });
+        }
+        const outputPath = (0, shared_1.resolveOutputPath)(context, options.output);
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: report,
+            json: options.json,
+            outputPath,
+            renderText: text_1.formatDoctorReport
+        });
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInitCommand = registerInitCommand;
+function registerInitCommand(program) {
+    program.command('init').description('Initialize project workspace (planned)').action(() => {
+        process.stdout.write('`init` will be implemented in a later phase.\n');
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;AAEA,kDAIC;AAJD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;QACxF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/login.d.ts

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

package/dist/commands/login.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLoginCommand = registerLoginCommand;
+const config_1 = require("../core/config");
+const errors_1 = require("../core/errors");
+const output_1 = require("../core/output");
+const text_1 = require("../formatters/text");
+function registerLoginCommand(program, context) {
+    program
+        .command('login')
+        .description('Save the XCrawl API key to local config')
+        .option('--api-key <key>', 'XCrawl API Key')
+        .option('--json', 'Output result as JSON')
+        .action(async (options) => {
+        if (!options.apiKey || options.apiKey.trim().length === 0) {
+            throw new errors_1.ValidationError('Missing required argument: api-key.', 'Run `xcrawl login --api-key <key>`.');
+        }
+        const configPath = await (0, config_1.saveLocalConfig)({ apiKey: options.apiKey }, context.homeDir);
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: { ok: true, configPath },
+            json: options.json,
+            renderText: () => (0, text_1.formatLoginSuccess)(configPath)
+        });
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":";;AAaA,oDAmBC;AA9BD,2CAAiD;AACjD,2CAAiD;AACjD,2CAA8C;AAC9C,6CAAwD;AAQxD,SAAgB,oBAAoB,CAAC,OAAgB,EAAE,OAAmB;IACxE,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;SAC3C,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,OAAqB,EAAE,EAAE;QACtC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,wBAAe,CAAC,qCAAqC,EAAE,qCAAqC,CAAC,CAAC;QAC1G,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,IAAA,wBAAe,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACtF,MAAM,IAAA,qBAAY,EAAC;YACjB,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAC/B,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAA,yBAAkB,EAAC,UAAU,CAAC;SACjD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/map.d.ts

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

package/dist/commands/map.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMapCommand = registerMapCommand;
+const map_1 = require("../api/map");
+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 registerMapCommand(program, context) {
+    program
+        .command('map')
+        .description('Generate site map links for a URL')
+        .argument('<url>', 'Target URL')
+        .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')
+        .option('--max-depth <n>', 'Maximum traversal depth')
+        .option('--limit <n>', 'Maximum number of links')
+        .action(async (url, options) => {
+        (0, validate_1.assertHttpUrl)(url);
+        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 result = await (0, map_1.fetchMap)(client, {
+            url,
+            maxDepth: (0, validate_1.parsePositiveInt)(options.maxDepth, 'max-depth'),
+            limit: (0, validate_1.parsePositiveInt)(options.limit, 'limit')
+        });
+        const outputPath = (0, shared_1.resolveOutputPath)(context, options.output);
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: result,
+            json: options.json,
+            outputPath,
+            renderText: text_1.formatMap
+        });
+    });
+}
+//# sourceMappingURL=map.js.map

package/dist/commands/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/commands/map.ts"],"names":[],"mappings":";;AAqBA,gDA0CC;AA7DD,oCAAsC;AACtC,uCAA6C;AAC7C,2CAA8C;AAC9C,6CAA+C;AAE/C,gDAAoE;AACpE,qCAA0E;AAa1E,SAAgB,kBAAkB,CAAC,OAAgB,EAAE,OAAmB;IACtE,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,mCAAmC,CAAC;SAChD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;SAC/B,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,iBAAiB,EAAE,yBAAyB,CAAC;SACpD,MAAM,CAAC,aAAa,EAAE,yBAAyB,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAAmB,EAAE,EAAE;QACjD,IAAA,wBAAa,EAAC,GAAG,CAAC,CAAC;QAEnB,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;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAA,cAAQ,EAAC,MAAM,EAAE;YACpC,GAAG;YACH,QAAQ,EAAE,IAAA,2BAAgB,EAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC;YACzD,KAAK,EAAE,IAAA,2BAAgB,EAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SAChD,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,IAAA,0BAAiB,EAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAE9D,MAAM,IAAA,qBAAY,EAAC;YACjB,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAC/B,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU;YACV,UAAU,EAAE,gBAAS;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/scrape.d.ts

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

package/dist/commands/scrape.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScrapeCommand = registerScrapeCommand;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const scrape_1 = require("../api/scrape");
+const auth_1 = require("../core/auth");
+const errors_1 = require("../core/errors");
+const output_1 = require("../core/output");
+const json_1 = require("../formatters/json");
+const text_1 = require("../formatters/text");
+const files_1 = require("../core/files");
+const concurrency_1 = require("../utils/concurrency");
+const validate_1 = require("../utils/validate");
+const shared_1 = require("./shared");
+function extensionFor(format, jsonMode) {
+    if (jsonMode) {
+        return 'json';
+    }
+    switch (format) {
+        case 'markdown':
+            return 'md';
+        case 'html':
+            return 'html';
+        case 'screenshot':
+            return 'png';
+        case 'json':
+            return 'json';
+        default:
+            return 'txt';
+    }
+}
+async function loadUrlsFromInputFile(inputPath, cwd) {
+    const fullPath = node_path_1.default.isAbsolute(inputPath) ? inputPath : node_path_1.default.resolve(cwd, inputPath);
+    const content = await (0, promises_1.readFile)(fullPath, 'utf8');
+    return content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith('#'));
+}
+function registerScrapeCommand(program, context) {
+    program
+        .command('scrape')
+        .description('Scrape one or more URLs')
+        .argument('[url...]', 'URL list to scrape')
+        .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>', 'Output path; treated as a directory for multiple URLs')
+        .option('--format <format>', 'Output format: markdown/json/html/screenshot')
+        .option('--wait-for <selector>', 'Wait for selector before scraping')
+        .option('--headers <k:v,k2:v2>', 'Additional request headers')
+        .option('--cookies <cookies>', 'Cookie string')
+        .option('--proxy <proxy>', 'Proxy URL')
+        .option('--input <path>', 'Read URLs from a newline-delimited file')
+        .option('--concurrency <n>', 'Concurrent scrape workers (default: 3 for batch mode)')
+        .action(async (cliUrls, options) => {
+        const fileUrls = options.input ? await loadUrlsFromInputFile(options.input, context.cwd) : [];
+        const urls = [...cliUrls, ...fileUrls];
+        if (urls.length === 0) {
+            throw new errors_1.ValidationError('No URL provided.', 'Pass URLs as arguments, or use --input <path>.');
+        }
+        urls.forEach((url) => (0, validate_1.assertHttpUrl)(url));
+        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,
+            defaultFormat: options.format
+        });
+        runtime.apiKey = (0, auth_1.requireApiKey)(runtime.apiKey);
+        const format = options.format ?? runtime.defaultFormat;
+        const client = context.createApiClient(runtime);
+        const outputPath = (0, shared_1.resolveOutputPath)(context, options.output);
+        const concurrency = (0, validate_1.parsePositiveInt)(options.concurrency, 'concurrency') ?? 3;
+        const headers = (0, validate_1.parseHeaders)(options.headers);
+        const results = await (0, concurrency_1.runWithConcurrency)(urls, concurrency, async (url) => (0, scrape_1.scrapeUrl)(client, {
+            url,
+            format,
+            timeoutMs: runtime.timeoutMs,
+            waitFor: options.waitFor,
+            headers,
+            cookies: options.cookies,
+            proxy: options.proxy
+        }));
+        if (results.length > 1 && !options.output && options.json) {
+            await (0, output_1.renderOutput)({
+                ctx: { stdout: context.stdout },
+                data: results,
+                json: true,
+                renderText: () => ''
+            });
+            return;
+        }
+        if (results.length > 1) {
+            const targetDir = outputPath ?? node_path_1.default.resolve(context.cwd, runtime.outputDir);
+            const ext = extensionFor(format, options.json ?? false);
+            await (0, output_1.writeBatchOutput)(targetDir, results.map((item) => ({
+                fileName: `${(0, files_1.toSafeFileName)(item.url)}.${ext}`,
+                content: options.json ? (0, json_1.toStableJson)(item) : `${(0, text_1.formatScrape)(item)}\n`
+            })), context.stdout);
+            return;
+        }
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: results[0],
+            json: options.json,
+            outputPath,
+            renderText: text_1.formatScrape
+        });
+    });
+}
+//# sourceMappingURL=scrape.js.map

package/dist/commands/scrape.js.map

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

package/dist/commands/search.d.ts

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

package/dist/commands/search.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSearchCommand = registerSearchCommand;
+const search_1 = require("../api/search");
+const auth_1 = require("../core/auth");
+const output_1 = require("../core/output");
+const table_1 = require("../formatters/table");
+const text_1 = require("../formatters/text");
+const validate_1 = require("../utils/validate");
+const shared_1 = require("./shared");
+function formatSearchHuman(data) {
+    if (data.results.length === 0) {
+        return (0, text_1.formatSearch)(data);
+    }
+    return [
+        `Query: ${data.query}`,
+        '',
+        (0, table_1.renderTable)(data.results, [
+            { key: 'title', title: 'Title' },
+            { key: 'url', title: 'URL' }
+        ])
+    ].join('\n');
+}
+function registerSearchCommand(program, context) {
+    program
+        .command('search')
+        .description('Run a web search')
+        .argument('<query...>', 'Search query')
+        .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')
+        .option('--limit <n>', 'Result limit, default is 10')
+        .option('--country <country>', 'Country code, e.g. US')
+        .option('--language <language>', 'Language code, e.g. en')
+        .action(async (queryParts, options) => {
+        const query = queryParts.join(' ').trim();
+        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 result = await (0, search_1.searchWeb)(client, {
+            query,
+            limit: (0, validate_1.parsePositiveInt)(options.limit, 'limit') ?? 10,
+            country: options.country,
+            language: options.language
+        });
+        const outputPath = (0, shared_1.resolveOutputPath)(context, options.output);
+        await (0, output_1.renderOutput)({
+            ctx: { stdout: context.stdout },
+            data: result,
+            json: options.json,
+            outputPath,
+            renderText: formatSearchHuman
+        });
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":";;AAuCA,sDA2CC;AAhFD,0CAA0C;AAC1C,uCAA6C;AAC7C,2CAA8C;AAC9C,+CAAkD;AAClD,6CAAkD;AAGlD,gDAAqD;AACrD,qCAA0E;AAc1E,SAAS,iBAAiB,CAAC,IAAoB;IAC7C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAA,mBAAY,EAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,UAAU,IAAI,CAAC,KAAK,EAAE;QACtB,EAAE;QACF,IAAA,mBAAW,EAAC,IAAI,CAAC,OAAO,EAAE;YACxB,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;YAChC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;SAC7B,CAAC;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB,EAAE,OAAmB;IACzE,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kBAAkB,CAAC;SAC/B,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;SACtC,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,aAAa,EAAE,6BAA6B,CAAC;SACpD,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;SACtD,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,UAAoB,EAAE,OAAsB,EAAE,EAAE;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE1C,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;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,MAAM,IAAA,kBAAS,EAAC,MAAM,EAAE;YACrC,KAAK;YACL,KAAK,EAAE,IAAA,2BAAgB,EAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;YACrD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,IAAA,0BAAiB,EAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAE9D,MAAM,IAAA,qBAAY,EAAC;YACjB,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YAC/B,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU;YACV,UAAU,EAAE,iBAAiB;SAC9B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/shared.d.ts

@@ -0,0 +1,14 @@
+import type { CliContext } from '../types/cli';
+import type { RuntimeConfig, XCrawlConfig } from '../types/config';
+export interface CommonCommandOptions {
+    apiKey?: string;
+    apiBaseUrl?: string;
+    timeout?: number;
+    debug?: boolean;
+    json?: boolean;
+    output?: string;
+}
+export declare function resolveCommandRuntimeConfig(context: CliContext, flags?: XCrawlConfig): Promise<RuntimeConfig>;
+export declare function resolveOutputPath(context: CliContext, outputPath: string | undefined): string | undefined;
+export declare function isRunApiBaseUrl(baseUrl: string): boolean;
+export declare function isAccountEndpointUnavailable(error: unknown, baseUrl: string): boolean;