run402 1.40.1 → 1.40.2

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

@@ -0,0 +1,64 @@
+/**
+ * `billing` namespace — wallet-scoped billing accounts and Stripe checkouts.
+ * All operations are public (no service key required); they identify the
+ * account by wallet address or email.
+ */
+import type { Client } from "../kernel.js";
+export interface BillingBalance {
+    wallet: string;
+    exists: boolean;
+    available_usd_micros: number;
+    held_usd_micros: number;
+    status?: string;
+}
+export interface BillingHistoryEntry {
+    direction: string;
+    kind: string;
+    amount_usd_micros: number;
+    balance_after_available: number;
+    created_at: string;
+}
+export interface BillingHistoryResult {
+    wallet: string;
+    entries: BillingHistoryEntry[];
+}
+export interface CreateCheckoutResult {
+    checkout_url: string;
+    topup_id: string;
+}
+export interface EmailBillingAccount {
+    id: string;
+    email: string;
+    email_credits_remaining: number;
+    verification_sent: boolean;
+}
+export interface AccountIdentifier {
+    email?: string;
+    wallet?: string;
+}
+export interface AutoRechargeOptions {
+    billingAccountId: string;
+    enabled: boolean;
+    threshold?: number;
+}
+export declare class Billing {
+    private readonly client;
+    constructor(client: Client);
+    /** Check a wallet's billing balance (available / held / status). Public, no auth. */
+    checkBalance(wallet: string): Promise<BillingBalance>;
+    /** Fetch billing history for a wallet. */
+    history(wallet: string, limit?: number): Promise<BillingHistoryResult>;
+    /** Create a Stripe checkout URL to fund a wallet's billing balance. */
+    createCheckout(wallet: string, amountUsdMicros: number): Promise<CreateCheckoutResult>;
+    /** Create an email-only (no-wallet) billing account. Sends a verification email. */
+    createEmailAccount(email: string): Promise<EmailBillingAccount>;
+    /** Link a wallet to an existing email billing account to enable hybrid Stripe + x402. */
+    linkWallet(billingAccountId: string, wallet: string): Promise<void>;
+    /** Create a Stripe checkout for a tier subscription/renewal/upgrade. */
+    tierCheckout(tier: string, identifier: AccountIdentifier): Promise<CreateCheckoutResult>;
+    /** Buy a $5 email pack (10,000 emails). */
+    buyEmailPack(identifier: AccountIdentifier): Promise<CreateCheckoutResult>;
+    /** Enable/disable email-pack auto-recharge. */
+    setAutoRecharge(opts: AutoRechargeOptions): Promise<void>;
+}
+//# sourceMappingURL=billing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/namespaces/billing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,qFAAqF;IAC/E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ3D,0CAA0C;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAW5E,uEAAuE;IACjE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAS5F,oFAAoF;IAC9E,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IASrE,yFAAyF;IACnF,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzE,wEAAwE;IAClE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAc9F,2CAA2C;IACrC,YAAY,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAchF,+CAA+C;IACzC,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAchE"}

package/sdk/dist/namespaces/billing.js

