@iterable/cli 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Iterable, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,194 @@
+# Iterable CLI
+
+[![npm version](https://img.shields.io/npm/v/@iterable/cli.svg)](https://www.npmjs.com/package/@iterable/cli)
+
+> **Note:** This is an open-source developer tool, not an officially supported Iterable product. It is provided "as is" under the MIT License with no warranty or support guarantees.
+
+A command-line interface for the [Iterable API](https://api.iterable.com/api/docs). Manage campaigns, templates, users, lists, and more from your terminal.
+
+## Installation
+
+**Prerequisites:**
+- Node.js >= 20 (v22 LTS recommended)
+- An Iterable API key
+
+```bash
+npm install -g @iterable/cli
+```
+
+Or run directly with npx:
+
+```bash
+npx @iterable/cli campaigns list
+```
+
+## Quick Start
+
+Add your API key (stored securely in your system keychain):
+
+```bash
+iterable keys add
+```
+
+Then start using the CLI:
+
+```bash
+iterable campaigns list
+```
+
+For CI/scripting environments, you can also use an environment variable:
+
+```bash
+export ITERABLE_API_KEY=your_api_key_here
+```
+
+## Usage
+
+```bash
+iterable <category> <command> [options]
+```
+
+### Examples
+
+```bash
+# List campaigns
+iterable campaigns list
+
+# Get a specific campaign
+iterable campaigns get 123
+
+# List campaigns sorted by creation date
+iterable campaigns list --sort createdAt --order desc
+
+# Get a user (auto-detects email vs userId)
+iterable users get user@example.com
+iterable users get some-user-id
+
+# Create a list
+iterable lists create --name "My List"
+
+# Pass complex parameters as JSON
+iterable campaigns create-blast --json '{"name":"My Campaign","templateId":123,"listIds":[1,2,3]}'
+
+# Pipe JSON from stdin
+echo '{"page":1,"pageSize":5}' | iterable campaigns list --json -
+
+# Output as a table
+iterable campaigns list --output table
+
+# Output as colorized JSON
+iterable campaigns list --output pretty
+```
+
+### Positional Arguments
+
+Commands that take a single identifier support positional arguments:
+
+```bash
+iterable campaigns get 123            # equivalent to --id 123
+iterable campaigns abort 456          # equivalent to --campaignId 456
+iterable users get-by-email user@example.com  # equivalent to --email user@example.com
+iterable snippets get my-snippet      # equivalent to --identifier my-snippet
+```
+
+### Smart Aliases
+
+Some categories have convenience aliases that auto-detect the identifier type:
+
+```bash
+iterable users get user@example.com   # routes to get-by-email
+iterable users get some-user-id       # routes to get-by-userid
+iterable users delete user@example.com  # routes to delete-by-email
+```
+
+## Available Commands
+
+See the [full command reference](COMMANDS.md) for all 109 commands with parameter details.
+
+**Categories:** campaigns, catalogs, events, experiments, export, journeys, lists, messaging, snippets, subscriptions, templates, users, webhooks
+
+## Global Options
+
+| Option | Description |
+|--------|-------------|
+| `--help, -h` | Show help |
+| `--version, -V` | Show version |
+| `--output <format>` | Output format: `json`, `pretty`, `table` |
+| `--columns <cols>` | Comma-separated columns for table output |
+| `--json <data>` | Pass raw JSON (use `-` for stdin) |
+
+## Output Formats
+
+- **`json`** (default when piped): Raw JSON
+- **`pretty`** (default in terminal): Colorized JSON with syntax highlighting
+- **`table`**: Tabular format with auto-detected data shape
+
+### Table output
+
+Table mode auto-detects the data shape:
+- List responses (e.g., `{campaigns: [...]}`) render as a table with one row per item
+- Single objects render as a key-value table
+
+Use `--columns` to select which columns to display:
+
+```bash
+iterable campaigns list --output table --columns id,name,campaignState
+```
+
+Without `--columns`, all fields are shown.
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ITERABLE_API_KEY` | Your Iterable API key | (required) |
+| `ITERABLE_BASE_URL` | API base URL | `https://api.iterable.com` |
+
+### Key Management
+
+The CLI supports storing multiple API keys securely:
+
+```bash
+iterable keys add                   # Add a new key interactively
+iterable keys list                  # List stored keys
+iterable keys activate <name>       # Switch active key
+iterable keys deactivate            # Deactivate current key
+iterable keys update <name>         # Update an existing key
+iterable keys delete <name>         # Remove a key
+```
+
+Keys are stored securely using:
+- **macOS**: Keychain
+- **Windows**: DPAPI encryption
+- **Linux**: File with restrictive permissions (`~/.iterable/keys.json`)
+
+## Development
+
+```bash
+git clone https://github.com/Iterable/cli.git
+cd cli
+pnpm install
+pnpm build
+```
+
+### Scripts
+
+| Command | Description |
+|---------|-------------|
+| `pnpm build` | Lint, compile, generate docs |
+| `pnpm check` | Typecheck and lint (no changes) |
+| `pnpm test` | Run all tests |
+| `pnpm test:unit` | Run unit tests |
+| `pnpm test:integration` | Run integration tests |
+| `pnpm test:e2e` | Run E2E tests |
+| `pnpm dev` | Run with hot reload |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.
+
+## License
+
+[MIT](LICENSE.md)

package/dist/commands/campaigns.d.ts

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

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

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

package/dist/commands/campaigns.js

@@ -0,0 +1,106 @@
+import { AbortCampaignParamsSchema, ActivateTriggeredCampaignParamsSchema, ArchiveCampaignsParamsSchema, CancelCampaignParamsSchema, CreateBlastCampaignParamsSchema, CreateTriggeredCampaignParamsSchema, DeactivateTriggeredCampaignParamsSchema, GetCampaignMetricsParamsSchema, GetCampaignParamsSchema, GetCampaignsParamsSchema, GetChildCampaignsParamsSchema, ScheduleCampaignParamsSchema, SendCampaignParamsSchema, TriggerCampaignParamsSchema, } from "@iterable/api";
+import { sortTransform } from "./transforms.js";
+import { defineCommand } from "./types.js";
+export const campaignCommands = [
+    defineCommand({
+        category: "campaigns",
+        name: "list",
+        description: "Retrieve campaigns",
+        clientMethod: "getCampaigns",
+        schema: GetCampaignsParamsSchema,
+        cliTransforms: { sort: sortTransform },
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "get",
+        description: "Get detailed information about a specific campaign",
+        clientMethod: "getCampaign",
+        schema: GetCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "get-metrics",
+        description: "Get campaign performance metrics",
+        clientMethod: "getCampaignMetrics",
+        schema: GetCampaignMetricsParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "create-blast",
+        description: "Create a new blast campaign from an existing template. The campaign is created without being scheduled. Use schedule to schedule it for delivery.",
+        clientMethod: "createBlastCampaign",
+        schema: CreateBlastCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "create-triggered",
+        description: "Create a new triggered campaign from an existing template. The campaign is created in Ready state and must be activated before it can send.",
+        clientMethod: "createTriggeredCampaign",
+        schema: CreateTriggeredCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "get-children",
+        description: "Get child campaigns generated by a recurring campaign",
+        clientMethod: "getChildCampaigns",
+        schema: GetChildCampaignsParamsSchema,
+        cliTransforms: { sort: sortTransform },
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "schedule",
+        description: "Schedule an existing campaign to be sent at a specific time",
+        clientMethod: "scheduleCampaign",
+        schema: ScheduleCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "abort",
+        description: "Abort a campaign that is currently running",
+        clientMethod: "abortCampaign",
+        schema: AbortCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "cancel",
+        description: "Cancel a scheduled or recurring campaign",
+        clientMethod: "cancelCampaign",
+        schema: CancelCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "activate",
+        description: "Activate a triggered campaign",
+        clientMethod: "activateTriggeredCampaign",
+        schema: ActivateTriggeredCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "deactivate",
+        description: "Deactivate a triggered campaign",
+        clientMethod: "deactivateTriggeredCampaign",
+        schema: DeactivateTriggeredCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "archive",
+        description: "Archive one or more campaigns. Scheduled/recurring campaigns will be cancelled, running campaigns will be aborted.",
+        clientMethod: "archiveCampaigns",
+        schema: ArchiveCampaignsParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "trigger",
+        description: "Trigger a campaign to send to specified lists",
+        clientMethod: "triggerCampaign",
+        schema: TriggerCampaignParamsSchema,
+    }),
+    defineCommand({
+        category: "campaigns",
+        name: "send",
+        description: "Send an existing scheduled campaign immediately",
+        clientMethod: "sendCampaign",
+        schema: SendCampaignParamsSchema,
+    }),
+];
+//# sourceMappingURL=campaigns.js.map

package/dist/commands/campaigns.js.map

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

package/dist/commands/catalogs.d.ts

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

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

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

package/dist/commands/catalogs.js

@@ -0,0 +1,99 @@
+import { BulkDeleteCatalogItemsParamsSchema, CreateCatalogParamsSchema, GetCatalogFieldMappingsParamsSchema, GetCatalogItemParamsSchema, GetCatalogItemsParamsSchema, GetCatalogsParamsSchema, PartialUpdateCatalogItemParamsSchema, ReplaceCatalogItemParamsSchema, UpdateCatalogFieldMappingsParamsSchema, UpdateCatalogItemParamsSchema, } from "@iterable/api";
+import { z } from "zod";
+import { defineCommand } from "./types.js";
+export const catalogCommands = [
+    defineCommand({
+        category: "catalogs",
+        name: "list",
+        description: "Get list of all catalogs with optional pagination",
+        clientMethod: "getCatalogs",
+        schema: GetCatalogsParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "get-items",
+        description: "Get items from a catalog with optional pagination and sorting",
+        clientMethod: "getCatalogItems",
+        schema: GetCatalogItemsParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "get-item",
+        description: "Get a specific catalog item by ID",
+        clientMethod: "getCatalogItem",
+        schema: GetCatalogItemParamsSchema,
+        execute: (client, params) => client.getCatalogItem(params.catalogName, params.itemId),
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "create",
+        description: "Create a new catalog",
+        clientMethod: "createCatalog",
+        schema: CreateCatalogParamsSchema,
+        execute: (client, params) => client.createCatalog(params.catalogName),
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "delete",
+        description: "Delete a catalog",
+        clientMethod: "deleteCatalog",
+        schema: z.object({
+            catalogName: z.string().describe("Name of the catalog to delete"),
+        }),
+        execute: (client, params) => client.deleteCatalog(params.catalogName),
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "get-field-mappings",
+        description: "Get field mappings and data types for a catalog",
+        clientMethod: "getCatalogFieldMappings",
+        schema: GetCatalogFieldMappingsParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "update-field-mappings",
+        description: "Update catalog field mappings (data types)",
+        clientMethod: "updateCatalogFieldMappings",
+        schema: UpdateCatalogFieldMappingsParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "update-items",
+        description: "Update catalog items",
+        clientMethod: "updateCatalogItems",
+        schema: UpdateCatalogItemParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "delete-item",
+        description: "Delete a specific catalog item by ID",
+        clientMethod: "deleteCatalogItem",
+        schema: z.object({
+            catalogName: z.string().describe("Name of the catalog"),
+            itemId: z.string().describe("ID of the catalog item to delete"),
+        }),
+        execute: (client, params) => client.deleteCatalogItem(params.catalogName, params.itemId),
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "bulk-delete-items",
+        description: "Bulk delete catalog items by their IDs",
+        clientMethod: "bulkDeleteCatalogItems",
+        schema: BulkDeleteCatalogItemsParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "partial-update-item",
+        description: "Partial update (PATCH) a catalog item - updates only specified fields",
+        clientMethod: "partialUpdateCatalogItem",
+        schema: PartialUpdateCatalogItemParamsSchema,
+    }),
+    defineCommand({
+        category: "catalogs",
+        name: "replace-item",
+        description: "Replace (PUT) a catalog item - replaces the entire item with new value",
+        clientMethod: "replaceCatalogItem",
+        schema: ReplaceCatalogItemParamsSchema,
+    }),
+];
+//# sourceMappingURL=catalogs.js.map

package/dist/commands/catalogs.js.map

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

package/dist/commands/events.d.ts

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

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

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

package/dist/commands/events.js

@@ -0,0 +1,33 @@
+import { GetUserEventsByEmailParamsSchema, GetUserEventsByUserIdParamsSchema, TrackBulkEventsParamsSchema, TrackEventParamsSchema, } from "@iterable/api";
+import { defineCommand } from "./types.js";
+export const eventCommands = [
+    defineCommand({
+        category: "events",
+        name: "track",
+        description: "Track a custom event for a user",
+        clientMethod: "trackEvent",
+        schema: TrackEventParamsSchema,
+    }),
+    defineCommand({
+        category: "events",
+        name: "track-bulk",
+        description: "Track multiple events in a single request for better performance",
+        clientMethod: "trackBulkEvents",
+        schema: TrackBulkEventsParamsSchema,
+    }),
+    defineCommand({
+        category: "events",
+        name: "get-by-email",
+        description: "Get event history for a user by email address",
+        clientMethod: "getUserEventsByEmail",
+        schema: GetUserEventsByEmailParamsSchema,
+    }),
+    defineCommand({
+        category: "events",
+        name: "get-by-userid",
+        description: "Get event history for a user by user ID",
+        clientMethod: "getUserEventsByUserId",
+        schema: GetUserEventsByUserIdParamsSchema,
+    }),
+];
+//# sourceMappingURL=events.js.map

package/dist/commands/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,iCAAiC;QAC9C,YAAY,EAAE,YAAY;QAC1B,MAAM,EAAE,sBAAsB;KAC/B,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,kEAAkE;QACpE,YAAY,EAAE,iBAAiB;QAC/B,MAAM,EAAE,2BAA2B;KACpC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,+CAA+C;QAC5D,YAAY,EAAE,sBAAsB;QACpC,MAAM,EAAE,gCAAgC;KACzC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yCAAyC;QACtD,YAAY,EAAE,uBAAuB;QACrC,MAAM,EAAE,iCAAiC;KAC1C,CAAC;CACH,CAAC"}

package/dist/commands/experiments.d.ts

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

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

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

package/dist/commands/experiments.js

@@ -0,0 +1,33 @@
+import { GetExperimentMetricsParamsSchema, GetExperimentParamsSchema, GetExperimentVariantsParamsSchema, ListExperimentsParamsSchema, } from "@iterable/api";
+import { defineCommand } from "./types.js";
+export const experimentCommands = [
+    defineCommand({
+        category: "experiments",
+        name: "list",
+        description: "List experiments with optional filtering by campaign, status, and date range",
+        clientMethod: "listExperiments",
+        schema: ListExperimentsParamsSchema,
+    }),
+    defineCommand({
+        category: "experiments",
+        name: "get",
+        description: "Get detailed information about a specific experiment by ID",
+        clientMethod: "getExperiment",
+        schema: GetExperimentParamsSchema,
+    }),
+    defineCommand({
+        category: "experiments",
+        name: "get-metrics",
+        description: "Get experiment metrics for A/B testing analysis",
+        clientMethod: "getExperimentMetrics",
+        schema: GetExperimentMetricsParamsSchema,
+    }),
+    defineCommand({
+        category: "experiments",
+        name: "get-variants",
+        description: "Get variant content for an experiment, including subject lines, preheaders, HTML source, and plain text",
+        clientMethod: "getExperimentVariants",
+        schema: GetExperimentVariantsParamsSchema,
+    }),
+];
+//# sourceMappingURL=experiments.js.map

package/dist/commands/experiments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../src/commands/experiments.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,yBAAyB,EACzB,iCAAiC,EACjC,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACrD,aAAa,CAAC;QACZ,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,8EAA8E;QAChF,YAAY,EAAE,iBAAiB;QAC/B,MAAM,EAAE,2BAA2B;KACpC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,4DAA4D;QACzE,YAAY,EAAE,eAAe;QAC7B,MAAM,EAAE,yBAAyB;KAClC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,iDAAiD;QAC9D,YAAY,EAAE,sBAAsB;QACpC,MAAM,EAAE,gCAAgC;KACzC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,yGAAyG;QAC3G,YAAY,EAAE,uBAAuB;QACrC,MAAM,EAAE,iCAAiC;KAC1C,CAAC;CACH,CAAC"}

package/dist/commands/export.d.ts

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

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

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

package/dist/commands/export.js

@@ -0,0 +1,33 @@
+import { CancelExportJobParamsSchema, GetExportFilesParamsSchema, GetExportJobsParamsSchema, StartExportJobParamsSchema, } from "@iterable/api";
+import { defineCommand } from "./types.js";
+export const exportCommands = [
+    defineCommand({
+        category: "export",
+        name: "list-jobs",
+        description: "Get a list of recent export jobs for the current project",
+        clientMethod: "getExportJobs",
+        schema: GetExportJobsParamsSchema,
+    }),
+    defineCommand({
+        category: "export",
+        name: "get-files",
+        description: "Get the job status and download URLs for files from a completed export job",
+        clientMethod: "getExportFiles",
+        schema: GetExportFilesParamsSchema,
+    }),
+    defineCommand({
+        category: "export",
+        name: "start",
+        description: "Start a data export job that processes as a background job. Use get-files to check status and obtain download links.",
+        clientMethod: "startExportJob",
+        schema: StartExportJobParamsSchema,
+    }),
+    defineCommand({
+        category: "export",
+        name: "cancel",
+        description: "Cancel a queued or running export job",
+        clientMethod: "cancelExportJob",
+        schema: CancelExportJobParamsSchema,
+    }),
+];
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,0DAA0D;QACvE,YAAY,EAAE,eAAe;QAC7B,MAAM,EAAE,yBAAyB;KAClC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,4EAA4E;QAC9E,YAAY,EAAE,gBAAgB;QAC9B,MAAM,EAAE,0BAA0B;KACnC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,OAAO;QACb,WAAW,EACT,sHAAsH;QACxH,YAAY,EAAE,gBAAgB;QAC9B,MAAM,EAAE,0BAA0B;KACnC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uCAAuC;QACpD,YAAY,EAAE,iBAAiB;QAC/B,MAAM,EAAE,2BAA2B;KACpC,CAAC;CACH,CAAC"}

package/dist/commands/journeys.d.ts

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

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

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

package/dist/commands/journeys.js

@@ -0,0 +1,21 @@
+import { GetJourneysParamsSchema, TriggerJourneyParamsSchema, } from "@iterable/api";
+import { sortTransform } from "./transforms.js";
+import { defineCommand } from "./types.js";
+export const journeyCommands = [
+    defineCommand({
+        category: "journeys",
+        name: "list",
+        description: "Get journeys (workflows) with optional pagination and state filtering",
+        clientMethod: "getJourneys",
+        schema: GetJourneysParamsSchema,
+        cliTransforms: { sort: sortTransform },
+    }),
+    defineCommand({
+        category: "journeys",
+        name: "trigger",
+        description: "Trigger a journey (workflow) for a user",
+        clientMethod: "triggerJourney",
+        schema: TriggerJourneyParamsSchema,
+    }),
+];
+//# sourceMappingURL=journeys.js.map

package/dist/commands/journeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journeys.js","sourceRoot":"","sources":["../../src/commands/journeys.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,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,EACT,uEAAuE;QACzE,YAAY,EAAE,aAAa;QAC3B,MAAM,EAAE,uBAAuB;QAC/B,aAAa,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KACvC,CAAC;IACF,aAAa,CAAC;QACZ,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yCAAyC;QACtD,YAAY,EAAE,gBAAgB;QAC9B,MAAM,EAAE,0BAA0B;KACnC,CAAC;CACH,CAAC"}

package/dist/commands/lists.d.ts

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

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

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