@spacefast/common 0.0.11 → 0.0.13

package/dist/contracts/zero.d.ts

@@ -1,4 +1,15 @@
 import { z } from "zod";
+/**
+ * Spacefast Zero: capsules — schema, queries, mutations and endpoints that run
+ * together inside one parent-owned transaction — executed by the native runner
+ * on a dedicated wp.cloud site, against that site's own MySQL.
+ *
+ * The transaction is what makes this a separate product rather than a
+ * placement option for `./functions.js`. A capsule handler's semantics depend
+ * on the transaction wrapped around it, and an isolate reaching the database
+ * over a relay cannot offer one. See `endpointIsPortable` in `./execution.js`
+ * for the narrow surface both products can host.
+ */
 export declare const ZERO_SOURCE_METADATA_KEY = "statticZero";
 export declare const ZERO_RUNTIME_KIND = "zero";
 export declare const ZERO_PLATFORM_ROUTE_PREFIX = "/__spacefast/zero";
@@ -17,7 +28,7 @@ export declare const ZERO_RUNTIME_ROUTE_PATHS: {
 export declare const ZERO_RUNTIME_STORAGE_ROOT = "__spacefast/zero";
 export declare const ZERO_RUNTIME_ARTIFACT_PATH = "__spacefast/zero/artifact.json";
 export declare const ZERO_RUNTIME_CONFIG_PATH = "__spacefast/zero/config.json";
-export declare const ZERO_RUNTIME_BINARY_PATH = "__spacefast/zero/bin/stattic-zero-runner";
+export declare const ZERO_RUNTIME_BINARY_PATH = "__spacefast/zero/bin/stattic-runtime";
 export declare const ZERO_RUNTIME_BINARY_COMPATIBILITY_TARGET = "wpcloud-linux-x86_64-gnu-v1";
 export declare const ZERO_RUNTIME_BUNDLE_ROOT = "__spacefast/zero/bundles";
 export declare const ZERO_RUNTIME_CLIENT_BUNDLE_PATH = "__spacefast/zero/bundles/client.js";
@@ -26,35 +37,18 @@ export declare const ZERO_SOURCE_ENV_FILE = ".env.zero.server";
 export declare const ZERO_CONFIG_FILE = "zero.json";
 export declare const ZERO_DEPLOY_FILE = ".zero/deploy.json";
 export declare const ZERO_RUNTIME_BUNDLE_MAX_BYTES = 786432;
-export declare const ZERO_ENV_MAX_KEYS = 64;
-export declare const ZERO_ENV_NAME_MAX_BYTES = 128;
-export declare const ZERO_ENV_VALUE_MAX_BYTES: number;
-export declare const ZERO_ENV_TOTAL_VALUE_MAX_BYTES: number;
-export declare const ZERO_ENV_RESERVED_PREFIXES: readonly ["SPACEFAST_", "ZERO_"];
 export declare const ZERO_MANAGED_TABLE_COLUMNS: readonly ["id", "createdAt", "updatedAt"];
-export declare const ZERO_RESERVED_APP_ROUTE_PATHS: readonly ["/", "/index.html", "/client.js", "/auth/callback", "/__spacefast", "/__span"];
-export declare const ZERO_RESERVED_APP_ROUTE_PREFIXES: readonly ["/auth/", "/__spacefast/", "/__span/"];
-export declare const zeroRuntimeKindSchema: z.ZodEnum<{
-    zero: "zero";
-    static: "static";
-    php: "php";
-    node: "node";
-    workers: "workers";
-}>;
-export type ZeroRuntimeKind = z.infer<typeof zeroRuntimeKindSchema>;
-export declare const zeroHttpMethodSchema: z.ZodEnum<{
-    PUT: "PUT";
-    POST: "POST";
-    GET: "GET";
-    HEAD: "HEAD";
-    PATCH: "PATCH";
-    DELETE: "DELETE";
-    OPTIONS: "OPTIONS";
-}>;
+/**
+ * Paths the Zero app shell itself answers, on top of the platform-reserved set
+ * in `./execution.js`. A capsule cannot claim these because its own client
+ * router and auth flow already do.
+ */
+export declare const ZERO_RESERVED_APP_ROUTE_PATHS: readonly ["/", "/index.html", "/client.js", "/auth/callback"];
+export declare const ZERO_RESERVED_APP_ROUTE_PREFIXES: readonly ["/auth/"];
 export declare const zeroEndpointSchema: z.ZodObject<{
     method: z.ZodEnum<{
-        PUT: "PUT";
         POST: "POST";
+        PUT: "PUT";
         GET: "GET";
         HEAD: "HEAD";
         PATCH: "PATCH";
@@ -64,6 +58,7 @@ export declare const zeroEndpointSchema: z.ZodObject<{
     path: z.ZodString;
 }, z.core.$strict>;
 export type ZeroEndpoint = z.infer<typeof zeroEndpointSchema>;
+export declare function zeroEndpointRoutesAmbiguous(left: ZeroEndpoint, right: ZeroEndpoint): boolean;
 export declare const zeroTableColumnSchema: z.ZodObject<{
     name: z.ZodString;
     type: z.ZodEnum<{
@@ -106,6 +101,12 @@ export declare const zeroDatabaseSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
     }, z.core.$strict>>>;
 }, z.core.$strict>>;
 export type ZeroDatabase = z.infer<typeof zeroDatabaseSchema>;
+/**
+ * Zero's bundles travel inline in the finalize payload — a capsule's compiled
+ * client and server fit comfortably under the ceiling, and inlining keeps the
+ * whole version one atomic write. Functions bundles do the opposite and land
+ * in the content store first; see `functionsBundleRefSchema`.
+ */
 export declare const zeroRuntimeBundleSchema: z.ZodObject<{
     path: z.ZodString;
     sha256: z.ZodString;
@@ -136,6 +137,31 @@ export declare const zeroRuntimeRunSourceSchema: z.ZodObject<{
     db: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 export type ZeroRuntimeRunSource = z.infer<typeof zeroRuntimeRunSourceSchema>;
+export declare const zeroRuntimeEndpointSourceSchema: z.ZodObject<{
+    method: z.ZodEnum<{
+        POST: "POST";
+        PUT: "PUT";
+        GET: "GET";
+        HEAD: "HEAD";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+    }>;
+    path: z.ZodString;
+    endpointId: z.ZodString;
+    source: z.ZodString;
+    schemaHash: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodDefault<z.ZodObject<{
+        db: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        fetch: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        auth: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+    db: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type ZeroRuntimeEndpointSource = z.infer<typeof zeroRuntimeEndpointSourceSchema>;
 export declare const zeroMigrationOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     op: z.ZodLiteral<"create_table">;
     table: z.ZodString;
@@ -312,7 +338,7 @@ export declare const zeroRuntimeInstallProfileSchema: z.ZodObject<{
     artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
     configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
     binary: z.ZodObject<{
-        path: z.ZodLiteral<"__spacefast/zero/bin/stattic-zero-runner">;
+        path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
         compatibilityTarget: z.ZodObject<{
             profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
             os: z.ZodLiteral<"linux">;
@@ -410,8 +436,8 @@ export declare const zeroCapsuleArtifactSchema: z.ZodObject<{
         mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
         endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
             method: z.ZodEnum<{
-                PUT: "PUT";
                 POST: "POST";
+                PUT: "PUT";
                 GET: "GET";
                 HEAD: "HEAD";
                 PATCH: "PATCH";
@@ -522,7 +548,7 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
         artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
         configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
         binary: z.ZodObject<{
-            path: z.ZodLiteral<"__spacefast/zero/bin/stattic-zero-runner">;
+            path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
             compatibilityTarget: z.ZodObject<{
                 profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
                 os: z.ZodLiteral<"linux">;
@@ -571,8 +597,8 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
             mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
             endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 method: z.ZodEnum<{
-                    PUT: "PUT";
                     POST: "POST";
+                    PUT: "PUT";
                     GET: "GET";
                     HEAD: "HEAD";
                     PATCH: "PATCH";
@@ -686,6 +712,30 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
         size: z.ZodNumber;
         contentBase64: z.ZodString;
     }, z.core.$strict>>>;
+    endpointSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        method: z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>;
+        path: z.ZodString;
+        endpointId: z.ZodString;
+        source: z.ZodString;
+        schemaHash: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodDefault<z.ZodObject<{
+            db: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            fetch: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            auth: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        }, z.core.$strip>>;
+        db: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
     runSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
         runId: z.ZodString;
         source: z.ZodString;
@@ -786,6 +836,253 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type ZeroRuntimeFinalizePayload = z.infer<typeof zeroRuntimeFinalizePayloadSchema>;
+export declare const zeroRuntimeConfigSchema: z.ZodObject<{
+    auth: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodLiteral<"wpcom">>;
+        signInPath: z.ZodDefault<z.ZodNullable<z.ZodLiteral<"/__spacefast/zero/auth/wpcom/start">>>;
+        signInUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        signOutPath: z.ZodDefault<z.ZodNullable<z.ZodLiteral<"/__spacefast/zero/auth/sign-out">>>;
+        signOutUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        returnToParam: z.ZodDefault<z.ZodString>;
+    }, z.core.$strict>>;
+    realtime: z.ZodObject<{
+        mode: z.ZodEnum<{
+            "stattic-central": "stattic-central";
+            "spacefast-cast": "spacefast-cast";
+            "local-dev": "local-dev";
+        }>;
+        centralUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        replayUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        castResourceKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        eventCallback: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            token: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    variables: z.ZodObject<{
+        source: z.ZodLiteral<"stattic-variables">;
+        names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    artifact: z.ZodObject<{
+        format: z.ZodLiteral<"stattic.zero.capsule.v1">;
+        appName: z.ZodString;
+        serverRuntime: z.ZodLiteral<"quickjs-rust">;
+        client: z.ZodObject<{
+            bundlePath: z.ZodString;
+            basePathAware: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>;
+        server: z.ZodObject<{
+            bundlePath: z.ZodString;
+            schema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                name: z.ZodString;
+                columns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        json: "json";
+                    }>;
+                    nullable: z.ZodDefault<z.ZodBoolean>;
+                    default: z.ZodOptional<z.ZodUnknown>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>;
+            queries: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                method: z.ZodEnum<{
+                    POST: "POST";
+                    PUT: "PUT";
+                    GET: "GET";
+                    HEAD: "HEAD";
+                    PATCH: "PATCH";
+                    DELETE: "DELETE";
+                    OPTIONS: "OPTIONS";
+                }>;
+                path: z.ZodString;
+            }, z.core.$strict>>>;
+            sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+        db: z.ZodObject<{
+            backend: z.ZodLiteral<"wpcloud-mysql">;
+            migrations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                op: z.ZodLiteral<"create_table">;
+                table: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                op: z.ZodLiteral<"add_column">;
+                table: z.ZodString;
+                column: z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        json: "json";
+                    }>;
+                    nullable: z.ZodDefault<z.ZodBoolean>;
+                    default: z.ZodOptional<z.ZodUnknown>;
+                }, z.core.$strict>;
+            }, z.core.$strict>, z.ZodObject<{
+                op: z.ZodLiteral<"add_index">;
+                table: z.ZodString;
+                columns: z.ZodArray<z.ZodString>;
+                unique: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>, z.ZodObject<{
+                op: z.ZodLiteral<"drop_table">;
+                table: z.ZodString;
+                explicit: z.ZodLiteral<"drop">;
+            }, z.core.$strict>, z.ZodObject<{
+                op: z.ZodLiteral<"drop_column">;
+                table: z.ZodString;
+                column: z.ZodString;
+                explicit: z.ZodLiteral<"drop">;
+            }, z.core.$strict>, z.ZodObject<{
+                op: z.ZodLiteral<"rename_table">;
+                from: z.ZodString;
+                to: z.ZodString;
+                explicit: z.ZodLiteral<"rename">;
+            }, z.core.$strict>, z.ZodObject<{
+                op: z.ZodLiteral<"rename_column">;
+                table: z.ZodString;
+                from: z.ZodString;
+                to: z.ZodString;
+                explicit: z.ZodLiteral<"rename">;
+            }, z.core.$strict>], "op">>>;
+        }, z.core.$strict>;
+        realtime: z.ZodObject<{
+            mode: z.ZodEnum<{
+                "stattic-central": "stattic-central";
+                "spacefast-cast": "spacefast-cast";
+                "local-dev": "local-dev";
+            }>;
+            mutationEvents: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>;
+        limits: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        futureCapabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            ai: "ai";
+            blob: "blob";
+            "generalized-js": "generalized-js";
+        }>>>;
+        sourceManifest: z.ZodObject<{
+            entries: z.ZodObject<{
+                client: z.ZodLiteral<"client/index.tsx">;
+                server: z.ZodLiteral<"server/index.ts">;
+            }, z.core.$strict>;
+            sourceRoot: z.ZodString;
+            files: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                size: z.ZodNumber;
+                sha256: z.ZodString;
+            }, z.core.$strict>>>;
+            env: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                file: z.ZodLiteral<".env.zero.server">;
+                names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
+            sourceConfig: z.ZodDefault<z.ZodObject<{
+                configFile: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                    path: z.ZodLiteral<"zero.json">;
+                    appName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    deployId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    title: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strip>>>;
+                deployFile: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                    path: z.ZodLiteral<".zero/deploy.json">;
+                    keys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    runtimeKind: z.ZodLiteral<"zero">;
+    inspect: z.ZodDefault<z.ZodObject<{
+        policy: z.ZodDefault<z.ZodEnum<{
+            public: "public";
+            private: "private";
+        }>>;
+    }, z.core.$strict>>;
+    migrations: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        format: z.ZodLiteral<"stattic.zero.migrations.v1">;
+        mode: z.ZodDefault<z.ZodEnum<{
+            safe: "safe";
+            drop: "drop";
+            rename: "rename";
+        }>>;
+        schemaHash: z.ZodString;
+        operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            op: z.ZodLiteral<"create_table">;
+            table: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            op: z.ZodLiteral<"add_column">;
+            table: z.ZodString;
+            column: z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    json: "json";
+                }>;
+                nullable: z.ZodDefault<z.ZodBoolean>;
+                default: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            op: z.ZodLiteral<"add_index">;
+            table: z.ZodString;
+            columns: z.ZodArray<z.ZodString>;
+            unique: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            op: z.ZodLiteral<"drop_table">;
+            table: z.ZodString;
+            explicit: z.ZodLiteral<"drop">;
+        }, z.core.$strict>, z.ZodObject<{
+            op: z.ZodLiteral<"drop_column">;
+            table: z.ZodString;
+            column: z.ZodString;
+            explicit: z.ZodLiteral<"drop">;
+        }, z.core.$strict>, z.ZodObject<{
+            op: z.ZodLiteral<"rename_table">;
+            from: z.ZodString;
+            to: z.ZodString;
+            explicit: z.ZodLiteral<"rename">;
+        }, z.core.$strict>, z.ZodObject<{
+            op: z.ZodLiteral<"rename_column">;
+            table: z.ZodString;
+            from: z.ZodString;
+            to: z.ZodString;
+            explicit: z.ZodLiteral<"rename">;
+        }, z.core.$strict>], "op">>;
+    }, z.core.$strict>>>;
+    install: z.ZodObject<{
+        runtimeKind: z.ZodLiteral<"zero">;
+        engine: z.ZodLiteral<"quickjs-rust">;
+        storageRoot: z.ZodLiteral<"__spacefast/zero">;
+        artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
+        configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
+        binary: z.ZodObject<{
+            path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
+            compatibilityTarget: z.ZodObject<{
+                profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                os: z.ZodLiteral<"linux">;
+                cpu: z.ZodLiteral<"x86_64">;
+                libc: z.ZodLiteral<"glibc">;
+                linking: z.ZodLiteral<"dynamic">;
+                requireExecutableBit: z.ZodLiteral<true>;
+            }, z.core.$strict>;
+            sha256: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            required: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+        mysql: z.ZodObject<{
+            migrateAtFinalize: z.ZodLiteral<true>;
+            blockIncompatibleRollback: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+        realtime: z.ZodObject<{
+            production: z.ZodLiteral<"stattic-central">;
+            local: z.ZodLiteral<"foreground-cli-ws">;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    variableValues: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export type ZeroRuntimeConfig = z.infer<typeof zeroRuntimeConfigSchema>;
 export declare const zeroDeployMetadataSchema: z.ZodObject<{
     artifactId: z.ZodOptional<z.ZodString>;
     finalize: z.ZodObject<{
@@ -797,7 +1094,7 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
             artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
             configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
             binary: z.ZodObject<{
-                path: z.ZodLiteral<"__spacefast/zero/bin/stattic-zero-runner">;
+                path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
                 compatibilityTarget: z.ZodObject<{
                     profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
                     os: z.ZodLiteral<"linux">;
@@ -846,8 +1143,8 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
                 mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
                 endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
                     method: z.ZodEnum<{
-                        PUT: "PUT";
                         POST: "POST";
+                        PUT: "PUT";
                         GET: "GET";
                         HEAD: "HEAD";
                         PATCH: "PATCH";
@@ -961,6 +1258,30 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
             size: z.ZodNumber;
             contentBase64: z.ZodString;
         }, z.core.$strict>>>;
+        endpointSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            method: z.ZodEnum<{
+                POST: "POST";
+                PUT: "PUT";
+                GET: "GET";
+                HEAD: "HEAD";
+                PATCH: "PATCH";
+                DELETE: "DELETE";
+                OPTIONS: "OPTIONS";
+            }>;
+            path: z.ZodString;
+            endpointId: z.ZodString;
+            source: z.ZodString;
+            schemaHash: z.ZodOptional<z.ZodString>;
+            capabilities: z.ZodDefault<z.ZodObject<{
+                db: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                fetch: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                auth: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            }, z.core.$strip>>;
+            db: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
         runSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
             runId: z.ZodString;
             source: z.ZodString;
@@ -1062,171 +1383,93 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type ZeroDeployMetadata = z.infer<typeof zeroDeployMetadataSchema>;
-export declare const zeroInspectResponseSchema: z.ZodObject<{
-    versionId: z.ZodNullable<z.ZodString>;
-    artifactId: z.ZodNullable<z.ZodString>;
-    data: z.ZodNullable<z.ZodObject<{
+/**
+ * What a live Zero capsule is, as the `app` member of a space's runtime status.
+ *
+ * There is no `versionId` here: this only ever describes the version the status
+ * response already names as live, and repeating it would invite the two to
+ * disagree. `artifactId` stays because it identifies the built capsule rather
+ * than the publish that carries it.
+ */
+export declare const zeroAppSchema: z.ZodObject<{
+    runtimeKind: z.ZodLiteral<"zero">;
+    artifactId: z.ZodString;
+    appName: z.ZodString;
+    serverRuntime: z.ZodLiteral<"quickjs-rust">;
+    inspect: z.ZodObject<{
+        policy: z.ZodEnum<{
+            public: "public";
+            private: "private";
+        }>;
+    }, z.core.$strict>;
+    install: z.ZodObject<{
         runtimeKind: z.ZodLiteral<"zero">;
-        appName: z.ZodString;
-        serverRuntime: z.ZodLiteral<"quickjs-rust">;
-        inspect: z.ZodObject<{
-            policy: z.ZodEnum<{
-                public: "public";
-                private: "private";
-            }>;
-        }, z.core.$strict>;
-        install: z.ZodObject<{
-            runtimeKind: z.ZodLiteral<"zero">;
-            engine: z.ZodLiteral<"quickjs-rust">;
-            storageRoot: z.ZodLiteral<"__spacefast/zero">;
-            artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
-            configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
-            binary: z.ZodObject<{
-                path: z.ZodLiteral<"__spacefast/zero/bin/stattic-zero-runner">;
-                compatibilityTarget: z.ZodObject<{
-                    profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
-                    os: z.ZodLiteral<"linux">;
-                    cpu: z.ZodLiteral<"x86_64">;
-                    libc: z.ZodLiteral<"glibc">;
-                    linking: z.ZodLiteral<"dynamic">;
-                    requireExecutableBit: z.ZodLiteral<true>;
-                }, z.core.$strict>;
-                sha256: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-                required: z.ZodLiteral<true>;
-            }, z.core.$strict>;
-            mysql: z.ZodObject<{
-                migrateAtFinalize: z.ZodLiteral<true>;
-                blockIncompatibleRollback: z.ZodLiteral<true>;
-            }, z.core.$strict>;
-            realtime: z.ZodObject<{
-                production: z.ZodLiteral<"stattic-central">;
-                local: z.ZodLiteral<"foreground-cli-ws">;
+        engine: z.ZodLiteral<"quickjs-rust">;
+        storageRoot: z.ZodLiteral<"__spacefast/zero">;
+        artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
+        configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
+        binary: z.ZodObject<{
+            path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
+            compatibilityTarget: z.ZodObject<{
+                profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                os: z.ZodLiteral<"linux">;
+                cpu: z.ZodLiteral<"x86_64">;
+                libc: z.ZodLiteral<"glibc">;
+                linking: z.ZodLiteral<"dynamic">;
+                requireExecutableBit: z.ZodLiteral<true>;
             }, z.core.$strict>;
+            sha256: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            required: z.ZodLiteral<true>;
         }, z.core.$strict>;
-        tables: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        queries: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            method: z.ZodEnum<{
-                PUT: "PUT";
-                POST: "POST";
-                GET: "GET";
-                HEAD: "HEAD";
-                PATCH: "PATCH";
-                DELETE: "DELETE";
-                OPTIONS: "OPTIONS";
-            }>;
-            path: z.ZodString;
-        }, z.core.$strict>>>;
-        sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        variables: z.ZodObject<{
-            source: z.ZodLiteral<"stattic-variables">;
-            names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        mysql: z.ZodObject<{
+            migrateAtFinalize: z.ZodLiteral<true>;
+            blockIncompatibleRollback: z.ZodLiteral<true>;
         }, z.core.$strict>;
         realtime: z.ZodObject<{
-            mode: z.ZodEnum<{
-                "stattic-central": "stattic-central";
-                "spacefast-cast": "spacefast-cast";
-                "local-dev": "local-dev";
-                "local-websocket": "local-websocket";
-            }>;
-            centralUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            path: z.ZodOptional<z.ZodString>;
-            replayPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            replayUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            runPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            resourceKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            socketPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            spaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            versionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            production: z.ZodLiteral<"stattic-central">;
+            local: z.ZodLiteral<"foreground-cli-ws">;
         }, z.core.$strict>;
-    }, z.core.$strip>>;
-}, z.core.$strict>;
-export type ZeroInspectResponse = z.infer<typeof zeroInspectResponseSchema>;
-export declare const zeroInspectPublicResponseSchema: z.ZodObject<{
-    data: z.ZodObject<{
-        versionId: z.ZodNullable<z.ZodString>;
-        artifactId: z.ZodNullable<z.ZodString>;
-        data: z.ZodNullable<z.ZodObject<{
-            runtimeKind: z.ZodLiteral<"zero">;
-            appName: z.ZodString;
-            serverRuntime: z.ZodLiteral<"quickjs-rust">;
-            inspect: z.ZodObject<{
-                policy: z.ZodEnum<{
-                    public: "public";
-                    private: "private";
-                }>;
-            }, z.core.$strict>;
-            install: z.ZodObject<{
-                runtimeKind: z.ZodLiteral<"zero">;
-                engine: z.ZodLiteral<"quickjs-rust">;
-                storageRoot: z.ZodLiteral<"__spacefast/zero">;
-                artifactPath: z.ZodLiteral<"__spacefast/zero/artifact.json">;
-                configPath: z.ZodLiteral<"__spacefast/zero/config.json">;
-                binary: z.ZodObject<{
-                    path: z.ZodLiteral<"__spacefast/zero/bin/stattic-zero-runner">;
-                    compatibilityTarget: z.ZodObject<{
-                        profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
-                        os: z.ZodLiteral<"linux">;
-                        cpu: z.ZodLiteral<"x86_64">;
-                        libc: z.ZodLiteral<"glibc">;
-                        linking: z.ZodLiteral<"dynamic">;
-                        requireExecutableBit: z.ZodLiteral<true>;
-                    }, z.core.$strict>;
-                    sha256: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-                    required: z.ZodLiteral<true>;
-                }, z.core.$strict>;
-                mysql: z.ZodObject<{
-                    migrateAtFinalize: z.ZodLiteral<true>;
-                    blockIncompatibleRollback: z.ZodLiteral<true>;
-                }, z.core.$strict>;
-                realtime: z.ZodObject<{
-                    production: z.ZodLiteral<"stattic-central">;
-                    local: z.ZodLiteral<"foreground-cli-ws">;
-                }, z.core.$strict>;
-            }, z.core.$strict>;
-            tables: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            queries: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                method: z.ZodEnum<{
-                    PUT: "PUT";
-                    POST: "POST";
-                    GET: "GET";
-                    HEAD: "HEAD";
-                    PATCH: "PATCH";
-                    DELETE: "DELETE";
-                    OPTIONS: "OPTIONS";
-                }>;
-                path: z.ZodString;
-            }, z.core.$strict>>>;
-            sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            variables: z.ZodObject<{
-                source: z.ZodLiteral<"stattic-variables">;
-                names: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            }, z.core.$strict>;
-            realtime: z.ZodObject<{
-                mode: z.ZodEnum<{
-                    "stattic-central": "stattic-central";
-                    "spacefast-cast": "spacefast-cast";
-                    "local-dev": "local-dev";
-                    "local-websocket": "local-websocket";
-                }>;
-                centralUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-                path: z.ZodOptional<z.ZodString>;
-                replayPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                replayUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                runPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                resourceKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                socketPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                spaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                versionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            }, z.core.$strict>;
-        }, z.core.$strip>>;
     }, z.core.$strict>;
-}, z.core.$strip>;
+    tables: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    queries: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    mutations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    endpoints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        method: z.ZodEnum<{
+            POST: "POST";
+            PUT: "PUT";
+            GET: "GET";
+            HEAD: "HEAD";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+        }>;
+        path: z.ZodString;
+    }, z.core.$strict>>>;
+    sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    variables: z.ZodObject<{
+        source: z.ZodLiteral<"stattic-variables">;
+        names: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    realtime: z.ZodObject<{
+        mode: z.ZodEnum<{
+            "stattic-central": "stattic-central";
+            "spacefast-cast": "spacefast-cast";
+            "local-dev": "local-dev";
+            "local-websocket": "local-websocket";
+        }>;
+        centralUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        path: z.ZodOptional<z.ZodString>;
+        replayPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        replayUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        runPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        resourceKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        socketPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        spaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        versionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ZeroApp = z.infer<typeof zeroAppSchema>;
 export declare const zeroDbInspectResponseSchema: z.ZodObject<{
     versionId: z.ZodNullable<z.ZodString>;
     artifactId: z.ZodNullable<z.ZodString>;
@@ -1399,7 +1642,7 @@ export declare const zeroLogListQuerySchema: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     cursor: z.ZodOptional<z.ZodString>;
     requestId: z.ZodOptional<z.ZodString>;
-    mutationName: z.ZodOptional<z.ZodString>;
+    handlerName: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type ZeroLogListQuery = z.infer<typeof zeroLogListQuerySchema>;
 export declare const zeroLogEntrySchema: z.ZodObject<{
@@ -1413,7 +1656,7 @@ export declare const zeroLogEntrySchema: z.ZodObject<{
     }>;
     requestId: z.ZodNullable<z.ZodString>;
     versionId: z.ZodNullable<z.ZodString>;
-    mutationName: z.ZodNullable<z.ZodString>;
+    handlerName: z.ZodNullable<z.ZodString>;
     message: z.ZodString;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
@@ -1429,7 +1672,7 @@ export declare const zeroLogListResponseSchema: z.ZodObject<{
         }>;
         requestId: z.ZodNullable<z.ZodString>;
         versionId: z.ZodNullable<z.ZodString>;
-        mutationName: z.ZodNullable<z.ZodString>;
+        handlerName: z.ZodNullable<z.ZodString>;
         message: z.ZodString;
         metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>>;
@@ -1519,6 +1762,7 @@ export declare function createZeroRuntimeFinalizePayload(input: {
     artifact: z.input<typeof zeroCapsuleArtifactSchema>;
     bundles?: z.input<typeof zeroRuntimeBundleSchema>[];
     staticFiles?: z.input<typeof zeroRuntimeStaticFileSchema>[];
+    endpointSources?: z.input<typeof zeroRuntimeEndpointSourceSchema>[];
     runSources?: z.input<typeof zeroRuntimeRunSourceSchema>[];
     migrations?: z.input<typeof zeroMigrationPlanSchema> | null;
     runnerSha256?: string | null;