@sendmux/cli 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { CliConfig, CliProfile, } from "./profiles.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,SAAS,EACT,UAAU,GACX,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export {};

package/dist/key-kind.d.ts

@@ -0,0 +1,4 @@
+export type ApiKeyKind = "mailbox" | "root";
+export declare function inferApiKeyKind(apiKey: string): ApiKeyKind;
+export declare function maskApiKey(apiKey: string): string;
+//# sourceMappingURL=key-kind.d.ts.map

package/dist/key-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-kind.d.ts","sourceRoot":"","sources":["../src/key-kind.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAU1D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/key-kind.js

@@ -0,0 +1,15 @@
+export function inferApiKeyKind(apiKey) {
+    if (apiKey.startsWith("smx_root_")) {
+        return "root";
+    }
+    if (apiKey.startsWith("smx_mbx_")) {
+        return "mailbox";
+    }
+    throw new Error("Sendmux API keys must start with smx_root_ or smx_mbx_");
+}
+export function maskApiKey(apiKey) {
+    if (apiKey.length <= 16) {
+        return "********";
+    }
+    return `${apiKey.slice(0, 9)}...${apiKey.slice(-4)}`;
+}

package/dist/operation-command.d.ts

@@ -0,0 +1,18 @@
+import { SendmuxCommand } from "./base-command.js";
+export declare abstract class OperationCommand extends SendmuxCommand {
+    static flags: {
+        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>;
+        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>;
+        "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>;
+    };
+    run(): Promise<unknown>;
+}
+//# sourceMappingURL=operation-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation-command.d.ts","sourceRoot":"","sources":["../src/operation-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMnD,8BAAsB,gBAAiB,SAAQ,cAAc;IAC3D,MAAM,CAAC,KAAK;;;;;;;;;;;;MAAkB;IAExB,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAK9B"}

package/dist/operation-command.js

@@ -0,0 +1,11 @@
+import { operationFlags } from "./operation-flags.js";
+import { runSdkOperation } from "./operation-runner.js";
+import { SendmuxCommand } from "./base-command.js";
+export class OperationCommand extends SendmuxCommand {
+    static flags = operationFlags;
+    async run() {
+        const constructor = this.constructor;
+        const { flags } = await this.parse(constructor);
+        return runSdkOperation(this, constructor.operation, flags);
+    }
+}

package/dist/operation-flags.d.ts

@@ -0,0 +1,33 @@
+import { type AuthFlags, type SendmuxCommand } from "./base-command.js";
+import type { OperationDefinition } from "./operation-types.js";
+export interface OperationFlags extends AuthFlags {
+    body?: string;
+    "body-file"?: string;
+    header?: string[];
+    "idempotency-key"?: string;
+    "if-match"?: string;
+    "if-none-match"?: string;
+    path?: string[];
+    query?: string[];
+}
+export interface ParsedOperationOptions {
+    body?: unknown;
+    headers?: Record<string, string>;
+    path?: Record<string, string>;
+    query?: Record<string, string>;
+}
+export declare const operationFlags: {
+    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>;
+    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>;
+    "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>;
+};
+export declare function parseOperationOptions(command: SendmuxCommand, operation: OperationDefinition, flags: OperationFlags): Promise<ParsedOperationOptions>;
+//# sourceMappingURL=operation-flags.d.ts.map

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

@@ -0,0 +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,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,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,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;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,CAgCjC"}

package/dist/operation-flags.js

@@ -0,0 +1,103 @@
+import { Flags } from "@oclif/core";
+import { readFile } from "node:fs/promises";
+import { authFlags, } from "./base-command.js";
+export const operationFlags = {
+    ...authFlags,
+    body: Flags.string({
+        description: "JSON request body for POST, PUT, and PATCH operations.",
+    }),
+    "body-file": Flags.string({
+        description: "Path to a JSON request body file.",
+    }),
+    header: Flags.string({
+        description: "Header as name=value. Repeat for multiple headers.",
+        multiple: true,
+    }),
+    "idempotency-key": Flags.string({
+        description: "Set the Idempotency-Key header.",
+    }),
+    "if-match": Flags.string({
+        description: "Set the If-Match header.",
+    }),
+    "if-none-match": Flags.string({
+        description: "Set the If-None-Match header.",
+    }),
+    path: Flags.string({
+        description: "Path parameter as name=value. Repeat for multiple path parameters.",
+        multiple: true,
+    }),
+    query: Flags.string({
+        description: "Query parameter as name=value. Repeat for multiple query parameters.",
+        multiple: true,
+    }),
+};
+export async function parseOperationOptions(command, operation, flags) {
+    const path = parsePairs(flags.path ?? [], "--path");
+    for (const parameter of operation.pathParams) {
+        if (parameter.required && !path[parameter.name]) {
+            command.error(`Missing path parameter "${parameter.name}". Pass --path ${parameter.name}=<value>.`, {
+                exit: 2,
+            });
+        }
+    }
+    const query = parsePairs(flags.query ?? [], "--query");
+    const headers = parsePairs(flags.header ?? [], "--header");
+    if (flags["idempotency-key"]) {
+        headers["Idempotency-Key"] = flags["idempotency-key"];
+    }
+    if (flags["if-match"]) {
+        headers["If-Match"] = flags["if-match"];
+    }
+    if (flags["if-none-match"]) {
+        headers["If-None-Match"] = flags["if-none-match"];
+    }
+    const body = await parseBody(command, operation, flags);
+    return dropEmpty({
+        body,
+        headers,
+        path,
+        query,
+    });
+}
+function parsePairs(values, flagName) {
+    const pairs = {};
+    for (const value of values) {
+        const separator = value.indexOf("=");
+        if (separator <= 0) {
+            throw new Error(`${flagName} values must use name=value syntax`);
+        }
+        pairs[value.slice(0, separator)] = value.slice(separator + 1);
+    }
+    return pairs;
+}
+async function parseBody(command, operation, flags) {
+    if (flags.body && flags["body-file"]) {
+        command.error("Pass only one of --body or --body-file.", { exit: 2 });
+    }
+    const raw = flags["body-file"] ? await readFile(flags["body-file"], "utf8") : flags.body;
+    if (!raw) {
+        if (operation.requestBodyRequired) {
+            command.error("This command requires a JSON body. Pass --body or --body-file.", { exit: 2 });
+        }
+        return undefined;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        command.error("Request body must be valid JSON.", { exit: 2 });
+    }
+}
+function dropEmpty(options) {
+    const next = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (value && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) {
+            continue;
+        }
+        next[key] = value;
+    }
+    return next;
+}

