@sylphx/contract 0.4.0 → 0.5.0

package/dist/schemas/resources.js

@@ -19,7 +19,7 @@ export const VolumeStatus = Schema.Literal('provisioning', 'active', 'error');
  *   caches / parallel workers)
  */
 export const VolumeAccessMode = Schema.Literal('ReadWriteOnce', 'ReadWriteMany');
-export const BindingRole = Schema.Literal('primary', 'replica', 'analytics', 'backup');
+export const BindingRole = Schema.Literal('primary', 'replica', 'analytics', 'backup', 'session');
 // ── Tier Badge (display) ───────────────────────────────────────────────────
 export const TierBadge = Schema.Struct({
     tier: ResourceTier,
@@ -218,3 +218,54 @@ export const CreateSearchResourceInput = Schema.Struct({
 export const ListSearchResourcesResult = Schema.Struct({
     resources: Schema.Array(SearchResource),
 });
+// ── Unified Managed Resource Wire Shape ───────────────────────────────────
+export const ManagedResource = Schema.Struct({
+    id: Schema.String,
+    orgId: Schema.optional(Schema.String),
+    name: Schema.String,
+    slug: Schema.optional(Schema.NullOr(Schema.String)),
+    kind: Schema.optional(ResourceType),
+    provider: Schema.optional(Schema.String),
+    tier: Schema.optional(Schema.String),
+    status: Schema.optional(Schema.String),
+    reconcileStatus: Schema.optional(Schema.String),
+    bindingCount: Schema.optional(Schema.Number),
+    host: Schema.optional(Schema.NullOr(Schema.String)),
+    directHost: Schema.optional(Schema.NullOr(Schema.String)),
+    port: Schema.optional(Schema.Number),
+    publicPort: Schema.optional(Schema.NullOr(Schema.Number)),
+    publicHost: Schema.optional(Schema.NullOr(Schema.String)),
+    dbUser: Schema.optional(Schema.NullOr(Schema.String)),
+    dbName: Schema.optional(Schema.NullOr(Schema.String)),
+    cacheUser: Schema.optional(Schema.NullOr(Schema.String)),
+    keyPrefix: Schema.optional(Schema.NullOr(Schema.String)),
+    connectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    maskedConnectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    publicConnectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    maskedPublicConnectionString: Schema.optional(Schema.NullOr(Schema.String)),
+    storageGb: Schema.optional(Schema.Number),
+    env: Schema.optional(Schema.String),
+    engine: Schema.optional(Schema.String),
+    instances: Schema.optional(Schema.Number),
+    clusterName: Schema.optional(Schema.NullOr(Schema.String)),
+    branchName: Schema.optional(Schema.NullOr(Schema.String)),
+    backupRetentionDays: Schema.optional(Schema.Number),
+    bucket: Schema.optional(Schema.String),
+    endpoint: Schema.optional(Schema.NullOr(Schema.String)),
+    region: Schema.optional(Schema.NullOr(Schema.String)),
+    prefix: Schema.optional(Schema.NullOr(Schema.String)),
+    publicUrl: Schema.optional(Schema.NullOr(Schema.String)),
+    accessMode: Schema.optional(VolumeAccessMode),
+    hostPath: Schema.optional(Schema.NullOr(Schema.String)),
+    mountPath: Schema.optional(Schema.NullOr(Schema.String)),
+    sizeGb: Schema.optional(Schema.NullOr(Schema.Number)),
+    memoryGb: Schema.optional(Schema.Number),
+    nodes: Schema.optional(Schema.Number),
+    apiKey: Schema.optional(Schema.NullOr(Schema.String)),
+    message: Schema.optional(Schema.String),
+    provisioningError: Schema.optional(Schema.NullOr(Schema.String)),
+    conditions: Schema.optional(Schema.Array(Schema.Unknown)),
+    config: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+    createdAt: Schema.optional(Schema.String),
+    updatedAt: Schema.optional(Schema.String),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/contract",
-	"version": "0.4.0",
+	"version": "0.5.0",
 	"description": "Sylphx Platform contract — Effect Schema SSOT for every API endpoint (ADR-084).",
 	"type": "module",
 	"sideEffects": false,

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

@@ -1,92 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-/**
- * 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'],
-    }),
-};

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

@@ -1,140 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/schemas/edge-deployments.js

@@ -1,87 +0,0 @@
-/**
- * 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';
-// ── Status enum ────────────────────────────────────────────────────────────
-/** Lifecycle of a single edge-deployment row. Mirrors `edge_deployments.state` in the design doc (§ 5). */
-export const EdgeDeploymentStatus = Schema.Literal('pending', // CLI upload accepted, Cloudflare API call not yet made
-'deploying', // Cloudflare API call in-flight
-'active', // Worker script is serving traffic
-'failed', // Cloudflare API returned an error; see `error` field
-'retired');
-// ── Route definition carried alongside each deployment ─────────────────────
-/** A single HTTP method + path combo the worker handles (e.g. GET /api/hello). */
-export const EdgeRoute = Schema.Struct({
-    method: Schema.Literal('GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', '*'),
-    path: Schema.String.pipe(Schema.minLength(1)),
-});
-// ── Entity shape on the wire ───────────────────────────────────────────────
-/** Single deployment record. Mirrors the `edge_deployments` table in the design doc. */
-export const EdgeDeployment = Schema.Struct({
-    /** TypeID `edge_xxx`. */
-    id: Schema.String,
-    /** TypeID `proj_xxx`. */
-    projectId: Schema.String,
-    /** TypeID `env_xxx`. */
-    environmentId: Schema.String,
-    /** Cloudflare dispatch namespace + script id (e.g. `sylphx-prod/proj_abc-v3`). */
-    workerName: Schema.String,
-    /** Cloudflare script tag — opaque per upload, used for rollback. */
-    version: Schema.String,
-    /** Every URL pattern the deployment claims. */
-    routes: Schema.Array(EdgeRoute),
-    status: EdgeDeploymentStatus,
-    /** Populated only when `status === 'failed'`. */
-    error: Schema.NullOr(Schema.String),
-    /** Byte size of the uploaded bundle — useful for quota displays. */
-    bundleSizeBytes: Schema.Number,
-    /** TypeID `user_xxx` of the operator who triggered the deploy. */
-    deployedBy: Schema.String,
-    deployedAt: Schema.String,
-});
-// ── Inputs ─────────────────────────────────────────────────────────────────
-/**
- * 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 const CreateEdgeDeploymentInput = Schema.Struct({
-    /** Target environment for the deployment (dev / preview / production). */
-    environmentId: Schema.String,
-    /** Base64-encoded ESM worker bundle. */
-    bundle: Schema.String,
-    /** Optional route hints; server can also infer from the bundle on deploy. */
-    routes: Schema.optional(Schema.Array(EdgeRoute)),
-    /** Human label surfaced in the Console deploy list. */
-    label: Schema.optional(Schema.String),
-});
-// ── Responses ──────────────────────────────────────────────────────────────
-export const CreateEdgeDeploymentResult = Schema.Struct({
-    deployment: EdgeDeployment,
-});
-export const ListEdgeDeploymentsResult = Schema.Struct({
-    deployments: Schema.Array(EdgeDeployment),
-    total: Schema.Number,
-});
-export const DeleteEdgeDeploymentResult = Schema.Struct({
-    deleted: Schema.Boolean,
-});
-// ── Query params ───────────────────────────────────────────────────────────
-export const ListEdgeDeploymentsQuery = Schema.Struct({
-    environmentId: Schema.optional(Schema.String),
-    status: Schema.optional(EdgeDeploymentStatus),
-    limit: Schema.optional(Schema.String),
-    offset: Schema.optional(Schema.String),
-});