@sylphx/contract 0.3.0 → 0.5.0

package/dist/schemas/storage.js

@@ -1,174 +1,193 @@
 /**
- * Storage — BaaS plane file upload / download. Uses presigned URLs per AWS
- * S3 convention. Mirrors `@sylphx/sdk/storage.ts`.
+ * Storage — BaaS plane object storage. Per ADR-100.
  *
- * Shape policy (ADR-084 Wave 2d): schemas here are the UNION superset of
- * all production SDK / OpenAPI-generated wire shapes. Any field that is not
- * universally present on the wire is `optional`, so contract consumers
- * never have to narrow to parse a legitimate server response. When the
- * server response narrows in future, tighten the optional in a dedicated
- * wave — never break existing callers by removing a field.
+ * Wire is one resource (`uploads`) plus the existing `files` resource. No
+ * polymorphic POSTs, no vendor-namespaced wire envelopes, no historical
+ * field aliases. Every endpoint has exactly one request and one response
+ * schema.
+ *
+ * Storage backends (B2, R2) are abstracted by `apps/storage-gateway`. The
+ * BaaS handler returns presigned URLs against `storage.sylphx.com`; the
+ * client uploads bytes there directly. Mid-flow tenant subdomain hops are
+ * forbidden (ADR-083.1).
  */
 import { Schema } from 'effect';
+// ============================================================================
+// Branded identifiers
+// ============================================================================
 export const FileId = Schema.String.pipe(Schema.brand('FileId'));
+export const UploadId = Schema.String.pipe(Schema.brand('UploadId'));
+export const FileVersionId = Schema.String.pipe(Schema.brand('FileVersionId'));
+// ============================================================================
+// Enumerations
+// ============================================================================
+export const FileVisibility = Schema.Literal('public', 'private');
+export const SignedUrlDisposition = Schema.Literal('attachment', 'inline');
+/** Method discriminator on the upload-create response. */
+export const UploadMethod = Schema.Literal('PUT', 'MULTIPART');
+// ============================================================================
+// Core types
+// ============================================================================
 /**
- * File metadata superset — reconciles three historical shapes:
- *
- * - SDK `FileInfo` interface: `{ id, url, name, size, contentType,
- *   isPrivate, createdAt }`
- * - Generated OpenAPI `FileInfo` / `GetFileResponse`: `{ id, filename,
- *   path, url, mimeType, size, metadata, createdAt }`
- * - Previous contract shape: `{ id, key, size, contentType, url?,
- *   uploadedAt }`
- *
- * Every historical field is preserved as optional so older and newer
- * clients can both parse server responses. `id` and `size` are the only
- * guaranteed-present fields across all three shapes.
+ * Canonical file metadata. Single shape — no aliases, no nullable hacks
+ * for legacy callers. ADR-100 §2.6.
  */
