@sylphx/contract 0.2.0

package/dist/endpoints/domains.d.ts

@@ -0,0 +1,356 @@
+/**
+ * Domains endpoints — apex domain + hostname bindings + optional DKIM/SMTP
+ * email delivery. Production mounts at `/projects/:projectId/domains/*`
+ * (ADR-084 Wave 2b). Widened to cover the full surface in
+ * `apps/api/src/server/platform/routes/domains.ts`.
+ */
+import { Schema } from 'effect';
+export declare const domainsEndpoints: {
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/projects/:projectId/domains", Schema.Struct<{
+        projectId: typeof Schema.String;
+    }>, Schema.Struct<{
+        envType: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Array$<Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        apexDomain: typeof Schema.String;
+        hostnames: Schema.Array$<Schema.Struct<{
+            id: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+            domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+            hostname: typeof Schema.String;
+            isPrimary: typeof Schema.Boolean;
+            redirectTo: Schema.NullOr<typeof Schema.String>;
+            dnsStatus: Schema.Literal<["pending", "active", "error"]>;
+            instruction: Schema.Struct<{
+                type: Schema.Literal<["A", "CNAME"]>;
+                name: typeof Schema.String;
+                value: typeof Schema.String;
+                ttl: typeof Schema.Number;
+            }>;
+            verifiedAt: Schema.NullOr<typeof Schema.String>;
+            lastCheckError: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+        }>>;
+        email: Schema.NullOr<Schema.Struct<{
+            id: typeof Schema.String;
+            domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+            dnsStatus: Schema.Literal<["pending", "verifying", "verified", "failed"]>;
+            stalwartLoaded: typeof Schema.Boolean;
+            defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+            defaultFromName: Schema.NullOr<typeof Schema.String>;
+            records: Schema.Array$<Schema.Struct<{
+                type: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+                name: typeof Schema.String;
+                value: typeof Schema.String;
+                priority: Schema.optional<typeof Schema.Number>;
+                ttl: typeof Schema.Number;
+                status: Schema.optional<Schema.Literal<["pending", "verified"]>>;
+                description: Schema.optional<typeof Schema.String>;
+            }>>;
+            verifiedAt: Schema.NullOr<typeof Schema.String>;
+            verificationError: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+            smtpEnabled: Schema.optional<typeof Schema.Boolean>;
+            smtpUsername: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        }>>;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>>;
+    readonly create: import("../endpoint.js").Endpoint<"POST", "/projects/:projectId/domains", Schema.Struct<{
+        projectId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        apexDomain: typeof Schema.String;
+        envType: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        apexDomain: typeof Schema.String;
+        hostnames: Schema.Array$<Schema.Struct<{
+            id: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+            domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+            hostname: typeof Schema.String;
+            isPrimary: typeof Schema.Boolean;
+            redirectTo: Schema.NullOr<typeof Schema.String>;
+            dnsStatus: Schema.Literal<["pending", "active", "error"]>;
+            instruction: Schema.Struct<{
+                type: Schema.Literal<["A", "CNAME"]>;
+                name: typeof Schema.String;
+                value: typeof Schema.String;
+                ttl: typeof Schema.Number;
+            }>;
+            verifiedAt: Schema.NullOr<typeof Schema.String>;
+            lastCheckError: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+        }>>;
+        email: Schema.NullOr<Schema.Struct<{
+            id: typeof Schema.String;
+            domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+            dnsStatus: Schema.Literal<["pending", "verifying", "verified", "failed"]>;
+            stalwartLoaded: typeof Schema.Boolean;
+            defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+            defaultFromName: Schema.NullOr<typeof Schema.String>;
+            records: Schema.Array$<Schema.Struct<{
+                type: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+                name: typeof Schema.String;
+                value: typeof Schema.String;
+                priority: Schema.optional<typeof Schema.Number>;
+                ttl: typeof Schema.Number;
+                status: Schema.optional<Schema.Literal<["pending", "verified"]>>;
+                description: Schema.optional<typeof Schema.String>;
+            }>>;
+            verifiedAt: Schema.NullOr<typeof Schema.String>;
+            verificationError: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+            smtpEnabled: Schema.optional<typeof Schema.Boolean>;
+            smtpUsername: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        }>>;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/projects/:projectId/domains/:domainId", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        apexDomain: typeof Schema.String;
+        hostnames: Schema.Array$<Schema.Struct<{
+            id: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+            domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+            hostname: typeof Schema.String;
+            isPrimary: typeof Schema.Boolean;
+            redirectTo: Schema.NullOr<typeof Schema.String>;
+            dnsStatus: Schema.Literal<["pending", "active", "error"]>;
+            instruction: Schema.Struct<{
+                type: Schema.Literal<["A", "CNAME"]>;
+                name: typeof Schema.String;
+                value: typeof Schema.String;
+                ttl: typeof Schema.Number;
+            }>;
+            verifiedAt: Schema.NullOr<typeof Schema.String>;
+            lastCheckError: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+        }>>;
+        email: Schema.NullOr<Schema.Struct<{
+            id: typeof Schema.String;
+            domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+            dnsStatus: Schema.Literal<["pending", "verifying", "verified", "failed"]>;
+            stalwartLoaded: typeof Schema.Boolean;
+            defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+            defaultFromName: Schema.NullOr<typeof Schema.String>;
+            records: Schema.Array$<Schema.Struct<{
+                type: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+                name: typeof Schema.String;
+                value: typeof Schema.String;
+                priority: Schema.optional<typeof Schema.Number>;
+                ttl: typeof Schema.Number;
+                status: Schema.optional<Schema.Literal<["pending", "verified"]>>;
+                description: Schema.optional<typeof Schema.String>;
+            }>>;
+            verifiedAt: Schema.NullOr<typeof Schema.String>;
+            verificationError: Schema.NullOr<typeof Schema.String>;
+            createdAt: typeof Schema.String;
+            smtpEnabled: Schema.optional<typeof Schema.Boolean>;
+            smtpUsername: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+        }>>;
+        createdAt: typeof Schema.String;
+        updatedAt: typeof Schema.String;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/projects/:projectId/domains/:domainId", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.optional<typeof Schema.Boolean>;
+    }>>;
+    readonly addHostname: import("../endpoint.js").Endpoint<"POST", "/projects/:projectId/domains/:domainId/hostnames", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Struct<{
+        envType: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        hostname: typeof Schema.String;
+        serviceId: Schema.optional<typeof Schema.String>;
+        isPrimary: Schema.optional<typeof Schema.Boolean>;
+        redirectTo: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+        domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        hostname: typeof Schema.String;
+        isPrimary: typeof Schema.Boolean;
+        redirectTo: Schema.NullOr<typeof Schema.String>;
+        dnsStatus: Schema.Literal<["pending", "active", "error"]>;
+        instruction: Schema.Struct<{
+            type: Schema.Literal<["A", "CNAME"]>;
+            name: typeof Schema.String;
+            value: typeof Schema.String;
+            ttl: typeof Schema.Number;
+        }>;
+        verifiedAt: Schema.NullOr<typeof Schema.String>;
+        lastCheckError: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>>;
+    readonly updateHostname: import("../endpoint.js").Endpoint<"PATCH", "/projects/:projectId/domains/:domainId/hostnames/:hostnameId", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+        hostnameId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        isPrimary: Schema.optional<typeof Schema.Boolean>;
+        redirectTo: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>, Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+        domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        hostname: typeof Schema.String;
+        isPrimary: typeof Schema.Boolean;
+        redirectTo: Schema.NullOr<typeof Schema.String>;
+        dnsStatus: Schema.Literal<["pending", "active", "error"]>;
+        instruction: Schema.Struct<{
+            type: Schema.Literal<["A", "CNAME"]>;
+            name: typeof Schema.String;
+            value: typeof Schema.String;
+            ttl: typeof Schema.Number;
+        }>;
+        verifiedAt: Schema.NullOr<typeof Schema.String>;
+        lastCheckError: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>>;
+    readonly removeHostname: import("../endpoint.js").Endpoint<"DELETE", "/projects/:projectId/domains/:domainId/hostnames/:hostnameId", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+        hostnameId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.optional<typeof Schema.Boolean>;
+    }>>;
+    readonly checkHostname: import("../endpoint.js").Endpoint<"POST", "/projects/:projectId/domains/:domainId/hostnames/:hostnameId/check", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+        hostnameId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+        domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        hostname: typeof Schema.String;
+        isPrimary: typeof Schema.Boolean;
+        redirectTo: Schema.NullOr<typeof Schema.String>;
+        dnsStatus: Schema.Literal<["pending", "active", "error"]>;
+        instruction: Schema.Struct<{
+            type: Schema.Literal<["A", "CNAME"]>;
+            name: typeof Schema.String;
+            value: typeof Schema.String;
+            ttl: typeof Schema.Number;
+        }>;
+        verifiedAt: Schema.NullOr<typeof Schema.String>;
+        lastCheckError: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+    }>>;
+    readonly enableEmail: import("../endpoint.js").Endpoint<"POST", "/projects/:projectId/domains/:domainId/email", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        defaultFromEmail: Schema.optional<typeof Schema.String>;
+        defaultFromName: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        id: typeof Schema.String;
+        domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        dnsStatus: Schema.Literal<["pending", "verifying", "verified", "failed"]>;
+        stalwartLoaded: typeof Schema.Boolean;
+        defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+        defaultFromName: Schema.NullOr<typeof Schema.String>;
+        records: Schema.Array$<Schema.Struct<{
+            type: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+            name: typeof Schema.String;
+            value: typeof Schema.String;
+            priority: Schema.optional<typeof Schema.Number>;
+            ttl: typeof Schema.Number;
+            status: Schema.optional<Schema.Literal<["pending", "verified"]>>;
+            description: Schema.optional<typeof Schema.String>;
+        }>>;
+        verifiedAt: Schema.NullOr<typeof Schema.String>;
+        verificationError: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+        smtpEnabled: Schema.optional<typeof Schema.Boolean>;
+        smtpUsername: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>;
+    readonly getEmail: import("../endpoint.js").Endpoint<"GET", "/projects/:projectId/domains/:domainId/email", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        dnsStatus: Schema.Literal<["pending", "verifying", "verified", "failed"]>;
+        stalwartLoaded: typeof Schema.Boolean;
+        defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+        defaultFromName: Schema.NullOr<typeof Schema.String>;
+        records: Schema.Array$<Schema.Struct<{
+            type: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+            name: typeof Schema.String;
+            value: typeof Schema.String;
+            priority: Schema.optional<typeof Schema.Number>;
+            ttl: typeof Schema.Number;
+            status: Schema.optional<Schema.Literal<["pending", "verified"]>>;
+            description: Schema.optional<typeof Schema.String>;
+        }>>;
+        verifiedAt: Schema.NullOr<typeof Schema.String>;
+        verificationError: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+        smtpEnabled: Schema.optional<typeof Schema.Boolean>;
+        smtpUsername: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>;
+    readonly disableEmail: import("../endpoint.js").Endpoint<"DELETE", "/projects/:projectId/domains/:domainId/email", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.optional<typeof Schema.Boolean>;
+    }>>;
+    readonly checkEmail: import("../endpoint.js").Endpoint<"POST", "/projects/:projectId/domains/:domainId/email/check", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        domainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+        dnsStatus: Schema.Literal<["pending", "verifying", "verified", "failed"]>;
+        stalwartLoaded: typeof Schema.Boolean;
+        defaultFromEmail: Schema.NullOr<typeof Schema.String>;
+        defaultFromName: Schema.NullOr<typeof Schema.String>;
+        records: Schema.Array$<Schema.Struct<{
+            type: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+            name: typeof Schema.String;
+            value: typeof Schema.String;
+            priority: Schema.optional<typeof Schema.Number>;
+            ttl: typeof Schema.Number;
+            status: Schema.optional<Schema.Literal<["pending", "verified"]>>;
+            description: Schema.optional<typeof Schema.String>;
+        }>>;
+        verifiedAt: Schema.NullOr<typeof Schema.String>;
+        verificationError: Schema.NullOr<typeof Schema.String>;
+        createdAt: typeof Schema.String;
+        smtpEnabled: Schema.optional<typeof Schema.Boolean>;
+        smtpUsername: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    }>>;
+    readonly getSmtpCredentials: import("../endpoint.js").Endpoint<"GET", "/projects/:projectId/domains/:domainId/email/smtp", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.NullOr<Schema.Struct<{
+        enabled: typeof Schema.Boolean;
+        host: typeof Schema.String;
+        port: typeof Schema.Number;
+        portTls: typeof Schema.Number;
+        username: Schema.NullOr<typeof Schema.String>;
+        passwordHint: typeof Schema.String;
+    }>>>;
+    readonly enableSmtp: import("../endpoint.js").Endpoint<"POST", "/projects/:projectId/domains/:domainId/email/smtp", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        apiKey: typeof Schema.String;
+    }>, Schema.Struct<{
+        enabled: typeof Schema.Boolean;
+        host: typeof Schema.String;
+        port: typeof Schema.Number;
+        portTls: typeof Schema.Number;
+        username: Schema.NullOr<typeof Schema.String>;
+        passwordHint: typeof Schema.String;
+    }>>;
+    readonly disableSmtp: import("../endpoint.js").Endpoint<"DELETE", "/projects/:projectId/domains/:domainId/email/smtp", Schema.Struct<{
+        projectId: typeof Schema.String;
+        domainId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        success: Schema.optional<typeof Schema.Boolean>;
+    }>>;
+};
+//# sourceMappingURL=domains.d.ts.map

