@dataworks-technology/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dataworks Technology Ltd
+
+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,179 @@
+ 
+
+<div align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset=".github/.assets/dataworks-light.svg">
+    <source media="(prefers-color-scheme: light)" srcset=".github/.assets/dataworks-dark.svg">
+    <img alt="Dataworks Logo" src=".github/.assets/dataworks-dark.svg" width="200">
+  </picture>
+</div>
+
+# Dataworks — CLI
+
+> The official command-line interface for the Dataworks sports data platform. Authenticate with Dataworks, operate the public Data Engine API, ingest metrics, and consume real-time events from a terminal or automation workflow.
+
+---
+
+## Overview
+
+The `dw` binary turns the public GraphQL contract published by `@dataworks-technology/data` into discoverable, typed commands. It provides human-readable output for interactive use and stable JSON or NDJSON output for scripts and agents.
+
+### Command Surface
+
+| Command               | Description                                                 |
+| --------------------- | ----------------------------------------------------------- |
+| `dw auth ...`         | Log in, log out, and inspect the active UAT or Live session |
+| `dw data ...`         | Run schema-derived queries, mutations, and subscriptions    |
+| `dw ingest`           | Send athlete metrics to the Data Engine ingest endpoint     |
+| `dw events subscribe` | Subscribe to AppSync Events channels                        |
+| `dw graphql ...`      | Run raw GraphQL queries, mutations, and subscriptions       |
+| `dw report-error`     | Report a datasource error                                   |
+| `dw tenant select`    | Select the tenant used by subsequent commands               |
+| `dw commands`         | Print the complete machine-readable command inventory       |
+
+---
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) 22 or newer to run the published CLI
+- A Dataworks account and Cognito client ID for the target environment
+- [Bun](https://bun.sh/) for repository development
+
+---
+
+## Getting Started
+
+1. **Install the CLI:**
+
+   ```sh
+   npm install --global @dataworks-technology/cli
+   dw --help
+   ```
+
+2. **Authenticate:**
+
+   ```sh
+   export DW_UAT_CLIENT_ID=<uat-cognito-client-id>
+   dw auth login --environment uat
+   dw auth status --json
+   ```
+
+   The CLI opens Dataworks Managed Login in your browser and never receives your password. Sessions are stored in the operating-system credential store, never in the Dataworks config file. If a browser cannot be opened automatically, pass `--no-browser` and visit the displayed URL on the same computer. Headless jobs can provide a protected `DW_SESSION_JSON` secret instead.
+
+3. **Select a tenant.** Run the command without an ID to choose interactively, or
+   pass an ID for noninteractive use. The selection is saved to your local profile.
+
+   ```bash
+   dw tenant select
+   dw tenant select tenant-123
+   ```
+
+   Use `dw tenant select --json` to list the available tenant IDs and friendly
+   names without opening an interactive prompt.
+
+4. **Discover and run commands:**
+
+   ```sh
+   dw commands --json
+   dw data athlete list --json
+   dw data athlete create --name "Ada" --date-of-birth 1992-01-01
+   ```
+
+Generated command documentation is available in [`docs/commands`](./docs/commands/README.md).
+
+---
+
+## Output and Safety
+
+- Commands that emit finite data support `--json` and return a stable `{data,meta}` envelope.
+- Subscriptions and other streams emit newline-delimited JSON (NDJSON).
+- Generated mutations support `--dry-run --json` to render a request without sending it.
+- Destructive mutations and all Live mutations require confirmation; non-interactive callers must pass `--yes`.
+- Passwords, tokens, authorization headers, secrets, and API keys are redacted from structured output.
+- Missing-argument errors list the required GraphQL types and representative values, then provide a safe copy-paste example and an exact `--help` command; `--json` includes the same guidance as structured details.
+
+```sh
+# Preview a mutation without sending it
+dw data athlete update --public-id athlete-123 --name "Ada L." --dry-run --json
+
+# Explicitly confirm a destructive mutation
+dw data athlete delete --public-id athlete-123 --yes
+
+# Use raw GraphQL when no friendly command fits
+dw graphql query --document @query.graphql --variables @variables.json --json
+```
+
+---
+
+## Common Commands
+
+| Command                         | Description                                                         |
+| ------------------------------- | ------------------------------------------------------------------- |
+| `bun install --frozen-lockfile` | Install development dependencies                                    |
+| `bun run dev --help`            | Run the TypeScript development CLI                                  |
+| `bun run generate`              | Regenerate schema-derived commands and Markdown                     |
+| `bun run generate:check`        | Verify generated files are current                                  |
+| `bun run test`                  | Run the Vitest unit tests                                           |
+| `bun run lint`                  | Run the TypeScript checks                                           |
+| `bun run format`                | Format files with Prettier                                          |
+| `bun run build`                 | Generate commands, compile for Node, and build the oclif manifest   |
+| `make verify`                   | Run generation, formatting, typing, tests, and the production build |
+
+---
+
+## SDK and Command Generation
+
+The Data Engine SDK publishes a filtered public GraphQL schema and a versioned contract containing its SDK version, operation counts, and schema hash. This repository pins that SDK version, validates the contract, and generates one oclif command and Markdown page for every public operation.
+
+Files under `src/generated/`, `src/commands/data/`, and `docs/commands/` are generated. Change [`schema/operation-overrides.json`](./schema/operation-overrides.json), [`scripts/generate-commands.ts`](./scripts/generate-commands.ts), or the upstream public schema instead of editing generated files.
+
+The daily SDK maintenance workflow checks npm for a new `@dataworks-technology/data` version. Deterministic generation runs first; if compatibility work is required, a constrained LiteLLM maintenance agent prepares a draft pull request for human review.
+
+See [architecture](./docs/architecture.md), [automated SDK maintenance](./docs/maintenance.md), [security](./docs/security.md), and [releasing](./docs/releasing.md) for details.
+
+---
+
+## CI/CD
+
+| Trigger                           | Workflow       | Description                                                                                                                 |
+| --------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| Pull request or push to `main`    | `ci.yml`       | Verifies generation, formatting, types, tests, builds, and packaging on the labelled self-hosted runner with Node 22 and 24 |
+| Daily schedule or manual dispatch | `sdk-sync.yml` | Updates the Data SDK and opens or refreshes a draft maintenance PR                                                          |
+| Manual dispatch                   | `uat-e2e.yml`  | Authenticates against UAT and reads the public Data manifest                                                                |
+| Push to `main`                    | `release.yml`  | Runs release-please on the self-hosted runner, then publishes with npm provenance from the required GitHub-hosted runner    |
+
+Automated SDK update pull requests remain drafts until a human reviews and marks them ready.
+
+---
+
+## Code Style
+
+- **Bun** for dependency management and repository scripts
+- **Node.js 22+** compatibility for the published CLI
+- **Prettier** for formatting
+- **Vitest** for unit tests
+- **Conventional commits** enforced by commitlint (`feat:`, `fix:`, `chore:`, `refactor:`, `test:`, `docs:`)
+- Explicit risk classification for every generated GraphQL mutation
+
+---
+
+## Cross-Repo Dependencies
+
+- Depends on **Dataworks-Data** for the public GraphQL schema and `@dataworks-technology/data` package
+- Uses the same public contract that generates the Data SDK Docusaurus reference
+- Authenticates against the UAT or Live Cognito and Data Engine endpoints at runtime
+- New SDK versions are consumed through reviewed automated pull requests rather than manual schema copying
+
+---
+
+## Contributors
+
+- [James Haigh](https://github.com/jameshaigh54)
+- [Felix Alonso Rodriguez](https://github.com/felixalonso)
+- [Paul Gardner](https://github.com/phpMagpie)
+- [Chris Moore](https://github.com/cwiggo)
+- [Martina Brillante](https://github.com/martina-WAS)
+
+## License
+
+MIT

package/bin/dev.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { execute } from "@oclif/core";
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { execute } from "@oclif/core";
+
+await execute({ dir: import.meta.url });

package/dist/commands/auth/login.d.ts

@@ -0,0 +1,16 @@
+import { DataworksCommand } from "../../lib/command.js";
+export default class AuthLogin extends DataworksCommand {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        "client-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "no-browser": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=login.d.ts.map

package/dist/commands/auth/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/login.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAUxD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,gBAAgB;IACrD,OAAgB,WAAW,SAA2D;IACtF,OAAgB,QAAQ;;;QAStB;IACF,OAAgB,KAAK;;;;;MAUnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiClC"}

package/dist/commands/auth/login.js

@@ -0,0 +1,63 @@
+import { Flags } from "@oclif/core";
+import { DataworksCommand } from "../../lib/command.js";
+import { loginWithBrowser } from "../../lib/browser-auth.js";
+import { saveSession } from "../../lib/credential-store.js";
+import { isEnvironment, resolveEnvironment } from "../../lib/environment.js";
+import { prompt } from "../../lib/prompts.js";
+import { readConfig, writeConfig } from "../../lib/config-store.js";
+import { CliError } from "../../lib/errors.js";
+import { writeResult } from "../../lib/output.js";
+import { applyProfileTenant } from "../../lib/session.js";
+export default class AuthLogin extends DataworksCommand {
+    static description = "Authenticate with Dataworks and store a token session";
+    static examples = [
+        {
+            description: "Open UAT login in the default browser",
+            command: "dw auth login --environment uat",
+        },
+        {
+            description: "Print the login URL when a browser cannot be opened automatically",
+            command: "dw auth login --environment uat --no-browser",
+        },
+    ];
+    static flags = {
+        "client-id": Flags.string({ description: "Cognito client ID override" }),
+        environment: Flags.string({
+            options: ["uat", "live"],
+            description: "Dataworks environment",
+        }),
+        json: Flags.boolean({ description: "Emit stable JSON output" }),
+        "no-browser": Flags.boolean({
+            description: "Print the login URL instead of opening a browser",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AuthLogin);
+        let environment = flags.environment;
+        if (!environment && process.stdin.isTTY)
+            environment = await prompt("Environment (uat/live)");
+        if (!environment || !isEnvironment(environment)) {
+            throw new CliError("Specify --environment uat|live", "ENVIRONMENT_REQUIRED", 2);
+        }
+        const config = resolveEnvironment(environment, flags["client-id"]);
+        const session = await loginWithBrowser(config, {
+            noBrowser: flags["no-browser"],
+            onAuthorizationUrl: (url, browserRequested) => {
+                process.stderr.write(browserRequested
+                    ? `Opening Dataworks login in your browser. If it does not open, visit:\n${url}\n`
+                    : `Open this URL in a browser on this computer:\n${url}\n`);
+            },
+        });
+        await saveSession(session);
+        const existingConfig = await readConfig();
+        const tenant = applyProfileTenant(session, existingConfig).tenant;
+        await writeConfig({
+            environment,
+            username: session.username,
+            clientId: flags["client-id"],
+            tenant: tenant ?? undefined,
+        });
+        writeResult({ authenticated: true, tenant, expiresAt: session.expiresAt }, { json: flags.json, meta: { environment } });
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/auth/login.js.map

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

package/dist/commands/auth/logout.d.ts

@@ -0,0 +1,9 @@
+import { DataworksCommand } from "../../lib/command.js";
+export default class AuthLogout extends DataworksCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=logout.d.ts.map

package/dist/commands/auth/logout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/logout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKxD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,gBAAgB;IACtD,OAAgB,WAAW,SAAyC;IACpE,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAMlC"}

package/dist/commands/auth/logout.js

@@ -0,0 +1,18 @@
+import { Flags } from "@oclif/core";
+import { DataworksCommand } from "../../lib/command.js";
+import { deleteConfig } from "../../lib/config-store.js";
+import { clearSession } from "../../lib/credential-store.js";
+import { writeResult } from "../../lib/output.js";
+export default class AuthLogout extends DataworksCommand {
+    static description = "Remove the active Dataworks session";
+    static flags = {
+        json: Flags.boolean({ description: "Emit stable JSON output" }),
+    };
+    async run() {
+        const { flags } = await this.parse(AuthLogout);
+        await clearSession();
+        await deleteConfig();
+        writeResult({ authenticated: false }, { json: flags.json });
+    }
+}
+//# sourceMappingURL=logout.js.map

package/dist/commands/auth/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../../src/commands/auth/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,gBAAgB;IACtD,MAAM,CAAU,WAAW,GAAG,qCAAqC,CAAC;IACpE,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,YAAY,EAAE,CAAC;QACrB,MAAM,YAAY,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC"}

package/dist/commands/auth/status.d.ts

@@ -0,0 +1,9 @@
+import { DataworksCommand } from "../../lib/command.js";
+export default class AuthStatus extends DataworksCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/auth/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,gBAAgB;IACtD,OAAgB,WAAW,SAAuC;IAClE,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBlC"}

package/dist/commands/auth/status.js

@@ -0,0 +1,30 @@
+import { Flags } from "@oclif/core";
+import { DataworksCommand } from "../../lib/command.js";
+import { readConfig } from "../../lib/config-store.js";
+import { loadSession } from "../../lib/credential-store.js";
+import { writeResult } from "../../lib/output.js";
+import { applyProfileTenant } from "../../lib/session.js";
+export default class AuthStatus extends DataworksCommand {
+    static description = "Show the active Dataworks session";
+    static flags = {
+        json: Flags.boolean({ description: "Emit stable JSON output" }),
+    };
+    async run() {
+        const { flags } = await this.parse(AuthStatus);
+        const storedSession = await loadSession();
+        const session = storedSession
+            ? applyProfileTenant(storedSession, await readConfig())
+            : null;
+        writeResult(session
+            ? {
+                authenticated: true,
+                environment: session.environment,
+                username: session.username,
+                tenant: session.tenant,
+                expiresAt: session.expiresAt,
+                expired: session.expiresAt <= Date.now(),
+            }
+            : { authenticated: false }, { json: flags.json });
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/auth/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/auth/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,gBAAgB;IACtD,MAAM,CAAU,WAAW,GAAG,mCAAmC,CAAC;IAClE,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,aAAa,GAAG,MAAM,WAAW,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,aAAa;YAC3B,CAAC,CAAC,kBAAkB,CAAC,aAAa,EAAE,MAAM,UAAU,EAAE,CAAC;YACvD,CAAC,CAAC,IAAI,CAAC;QACT,WAAW,CACT,OAAO;YACL,CAAC,CAAC;gBACE,aAAa,EAAE,IAAI;gBACnB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;aACzC;YACH,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,EAC5B,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CACrB,CAAC;IACJ,CAAC"}

package/dist/commands/commands.d.ts

@@ -0,0 +1,9 @@
+import { DataworksCommand } from "../lib/command.js";
+export default class Commands extends DataworksCommand {
+    static description: string;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAkBrD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,gBAAgB;IACpD,OAAgB,WAAW,SACgC;IAC3D,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBlC"}

package/dist/commands/commands.js

@@ -0,0 +1,41 @@
+import { Flags } from "@oclif/core";
+import { DataworksCommand } from "../lib/command.js";
+import { operations } from "../generated/operations.js";
+import { writeResult } from "../lib/output.js";
+const builtIns = [
+    "auth login",
+    "auth logout",
+    "auth status",
+    "commands",
+    "events subscribe",
+    "graphql mutate",
+    "graphql query",
+    "graphql subscribe",
+    "ingest",
+    "report-error",
+    "tenant select",
+];
+export default class Commands extends DataworksCommand {
+    static description = "List the stable command contract for humans and agents";
+    static flags = {
+        json: Flags.boolean({ description: "Emit stable JSON output" }),
+    };
+    async run() {
+        const { flags } = await this.parse(Commands);
+        const data = {
+            builtIns: builtIns.map((command) => ({ command: `dw ${command}` })),
+            generated: operations.map((operation) => ({
+                command: `dw ${operation.command}`,
+                operation: operation.name,
+                kind: operation.kind,
+                risk: operation.risk,
+                arguments: operation.arguments,
+            })),
+        };
+        writeResult(data, {
+            json: flags.json,
+            meta: { generatedCount: operations.length },
+        });
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,QAAQ,GAAG;IACf,YAAY;IACZ,aAAa;IACb,aAAa;IACb,UAAU;IACV,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,QAAQ;IACR,cAAc;IACd,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,gBAAgB;IACpD,MAAM,CAAU,WAAW,GACzB,wDAAwD,CAAC;IAC3D,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,EAAE,CAAC,CAAC;YACnE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClC,SAAS,EAAE,SAAS,CAAC,IAAI;gBACzB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,SAAS,EAAE,SAAS,CAAC,SAAS;aAC/B,CAAC,CAAC;SACJ,CAAC;QACF,WAAW,CAAC,IAAI,EAAE;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,EAAE,cAAc,EAAE,UAAU,CAAC,MAAM,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/data/adaptor/start.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/data/adaptor/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor/start.ts"],"names":[],"mappings":";AAGA,wBAAsD"}

package/dist/commands/data/adaptor/start.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("startAdaptor");
+//# sourceMappingURL=start.js.map

package/dist/commands/data/adaptor/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor/start.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,cAAc,CAAC,CAAC"}

package/dist/commands/data/adaptor/stop.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=stop.d.ts.map

package/dist/commands/data/adaptor/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor/stop.ts"],"names":[],"mappings":";AAGA,wBAAqD"}

package/dist/commands/data/adaptor/stop.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("stopAdaptor");
+//# sourceMappingURL=stop.js.map

package/dist/commands/data/adaptor/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor/stop.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,aAAa,CAAC,CAAC"}

package/dist/commands/data/adaptor-log-event/publish.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=publish.d.ts.map

package/dist/commands/data/adaptor-log-event/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-log-event/publish.ts"],"names":[],"mappings":";AAGA,wBAAgE"}

package/dist/commands/data/adaptor-log-event/publish.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("publishAdaptorLogEvent");
+//# sourceMappingURL=publish.js.map

package/dist/commands/data/adaptor-log-event/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-log-event/publish.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/commands/data/adaptor-log-event/watch-no-session.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=watch-no-session.d.ts.map

package/dist/commands/data/adaptor-log-event/watch-no-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-no-session.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-log-event/watch-no-session.ts"],"names":[],"mappings":";AAGA,wBAAoE"}

package/dist/commands/data/adaptor-log-event/watch-no-session.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("onAdaptorLogEventNoSession");
+//# sourceMappingURL=watch-no-session.js.map

package/dist/commands/data/adaptor-log-event/watch-no-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-no-session.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-log-event/watch-no-session.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/commands/data/adaptor-log-event/watch.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/data/adaptor-log-event/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-log-event/watch.ts"],"names":[],"mappings":";AAGA,wBAA2D"}

package/dist/commands/data/adaptor-log-event/watch.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("onAdaptorLogEvent");
+//# sourceMappingURL=watch.js.map

package/dist/commands/data/adaptor-log-event/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-log-event/watch.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/commands/data/adaptor-status/get.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=get.d.ts.map

package/dist/commands/data/adaptor-status/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status/get.ts"],"names":[],"mappings":";AAGA,wBAA0D"}

package/dist/commands/data/adaptor-status/get.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("getAdaptorStatus");
+//# sourceMappingURL=get.js.map

package/dist/commands/data/adaptor-status/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status/get.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/commands/data/adaptor-status/watch-all.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=watch-all.d.ts.map

package/dist/commands/data/adaptor-status/watch-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-all.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status/watch-all.ts"],"names":[],"mappings":";AAGA,wBAAkE"}

package/dist/commands/data/adaptor-status/watch-all.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("onAdaptorStatusChangeAll");
+//# sourceMappingURL=watch-all.js.map

package/dist/commands/data/adaptor-status/watch-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-all.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status/watch-all.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,0BAA0B,CAAC,CAAC"}

package/dist/commands/data/adaptor-status-change/publish.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=publish.d.ts.map

package/dist/commands/data/adaptor-status-change/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status-change/publish.ts"],"names":[],"mappings":";AAGA,wBAAoE"}

package/dist/commands/data/adaptor-status-change/publish.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("publishAdaptorStatusChange");
+//# sourceMappingURL=publish.js.map

package/dist/commands/data/adaptor-status-change/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status-change/publish.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,eAAe,sBAAsB,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/commands/data/adaptor-status-change/watch.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof import("../../../lib/command.js").DataworksCommand;
+export default _default;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/data/adaptor-status-change/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../../src/commands/data/adaptor-status-change/watch.ts"],"names":[],"mappings":";AAGA,wBAA+D"}

package/dist/commands/data/adaptor-status-change/watch.js

@@ -0,0 +1,4 @@
+// Generated by scripts/generate-commands.ts. Do not edit.
+import { createOperationCommand } from "../../../lib/operation-command.js";
+export default createOperationCommand("onAdaptorStatusChange");
+//# sourceMappingURL=watch.js.map