@iterable/cli 0.1.0

package/dist/commands/types.d.ts

@@ -0,0 +1,40 @@
+import type { IterableClient } from "@iterable/api";
+import { z } from "zod";
+export interface CliTransform {
+    cliFields: Record<string, z.ZodType>;
+    toParam: (values: Record<string, unknown>) => unknown;
+}
+export interface CommandDefinition {
+    category: string;
+    name: string;
+    description: string;
+    clientMethod?: keyof IterableClient & string;
+    schema: z.ZodType;
+    execute: (client: IterableClient, params: Record<string, unknown>) => Promise<unknown>;
+    positionalArgs?: string[];
+    cliTransforms?: Record<string, CliTransform>;
+    examples?: string[];
+    isAlias?: boolean;
+}
+export declare function defineCommand<K extends keyof IterableClient, TSchema extends z.ZodType>(def: {
+    category: string;
+    name: string;
+    description: string;
+    clientMethod: K & string;
+    schema: TSchema;
+    execute?: (client: IterableClient, params: z.infer<TSchema>) => Promise<unknown>;
+    positionalArgs?: (keyof z.infer<TSchema> & string)[];
+    cliTransforms?: Record<string, CliTransform>;
+    examples?: string[];
+}): CommandDefinition;
+export declare function defineAlias<TSchema extends z.ZodType>(def: {
+    category: string;
+    name: string;
+    description: string;
+    schema: TSchema;
+    execute: (client: IterableClient, params: z.infer<TSchema>) => Promise<unknown>;
+    positionalArgs?: (keyof z.infer<TSchema> & string)[];
+    cliTransforms?: Record<string, CliTransform>;
+    examples?: string[];
+}): CommandDefinition;
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CACvD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,cAAc,GAAG,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,OAAO,EAAE,CACP,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,aAAa,CAC3B,CAAC,SAAS,MAAM,cAAc,EAC9B,OAAO,SAAS,CAAC,CAAC,OAAO,EACzB,GAAG,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CACR,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,iBAAiB,CAYpB;AAED,wBAAgB,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,CACP,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,iBAAiB,CAKpB"}

package/dist/commands/types.js

@@ -0,0 +1,15 @@
+export function defineCommand(def) {
+    const userExecute = def.execute;
+    const execute = userExecute
+        ? (client, params) => userExecute(client, params)
+        : (client, params) => {
+            const method = client[def.clientMethod];
+            return method.call(client, params);
+        };
+    return { ...def, execute };
+}
+export function defineAlias(def) {
+    const execute = (client, params) => def.execute(client, params);
+    return { ...def, execute, isAlias: true };
+}
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,aAAa,CAG3B,GAaD;IACC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;IAChC,MAAM,OAAO,GAAiC,WAAW;QACvD,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,MAA0B,CAAC;QACrE,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YACjB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAEjB,CAAC;YACtB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC,CAAC;IAEN,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,CAA4B,GAYtD;IACC,MAAM,OAAO,GAAiC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAC/D,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAA0B,CAAC,CAAC;IAElD,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC"}

package/dist/commands/users.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from "./types.js";
+export declare const userCommands: CommandDefinition[];
+//# sourceMappingURL=users.d.ts.map

package/dist/commands/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/commands/users.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,eAAO,MAAM,YAAY,EAAE,iBAAiB,EAuG3C,CAAC"}

package/dist/commands/users.js

