datavessel-cli 0.1.0

package/dist/commands/config.js

@@ -0,0 +1,108 @@
+/**
+ * `config` and `sync` commands.
+ *
+ * `config` manages non-secret per-profile settings (base URL, default
+ * profile). `sync` force-refreshes the local tool catalog cache.
+ */
+import { buildContext, globalOpts } from '../context.js';
+import { refreshCatalog } from '../catalog.js';
+import { DEFAULT_BASE_URL, configDir, listProfiles, resolveConfig, resolveProfileName, setAppUrl, setBaseUrl, setDefaultProfile, } from '../config.js';
+import { CliError, ExitCode } from '../errors.js';
+import { printJson, success, info, table, c } from '../output.js';
+export function registerConfigCommands(program) {
+    const config = program.command('config').description('Manage CLI configuration');
+    config
+        .command('show')
+        .description('Show the resolved configuration for the active profile')
+        .action((_opts, cmd) => {
+        const global = globalOpts(cmd);
+        const resolved = resolveConfig(global.profile);
+        const data = {
+            profile: resolved.profile,
+            baseUrl: resolved.baseUrl,
+            appUrl: resolved.appUrl,
+            authenticated: Boolean(resolved.credential),
+            authType: resolved.credential?.type ?? null,
+            configDir: configDir(),
+            profiles: listProfiles(),
+        };
+        if (global.json) {
+            printJson(data);
+            return;
+        }
+        info(table(['FIELD', 'VALUE'], [
+            ['profile', data.profile],
+            ['base-url', data.baseUrl],
+            ['app-url', data.appUrl],
+            ['authenticated', String(data.authenticated)],
+            ['auth-type', String(data.authType ?? '-')],
+            ['config-dir', data.configDir],
+            ['profiles', data.profiles.join(', ')],
+        ]));
+    });
+    config
+        .command('get <key>')
+        .description('Get a config value. Keys: base-url, app-url, default-profile')
+        .action((key, _opts, cmd) => {
+        const global = globalOpts(cmd);
+        const resolved = resolveConfig(global.profile);
+        switch (key) {
+            case 'base-url':
+                info(resolved.baseUrl);
+                break;
+            case 'app-url':
+                info(resolved.appUrl);
+                break;
+            case 'default-profile':
+                info(resolveProfileName());
+                break;
+            default:
+                throw new CliError(`Unknown config key: ${key}`, ExitCode.USAGE, 'Keys: base-url, app-url, default-profile');
+        }
+    });
+    config
+        .command('set <key> <value>')
+        .description('Set a config value. Keys: base-url, app-url, default-profile')
+        .action((key, value, _opts, cmd) => {
+        const global = globalOpts(cmd);
+        const profile = resolveProfileName(global.profile);
+        switch (key) {
+            case 'base-url':
+                setBaseUrl(profile, value);
+                success(`Set base-url for profile ${c.cyan(profile)} to ${value}`);
+                break;
+            case 'app-url':
+                setAppUrl(profile, value);
+                success(`Set app-url for profile ${c.cyan(profile)} to ${value}`);
+                break;
+            case 'default-profile':
+                setDefaultProfile(value);
+                success(`Default profile set to ${c.cyan(value)}`);
+                break;
+            default:
+                throw new CliError(`Unknown config key: ${key}`, ExitCode.USAGE, 'Keys: base-url, app-url, default-profile');
+        }
+    });
+    config
+        .command('reset-base-url')
+        .description(`Reset base-url to the default (${DEFAULT_BASE_URL})`)
+        .action((_opts, cmd) => {
+        const global = globalOpts(cmd);
+        const profile = resolveProfileName(global.profile);
+        setBaseUrl(profile, DEFAULT_BASE_URL);
+        success(`Reset base-url for profile ${c.cyan(profile)} to ${DEFAULT_BASE_URL}`);
+    });
+    program
+        .command('sync')
+        .description('Force-refresh the local tool catalog from the backend')
+        .action(async (_opts, cmd) => {
+        const ctx = buildContext(cmd);
+        const tools = await refreshCatalog(ctx.client);
+        if (ctx.global.json) {
+            printJson({ tools: tools.length, baseUrl: ctx.client.baseUrl });
+            return;
+        }
+        success(`Synced ${tools.length} tools from ${ctx.client.baseUrl}`);
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/run.js

@@ -0,0 +1,185 @@
+/**
+ * `datavessel run <tool> [--flags…]` — execute any catalog tool.
+ *
+ * Flags are validated against the tool's `inputSchema` from the catalog. Two
+ * escape hatches always work for power users / odd schemas:
+ *   --param key=value     (repeatable) set one parameter as a raw string
+ *   --params-json '<json>'  merge a full JSON object of parameters
+ *
+ * Write tools prompt for confirmation unless `--yes` (global) is set.
+ * Global options (e.g. `--json`) must precede `run`: `datavessel --json run …`.
+ */
+import { buildContext } from '../context.js';
+import { getCatalog, findTool } from '../catalog.js';
+import { schemaToParams, collectParams, describeSchema, } from '../schema.js';
+import { CliError, ExitCode } from '../errors.js';
+import { printJson, info, success, warn, c } from '../output.js';
+import { confirm, isInteractive } from '../prompt.js';
+/** Parse the raw token stream after `<tool>` into flags + escape-hatch params. */
+export function parseRawFlags(tokens) {
+    const flags = {};
+    const params = {};
+    let wantsHelp = false;
+    const addFlag = (name, value) => {
+        const prev = flags[name];
+        if (Array.isArray(prev))
+            prev.push(value);
+        else
+            flags[name] = [value];
+    };
+    for (let i = 0; i < tokens.length; i++) {
+        const tok = tokens[i];
+        if (tok === '--help' || tok === '-h') {
+            wantsHelp = true;
+            continue;
+        }
+        if (!tok.startsWith('--')) {
+            throw new CliError(`Unexpected argument: ${tok}`, ExitCode.USAGE);
+        }
+        let name = tok.slice(2);
+        let inlineValue;
+        const eq = name.indexOf('=');
+        if (eq !== -1) {
+            inlineValue = name.slice(eq + 1);
+            name = name.slice(0, eq);
+        }
+        // Escape hatches.
+        if (name === 'params-json') {
+            const raw = inlineValue ?? tokens[++i];
+            if (raw === undefined)
+                throw new CliError('--params-json requires a value', ExitCode.USAGE);
+            let obj;
+            try {
+                obj = JSON.parse(raw);
+            }
+            catch {
+                throw new CliError('--params-json must be valid JSON', ExitCode.USAGE);
+            }
+            if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
+                throw new CliError('--params-json must be a JSON object', ExitCode.USAGE);
+            }
+            Object.assign(params, obj);
+            continue;
+        }
+        if (name === 'param') {
+            const raw = inlineValue ?? tokens[++i];
+            if (raw === undefined)
+                throw new CliError('--param requires key=value', ExitCode.USAGE);
+            const kv = raw.indexOf('=');
+            if (kv === -1)
+                throw new CliError(`--param expects key=value, got "${raw}"`, ExitCode.USAGE);
+            params[raw.slice(0, kv)] = raw.slice(kv + 1);
+            continue;
+        }
+        // Boolean negation: --no-foo
+        if (name.startsWith('no-')) {
+            flags[name.slice(3)] = false;
+            continue;
+        }
+        if (inlineValue !== undefined) {
+            addFlag(name, inlineValue);
+            continue;
+        }
+        // Look ahead: a following non-flag token is this flag's value; otherwise
+        // it's a boolean switch.
+        const next = tokens[i + 1];
+        if (next !== undefined && !next.startsWith('--')) {
+            addFlag(name, next);
+            i++;
+        }
+        else {
+            flags[name] = true;
+        }
+    }
+    return { flags, params, wantsHelp };
+}
+/** Map parsed kebab-flags onto the commander-style opts object keyed by attr. */
+function flagsToOpts(parsed, params) {
+    const byFlag = new Map(params.map((p) => [p.flag, p]));
+    const opts = {};
+    const unknown = [];
+    for (const [flag, value] of Object.entries(parsed.flags)) {
+        const desc = byFlag.get(flag);
+        if (!desc) {
+            // Unknown flag: keep as a raw string param so schemaless tools still work.
+            if (!(flag in parsed.params)) {
+                parsed.params[flag] = Array.isArray(value) ? value[value.length - 1] : value;
+            }
+            unknown.push(flag);
+            continue;
+        }
+        if (desc.type === 'array') {
+            opts[desc.attr] = Array.isArray(value) ? value : [value];
+        }
+        else if (Array.isArray(value)) {
+            opts[desc.attr] = value[value.length - 1]; // last wins for scalars
+        }
+        else {
+            opts[desc.attr] = value;
+        }
+    }
+    return { opts, unknown };
+}
+export function registerRunCommand(program) {
+    program
+        .command('run')
+        .description('Execute a tool by name (flags are derived from its schema)')
+        .argument('<tool>', 'Tool name, e.g. get_account_summaries')
+        .argument('[params...]', 'Tool parameters as --flag value (see `tools show <tool>`)')
+        .passThroughOptions()
+        .allowUnknownOption()
+        .addHelpText('after', '\nExamples:\n' +
+        '  datavessel run get_account_summaries\n' +
+        '  datavessel run run_report --property-id 123 --metrics sessions --metrics users\n' +
+        "  datavessel run some_tool --params-json '{\"a\":1}'\n" +
+        '  datavessel --json run list_sites\n')
+        .action(async (toolName, rawParams, _opts, cmd) => {
+        const ctx = buildContext(cmd);
+        const catalog = await getCatalog(ctx.client);
+        const tool = findTool(catalog, toolName);
+        if (!tool) {
+            throw new CliError(`Unknown tool: ${toolName}`, ExitCode.USAGE, 'Run `datavessel tools list` to see available tools.');
+        }
+        const descriptors = schemaToParams(tool.inputSchema);
+        const parsed = parseRawFlags(rawParams);
+        if (parsed.wantsHelp) {
+            info(`${c.bold(tool.toolName)}  ${c.dim(`(${tool.provider}, ${tool.access})`)}`);
+            if (tool.description)
+                info(`\n${tool.description}`);
+            info(`\n${c.bold('Parameters:')}`);
+            info(describeSchema(descriptors));
+            return;
+        }
+        const { opts, unknown } = flagsToOpts(parsed, descriptors);
+        if (unknown.length > 0 && descriptors.length > 0) {
+            warn(`Unknown flag(s) sent as raw string params: ${unknown
+                .map((f) => '--' + f)
+                .join(', ')}. See \`datavessel tools show ${toolName}\`.`);
+        }
+        const params = collectParams(descriptors, opts, parsed.params);
+        // Guard destructive/write tools behind a confirmation.
+        if (tool.access === 'write' && !ctx.global.yes) {
+            if (!isInteractive()) {
+                throw new CliError(`'${toolName}' is a write tool; refusing to run non-interactively without --yes.`, ExitCode.USAGE);
+            }
+            const ok = await confirm(`${c.yellow('!')} '${toolName}' modifies data. Continue?`, false);
+            if (!ok) {
+                info('Aborted.');
+                process.exitCode = ExitCode.OK;
+                return;
+            }
+        }
+        const result = await ctx.client.execute(toolName, params);
+        if (ctx.global.json) {
+            printJson(result);
+        }
+        else if (typeof result === 'string') {
+            process.stdout.write(result + '\n');
+        }
+        else {
+            printJson(result);
+        }
+        success(`Executed ${toolName}`);
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/tools.js

@@ -0,0 +1,84 @@
+/**
+ * Tool catalog commands: `tools list` and `tools show <name>`.
+ *
+ * Both read the catalog from the local cache (refreshing from the backend when
+ * stale). `tools show` renders the dynamically-derived flags for a tool — the
+ * same flags `datavessel run <tool>` accepts.
+ */
+import { buildContext } from '../context.js';
+import { getCatalog, findTool } from '../catalog.js';
+import { schemaToParams, describeSchema } from '../schema.js';
+import { CliError, ExitCode } from '../errors.js';
+import { printJson, table, info, c } from '../output.js';
+export function registerToolsCommands(program) {
+    const tools = program.command('tools').description('Browse the available tool catalog');
+    tools
+        .command('list')
+        .description('List all available tools')
+        .option('-p, --provider <name>', 'Filter by provider (e.g. google_analytics)')
+        .option('-a, --access <type>', "Filter by access: 'read' or 'write'")
+        .option('-s, --search <text>', 'Filter by substring in name or description')
+        .option('--refresh', 'Force-refresh the catalog from the backend')
+        .action(async (opts, cmd) => {
+        const ctx = buildContext(cmd);
+        let catalog = await getCatalog(ctx.client, { forceRefresh: Boolean(opts.refresh) });
+        if (opts.provider)
+            catalog = catalog.filter((t) => t.provider === opts.provider);
+        if (opts.access)
+            catalog = catalog.filter((t) => t.access === opts.access);
+        if (opts.search) {
+            const q = String(opts.search).toLowerCase();
+            catalog = catalog.filter((t) => t.toolName.toLowerCase().includes(q) ||
+                (t.description ?? '').toLowerCase().includes(q));
+        }
+        catalog = [...catalog].sort((a, b) => a.provider.localeCompare(b.provider) || a.toolName.localeCompare(b.toolName));
+        if (ctx.global.json) {
+            printJson(catalog);
+            return;
+        }
+        if (catalog.length === 0) {
+            info('No matching tools.');
+            return;
+        }
+        const rows = catalog.map((t) => [
+            t.access === 'write' ? c.yellow(t.toolName) : t.toolName,
+            t.provider,
+            t.access,
+            truncate(t.description ?? '', 60),
+        ]);
+        info(table(['TOOL', 'PROVIDER', 'ACCESS', 'DESCRIPTION'], rows));
+        info('');
+        info(c.dim(`${catalog.length} tool(s). Run \`datavessel tools show <name>\` for details.`));
+    });
+    tools
+        .command('show <name>')
+        .description('Show a tool description and its parameters')
+        .option('--refresh', 'Force-refresh the catalog from the backend')
+        .action(async (name, opts, cmd) => {
+        const ctx = buildContext(cmd);
+        const catalog = await getCatalog(ctx.client, { forceRefresh: Boolean(opts.refresh) });
+        const tool = findTool(catalog, name);
+        if (!tool) {
+            throw new CliError(`Unknown tool: ${name}`, ExitCode.USAGE, 'Run `datavessel tools list` to see available tools.');
+        }
+        if (ctx.global.json) {
+            printJson(tool);
+            return;
+        }
+        const params = schemaToParams(tool.inputSchema);
+        info(`${c.bold(tool.toolName)}  ${c.dim(`(${tool.provider}, ${tool.access})`)}`);
+        if (tool.description)
+            info(`\n${tool.description}`);
+        info(`\n${c.bold('Parameters:')}`);
+        info(describeSchema(params));
+        info(`\n${c.dim('Run with:')} datavessel run ${tool.toolName} ${params
+            .filter((p) => p.required)
+            .map((p) => `--${p.flag} <…>`)
+            .join(' ')}`);
+    });
+}
+function truncate(s, n) {
+    const clean = s.replace(/\s+/g, ' ').trim();
+    return clean.length > n ? clean.slice(0, n - 1) + '…' : clean;
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAqB,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC;IAExF,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,uBAAuB,EAAE,4CAA4C,CAAC;SAC7E,MAAM,CAAC,qBAAqB,EAAE,qCAAqC,CAAC;SACpE,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;SAC3E,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAY,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEpF,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO,GAAG,OAAO,CAAC,MAAM,CACtB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAClD,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CACvF,CAAC;QAEF,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,SAAS,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC9B,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;YACxD,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,MAAM;YACR,QAAQ,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,EAAE,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,EAAE,CAAC,CAAC;QACT,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,6DAA6D,CAAC,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAI,EAAE,GAAY,EAAE,EAAE;QACjD,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,QAAQ,CAChB,iBAAiB,IAAI,EAAE,EACvB,QAAQ,CAAC,KAAK,EACd,qDAAqD,CACtD,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,WAAkC,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,mBAAmB,IAAI,CAAC,QAAQ,IAAI,MAAM;aACnE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC;aAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC"}

package/dist/config.js

@@ -0,0 +1,138 @@
+/**
+ * Configuration and credential storage.
+ *
+ * Two files live under the datavessel config dir (default
+ * `~/.config/datavessel`, override with `DATAVESSEL_CONFIG_DIR`):
+ *
+ *   - config.json      non-secret settings (base URL, default profile, …)
+ *   - credentials.json  auth tokens, written with 0600 perms
+ *
+ * Both support named profiles so a user can keep separate prod / staging /
+ * personal credentials. The active profile is chosen by (in order):
+ *   `--profile` flag → `DATAVESSEL_PROFILE` env → config `defaultProfile` →
+ *   "default".
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Production backend API base. Override per-profile or with DATAVESSEL_API_URL. */
+export const DEFAULT_BASE_URL = 'https://api.datavessel.io';
+/** Web app base, used for the browser login handoff. Override with DATAVESSEL_APP_URL. */
+export const DEFAULT_APP_URL = 'https://app.datavessel.io';
+export function configDir() {
+    if (process.env.DATAVESSEL_CONFIG_DIR)
+        return process.env.DATAVESSEL_CONFIG_DIR;
+    const base = process.env.XDG_CONFIG_HOME && process.env.XDG_CONFIG_HOME.length > 0
+        ? process.env.XDG_CONFIG_HOME
+        : join(homedir(), '.config');
+    return join(base, 'datavessel');
+}
+const configPath = () => join(configDir(), 'config.json');
+const credentialsPath = () => join(configDir(), 'credentials.json');
+const catalogPath = () => join(configDir(), 'catalog.json');
+export function ensureDir() {
+    const dir = configDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+}
+function readJson(path, fallback) {
+    if (!existsSync(path))
+        return fallback;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+function readConfig() {
+    return readJson(configPath(), {});
+}
+function readCredentials() {
+    return readJson(credentialsPath(), {});
+}
+function writeConfig(cfg) {
+    ensureDir();
+    writeFileSync(configPath(), JSON.stringify(cfg, null, 2) + '\n', { mode: 0o600 });
+}
+function writeCredentials(creds) {
+    ensureDir();
+    writeFileSync(credentialsPath(), JSON.stringify(creds, null, 2) + '\n', { mode: 0o600 });
+    // Defensive: re-assert perms in case the file pre-existed with looser bits.
+    try {
+        chmodSync(credentialsPath(), 0o600);
+    }
+    catch {
+        /* best effort */
+    }
+}
+/** The profile name in effect, honouring flag → env → config default. */
+export function resolveProfileName(flagProfile) {
+    return (flagProfile ||
+        process.env.DATAVESSEL_PROFILE ||
+        readConfig().defaultProfile ||
+        'default');
+}
+/**
+ * Resolve the full active config: base URL and credential for the chosen
+ * profile, with env-var overrides applied. The base URL precedence is
+ * `DATAVESSEL_API_URL` → per-profile config → built-in default.
+ */
+export function resolveConfig(flagProfile) {
+    const profile = resolveProfileName(flagProfile);
+    const cfg = readConfig();
+    const baseUrl = process.env.DATAVESSEL_API_URL ||
+        cfg.profiles?.[profile]?.baseUrl ||
+        DEFAULT_BASE_URL;
+    const appUrl = process.env.DATAVESSEL_APP_URL ||
+        cfg.profiles?.[profile]?.appUrl ||
+        DEFAULT_APP_URL;
+    let credential = readCredentials()[profile];
+    // Env tokens win so CI can inject auth without touching disk.
+    if (process.env.DATAVESSEL_TOKEN) {
+        credential = { type: 'bearer', token: process.env.DATAVESSEL_TOKEN };
+    }
+    else if (process.env.DATAVESSEL_API_KEY) {
+        credential = { type: 'api-key', token: process.env.DATAVESSEL_API_KEY };
+    }
+    return { profile, baseUrl, appUrl, credential };
+}
+export function setBaseUrl(profile, baseUrl) {
+    const cfg = readConfig();
+    cfg.profiles ??= {};
+    cfg.profiles[profile] ??= {};
+    cfg.profiles[profile].baseUrl = baseUrl;
+    writeConfig(cfg);
+}
+export function setAppUrl(profile, appUrl) {
+    const cfg = readConfig();
+    cfg.profiles ??= {};
+    cfg.profiles[profile] ??= {};
+    cfg.profiles[profile].appUrl = appUrl;
+    writeConfig(cfg);
+}
+export function setDefaultProfile(profile) {
+    const cfg = readConfig();
+    cfg.defaultProfile = profile;
+    writeConfig(cfg);
+}
+export function saveCredential(profile, credential) {
+    const creds = readCredentials();
+    creds[profile] = credential;
+    writeCredentials(creds);
+}
+export function clearCredential(profile) {
+    const creds = readCredentials();
+    if (!(profile in creds))
+        return false;
+    delete creds[profile];
+    writeCredentials(creds);
+    return true;
+}
+export function listProfiles() {
+    const fromConfig = Object.keys(readConfig().profiles ?? {});
+    const fromCreds = Object.keys(readCredentials());
+    return [...new Set(['default', ...fromConfig, ...fromCreds])].sort();
+}
+export const _paths = { configPath, credentialsPath, catalogPath };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context.js

@@ -0,0 +1,39 @@
+/**
+ * Builds the per-invocation context (resolved config + API client) from the
+ * program's global options, applying flag overrides on top of stored config.
+ */
+import { ApiClient } from './api.js';
+import { resolveConfig, saveCredential } from './config.js';
+/** Read the root program's global options regardless of nesting depth. */
+export function globalOpts(cmd) {
+    let root = cmd;
+    while (root.parent)
+        root = root.parent;
+    return root.opts();
+}
+export function buildContext(cmd) {
+    const global = globalOpts(cmd);
+    const config = resolveConfig(global.profile);
+    // Flag overrides take precedence over stored/env config.
+    if (global.baseUrl)
+        config.baseUrl = global.baseUrl;
+    let credential = config.credential;
+    let fromStore = true;
+    if (global.token) {
+        credential = { type: 'bearer', token: global.token };
+        fromStore = false;
+    }
+    else if (global.apiKey) {
+        credential = { type: 'api-key', token: global.apiKey };
+        fromStore = false;
+    }
+    config.credential = credential;
+    // Persist rotated OAuth tokens only when the credential came from disk (not
+    // from an ephemeral --token / env override).
+    const onRefresh = fromStore && credential?.type === 'oauth'
+        ? (c) => saveCredential(config.profile, c)
+        : undefined;
+    const client = new ApiClient({ baseUrl: config.baseUrl, credential, onRefresh });
+    return { global, config, client };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAwC,MAAM,aAAa,CAAC;AAkBlG,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,IAAI,IAAI,GAAY,GAAG,CAAC;IACxB,OAAO,IAAI,CAAC,MAAM;QAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,EAAiB,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE7C,yDAAyD;IACzD,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACpD,IAAI,UAAU,GAA2B,MAAM,CAAC,UAAU,CAAC;IAC3D,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,UAAU,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACrD,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACzB,UAAU,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACvD,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAE/B,4EAA4E;IAC5E,6CAA6C;IAC7C,MAAM,SAAS,GACb,SAAS,IAAI,UAAU,EAAE,IAAI,KAAK,OAAO;QACvC,CAAC,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC"}