-export const FileInfo = Schema.Struct({
-    id: Schema.String,
+export const File = Schema.Struct({
+    id: FileId,
+    filename: Schema.String,
+    contentType: Schema.String,
     size: Schema.Number,
-    /** SDK-native filename (preferred). Alias of `filename` on newer servers. */
-    name: Schema.optional(Schema.String),
-    /** OpenAPI-native filename. Alias of `name` on older servers. */
-    filename: Schema.optional(Schema.String),
-    /** Folder path or storage key. */
-    path: Schema.optional(Schema.String),
-    /** Legacy storage object key (contract v1). */
-    key: Schema.optional(Schema.String),
-    /** Public URL — null for private files, absent on some delete responses. */
-    url: Schema.optional(Schema.NullOr(Schema.String)),
-    /** SDK-native MIME type. */
-    contentType: Schema.optional(Schema.String),
-    /** OpenAPI-native MIME type (alias of `contentType`). */
-    mimeType: Schema.optional(Schema.String),
-    /** Private/public visibility flag. Absent => treat as public. */
-    isPrivate: Schema.optional(Schema.Boolean),
-    /** Arbitrary caller-attached metadata. */
-    metadata: Schema.optional(Schema.NullOr(Schema.Record({ key: Schema.String, value: Schema.Unknown }))),
-    /** SDK-native creation timestamp (ISO string). */
-    createdAt: Schema.optional(Schema.String),
-    /** Legacy contract v1 upload timestamp (alias of createdAt). */
-    uploadedAt: Schema.optional(Schema.String),
+    checksumSha256: Schema.String,
+    etag: Schema.String,
+    visibility: FileVisibility,
+    folder: Schema.NullOr(Schema.String),
+    metadata: Schema.Record({ key: Schema.String, value: Schema.Unknown }),
+    /** Public URL when `visibility === 'public'`; `null` otherwise. Use `:signedUrl` for private files. */
+    url: Schema.NullOr(Schema.String),
+    isDeleted: Schema.Boolean,
+    createdAt: Schema.DateFromString,
+    updatedAt: Schema.DateFromString,
+});
+export const FileVersion = Schema.Struct({
+    id: FileVersionId,
+    fileId: FileId,
+    versionNumber: Schema.Number,
+    size: Schema.Number,
+    contentType: Schema.String,
+    checksumSha256: Schema.String,
+    etag: Schema.String,
+    createdAt: Schema.DateFromString,
+    createdBy: Schema.NullOr(Schema.String),
+    isCurrent: Schema.Boolean,
+});
+// ============================================================================
+// Upload session — POST /v1/storage/uploads
+// ============================================================================
+export const UploadCreateRequest = Schema.Struct({
+    filename: Schema.String.pipe(Schema.minLength(1)),
+    contentType: Schema.String.pipe(Schema.minLength(1)),
+    size: Schema.Number.pipe(Schema.greaterThanOrEqualTo(0)),
+    folder: Schema.optional(Schema.String),
+    visibility: Schema.optional(FileVisibility),
+    metadata: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+    /** Pre-computed SHA-256 (hex); verified server-side on `:complete` (multipart) or after PUT (single). */
+    checksumSha256: Schema.optional(Schema.String),
+    /** S3-style precondition; if `'*'`, fail when a file already exists at (folder, filename). */
+    ifNoneMatch: Schema.optional(Schema.Literal('*')),
+});
+export const UploadPart = Schema.Struct({
+    partNumber: Schema.Number.pipe(Schema.greaterThanOrEqualTo(1)),
+    url: Schema.String,
+    expiresAt: Schema.DateFromString,
 });
 /**
- * Input for the richer `/storage/upload` token flow used by the SDK for
- * client-direct uploads (Vercel Blob pattern). Server mints an upload
- * endpoint + client payload, and the SDK performs the actual PUT against
- * storage. Superset of `UploadUrlInput`.
+ * Single-part response — the request body fits in one PUT. Client uploads
+ * the whole blob to `url` with the supplied `headers`, captures the `ETag`
+ * response header, then calls `:complete` with `parts: [{partNumber: 1,
+ * etag}]` to finalise. The `:complete` step is non-optional even for
+ * single-part uploads because it is what writes the file row to the
+ * database and consumes quota — without it the storage object is
+ * orphaned and reclaimed by the multipart-aborts sweeper after
+ * `expiresAt`.
  */
-export const UploadTokenInput = Schema.Struct({
-    filename: Schema.String,
-    contentType: Schema.optional(Schema.String),
-    size: Schema.optional(Schema.Number),
-    /** Folder path for organizing the file. */
-    path: Schema.optional(Schema.String),
-    /** `file` | `avatar` — avatars apply user-scoped policy. */
-    type: Schema.optional(Schema.Literal('file', 'avatar')),
-    /** User ID (required for `type: 'avatar'`). */
-    userId: Schema.optional(Schema.String),
-    /** Arbitrary caller-attached metadata persisted alongside the blob. */
-    metadata: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+export const UploadCreateSinglePartResult = Schema.Struct({
+    method: Schema.Literal('PUT'),
+    uploadId: UploadId,
+    fileId: FileId,
+    url: Schema.String,
+    headers: Schema.Record({ key: Schema.String, value: Schema.String }),
+    expiresAt: Schema.DateFromString,
 });
 /**
- * Upload token response. Supports both the simple `{ uploadUrl, publicUrl,
- * fileId, expiresAt }` shape and the richer Vercel-Blob-style
- * `{ uploadEndpoint, clientPayload, instructions, ... }` shape.
+ * Multipart response — client PUTs each part to its presigned URL, then
+ * calls `POST /uploads/{uploadId}:complete` with the per-part etags.
  */
-export const UploadTokenResult = Schema.Struct({
-    // Simple flow
-    uploadUrl: Schema.optional(Schema.String),
-    publicUrl: Schema.optional(Schema.String),
-    fileId: Schema.optional(Schema.String),
-    expiresAt: Schema.optional(Schema.String),
-    // Presigned S3 flow returned by the Effect-native upload handler
-    presignedUrl: Schema.optional(Schema.String),
-    storageKey: Schema.optional(Schema.String),
-    tokenPayload: Schema.optional(Schema.String),
-    url: Schema.optional(Schema.String),
-    // Vercel Blob client-upload flow
-    uploadEndpoint: Schema.optional(Schema.String),
-    clientPayload: Schema.optional(Schema.String),
-    maxSize: Schema.optional(Schema.Number),
-    maxMultipartSize: Schema.optional(Schema.Number),
-    multipartThreshold: Schema.optional(Schema.Number),
-    allowedContentTypes: Schema.optional(Schema.Array(Schema.String)),
-    instructions: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
-});
-export const UploadUrlInput = Schema.Struct({
-    filename: Schema.String,
-    contentType: Schema.String,
-    size: Schema.optional(Schema.Number),
+export const UploadCreateMultipartResult = Schema.Struct({
+    method: Schema.Literal('MULTIPART'),
+    uploadId: UploadId,
+    fileId: FileId,
+    partSize: Schema.Number,
+    partCount: Schema.Number,
+    parts: Schema.Array(UploadPart),
+    expiresAt: Schema.DateFromString,
+});
+/**
+ * Discriminated union on `method`. SDK narrows via the literal; downstream
+ * code never has to inspect optional fields.
+ */
+export const UploadCreateResult = Schema.Union(UploadCreateSinglePartResult, UploadCreateMultipartResult);
+// ============================================================================
+// Multipart support
+// ============================================================================
+/** Refresh a single part presigned URL — used when an upload pauses past `expiresAt`. */
+export const UploadPartPresignResult = Schema.Struct({
+    url: Schema.String,
+    expiresAt: Schema.DateFromString,
+});
+export const UploadCompletePart = Schema.Struct({
+    partNumber: Schema.Number.pipe(Schema.greaterThanOrEqualTo(1)),
+    etag: Schema.String.pipe(Schema.minLength(1)),
 });
-export const UploadUrlResult = Schema.Struct({
-    uploadUrl: Schema.String,
-    fileId: Schema.String,
-    expiresAt: Schema.String,
+export const UploadCompleteRequest = Schema.Struct({
+    parts: Schema.Array(UploadCompletePart),
+});
+export const UploadCompleteResult = Schema.Struct({
+    fileId: FileId,
+    url: Schema.NullOr(Schema.String),
+    size: Schema.Number,
+    etag: Schema.String,
+    checksumSha256: Schema.String,
 });
+// ============================================================================
+// Files resource
+// ============================================================================
 export const ListFilesQuery = Schema.Struct({
-    prefix: Schema.optional(Schema.String),
-    limit: Schema.optional(Schema.String),
+    folder: Schema.optional(Schema.String),
     cursor: Schema.optional(Schema.String),
+    /** Page size; clamped server-side to [1, 100]; default 25. */
+    limit: Schema.optional(Schema.Number),
+    includeDeleted: Schema.optional(Schema.Boolean),
 });
 export const ListFilesResult = Schema.Struct({
-    files: Schema.Array(FileInfo),
+    files: Schema.Array(File),
     nextCursor: Schema.NullOr(Schema.String),
-    /** True if there are more files beyond this page. */
-    hasMore: Schema.optional(Schema.Boolean),
 });
-export const DeleteFileResult = Schema.Struct({ success: Schema.Boolean });
-/**
- * Signed download URL input. Returns a short-lived URL for private files
- * without exposing permanent credentials.
- */
-export const SignedUrlInput = Schema.Struct({
-    fileId: Schema.String,
-    /** Seconds until the URL expires (default: 3600, max: 604800 = 7 days). */
-    expiresIn: Schema.optional(Schema.Number),
-    /** `attachment` forces download, `inline` displays in browser. */
-    disposition: Schema.optional(Schema.Literal('attachment', 'inline')),
-    /** Restrict URL access to a specific user. */
+export const SoftDeleteFileResult = Schema.Struct({
+    id: FileId,
+    isDeleted: Schema.Literal(true),
+});
+export const RestoreFileResult = File;
+// ============================================================================
+// Signed URLs
+// ============================================================================
+export const SignedUrlRequest = Schema.Struct({
+    expiresIn: Schema.optional(Schema.Number.pipe(Schema.greaterThanOrEqualTo(1))),
+    disposition: Schema.optional(SignedUrlDisposition),
+    /** Restrict the signed URL to a specific authenticated user (claim baked into the signature). */
     userId: Schema.optional(Schema.String),
 });
 export const SignedUrlResult = Schema.Struct({
     url: Schema.String,
-    expiresAt: Schema.String,
-    file: Schema.Struct({
-        id: Schema.String,
-        filename: Schema.String,
-        mimeType: Schema.String,
-        sizeBytes: Schema.Number,
-        isPrivate: Schema.Boolean,
-    }),
+    expiresAt: Schema.DateFromString,
+    file: File,
 });
 // ============================================================================
-// ADR-089 Phase 5.8 — Versioning
+// Copy
 // ============================================================================
-/**
- * A single version of a file. Append-only per-file history — every
- * upload creates one row with a monotonic `versionNumber`. Restore
- * creates a NEW version row pointing at the old object (never mutates
- * history).
- */
-export const StorageFileVersion = Schema.Struct({
-    id: Schema.String,
-    fileId: Schema.String,
-    versionNumber: Schema.Number,
-    sizeBytes: Schema.Number,
-    contentType: Schema.NullOr(Schema.String),
-    checksumSha256: Schema.NullOr(Schema.String),
-    createdAt: Schema.String,
-    createdBy: Schema.NullOr(Schema.String),
-    isCurrent: Schema.Boolean,
+export const CopyFileRequest = Schema.Struct({
+    folder: Schema.optional(Schema.String),
+    filename: Schema.optional(Schema.String),
+    visibility: Schema.optional(FileVisibility),
+    metadata: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
 });
+export const CopyFileResult = File;
+// ============================================================================
+// Versions
+// ============================================================================
 export const ListFileVersionsResult = Schema.Struct({
-    versions: Schema.Array(StorageFileVersion),
+    versions: Schema.Array(FileVersion),
 });
 export const RestoreVersionResult = Schema.Struct({
-    success: Schema.Literal(true),
-    version: StorageFileVersion,
-});
-export const RestoreFileResult = Schema.Struct({
-    success: Schema.Literal(true),
-    file: FileInfo,
+    file: File,
+    version: FileVersion,
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/contract",
-	"version": "0.3.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"}