@sylphx/contract 0.2.0

package/dist/schemas/deployment.js

@@ -0,0 +1,282 @@
+/**
+ * Deployment — the record of a build + rollout attempt against an
+ * environment. Mirrors `management/types.ts` DeployResult + DeploymentStatus
+ * + deployments.ts DeploymentDetail.
+ */
+import { Schema } from 'effect';
+import { DeploymentId, EnvironmentId, ProjectId, ServiceId } from './ids.js';
+/** Per-environment status row (inside DeploymentStatus.environments). */
+export const DeploymentEnvironmentStatus = Schema.Struct({
+    envId: Schema.optional(EnvironmentId),
+    envType: Schema.optional(Schema.String),
+    envName: Schema.optional(Schema.String),
+    status: Schema.String,
+    url: Schema.optional(Schema.NullOr(Schema.String)),
+    lastDeployedAt: Schema.optional(Schema.NullOr(Schema.String)),
+});
+export const DeploymentStatus = Schema.Struct({
+    appId: Schema.optional(Schema.String),
+    projectId: Schema.optional(ProjectId),
+    projectSlug: Schema.optional(Schema.String),
+    status: Schema.String,
+    environment: Schema.optional(Schema.String),
+    deployedAt: Schema.optional(Schema.String),
+    url: Schema.optional(Schema.String),
+    replicas: Schema.optional(Schema.Struct({
+        ready: Schema.Number,
+        desired: Schema.Number,
+    })),
+    environments: Schema.optional(Schema.Array(DeploymentEnvironmentStatus)),
+});
+export const DeployResult = Schema.Struct({
+    deploymentId: Schema.optional(DeploymentId),
+    deploymentRecordId: Schema.optional(DeploymentId),
+    buildRecordId: Schema.optional(Schema.NullOr(Schema.String)),
+    projectId: Schema.optional(ProjectId),
+    envId: Schema.optional(EnvironmentId),
+    envType: Schema.optional(Schema.String),
+    namespace: Schema.optional(Schema.NullOr(Schema.String)),
+    status: Schema.String,
+    environment: Schema.optional(Schema.String),
+    message: Schema.optional(Schema.String),
+    triggeredAt: Schema.optional(Schema.String),
+});
+/** History row in `GET /projects/:id/deployments`. */
+export const DeploymentHistoryItem = Schema.Struct({
+    id: DeploymentId,
+    projectId: Schema.optional(ProjectId),
+    envId: Schema.optional(EnvironmentId),
+    envType: Schema.NullOr(Schema.String),
+    envName: Schema.NullOr(Schema.String),
+    deploymentUuid: Schema.optional(Schema.NullOr(Schema.String)),
+    status: Schema.String,
+    gitCommit: Schema.NullOr(Schema.String),
+    gitBranch: Schema.NullOr(Schema.String),
+    commitMessage: Schema.optional(Schema.NullOr(Schema.String)),
+    triggeredBy: Schema.NullOr(Schema.String),
+    startedAt: Schema.NullOr(Schema.String),
+    finishedAt: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+});
+export const DeploymentHistoryResult = Schema.Struct({
+    object: Schema.Literal('list'),
+    data: Schema.Array(DeploymentHistoryItem),
+});
+/** `POST /projects/:id/rollback` result. */
+export const RollbackResult = Schema.Struct({
+    rolledBack: Schema.Boolean,
+    imageDigest: Schema.NullOr(Schema.String),
+    deploymentId: Schema.NullOr(DeploymentId),
+    serviceId: Schema.NullOr(ServiceId),
+});
+/** `GET /projects/:id/status` result — per-env health snapshot. */
+export const ProjectStatusEnvironment = Schema.Struct({
+    envId: EnvironmentId,
+    envType: Schema.optional(Schema.String),
+    envName: Schema.optional(Schema.String),
+    status: Schema.String,
+    url: Schema.optional(Schema.NullOr(Schema.String)),
+    gitBranch: Schema.optional(Schema.NullOr(Schema.String)),
+    lastDeployedAt: Schema.optional(Schema.NullOr(Schema.String)),
+    latestDeployment: Schema.optional(Schema.NullOr(Schema.Struct({
+        id: DeploymentId,
+        status: Schema.String,
+        deploymentUuid: Schema.optional(Schema.NullOr(Schema.String)),
+        triggeredBy: Schema.NullOr(Schema.String),
+        startedAt: Schema.NullOr(Schema.String),
+        finishedAt: Schema.NullOr(Schema.String),
+    }))),
+    error: Schema.optional(Schema.String),
+});
+export const ProjectStatus = Schema.Struct({
+    projectId: ProjectId,
+    projectSlug: Schema.String,
+    projectName: Schema.String,
+    isActive: Schema.Boolean,
+    status: Schema.String,
+    environments: Schema.Array(ProjectStatusEnvironment),
+});
+export const DeploymentServiceStatus = Schema.Struct({
+    id: Schema.optional(ServiceId),
+    name: Schema.String,
+    image: Schema.optional(Schema.NullOr(Schema.String)),
+    status: Schema.String,
+});
+export const DeploymentDetail = Schema.Struct({
+    id: DeploymentId,
+    status: Schema.String,
+    projectId: Schema.optional(ProjectId),
+    projectSlug: Schema.optional(Schema.String),
+    environment: Schema.optional(Schema.String),
+    environmentId: Schema.optional(Schema.NullOr(EnvironmentId)),
+    image: Schema.optional(Schema.NullOr(Schema.String)),
+    commitSha: Schema.optional(Schema.String),
+    commitMessage: Schema.optional(Schema.String),
+    author: Schema.optional(Schema.String),
+    gitCommit: Schema.optional(Schema.NullOr(Schema.String)),
+    gitBranch: Schema.optional(Schema.NullOr(Schema.String)),
+    createdAt: Schema.optional(Schema.String),
+    startedAt: Schema.optional(Schema.String),
+    completedAt: Schema.optional(Schema.NullOr(Schema.String)),
+    finishedAt: Schema.optional(Schema.String),
+    failedAt: Schema.optional(Schema.NullOr(Schema.String)),
+    durationMs: Schema.optional(Schema.Number),
+    errorMessage: Schema.optional(Schema.NullOr(Schema.String)),
+    url: Schema.optional(Schema.NullOr(Schema.String)),
+    buildLogUrl: Schema.optional(Schema.String),
+    services: Schema.optional(Schema.Array(DeploymentServiceStatus)),
+});
+export const TriggerDeploymentInput = Schema.Struct({
+    envType: Schema.optional(Schema.Literal('production', 'staging', 'development')),
+    envId: Schema.optional(EnvironmentId),
+    /** Fully-qualified content-addressed image ref (`host/path@sha256:…`). */
+    image: Schema.optional(Schema.String),
+    /** Required when `image` is set — deploys are always per-service. */
+    serviceId: Schema.optional(ServiceId),
+});
+export const RollbackDeploymentInput = Schema.Struct({
+    envId: Schema.optional(EnvironmentId),
+    deploymentRecordId: Schema.optional(DeploymentId),
+    buildRecordId: Schema.optional(Schema.String),
+    serviceId: Schema.optional(ServiceId),
+});
+// ============================================================================
+// Env-scoped Console deploy endpoints (`/deployments/projects/:envId/...`)
+// Added in ADR-084 Wave 3E. These power the Console UI which resolves an env
+// by its id (rather than project + env) and operates per-env-service for
+// rollback / promote flows.
+// ============================================================================
+/** `GET /deployments/status` — service-wide readiness. */
+export const DeployServiceStatus = Schema.Struct({
+    configured: Schema.Boolean,
+});
+/** `GET /deployments/projects` — one env row per (project, env) pair. */
+export const EnvScopedAppEnvInfo = Schema.Struct({
+    envId: EnvironmentId,
+    envType: Schema.String,
+    name: Schema.String,
+    status: Schema.String,
+    url: Schema.NullOr(Schema.String),
+    gitBranch: Schema.NullOr(Schema.String),
+    lastDeployedAt: Schema.NullOr(Schema.String),
+    deployConfigured: Schema.Boolean,
+});
+export const EnvScopedAppDeployments = Schema.Struct({
+    projectId: ProjectId,
+    buildMachineType: Schema.Literal('standard', 'large', 'xlarge'),
+    environments: Schema.Array(EnvScopedAppEnvInfo),
+});
+/** `POST /deployments/projects/:envId/deploy`. */
+export const EnvScopedTriggerDeployResult = Schema.Struct({
+    deploymentId: Schema.String,
+    message: Schema.String,
+});
+/** `POST /deployments/projects/:envId/rollback` — legacy commit-based. */
+export const EnvScopedRollbackByCommitInput = Schema.Struct({
+    commitSha: Schema.String,
+});
+export const EnvScopedRollbackByCommitResult = Schema.Struct({
+    deploymentId: Schema.String,
+    message: Schema.String,
+});
+/** `POST /deployments/builds/:buildId/cancel`. */
+export const CancelBuildResult = Schema.Struct({
+    cancelled: Schema.Boolean,
+    buildId: Schema.String,
+});
+/** `GET /deployments/projects/:envId/env` — env var list (values masked). */
+export const EnvScopedEnvVar = Schema.Struct({
+    key: Schema.String,
+    value: Schema.String,
+});
+export const EnvScopedListEnvVarsResult = Schema.Struct({
+    envId: EnvironmentId,
+    vars: Schema.Array(EnvScopedEnvVar),
+});
+/** `POST /deployments/projects/:envId/env`. */
+export const EnvScopedSetEnvVarInput = Schema.Struct({
+    key: Schema.String,
+    value: Schema.String,
+});
+export const EnvScopedSetEnvVarResult = Schema.Struct({
+    success: Schema.Boolean,
+    message: Schema.String,
+});
+/** `DELETE /deployments/projects/:envId/env/:key`. */
+export const EnvScopedDeleteEnvVarResult = Schema.Struct({
+    success: Schema.Boolean,
+});
+/** `GET /deployments/projects/:envId/deployments` — env-scoped history row. */
+export const EnvScopedDeploymentView = Schema.Struct({
+    id: Schema.String,
+    status: Schema.Literal('queued', 'running', 'building', 'success', 'failed', 'cancelled'),
+    createdAt: Schema.String,
+    commitMessage: Schema.NullOr(Schema.String),
+    gitCommit: Schema.NullOr(Schema.String),
+    gitBranch: Schema.NullOr(Schema.String),
+    supersededByGitSha: Schema.optional(Schema.NullOr(Schema.String)),
+    cancellationReason: Schema.optional(Schema.NullOr(Schema.String)),
+});
+export const EnvScopedDeploymentHistory = Schema.Struct({
+    envId: EnvironmentId,
+    deployments: Schema.Array(EnvScopedDeploymentView),
+});
+/** `GET /deployments/projects/:envId/status` — app health snapshot. */
+export const EnvScopedAppHealthStatus = Schema.Struct({
+    envId: EnvironmentId,
+    status: Schema.String,
+    url: Schema.NullOr(Schema.String),
+    gitBranch: Schema.NullOr(Schema.String),
+    lastDeployedAt: Schema.NullOr(Schema.String),
+});
+/**
+ * Per-service explicit rollback
+ * `POST /deployments/projects/:projectId/environments/:envId/services/:envSvcId/rollback`.
+ */
+export const EnvServiceRollbackInput = Schema.Struct({
+    to_deployment_id: Schema.String,
+});
+export const EnvServiceRollbackResult = Schema.Struct({
+    ok: Schema.Literal(true),
+    alreadyAtTarget: Schema.Boolean,
+    newDeploymentId: Schema.NullOr(Schema.String),
+    imageDigest: Schema.String,
+    reconcileTriggered: Schema.Boolean,
+});
+/** Promote — `POST /deployments/projects/:projectId/promote`. */
+export const PromoteArtifactInput = Schema.Struct({
+    from_env_svc_id: Schema.String,
+    to_env_svc_id: Schema.String,
+    artifact_digest: Schema.optional(Schema.String),
+});
+export const PromoteArtifactResult = Schema.Struct({
+    ok: Schema.Literal(true),
+    targetEnvSvcId: Schema.String,
+    artifactDigest: Schema.String,
+    newDeploymentId: Schema.NullOr(Schema.String),
+    reconcileTriggered: Schema.Boolean,
+});
+/** Per-env-service history row. */
+const DeployStatusLiteral = Schema.Literal('queued', 'running', 'building', 'success', 'failed', 'cancelled');
+const TriggerSourceLiteral = Schema.Literal('build', 'promote', 'rollback', 'manual', 'unknown');
+export const EnvServiceHistoryDeployment = Schema.Struct({
+    id: Schema.String,
+    imageDigest: Schema.NullOr(Schema.String),
+    imageRef: Schema.NullOr(Schema.String),
+    status: DeployStatusLiteral,
+    triggeredBy: Schema.NullOr(Schema.String),
+    triggerSource: TriggerSourceLiteral,
+    createdAt: Schema.String,
+    finishedAt: Schema.NullOr(Schema.String),
+    gitSha: Schema.NullOr(Schema.String),
+    gitCommit: Schema.NullOr(Schema.String),
+    gitBranch: Schema.NullOr(Schema.String),
+    commitMessage: Schema.NullOr(Schema.String),
+    isCurrent: Schema.Boolean,
+    isDesired: Schema.Boolean,
+});
+export const EnvServiceHistoryResult = Schema.Struct({
+    envSvcId: Schema.String,
+    deployments: Schema.Array(EnvServiceHistoryDeployment),
+    nextCursor: Schema.NullOr(Schema.String),
+});

