run402 1.40.1 → 1.40.2

package/sdk/dist/namespaces/contracts.js

@@ -0,0 +1,163 @@
+/**
+ * `contracts` namespace — AWS KMS-backed Ethereum contract wallets.
+ *
+ * Contract wallets sign smart-contract write transactions. Private keys
+ * never leave KMS. Pricing: $0.04/day rental ($1.20/month) plus $0.000005
+ * per sign. Non-custodial.
+ *
+ * NOTE: The contracts API surface is frozen — this namespace preserves the
+ * existing request/response shapes verbatim.
+ */
+import { ProjectNotFound } from "../errors.js";
+export class Contracts {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Provision a new KMS-backed contract wallet. */
+    async provisionWallet(projectId, opts) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "provisioning KMS contract wallet");
+        const body = { chain: opts.chain };
+        if (opts.recoveryAddress)
+            body.recovery_address = opts.recoveryAddress;
+        return this.client.request("/contracts/v1/wallets", {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body,
+            context: "provisioning KMS contract wallet",
+        });
+    }
+    /** Get a wallet's metadata + live balance. */
+    async getWallet(projectId, walletId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "fetching wallet");
+        return this.client.request(`/contracts/v1/wallets/${encodeURIComponent(walletId)}`, {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "fetching wallet",
+        });
+    }
+    /** List all wallets owned by the project, including deleted ones. */
+    async listWallets(projectId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "listing wallets");
+        return this.client.request("/contracts/v1/wallets", {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "listing wallets",
+        });
+    }
+    /** Set or clear the recovery address used for auto-drain on day-90 deletion. */
+    async setRecovery(projectId, walletId, recoveryAddress) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "setting recovery address");
+        await this.client.request(`/contracts/v1/wallets/${encodeURIComponent(walletId)}/recovery-address`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body: { recovery_address: recoveryAddress },
+            context: "setting recovery address",
+        });
+    }
+    /** Set the low-balance threshold (in wei) for email alerts. */
+    async setLowBalanceAlert(projectId, walletId, thresholdWei) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "setting low-balance threshold");
+        await this.client.request(`/contracts/v1/wallets/${encodeURIComponent(walletId)}/alert`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body: { threshold_wei: thresholdWei },
+            context: "setting low-balance threshold",
+        });
+    }
+    /** Submit a smart-contract write call. Idempotent on `idempotencyKey`. */
+    async call(projectId, opts) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "submitting contract call");
+        const headers = { Authorization: `Bearer ${project.service_key}` };
+        if (opts.idempotencyKey)
+            headers["Idempotency-Key"] = opts.idempotencyKey;
+        const body = {
+            wallet_id: opts.walletId,
+            chain: opts.chain,
+            contract_address: opts.contractAddress,
+            abi_fragment: opts.abiFragment,
+            function_name: opts.functionName,
+            args: opts.args,
+        };
+        if (opts.value)
+            body.value = opts.value;
+        return this.client.request("/contracts/v1/call", {
+            method: "POST",
+            headers,
+            body,
+            context: "submitting contract call",
+        });
+    }
+    /** Read-only smart-contract call (view/pure). No auth, no gas, no billing. */
+    async read(opts) {
+        return this.client.request("/contracts/v1/read", {
+            method: "POST",
+            body: {
+                chain: opts.chain,
+                contract_address: opts.contractAddress,
+                abi_fragment: opts.abiFragment,
+                function_name: opts.functionName,
+                args: opts.args,
+            },
+            context: "reading contract",
+            withAuth: false,
+        });
+    }
+    /** Look up a previously submitted call by id. */
+    async callStatus(projectId, callId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "fetching call status");
+        return this.client.request(`/contracts/v1/calls/${encodeURIComponent(callId)}`, {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "fetching call status",
+        });
+    }
+    /**
+     * Drain the wallet's native-token balance to a destination address.
+     * Works on suspended wallets. Requires `X-Confirm-Drain: <wallet_id>`
+     * confirmation header (sent automatically by the SDK).
+     */
+    async drain(projectId, walletId, destinationAddress) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "draining wallet");
+        return this.client.request(`/contracts/v1/wallets/${encodeURIComponent(walletId)}/drain`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${project.service_key}`,
+                "X-Confirm-Drain": walletId,
+            },
+            body: { destination_address: destinationAddress },
+            context: "draining wallet",
+        });
+    }
+    /**
+     * Schedule the KMS key for deletion (7-day AWS minimum window). Refused
+     * if the wallet has on-chain balance ≥ dust — drain first.
+     */
+    async deleteWallet(projectId, walletId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "deleting wallet");
+        return this.client.request(`/contracts/v1/wallets/${encodeURIComponent(walletId)}`, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${project.service_key}`,
+                "X-Confirm-Delete": walletId,
+            },
+            context: "deleting wallet",
+        });
+    }
+}
+//# sourceMappingURL=contracts.js.map

