run402-mcp 3.8.3 → 4.0.1

package/sdk/dist/namespaces/domains.js

@@ -1,89 +1,134 @@
 /**
- * `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.
+ * `domains` namespace — ProjectDomain lifecycle.
+ *
+ * Domain operations are project-scoped control-plane actions. They use the
+ * SDK credential provider's server auth (SIWX, control-plane session, or
+ * delegate) and deliberately do not require local project-key cache entries.
  */
-import { deprecatePositional } from "../deprecate.js";
-import { requireProjectCredentials } from "../project-credentials.js";
-function withProjectId(path, projectId) {
-    const sep = path.includes("?") ? "&" : "?";
-    return `${path}${sep}project_id=${encodeURIComponent(projectId)}`;
+import { LocalError } from "../errors.js";
+function domainPath(projectId, domain) {
+    return `/projects/v1/${encodeURIComponent(projectId)}/domains/${encodeURIComponent(domain)}`;
+}
+function authMeta(method, projectId) {
+    return { method, target: { project_id: projectId } };
+}
+function removed(command, replacement) {
+    throw new LocalError(`${command} has been removed. Use ${replacement}.`, command, {
+        code: "COMMAND_REMOVED",
+        details: { command, replacement },
+        next_actions: [{ type: "use_replacement_command", command: replacement }],
+    });
+}
+function waitSatisfied(domain, until) {
+    if (until === "active")
+        return domain.status === "active";
+    if (until === "receive-active") {
+        const email = domain.effective.email;
+        return email?.receive?.active === true;
+    }
+    return domain.checks.every((check) => !check.blocking || check.status === "passed");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }
 export class Domains {
     client;
     constructor(client) {
         this.client = client;
     }
-    async add(projectId, domainOrOpts, subdomainName) {
-        let domain;
-        let subdomain;
-        let authMode;
-        if (typeof domainOrOpts === "object" && domainOrOpts !== null) {
-            domain = domainOrOpts.domain;
-            subdomain = domainOrOpts.subdomainName;
-            authMode = domainOrOpts.authMode;
-        }
-        else {
-            deprecatePositional("domains.add", "use add(projectId, { domain, subdomainName })");
-            domain = domainOrOpts;
-            subdomain = subdomainName;
-        }
-        if (authMode === "service_key") {
-            const project = await requireProjectCredentials(this.client, projectId, "registering custom domain");
-            return this.client.request("/domains/v1", {
-                method: "POST",
-                headers: { Authorization: `Bearer ${project.service_key}` },
-                body: { domain, subdomain_name: subdomain },
-                context: "registering custom domain",
-            });
-        }
-        return this.client.request("/domains/v1", {
+    async ensure(projectId, domain, opts) {
+        return this.client.request(domainPath(projectId, domain), {
+            method: "PUT",
+            body: { desired: opts.desired },
+            authMeta: authMeta("domains.ensure", projectId),
+            context: "ensuring project domain",
+        });
+    }
+    async get(projectId, domain) {
+        return this.client.request(domainPath(projectId, domain), {
+            authMeta: authMeta("domains.get", projectId),
+            context: "getting project domain",
+        });
+    }
+    async list(projectId) {
+        return this.client.request(`/projects/v1/${encodeURIComponent(projectId)}/domains`, {
+            authMeta: authMeta("domains.list", projectId),
+            context: "listing project domains",
+        });
+    }
+    async check(projectId, domain) {
+        return this.client.request(`${domainPath(projectId, domain)}/actions/check`, {
             method: "POST",
-            body: { project_id: projectId, domain, subdomain_name: subdomain },
-            context: "registering custom domain",
+            authMeta: authMeta("domains.check", projectId),
+            context: "checking project domain",
         });
     }
-    /** List all custom domains registered for a project. */
-    async list(projectId, opts = {}) {
-        if (opts.authMode === "service_key") {
-            const project = await requireProjectCredentials(this.client, projectId, "listing custom domains");
-            return this.client.request("/domains/v1", {
-                headers: { Authorization: `Bearer ${project.service_key}` },
-                context: "listing custom domains",
-            });
-        }
-        return this.client.request(withProjectId("/domains/v1", projectId), {
-            context: "listing custom domains",
+    async apply(projectId, domain) {
+        return this.client.request(`${domainPath(projectId, domain)}/actions/apply`, {
+            method: "POST",
+            authMeta: authMeta("domains.apply", projectId),
+            context: "applying project domain",
         });
     }
-    /** Check verification/SSL status for a specific custom domain. */
-    async status(projectId, domain, opts = {}) {
-        if (opts.authMode === "service_key") {
-            const project = await requireProjectCredentials(this.client, projectId, "checking domain status");
-            return this.client.request(`/domains/v1/${encodeURIComponent(domain)}`, {
-                headers: { Authorization: `Bearer ${project.service_key}` },
-                context: "checking domain status",
-            });
-        }
-        return this.client.request(withProjectId(`/domains/v1/${encodeURIComponent(domain)}`, projectId), {
-            context: "checking domain status",
+    async repair(projectId, domain) {
+        return this.client.request(`${domainPath(projectId, domain)}/actions/repair`, {
+            method: "POST",
+            authMeta: authMeta("domains.repair", projectId),
+            context: "repairing project domain",
         });
     }
-    /** Release a custom domain. `projectId` is optional for ownership-free removal. */
-    async remove(domain, opts = {}) {
-        const headers = {};
-        if (opts.projectId && opts.authMode === "service_key") {
-            const project = await requireProjectCredentials(this.client, opts.projectId, "removing custom domain");
-            headers.Authorization = `Bearer ${project.service_key}`;
-        }
-        const path = opts.projectId && opts.authMode !== "service_key"
-            ? withProjectId(`/domains/v1/${encodeURIComponent(domain)}`, opts.projectId)
-            : `/domains/v1/${encodeURIComponent(domain)}`;
-        return this.client.request(path, {
+    async testReceive(projectId, domain, to) {
+        return this.client.request(`${domainPath(projectId, domain)}/actions/test_receive`, {
+            method: "POST",
+            body: { to },
+            authMeta: authMeta("domains.testReceive", projectId),
+            context: "creating project domain receive test",
+        });
+    }
+    async activate(projectId, domain) {
+        return this.client.request(`${domainPath(projectId, domain)}/actions/activate_mailbox_addresses`, {
+            method: "POST",
+            authMeta: authMeta("domains.activate", projectId),
+            context: "activating project domain mailbox addresses",
+        });
+    }
+    async disconnect(projectId, domain) {
+        return this.client.request(domainPath(projectId, domain), {
             method: "DELETE",
-            headers,
-            context: "removing custom domain",
+            authMeta: authMeta("domains.disconnect", projectId),
+            context: "disconnecting project domain",
         });
     }
+    async wait(projectId, domain, opts = {}) {
+        const until = opts.until ?? "active";
+        const timeoutMs = opts.timeoutMs ?? 120_000;
+        const intervalMs = opts.intervalMs ?? 5_000;
+        const started = Date.now();
+        let last = await this.check(projectId, domain);
+        while (!waitSatisfied(last, until)) {
+            if (Date.now() - started >= timeoutMs) {
+                throw new LocalError(`Timed out waiting for project domain ${domain} to reach ${until}`, "waiting for project domain", {
+                    code: "DOMAIN_WAIT_TIMEOUT",
+                    details: { project_id: projectId, domain, until, last_status: last.status, checks: last.checks },
+                    next_actions: [{ type: "check", command: `run402 domains check ${domain} --project ${projectId}` }],
+                });
+            }
+            await sleep(intervalMs);
+            last = await this.check(projectId, domain);
+        }
+        return last;
+    }
+    async add(projectId, domainOrOpts) {
+        const domain = typeof domainOrOpts === "string" ? domainOrOpts : domainOrOpts.domain;
+        return removed("domains.add", `run402 domains connect ${domain} --project ${projectId} --web`);
+    }
+    /** @deprecated Removed. Use get(projectId, domain). */
+    async status(projectId, domain) {
+        return removed("domains.status", `run402 domains status ${domain} --project ${projectId}`);
+    }
+    /** @deprecated Removed. Use disconnect(projectId, domain). */
+    async remove(domain, opts = {}) {
+        return removed("domains.remove", `run402 domains disconnect ${domain}${opts.projectId ? ` --project ${opts.projectId}` : ""} --confirm`);
+    }
 }
 //# sourceMappingURL=domains.js.map

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

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

package/sdk/dist/namespaces/sender-domain.d.ts

@@ -1,8 +1,11 @@
 /**
- * `senderDomain` namespace — custom email sending domains with DKIM
- * verification and optional inbound routing.
+ * `senderDomain` namespace — removed compatibility shim.
+ *
+ * Sender-domain APIs are now folded into the project-scoped ProjectDomain
+ * lifecycle under `domains`. Methods remain present so existing imports fail
+ * loudly and locally with a replacement path instead of calling retired
+ * `/email/v1/domains` endpoints.
  */
-import type { Client } from "../kernel.js";
 export interface DnsRecord {
     type: string;
     name: string;
@@ -27,19 +30,18 @@ export interface DisableInboundResult {
     status: string;
 }
 export declare class SenderDomain {
-    private readonly client;
     readonly inboundEnable: (projectId: string, domain: string) => Promise<InboundEnableResult>;
     readonly inboundDisable: (projectId: string, domain: string) => Promise<DisableInboundResult>;
-    constructor(client: Client);
-    /** Register a custom email sending domain. Returns DKIM + SPF/DMARC DNS records. */
+    constructor(_client: unknown);
+    /** @deprecated Use `domains.ensure(projectId, domain, { desired })`. */
     register(projectId: string, domain: string): Promise<SenderDomainRegisterResult>;
-    /** Get the project's current sender-domain registration state (polls SES). */
+    /** @deprecated Use `domains.list(projectId)` or `domains.get(projectId, domain)`. */
     status(projectId: string): Promise<SenderDomainStatusResult>;
-    /** Remove the custom sender domain; email reverts to each mailbox's managed address. */
+    /** @deprecated Use `domains.disconnect(projectId, domain)`. */
     remove(projectId: string): Promise<void>;
-    /** Enable inbound email on a verified custom sender domain. */
+    /** @deprecated Use `domains.ensure(..., { desired: { email: { receive: ... }}})`. */
     enableInbound(projectId: string, domain: string): Promise<InboundEnableResult>;
-    /** Disable inbound email for a custom sender domain. */
+    /** @deprecated Use `domains.ensure` with receive disabled or `domains.disconnect`. */
     disableInbound(projectId: string, domain: string): Promise<DisableInboundResult>;
 }
 //# sourceMappingURL=sender-domain.d.ts.map

package/sdk/dist/namespaces/sender-domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sender-domain.d.ts","sourceRoot":"","sources":["../../src/namespaces/sender-domain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5F,QAAQ,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;gBAEjE,MAAM,EAAE,MAAM;IAK3C,oFAAoF;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAWtF,8EAA8E;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IASlE,wFAAwF;IAClF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C,+DAA+D;IACzD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWpF,wDAAwD;IAClD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAUvF"}
+{"version":3,"file":"sender-domain.d.ts","sourceRoot":"","sources":["../../src/namespaces/sender-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5F,QAAQ,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;gBAElF,OAAO,EAAE,OAAO;IAK5B,wEAAwE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAOtF,qFAAqF;IAC/E,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOlE,+DAA+D;IACzD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,qFAAqF;IAC/E,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOpF,sFAAsF;IAChF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAMvF"}

package/sdk/dist/namespaces/sender-domain.js

@@ -1,63 +1,45 @@
 /**
- * `senderDomain` namespace — custom email sending domains with DKIM
- * verification and optional inbound routing.
+ * `senderDomain` namespace — removed compatibility shim.
+ *
+ * Sender-domain APIs are now folded into the project-scoped ProjectDomain
+ * lifecycle under `domains`. Methods remain present so existing imports fail
+ * loudly and locally with a replacement path instead of calling retired
+ * `/email/v1/domains` endpoints.
  */
-import { requireProjectCredentials } from "../project-credentials.js";
+import { LocalError } from "../errors.js";
 export class SenderDomain {
-    client;
     inboundEnable;
     inboundDisable;
-    constructor(client) {
-        this.client = client;
+    constructor(_client) {
         this.inboundEnable = this.enableInbound.bind(this);
         this.inboundDisable = this.disableInbound.bind(this);
     }
-    /** Register a custom email sending domain. Returns DKIM + SPF/DMARC DNS records. */
+    /** @deprecated Use `domains.ensure(projectId, domain, { desired })`. */
     async register(projectId, domain) {
-        const project = await requireProjectCredentials(this.client, projectId, "registering sender domain");
-        return this.client.request("/email/v1/domains", {
-            method: "POST",
-            headers: { Authorization: `Bearer ${project.service_key}` },
-            body: { domain },
-            context: "registering sender domain",
-        });
+        return removed("senderDomain.register", `run402 domains connect ${domain} --project ${projectId} --email-send`);
     }
-    /** Get the project's current sender-domain registration state (polls SES). */
+    /** @deprecated Use `domains.list(projectId)` or `domains.get(projectId, domain)`. */
     async status(projectId) {
-        const project = await requireProjectCredentials(this.client, projectId, "checking sender domain status");
-        return this.client.request("/email/v1/domains", {
-            headers: { Authorization: `Bearer ${project.service_key}` },
-            context: "checking sender domain status",
-        });
+        return removed("senderDomain.status", `run402 domains list --project ${projectId}`);
     }
-    /** Remove the custom sender domain; email reverts to each mailbox's managed address. */
+    /** @deprecated Use `domains.disconnect(projectId, domain)`. */
     async remove(projectId) {
-        const project = await requireProjectCredentials(this.client, projectId, "removing sender domain");
-        await this.client.request("/email/v1/domains", {
-            method: "DELETE",
-            headers: { Authorization: `Bearer ${project.service_key}` },
-            context: "removing sender domain",
-        });
+        return removed("senderDomain.remove", `run402 domains disconnect <domain> --project ${projectId} --confirm`);
     }
-    /** Enable inbound email on a verified custom sender domain. */
+    /** @deprecated Use `domains.ensure(..., { desired: { email: { receive: ... }}})`. */
     async enableInbound(projectId, domain) {
-        const project = await requireProjectCredentials(this.client, projectId, "enabling inbound email");
-        return this.client.request("/email/v1/domains/inbound", {
-            method: "POST",
-            headers: { Authorization: `Bearer ${project.service_key}` },
-            body: { domain },
-            context: "enabling inbound email",
-        });
+        return removed("senderDomain.enableInbound", `run402 domains connect ${domain} --project ${projectId} --email-receive`);
     }
-    /** Disable inbound email for a custom sender domain. */
+    /** @deprecated Use `domains.ensure` with receive disabled or `domains.disconnect`. */
     async disableInbound(projectId, domain) {
-        const project = await requireProjectCredentials(this.client, projectId, "disabling inbound email");
-        return this.client.request("/email/v1/domains/inbound", {
-            method: "DELETE",
-            headers: { Authorization: `Bearer ${project.service_key}` },
-            body: { domain },
-            context: "disabling inbound email",
-        });
+        return removed("senderDomain.disableInbound", `run402 domains disconnect ${domain} --project ${projectId} --confirm`);
     }
 }
+function removed(command, replacement) {
+    throw new LocalError(`${command} has been removed. Use ${replacement}.`, command, {
+        code: "COMMAND_REMOVED",
+        details: { command, replacement },
+        next_actions: [{ type: "use_replacement_command", command: replacement }],
+    });
+}
 //# sourceMappingURL=sender-domain.js.map

package/sdk/dist/namespaces/sender-domain.js.map

@@ -1 +1 @@
-{"version":3,"file":"sender-domain.js","sourceRoot":"","sources":["../../src/namespaces/sender-domain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AA8BtE,MAAM,OAAO,YAAY;IAIM;IAHpB,aAAa,CAAsE;IACnF,cAAc,CAAuE;IAE9F,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,MAAc;QAC9C,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC;QAErG,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA6B,mBAAmB,EAAE;YAC1E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,+BAA+B,CAAC,CAAC;QAEzG,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA2B,mBAAmB,EAAE;YACxE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,OAAO,EAAE,+BAA+B;SACzC,CAAC,CAAC;IACL,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAElG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,mBAAmB,EAAE;YACtD,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,OAAO,EAAE,wBAAwB;SAClC,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,MAAc;QACnD,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAElG,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAsB,2BAA2B,EAAE;YAC3E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,OAAO,EAAE,wBAAwB;SAClC,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,MAAc;QACpD,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;QAEnG,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAuB,2BAA2B,EAAE;YAC5E,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,EAAE;YAC3D,IAAI,EAAE,EAAE,MAAM,EAAE;YAChB,OAAO,EAAE,yBAAyB;SACnC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"sender-domain.js","sourceRoot":"","sources":["../../src/namespaces/sender-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8B1C,MAAM,OAAO,YAAY;IACd,aAAa,CAAsE;IACnF,cAAc,CAAuE;IAE9F,YAAY,OAAgB;QAC1B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,MAAc;QAC9C,OAAO,OAAO,CACZ,uBAAuB,EACvB,0BAA0B,MAAM,cAAc,SAAS,eAAe,CACvE,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,OAAO,OAAO,CACZ,qBAAqB,EACrB,iCAAiC,SAAS,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,OAAO,OAAO,CACZ,qBAAqB,EACrB,gDAAgD,SAAS,YAAY,CACtE,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,MAAc;QACnD,OAAO,OAAO,CACZ,4BAA4B,EAC5B,0BAA0B,MAAM,cAAc,SAAS,kBAAkB,CAC1E,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,MAAc;QACpD,OAAO,OAAO,CACZ,6BAA6B,EAC7B,6BAA6B,MAAM,cAAc,SAAS,YAAY,CACvE,CAAC;IACJ,CAAC;CACF;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,WAAmB;IACnD,MAAM,IAAI,UAAU,CAClB,GAAG,OAAO,0BAA0B,WAAW,GAAG,EAClD,OAAO,EACP;QACE,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;QACjC,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;KAC1E,CACF,CAAC;AACJ,CAAC"}

package/sdk/dist/node/deploy-manifest.d.ts

@@ -21,8 +21,7 @@ export type DeployManifestFileEntry = ContentSource | {
     content_type?: string;
 };
 export type DeployManifestFileSet = Record<string, DeployManifestFileEntry>;
-export interface DeployManifestMigrationSpec {
-    id: string;
+interface DeployManifestMigrationBaseSpec {
     checksum?: string;
     sql?: string;
     sql_ref?: ContentRef;
@@ -30,6 +29,18 @@ export interface DeployManifestMigrationSpec {
     sql_file?: string;
     transaction?: "required" | "none";
 }
+export interface DeployManifestVersionedMigrationSpec extends DeployManifestMigrationBaseSpec {
+    id: string;
+    name?: never;
+}
+export interface DeployManifestContentTrackedMigrationSpec extends DeployManifestMigrationBaseSpec {
+    /** Content-tracked migration name. The SDK compiles this to
+     *  `<name>_<sha256(sql)[0:16]>`; SQL MUST be idempotent because changed
+     *  content applies again against a database with prior versions. */
+    name: string;
+    id?: never;
+}
+export type DeployManifestMigrationSpec = DeployManifestVersionedMigrationSpec | DeployManifestContentTrackedMigrationSpec;
 export interface DeployManifestDatabaseSpec {
     migrations?: DeployManifestMigrationSpec[];
     expose?: DatabaseSpec["expose"];
@@ -135,4 +146,5 @@ export interface NormalizedDeployManifest {
 export declare function loadDeployManifest(path: string, opts?: LoadDeployManifestOptions): Promise<NormalizedDeployManifest>;
 export declare function loadExecutableDeployConfig(path: string, opts?: LoadExecutableDeployConfigOptions): Promise<Run402ReleaseConfig>;
 export declare function normalizeDeployManifest(input: DeployManifestInput, opts?: NormalizeDeployManifestOptions): Promise<NormalizedDeployManifest>;
+export {};
 //# sourceMappingURL=deploy-manifest.d.ts.map

package/sdk/dist/node/deploy-manifest.d.ts.map

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

package/sdk/dist/node/deploy-manifest.js

@@ -38,6 +38,7 @@ const MANIFEST_I18N_FIELDS = new Set([
 const MANIFEST_DATABASE_FIELDS = new Set(["migrations", "expose", "zero_downtime"]);
 const MANIFEST_MIGRATION_FIELDS = new Set([
     "id",
+    "name",
     "checksum",
     "sql",
     "sql_ref",
@@ -104,6 +105,7 @@ const TYPESCRIPT_MANIFEST_EXTENSIONS = new Set([".ts", ".mts", ".cts"]);
 const TYPESCRIPT_FUNCTION_EXTENSIONS = new Set([".ts", ".tsx", ".mts", ".cts"]);
 const EXECUTABLE_CONFIG_TIMEOUT_MS = 5_000;
 const EXECUTABLE_CONFIG_METADATA = Symbol("run402.executableConfigMetadata");
+const MIGRATION_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
 export async function loadDeployManifest(path, opts = {}) {
     const manifestPath = isAbsolute(path) ? path : resolvePath(process.cwd(), path);
     const extension = extname(manifestPath).toLowerCase();
@@ -342,18 +344,43 @@ async function mapDatabase(database, opts) {
             throw new LocalError("Deploy manifest database.migrations must be an array", CONTEXT);
         }
         out.migrations = [];
-        for (const migration of raw.migrations) {
-            out.migrations.push(await mapMigration(migration, opts));
+        const seenNames = new Map();
+        for (const [index, migration] of raw.migrations.entries()) {
+            out.migrations.push(await mapMigration(migration, opts, index, seenNames));
         }
     }
     return out;
 }
-async function mapMigration(migration, opts) {
+async function mapMigration(migration, opts, index, seenNames) {
     assertPlainRecord(migration, "Deploy manifest database.migrations[]");
     assertKnownFields(migration, "Deploy manifest database.migrations[]", MANIFEST_MIGRATION_FIELDS);
-    const out = {
-        id: migration.id,
-    };
+    const hasId = Object.prototype.hasOwnProperty.call(migration, "id") && migration.id !== undefined;
+    const hasName = Object.prototype.hasOwnProperty.call(migration, "name") && migration.name !== undefined;
+    const label = migrationLabel(migration, index);
+    if (hasId && hasName) {
+        throw new LocalError(`${label} declares both id and name; use exactly one`, CONTEXT);
+    }
+    if (!hasId && !hasName) {
+        throw new LocalError(`${label} must declare exactly one of id or name`, CONTEXT);
+    }
+    let out;
+    if (hasName) {
+        if (typeof migration.name !== "string" || !MIGRATION_NAME_RE.test(migration.name)) {
+            throw new LocalError(`${label}.name must match /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/`, CONTEXT);
+        }
+        const firstIndex = seenNames.get(migration.name);
+        if (firstIndex !== undefined) {
+            throw new LocalError(`${label}.name duplicates database.migrations[${firstIndex}].name ${JSON.stringify(migration.name)}`, CONTEXT);
+        }
+        seenNames.set(migration.name, index);
+        out = { name: migration.name };
+    }
+    else {
+        if (typeof migration.id !== "string" || migration.id.trim() === "") {
+            throw new LocalError(`${label}.id must be a non-empty string`, CONTEXT);
+        }
+        out = { id: migration.id };
+    }
     if (migration.sql !== undefined)
         out.sql = migration.sql;
     if (migration.sql_ref !== undefined)
@@ -366,7 +393,7 @@ async function mapMigration(migration, opts) {
     if (migration.sql_path !== undefined &&
         migration.sql_file !== undefined &&
         migration.sql_path !== migration.sql_file) {
-        throw new LocalError(`Migration ${migration.id} has both sql_path and sql_file with different values`, CONTEXT);
+        throw new LocalError(`${label} has both sql_path and sql_file with different values`, CONTEXT);
     }
     if (out.sql === undefined && sqlPath !== undefined) {
         const field = migration.sql_path !== undefined ? "sql_path" : "sql_file";
@@ -375,11 +402,21 @@ async function mapMigration(migration, opts) {
             out.sql = await readFile(abs, "utf-8");
         }
         catch (err) {
-            throw new LocalError(`Failed to read migration ${field} '${sqlPath}': ${err.message}`, CONTEXT, err);
+            throw new LocalError(`Failed to read migration ${field} '${sqlPath}' for ${label}: ${err.message}`, CONTEXT, err);
         }
     }
     return out;
 }
+function migrationLabel(migration, index) {
+    const identity = typeof migration.id === "string"
+        ? migration.id
+        : typeof migration.name === "string"
+            ? migration.name
+            : null;
+    return identity
+        ? `Deploy manifest database.migrations[${index}] (${identity})`
+        : `Deploy manifest database.migrations[${index}]`;
+}
 function mapFunctions(functions, opts) {
     assertPlainRecord(functions, "Deploy manifest functions");
     assertKnownFields(functions, "Deploy manifest functions", MANIFEST_FUNCTIONS_FIELDS);