package/dist/operation-runner.d.ts

@@ -0,0 +1,5 @@
+import type { SendmuxCommand } from "./base-command.js";
+import { type OperationFlags } from "./operation-flags.js";
+import type { OperationDefinition } from "./operation-types.js";
+export declare function runSdkOperation(command: SendmuxCommand, operation: OperationDefinition, flags: OperationFlags): Promise<unknown>;
+//# sourceMappingURL=operation-runner.d.ts.map

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

@@ -0,0 +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,CAelB"}

package/dist/operation-runner.js

@@ -0,0 +1,45 @@
+import * as sdk from "@sendmux/sdk";
+import { parseOperationOptions, } from "./operation-flags.js";
+const surfaceModules = {
+    mailbox: sdk.mailbox,
+    management: sdk.management,
+    sending: sdk.sending,
+};
+const clientFactories = {
+    mailbox: sdk.mailbox.createMailboxClient,
+    management: sdk.management.createManagementClient,
+    sending: sdk.sending.createSendingClient,
+};
+export async function runSdkOperation(command, operation, flags) {
+    const auth = await command.resolveAuth(flags, operation.requiredKeyKind);
+    const clientConfig = {
+        apiKey: auth.apiKey,
+        ...(auth.baseUrl ? { baseUrl: auth.baseUrl } : {}),
+    };
+    const client = clientFactories[operation.surface](clientConfig);
+    const operationOptions = await parseOperationOptions(command, operation, flags);
+    const sdkOperation = operationFor(operation);
+    const response = await sdkOperation({
+        client,
+        ...operationOptions,
+    });
+    return command.renderResult(rawEnvelope(response));
+}
+function operationFor(operation) {
+    const module = surfaceModules[operation.surface];
+    const sdkOperation = module[operation.operationId];
+    if (typeof sdkOperation !== "function") {
+        throw new Error(`SDK operation ${operation.operationId} is not exported by @sendmux/sdk`);
+    }
+    return sdkOperation;
+}
+function rawEnvelope(value) {
+    if (!value || typeof value !== "object" || !("data" in value)) {
+        return value;
+    }
+    const data = value.data;
+    if (!data || typeof data !== "object" || !("ok" in data)) {
+        return value;
+    }
+    return data;
+}

package/dist/operation-types.d.ts

@@ -0,0 +1,19 @@
+import type { ApiKeyKind } from "./key-kind.js";
+export interface OperationParameter {
+    name: string;
+    required: boolean;
+}
+export interface OperationDefinition {
+    command: string;
+    description: string;
+    headerParams: readonly OperationParameter[];
+    method: string;
+    operationId: string;
+    path: string;
+    pathParams: readonly OperationParameter[];
+    queryParams: readonly OperationParameter[];
+    requestBodyRequired: boolean;
+    requiredKeyKind: ApiKeyKind;
+    surface: "mailbox" | "management" | "sending";
+}
+//# sourceMappingURL=operation-types.d.ts.map

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

@@ -0,0 +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;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,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,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,UAAU,CAAC;IAC5B,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;CAC/C"}

package/dist/operation-types.js

@@ -0,0 +1 @@
+export {};

package/dist/profiles.d.ts

@@ -0,0 +1,12 @@
+export interface CliProfile {
+    apiKey: string;
+    baseUrl?: string;
+}
+export interface CliConfig {
+    defaultProfile?: string;
+    profiles: Record<string, CliProfile>;
+}
+export declare function readCliConfig(configDir: string): Promise<CliConfig>;
+export declare function writeCliConfig(configDir: string, config: CliConfig): Promise<void>;
+export declare function configPath(configDir: string): string;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAID,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAiBzE;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxF;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/profiles.js

@@ -0,0 +1,35 @@
+import { chmod, mkdir, readFile, rename, writeFile, } from "node:fs/promises";
+import { join } from "node:path";
+const CONFIG_FILE = "config.json";
+export async function readCliConfig(configDir) {
+    const path = configPath(configDir);
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            profiles: parsed.profiles ?? {},
+            ...(parsed.defaultProfile ? { defaultProfile: parsed.defaultProfile } : {}),
+        };
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return { profiles: {} };
+        }
+        throw error;
+    }
+}
+export async function writeCliConfig(configDir, config) {
+    await mkdir(configDir, { mode: 0o700, recursive: true });
+    const path = configPath(configDir);
+    const tempPath = `${path}.${process.pid}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+    await chmod(tempPath, 0o600);
+    await rename(tempPath, path);
+    await chmod(path, 0o600);
+}
+export function configPath(configDir) {
+    return join(configDir, CONFIG_FILE);
+}
+function isNodeError(error) {
+    return Boolean(error && typeof error === "object" && "code" in error);
+}