package/dist/schemas/domain.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Domain — apex domain + its hostnames + optional DKIM/SMTP email binding.
+ * The shape is tight with the `routes/projects/:id/domains/*` Hono tree.
+ */
+import { Schema } from 'effect';
+export declare const DnsRecordType: Schema.Literal<["MX", "TXT", "CNAME", "A"]>;
+export type DnsRecordType = typeof DnsRecordType.Type;
+export declare const DnsRecord: 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>;
+}>;
+export type DnsRecord = typeof DnsRecord.Type;
+export declare const HostnameInstruction: Schema.Struct<{
+    type: Schema.Literal<["A", "CNAME"]>;
+    name: typeof Schema.String;
+    value: typeof Schema.String;
+    ttl: typeof Schema.Number;
+}>;
+export type HostnameInstruction = typeof HostnameInstruction.Type;
+export declare const DomainHostname: 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;
+}>;
+export type DomainHostname = typeof DomainHostname.Type;
+export declare const DomainEmailBinding: 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>>;
+}>;
+export type DomainEmailBinding = typeof DomainEmailBinding.Type;
+/** SMTP relay credentials (one-time visibility on enable). */
+export declare const SmtpCredentials: 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;
+}>;
+export type SmtpCredentials = typeof SmtpCredentials.Type;
+export declare const EnableEmailInput: Schema.Struct<{
+    defaultFromEmail: Schema.optional<typeof Schema.String>;
+    defaultFromName: Schema.optional<typeof Schema.String>;
+}>;
+export type EnableEmailInput = typeof EnableEmailInput.Type;
+export declare const EnableSmtpInput: Schema.Struct<{
+    apiKey: typeof Schema.String;
+}>;
+export type EnableSmtpInput = typeof EnableSmtpInput.Type;
+export declare const UpdateHostnameInput: Schema.Struct<{
+    isPrimary: Schema.optional<typeof Schema.Boolean>;
+    redirectTo: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+}>;
+export type UpdateHostnameInput = typeof UpdateHostnameInput.Type;
+export declare const Domain: 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;
+}>;
+export type Domain = typeof Domain.Type;
+export declare const CreateDomainInput: Schema.Struct<{
+    apexDomain: typeof Schema.String;
+    envType: Schema.optional<typeof Schema.String>;
+}>;
+export type CreateDomainInput = typeof CreateDomainInput.Type;
+export declare const AddHostnameInput: Schema.Struct<{
+    hostname: typeof Schema.String;
+    serviceId: Schema.optional<typeof Schema.String>;
+    isPrimary: Schema.optional<typeof Schema.Boolean>;
+    redirectTo: Schema.optional<typeof Schema.String>;
+}>;
+export type AddHostnameInput = typeof AddHostnameInput.Type;
+//# sourceMappingURL=domain.d.ts.map

