@vorlek/cli 0.1.0 → 0.2.1

package/README.md

@@ -18,8 +18,10 @@ the CLI.
 vorlek auth signup
 vorlek auth use --api-key vk_live_...
 vorlek connect sendgrid --api-key SG....
+vorlek connect reconnect klaviyo --api-key pk_...
 vorlek catalog
 vorlek contact upsert --provider sendgrid --email person@example.com --detail full
+vorlek contact upsert-all --email person@example.com --providers sendgrid,mailchimp,klaviyo --detail full
 vorlek contact get --provider sendgrid --email person@example.com
 vorlek operation get 01HV0000000000000000000000
 vorlek template list --provider sendgrid
@@ -30,4 +32,6 @@ vorlek status --check
 
 Tool commands accept `--detail minimal|standard|full` where the API supports
 response verbosity. Use `operation get` with the `meta.request_id` returned by
-API responses to inspect a stored operation receipt.
+API and CLI JSON responses to inspect a stored operation receipt. `contact
+upsert-all` writes the same contact to every connected provider by default, or
+to the comma-separated `--providers` list when provided.

package/dist/cli.js

@@ -23,7 +23,7 @@ import { defaultDeps } from './deps.js';
  */
 const cli = cac('vorlek');
 cli.help();
-cli.version('0.1.0');
+cli.version('0.2.1');
 cli.option('--api-base <url>', 'Override API base URL (default: from config or https://api.vorlek.com)');
 cli.option('--json', 'Output raw JSON (machine-readable)');
 cli.option('-v, --verbose', 'Verbose logging (includes stack traces on errors)');

package/dist/client.js

@@ -42,7 +42,7 @@ export function createApiClient(opts) {
             ],
         },
     });
-    async function call(path, init) {
+    async function callResult(path, init) {
         const res = await http(path, init);
         const text = await res.text();
         let body;
@@ -63,17 +63,22 @@ export function createApiClient(opts) {
                 throw new ApiError(res.status, body);
             }
             if (obj.status === 'success' && 'data' in obj) {
-                return body.data;
+                const envelope = body;
+                return { data: envelope.data, meta: envelope.meta, tip: envelope.tip };
             }
             // Non-2xx without an error envelope = something unusual; surface it.
             if (res.status < 200 || res.status >= 300) {
                 throw new Error(`Server returned status ${res.status} without an error envelope: ${text.slice(0, 200)}`);
             }
             // Flat success — body itself is the response.
-            return body;
+            return { data: body };
         }
         throw new Error(`Server returned a non-object response: ${text.slice(0, 200)}`);
     }
