@primitivedotdev/sdk 0.26.0 → 0.27.0

package/README.md

@@ -4,7 +4,7 @@ The official Node.js library for [Primitive](https://primitive.dev), an email AP
 
 ## Looking for the CLI?
 
-The `primitive` CLI now ships as a separate package, [`@primitivedotdev/cli`](https://www.npmjs.com/package/@primitivedotdev/cli). Install it with:
+The `primitive` CLI ships as a separate package, [`@primitivedotdev/cli`](https://www.npmjs.com/package/@primitivedotdev/cli). Install it with:
 
 ```bash
 npm install -g @primitivedotdev/cli
@@ -12,7 +12,7 @@ npm install -g @primitivedotdev/cli
 npx @primitivedotdev/cli@latest <command>
 ```
 
-This package retains the CLI for a few minor releases for backward compatibility (`npx @primitivedotdev/sdk@latest <command>` still works and prints a one-line migration banner). The retained CLI snapshot will be removed in a future minor release.
+This package no longer ships a `primitive` bin. Install `@primitivedotdev/cli` to get the CLI.
 
 ## Install
 

package/dist/api/index.js

@@ -1,406 +1,3 @@
-/**
- * Primitive API client module.
- *
- * Generated operations are exported directly, and `PrimitiveApiClient`
- * provides a configured fetch client for those operations.
- */
-import { formatAddress } from "../webhook/received-email.js";
-import { createClient, createConfig, } from "./generated/client/index.js";
-import * as generatedOperations from "./generated/sdk.gen.js";
-// Default production hosts. Two-host split exists because /send-mail
-// needs a larger body cap than Vercel allows; host 2 is a Cloudflare
-// Worker that accepts ~30 MiB raw. Host 1 carries everything else.
-// Customers don't see this split: PrimitiveClient.send() always routes
-// to host 2 internally, every other operation routes to host 1.
-//
-// Both base URLs are independently overridable via constructor options.
-// Override is for internal staging/local testing; not part of the
-// publicly-supported surface.
-export const DEFAULT_API_BASE_URL_1 = "https://www.primitive.dev/api/v1";
-export const DEFAULT_API_BASE_URL_2 = "https://api.primitive.dev/v1";
-const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-const MAX_THREAD_REFERENCES = 100;
-const MAX_THREAD_HEADER_BYTES = 8 * 1024;
-const MAX_FROM_HEADER_LENGTH = 998;
-const MAX_TO_HEADER_LENGTH = 320;
-function createDefaultAuth(apiKey) {
-    return (security) => {
-        if (security.type === "http" && security.scheme === "bearer") {
-            return apiKey;
-        }
-        return undefined;
-    };
-}
-function validateAddressHeader(field, value) {
-    const trimmed = value.trim();
-    const maxLength = field === "from" ? MAX_FROM_HEADER_LENGTH : MAX_TO_HEADER_LENGTH;
-    if (trimmed.length < 3) {
-        throw new TypeError(`${field} must be at least 3 characters`);
-    }
-    if (trimmed.length > maxLength) {
-        throw new TypeError(`${field} must be at most ${maxLength} characters`);
-    }
-}
-function validateEmailAddress(field, value) {
-    if (!EMAIL_REGEX.test(value) &&
-        !/^.+<[^\s@]+@[^\s@]+\.[^\s@]+>$/.test(value)) {
-        throw new TypeError(`${field} must be a valid email address`);
-    }
-}
-function validateThreadHeaderValue(field, value) {
-    if (value.trim().length === 0) {
-        throw new TypeError(`${field} must be a non-empty string`);
-    }
-    if ([...value].some((char) => {
-        const code = char.charCodeAt(0);
-        return code <= 0x1f || code === 0x7f;
-    })) {
-        throw new TypeError(`${field} must not contain control characters`);
-    }
-    if (value.length > 998) {
-        throw new TypeError(`${field} must be at most 998 characters`);
-    }
-}
-function validateSendInput(input) {
-    validateAddressHeader("from", input.from);
-    validateAddressHeader("to", input.to);
-    validateEmailAddress("to", input.to);
-    if (input.subject.trim().length === 0) {
-        throw new TypeError("subject must be a non-empty string");
-    }
-    if (!input.bodyText && !input.bodyHtml) {
-        throw new TypeError("one of bodyText or bodyHtml is required");
-    }
-    if (input.thread?.inReplyTo) {
-        validateThreadHeaderValue("thread.inReplyTo", input.thread.inReplyTo);
-    }
-    if (input.thread?.references) {
-        if (input.thread.references.length > MAX_THREAD_REFERENCES) {
-            throw new TypeError(`thread.references must contain at most ${MAX_THREAD_REFERENCES} values`);
-        }
-        for (const [index, reference] of input.thread.references.entries()) {
-            validateThreadHeaderValue(`thread.references[${index}]`, reference);
-        }
-        if (input.thread.references.join(" ").length > MAX_THREAD_HEADER_BYTES) {
-            throw new TypeError(`thread.references header must be at most ${MAX_THREAD_HEADER_BYTES} characters`);
-        }
-    }
-    if (input.waitTimeoutMs !== undefined) {
-        if (!Number.isInteger(input.waitTimeoutMs)) {
-            throw new TypeError("waitTimeoutMs must be an integer");
-        }
-        if (input.waitTimeoutMs < 1000 || input.waitTimeoutMs > 30000) {
-            throw new TypeError("waitTimeoutMs must be between 1000 and 30000");
-        }
-    }
-}
-function validateForwardInput(input) {
-    validateEmailAddress("to", input.to);
-    if (input.subject !== undefined && input.subject.trim().length === 0) {
-        throw new TypeError("subject must be a non-empty string");
-    }
-}
-function parseApiErrorPayload(payload) {
-    const fallback = {
-        message: "Primitive API request failed",
-        code: undefined,
-        gates: undefined,
-        requestId: undefined,
-        details: undefined,
-    };
-    if (!payload || typeof payload !== "object") {
-        return fallback;
-    }
-    if ("error" in payload &&
-        payload.error &&
-        typeof payload.error === "object") {
-        const err = payload.error;
-        return {
-            message: typeof err.message === "string" ? err.message : fallback.message,
-            code: typeof err.code === "string" ? err.code : undefined,
-            gates: Array.isArray(err.gates) ? err.gates : undefined,
-            requestId: typeof err.request_id === "string" ? err.request_id : undefined,
-            details: err.details && typeof err.details === "object"
-                ? err.details
-                : undefined,
-        };
-    }
-    if ("message" in payload && typeof payload.message === "string") {
-        return { ...fallback, message: payload.message };
-    }
-    return fallback;
-}
-export class PrimitiveApiError extends Error {
-    status;
-    code;
-    gates;
-    requestId;
-    retryAfter;
-    details;
-    payload;
-    constructor(message, options) {
-        super(message);
-        this.name = "PrimitiveApiError";
-        this.payload = options.payload;
-        this.status = options.status;
-        this.code = options.code;
-        this.gates = options.gates;
-        this.requestId = options.requestId;
-        this.retryAfter = options.retryAfter;
-        this.details = options.details;
-    }
-}
-function isAbortLikeError(error) {
-    if (!(error instanceof Error))
-        return false;
-    return error.name === "AbortError" || error.name === "TimeoutError";
-}
-function parseRetryAfterHeader(response) {
-    if (!response)
-        return undefined;
-    const raw = response.headers.get("retry-after");
-    if (!raw)
-        return undefined;
-    const seconds = Number.parseInt(raw, 10);
-    return Number.isFinite(seconds) ? seconds : undefined;
-}
-export class PrimitiveApiClient {
-    /**
-     * Generated client targeting the primary API host (apiBaseUrl1). Use
-     * this when passing `client: ...` to a generated operation function
-     * for every endpoint EXCEPT /send-mail. The hand-written
-     * PrimitiveClient.send / .reply / .forward methods on the subclass
-     * route /send-mail to the host-2 client internally.
-     */
-    client;
-    /**
-     * @internal Generated client targeting the attachments-supporting
-     * send host (apiBaseUrl2). Used by PrimitiveClient.send() under the
-     * hood. Exposed for the CLI's hand-rolled send command, which calls
-     * the generated sendEmail directly; not part of the publicly-
-     * documented SDK surface. Customer code should call .send() on the
-     * subclass instead.
-     */
-    _sendClient;
-    constructor(options = {}) {
-        const { apiKey, auth, apiBaseUrl1 = DEFAULT_API_BASE_URL_1, apiBaseUrl2 = DEFAULT_API_BASE_URL_2, ...config } = options;
-        const resolvedAuth = auth ?? createDefaultAuth(apiKey);
-        this.client = createClient(createConfig({
-            ...config,
-            auth: resolvedAuth,
-            baseUrl: apiBaseUrl1,
-        }));
-        this._sendClient = createClient(createConfig({
-            ...config,
-            auth: resolvedAuth,
-            baseUrl: apiBaseUrl2,
-        }));
-    }
-    getConfig() {
-        return this.client.getConfig();
-    }
-    setConfig(config) {
-        return this.client.setConfig(config);
-    }
-}
-function resolveRequestOptions(options) {
-    const signals = [];
-    if (options?.signal)
-        signals.push(options.signal);
-    if (options?.timeout !== undefined) {
-        signals.push(AbortSignal.timeout(options.timeout));
-    }
-    const signal = signals.length === 0
-        ? undefined
-        : signals.length === 1
-            ? signals[0]
-            : AbortSignal.any(signals);
-    const headers = {
-        ...(options?.headers ?? {}),
-        ...(options?.idempotencyKey
-            ? { "Idempotency-Key": options.idempotencyKey }
-            : {}),
-    };
-    const resolved = {};
-    if (signal)
-        resolved.signal = signal;
-    if (Object.keys(headers).length > 0)
-        resolved.headers = headers;
-    return resolved;
-}
-export class PrimitiveClient extends PrimitiveApiClient {
-    async send(input, options) {
-        validateSendInput(input);
-        const body = {
-            from: input.from,
-            to: input.to,
-            subject: input.subject,
-            ...(input.bodyText !== undefined ? { body_text: input.bodyText } : {}),
-            ...(input.bodyHtml !== undefined ? { body_html: input.bodyHtml } : {}),
-            ...(input.thread?.inReplyTo
-                ? { in_reply_to: input.thread.inReplyTo }
-                : {}),
-            ...(input.thread?.references?.length
-                ? { references: input.thread.references }
-                : {}),
-            ...(input.wait !== undefined ? { wait: input.wait } : {}),
-            ...(input.waitTimeoutMs !== undefined
-                ? { wait_timeout_ms: input.waitTimeoutMs }
-                : {}),
-        };
-        const result = await generatedOperations.sendEmail({
-            body,
-            ...resolveRequestOptions(options),
-            // /send-mail goes to the host that supports attachments. Same
-            // request body shape on both hosts; the host swap is the only
-            // difference. Callers don't see or configure this.
-            client: this._sendClient,
-            responseStyle: "fields",
-        });
-        return unwrapSendResult(result);
-    }
-    /**
-     * Reply to an inbound email.
-     *
-     * Calls `POST /emails/{id}/reply`. The server derives recipients
-     * (Reply-To, then From, then sender), subject (`Re: <parent>` with
-     * idempotent prefix), and threading headers (`In-Reply-To`,
-     * `References`) from the stored inbound row. The customer controls
-     * only the body, an optional `from` override, and the `wait` flag.
-     *
-     * Subject overrides are intentionally not supported: Gmail's
-     * Conversation View needs both a References match and a normalized-
-     * subject match to thread, so a custom subject silently breaks the
-     * thread for half the recipient population.
-     */
-    async reply(email, input, options) {
-        const resolved = typeof input === "string" ? { text: input } : input;
-        // Reject the subject override at runtime so a JS caller (no TS
-        // types) gets the same loud error as a TS caller. Without this,
-        // `client.reply(email, { text, subject: "Custom" })` silently
-        // dropped subject and sent a "Re:" reply, breaking Gmail
-        // threading without telling the caller. Mirrors Python's
-        // ValueError. Checked before the empty-body check so passing
-        // ONLY a subject surfaces the more informative error.
-        if ("subject" in resolved) {
-            throw new TypeError("reply does not support a subject override; the server prepends 'Re:' to the parent's subject for thread continuity");
-        }
-        if (!resolved.text && !resolved.html) {
-            throw new TypeError("reply requires text or html");
-        }
-        const body = {
-            ...(resolved.text !== undefined ? { body_text: resolved.text } : {}),
-            ...(resolved.html !== undefined ? { body_html: resolved.html } : {}),
-            ...(resolved.from !== undefined ? { from: resolved.from } : {}),
-            ...(resolved.wait !== undefined ? { wait: resolved.wait } : {}),
-        };
-        const result = await generatedOperations.replyToEmail({
-            body,
-            path: { id: email.id },
-            ...resolveRequestOptions(options),
-            client: this.client,
-            responseStyle: "fields",
-        });
-        return unwrapSendResult(result);
-    }
-    async forward(email, input, options) {
-        validateForwardInput(input);
-        return this.send({
-            from: input.from ?? email.receivedBy,
-            to: input.to,
-            subject: input.subject ?? email.forwardSubject,
-            bodyText: buildForwardText(email, input.bodyText),
-        }, options);
-    }
-}
-function buildForwardText(email, intro) {
-    const lines = [
-        ...(intro ? [intro.trim(), ""] : []),
-        "---------- Forwarded message ----------",
-        `From: ${formatAddress(email.sender)}`,
-        `To: ${email.raw.email.headers.to}`,
-        `Subject: ${email.subject ?? ""}`,
-        ...(email.raw.email.headers.date
-            ? [`Date: ${email.raw.email.headers.date}`]
-            : []),
-        ...(email.thread.messageId
-            ? [`Message-ID: ${email.thread.messageId}`]
-            : []),
-        "",
-        email.text ?? "",
-    ];
-    return lines.join("\n").trimEnd();
-}
-/**
- * Shared response handler for `send`, `reply`, and any future
- * operation that returns a SendMailResult envelope. Unifies the
- * error-mapping path so the network call sites only have to invoke
- * the generated operation.
- */
-function unwrapSendResult(result) {
-    const response = result.response;
-    if (result.error) {
-        if (isAbortLikeError(result.error)) {
-            throw result.error;
-        }
-        const parsed = parseApiErrorPayload(result.error);
-        throw new PrimitiveApiError(parsed.message, {
-            payload: result.error,
-            status: response?.status,
-            code: parsed.code,
-            gates: parsed.gates,
-            requestId: parsed.requestId,
-            retryAfter: parseRetryAfterHeader(response),
-            details: parsed.details,
-        });
-    }
-    if (!result.data?.data) {
-        throw new PrimitiveApiError("Primitive API returned no send result", {
-            payload: result,
-            status: response?.status,
-        });
-    }
-    return mapSendResult(result.data.data);
-}
-function mapSendResult(result) {
-    return {
-        id: result.id,
-        status: result.status,
-        queueId: result.queue_id,
-        accepted: result.accepted,
-        rejected: result.rejected,
-        clientIdempotencyKey: result.client_idempotency_key,
-        requestId: result.request_id,
-        contentHash: result.content_hash,
-        // Default to false if the server omits the field (old-format
-        // response, mocked partial response in a customer's tests). The
-        // type signature claims `boolean`, so undefined would be a lie.
-        idempotentReplay: result.idempotent_replay ?? false,
-        ...(result.delivery_status !== undefined
-            ? { deliveryStatus: result.delivery_status }
-            : {}),
-        ...(result.smtp_response_code !== undefined
-            ? { smtpResponseCode: result.smtp_response_code }
-            : {}),
-        ...(result.smtp_response_text !== undefined
-            ? { smtpResponseText: result.smtp_response_text }
-            : {}),
-    };
-}
-export function createPrimitiveApiClient(options = {}) {
-    return new PrimitiveApiClient(options);
-}
-export function createPrimitiveClient(options = {}) {
-    return new PrimitiveClient(options);
-}
-export function client(options = {}) {
-    return new PrimitiveClient(options);
-}
-export const operations = generatedOperations;
-export * from "./generated/index.js";
-// Web Crypto verifier for in-handler webhook verification. Mirrors
-// the surface of `verifyWebhookSignature` from `@primitivedotdev/sdk`
-// (the Node version) but implements HMAC-SHA256 with `crypto.subtle`
-// so it can be bundled into a Primitive Function without pulling in
-// a `node:crypto` polyfill.
-export { PRIMITIVE_SIGNATURE_HEADER, verifyWebhookSignature, WebhookVerificationError, } from "./verify-signature.js";
+import { c as WebhookVerificationError } from "../errors-x91I_yEt.js";
+import { $ as testFunction, A as getSendPermissions, B as listFunctionSecrets, C as deleteFunctionSecret, D as getAccount, E as downloadRawEmail, F as listDomains, G as replayEmailWebhooks, H as listSentEmails, I as listEmails, J as searchEmails, K as replyToEmail, L as listEndpoints, M as getStorageStats, N as getWebhookSecret, O as getEmail, P as listDeliveries, Q as testEndpoint, R as listFilters, S as deleteFunction, T as downloadAttachments, U as pollCliLogin, V as listFunctions, W as replayDelivery, X as setFunctionSecret, Y as sendEmail, Z as startCliLogin, _ as createFunctionSecret, a as PrimitiveClient, at as verifyDomain, b as deleteEndpoint, c as createPrimitiveClient, d as verifyWebhookSignature, et as updateAccount, f as addDomain, g as createFunction, h as createFilter, i as PrimitiveApiError, it as updateFunction, j as getSentEmail, k as getFunction, l as operations, m as createEndpoint, n as DEFAULT_API_BASE_URL_2, nt as updateEndpoint, o as client, p as cliLogout, q as rotateWebhookSecret, r as PrimitiveApiClient, rt as updateFilter, s as createPrimitiveApiClient, t as DEFAULT_API_BASE_URL_1, tt as updateDomain, u as PRIMITIVE_SIGNATURE_HEADER, v as deleteDomain, w as discardEmailContent, x as deleteFilter, y as deleteEmail, z as listFunctionLogs } from "../api-CnUa6o4r.js";
+export { DEFAULT_API_BASE_URL_1, DEFAULT_API_BASE_URL_2, PRIMITIVE_SIGNATURE_HEADER, PrimitiveApiClient, PrimitiveApiError, PrimitiveClient, WebhookVerificationError, addDomain, cliLogout, client, createEndpoint, createFilter, createFunction, createFunctionSecret, createPrimitiveApiClient, createPrimitiveClient, deleteDomain, deleteEmail, deleteEndpoint, deleteFilter, deleteFunction, deleteFunctionSecret, discardEmailContent, downloadAttachments, downloadRawEmail, getAccount, getEmail, getFunction, getSendPermissions, getSentEmail, getStorageStats, getWebhookSecret, listDeliveries, listDomains, listEmails, listEndpoints, listFilters, listFunctionLogs, listFunctionSecrets, listFunctions, listSentEmails, operations, pollCliLogin, replayDelivery, replayEmailWebhooks, replyToEmail, rotateWebhookSecret, searchEmails, sendEmail, setFunctionSecret, startCliLogin, testEndpoint, testFunction, updateAccount, updateDomain, updateEndpoint, updateFilter, updateFunction, verifyDomain, verifyWebhookSignature };