@@ -0,0 +1,105 @@
+/**
+ * `billing` namespace — wallet-scoped billing accounts and Stripe checkouts.
+ * All operations are public (no service key required); they identify the
+ * account by wallet address or email.
+ */
+export class Billing {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Check a wallet's billing balance (available / held / status). Public, no auth. */
+    async checkBalance(wallet) {
+        const w = wallet.toLowerCase();
+        return this.client.request(`/billing/v1/accounts/${w}`, {
+            context: "checking balance",
+            withAuth: false,
+        });
+    }
+    /** Fetch billing history for a wallet. */
+    async history(wallet, limit) {
+        const w = wallet.toLowerCase();
+        const path = limit
+            ? `/billing/v1/accounts/${w}/history?limit=${limit}`
+            : `/billing/v1/accounts/${w}/history`;
+        return this.client.request(path, {
+            context: "fetching billing history",
+            withAuth: false,
+        });
+    }
+    /** Create a Stripe checkout URL to fund a wallet's billing balance. */
+    async createCheckout(wallet, amountUsdMicros) {
+        return this.client.request("/billing/v1/checkouts", {
+            method: "POST",
+            body: { wallet: wallet.toLowerCase(), amount_usd_micros: amountUsdMicros },
+            context: "creating checkout",
+            withAuth: false,
+        });
+    }
+    /** Create an email-only (no-wallet) billing account. Sends a verification email. */
+    async createEmailAccount(email) {
+        return this.client.request("/billing/v1/accounts", {
+            method: "POST",
+            body: { email },
+            context: "creating email billing account",
+            withAuth: false,
+        });
+    }
+    /** Link a wallet to an existing email billing account to enable hybrid Stripe + x402. */
+    async linkWallet(billingAccountId, wallet) {
+        await this.client.request(`/billing/v1/accounts/${billingAccountId}/link-wallet`, {
+            method: "POST",
+            body: { wallet },
+            context: "linking wallet",
+            withAuth: false,
+        });
+    }
+    /** Create a Stripe checkout for a tier subscription/renewal/upgrade. */
+    async tierCheckout(tier, identifier) {
+        const body = {};
+        if (identifier.wallet)
+            body.wallet = identifier.wallet;
+        else if (identifier.email)
+            body.email = identifier.email;
+        else
+            throw new Error("Provide either `email` or `wallet` in identifier.");
+        return this.client.request(`/billing/v1/tiers/${tier}/checkout`, {
+            method: "POST",
+            body,
+            context: "creating tier checkout",
+            withAuth: false,
+        });
+    }
+    /** Buy a $5 email pack (10,000 emails). */
+    async buyEmailPack(identifier) {
+        const body = {};
+        if (identifier.wallet)
+            body.wallet = identifier.wallet;
+        else if (identifier.email)
+            body.email = identifier.email;
+        else
+            throw new Error("Provide either `email` or `wallet` in identifier.");
+        return this.client.request("/billing/v1/email-packs/checkout", {
+            method: "POST",
+            body,
+            context: "creating email pack checkout",
+            withAuth: false,
+        });
+    }
+    /** Enable/disable email-pack auto-recharge. */
+    async setAutoRecharge(opts) {
+        const body = {
+            billing_account_id: opts.billingAccountId,
+            enabled: opts.enabled,
+        };
+        if (opts.threshold !== undefined)
+            body.threshold = opts.threshold;
+        await this.client.request("/billing/v1/email-packs/auto-recharge", {
+            method: "POST",
+            body,
+            context: "setting auto-recharge",
+            withAuth: false,
+        });
+    }
+}
+//# sourceMappingURL=billing.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * `blobs` namespace — direct-to-S3 blob storage.
+ *
+ * `put` encapsulates the 3-step upload flow (init → PUT parts to S3 →
+ * complete). The S3 PUT uses `client.fetch` directly (not the gateway's
+ * `request`) so it bypasses gateway auth and path-rewriting. The client's
+ * configured fetch still flows through any wrappers (e.g. test mocks).
+ */
+import type { Client } from "../kernel.js";
+import type { BlobLsOptions, BlobLsResult, BlobPutOptions, BlobPutResult, BlobPutSource, BlobSignOptions, BlobSignResult } from "./blobs.types.js";
+export declare class Blobs {
+    private readonly client;
+    constructor(client: Client);
+    /**
+     * Upload a blob via the 3-step direct-to-S3 flow. The bytes are PUT to
+     * presigned S3 URLs — they do NOT pass through the gateway, so uploads
+     * are not double-billed as API calls and large files stream efficiently.
+     *
+     * Pass `immutable: true` to produce a content-addressed URL (the server
+     * computes no hash — the SDK does it locally and attests via `sha256`).
+     *
+     * @throws {ProjectNotFound} if `projectId` is not in the provider.
+     */
+    put(projectId: string, key: string, source: BlobPutSource, opts?: BlobPutOptions): Promise<BlobPutResult>;
+    /**
+     * Download a blob. Returns the raw `Response` so callers can stream to
+     * disk, pipe to another sink, or buffer with `.bytes()` / `.arrayBuffer()`.
+     * This avoids forcing large blobs through a JS buffer.
+     *
+     * @throws {ProjectNotFound} if `projectId` is not in the provider.
+     * @throws {ApiError} on non-2xx (includes the error text from the response body).
+     */
+    get(projectId: string, key: string): Promise<Response>;
+    /** List blobs with optional prefix + pagination. */
+    ls(projectId: string, opts?: BlobLsOptions): Promise<BlobLsResult>;
+    /** Delete a blob and decrement the project's storage_bytes. */
+    rm(projectId: string, key: string): Promise<void>;
+    /** Generate a time-boxed S3 presigned GET URL for a blob. Default TTL 1 hour, max 7 days. */
+    sign(projectId: string, key: string, opts?: BlobSignOptions): Promise<BlobSignResult>;
+}
+//# sourceMappingURL=blobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.d.ts","sourceRoot":"","sources":["../../src/namespaces/blobs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,kBAAkB,CAAC;AA6C1B,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C;;;;;;;;;OASG;IACG,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC;IA+EzB;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuB5D,oDAAoD;IAC9C,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB5E,+DAA+D;IACzD,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvD,6FAA6F;IACvF,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;CAoBhG"}

