@spacefast/common 0.0.2

package/dist/contracts/internal.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import { baseDiagnosticSchema } from "./common.js";
+export const conventionFilesSchema = z.object({
+    redirects: z.string().optional(),
+    headers: z.string().optional(),
+    routes: z.string().optional(),
+});
+export const manifestFileSchema = z.object({
+    path: z
+        .string()
+        .describe("Version-relative POSIX path. Canonicalized at intake to UTF-8 NFC, percent-decoded exactly once; max 1,024 bytes in canonical form."),
+    size: z.number().int().nonnegative().describe("File size in bytes."),
+    sha256: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/, "sha256 must be 64 lowercase hex characters without a prefix.")
+        .optional()
+        .describe("Optional SHA-256 content digest: exactly 64 lowercase hex characters, no `sha256:` prefix (Version.manifestHash is the only prefixed form). Omit it for fastest first uploads; include it on updates so unchanged files are never re-uploaded."),
+    contentType: z.string().optional().describe("Optional content type for serving metadata."),
+    sourceUrl: z
+        .string()
+        .url()
+        .optional()
+        .describe("Optional HTTPS URL the runtime can fetch directly for this file instead of receiving bytes from the client."),
+});
+export const pendingUploadSchema = manifestFileSchema.pick({
+    path: true,
+    size: true,
+    sha256: true,
+    sourceUrl: true,
+});
+export const uploadSessionModeSchema = z
+    .enum(["dist", "source"])
+    .describe("`dist` bytes are deployable output; `source` bytes must be transformed, unpacked, or built before deploy.");
+export const uploadTargetSchema = z.object({
+    path: z.string().describe("Caller-local path/key identifying the bytes this target accepts."),
+    method: z.enum(["PUT", "POST"]).describe("HTTP method to use for this target."),
+    url: z
+        .string()
+        .url()
+        .or(z.string().startsWith("/"))
+        .describe("Absolute or API-relative upload URL issued by the control plane."),
+    headers: z
+        .record(z.string().min(1), z.string())
+        .default({})
+        .describe("Exact headers to send with the upload request."),
+    body: z
+        .discriminatedUnion("kind", [z.object({ kind: z.literal("url"), url: z.string().url() })])
+        .optional()
+        .describe("Optional body recipe. Omitted means the client uploads the local bytes for `path`; `url` means POST the URL for server-side fetch."),
+    size: z.number().int().nonnegative().optional().describe("Expected byte size when known."),
+    maxBytes: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Maximum accepted byte size when the server can advertise it."),
+    sha256: z
+        .string()
+        .regex(/^[0-9a-f]{64}$/, "sha256 must be 64 lowercase hex characters without a prefix.")
+        .optional(),
+    contentType: z.string().optional(),
+});
+export const uploadInstructionsSchema = z.object({
+    id: z.string().min(1).describe("Upload session id (upl_…) minted by the runtime."),
+    mode: uploadSessionModeSchema,
+    expiresAt: z
+        .string()
+        .datetime()
+        .describe("Session-token expiry. Token rotation only, never a version-lifecycle boundary: resume always mints a fresh token."),
+    summary: z
+        .object({
+        upload: z.number().int().nonnegative().describe("Files that still need uploading."),
+        reused: z.number().int().nonnegative().describe("Files satisfied by hash reuse."),
+        ignored: z.number().int().nonnegative().describe("Files ignored by plan policy."),
+    })
+        .describe("Counts for the whole manifest, independent of target paging."),
+    targets: z
+        .array(uploadTargetSchema)
+        .default([])
+        .describe("Opaque upload targets, bounded by the instruction payload budget. Upload these, then call `links.resume` for the remainder."),
+    links: z.object({
+        resume: z.string(),
+        finalize: z.string(),
+    }),
+    details: z
+        .object({
+        reused: z.array(z.object({ path: z.string(), reason: z.string() })).optional(),
+        ignored: z.array(z.object({ path: z.string(), reason: z.string() })).optional(),
+        diagnostics: z.array(baseDiagnosticSchema).optional(),
+    })
+        .optional(),
+});