package/dist/schemas/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/schemas/domain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,eAAO,MAAM,aAAa,6CAA4C,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,eAAO,MAAM,SAAS;;;;;;;;EAQpB,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,mBAAmB;;;;;EAK9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;EAWzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAa7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;;EAO1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,gBAAgB;;;EAG3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAE3D,eAAO,MAAM,eAAe;;EAE1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,eAAO,MAAM,mBAAmB;;;EAG9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOjB,CAAA;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AAEvC,eAAO,MAAM,iBAAiB;;;EAG5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA"}

package/dist/schemas/domain.js

@@ -0,0 +1,86 @@
+/**
+ * Domain — apex domain + its hostnames + optional DKIM/SMTP email binding.
+ * The shape is tight with the `routes/projects/:id/domains/*` Hono tree.
+ */
+import { Schema } from 'effect';
+import { DomainId, HostnameId } from './ids.js';
+export const DnsRecordType = Schema.Literal('MX', 'TXT', 'CNAME', 'A');
+export const DnsRecord = Schema.Struct({
+    type: DnsRecordType,
+    name: Schema.String,
+    value: Schema.String,
+    priority: Schema.optional(Schema.Number),
+    ttl: Schema.Number,
+    status: Schema.optional(Schema.Literal('pending', 'verified')),
+    description: Schema.optional(Schema.String),
+});
+export const HostnameInstruction = Schema.Struct({
+    type: Schema.Literal('A', 'CNAME'),
+    name: Schema.String,
+    value: Schema.String,
+    ttl: Schema.Number,
+});
+export const DomainHostname = Schema.Struct({
+    id: HostnameId,
+    domainId: DomainId,
+    hostname: Schema.String,
+    isPrimary: Schema.Boolean,
+    redirectTo: Schema.NullOr(Schema.String),
+    dnsStatus: Schema.Literal('pending', 'active', 'error'),
+    instruction: HostnameInstruction,
+    verifiedAt: Schema.NullOr(Schema.String),
+    lastCheckError: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+});
+export const DomainEmailBinding = Schema.Struct({
+    id: Schema.String,
+    domainId: DomainId,
+    dnsStatus: Schema.Literal('pending', 'verifying', 'verified', 'failed'),
+    stalwartLoaded: Schema.Boolean,
+    defaultFromEmail: Schema.NullOr(Schema.String),
+    defaultFromName: Schema.NullOr(Schema.String),
+    records: Schema.Array(DnsRecord),
+    verifiedAt: Schema.NullOr(Schema.String),
+    verificationError: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+    smtpEnabled: Schema.optional(Schema.Boolean),
+    smtpUsername: Schema.optional(Schema.NullOr(Schema.String)),
+});
+/** SMTP relay credentials (one-time visibility on enable). */
+export const SmtpCredentials = Schema.Struct({
+    enabled: Schema.Boolean,
+    host: Schema.String,
+    port: Schema.Number,
+    portTls: Schema.Number,
+    username: Schema.NullOr(Schema.String),
+    passwordHint: Schema.String,
+});
+export const EnableEmailInput = Schema.Struct({
+    defaultFromEmail: Schema.optional(Schema.String),
+    defaultFromName: Schema.optional(Schema.String),
+});
+export const EnableSmtpInput = Schema.Struct({
+    apiKey: Schema.String,
+});
+export const UpdateHostnameInput = Schema.Struct({
+    isPrimary: Schema.optional(Schema.Boolean),
+    redirectTo: Schema.optional(Schema.NullOr(Schema.String)),
+});
+export const Domain = Schema.Struct({
+    id: DomainId,
+    apexDomain: Schema.String,
+    hostnames: Schema.Array(DomainHostname),
+    email: Schema.NullOr(DomainEmailBinding),
+    createdAt: Schema.String,
+    updatedAt: Schema.String,
+});
+export const CreateDomainInput = Schema.Struct({
+    apexDomain: Schema.String,
+    envType: Schema.optional(Schema.String),
+});
+export const AddHostnameInput = Schema.Struct({
+    hostname: Schema.String,
+    serviceId: Schema.optional(Schema.String),
+    isPrimary: Schema.optional(Schema.Boolean),
+    redirectTo: Schema.optional(Schema.String),
+});

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