package/sdk/dist/namespaces/blobs.js

@@ -0,0 +1,202 @@
+/**
+ * `blobs` namespace — direct-to-S3 blob storage.
+ *
+ * `put` encapsulates the 3-step upload flow (init → PUT parts to S3 →
+ * complete). The S3 PUT uses `client.fetch` directly (not the gateway's
+ * `request`) so it bypasses gateway auth and path-rewriting. The client's
+ * configured fetch still flows through any wrappers (e.g. test mocks).
+ */
+import { ApiError, ProjectNotFound } from "../errors.js";
+function encodeKey(key) {
+    return key.split("/").map(encodeURIComponent).join("/");
+}
+function guessContentType(key) {
+    const ext = key.slice(key.lastIndexOf(".") + 1).toLowerCase();
+    const map = {
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        gif: "image/gif",
+        svg: "image/svg+xml",
+        webp: "image/webp",
+        html: "text/html",
+        css: "text/css",
+        js: "text/javascript",
+        json: "application/json",
+        txt: "text/plain",
+        md: "text/markdown",
+        pdf: "application/pdf",
+        zip: "application/zip",
+        tgz: "application/gzip",
+        gz: "application/gzip",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+async function sha256Hex(bytes) {
+    // crypto.subtle.digest typings disallow SharedArrayBuffer-backed views;
+    // cast through BufferSource to accept the concrete Uint8Array instance.
+    const hash = await crypto.subtle.digest("SHA-256", bytes);
+    return Array.from(new Uint8Array(hash))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+export class Blobs {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Upload a blob via the 3-step direct-to-S3 flow. The bytes are PUT to
+     * presigned S3 URLs — they do NOT pass through the gateway, so uploads
+     * are not double-billed as API calls and large files stream efficiently.
+     *
+     * Pass `immutable: true` to produce a content-addressed URL (the server
+     * computes no hash — the SDK does it locally and attests via `sha256`).
+     *
+     * @throws {ProjectNotFound} if `projectId` is not in the provider.
+     */
+    async put(projectId, key, source, opts = {}) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "uploading blob");
+        if ((source.content !== undefined && source.bytes !== undefined) ||
+            (source.content === undefined && source.bytes === undefined)) {
+            throw new Error("Provide exactly one of `content` or `bytes` in BlobPutSource.");
+        }
+        const bytes = source.bytes
+            ? source.bytes
+            : new TextEncoder().encode(source.content);
+        const sizeBytes = bytes.byteLength;
+        if (source.content !== undefined && sizeBytes > 1_048_576) {
+            throw new Error("`content` is limited to 1 MB. Use `bytes` for larger uploads.");
+        }
+        const contentType = opts.contentType ?? guessContentType(key);
+        const sha256 = opts.immutable ? await sha256Hex(bytes) : undefined;
+        // 1. Init upload — gateway returns presigned S3 URLs for each part.
+        const init = await this.client.request("/storage/v1/uploads", {
+            method: "POST",
+            headers: {
+                apikey: project.anon_key,
+                Authorization: `Bearer ${project.anon_key}`,
+            },
+            body: {
+                key,
+                size_bytes: sizeBytes,
+                content_type: contentType,
+                visibility: opts.visibility ?? "public",
+                immutable: opts.immutable ?? false,
+                sha256,
+            },
+            context: "initializing upload",
+        });
+        // 2. PUT each part directly to S3 via the presigned URL.
+        const partEtags = new Array(init.part_count);
+        for (const part of init.parts) {
+            const partBytes = bytes.subarray(part.byte_start, part.byte_end + 1);
+            const putRes = await this.client.fetch(part.url, {
+                method: "PUT",
+                body: partBytes,
+            });
+            if (!putRes.ok) {
+                const errText = await putRes.text().catch(() => "");
+                throw new ApiError(`Part ${part.part_number} PUT failed (HTTP ${putRes.status} ${putRes.statusText})${errText ? ": " + errText.slice(0, 200) : ""}`, putRes.status, errText, "uploading blob part");
+            }
+            partEtags[part.part_number - 1] = {
+                etag: (putRes.headers.get("etag") ?? "").replace(/^"|"$/g, ""),
+            };
+        }
+        // 3. Complete upload — gateway finalizes (commits multipart, writes DB row).
+        const completeBody = init.mode === "multipart"
+            ? { parts: partEtags.map((e, i) => ({ part_number: i + 1, etag: `"${e.etag}"` })) }
+            : {};
+        return this.client.request(`/storage/v1/uploads/${init.upload_id}/complete`, {
+            method: "POST",
+            headers: {
+                apikey: project.anon_key,
+                Authorization: `Bearer ${project.anon_key}`,
+            },
+            body: completeBody,
+            context: "completing upload",
+        });
+    }
+    /**
+     * Download a blob. Returns the raw `Response` so callers can stream to
+     * disk, pipe to another sink, or buffer with `.bytes()` / `.arrayBuffer()`.
+     * This avoids forcing large blobs through a JS buffer.
+     *
+     * @throws {ProjectNotFound} if `projectId` is not in the provider.
+     * @throws {ApiError} on non-2xx (includes the error text from the response body).
+     */
+    async get(projectId, key) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "downloading blob");
+        const url = `${this.client.apiBase}/storage/v1/blob/${encodeKey(key)}`;
+        const res = await this.client.fetch(url, {
+            headers: {
+                apikey: project.anon_key,
+                Authorization: `Bearer ${project.anon_key}`,
+            },
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => "");
+            throw new ApiError(`Downloading blob failed (HTTP ${res.status})`, res.status, errText, "downloading blob");
+        }
+        return res;
+    }
+    /** List blobs with optional prefix + pagination. */
+    async ls(projectId, opts = {}) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "listing blobs");
+        const qs = new URLSearchParams();
+        if (opts.prefix)
+            qs.set("prefix", opts.prefix);
+        if (opts.limit !== undefined)
+            qs.set("limit", String(opts.limit));
+        if (opts.cursor)
+            qs.set("cursor", opts.cursor);
+        const query = qs.toString();
+        const path = `/storage/v1/blobs${query ? "?" + query : ""}`;
+        return this.client.request(path, {
+            headers: {
+                apikey: project.anon_key,
+                Authorization: `Bearer ${project.anon_key}`,
+            },
+            context: "listing blobs",
+        });
+    }
+    /** Delete a blob and decrement the project's storage_bytes. */
+    async rm(projectId, key) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "deleting blob");
+        await this.client.request(`/storage/v1/blob/${encodeKey(key)}`, {
+            method: "DELETE",
+            headers: {
+                apikey: project.anon_key,
+                Authorization: `Bearer ${project.anon_key}`,
+            },
+            context: "deleting blob",
+        });
+    }
+    /** Generate a time-boxed S3 presigned GET URL for a blob. Default TTL 1 hour, max 7 days. */
+    async sign(projectId, key, opts = {}) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "signing blob URL");
+        const body = {};
+        if (opts.ttl_seconds !== undefined)
+            body.ttl_seconds = opts.ttl_seconds;
+        return this.client.request(`/storage/v1/blob/${encodeKey(key)}/sign`, {
+            method: "POST",
+            headers: {
+                apikey: project.anon_key,
+                Authorization: `Bearer ${project.anon_key}`,
+            },
+            body,
+            context: "signing blob URL",
+        });
+    }
+}
+//# sourceMappingURL=blobs.js.map

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

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