@@ -0,0 +1,103 @@
+import { BulkUpdateUsersParamsSchema, DeleteUserByEmailParamsSchema, DeleteUserByUserIdParamsSchema, GetSentMessagesParamsSchema, GetUserByEmailParamsSchema, GetUserByIdParamsSchema, UpdateEmailParamsSchema, UpdateUserParamsSchema, UpdateUserSubscriptionsParamsSchema, } from "@iterable/api";
+import { z } from "zod";
+import { defineAlias, defineCommand } from "./types.js";
+export const userCommands = [
+    defineAlias({
+        category: "users",
+        name: "get",
+        description: "Get a user by email or userId (auto-detected)",
+        schema: z.object({
+            identifier: z.string().describe("Email address or userId"),
+        }),
+        execute: (client, params) => params.identifier.includes("@")
+            ? client.getUserByEmail(params.identifier)
+            : client.getUserByUserId(params.identifier),
+    }),
+    defineCommand({
+        category: "users",
+        name: "get-by-email",
+        description: "Get user profile information by email address",
+        clientMethod: "getUserByEmail",
+        schema: GetUserByEmailParamsSchema,
+        execute: (client, params) => client.getUserByEmail(params.email),
+    }),
+    defineCommand({
+        category: "users",
+        name: "get-by-userid",
+        description: "Get user profile information by user ID",
+        clientMethod: "getUserByUserId",
+        schema: GetUserByIdParamsSchema,
+        execute: (client, params) => client.getUserByUserId(params.userId),
+    }),
+    defineCommand({
+        category: "users",
+        name: "update",
+        description: "Update user profile information (accepts email OR userId)",
+        clientMethod: "updateUser",
+        schema: UpdateUserParamsSchema,
+    }),
+    defineAlias({
+        category: "users",
+        name: "delete",
+        description: "Delete a user by email or userId (auto-detected)",
+        schema: z.object({
+            identifier: z.string().describe("Email address or userId"),
+        }),
+        execute: (client, params) => params.identifier.includes("@")
+            ? client.deleteUserByEmail(params.identifier)
+            : client.deleteUserByUserId(params.identifier),
+    }),
+    defineCommand({
+        category: "users",
+        name: "delete-by-email",
+        description: "Delete a user by email address (asynchronous)",
+        clientMethod: "deleteUserByEmail",
+        schema: DeleteUserByEmailParamsSchema,
+        execute: (client, params) => client.deleteUserByEmail(params.email),
+    }),
+    defineCommand({
+        category: "users",
+        name: "delete-by-userid",
+        description: "Delete a user by user ID (asynchronous, deletes all users with same userId)",
+        clientMethod: "deleteUserByUserId",
+        schema: DeleteUserByUserIdParamsSchema,
+        execute: (client, params) => client.deleteUserByUserId(params.userId),
+    }),
+    defineCommand({
+        category: "users",
+        name: "update-email",
+        description: "Update a user's email address (only for email-based projects)",
+        clientMethod: "updateEmail",
+        schema: UpdateEmailParamsSchema,
+    }),
+    defineCommand({
+        category: "users",
+        name: "update-subscriptions",
+        description: "Update user subscriptions (overwrites existing data for any non-null fields specified)",
+        clientMethod: "updateUserSubscriptions",
+        schema: UpdateUserSubscriptionsParamsSchema,
+    }),
+    defineCommand({
+        category: "users",
+        name: "bulk-update",
+        description: "Update multiple users at once",
+        clientMethod: "bulkUpdateUsers",
+        schema: BulkUpdateUsersParamsSchema,
+    }),
+    defineCommand({
+        category: "users",
+        name: "get-sent-messages",
+        description: "Get messages sent to a specific user with optional filtering",
+        clientMethod: "getSentMessages",
+        schema: GetSentMessagesParamsSchema,
+    }),
+    defineCommand({
+        category: "users",
+        name: "get-fields",
+        description: "Get all user profile field definitions and their types",
+        clientMethod: "getUserFields",
+        schema: z.object({}),
+        execute: (client) => client.getUserFields(),
+    }),
+];
+//# sourceMappingURL=users.js.map

package/dist/commands/users.js.map

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

package/dist/commands/webhooks.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from "./types.js";
+export declare const webhookCommands: CommandDefinition[];
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/commands/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/commands/webhooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAgB9C,CAAC"}

package/dist/commands/webhooks.js

@@ -0,0 +1,21 @@
+import { UpdateWebhookParamsSchema } from "@iterable/api";
+import { z } from "zod";
+import { defineCommand } from "./types.js";
+export const webhookCommands = [
+    defineCommand({
+        category: "webhooks",
+        name: "list",
+        description: "Get all webhooks for the project",
+        clientMethod: "getWebhooks",
+        schema: z.object({}),
+        execute: (client) => client.getWebhooks(),
+    }),
+    defineCommand({
+        category: "webhooks",
+        name: "update",
+        description: "Update a webhook configuration",
+        clientMethod: "updateWebhook",
+        schema: UpdateWebhookParamsSchema,
+    }),
+];
+//# sourceMappingURL=webhooks.js.map

