@sendmux/cli 1.0.1 → 1.2.0

package/dist/operation-flags.d.ts

@@ -1,14 +1,19 @@
 import { type AuthFlags, type SendmuxCommand } from "./base-command.js";
 import type { OperationDefinition } from "./operation-types.js";
 export interface OperationFlags extends AuthFlags {
+    attach?: string[];
     body?: string;
     "body-file"?: string;
+    "content-type"?: string;
+    file?: string;
+    follow?: boolean;
     header?: string[];
     "idempotency-key"?: string;
     "if-match"?: string;
     "if-none-match"?: string;
     path?: string[];
     query?: string[];
+    "via-presigned"?: boolean;
 }
 export interface ParsedOperationOptions {
     body?: unknown;
@@ -17,14 +22,18 @@ export interface ParsedOperationOptions {
     query?: Record<string, unknown>;
 }
 export declare const operationFlags: {
+    attach: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
     body: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     "body-file": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    "content-type": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     header: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
     "idempotency-key": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     "if-match": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     "if-none-match": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     path: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
     query: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    "via-presigned": import("@oclif/core/interfaces").BooleanFlag<boolean>;
     "api-key": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     "base-url": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/operation-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation-flags.d.ts","sourceRoot":"","sources":["../src/operation-flags.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;CA6B1B,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAwBjC"}
+{"version":3,"file":"operation-flags.d.ts","sourceRoot":"","sources":["../src/operation-flags.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CA0C1B,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAwBjC"}

package/dist/operation-flags.js

@@ -3,12 +3,22 @@ import { readFile } from "node:fs/promises";
 import { authFlags, } from "./base-command.js";
 export const operationFlags = {
     ...authFlags,
+    attach: Flags.string({
+        description: "Local file path to attach to mailbox:send-message or sending:send. Repeat for multiple files.",
+        multiple: true,
+    }),
     body: Flags.string({
         description: "JSON request body, or UTF-8 bytes for binary operations.",
     }),
     "body-file": Flags.string({
         description: "Path to a JSON request body file, or a binary file for binary operations.",
     }),
+    "content-type": Flags.string({
+        description: "Override the inferred Content-Type for --file or --attach.",
+    }),
+    file: Flags.string({
+        description: "Local file path for attachment upload convenience commands.",
+    }),
     header: Flags.string({
         description: "Header as name=value. Repeat for multiple headers.",
         multiple: true,
@@ -30,10 +40,13 @@ export const operationFlags = {
         description: "Query parameter as name=value. Repeat for multiple query parameters.",
         multiple: true,
     }),
+    "via-presigned": Flags.boolean({
+        description: "For mailbox:upload-attachment --file, mint a short-lived upload URL and PUT the file without sending an API key.",
+    }),
 };
 export async function parseOperationOptions(command, operation, flags) {
     const path = parseParameterPairs(command, operation.pathParams, flags.path ?? [], "--path");
-    const query = parseParameterPairs(command, operation.queryParams, flags.query ?? [], "--query");
+    const query = parseParameterPairs(command, operation.queryParams, flags.query ?? [], "--query", fileSuppliedQueryParams(operation, flags));
     const headers = parseParameterPairs(command, operation.headerParams, flags.header ?? [], "--header");
     if (flags["idempotency-key"]) {
         addHeaderFlag(command, operation, headers, "Idempotency-Key", flags["idempotency-key"]);
@@ -52,7 +65,7 @@ export async function parseOperationOptions(command, operation, flags) {
         query,
     });
 }
-function parseParameterPairs(command, parameters, values, flagName) {
+function parseParameterPairs(command, parameters, values, flagName, suppliedByConvenienceFlag = new Set()) {
     const parameterMap = new Map(parameters.map((parameter) => [keyForParameter(flagName, parameter.name), parameter]));
     const pairs = {};
     for (const value of values) {
@@ -83,7 +96,7 @@ function parseParameterPairs(command, parameters, values, flagName) {
         pairs[parameter.name] = parsedValue;
     }
     for (const parameter of parameters) {
-        if (parameter.required && pairs[parameter.name] === undefined) {
+        if (parameter.required && pairs[parameter.name] === undefined && !suppliedByConvenienceFlag.has(parameter.name)) {
             command.error(`Missing ${labelForFlag(flagName)} parameter "${parameter.name}". Pass ${flagName} ${parameter.name}=<value>.`, {
                 exit: 2,
             });
@@ -101,6 +114,9 @@ function parseParameterPairs(command, parameters, values, flagName) {
     return pairs;
 }
 async function parseBody(command, operation, flags) {
+    if (flags.file && (flags.body || flags["body-file"])) {
+        command.error("Pass only one of --file, --body, or --body-file.", { exit: 2 });
+    }
     if (flags.body && flags["body-file"]) {
         command.error("Pass only one of --body or --body-file.", { exit: 2 });
     }
@@ -112,7 +128,7 @@ async function parseBody(command, operation, flags) {
     }
     const hasBodyInput = flags.body !== undefined || flags["body-file"] !== undefined;
     if (!hasBodyInput) {
-        if (operation.requestBodyRequired) {
+        if (operation.requestBodyRequired && !fileSuppliesBody(operation, flags)) {
             const label = operation.bodyKind === "binary" ? "request body file" : "JSON body";
             command.error(`This command requires a ${label}. Pass --body${operation.bodyKind === "binary" ? "-file" : " or --body-file"}.`, {
                 exit: 2,
@@ -137,6 +153,15 @@ async function parseBody(command, operation, flags) {
         command.error("Request body must be valid JSON.", { exit: 2 });
     }
 }
+function fileSuppliesBody(operation, flags) {
+    return Boolean(flags.file) && operation.operationId === "mailboxUploadAttachment";
+}
+function fileSuppliedQueryParams(operation, flags) {
+    if (flags.file && operation.operationId === "mailboxUploadAttachment") {
+        return new Set(["filename"]);
+    }
+    return new Set();
+}
 function addHeaderFlag(command, operation, headers, name, value) {
     const parameter = operation.headerParams.find((item) => item.name.toLowerCase() === name.toLowerCase());
     if (!parameter) {

package/dist/operation-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation-runner.d.ts","sourceRoot":"","sources":["../src/operation-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAoBhE,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,OAAO,CAAC,CA4ClB"}
+{"version":3,"file":"operation-runner.d.ts","sourceRoot":"","sources":["../src/operation-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAqBhE,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,OAAO,CAAC,CAkElB"}

package/dist/operation-runner.js

@@ -1,4 +1,6 @@
 import * as sdk from "@sendmux/sdk";
+import { readFile, stat } from "node:fs/promises";
+import { basename, extname } from "node:path";
 import { parseOperationOptions, } from "./operation-flags.js";
 const surfaceModules = {
     mailbox: sdk.mailbox,
@@ -11,6 +13,7 @@ const clientFactories = {
     sending: sdk.sending.createSendingClient,
 };
 export async function runSdkOperation(command, operation, flags) {
+    validateAttachmentConvenienceFlags(command, operation, flags);
     const auth = await command.resolveAuth(flags, operation.requiredKeyKind);
     const clientConfig = {
         apiKey: auth.apiKey,
@@ -19,6 +22,20 @@ export async function runSdkOperation(command, operation, flags) {
     const client = clientFactories[operation.surface](clientConfig);
     const operationOptions = await parseOperationOptions(command, operation, flags);
     const sdkOperation = operationFor(operation);
+    if (operation.operationId === "mailboxCreateAttachmentUpload" && flags.file) {
+        return createMailboxAttachmentUploadFromFile(command, client, operationOptions, flags);
+    }
+    if (operation.operationId === "mailboxUploadAttachment" && flags.file) {
+        return uploadMailboxAttachmentFromFile(command, client, operationOptions, flags);
+    }
+    if ((operation.operationId === "mailboxSendMessage" || operation.operationId === "sendingSendEmail") && flags.attach?.length) {
+        const nextOptions = await withAttachedFiles(command, operation, client, operationOptions, flags);
+        const response = await sdkOperation({
+            client,
+            ...nextOptions,
+        });
+        return command.renderResult(rawResponseData(response));
+    }
     if (operation.operationId === "mailboxStreamEvents") {
         const controller = new AbortController();
         const response = await sdkOperation({
@@ -26,6 +43,9 @@ export async function runSdkOperation(command, operation, flags) {
             ...operationOptions,
             signal: controller.signal,
         });
+        if (flags.follow) {
+            return streamEvents(command, response, controller);
+        }
         return command.renderResult(await firstStreamEvent(response, controller));
     }
     if (operation.operationId === "mailboxGetMessageAttachment") {
@@ -50,6 +70,241 @@ export async function runSdkOperation(command, operation, flags) {
     }
     return command.renderResult(data);
 }
+function validateAttachmentConvenienceFlags(command, operation, flags) {
+    const supportsFile = operation.operationId === "mailboxUploadAttachment" || operation.operationId === "mailboxCreateAttachmentUpload";
+    if (flags.file && !supportsFile) {
+        command.error("This command does not support --file. Use --attach on send commands.", { exit: 2 });
+    }
+    if (flags["via-presigned"] && operation.operationId !== "mailboxUploadAttachment") {
+        command.error("--via-presigned is only supported by mailbox:upload-attachment --file.", { exit: 2 });
+    }
+    const supportsAttach = operation.operationId === "mailboxSendMessage" || operation.operationId === "sendingSendEmail";
+    if (flags.attach?.length && !supportsAttach) {
+        command.error("--attach is only supported by mailbox:send-message and sending:send.", { exit: 2 });
+    }
+    if (flags.attach?.length && flags["content-type"] && flags.attach.length > 1) {
+        command.error("--content-type with multiple --attach files would apply the same type to every file. Omit it to infer per file.", {
+            exit: 2,
+        });
+    }
+}
+async function createMailboxAttachmentUploadFromFile(command, client, operationOptions, flags) {
+    const file = await readAttachmentFile(command, flags.file, flags["content-type"]);
+    const response = await sdk.mailbox.mailboxCreateAttachmentUpload({
+        client: client,
+        body: {
+            content_type: file.contentType,
+            filename: file.filename,
+            size_bytes: file.sizeBytes,
+        },
+        query: mailboxUploadQuery(operationOptions),
+    });
+    return command.renderResult(rawResponseData(response));
+}
+async function uploadMailboxAttachmentFromFile(command, client, operationOptions, flags) {
+    const file = await readAttachmentFile(command, flags.file, flags["content-type"]);
+    if (flags["via-presigned"]) {
+        const intentResponse = await sdk.mailbox.mailboxCreateAttachmentUpload({
+            client: client,
+            query: mailboxUploadQuery(operationOptions),
+            body: {
+                content_type: file.contentType,
+                filename: file.filename,
+                size_bytes: file.sizeBytes,
+            },
+        });
+        const intent = envelopeData(intentResponse, "mailboxCreateAttachmentUpload");
+        const uploadUrl = stringField(intent, "upload_url", "mailboxCreateAttachmentUpload");
+        const method = stringField(intent, "method", "mailboxCreateAttachmentUpload");
+        const headers = recordField(intent, "headers", "mailboxCreateAttachmentUpload");
+        const contentType = stringField(headers, "Content-Type", "mailboxCreateAttachmentUpload headers");
+        const contentLength = stringField(headers, "Content-Length", "mailboxCreateAttachmentUpload headers");
+        if (method !== "PUT") {
+            throw new Error(`mailboxCreateAttachmentUpload returned unsupported method ${method}`);
+        }
+        const putResponse = await fetch(uploadUrl, {
+            body: arrayBufferFor(file.bytes),
+            headers: {
+                "Content-Length": contentLength,
+                "Content-Type": contentType,
+            },
+            method,
+        });
+        const payload = await putResponse.json().catch(() => undefined);
+        if (!putResponse.ok) {
+            throw new Error(`Presigned attachment upload failed with HTTP ${putResponse.status}`);
+        }
+        return command.renderResult(payload);
+    }
+    const response = await sdk.mailbox.mailboxUploadAttachment({
+        client: client,
+        body: blobFor(file),
+        headers: {
+            ...(recordOrUndefined(operationOptions.headers)),
+            "Content-Type": file.contentType,
+        },
+        query: {
+            ...mailboxUploadQuery(operationOptions),
+            filename: file.filename,
+        },
+    });
+    return command.renderResult(rawResponseData(response));
+}
+async function withAttachedFiles(command, operation, client, operationOptions, flags) {
+    const body = jsonObjectBody(command, operationOptions.body);
+    const existingAttachments = attachmentArray(command, body.attachments);
+    const files = [];
+    for (const path of flags.attach ?? []) {
+        files.push(await readAttachmentFile(command, path, flags["content-type"]));
+    }
+    if (operation.operationId === "mailboxSendMessage") {
+        const uploaded = [];
+        for (const file of files) {
+            const uploadResponse = await sdk.mailbox.mailboxUploadAttachment({
+                client: client,
+                body: blobFor(file),
+                headers: {
+                    "Content-Type": file.contentType,
+                },
+                query: {
+                    ...mailboxUploadQuery(operationOptions),
+                    filename: file.filename,
+                },
+            });
+            const result = envelopeData(uploadResponse, "mailboxUploadAttachment");
+            uploaded.push({
+                blob_id: stringField(result, "blob_id", "mailboxUploadAttachment"),
+                content_type: stringField(result, "content_type", "mailboxUploadAttachment"),
+                filename: stringField(result, "filename", "mailboxUploadAttachment"),
+            });
+        }
+        return {
+            ...operationOptions,
+            body: {
+                ...body,
+                attachments: [...existingAttachments, ...uploaded],
+            },
+        };
+    }
+    return {
+        ...operationOptions,
+        body: {
+            ...body,
+            attachments: [
+                ...existingAttachments,
+                ...files.map((file) => ({
+                    content: file.bytes.toString("base64"),
+                    encoding: "base64",
+                    filename: file.filename,
+                    type: file.contentType,
+                })),
+            ],
+        },
+    };
+}
+async function readAttachmentFile(command, filePath, contentTypeOverride) {
+    const info = await stat(filePath).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        command.error(`Could not read attachment file ${filePath}: ${message}`, { exit: 2 });
+    });
+    if (!info.isFile()) {
+        command.error(`Attachment path is not a regular file: ${filePath}`, { exit: 2 });
+    }
+    if (info.size === 0) {
+        command.error(`Attachment file is empty: ${filePath}`, { exit: 2 });
+    }
+    const bytes = await readFile(filePath);
+    return {
+        bytes,
+        contentType: contentTypeOverride ?? inferContentType(filePath),
+        filename: basename(filePath),
+        sizeBytes: bytes.byteLength,
+    };
+}
+function inferContentType(filePath) {
+    switch (extname(filePath).toLowerCase()) {
+        case ".csv":
+            return "text/csv";
+        case ".gif":
+            return "image/gif";
+        case ".htm":
+        case ".html":
+            return "text/html";
+        case ".jpeg":
+        case ".jpg":
+            return "image/jpeg";
+        case ".json":
+            return "application/json";
+        case ".md":
+        case ".txt":
+            return "text/plain";
+        case ".pdf":
+            return "application/pdf";
+        case ".png":
+            return "image/png";
+        case ".webp":
+            return "image/webp";
+        case ".zip":
+            return "application/zip";
+        default:
+            return "application/octet-stream";
+    }
+}
+function jsonObjectBody(command, value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        command.error("--attach requires a JSON object request body.", { exit: 2 });
+    }
+    return value;
+}
+function attachmentArray(command, value) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        command.error('Request body field "attachments" must be an array when using --attach.', { exit: 2 });
+    }
+    return value;
+}
+function mailboxUploadQuery(operationOptions) {
+    const mailboxId = recordOrUndefined(operationOptions.query)?.mailbox_id;
+    return typeof mailboxId === "string" && mailboxId.length > 0 ? { mailbox_id: mailboxId } : {};
+}
+function envelopeData(value, operationId) {
+    const raw = rawResponseData(value);
+    if (!raw || typeof raw !== "object" || !("data" in raw)) {
+        throw new Error(`SDK operation ${operationId} did not return an API envelope`);
+    }
+    const data = raw.data;
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new Error(`SDK operation ${operationId} did not return object data`);
+    }
+    return data;
+}
+function stringField(record, field, source) {
+    const value = record[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`${source} did not return string field ${field}`);
+    }
+    return value;
+}
+function recordField(record, field, source) {
+    const value = record[field];
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${source} did not return object field ${field}`);
+    }
+    return value;
+}
+function recordOrUndefined(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function blobFor(file) {
+    return new Blob([arrayBufferFor(file.bytes)], { type: file.contentType });
+}
+function arrayBufferFor(bytes) {
+    const copy = new Uint8Array(bytes.byteLength);
+    copy.set(bytes);
+    return copy.buffer;
+}
 async function firstStreamEvent(value, controller) {
     const stream = value?.stream;
     if (!stream || typeof stream[Symbol.asyncIterator] !== "function") {
@@ -75,6 +330,33 @@ async function firstStreamEvent(value, controller) {
         await closeAsyncIterator(iterator);
     }
 }
+async function streamEvents(command, value, controller) {
+    const stream = value?.stream;
+    if (!stream || typeof stream[Symbol.asyncIterator] !== "function") {
+        throw new Error("SDK operation mailboxStreamEvents did not return an async stream");
+    }
+    const iterator = stream[Symbol.asyncIterator]();
+    const abort = () => {
+        controller.abort();
+    };
+    process.once("SIGINT", abort);
+    process.once("SIGTERM", abort);
+    try {
+        while (true) {
+            const next = await iterator.next();
+            if (next.done) {
+                return;
+            }
+            command.log(JSON.stringify(next.value));
+        }
+    }
+    finally {
+        process.off("SIGINT", abort);
+        process.off("SIGTERM", abort);
+        controller.abort();
+        await closeAsyncIterator(iterator);
+    }
+}
 async function closeAsyncIterator(iterator) {
     if (typeof iterator.return !== "function") {
         return;

package/dist/operation-types.d.ts

@@ -1,4 +1,4 @@
-import type { ApiKeyKind } from "./key-kind.js";
+import type { RequiredApiKeyKind } from "./key-kind.js";
 export interface OperationParameter {
     name: string;
     required: boolean;
@@ -32,7 +32,7 @@ export interface OperationDefinition {
     queryParams: readonly OperationParameter[];
     responseKind: "binary" | "json" | "text";
     requestBodyRequired: boolean;
-    requiredKeyKind: ApiKeyKind;
+    requiredKeyKind: RequiredApiKeyKind;
     surface: "mailbox" | "management" | "sending";
 }
 //# sourceMappingURL=operation-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../src/operation-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,wBAAwB,CAAC;CAClC;AAED,MAAM,MAAM,wBAAwB,GAAG,6BAA6B,GAAG,8BAA8B,CAAC;AAEtG,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,8BAA8B,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC3C,YAAY,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,UAAU,CAAC;IAC5B,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;CAC/C"}
+{"version":3,"file":"operation-types.d.ts","sourceRoot":"","sources":["../src/operation-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,wBAAwB,CAAC;CAClC;AAED,MAAM,MAAM,wBAAwB,GAAG,6BAA6B,GAAG,8BAA8B,CAAC;AAEtG,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,8BAA8B,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC3C,YAAY,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,kBAAkB,CAAC;IACpC,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;CAC/C"}