package/sdk/dist/namespaces/blobs.types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Request and response types for the `blobs` namespace.
+ *
+ * Covers the direct-to-S3 blob storage API: `PUT /storage/v1/uploads` +
+ * multipart S3 uploads, `GET /storage/v1/blob/:key`, `GET /storage/v1/blobs`,
+ * `DELETE /storage/v1/blob/:key`, `POST /storage/v1/blob/:key/sign`.
+ */
+export type BlobVisibility = "public" | "private";
+/** Source for an upload. Pass exactly one of `content` (UTF-8 string) or `bytes`. */
+export interface BlobPutSource {
+    content?: string;
+    bytes?: Uint8Array;
+}
+export interface BlobPutOptions {
+    /** MIME type. Auto-detected from `key`'s extension when omitted. */
+    contentType?: string;
+    /** Default: `"public"`. Public blobs get a CDN URL; private requires auth. */
+    visibility?: BlobVisibility;
+    /** When true, the returned URL includes a content-hash suffix — overwrites produce distinct URLs. Forces sha256 computation. */
+    immutable?: boolean;
+}
+export interface BlobPutResult {
+    key: string;
+    size_bytes: number;
+    sha256: string | null;
+    visibility: BlobVisibility;
+    url: string | null;
+    immutable_url: string | null;
+}
+export interface BlobLsOptions {
+    /** Filter: only return blobs whose key starts with this prefix. */
+    prefix?: string;
+    /** Max results. Server default 100, max 1000. */
+    limit?: number;
+    /** Pagination cursor from a previous response's `next_cursor`. */
+    cursor?: string;
+}
+export interface BlobSummary {
+    key: string;
+    size_bytes: number;
+    content_type: string | null;
+    visibility: BlobVisibility;
+    created_at: string;
+}
+export interface BlobLsResult {
+    blobs: BlobSummary[];
+    next_cursor: string | null;
+}
+export interface BlobSignOptions {
+    /** URL lifetime in seconds. 60–604800 (7 days). Server default 3600. */
+    ttl_seconds?: number;
+}
+export interface BlobSignResult {
+    signed_url: string;
+    expires_at: string;
+    expires_in: number;
+}
+//# sourceMappingURL=blobs.types.d.ts.map

