@spacefast/common 0.2.1 → 0.4.1

package/dist/contracts/runtime-api.js

@@ -1,13 +1,15 @@
 import { z } from "zod";
 import { CONTENT_SNIFF_KINDS } from "../utils/content-type.js";
 import { accessFenceKindSchema } from "./access.js";
+import { applicationJournalDeliveryClaimV1Schema, applicationJournalDeliveryReceiptV1Schema, } from "./application-journal.js";
 import { functionsRuntimeConfigSchema } from "./functions.js";
 import { grantSchema } from "./grants.js";
 import { manifestFileSchema } from "./internal.js";
 import { runtimePagesSchema } from "./pages.js";
+import { routeInventoryKindSchema } from "./route-inventory.js";
 import { runtimePurgeStatusSchema } from "./runtime-purge.js";
 import { SPACE_CONFIG_CAPS } from "./space-config.js";
-import { zeroEndpointSchema, zeroRuntimeConfigSchema } from "./zero.js";
+import { zeroEndpointSchema, zeroExecutionModeSchema, zeroRuntimeConfigSchema } from "./zero.js";
 const hostCanonicalRedirectSchema = z.object({
     from: z.string().min(1),
     to: z.string().url(),
@@ -317,10 +319,15 @@ const runtimeRouteConfigSchema = z.object({
 // content defaults (root index.html => website-style, otherwise artifact-style
 // listing + viewer).
 const runtimeServingConfigSchema = z.object({
+    directory_index: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Resolved directory index filename, independent of the inferred homepage."),
     index: z
         .union([z.string().min(1), z.literal(false)])
         .optional()
-        .describe("Directory index file name, or `false` to disable directory index resolution."),
+        .describe("Homepage file, or `false` when no homepage is selected."),
     fallback: z
         .object({
         path: z.string().min(1).describe("Committed file served when no exact route matches."),
@@ -365,12 +372,10 @@ const runtimeServingConfigSchema = z.object({
         .optional()
         .describe("Finalize-resolved listing, viewer, sharing, and browser icon metadata (effective SpaceConfig metadata). This value wins over session metadata."),
     pages: runtimePagesSchema.optional(),
-    // Hidden experimental build-pipeline flag. Only ever sent as true.
-    experimental_gutenberg: z.boolean().optional(),
     // Platform-owned head metadata injection: enables missing title,
     // description, favicon, OG, and Twitter tags from finalized SpaceConfig meta.
     platform_meta: z.boolean().optional(),
-    // Sent only when experimental_gutenberg is true. The char caps here are a
+    // Sent whenever the space configures snippets. The char caps here are a
     // sanity bound; the byte caps live in the shared SpaceConfig validator.
     inject: z
         .object({
@@ -389,9 +394,15 @@ const runtimeZeroEndpointCapabilitiesSchema = z
     env: z.boolean().optional(),
     realtime: z.boolean().optional(),
     logging: z.boolean().optional(),
+    gravatar: z.boolean().optional(),
+    spam: z.boolean().optional(),
+    email: z.boolean().optional(),
+    content: z.boolean().optional(),
+    storage: z.boolean().optional(),
 })
     .default({});
 const runtimeZeroEndpointSchema = z.object({
+    execution_mode: zeroExecutionModeSchema,
     method: zeroEndpointSchema.shape.method,
     path: zeroEndpointSchema.shape.path,
     source: z
@@ -404,6 +415,7 @@ const runtimeZeroEndpointSchema = z.object({
     db: z.record(z.string(), z.unknown()).optional(),
 });
 const runtimeZeroRunSchema = z.object({
+    execution_mode: zeroExecutionModeSchema,
     run_id: z.string().min(1).max(256),
     source: z
         .string()
@@ -469,6 +481,11 @@ export const runtimeVersionFinalizeRequestSchema = z.object({
     serving: z
         .object({
         noindexHost: z.boolean().optional(),
+        // Finalize-generated site theme shared by static, Zero, and WordPress pages.
+        theme_css: z
+            .string()
+            .max(16 * 1024)
+            .optional(),
         config: runtimeServingConfigSchema.optional(),
         // Origins the platform's own browser code loads from, keyed by the CSP
         // directive each belongs in. The control plane picks them, validated
@@ -545,16 +562,7 @@ export const runtimeRouteInventorySchema = z.object({
     format: z.literal("stattic.route-inventory.v1"),
     routes: z.array(z.object({
         id: z.string().regex(/^sha256:[a-f0-9]{64}$/),
-        kind: z.enum([
-            "redirect",
-            "rewrite",
-            "proxy",
-            "not-found",
-            "functions",
-            "php-function",
-            "zero-control",
-            "zero-endpoint",
-        ]),
+        kind: routeInventoryKindSchema,
         source: z.string().min(1),
         runtime: z.enum(["routing", "cloudflare-worker", "php", "quick-js"]),
         host: z.string().min(1),
@@ -968,6 +976,43 @@ export const runtimeEventsAckResponseSchema = z.object({
         .optional()
         .describe("The committed journal coordinate. Absent after a legacy delivery acknowledgement."),
 });
+export const runtimeApplicationJournalDrainRequestSchema = z
+    .object({
+    sink: z.string().min(1).max(160),
+    limit: z.number().int().min(1).max(50).optional(),
+    lease_seconds: z.number().int().min(5).max(900).optional(),
+})
+    .strict();
+export const runtimeApplicationJournalDrainResponseSchema = z
+    .object({
+    claims: z.array(applicationJournalDeliveryClaimV1Schema).max(50),
+})
+    .strict();
+export const runtimeApplicationJournalCompleteRequestSchema = z
+    .object({
+    receipts: z.array(applicationJournalDeliveryReceiptV1Schema).max(50),
+})
+    .strict();
+export const runtimeApplicationJournalCompleteResponseSchema = z
+    .object({
+    recorded: z.number().int().nonnegative(),
+    stale: z.number().int().nonnegative(),
+})
+    .strict();
+export const runtimeApplicationJournalMailRequestSchema = z
+    .object({
+    claim: applicationJournalDeliveryClaimV1Schema,
+})
+    .strict()
+    .refine((request) => request.claim.entry.kind === "mail", {
+    path: ["claim", "entry", "kind"],
+    message: "the WordPress mail lane accepts only mail journal entries",
+});
+export const runtimeApplicationJournalMailResponseSchema = z
+    .object({
+    message_id: z.string().min(1).max(255),
+})
+    .strict();
 // One lane; the enum keeps its single value because the engine's job record and
 // tick response still carry the field.
 export const runtimeEngineJobLaneSchema = z.literal("bulk");

package/dist/contracts/runtime-app.d.ts

@@ -51,8 +51,11 @@ export declare const runtimeAppSchema: z.ZodObject<{
         tables: z.ZodDefault<z.ZodArray<z.ZodString>>;
         queries: z.ZodDefault<z.ZodArray<z.ZodString>>;
         mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
         endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            mode: z.ZodEnum<{
+                read: "read";
+                write: "write";
+            }>;
             method: z.ZodEnum<{
                 POST: "POST";
                 PUT: "PUT";
@@ -122,6 +125,8 @@ export declare const runtimeAppSchema: z.ZodObject<{
             spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             content: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            storage: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            connectors: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
         executionState: z.ZodEnum<{
             ready: "ready";