package/dist/endpoints/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/endpoints/domains.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAuB/B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsInB,CAAA"}

package/dist/endpoints/domains.js

@@ -0,0 +1,149 @@
+/**
+ * Domains endpoints — apex domain + hostname bindings + optional DKIM/SMTP
+ * email delivery. Production mounts at `/projects/:projectId/domains/*`
+ * (ADR-084 Wave 2b). Widened to cover the full surface in
+ * `apps/api/src/server/platform/routes/domains.ts`.
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { AddHostnameInput, CreateDomainInput, Domain, DomainEmailBinding, DomainHostname, EnableEmailInput, EnableSmtpInput, SmtpCredentials, UpdateHostnameInput, } from '../schemas/domain.js';
+const ProjectPath = Schema.Struct({ projectId: Schema.String });
+const DomainPath = Schema.Struct({ projectId: Schema.String, domainId: Schema.String });
+const HostnamePath = Schema.Struct({
+    projectId: Schema.String,
+    domainId: Schema.String,
+    hostnameId: Schema.String,
+});
+const EnvTypeQuery = Schema.Struct({ envType: Schema.optional(Schema.String) });
+export const domainsEndpoints = {
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:projectId/domains',
+        params: ProjectPath,
+        query: EnvTypeQuery,
+        response: Schema.Array(Domain),
+        summary: 'List apex domains registered on a project',
+        tags: ['domains'],
+    }),
+    create: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:projectId/domains',
+        params: ProjectPath,
+        body: CreateDomainInput,
+        response: Domain,
+        summary: 'Register a new apex domain on a project',
+        tags: ['domains'],
+    }),
+    get: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:projectId/domains/:domainId',
+        params: DomainPath,
+        response: Domain,
+        summary: 'Get a domain with all its bindings',
+        tags: ['domains'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/projects/:projectId/domains/:domainId',
+        params: DomainPath,
+        response: Schema.Struct({ success: Schema.optional(Schema.Boolean) }),
+        summary: 'Remove a domain and all its bindings',
+        tags: ['domains'],
+    }),
+    // ── Hostname bindings ─────────────────────────────────────────────
+    addHostname: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:projectId/domains/:domainId/hostnames',
+        params: DomainPath,
+        query: EnvTypeQuery,
+        body: AddHostnameInput,
+        response: DomainHostname,
+        summary: 'Add a hostname under an apex domain',
+        tags: ['domains'],
+    }),
+    updateHostname: defineEndpoint({
+        method: 'PATCH',
+        path: '/projects/:projectId/domains/:domainId/hostnames/:hostnameId',
+        params: HostnamePath,
+        body: UpdateHostnameInput,
+        response: DomainHostname,
+        summary: 'Update hostname (primary flag, redirect)',
+        tags: ['domains'],
+    }),
+    removeHostname: defineEndpoint({
+        method: 'DELETE',
+        path: '/projects/:projectId/domains/:domainId/hostnames/:hostnameId',
+        params: HostnamePath,
+        response: Schema.Struct({ success: Schema.optional(Schema.Boolean) }),
+        summary: 'Remove a hostname binding',
+        tags: ['domains'],
+    }),
+    checkHostname: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:projectId/domains/:domainId/hostnames/:hostnameId/check',
+        params: HostnamePath,
+        response: DomainHostname,
+        summary: 'Manually trigger DNS check for a hostname',
+        tags: ['domains'],
+    }),
+    // ── Email (DKIM) ───────────────────────────────────────────────────
+    enableEmail: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:projectId/domains/:domainId/email',
+        params: DomainPath,
+        body: EnableEmailInput,
+        response: DomainEmailBinding,
+        summary: 'Enable email sending for a domain (creates DKIM binding)',
+        tags: ['domains'],
+    }),
+    getEmail: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:projectId/domains/:domainId/email',
+        params: DomainPath,
+        response: DomainEmailBinding,
+        summary: 'Get email binding status + DKIM DNS records',
+        tags: ['domains'],
+    }),
+    disableEmail: defineEndpoint({
+        method: 'DELETE',
+        path: '/projects/:projectId/domains/:domainId/email',
+        params: DomainPath,
+        response: Schema.Struct({ success: Schema.optional(Schema.Boolean) }),
+        summary: 'Disable email sending for a domain',
+        tags: ['domains'],
+    }),
+    checkEmail: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:projectId/domains/:domainId/email/check',
+        params: DomainPath,
+        response: DomainEmailBinding,
+        summary: 'Check DKIM DNS propagation + load into Stalwart',
+        tags: ['domains'],
+    }),
+    // ── SMTP relay ─────────────────────────────────────────────────────
+    getSmtpCredentials: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:projectId/domains/:domainId/email/smtp',
+        params: DomainPath,
+        response: Schema.NullOr(SmtpCredentials),
+        summary: 'Get SMTP relay credentials (null when not enabled)',
+        tags: ['domains'],
+    }),
+    enableSmtp: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:projectId/domains/:domainId/email/smtp',
+        params: DomainPath,
+        body: EnableSmtpInput,
+        response: SmtpCredentials,
+        summary: 'Enable SMTP relay (domain email must be verified)',
+        tags: ['domains'],
+    }),
+    disableSmtp: defineEndpoint({
+        method: 'DELETE',
+        path: '/projects/:projectId/domains/:domainId/email/smtp',
+        params: DomainPath,
+        response: Schema.Struct({ success: Schema.optional(Schema.Boolean) }),
+        summary: 'Disable SMTP relay',
+        tags: ['domains'],
+    }),
+};

package/dist/endpoints/edge-deployments.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Edge Deployment endpoints — customer edge Workers, Management plane.
+ *
+ * Mount: `/projects/:id/edge-deployments` (see
+ * `apps/api/src/server/platform/routes/edge-deployments.ts`). Scaffold stage:
+ * handlers accept the upload and log "CF Workers API integration pending".
+ *
+ * Design reference: `docs/design/edge-functions-isr-image-opt.md` § 3.1 + § 6.
+ */
+import { Schema } from 'effect';
+export declare const edgeDeploymentsEndpoints: {
+    readonly create: import("../endpoint.js").Endpoint<"POST", "/projects/:id/edge-deployments", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        environmentId: typeof Schema.String;
+        bundle: typeof Schema.String;
+        routes: Schema.optional<Schema.Array$<Schema.Struct<{
+            method: Schema.Literal<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "*"]>;
+            path: Schema.filter<typeof Schema.String>;
+        }>>>;
+        label: Schema.optional<typeof Schema.String>;
+    }>, Schema.Struct<{
+        deployment: Schema.Struct<{
+            id: typeof Schema.String;
+            projectId: typeof Schema.String;
+            environmentId: typeof Schema.String;
+            workerName: typeof Schema.String;
+            version: typeof Schema.String;
+            routes: Schema.Array$<Schema.Struct<{
+                method: Schema.Literal<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "*"]>;
+                path: Schema.filter<typeof Schema.String>;
+            }>>;
+            status: Schema.Literal<["pending", "deploying", "active", "failed", "retired"]>;
+            error: Schema.NullOr<typeof Schema.String>;
+            bundleSizeBytes: typeof Schema.Number;
+            deployedBy: typeof Schema.String;
+            deployedAt: typeof Schema.String;
+        }>;
+    }>>;
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/projects/:id/edge-deployments", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Struct<{
+        environmentId: Schema.optional<typeof Schema.String>;
+        status: Schema.optional<Schema.Literal<["pending", "deploying", "active", "failed", "retired"]>>;
+        limit: Schema.optional<typeof Schema.String>;
+        offset: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        deployments: Schema.Array$<Schema.Struct<{
+            id: typeof Schema.String;
+            projectId: typeof Schema.String;
+            environmentId: typeof Schema.String;
+            workerName: typeof Schema.String;
+            version: typeof Schema.String;
+            routes: Schema.Array$<Schema.Struct<{
+                method: Schema.Literal<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "*"]>;
+                path: Schema.filter<typeof Schema.String>;
+            }>>;
+            status: Schema.Literal<["pending", "deploying", "active", "failed", "retired"]>;
+            error: Schema.NullOr<typeof Schema.String>;
+            bundleSizeBytes: typeof Schema.Number;
+            deployedBy: typeof Schema.String;
+            deployedAt: typeof Schema.String;
+        }>>;
+        total: typeof Schema.Number;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/projects/:id/edge-deployments/:deploymentId", Schema.Struct<{
+        id: typeof Schema.String;
+        deploymentId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        id: typeof Schema.String;
+        projectId: typeof Schema.String;
+        environmentId: typeof Schema.String;
+        workerName: typeof Schema.String;
+        version: typeof Schema.String;
+        routes: Schema.Array$<Schema.Struct<{
+            method: Schema.Literal<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "*"]>;
+            path: Schema.filter<typeof Schema.String>;
+        }>>;
+        status: Schema.Literal<["pending", "deploying", "active", "failed", "retired"]>;
+        error: Schema.NullOr<typeof Schema.String>;
+        bundleSizeBytes: typeof Schema.Number;
+        deployedBy: typeof Schema.String;
+        deployedAt: typeof Schema.String;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/projects/:id/edge-deployments/:deploymentId", Schema.Struct<{
+        id: typeof Schema.String;
+        deploymentId: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        deleted: typeof Schema.Boolean;
+    }>>;
+};
+//# sourceMappingURL=edge-deployments.d.ts.map