package/sdk/dist/namespaces/blobs.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.types.d.ts","sourceRoot":"","sources":["../../src/namespaces/blobs.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,gIAAgI;IAChI,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/sdk/dist/namespaces/blobs.types.js

@@ -0,0 +1,9 @@
+/**
+ * Request and response types for the `blobs` namespace.
+ *
+ * Covers the direct-to-S3 blob storage API: `PUT /storage/v1/uploads` +
+ * multipart S3 uploads, `GET /storage/v1/blob/:key`, `GET /storage/v1/blobs`,
+ * `DELETE /storage/v1/blob/:key`, `POST /storage/v1/blob/:key/sign`.
+ */
+export {};
+//# sourceMappingURL=blobs.types.js.map

package/sdk/dist/namespaces/blobs.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.types.js","sourceRoot":"","sources":["../../src/namespaces/blobs.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -0,0 +1,65 @@
+/**
+ * `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 type { Client } from "../kernel.js";
+export type EvmChain = "base-mainnet" | "base-sepolia";
+export interface ProvisionWalletOptions {
+    chain: EvmChain;
+    recoveryAddress?: string;
+}
+export interface ContractCallOptions {
+    walletId: string;
+    chain: EvmChain;
+    contractAddress: string;
+    abiFragment: unknown[];
+    functionName: string;
+    args: unknown[];
+    value?: string;
+    idempotencyKey?: string;
+}
+export interface ContractReadOptions {
+    chain: EvmChain;
+    contractAddress: string;
+    abiFragment: unknown[];
+    functionName: string;
+    args: unknown[];
+}
+export declare class Contracts {
+    private readonly client;
+    constructor(client: Client);
+    /** Provision a new KMS-backed contract wallet. */
+    provisionWallet(projectId: string, opts: ProvisionWalletOptions): Promise<unknown>;
+    /** Get a wallet's metadata + live balance. */
+    getWallet(projectId: string, walletId: string): Promise<unknown>;
+    /** List all wallets owned by the project, including deleted ones. */
+    listWallets(projectId: string): Promise<unknown>;
+    /** Set or clear the recovery address used for auto-drain on day-90 deletion. */
+    setRecovery(projectId: string, walletId: string, recoveryAddress: string | null): Promise<void>;
+    /** Set the low-balance threshold (in wei) for email alerts. */
+    setLowBalanceAlert(projectId: string, walletId: string, thresholdWei: string): Promise<void>;
+    /** Submit a smart-contract write call. Idempotent on `idempotencyKey`. */
+    call(projectId: string, opts: ContractCallOptions): Promise<unknown>;
+    /** Read-only smart-contract call (view/pure). No auth, no gas, no billing. */
+    read(opts: ContractReadOptions): Promise<unknown>;
+    /** Look up a previously submitted call by id. */
+    callStatus(projectId: string, callId: string): Promise<unknown>;
+    /**
+     * 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).
+     */
+    drain(projectId: string, walletId: string, destinationAddress: string): Promise<unknown>;
+    /**
+     * Schedule the KMS key for deletion (7-day AWS minimum window). Refused
+     * if the wallet has on-chain balance ≥ dust — drain first.
+     */
+    deleteWallet(projectId: string, walletId: string): Promise<unknown>;
+}
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/namespaces/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,cAAc,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,QAAQ,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,QAAQ,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C,kDAAkD;IAC5C,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAaxF,8CAA8C;IACxC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYtE,qEAAqE;IAC/D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAStD,gFAAgF;IAC1E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrG,+DAA+D;IACzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAclG,0EAA0E;IACpE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB1E,8EAA8E;IACxE,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAevD,iDAAiD;IAC3C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYrE;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB9F;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAe1E"}