run402 1.40.0 → 1.40.2

package/sdk/dist/namespaces/email.js

@@ -0,0 +1,318 @@
+/**
+ * `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 { ApiError, ProjectNotFound } from "../errors.js";
+const SLUG_RE = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+export class Webhooks {
+    client;
+    resolveMailbox;
+    constructor(client, resolveMailbox) {
+        this.client = client;
+        this.resolveMailbox = resolveMailbox;
+    }
+    async register(projectId, opts) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        return this.client.request(`/mailboxes/v1/${id}/webhooks`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            body: { url: opts.url, events: opts.events },
+            context: "registering webhook",
+        });
+    }
+    async list(projectId) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        return this.client.request(`/mailboxes/v1/${id}/webhooks`, {
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            context: "listing webhooks",
+        });
+    }
+    async get(projectId, webhookId) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        return this.client.request(`/mailboxes/v1/${id}/webhooks/${webhookId}`, {
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            context: "getting webhook",
+        });
+    }
+    async update(projectId, webhookId, opts) {
+        if (!opts.url && !opts.events) {
+            throw new Error("Provide at least `url` or `events` to update a webhook.");
+        }
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        const body = {};
+        if (opts.url)
+            body.url = opts.url;
+        if (opts.events)
+            body.events = opts.events;
+        return this.client.request(`/mailboxes/v1/${id}/webhooks/${webhookId}`, {
+            method: "PATCH",
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            body,
+            context: "updating webhook",
+        });
+    }
+    async delete(projectId, webhookId) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        await this.client.request(`/mailboxes/v1/${id}/webhooks/${webhookId}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            context: "deleting webhook",
+        });
+    }
+}
+export class Email {
+    client;
+    webhooks;
+    constructor(client) {
+        this.client = client;
+        this.webhooks = new Webhooks(client, (projectId) => this.resolveMailbox(projectId));
+    }
+    /**
+     * 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`.
+     */
+    async resolveMailbox(projectId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "resolving mailbox");
+        if (project.mailbox_id) {
+            return { id: project.mailbox_id, serviceKey: project.service_key };
+        }
+        const list = await this.listMailboxes(project.service_key);
+        if (list.length === 0) {
+            throw new ApiError("No mailbox found for this project. Use `create_mailbox` to create one first.", 404, null, "resolving mailbox");
+        }
+        const first = list[0];
+        const updater = this.client.credentials.updateProject;
+        if (updater) {
+            try {
+                await updater.call(this.client.credentials, projectId, {
+                    mailbox_id: first.mailbox_id,
+                    mailbox_address: first.address,
+                });
+            }
+            catch {
+                // best-effort cache — ignore failures
+            }
+        }
+        return { id: first.mailbox_id, serviceKey: project.service_key };
+    }
+    async listMailboxes(serviceKey) {
+        const raw = await this.client.request(`/mailboxes/v1`, {
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            context: "listing mailboxes",
+        });
+        return Array.isArray(raw) ? raw : raw.mailboxes ?? [];
+    }
+    /** Create a mailbox for a project. Idempotent: returns the existing one on 409. */
+    async createMailbox(projectId, slug) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "creating mailbox");
+        if (slug.length < 3 || slug.length > 63) {
+            throw new Error("Slug must be 3-63 characters.");
+        }
+        if (!SLUG_RE.test(slug)) {
+            throw new Error("Slug must be lowercase alphanumeric + hyphens, start/end with alphanumeric.");
+        }
+        if (slug.includes("--")) {
+            throw new Error("Slug must not contain consecutive hyphens.");
+        }
+        try {
+            const result = await this.client.request("/mailboxes/v1", {
+                method: "POST",
+                headers: { Authorization: `Bearer ${project.service_key}` },
+                body: { slug, project_id: projectId },
+                context: "creating mailbox",
+            });
+            const updater = this.client.credentials.updateProject;
+            if (updater) {
+                await updater.call(this.client.credentials, projectId, {
+                    mailbox_id: result.mailbox_id,
+                    mailbox_address: result.address,
+                });
+            }
+            return result;
+        }
+        catch (err) {
+            if (err instanceof ApiError && err.status === 409) {
+                // Existing mailbox — try to discover and cache it. If discovery
+                // fails or returns empty, re-throw the original 409 so the caller
+                // sees the server's "already has a mailbox" message.
+                try {
+                    const list = await this.listMailboxes(project.service_key);
+                    if (list.length > 0) {
+                        const existing = list[0];
+                        const updater = this.client.credentials.updateProject;
+                        if (updater) {
+                            await updater.call(this.client.credentials, projectId, {
+                                mailbox_id: existing.mailbox_id,
+                                mailbox_address: existing.address,
+                            });
+                        }
+                        return existing;
+                    }
+                }
+                catch {
+                    // fall through to re-throw the original 409
+                }
+            }
+            throw err;
+        }
+    }
+    /** Send an email via template or raw (subject + html) mode. */
+    async send(projectId, opts) {
+        const hasSubject = !!opts.subject;
+        const hasHtml = !!opts.html;
+        const isRaw = hasSubject || hasHtml;
+        const isTemplate = !!opts.template;
+        if (!isRaw && !isTemplate) {
+            throw new Error("Provide either `template` + `variables` or both `subject` + `html`.");
+        }
+        if (isRaw && isTemplate) {
+            throw new Error("Provide `template` OR raw mode (`subject` + `html`), not both.");
+        }
+        if (isRaw && !(hasSubject && hasHtml)) {
+            const missing = hasSubject ? "html" : "subject";
+            throw new Error(`Raw mode requires both \`subject\` and \`html\` (missing \`${missing}\`).`);
+        }
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        const body = { to: opts.to };
+        if (isTemplate) {
+            body.template = opts.template;
+            body.variables = opts.variables;
+        }
+        else {
+            body.subject = opts.subject;
+            body.html = opts.html;
+            if (opts.text)
+                body.text = opts.text;
+        }
+        if (opts.from_name)
+            body.from_name = opts.from_name;
+        if (opts.in_reply_to)
+            body.in_reply_to = opts.in_reply_to;
+        return this.client.request(`/mailboxes/v1/${id}/messages`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            body,
+            context: "sending email",
+        });
+    }
+    /** List messages in the project's mailbox. */
+    async list(projectId, opts = {}) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        const qs = new URLSearchParams();
+        if (opts.limit !== undefined)
+            qs.set("limit", String(opts.limit));
+        if (opts.after)
+            qs.set("after", opts.after);
+        const path = `/mailboxes/v1/${id}/messages${qs.toString() ? "?" + qs.toString() : ""}`;
+        return this.client.request(path, {
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            context: "listing emails",
+        });
+    }
+    /** Get a single message by id, including any replies. */
+    async get(projectId, messageId) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        return this.client.request(`/mailboxes/v1/${id}/messages/${messageId}`, {
+            headers: { Authorization: `Bearer ${serviceKey}` },
+            context: "getting email",
+        });
+    }
+    /**
+     * Fetch the raw RFC-822 bytes of an inbound message. Returns `Uint8Array`
+     * so the consumer can decode / store / forward without re-encoding.
+     */
+    async getRaw(projectId, messageId) {
+        const { id, serviceKey } = await this.resolveMailbox(projectId);
+        const url = `${this.client.apiBase}/mailboxes/v1/${id}/messages/${messageId}/raw`;
+        const res = await this.client.fetch(url, {
+            headers: { Authorization: `Bearer ${serviceKey}` },
+        });
+        if (!res.ok) {
+            let body;
+            try {
+                body = await res.json();
+            }
+            catch {
+                body = await res.text().catch(() => "");
+            }
+            throw new ApiError(`Fetching raw MIME failed (HTTP ${res.status})`, res.status, body, "fetching raw MIME");
+        }
+        const buf = await res.arrayBuffer();
+        return {
+            content_type: res.headers.get("content-type") ?? "message/rfc822",
+            bytes: new Uint8Array(buf),
+        };
+    }
+    /** Get the project's mailbox info. Uses the cached mailbox_id when available. */
+    async getMailbox(projectId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "getting mailbox");
+        const list = await this.listMailboxes(project.service_key);
+        if (list.length === 0) {
+            throw new ApiError("No mailbox found for this project. Use `create_mailbox` to create one first.", 404, null, "getting mailbox");
+        }
+        const mb = list[0];
+        const updater = this.client.credentials.updateProject;
+        if (updater) {
+            try {
+                await updater.call(this.client.credentials, projectId, {
+                    mailbox_id: mb.mailbox_id,
+                    mailbox_address: mb.address,
+                });
+            }
+            catch {
+                // best-effort
+            }
+        }
+        return mb;
+    }
+    /**
+     * 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.
+     */
+    async deleteMailbox(projectId, mailboxId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "deleting mailbox");
+        let id = mailboxId;
+        if (!id) {
+            if (project.mailbox_id) {
+                id = project.mailbox_id;
+            }
+            else {
+                const list = await this.listMailboxes(project.service_key);
+                if (list.length === 0) {
+                    throw new ApiError("No mailbox found for this project — nothing to delete.", 404, null, "deleting mailbox");
+                }
+                id = list[0].mailbox_id;
+            }
+        }
+        await this.client.request(`/mailboxes/v1/${id}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "deleting mailbox",
+        });
+        // Clear the cached mailbox_id so future calls re-discover.
+        const updater = this.client.credentials.updateProject;
+        if (updater) {
+            try {
+                await updater.call(this.client.credentials, projectId, {
+                    mailbox_id: undefined,
+                    mailbox_address: undefined,
+                });
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
+}
+//# sourceMappingURL=email.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/namespaces/email.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,OAAO,GAAG,iCAAiC,CAAC;AA8FlD,MAAM,OAAO,QAAQ;IAEA;IACA;IAFnB,YACmB,MAAc,EACd,cAAkF;QADlF,WAAM,GAAN,MAAM,CAAQ;QACd,mBAAc,GAAd,cAAc,CAAoE;IAClG,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,IAA4B;QAC5D,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB,iBAAiB,EAAE,WAAW,EAAE;YAChF,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;YAC5C,OAAO,EAAE,qBAAqB;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwB,iBAAiB,EAAE,WAAW,EAAE;YAChF,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,SAAiB;QAC5C,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,iBAAiB,EAAE,aAAa,SAAS,EAAE,EAC3C;YACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,OAAO,EAAE,iBAAiB;SAC3B,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,SAAiB,EACjB,IAA0B;QAE1B,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,iBAAiB,EAAE,aAAa,SAAS,EAAE,EAC3C;YACE,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,IAAI;YACJ,OAAO,EAAE,kBAAkB;SAC5B,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,SAAiB;QAC/C,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,iBAAiB,EAAE,aAAa,SAAS,EAAE,EAAE;YAC9E,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,KAAK;IAGa;IAFpB,QAAQ,CAAW;IAE5B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,SAAiB;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,mBAAmB,CAAC,CAAC;QAExE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,QAAQ,CAChB,8EAA8E,EAC9E,GAAG,EACH,IAAI,EACJ,mBAAmB,CACpB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC;QACtD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE;oBACrD,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,eAAe,EAAE,KAAK,CAAC,OAAO;iBAC/B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;YACxC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,UAAkB;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB,eAAe,EAAE;YAC1E,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,OAAO,EAAE,mBAAmB;SAC7B,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,IAAY;QACjD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAEvE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB,eAAe,EAAE;gBAC7E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;gBAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE;gBACrC,OAAO,EAAE,kBAAkB;aAC5B,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC;YACtD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE;oBACrD,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,eAAe,EAAE,MAAM,CAAC,OAAO;iBAChC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClD,gEAAgE;gBAChE,kEAAkE;gBAClE,qDAAqD;gBACrD,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;oBAC3D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;wBAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC;wBACtD,IAAI,OAAO,EAAE,CAAC;4BACZ,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE;gCACrD,UAAU,EAAE,QAAQ,CAAC,UAAU;gCAC/B,eAAe,EAAE,QAAQ,CAAC,OAAO;6BAClC,CAAC,CAAC;wBACL,CAAC;wBACD,OAAO,QAAQ,CAAC;oBAClB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;gBAC9C,CAAC;YACH,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAAsB;QAClD,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,MAAM,KAAK,GAAG,UAAU,IAAI,OAAO,CAAC;QACpC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,KAAK,IAAI,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,8DAA8D,OAAO,MAAM,CAAC,CAAC;QAC/F,CAAC;QAED,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,IAAI,GAA4B,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACpD,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAE1D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAkB,iBAAiB,EAAE,WAAW,EAAE;YAC1E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,IAAI;YACJ,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,OAA0B,EAAE;QACxD,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,IAAI,IAAI,CAAC,KAAK;YAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,iBAAiB,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACvF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAiB,IAAI,EAAE;YAC/C,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,SAAiB;QAC5C,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAc,iBAAiB,EAAE,aAAa,SAAS,EAAE,EAAE;YACnF,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;YAClD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,SAAiB;QAC/C,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,iBAAiB,EAAE,aAAa,SAAS,MAAM,CAAC;QAClF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YACvC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,UAAU,EAAE,EAAE;SACnD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBAAC,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YACnF,MAAM,IAAI,QAAQ,CAChB,kCAAkC,GAAG,CAAC,MAAM,GAAG,EAC/C,GAAG,CAAC,MAAM,EACV,IAAI,EACJ,mBAAmB,CACpB,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO;YACL,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,gBAAgB;YACjE,KAAK,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC;SAC3B,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,QAAQ,CAChB,8EAA8E,EAC9E,GAAG,EACH,IAAI,EACJ,iBAAiB,CAClB,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC;QACtD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE;oBACrD,UAAU,EAAE,EAAE,CAAC,UAAU;oBACzB,eAAe,EAAE,EAAE,CAAC,OAAO;iBAC5B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,SAAkB;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;QAEvE,IAAI,EAAE,GAAG,SAAS,CAAC;QACnB,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,QAAQ,CAChB,wDAAwD,EACxD,GAAG,EACH,IAAI,EACJ,kBAAkB,CACnB,CAAC;gBACJ,CAAC;gBACD,EAAE,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,iBAAiB,EAAE,EAAE,EAAE;YACxD,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;QAEH,2DAA2D;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC;QACtD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE;oBACrD,UAAU,EAAE,SAAS;oBACrB,eAAe,EAAE,SAAS;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,43 @@
+/**
+ * `functions` namespace — serverless function lifecycle.
+ *
+ * Covers deploy/invoke/logs/list/delete/update against
+ * `/projects/v1/admin/:id/functions*` and `/functions/v1/:name`.
+ */
+import type { Client } from "../kernel.js";
+import type { FunctionDeployOptions, FunctionDeployResult, FunctionInvokeOptions, FunctionInvokeResult, FunctionListResult, FunctionLogsOptions, FunctionLogsResult, FunctionUpdateOptions, FunctionUpdateResult } from "./functions.types.js";
+export declare class Functions {
+    private readonly client;
+    constructor(client: Client);
+    /**
+     * Deploy a serverless function. Pre-bundled packages include `stripe`,
+     * `openai`, `@anthropic-ai/sdk`, `resend`, `zod`, `uuid`, `jsonwebtoken`,
+     * `bcryptjs`, `cheerio`, `csv-parse`. Additional deps are bundled when
+     * listed in `opts.deps`.
+     *
+     * @throws {PaymentRequired} when the project lease has expired.
+     */
+    deploy(projectId: string, opts: FunctionDeployOptions): Promise<FunctionDeployResult>;
+    /**
+     * Invoke a deployed function via HTTP. Uses the project's service key as
+     * the API key. The returned `body` is parsed JSON when the response was
+     * JSON, otherwise the raw text.
+     */
+    invoke(projectId: string, name: string, opts?: FunctionInvokeOptions): Promise<FunctionInvokeResult>;
+    /**
+     * Get recent logs for a function. Default tail 50; `since` accepts an ISO
+     * 8601 timestamp for incremental polling.
+     */
+    logs(projectId: string, name: string, opts?: FunctionLogsOptions): Promise<FunctionLogsResult>;
+    /** List deployed functions for a project. */
+    list(projectId: string): Promise<FunctionListResult>;
+    /** Delete a deployed function. */
+    delete(projectId: string, name: string): Promise<void>;
+    /**
+     * Update a function's schedule / timeout / memory without re-deploying.
+     * Pass `schedule: null` to remove an existing schedule; `undefined`
+     * leaves it unchanged.
+     */
+    update(projectId: string, name: string, opts: FunctionUpdateOptions): Promise<FunctionUpdateResult>;
+}
+//# sourceMappingURL=functions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/namespaces/functions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C;;;;;;;OAOG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuB3F;;;;OAIG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,oBAAoB,CAAC;IAgChC;;;OAGG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAiB9B,6CAA6C;IACvC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa1D,kCAAkC;IAC5B,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;;OAIG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;CAuBjC"}

package/sdk/dist/namespaces/functions.js

@@ -0,0 +1,146 @@
+/**
+ * `functions` namespace — serverless function lifecycle.
+ *
+ * Covers deploy/invoke/logs/list/delete/update against
+ * `/projects/v1/admin/:id/functions*` and `/functions/v1/:name`.
+ */
+import { ProjectNotFound } from "../errors.js";
+export class Functions {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Deploy a serverless function. Pre-bundled packages include `stripe`,
+     * `openai`, `@anthropic-ai/sdk`, `resend`, `zod`, `uuid`, `jsonwebtoken`,
+     * `bcryptjs`, `cheerio`, `csv-parse`. Additional deps are bundled when
+     * listed in `opts.deps`.
+     *
+     * @throws {PaymentRequired} when the project lease has expired.
+     */
+    async deploy(projectId, opts) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "deploying function");
+        const body = {
+            name: opts.name,
+            code: opts.code,
+        };
+        if (opts.config !== undefined)
+            body.config = opts.config;
+        if (opts.deps !== undefined)
+            body.deps = opts.deps;
+        if (opts.schedule !== undefined)
+            body.schedule = opts.schedule;
+        return this.client.request(`/projects/v1/admin/${projectId}/functions`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body,
+            context: "deploying function",
+        });
+    }
+    /**
+     * Invoke a deployed function via HTTP. Uses the project's service key as
+     * the API key. The returned `body` is parsed JSON when the response was
+     * JSON, otherwise the raw text.
+     */
+    async invoke(projectId, name, opts = {}) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "invoking function");
+        const method = opts.method ?? "POST";
+        const headers = {
+            apikey: project.service_key,
+            ...(opts.headers ?? {}),
+        };
+        const requestOpts = {
+            method,
+            headers,
+            context: "invoking function",
+        };
+        if (method !== "GET" && method !== "HEAD" && opts.body !== undefined) {
+            if (typeof opts.body === "string") {
+                requestOpts.rawBody = opts.body;
+            }
+            else {
+                requestOpts.body = opts.body;
+            }
+        }
+        const start = Date.now();
+        const body = await this.client.request(`/functions/v1/${name}`, requestOpts);
+        return {
+            status: 200,
+            body,
+            duration_ms: Date.now() - start,
+        };
+    }
+    /**
+     * Get recent logs for a function. Default tail 50; `since` accepts an ISO
+     * 8601 timestamp for incremental polling.
+     */
+    async logs(projectId, name, opts = {}) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "fetching function logs");
+        const tail = opts.tail ?? 50;
+        let path = `/projects/v1/admin/${projectId}/functions/${encodeURIComponent(name)}/logs?tail=${tail}`;
+        if (opts.since) {
+            const sinceMs = new Date(opts.since).getTime();
+            if (!Number.isNaN(sinceMs))
+                path += `&since=${sinceMs}`;
+        }
+        return this.client.request(path, {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "fetching function logs",
+        });
+    }
+    /** List deployed functions for a project. */
+    async list(projectId) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "listing functions");
+        return this.client.request(`/projects/v1/admin/${projectId}/functions`, {
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "listing functions",
+        });
+    }
+    /** Delete a deployed function. */
+    async delete(projectId, name) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "deleting function");
+        await this.client.request(`/projects/v1/admin/${projectId}/functions/${encodeURIComponent(name)}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            context: "deleting function",
+        });
+    }
+    /**
+     * Update a function's schedule / timeout / memory without re-deploying.
+     * Pass `schedule: null` to remove an existing schedule; `undefined`
+     * leaves it unchanged.
+     */
+    async update(projectId, name, opts) {
+        const project = await this.client.getProject(projectId);
+        if (!project)
+            throw new ProjectNotFound(projectId, "updating function");
+        const body = {};
+        if (opts.schedule !== undefined)
+            body.schedule = opts.schedule;
+        if (opts.timeout !== undefined || opts.memory !== undefined) {
+            const config = {};
+            if (opts.timeout !== undefined)
+                config.timeout = opts.timeout;
+            if (opts.memory !== undefined)
+                config.memory = opts.memory;
+            body.config = config;
+        }
+        return this.client.request(`/projects/v1/admin/${projectId}/functions/${encodeURIComponent(name)}`, {
+            method: "PATCH",
+            headers: { Authorization: `Bearer ${project.service_key}` },
+            body,
+            context: "updating function",
+        });
+    }
+}
+//# sourceMappingURL=functions.js.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * Request and response types for the `functions` namespace.
+ * Maps to `/projects/v1/admin/:id/functions*` and `/functions/v1/:name`.
+ */
+export interface FunctionConfig {
+    /** Timeout in seconds. Tier limits apply. */
+    timeout?: number;
+    /** Memory in MB. Tier limits apply. */
+    memory?: number;
+}
+export interface FunctionDeployOptions {
+    /** Function name — URL-safe slug, used in the invoke path. */
+    name: string;
+    /** Source code. TypeScript or JavaScript. Must `export default async (req: Request) => Response`. */
+    code: string;
+    config?: FunctionConfig;
+    /** Additional npm packages to bundle with the function (beyond the pre-bundled set). */
+    deps?: string[];
+    /** Cron schedule (5-field). Omit to deploy without a schedule. */
+    schedule?: string | null;
+}
+export interface FunctionDeployResult {
+    name: string;
+    url: string;
+    status: string;
+    runtime: string;
+    timeout: number;
+    memory: number;
+    schedule?: string | null;
+    created_at: string;
+}
+export interface FunctionInvokeOptions {
+    /** HTTP method. Default `POST`. */
+    method?: string;
+    /** Request body. Sent as JSON when an object, as-is when a string. */
+    body?: string | Record<string, unknown>;
+    /** Extra headers to forward. */
+    headers?: Record<string, string>;
+}
+export interface FunctionInvokeResult {
+    status: number;
+    /** Parsed JSON body if the response was JSON, otherwise the raw text. */
+    body: unknown;
+    /** Wall-clock duration in milliseconds. */
+    duration_ms: number;
+}
+export interface FunctionLogEntry {
+    timestamp: string;
+    message: string;
+}
+export interface FunctionLogsOptions {
+    /** Number of log lines. Server clamps to 200. Default 50. */
+    tail?: number;
+    /** Only return logs at or after this ISO 8601 timestamp. */
+    since?: string;
+}
+export interface FunctionLogsResult {
+    logs: FunctionLogEntry[];
+}
+export interface FunctionScheduleMeta {
+    last_run_at?: string;
+    last_status?: number;
+    next_run_at?: string;
+    run_count?: number;
+    last_error?: string | null;
+}
+export interface FunctionSummary {
+    name: string;
+    url: string;
+    runtime: string;
+    timeout: number;
+    memory: number;
+    schedule?: string | null;
+    schedule_meta?: FunctionScheduleMeta | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface FunctionListResult {
+    functions: FunctionSummary[];
+}
+export interface FunctionUpdateOptions {
+    /** Pass `null` to remove an existing schedule. `undefined` leaves the schedule unchanged. */
+    schedule?: string | null;
+    timeout?: number;
+    memory?: number;
+}
+export interface FunctionUpdateResult {
+    name: string;
+    runtime: string;
+    timeout: number;
+    memory: number;
+    schedule: string | null;
+    schedule_meta: Record<string, unknown> | null;
+    updated_at: string;
+}
+//# sourceMappingURL=functions.types.d.ts.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Request and response types for the `functions` namespace.
+ * Maps to `/projects/v1/admin/:id/functions*` and `/functions/v1/:name`.
+ */
+export {};
+//# sourceMappingURL=functions.types.js.map

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

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