package/sdk/dist/namespaces/contracts.js.map

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

package/sdk/dist/namespaces/domains.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `domains` namespace — custom domains (BYODomain) mapped to run402
+ * subdomains. Manages the registration/verification lifecycle and DNS
+ * instructions surfaced back to the user's DNS provider.
+ */
+import type { Client } from "../kernel.js";
+export interface DnsInstructions {
+    cname_target?: string;
+    txt_name?: string;
+    txt_value?: string;
+}
+export interface CustomDomainAddResult {
+    domain: string;
+    subdomain_name: string;
+    url: string;
+    subdomain_url: string;
+    status: string;
+    dns_instructions: DnsInstructions | null;
+    project_id: string | null;
+    created_at: string;
+}
+export interface CustomDomainSummary {
+    domain: string;
+    subdomain_name: string;
+    url: string;
+    subdomain_url: string;
+    status: string;
+    created_at: string;
+}
+export interface CustomDomainListResult {
+    domains: CustomDomainSummary[];
+}
+export interface CustomDomainStatusResult {
+    domain: string;
+    subdomain_name: string;
+    url: string;
+    subdomain_url: string;
+    status: string;
+    dns_instructions: DnsInstructions | null;
+    created_at: string;
+}
+export interface CustomDomainRemoveOptions {
+    projectId?: string;
+}
+export declare class Domains {
+    private readonly client;
+    constructor(client: Client);
+    /** Register a custom domain. Returns DNS records the user must add at their DNS provider. */
+    add(projectId: string, domain: string, subdomainName: string): Promise<CustomDomainAddResult>;
+    /** List all custom domains registered for a project. */
+    list(projectId: string): Promise<CustomDomainListResult>;
+    /** Check verification/SSL status for a specific custom domain. */
+    status(projectId: string, domain: string): Promise<CustomDomainStatusResult>;
+    /** Release a custom domain. `projectId` is optional for ownership-free removal. */
+    remove(domain: string, opts?: CustomDomainRemoveOptions): Promise<void>;
+}
+//# sourceMappingURL=domains.d.ts.map

package/sdk/dist/namespaces/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/namespaces/domains.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,6FAA6F;IACvF,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,CAAC;IAYjC,wDAAwD;IAClD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAU9D,kEAAkE;IAC5D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAalF,mFAAmF;IAC7E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,yBAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;CAclF"}

package/sdk/dist/namespaces/domains.js

@@ -0,0 +1,60 @@
+/**
+ * `domains` namespace — custom domains (BYODomain) mapped to run402
+ * subdomains. Manages the registration/verification lifecycle and DNS
+ * instructions surfaced back to the user's DNS provider.
+ */
+import { ProjectNotFound } from "../errors.js";
+export class Domains {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Register a custom domain. Returns DNS records the user must add at their DNS provider. */
+    async add(projectId, domain, subdomainName) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "registering custom domain");
+        return this.client.request("/domains/v1", {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body: { domain, subdomain_name: subdomainName },
+            context: "registering custom domain",
+        });
+    }
+    /** List all custom domains registered for a project. */
+    async list(projectId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "listing custom domains");
+        return this.client.request("/domains/v1", {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "listing custom domains",
+        });
+    }
+    /** Check verification/SSL status for a specific custom domain. */
+    async status(projectId, domain) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "checking domain status");
+        return this.client.request(`/domains/v1/${encodeURIComponent(domain)}`, {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "checking domain status",
+        });
+    }
+    /** Release a custom domain. `projectId` is optional for ownership-free removal. */
+    async remove(domain, opts = {}) {
+        const headers = {};
+        if (opts.projectId) {
+            const project = await this.client.getProject(opts.projectId);
+            if (!project)
+                throw new ProjectNotFound(opts.projectId, "removing custom domain");
+            headers.Authorization = `Bearer ${project.service_key}`;
+        }
+        await this.client.request(`/domains/v1/${encodeURIComponent(domain)}`, {
+            method: "DELETE",
+            headers,
+            context: "removing custom domain",
+        });
+    }
+}
+//# sourceMappingURL=domains.js.map

package/sdk/dist/namespaces/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../src/namespaces/domains.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA8C/C,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,6FAA6F;IAC7F,KAAK,CAAC,GAAG,CACP,SAAiB,EACjB,MAAc,EACd,aAAqB;QAErB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;QAEhF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB,aAAa,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,IAAI,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE;YAC/C,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAE7E,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAyB,aAAa,EAAE;YAChE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,OAAO,EAAE,wBAAwB;SAClC,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAAc;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAE7E,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,eAAe,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAC3C;YACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,OAAO,EAAE,wBAAwB;SAClC,CACF,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,OAAkC,EAAE;QAC/D,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;YAClF,OAAO,CAAC,aAAa,GAAG,UAAU,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,eAAe,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE;YAC9E,MAAM,EAAE,QAAQ;YAChB,OAAO;YACP,OAAO,EAAE,wBAAwB;SAClC,CAAC,CAAC;IACL,CAAC;CACF"}

