@dataworks-technology/cli 1.0.0

package/dist/lib/http-transport.js

@@ -0,0 +1,140 @@
+import { resolveEndpoints, resolveEnvironment } from "./environment.js";
+import { CliError } from "./errors.js";
+import { requireSession } from "./session.js";
+export function validateMetric(metric) {
+    const value = metric;
+    if (typeof value.metric !== "string" || value.metric.trim() === "")
+        return "metric must be a non-empty string";
+    if (typeof value.athletePublicId !== "string" || value.athletePublicId.trim() === "")
+        return "athletePublicId must be a non-empty string";
+    if (!Number.isInteger(value.timestamp) || value.timestamp <= 0)
+        return "timestamp must be a positive integer";
+    if (value.value === null || typeof value.value === "undefined")
+        return "value is null/undefined";
+    if (typeof value.value === "number" && !Number.isFinite(value.value))
+        return "value must be finite";
+    if (!["number", "string"].includes(typeof value.value))
+        return "value must be a number or string";
+    if (value.value === "")
+        return "value is an empty string";
+    return null;
+}
+export async function ingestMetrics(metrics, eventPublicId, datasetDatasourcePublicId, bestEffort) {
+    const dropped = [];
+    const valid = metrics.filter((metric, index) => {
+        const reason = validateMetric(metric);
+        if (reason)
+            dropped.push({ index, metric, reason });
+        return !reason;
+    });
+    if (dropped.length && !bestEffort) {
+        throw new CliError("Metric validation failed; no request was sent", "METRIC_VALIDATION_FAILED", 2, dropped);
+    }
+    if (!valid.length) {
+        return {
+            acceptedCount: 0,
+            droppedCount: dropped.length,
+            dropped,
+            requestSent: false,
+        };
+    }
+    const session = await requireSession();
+    const environment = resolveEnvironment(session.environment, session.clientId);
+    const response = await fetch(environment.ingestUrl, {
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${session.accessToken}`,
+            "content-type": "application/json",
+        },
+        body: JSON.stringify({ eventPublicId, datasetDatasourcePublicId, metrics: valid }),
+    });
+    if (!response.ok) {
+        throw new CliError(`Ingest failed (${response.status})`, "INGEST_FAILED");
+    }
+    return {
+        acceptedCount: valid.length,
+        droppedCount: dropped.length,
+        dropped,
+        requestSent: true,
+    };
+}
+export async function reportError(payload) {
+    const session = await requireSession();
+    const environment = resolveEnvironment(session.environment, session.clientId);
+    const response = await fetch(environment.errorUrl, {
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${session.accessToken}`,
+            "content-type": "application/json",
+        },
+        body: JSON.stringify({
+            client_id: String(payload.clientId),
+            dataset_datasource_id: payload.datasetDatasourcePublicId,
+            athlete_id: payload.athletePublicId,
+            error_title: payload.errorTitle,
+            error_description: payload.errorDescription,
+        }),
+    });
+    if (!response.ok) {
+        throw new CliError(`Error report failed (${response.status})`, "ERROR_REPORT_FAILED");
+    }
+}
+function base64Url(value) {
+    return Buffer.from(value).toString("base64url");
+}
+export async function subscribeEvents(channel, onData, apiKey = process.env.DW_API_KEY) {
+    const session = apiKey ? null : await requireSession();
+    const environment = session
+        ? resolveEnvironment(session.environment, session.clientId)
+        : resolveEndpoints(process.env.DW_ENVIRONMENT === "live" ? "live" : "uat");
+    const httpUrl = new URL(environment.realtimeUrl);
+    const socketUrl = new URL(environment.realtimeUrl);
+    socketUrl.protocol = socketUrl.protocol === "https:" ? "wss:" : "ws:";
+    socketUrl.pathname = "/event/realtime";
+    if (socketUrl.host.includes(".appsync-api.")) {
+        socketUrl.host = socketUrl.host.replace(".appsync-api.", ".appsync-realtime-api.");
+    }
+    const auth = session
+        ? { Authorization: session.accessToken, host: httpUrl.host }
+        : { "x-api-key": apiKey, host: httpUrl.host };
+    const socket = new WebSocket(socketUrl, [
+        "aws-appsync-event-ws",
+        `header-${base64Url(JSON.stringify(auth))}`,
+    ]);
+    await new Promise((resolve, reject) => {
+        let subscribed = false;
+        socket.addEventListener("open", () => {
+            socket.send(JSON.stringify({ type: "connection_init" }));
+        });
+        socket.addEventListener("message", (event) => {
+            const message = JSON.parse(String(event.data));
+            if (message.type === "connection_ack" && !subscribed) {
+                subscribed = true;
+                socket.send(JSON.stringify({
+                    type: "subscribe",
+                    id: crypto.randomUUID(),
+                    channel: channel.startsWith("/") ? channel : `/${channel}`,
+                    authorization: auth,
+                }));
+            }
+            else if (message.type === "data") {
+                for (const eventValue of Array.isArray(message.event)
+                    ? message.event
+                    : [message.event]) {
+                    onData(JSON.parse(String(eventValue)));
+                }
+            }
+            else if (String(message.type).includes("error")) {
+                reject(new CliError(JSON.stringify(message), "SUBSCRIPTION_ERROR"));
+            }
+        });
+        socket.addEventListener("error", () => reject(new CliError("WebSocket connection failed", "SUBSCRIPTION_ERROR")));
+        const stop = () => socket.close();
+        process.on("SIGINT", stop);
+        socket.addEventListener("close", () => {
+            process.off("SIGINT", stop);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=http-transport.js.map

package/dist/lib/http-transport.js.map

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

package/dist/lib/io.d.ts

@@ -0,0 +1,4 @@
+export declare function readJsonValue(value: string): Promise<Record<string, unknown>>;
+export declare function readJsonAny(value: string): Promise<unknown>;
+export declare function readTextValue(value: string): Promise<string>;
+//# sourceMappingURL=io.d.ts.map

package/dist/lib/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/lib/io.ts"],"names":[],"mappings":"AAQA,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMnF;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASjE;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlE"}

package/dist/lib/io.js

@@ -0,0 +1,31 @@
+import { readFile } from "node:fs/promises";
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks).toString("utf8");
+}
+export async function readJsonValue(value) {
+    const parsed = await readJsonAny(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("Expected a JSON object");
+    }
+    return parsed;
+}
+export async function readJsonAny(value) {
+    const text = value === "-"
+        ? await readStdin()
+        : value.startsWith("@")
+            ? await readFile(value.slice(1), "utf8")
+            : value;
+    const parsed = JSON.parse(text);
+    return parsed;
+}
+export async function readTextValue(value) {
+    return value === "-"
+        ? readStdin()
+        : value.startsWith("@")
+            ? readFile(value.slice(1), "utf8")
+            : value;
+}
+//# sourceMappingURL=io.js.map

package/dist/lib/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/lib/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa;IAC/C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAa;IAC7C,MAAM,IAAI,GACR,KAAK,KAAK,GAAG;QACX,CAAC,CAAC,MAAM,SAAS,EAAE;QACnB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACrB,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;YACxC,CAAC,CAAC,KAAK,CAAC;IACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IAC3C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa;IAC/C,OAAO,KAAK,KAAK,GAAG;QAClB,CAAC,CAAC,SAAS,EAAE;QACb,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACrB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;YAClC,CAAC,CAAC,KAAK,CAAC;AACd,CAAC"}

package/dist/lib/operation-command.d.ts

@@ -0,0 +1,21 @@
+import type { OperationDefinition } from "./operation-types.js";
+import { DataworksCommand } from "./command.js";
+export interface RequiredArgumentHint {
+    flag: string;
+    type: string;
+    description: string;
+    example: string;
+}
+export interface RequiredArgumentGuidance {
+    message: string;
+    details: {
+        command: string;
+        requiredArguments: RequiredArgumentHint[];
+        example: string;
+        help: string;
+    };
+}
+export declare function requiredArgumentGuidance(operation: OperationDefinition, missing: OperationDefinition["arguments"]): RequiredArgumentGuidance;
+export declare function variablesFor(operation: OperationDefinition, flags: Record<string, any>): Promise<Record<string, unknown>>;
+export declare function createOperationCommand(operationName: string): typeof DataworksCommand;
+//# sourceMappingURL=operation-command.d.ts.map

package/dist/lib/operation-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-command.d.ts","sourceRoot":"","sources":["../../src/lib/operation-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAOhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAYhD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;QAC1C,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AA+DD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,mBAAmB,EAC9B,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC,GACxC,wBAAwB,CAuD1B;AAyED,wBAAsB,YAAY,CAChC,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA8DlC;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,gBAAgB,CAqGrF"}

package/dist/lib/operation-command.js

@@ -0,0 +1,304 @@
+import { Flags } from "@oclif/core";
+import { operationsByName } from "../generated/operations.js";
+import { readJsonValue } from "./io.js";
+import { confirm } from "./prompts.js";
+import { executeGraphql, subscribeGraphql } from "./graphql-transport.js";
+import { requireSession } from "./session.js";
+import { CliError } from "./errors.js";
+import { redact, writeResult } from "./output.js";
+import { DataworksCommand } from "./command.js";
+const commonFlags = {
+    input: Flags.string({ description: "Input JSON, @file, or - for stdin" }),
+    json: Flags.boolean({ description: "Emit stable JSON output" }),
+    select: Flags.string({ description: "GraphQL selection set body" }),
+    tenant: Flags.string({
+        description: "Override the token tenant (authorized users only)",
+    }),
+    variables: Flags.string({ description: "Variables JSON, @file, or - for stdin" }),
+};
+function shellExample(value) {
+    if (/^[@./:A-Za-z0-9_-]+$/.test(value))
+        return value;
+    const escaped = value
+        .replaceAll("\\", "\\\\")
+        .replaceAll('"', '\\"')
+        .replaceAll("$", "\\$")
+        .replaceAll("`", "\\`");
+    return `"${escaped}"`;
+}
+function argumentDescription(argument) {
+    if (argument.description)
+        return argument.description;
+    const words = argument.flag.replaceAll("-", " ");
+    return words.replace(/\bid\b/gi, "ID").replace(/^./, (value) => value.toUpperCase());
+}
+function uniqueArguments(arguments_) {
+    return arguments_.filter((argument, index) => arguments_.findIndex((candidate) => candidate.flag === argument.flag) === index);
+}
+function expandInputArgument(operation, argument) {
+    if (argument.name !== "input" || !argument.variable)
+        return [argument];
+    const requiredFields = operation.arguments.filter((candidate) => candidate.input &&
+        !candidate.variable &&
+        candidate.required &&
+        candidate.path?.[0] === "input");
+    return requiredFields.length > 0 ? requiredFields : [argument];
+}
+function exampleArguments(operation, missing) {
+    const includeTenant = missing.some(({ name }) => name === "tenant");
+    const required = operation.arguments
+        .filter((argument) => argument.variable &&
+        argument.required &&
+        (argument.name !== "tenant" || includeTenant))
+        .flatMap((argument) => expandInputArgument(operation, argument));
+    return uniqueArguments([
+        ...required,
+        ...missing.flatMap((argument) => expandInputArgument(operation, argument)),
+    ]);
+}
+export function requiredArgumentGuidance(operation, missing) {
+    const expandedMissing = uniqueArguments(missing.flatMap((argument) => expandInputArgument(operation, argument)));
+    const hints = expandedMissing.map((argument) => ({
+        flag: `--${argument.flag}`,
+        type: argument.type,
+        description: argumentDescription(argument),
+        example: argument.example,
+    }));
+    const exampleFlags = exampleArguments(operation, missing)
+        .map((argument) => `--${argument.flag} ${shellExample(argument.example)}`)
+        .join(" ");
+    const behaviorFlags = operation.kind === "mutation"
+        ? " --dry-run --json"
+        : operation.kind === "query"
+            ? " --json"
+            : "";
+    const example = `dw ${operation.command} ${exampleFlags}${behaviorFlags}`.trim();
+    const help = `dw ${operation.command} --help`;
+    const acceptsInputObject = missing.some((argument) => (argument.name === "input" && argument.variable) ||
+        (argument.input && !argument.variable));
+    const lines = [
+        `Missing required arguments for \`dw ${operation.command}\`.`,
+        "",
+        "Required:",
+        ...hints.map(({ flag, type, description, example: value }) => `  ${flag} <${type}>  ${description}; for example: ${shellExample(value)}`),
+    ];
+    if (acceptsInputObject &&
+        !expandedMissing.some(({ name, variable }) => name === "input" && variable)) {
+        lines.push("", "Alternatively, pass the complete input object:", "  --input @input.json");
+    }
+    lines.push("", "Example:", `  ${example}`, "", `More help: ${help}`);
+    return {
+        message: lines.join("\n"),
+        details: {
+            command: `dw ${operation.command}`,
+            requiredArguments: hints,
+            example,
+            help,
+        },
+    };
+}
+function requiredArgumentError(operation, missing) {
+    const guidance = requiredArgumentGuidance(operation, missing);
+    return new CliError(guidance.message, "ARGUMENT_REQUIRED", 2, guidance.details);
+}
+function valueAtPath(value, path) {
+    let current = value;
+    for (const part of path) {
+        if (!current || typeof current !== "object")
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function parseValue(value, type) {
+    const unwrapped = type.replace(/[\[\]!]/g, "");
+    if (["Int", "Float"].includes(unwrapped))
+        return Number(value);
+    if (unwrapped === "Boolean") {
+        if (value !== "true" && value !== "false")
+            throw new Error("Boolean flags must be true or false");
+        return value === "true";
+    }
+    if (type.includes("[") || value.startsWith("{") || value.startsWith("[")) {
+        return JSON.parse(value);
+    }
+    return value;
+}
+function documentFor(operation, selectionOverride) {
+    const definitions = operation.arguments
+        .filter((argument) => argument.variable)
+        .map((argument) => `$${argument.name}: ${argument.type}`)
+        .join(", ");
+    const passedArguments = operation.arguments
+        .filter((argument) => argument.variable)
+        .map((argument) => `${argument.name}: $${argument.name}`)
+        .join(", ");
+    const selection = selectionOverride ?? operation.selection;
+    return `${operation.kind} ${operation.name}${definitions ? `(${definitions})` : ""} { ${operation.name}${passedArguments ? `(${passedArguments})` : ""}${selection ? ` { ${selection} }` : ""} }`;
+}
+function nextToken(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    if ("nextToken" in value && typeof value.nextToken === "string")
+        return value.nextToken;
+    for (const child of Object.values(value)) {
+        const found = nextToken(child);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function mergePages(target, source) {
+    if (Array.isArray(target) && Array.isArray(source))
+        return [...target, ...source];
+    if (target && source && typeof target === "object" && typeof source === "object") {
+        const output = { ...target };
+        for (const [key, value] of Object.entries(source)) {
+            output[key] =
+                key === "nextToken" ? value : mergePages(target[key], value);
+        }
+        return output;
+    }
+    return source;
+}
+export async function variablesFor(operation, flags) {
+    const variables = flags.variables ? await readJsonValue(flags.variables) : {};
+    if (flags.input)
+        variables.input = await readJsonValue(flags.input);
+    for (const argument of operation.arguments) {
+        if (argument.name === "input" || argument.name === "tenant")
+            continue;
+        const value = flags[argument.flag];
+        if (typeof value === "string") {
+            const parsed = parseValue(value, argument.type);
+            if (argument.path?.[0] === "input") {
+                variables.input = {
+                    ...(variables.input ?? {}),
+                    [argument.path[1]]: parsed,
+                };
+            }
+            else {
+                variables[argument.name] = parsed;
+            }
+        }
+    }
+    if (flags.tenant)
+        variables.tenant = flags.tenant;
+    const missingArguments = operation.arguments.filter((argument) => argument.name !== "tenant" &&
+        argument.variable &&
+        argument.required &&
+        typeof variables[argument.name] === "undefined");
+    if (missingArguments.length) {
+        throw requiredArgumentError(operation, missingArguments);
+    }
+    const missingInputFields = operation.arguments.filter((argument) => argument.input &&
+        !argument.variable &&
+        argument.required &&
+        argument.path &&
+        typeof valueAtPath(variables, argument.path) === "undefined");
+    if (missingInputFields.length) {
+        throw requiredArgumentError(operation, missingInputFields);
+    }
+    const session = await requireSession();
+    if (operation.arguments.some((argument) => argument.name === "tenant") &&
+        typeof variables.tenant === "undefined") {
+        if (!session.tenant) {
+            const tenant = operation.arguments.find((argument) => argument.name === "tenant");
+            if (tenant)
+                throw requiredArgumentError(operation, [tenant]);
+        }
+        variables.tenant = session.tenant;
+    }
+    const missingTenant = operation.arguments.filter((argument) => argument.name === "tenant" &&
+        argument.variable &&
+        argument.required &&
+        typeof variables[argument.name] === "undefined");
+    if (missingTenant.length) {
+        throw requiredArgumentError(operation, missingTenant);
+    }
+    return variables;
+}
+export function createOperationCommand(operationName) {
+    const operation = operationsByName.get(operationName);
+    if (!operation)
+        throw new Error(`Unknown generated operation ${operationName}`);
+    const definition = operation;
+    const operationFlags = Object.fromEntries(definition.arguments
+        .filter((argument) => !["input", "tenant"].includes(argument.name))
+        .map((argument) => [
+        argument.flag,
+        Flags.string({
+            description: argument.description ?? `GraphQL ${argument.name}`,
+        }),
+    ]));
+    const behaviorFlags = definition.kind === "mutation"
+        ? {
+            "dry-run": Flags.boolean({
+                description: "Render a mutation without sending it",
+            }),
+            yes: Flags.boolean({
+                char: "y",
+                description: "Confirm a noninteractive mutation",
+            }),
+        }
+        : definition.kind === "query"
+            ? {
+                all: Flags.boolean({
+                    description: "Follow pagination tokens until complete",
+                }),
+            }
+            : {};
+    return class GeneratedOperationCommand extends DataworksCommand {
+        static description = definition.description ?? `Run the ${definition.name} GraphQL ${definition.kind}`;
+        static flags = {
+            ...commonFlags,
+            ...behaviorFlags,
+            ...operationFlags,
+        };
+        async run() {
+            const { flags } = await this.parse(GeneratedOperationCommand);
+            const variables = await variablesFor(definition, flags);
+            const document = documentFor(definition, flags.select);
+            if (definition.kind === "mutation") {
+                const session = await requireSession();
+                const needsConfirmation = session.environment === "live" || definition.risk === "destructive";
+                if (flags["dry-run"]) {
+                    writeResult({
+                        operation: definition.name,
+                        document,
+                        variables: redact(variables),
+                        sent: false,
+                    }, { json: flags.json, meta: { environment: session.environment } });
+                    return;
+                }
+                if (needsConfirmation && !flags.yes) {
+                    if (!process.stdin.isTTY) {
+                        throw new CliError("This mutation requires --yes in noninteractive mode", "CONFIRMATION_REQUIRED", 4);
+                    }
+                    const accepted = await confirm(`Run ${definition.name} against ${session.environment.toUpperCase()}?`);
+                    if (!accepted)
+                        throw new CliError("Mutation cancelled", "CANCELLED", 4);
+                }
+            }
+            if (definition.kind === "subscription") {
+                await subscribeGraphql(document, variables, (data) => writeResult(data, { stream: true }));
+                return;
+            }
+            let data = await executeGraphql(document, variables);
+            if (flags.all) {
+                let token = nextToken(data);
+                while (token) {
+                    variables.nextToken = token;
+                    const page = await executeGraphql(document, variables);
+                    data = mergePages(data, page);
+                    token = nextToken(page);
+                }
+            }
+            writeResult(data, {
+                json: flags.json,
+                meta: { operation: definition.name },
+            });
+        }
+    };
+}
+//# sourceMappingURL=operation-command.js.map

package/dist/lib/operation-command.js.map

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

package/dist/lib/operation-types.d.ts

@@ -0,0 +1,24 @@
+export type OperationKind = "query" | "mutation" | "subscription";
+export type MutationRisk = "standard" | "destructive";
+export interface OperationArgument {
+    name: string;
+    flag: string;
+    type: string;
+    required: boolean;
+    description: string | null;
+    example: string;
+    input: boolean;
+    variable: boolean;
+    path?: string[];
+}
+export interface OperationDefinition {
+    name: string;
+    command: string;
+    kind: OperationKind;
+    description: string | null;
+    arguments: OperationArgument[];
+    returnType: string;
+    selection: string;
+    risk: MutationRisk | null;
+}
+//# sourceMappingURL=operation-types.d.ts.map

package/dist/lib/operation-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../../src/lib/operation-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B"}

package/dist/lib/operation-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operation-types.js.map

package/dist/lib/operation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-types.js","sourceRoot":"","sources":["../../src/lib/operation-types.ts"],"names":[],"mappings":""}

package/dist/lib/output.d.ts

@@ -0,0 +1,14 @@
+export interface OutputMeta {
+    command?: string;
+    environment?: string;
+    nextToken?: string | null;
+    [key: string]: unknown;
+}
+export declare function writeResult(data: unknown, options?: {
+    json?: boolean;
+    meta?: OutputMeta;
+    stream?: boolean;
+}): void;
+export declare function writeError(error: unknown, json?: boolean): never;
+export declare function redact(value: unknown): unknown;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACpE,IAAI,CAoBN;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,UAAQ,GAAG,KAAK,CAiB9D;AAID,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS9C"}