package/dist/commands/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/commands/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAwB;IAClD,aAAa,CAAC;QACZ,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,kCAAkC;QAC/C,YAAY,EAAE,aAAa;QAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;KAC1C,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gCAAgC;QAC7C,YAAY,EAAE,eAAe;QAC7B,MAAM,EAAE,yBAAyB;KAClC,CAAC;CACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+export interface CliConfig {
+    readonly apiKey: string;
+    readonly baseUrl: string;
+}
+/**
+ * Load configuration.
+ *
+ * Resolution order:
+ * 1. ITERABLE_API_KEY env var (if set, use directly -- enables CI/scripting override)
+ * 2. Key manager active key
+ * 3. Error with guidance
+ */
+export declare function loadCliConfig(): Promise<CliConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CA2DxD"}

package/dist/config.js

@@ -0,0 +1,60 @@
+import { logger } from "@iterable/api";
+import { CliError } from "./errors.js";
+import { getKeyManager } from "./key-manager.js";
+import { isTestEnv } from "./utils/cli-env.js";
+import { COMMAND_NAME } from "./utils/command-info.js";
+import { sanitizeString } from "./utils/sanitize.js";
+/**
+ * Load configuration.
+ *
+ * Resolution order:
+ * 1. ITERABLE_API_KEY env var (if set, use directly -- enables CI/scripting override)
+ * 2. Key manager active key
+ * 3. Error with guidance
+ */
+export async function loadCliConfig() {
+    const baseUrlFromEnv = process.env.ITERABLE_BASE_URL ?? "https://api.iterable.com";
+    if (process.env.ITERABLE_API_KEY) {
+        return { apiKey: process.env.ITERABLE_API_KEY, baseUrl: baseUrlFromEnv };
+    }
+    if (!isTestEnv()) {
+        try {
+            const keyManager = getKeyManager();
+            await keyManager.initialize();
+            if (await keyManager.hasKeys()) {
+                if (!(await keyManager.hasActiveKey())) {
+                    throw new CliError(`No active API key. Run "${COMMAND_NAME} keys activate <name>" to activate one, or set ITERABLE_API_KEY environment variable.`, 2);
+                }
+                const apiKey = await keyManager.getActiveKey();
+                if (apiKey) {
+                    let baseUrl = baseUrlFromEnv;
+                    const meta = await keyManager.getActiveKeyMetadata();
+                    if (meta?.baseUrl) {
+                        baseUrl = meta.baseUrl;
+                    }
+                    return { apiKey, baseUrl };
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof CliError)
+                throw error;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if (errorMessage.includes("Key store not initialized") ||
+                errorMessage.includes("No API key found")) {
+                logger.debug("No keys in key manager, falling back to error");
+            }
+            else {
+                const sanitizedMessage = sanitizeString(errorMessage);
+                logger.error("Unexpected error loading from key manager", {
+                    error: sanitizedMessage,
+                });
+                console.error(
+                // eslint-disable-line no-console
+                "Warning: Failed to load API key from key storage:", sanitizedMessage);
+            }
+        }
+    }
+    throw new CliError(`No API key found. Run "${COMMAND_NAME} keys add" to add one, or set ITERABLE_API_KEY environment variable.`, 2);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,0BAA0B,CAAC;IAE9D,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;YACnC,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;YAE9B,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;oBACvC,MAAM,IAAI,QAAQ,CAChB,2BAA2B,YAAY,uFAAuF,EAC9H,CAAC,CACF,CAAC;gBACJ,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,CAAC;gBAC/C,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,OAAO,GAAG,cAAc,CAAC;oBAC7B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,oBAAoB,EAAE,CAAC;oBACrD,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC;wBAClB,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;oBACzB,CAAC;oBACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAE3C,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,IACE,YAAY,CAAC,QAAQ,CAAC,2BAA2B,CAAC;gBAClD,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EACzC,CAAC;gBACD,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,MAAM,gBAAgB,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;gBACtD,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE;oBACxD,KAAK,EAAE,gBAAgB;iBACxB,CAAC,CAAC;gBACH,OAAO,CAAC,KAAK;gBACX,iCAAiC;gBACjC,mDAAmD,EACnD,gBAAgB,CACjB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,0BAA0B,YAAY,sEAAsE,EAC5G,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}
+export declare class ValidationError extends CliError {
+    constructor(message: string);
+}
+export declare class UsageError extends CliError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,MAAU;CAKvC;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAW,SAAQ,QAAQ;gBAC1B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "CliError";
+    }
+}
+export class ValidationError extends CliError {
+    constructor(message) {
+        super(message, 2);
+        this.name = "ValidationError";
+    }
+}
+export class UsageError extends CliError {
+    constructor(message) {
+        super(message, 2);
+        this.name = "UsageError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IAFlB,YACE,OAAe,EACC,WAAmB,CAAC;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,aAAQ,GAAR,QAAQ,CAAY;QAGpC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+import { IterableClient } from "@iterable/api";
+import { z } from "zod";
+import { loadCliConfig } from "./config.js";
+import { CliError, UsageError } from "./errors.js";
+import { formatOutput, getDefaultFormat } from "./output.js";
+import { buildParser, parseCommand } from "./parser.js";
+import { findCommand, parseArgs, showCategoryHelp, showGlobalHelp, showVersion, } from "./router.js";
+import { COMMAND_NAME } from "./utils/command-info.js";
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (parsed.globalFlags.version) {
+        showVersion();
+        return;
+    }
+    if (!parsed.category || (parsed.globalFlags.help && !parsed.action)) {
+        if (parsed.category) {
+            showCategoryHelp(parsed.category);
+        }
+        else {
+            await showGlobalHelp();
+        }
+        return;
+    }
+    if (parsed.category === "keys") {
+        const { handleKeysCommand } = await import("./keys-cli.js");
+        await handleKeysCommand(parsed.action ? [parsed.action, ...parsed.rest] : []);
+        return;
+    }
+    if (!parsed.action) {
+        showCategoryHelp(parsed.category);
+        return;
+    }
+    const command = findCommand(parsed.category, parsed.action);
+    if (!command) {
+        throw new UsageError(`Unknown command: ${parsed.category} ${parsed.action}\nRun '${COMMAND_NAME} ${parsed.category} --help' to see available commands.`);
+    }
+    if (parsed.globalFlags.help) {
+        const built = buildParser(command.schema, `iterable ${parsed.category} ${parsed.action}`, command.positionalArgs, command.cliTransforms);
+        try {
+            built.showHelp();
+        }
+        catch {
+            // zod-opts calls process.exit on --help
+        }
+        return;
+    }
+    const config = await loadCliConfig();
+    const client = new IterableClient({
+        apiKey: config.apiKey,
+        baseUrl: config.baseUrl,
+    });
+    try {
+        const params = await parseCommand(command.schema, `iterable ${parsed.category} ${parsed.action}`, parsed.rest, command.positionalArgs, command.cliTransforms);
+        const result = await command.execute(client, params);
+        const format = parsed.globalFlags.output ?? getDefaultFormat();
+        console.log(formatOutput(result, format, parsed.globalFlags.columns)); // eslint-disable-line no-console
+    }
+    finally {
+        client.destroy();
+    }
+}
+main().catch(async (error) => {
+    const { IterableApiError, IterableNetworkError, IterableRawError, IterableResponseValidationError, } = await import("@iterable/api");
+    /* eslint-disable no-console */
+    if (error instanceof CliError) {
+        console.error(error.message);
+        process.exit(error.exitCode);
+    }
+    if (error instanceof z.ZodError) {
+        const details = error.issues
+            .map((i) => `${i.path.join(".")}: ${i.message}`)
+            .join(", ");
+        console.error(`Validation error: ${details}`);
+        process.exit(2);
+    }
+    if (error instanceof IterableApiError) {
+        console.error(`API error (${error.statusCode}): ${error.message}`);
+        if (error.endpoint)
+            console.error(`  Endpoint: ${error.endpoint}`);
+        if (error.statusCode === 401) {
+            console.error(`  Run '${COMMAND_NAME} keys add' to configure your API key`);
+        }
+        process.exit(1);
+    }
+    if (error instanceof IterableRawError) {
+        console.error(`API error (${error.statusCode}): ${error.message}`);
+        if (error.endpoint)
+            console.error(`  Endpoint: ${error.endpoint}`);
+        process.exit(1);
+    }
+    if (error instanceof IterableResponseValidationError) {
+        console.error(`Response validation error (${error.statusCode}): ${error.message}`);
+        if (error.endpoint)
+            console.error(`  Endpoint: ${error.endpoint}`);
+        process.exit(1);
+    }
+    if (error instanceof IterableNetworkError) {
+        console.error(`Network error: ${error.message}`);
+        process.exit(1);
+    }
+    /* eslint-enable no-console */
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${msg}`); // eslint-disable-line no-console
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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