@@ -0,0 +1,140 @@
+/**
+ * Edge Deployments — customer code that runs on Cloudflare Workers at the
+ * edge. Part of the P1 gap #10 design (`docs/design/edge-functions-isr-image-opt.md`).
+ *
+ * Plane: `management` — customers call `POST /projects/:id/edge-deployments`
+ * via the CLI (`sylphx edge deploy`) to upload a pre-bundled ESM script. The
+ * Platform API then speaks to Cloudflare's Workers Platform API on their
+ * behalf (credentials never touch the customer machine, per § 8 of the design).
+ *
+ * The wire shapes are intentionally minimal for the scaffold step. When the
+ * real Cloudflare integration lands, `CreateEdgeDeploymentInput` will grow
+ * bindings / secrets / dispatch-namespace hints — but every new field must
+ * pass through this contract (ADR-084 Rule 1).
+ */
+import { Schema } from 'effect';
+/** Lifecycle of a single edge-deployment row. Mirrors `edge_deployments.state` in the design doc (§ 5). */
+export declare const EdgeDeploymentStatus: Schema.Literal<["pending", "deploying", "active", "failed", "retired"]>;
+export type EdgeDeploymentStatus = typeof EdgeDeploymentStatus.Type;
+/** A single HTTP method + path combo the worker handles (e.g. GET /api/hello). */
+export declare const EdgeRoute: Schema.Struct<{
+    method: Schema.Literal<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "*"]>;
+    path: Schema.filter<typeof Schema.String>;
+}>;
+export type EdgeRoute = typeof EdgeRoute.Type;
+/** Single deployment record. Mirrors the `edge_deployments` table in the design doc. */
+export declare const EdgeDeployment: Schema.Struct<{
+    /** TypeID `edge_xxx`. */
+    id: typeof Schema.String;
+    /** TypeID `proj_xxx`. */
+    projectId: typeof Schema.String;
+    /** TypeID `env_xxx`. */
+    environmentId: typeof Schema.String;
+    /** Cloudflare dispatch namespace + script id (e.g. `sylphx-prod/proj_abc-v3`). */
+    workerName: typeof Schema.String;
+    /** Cloudflare script tag — opaque per upload, used for rollback. */
+    version: typeof Schema.String;
+    /** Every URL pattern the deployment claims. */
+    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"]>;
+    /** Populated only when `status === 'failed'`. */
+    error: Schema.NullOr<typeof Schema.String>;
+    /** Byte size of the uploaded bundle — useful for quota displays. */
+    bundleSizeBytes: typeof Schema.Number;
+    /** TypeID `user_xxx` of the operator who triggered the deploy. */
+    deployedBy: typeof Schema.String;
+    deployedAt: typeof Schema.String;
+}>;
+export type EdgeDeployment = typeof EdgeDeployment.Type;
+/**
+ * Create-deployment body. The `bundle` field carries the raw ESM script as
+ * a base64 string — matches the CLI's `bundle → base64 → POST` flow. For
+ * larger bundles (> 1 MB) a follow-up multipart endpoint will land; scope
+ * for the scaffold is the small-bundle path only.
+ */
+export declare const CreateEdgeDeploymentInput: Schema.Struct<{
+    /** Target environment for the deployment (dev / preview / production). */
+    environmentId: typeof Schema.String;
+    /** Base64-encoded ESM worker bundle. */
+    bundle: typeof Schema.String;
+    /** Optional route hints; server can also infer from the bundle on deploy. */
+    routes: Schema.optional<Schema.Array$<Schema.Struct<{
+        method: Schema.Literal<["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "*"]>;
+        path: Schema.filter<typeof Schema.String>;
+    }>>>;
+    /** Human label surfaced in the Console deploy list. */
+    label: Schema.optional<typeof Schema.String>;
+}>;
+export type CreateEdgeDeploymentInput = typeof CreateEdgeDeploymentInput.Type;
+export declare const CreateEdgeDeploymentResult: Schema.Struct<{
+    deployment: Schema.Struct<{
+        /** TypeID `edge_xxx`. */
+        id: typeof Schema.String;
+        /** TypeID `proj_xxx`. */
+        projectId: typeof Schema.String;
+        /** TypeID `env_xxx`. */
+        environmentId: typeof Schema.String;
+        /** Cloudflare dispatch namespace + script id (e.g. `sylphx-prod/proj_abc-v3`). */
+        workerName: typeof Schema.String;
+        /** Cloudflare script tag — opaque per upload, used for rollback. */
+        version: typeof Schema.String;
+        /** Every URL pattern the deployment claims. */
+        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"]>;
+        /** Populated only when `status === 'failed'`. */
+        error: Schema.NullOr<typeof Schema.String>;
+        /** Byte size of the uploaded bundle — useful for quota displays. */
+        bundleSizeBytes: typeof Schema.Number;
+        /** TypeID `user_xxx` of the operator who triggered the deploy. */
+        deployedBy: typeof Schema.String;
+        deployedAt: typeof Schema.String;
+    }>;
+}>;
+export type CreateEdgeDeploymentResult = typeof CreateEdgeDeploymentResult.Type;
+export declare const ListEdgeDeploymentsResult: Schema.Struct<{
+    deployments: Schema.Array$<Schema.Struct<{
+        /** TypeID `edge_xxx`. */
+        id: typeof Schema.String;
+        /** TypeID `proj_xxx`. */
+        projectId: typeof Schema.String;
+        /** TypeID `env_xxx`. */
+        environmentId: typeof Schema.String;
+        /** Cloudflare dispatch namespace + script id (e.g. `sylphx-prod/proj_abc-v3`). */
+        workerName: typeof Schema.String;
+        /** Cloudflare script tag — opaque per upload, used for rollback. */
+        version: typeof Schema.String;
+        /** Every URL pattern the deployment claims. */
+        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"]>;
+        /** Populated only when `status === 'failed'`. */
+        error: Schema.NullOr<typeof Schema.String>;
+        /** Byte size of the uploaded bundle — useful for quota displays. */
+        bundleSizeBytes: typeof Schema.Number;
+        /** TypeID `user_xxx` of the operator who triggered the deploy. */
+        deployedBy: typeof Schema.String;
+        deployedAt: typeof Schema.String;
+    }>>;
+    total: typeof Schema.Number;
+}>;
+export type ListEdgeDeploymentsResult = typeof ListEdgeDeploymentsResult.Type;
+export declare const DeleteEdgeDeploymentResult: Schema.Struct<{
+    deleted: typeof Schema.Boolean;
+}>;
+export type DeleteEdgeDeploymentResult = typeof DeleteEdgeDeploymentResult.Type;
+export declare const ListEdgeDeploymentsQuery: 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>;
+}>;
+export type ListEdgeDeploymentsQuery = typeof ListEdgeDeploymentsQuery.Type;
+//# sourceMappingURL=edge-deployments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edge-deployments.d.ts","sourceRoot":"","sources":["../../src/schemas/edge-deployments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAI/B,2GAA2G;AAC3G,eAAO,MAAM,oBAAoB,yEAMhC,CAAA;AACD,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAInE,kFAAkF;AAClF,eAAO,MAAM,SAAS;;;EAGpB,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAI7C,wFAAwF;AACxF,eAAO,MAAM,cAAc;IAC1B,yBAAyB;;IAEzB,yBAAyB;;IAEzB,wBAAwB;;IAExB,kFAAkF;;IAElF,oEAAoE;;IAEpE,+CAA+C;;;;;;IAG/C,iDAAiD;;IAEjD,oEAAoE;;IAEpE,kEAAkE;;;EAGjE,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAIvD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;IACrC,0EAA0E;;IAE1E,wCAAwC;;IAExC,6EAA6E;;;;;IAE7E,uDAAuD;;EAEtD,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAI7E,eAAO,MAAM,0BAA0B;;QA7CtC,yBAAyB;;QAEzB,yBAAyB;;QAEzB,wBAAwB;;QAExB,kFAAkF;;QAElF,oEAAoE;;QAEpE,+CAA+C;;;;;;QAG/C,iDAAiD;;QAEjD,oEAAoE;;QAEpE,kEAAkE;;;;EA8BjE,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAA;AAE/E,eAAO,MAAM,yBAAyB;;QAlDrC,yBAAyB;;QAEzB,yBAAyB;;QAEzB,wBAAwB;;QAExB,kFAAkF;;QAElF,oEAAoE;;QAEpE,+CAA+C;;;;;;QAG/C,iDAAiD;;QAEjD,oEAAoE;;QAEpE,kEAAkE;;;;;EAoCjE,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAE7E,eAAO,MAAM,0BAA0B;;EAErC,CAAA;AACF,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAA;AAI/E,eAAO,MAAM,wBAAwB;;;;;EAKnC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA"}