package/sdk/dist/namespaces/email.d.ts

@@ -0,0 +1,131 @@
+/**
+ * `email` namespace — project mailboxes (send / list / get / raw / delete)
+ * and mailbox webhooks. Most operations auto-resolve the project's mailbox
+ * via the provider cache, falling back to a discovery GET when absent.
+ */
+import type { Client } from "../kernel.js";
+export interface CreateMailboxResult {
+    mailbox_id: string;
+    address: string;
+    slug: string;
+    status: string;
+}
+export interface MailboxInfo {
+    mailbox_id: string;
+    address: string;
+    slug?: string;
+}
+export type MailboxListResponse = {
+    mailboxes?: MailboxInfo[];
+} | MailboxInfo[];
+export type EmailTemplate = "project_invite" | "magic_link" | "notification";
+export interface SendEmailOptions {
+    to: string;
+    template?: EmailTemplate;
+    variables?: Record<string, string>;
+    subject?: string;
+    html?: string;
+    text?: string;
+    from_name?: string;
+    in_reply_to?: string;
+}
+export interface SendEmailResult {
+    id: string;
+    status: string;
+    to: string;
+    template?: string;
+    subject?: string;
+}
+export interface EmailSummary {
+    id: string;
+    template: string;
+    to: string;
+    status: string;
+    created_at: string;
+}
+export interface EmailDetail {
+    id: string;
+    template: string;
+    to: string;
+    status: string;
+    variables: Record<string, string>;
+    created_at: string;
+    replies?: Array<{
+        id: string;
+        from: string;
+        body: string;
+        received_at: string;
+    }>;
+}
+export interface ListEmailsOptions {
+    limit?: number;
+    after?: string;
+}
+export interface RawEmailResult {
+    content_type: string;
+    bytes: Uint8Array;
+}
+export interface MailboxWebhookSummary {
+    webhook_id: string;
+    url: string;
+    events: string[];
+    created_at: string;
+}
+export interface MailboxWebhooksResult {
+    webhooks: MailboxWebhookSummary[];
+}
+export interface RegisterWebhookOptions {
+    url: string;
+    events: string[];
+}
+export interface UpdateWebhookOptions {
+    url?: string;
+    events?: string[];
+}
+export declare class Webhooks {
+    private readonly client;
+    private readonly resolveMailbox;
+    constructor(client: Client, resolveMailbox: (projectId: string) => Promise<{
+        id: string;
+        serviceKey: string;
+    }>);
+    register(projectId: string, opts: RegisterWebhookOptions): Promise<MailboxWebhookSummary>;
+    list(projectId: string): Promise<MailboxWebhooksResult>;
+    get(projectId: string, webhookId: string): Promise<MailboxWebhookSummary>;
+    update(projectId: string, webhookId: string, opts: UpdateWebhookOptions): Promise<MailboxWebhookSummary>;
+    delete(projectId: string, webhookId: string): Promise<void>;
+}
+export declare class Email {
+    private readonly client;
+    readonly webhooks: Webhooks;
+    constructor(client: Client);
+    /**
+     * Resolve the project's mailbox id + service key. Prefers the provider's
+     * cached value; falls back to a discovery GET and persists the result
+     * when the provider supports `updateProject`.
+     */
+    private resolveMailbox;
+    private listMailboxes;
+    /** Create a mailbox for a project. Idempotent: returns the existing one on 409. */
+    createMailbox(projectId: string, slug: string): Promise<CreateMailboxResult | MailboxInfo>;
+    /** Send an email via template or raw (subject + html) mode. */
+    send(projectId: string, opts: SendEmailOptions): Promise<SendEmailResult>;
+    /** List messages in the project's mailbox. */
+    list(projectId: string, opts?: ListEmailsOptions): Promise<EmailSummary[]>;
+    /** Get a single message by id, including any replies. */
+    get(projectId: string, messageId: string): Promise<EmailDetail>;
+    /**
+     * Fetch the raw RFC-822 bytes of an inbound message. Returns `Uint8Array`
+     * so the consumer can decode / store / forward without re-encoding.
+     */
+    getRaw(projectId: string, messageId: string): Promise<RawEmailResult>;
+    /** Get the project's mailbox info. Uses the cached mailbox_id when available. */
+    getMailbox(projectId: string): Promise<MailboxInfo>;
+    /**
+     * Delete the project's mailbox. Destructive — drops all messages and
+     * webhook subscriptions. Pass `mailboxId` explicitly to delete a specific
+     * mailbox; otherwise the project's current mailbox is resolved.
+     */
+    deleteMailbox(projectId: string, mailboxId?: string): Promise<void>;
+}
+//# sourceMappingURL=email.d.ts.map

package/sdk/dist/namespaces/email.d.ts.map

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