package/dist/endpoints/edge-deployments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-deployments.d.ts","sourceRoot":"","sources":["../../src/endpoints/edge-deployments.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAiB/B,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC3B,CAAA"}

package/dist/endpoints/edge-deployments.js

@@ -0,0 +1,58 @@
+/**
+ * Edge Deployment endpoints — customer edge Workers, Management plane.
+ *
+ * Mount: `/projects/:id/edge-deployments` (see
+ * `apps/api/src/server/platform/routes/edge-deployments.ts`). Scaffold stage:
+ * handlers accept the upload and log "CF Workers API integration pending".
+ *
+ * Design reference: `docs/design/edge-functions-isr-image-opt.md` § 3.1 + § 6.
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { CreateEdgeDeploymentInput, CreateEdgeDeploymentResult, DeleteEdgeDeploymentResult, EdgeDeployment, ListEdgeDeploymentsQuery, ListEdgeDeploymentsResult, } from '../schemas/edge-deployments.js';
+const ProjectPath = Schema.Struct({ id: Schema.String });
+const ProjectAndDeploymentPath = Schema.Struct({
+    id: Schema.String,
+    deploymentId: Schema.String,
+});
+export const edgeDeploymentsEndpoints = {
+    create: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:id/edge-deployments',
+        params: ProjectPath,
+        body: CreateEdgeDeploymentInput,
+        response: CreateEdgeDeploymentResult,
+        plane: 'management',
+        summary: 'Upload a bundled edge Worker and record the deployment',
+        description: "Accepts a base64-encoded ESM bundle from `sylphx edge deploy`. The Platform API records the deployment row and forwards to the Cloudflare Workers Platform API on the caller's behalf.",
+        tags: ['edge-deployments'],
+    }),
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:id/edge-deployments',
+        params: ProjectPath,
+        query: ListEdgeDeploymentsQuery,
+        response: ListEdgeDeploymentsResult,
+        plane: 'management',
+        summary: 'List edge deployments for a project',
+        tags: ['edge-deployments'],
+    }),
+    get: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:id/edge-deployments/:deploymentId',
+        params: ProjectAndDeploymentPath,
+        response: EdgeDeployment,
+        plane: 'management',
+        summary: 'Get a single edge deployment by id',
+        tags: ['edge-deployments'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/projects/:id/edge-deployments/:deploymentId',
+        params: ProjectAndDeploymentPath,
+        response: DeleteEdgeDeploymentResult,
+        plane: 'management',
+        summary: 'Retire an edge deployment (removes the Worker script on Cloudflare once integrated)',
+        tags: ['edge-deployments'],
+    }),
+};