+    async function call(path, init) {
+        const result = await callResult(path, init);
+        return result.data;
+    }
     function toolPostInit(input) {
         const { idempotencyKey, detail, ...json } = input;
         return {
@@ -96,6 +101,12 @@ export function createApiClient(opts) {
         createConnection(input) {
             return call('v1/connections', { method: 'POST', json: input });
         },
+        updateConnection(provider, input) {
+            return call(`v1/connections/${provider}`, {
+                method: 'PATCH',
+                json: input,
+            });
+        },
         listConnections() {
             return call('v1/connections', { method: 'GET' });
         },
@@ -115,6 +126,9 @@ export function createApiClient(opts) {
         upsertContact(input) {
             return call('v1/tools/upsert_contact', toolPostInit(input));
         },
+        upsertContactWithMeta(input) {
+            return callResult('v1/tools/upsert_contact', toolPostInit(input));
+        },
         getContact(input) {
             return call('v1/tools/get_contact', toolPostInit(input));
         },

package/dist/commands/connect.js

@@ -20,24 +20,37 @@ function availableAudiencesFromError(err) {
 function connectionPayload(provider, opts, listId) {
     return {
         provider,
+        ...credentialPayload(provider, opts, listId),
+    };
+}
+function credentialPayload(provider, opts, listId) {
+    return {
         api_key: opts.apiKey ?? '',
         ...(provider === 'mailchimp' && listId ? { list_id: listId } : {}),
     };
 }
-function renderConnectSuccess(deps, ctx, provider, conn) {
-    renderSuccess(deps, ctx, conn, () => `${pc.green('✓')} Connected ${pc.bold(provider)} ${conn.account_name ? `(${pc.dim(conn.account_name)}) ` : ''}— connection_id ${pc.dim(conn.connection_id)}`);
+function renderConnectSuccess(deps, ctx, provider, conn, verb = 'Connected') {
+    renderSuccess(deps, ctx, conn, () => `${pc.green('✓')} ${verb} ${pc.bold(provider)} ${conn.account_name ? `(${pc.dim(conn.account_name)}) ` : ''}— connection_id ${pc.dim(conn.connection_id)}`);
+}
+function validateConnectInput(provider, opts) {
+    if (!opts.apiKey)
+        throw new Error('Missing --api-key flag.');
+    if (provider === 'klaviyo') {
+        if (opts.listId)
+            throw new Error('Klaviyo connections do not use --list-id.');
+    }
+}
+function klaviyoPublicKeyWarning(opts, ctx) {
+    return !ctx.json && opts.apiKey?.startsWith('pub_')
+        ? `${pc.yellow('warning')} Klaviyo public keys start with pub_; use a private key starting with pk_ for write operations.\n`
+        : undefined;
 }
 export async function runConnect(deps, ctx, provider, opts) {
     try {
-        if (!opts.apiKey)
-            throw new Error('Missing --api-key flag.');
-        if (provider === 'klaviyo') {
-            if (opts.listId)
-                throw new Error('Klaviyo connections do not use --list-id.');
-            if (opts.apiKey.startsWith('pub_') && !ctx.json) {
-                deps.stderr.write(`${pc.yellow('warning')} Klaviyo public keys start with pub_; use a private key starting with pk_ for write operations.\n`);
-            }
-        }
+        validateConnectInput(provider, opts);
+        const warning = provider === 'klaviyo' ? klaviyoPublicKeyWarning(opts, ctx) : undefined;
+        if (warning)
+            deps.stderr.write(warning);
         const cfg = await deps.loadConfig();
         if (!cfg)
             throw new ConfigMissingError();
@@ -69,6 +82,48 @@ export async function runConnect(deps, ctx, provider, opts) {
         deps.exit(renderError(deps, ctx, err));
     }
 }
+export async function runReconnect(deps, ctx, provider, opts) {
+    try {
+        if (!provider)
+            throw new Error('Missing <provider> argument: `vorlek connect reconnect <provider>`.');
+        validateConnectInput(provider, opts);
+        const warning = provider === 'klaviyo' ? klaviyoPublicKeyWarning(opts, ctx) : undefined;
+        if (warning)
+            deps.stderr.write(warning);
+        const cfg = await deps.loadConfig();
+        if (!cfg)
+            throw new ConfigMissingError();
+        const apiBase = ctx.apiBaseOverride ?? cfg.api_base;
+        const client = deps.createApiClient({ apiBase, apiKey: cfg.api_key });
+        if (!client.updateConnection) {
+            throw new Error('Configured API client does not support connection reconnect.');
+        }
+        try {
+            const conn = await client.updateConnection(provider, credentialPayload(provider, opts, opts.listId));
+            renderConnectSuccess(deps, ctx, provider, conn, 'Reconnected');
+        }
+        catch (err) {
+            const audiences = availableAudiencesFromError(err);
+            if (provider !== 'mailchimp' || ctx.json || opts.listId || audiences.length === 0)
+                throw err;
+            const selected = await deps.prompts.select({
+                message: 'Select Mailchimp audience',
+                options: audiences.map((audience) => ({
+                    value: audience.id,
+                    label: audience.name,
+                    hint: audience.id,
+                })),
+            });
+            if (deps.prompts.isCancel(selected))
+                throw new Error('Audience selection cancelled.');
+            const conn = await client.updateConnection(provider, credentialPayload(provider, opts, String(selected)));
+            renderConnectSuccess(deps, ctx, provider, conn, 'Reconnected');
+        }
+    }
+    catch (err) {
+        deps.exit(renderError(deps, ctx, err));
+    }
+}
 export async function runList(deps, ctx) {
     try {
         const cfg = await deps.loadConfig();
@@ -111,7 +166,7 @@ export async function runRemove(deps, ctx, provider) {
 }
 export function registerConnectCommands(cli, deps, ctx) {
     cli
-        .command('connect <action> [target]', 'Connect: <provider> --api-key <k> | list | remove <provider>')
+        .command('connect <action> [target]', 'Connect: <provider> --api-key <k> | reconnect <provider> --api-key <k> | list | remove <provider>')
         .option('--api-key <key>', 'Provider API key (required for connect <provider>)')
         .option('--list-id <id>', 'Mailchimp audience/list id')
         .action(async (action, target, opts) => {
@@ -119,6 +174,8 @@ export function registerConnectCommands(cli, deps, ctx) {
             return runList(deps, ctx);
         if (action === 'remove')
             return runRemove(deps, ctx, target);
+        if (action === 'reconnect')
+            return runReconnect(deps, ctx, target, opts);
         // Otherwise treat `action` as the provider name → create.
         return runConnect(deps, ctx, action, opts);
     });

package/dist/commands/contact.js

@@ -22,22 +22,9 @@ export async function runUpsertContact(deps, ctx, opts) {
             }
             provider = conns[0]?.provider;
         }
-        let properties;
-        if (opts.properties) {
-            try {
-                const parsed = JSON.parse(opts.properties);
-                if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
-                    throw new Error('--properties must be a JSON object.');
-                }
-                properties = parsed;
-            }
-            catch (parseErr) {
-                const msg = parseErr instanceof Error ? parseErr.message : String(parseErr);
-                throw new Error(`--properties: ${msg}`);
-            }
-        }
+        const properties = parseProperties(opts.properties);
         const detail = parseDetail(opts.detail);
-        const result = await client.upsertContact({
+        const result = await upsertContactWithResult(client, {
             provider,
             email: opts.email,
             first_name: opts.firstName,
@@ -49,12 +36,47 @@ export async function runUpsertContact(deps, ctx, opts) {
             ...(detail ? { detail } : {}),
             ...(opts.idempotencyKey ? { idempotencyKey: opts.idempotencyKey } : {}),
         });
-        renderSuccess(deps, ctx, result, () => {
-            const fieldsHint = result.fields_auto_created.length > 0
-                ? ` ${pc.dim(`(auto-created fields: ${result.fields_auto_created.join(', ')})`)}`
+        renderSuccess(deps, ctx, result.data, () => {
+            const fieldsHint = result.data.fields_auto_created.length > 0
+                ? ` ${pc.dim(`(auto-created fields: ${result.data.fields_auto_created.join(', ')})`)}`
                 : '';
-            return `${pc.green('✓')} Upserted contact ${pc.bold(result.contact_id)} (${result.action}) via ${pc.bold(result.provider)}.${fieldsHint}`;
-        });
+            return `${pc.green('✓')} Upserted contact ${pc.bold(result.data.contact_id)} (${result.data.action}) via ${pc.bold(result.data.provider)}.${fieldsHint}`;
+        }, result.meta);
+    }
+    catch (err) {
+        deps.exit(renderError(deps, ctx, err));
+    }
+}
+export async function runUpsertAllContacts(deps, ctx, opts) {
+    try {
+        if (!opts.email)
+            throw new Error('Missing --email flag.');
+        const cfg = await deps.loadConfig();
+        if (!cfg)
+            throw new ConfigMissingError();
+        const apiBase = ctx.apiBaseOverride ?? cfg.api_base;
+        const client = deps.createApiClient({ apiBase, apiKey: cfg.api_key });
+        const providers = await resolveTargetProviders(client, opts);
+        if (opts.idempotencyKey && providers.length > 1) {
+            throw new Error('--idempotency-key cannot be reused across multiple providers. Omit it or pass a single --provider/--providers value.');
+        }
+        const properties = parseProperties(opts.properties);
+        const detail = parseDetail(opts.detail);
+        const results = [];
+        for (const provider of providers) {
+            const result = await upsertContactWithResult(client, {
+                provider,
+                email: opts.email,
+                first_name: opts.firstName,
+                last_name: opts.lastName,
+                phone: opts.phone === undefined ? undefined : String(opts.phone),
+                properties,
+                ...(detail ? { detail } : {}),
+                ...(opts.idempotencyKey ? { idempotencyKey: opts.idempotencyKey } : {}),
+            });
+            results.push({ ...result.data, ...(result.meta ? { meta: result.meta } : {}) });
+        }
+        renderSuccess(deps, ctx, { email: opts.email, results }, () => renderUpsertAllContacts(opts.email ?? '', results));
     }
     catch (err) {
         deps.exit(renderError(deps, ctx, err));
@@ -93,21 +115,24 @@ export async function runGetContact(deps, ctx, opts) {
 }
 export function registerContactCommands(cli, deps, ctx) {
     cli
-        .command('contact <action>', 'Contact operations: upsert, get')
+        .command('contact <action>', 'Contact operations: upsert, upsert-all, get')
         .option('--email <email>', 'Contact email (required for upsert and get)')
         .option('--first-name <name>', 'First name')
         .option('--last-name <name>', 'Last name')
         .option('--phone <phone>', 'Phone number')
         .option('--properties <json>', 'Custom properties as JSON, e.g. \'{"plan":"gold","tier":"silver"}\'')
         .option('--provider <name>', 'Provider override (defaults to auto-detect)')
+        .option('--providers <list>', 'Comma-separated providers for upsert-all')
         .option('--detail <level>', 'Response detail: minimal, standard, full')
         .option('--idempotency-key <key>', 'Override the auto-generated idempotency key')
         .action(async (action, opts) => {
         if (action === 'upsert')
             return runUpsertContact(deps, ctx, opts);
+        if (action === 'upsert-all')
+            return runUpsertAllContacts(deps, ctx, opts);
         if (action === 'get')
             return runGetContact(deps, ctx, opts);
-        deps.stderr.write(`${pc.red('error')} Unknown contact action: ${action}. Try: upsert, get\n`);
+        deps.stderr.write(`${pc.red('error')} Unknown contact action: ${action}. Try: upsert, upsert-all, get\n`);
         deps.exit(1);
     });
 }
@@ -117,4 +142,58 @@ function contactIdFromResult(contact) {
     const contactId = contact.contact_id;
     return typeof contactId === 'string' ? contactId : null;
 }
+function parseProperties(raw) {
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error('--properties must be a JSON object.');
+        }
+        return parsed;
+    }
+    catch (parseErr) {
+        const msg = parseErr instanceof Error ? parseErr.message : String(parseErr);
+        throw new Error(`--properties: ${msg}`);
+    }
+}
+async function upsertContactWithResult(client, input) {
+    if (client.upsertContactWithMeta)
+        return client.upsertContactWithMeta(input);
+    return { data: await client.upsertContact(input) };
+}
+async function resolveTargetProviders(client, opts) {
+    const listed = parseProviderList(opts.providers);
+    if (listed.length > 0)
+        return listed;
+    if (opts.provider)
+        return [opts.provider];
+    const providers = [...new Set((await client.listConnections()).map((conn) => conn.provider))];
+    if (providers.length === 0) {
+        throw new Error('No connections found. Run `vorlek connect <provider> --api-key ...` first.');
+    }
+    return providers;
+}
+function parseProviderList(raw) {
+    if (!raw)
+        return [];
+    const providers = raw
+        .split(',')
+        .map((provider) => provider.trim())
+        .filter((provider) => provider.length > 0);
+    if (providers.length === 0)
+        throw new Error('--providers must include at least one provider.');
+    return [...new Set(providers)];
+}
+function renderUpsertAllContacts(email, results) {
+    const lines = results.map((result) => {
+        const { meta } = result;
+        const receipt = meta?.request_id ? ` ${pc.dim(`request_id: ${meta.request_id}`)}` : '';
+        return `  ${pc.green('✓')} ${result.provider}: ${result.contact_id} (${result.action})${receipt}`;
+    });
+    return [
+        `${pc.green('✓')} Upserted ${pc.bold(email)} across ${results.length} provider${results.length === 1 ? '' : 's'}.`,
+        ...lines,
+    ].join('\n');
+}
 //# sourceMappingURL=contact.js.map

package/dist/commands/status.js

@@ -46,6 +46,9 @@ export function registerStatusCommand(cli, deps, ctx) {
                         const fresh = checksByProvider.get(c.provider);
                         const checkText = fresh ? `, checked: ${fresh.status}` : '';
                         lines.push(`  ${pc.green('●')} ${c.provider} (${c.status}${checkText})${name}`);
+                        if (fresh?.error) {
+                            lines.push(`    ${pc.yellow(fresh.error.code)}: ${fresh.error.message}`);
+                        }
                     }
                 }
                 lines.push('');

package/dist/run-context.js

@@ -4,6 +4,8 @@ import { ApiError } from './client.js';
 export function renderSuccess(deps, ctx, data, human, meta) {
     if (ctx.json) {
         const out = { status: 'success', data };
+        if (meta)
+            out.meta = meta;
         if (meta?.request_id)
             out.request_id = meta.request_id;
         deps.stdout.write(`${JSON.stringify(out)}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vorlek/cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Vorlek CLI — thin REST API wrapper for the Vorlek aggregator",
   "license": "UNLICENSED",
   "homepage": "https://vorlek.dev/docs/",