@spacefast/common 0.0.9 → 0.0.10

package/dist/contracts/resources.d.ts

@@ -162,37 +162,13 @@ export declare const SpaceSchema: z.ZodObject<{
         }, z.core.$strip>>;
         templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
         theme: z.ZodOptional<z.ZodObject<{
-            color: z.ZodOptional<z.ZodObject<{
-                palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    slug: z.ZodString;
-                    color: z.ZodString;
-                    name: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
-            typography: z.ZodOptional<z.ZodObject<{
-                fontSizes: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    slug: z.ZodString;
-                    size: z.ZodString;
-                    name: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>>>;
-                fontFamily: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-            spacing: z.ZodOptional<z.ZodObject<{
-                spacingScale: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    slug: z.ZodString;
-                    size: z.ZodString;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        pages: z.ZodOptional<z.ZodObject<{
-            theme: z.ZodOptional<z.ZodObject<{
-                accent: z.ZodOptional<z.ZodString>;
-                background: z.ZodOptional<z.ZodString>;
-                logo: z.ZodOptional<z.ZodString>;
-                name: z.ZodOptional<z.ZodString>;
-                fontFamily: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
+            accent: z.ZodOptional<z.ZodString>;
+            background: z.ZodOptional<z.ZodString>;
+            logo: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            font: z.ZodOptional<z.ZodString>;
+            hideSpacefastBranding: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         build: z.ZodOptional<z.ZodObject<{
             rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -477,37 +453,13 @@ export declare const VersionSchema: z.ZodObject<{
         }, z.core.$strip>>;
         templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
         theme: z.ZodOptional<z.ZodObject<{
-            color: z.ZodOptional<z.ZodObject<{
-                palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    slug: z.ZodString;
-                    color: z.ZodString;
-                    name: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
-            typography: z.ZodOptional<z.ZodObject<{
-                fontSizes: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    slug: z.ZodString;
-                    size: z.ZodString;
-                    name: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>>>;
-                fontFamily: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-            spacing: z.ZodOptional<z.ZodObject<{
-                spacingScale: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    slug: z.ZodString;
-                    size: z.ZodString;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        pages: z.ZodOptional<z.ZodObject<{
-            theme: z.ZodOptional<z.ZodObject<{
-                accent: z.ZodOptional<z.ZodString>;
-                background: z.ZodOptional<z.ZodString>;
-                logo: z.ZodOptional<z.ZodString>;
-                name: z.ZodOptional<z.ZodString>;
-                fontFamily: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
+            accent: z.ZodOptional<z.ZodString>;
+            background: z.ZodOptional<z.ZodString>;
+            logo: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            font: z.ZodOptional<z.ZodString>;
+            hideSpacefastBranding: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         build: z.ZodOptional<z.ZodObject<{
             rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export declare const RUNTIME_CHANGED_PATHS_MAX = 500;
+export declare const RUNTIME_CHANGED_PATHS_MAX = 900;
 export declare const runtimeVersionCreateRequestSchema: z.ZodObject<{
     version_id: z.ZodOptional<z.ZodString>;
     files: z.ZodArray<z.ZodObject<{
@@ -75,11 +75,7 @@ export declare const runtimeVersionFinalizeRequestSchema: z.ZodObject<{
     }, z.core.$strict>>;
     template_files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     template_variants: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
-    access_pages: z.ZodOptional<z.ZodObject<{
-        challenge: z.ZodOptional<z.ZodString>;
-        deny: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    layout_template: z.ZodOptional<z.ZodString>;
+    page_artifacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     serving: z.ZodOptional<z.ZodObject<{
         headers_exact: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>>;
         headers_pattern: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -100,15 +96,16 @@ export declare const runtimeVersionFinalizeRequestSchema: z.ZodObject<{
                 image: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
             pages: z.ZodOptional<z.ZodObject<{
-                theme: z.ZodOptional<z.ZodObject<{
-                    accent: z.ZodOptional<z.ZodString>;
-                    background: z.ZodOptional<z.ZodString>;
-                    logo: z.ZodOptional<z.ZodString>;
-                    name: z.ZodOptional<z.ZodString>;
-                    fontFamily: z.ZodOptional<z.ZodString>;
+                routes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                    pages: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+                        login: "login";
+                        password: "password";
+                        denied: "denied";
+                        404: "404";
+                    }>, z.ZodString>>;
+                    index: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
-                theme_vars: z.ZodOptional<z.ZodString>;
-                white_label: z.ZodOptional<z.ZodBoolean>;
+                previews: z.ZodRecord<z.ZodString, z.ZodString>;
             }, z.core.$strip>>;
             experimental_gutenberg: z.ZodOptional<z.ZodBoolean>;
             platform_meta: z.ZodOptional<z.ZodBoolean>;
@@ -124,7 +121,6 @@ export declare const runtimeVersionFinalizeRequestSchema: z.ZodObject<{
                 noscript: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
-        theme_css: z.ZodOptional<z.ZodString>;
         zero_endpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
             method: z.ZodEnum<{
                 PUT: "PUT";
@@ -581,6 +577,7 @@ export declare const runtimeCallbackEventSchema: z.ZodObject<{
     route_name: z.ZodOptional<z.ZodString>;
     hostnames: z.ZodOptional<z.ZodArray<z.ZodString>>;
     changed_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    changed_paths_known: z.ZodOptional<z.ZodBoolean>;
     previous_version_id: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 export declare const runtimeEventsDrainResponseSchema: z.ZodObject<{
@@ -599,6 +596,7 @@ export declare const runtimeEventsDrainResponseSchema: z.ZodObject<{
             route_name: z.ZodOptional<z.ZodString>;
             hostnames: z.ZodOptional<z.ZodArray<z.ZodString>>;
             changed_paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            changed_paths_known: z.ZodOptional<z.ZodBoolean>;
             previous_version_id: z.ZodOptional<z.ZodString>;
         }, z.core.$loose>;
     }, z.core.$strip>>>;

package/dist/contracts/runtime-api.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { accessEventSchema, policyDocSchema } from "./access.js";
 import { conventionFilesSchema, manifestFileSchema } from "./internal.js";
+import { runtimePagesSchema } from "./pages.js";
 const runtimeConventionFilesSchema = conventionFilesSchema.omit({ routes: true }).strict();
 const hostCanonicalRedirectSchema = z.object({
     from: z.string().min(1),
@@ -35,7 +36,7 @@ const runtimeRouteIntentSchema = z.object({
 // changed paths, never a blanket purge when a diff exists. Past this cap (or
 // when no previous pointer target exists) the control plane omits the set and
 // purge handling falls back to one host-wide purge.
-export const RUNTIME_CHANGED_PATHS_MAX = 500;
+export const RUNTIME_CHANGED_PATHS_MAX = 900;
 const changedPathsSchema = z
     .array(z
     .string()
@@ -208,32 +209,7 @@ const runtimeServingConfigSchema = z.object({
         .nullable()
         .optional()
         .describe("Finalize-resolved listing/viewer/OG metadata (effective SpaceConfig meta); wins over session metadata."),
-    // Gate-page presentation (access-plan §5.7, X-16): finalize-compiled theme
-    // tokens (tier 1) plus the plan-gated white-label flag (tier 2). The runtime
-    // reads this shape defensively from the version's serving_config and defaults
-    // per-field; platform-LANE pages (tombstones, plan expiry, claim, invariant
-    // errors) never consume it (X-17).
-    pages: z
-        .object({
-        theme: z
-            .object({
-            accent: z.string().max(64).optional(),
-            background: z.string().max(64).optional(),
-            logo: z.string().max(2000).optional(),
-            name: z.string().max(120).optional(),
-            // Free tier ("basic color scheme + fonts"): a validated font-family
-            // stack, same grammar as pages.theme.accent/background.
-            fontFamily: z.string().max(256).optional(),
-        })
-            .optional(),
-        // Additive theme.json palette/font-family CSS custom properties
-        // (access-plan §8 tier 3 middle rung): exposes the full WP-compatible
-        // palette to custom 401.html/403.html/layout.html authors beyond the
-        // flat accent/background tokens above.
-        theme_vars: z.string().max(8192).optional(),
-        white_label: z.boolean().optional(),
-    })
-        .optional(),
+    pages: runtimePagesSchema.optional(),
     // Hidden experimental build-pipeline flag: absent on every version finalized
     // without it (byte-identical payload to today). Only ever sent as true.
     experimental_gutenberg: z.boolean().optional(),
@@ -350,46 +326,13 @@ export const runtimeVersionFinalizeRequestSchema = z.object({
     })
         .optional()
         .describe("Channel-variant template contents, keyed by runtime route name."),
-    // Publish-baked custom gate pages (access-plan §5.7 tier 3, X-35): the
-    // finalize compiler validates the version's 401.html/403.html slot element
-    // (`<div data-sf="challenge">` / `<div data-sf="deny">`), replaces the slot's
-    // contents with the opaque v1 marker comment, and ships the baked document
-    // here. The engine stores each under the version root as
-    // `access-pages/{challenge,deny}.html` (sibling of serving.php — never a
-    // publicly served path) and unlinks stale ones on re-finalize; serving is a
-    // single str_replace of the marker with the runtime-owned functional
-    // fragment. A version finalized without a key here has no override — the
-    // default platform page renders.
-    access_pages: z
-        .object({
-        challenge: z
-            .string()
-            .max(2 * 1024 * 1024)
-            .optional()
-            .describe("Baked 401.html carrying <!--spacefast:slot:challenge:v1-->."),
-        deny: z
-            .string()
-            .max(2 * 1024 * 1024)
-            .optional()
-            .describe("Baked 403.html carrying <!--spacefast:slot:deny:v1-->."),
+    // Finalize-rendered Pages documents stored outside the public file tree.
+    page_artifacts: z
+        .record(z.string().min(1).max(240), z.string().max(2 * 1024 * 1024))
+        .refine((documents) => Object.keys(documents).length <= 100_000, {
+        message: "page_artifacts supports up to 100,000 rendered documents.",
     })
         .optional(),
-    // Custom gate-page chrome (access-plan §8 tier 2): the finalize compiler
-    // validates `.spacefast/templates/layout.html`'s `<div data-sf="content">`
-    // slot, replaces its contents with the opaque v1 marker comment, and ships
-    // the baked document here. The engine stores it as
-    // `access-pages/layout.html` (sibling of the challenge/deny overrides,
-    // never a publicly served path) and unlinks it when a re-finalize omits it.
-    // Serving wraps the runtime-owned gate-page content (brand row + heading +
-    // functional fragment) in the layout's content slot with one str_replace;
-    // a missing/invalid layout falls back to the platform default chrome. Only
-    // consulted when no full custom 401.html/403.html override wins for that
-    // page (tier 1 > tier 2).
-    layout_template: z
-        .string()
-        .max(2 * 1024 * 1024)
-        .optional()
-        .describe("Baked .spacefast/templates/layout.html carrying <!--spacefast:slot:layout-content:v1-->."),
     serving: z
         .object({
         headers_exact: z.record(z.string(), z.array(z.record(z.string(), z.unknown()))).default({}),
@@ -397,11 +340,6 @@ export const runtimeVersionFinalizeRequestSchema = z.object({
         redirects_exact: z.record(z.string(), z.array(z.record(z.string(), z.unknown()))).default({}),
         redirects_pattern: z.array(z.record(z.string(), z.unknown())).default([]),
         config: runtimeServingConfigSchema.optional(),
-        // Compiled SpaceTheme custom-property declarations consumed by themeable pages
-        // (directory listings, single-file viewers, platform pages). The finalize
-        // compiler validates the token grammar; the runtime re-rejects anything that
-        // could escape a <style> element or reach the network.
-        theme_css: z.string().max(16384).optional(),
         // Trusted Zero endpoint source compiled by the runtime into private
         // endpoint-specific JS, QuickJS bytecode, and PHP manifest invoke actions.
         zero_endpoints: z.array(runtimeZeroEndpointSchema).max(128).optional(),
@@ -695,6 +633,10 @@ export const runtimeCallbackEventSchema = z.looseObject({
         .optional()
         .describe("Hostnames whose serving output this event changed; purge targets."),
     changed_paths: changedPathsSchema,
+    changed_paths_known: z
+        .boolean()
+        .optional()
+        .describe("True when changed_paths is the complete diff, including a known-empty diff. Absent on older engines, where an empty array remains the host-wide fallback."),
     previous_version_id: previousVersionIdSchema,
 });
 export const runtimeEventsDrainResponseSchema = z.object({

package/dist/contracts/space-config.d.ts

@@ -19,42 +19,25 @@ export declare const SPACE_CONFIG_CAPS: {
     readonly injectSnippets: 16;
     /** Max `access.rules` entries in the file lane. */
     readonly accessRules: 100;
-    /** Max `pages.theme` color token length. */
-    readonly pagesColorChars: 64;
-    /** Max `pages.theme.logo` URL/path length. */
-    readonly pagesLogoChars: 2000;
-    /** Max `pages.theme.name` display-name length. */
-    readonly pagesNameChars: 120;
+    /** Max `theme` color token length. */
+    readonly themeColorChars: 64;
+    /** Max `theme.logo` URL/path length. */
+    readonly themeLogoChars: 2000;
+    /** Max `theme.name` display-name length. */
+    readonly themeNameChars: 120;
 };
 /** Published JSON Schema URL for `sf.jsonc` ($schema autocomplete). */
 export declare const SPACE_CONFIG_SCHEMA_URL: string;
-export declare const spacePagesThemeSchema: z.ZodObject<{
+export declare const spacePageThemeSchema: z.ZodObject<{
     accent: z.ZodOptional<z.ZodString>;
     background: z.ZodOptional<z.ZodString>;
     logo: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
-    fontFamily: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type SpacePagesTheme = z.infer<typeof spacePagesThemeSchema>;
-export declare const SF_THEME_JSONC_FILE = "sf.theme.jsonc";
-export declare const sfThemeJsoncSchema: z.ZodObject<{
-    accent: z.ZodOptional<z.ZodString>;
-    background: z.ZodOptional<z.ZodString>;
-    logo: z.ZodOptional<z.ZodString>;
-    name: z.ZodOptional<z.ZodString>;
-    fontFamily: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+    font: z.ZodOptional<z.ZodString>;
+    hideSpacefastBranding: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type SpacePageTheme = z.infer<typeof spacePageThemeSchema>;
 export declare const THEME_JSON_FILE = "theme.json";
-export declare const LAYOUT_TEMPLATE_FILE = ".spacefast/templates/layout.html";
-export declare const spacePagesConfigSchema: z.ZodObject<{
-    theme: z.ZodOptional<z.ZodObject<{
-        accent: z.ZodOptional<z.ZodString>;
-        background: z.ZodOptional<z.ZodString>;
-        logo: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        fontFamily: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
 export declare const spaceBuildSettingsSchema: z.ZodObject<{
     rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -125,37 +108,13 @@ export declare const spaceConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
     theme: z.ZodOptional<z.ZodObject<{
-        color: z.ZodOptional<z.ZodObject<{
-            palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                slug: z.ZodString;
-                color: z.ZodString;
-                name: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-        typography: z.ZodOptional<z.ZodObject<{
-            fontSizes: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                slug: z.ZodString;
-                size: z.ZodString;
-                name: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            fontFamily: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        spacing: z.ZodOptional<z.ZodObject<{
-            spacingScale: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                slug: z.ZodString;
-                size: z.ZodString;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    pages: z.ZodOptional<z.ZodObject<{
-        theme: z.ZodOptional<z.ZodObject<{
-            accent: z.ZodOptional<z.ZodString>;
-            background: z.ZodOptional<z.ZodString>;
-            logo: z.ZodOptional<z.ZodString>;
-            name: z.ZodOptional<z.ZodString>;
-            fontFamily: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
+        accent: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        font: z.ZodOptional<z.ZodString>;
+        hideSpacefastBranding: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
     build: z.ZodOptional<z.ZodObject<{
         rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -243,6 +202,10 @@ export declare const spaceAccessConfigSchema: z.ZodObject<{
         message: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+export declare const spacePublishOptionsSchema: z.ZodObject<{
+    fingerprint: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SpacePublishOptions = z.infer<typeof spacePublishOptionsSchema>;
 export declare const spaceConfigFileSchema: z.ZodObject<{
     index: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
     fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -287,37 +250,13 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
     }, z.core.$strip>>;
     templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
     theme: z.ZodOptional<z.ZodObject<{
-        color: z.ZodOptional<z.ZodObject<{
-            palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                slug: z.ZodString;
-                color: z.ZodString;
-                name: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-        typography: z.ZodOptional<z.ZodObject<{
-            fontSizes: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                slug: z.ZodString;
-                size: z.ZodString;
-                name: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            fontFamily: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        spacing: z.ZodOptional<z.ZodObject<{
-            spacingScale: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                slug: z.ZodString;
-                size: z.ZodString;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    pages: z.ZodOptional<z.ZodObject<{
-        theme: z.ZodOptional<z.ZodObject<{
-            accent: z.ZodOptional<z.ZodString>;
-            background: z.ZodOptional<z.ZodString>;
-            logo: z.ZodOptional<z.ZodString>;
-            name: z.ZodOptional<z.ZodString>;
-            fontFamily: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
+        accent: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        font: z.ZodOptional<z.ZodString>;
+        hideSpacefastBranding: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
     build: z.ZodOptional<z.ZodObject<{
         rootDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         installDirectory: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -404,6 +343,9 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
             message: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
+    publish: z.ZodOptional<z.ZodObject<{
+        fingerprint: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type SpaceConfigFile = z.infer<typeof spaceConfigFileSchema>;
 /**

package/dist/contracts/space-config.js

@@ -2,7 +2,6 @@ import { z } from "zod";
 import { BRAND } from "../brand.js";
 import { runtimeRuleSchema } from "./access.js";
 import { normalizedSiteClass } from "./enums.js";
-import { spaceThemeSchema } from "./space-theme.js";
 export const SPACE_CONFIG_CANONICAL_FILE = "sf.jsonc";
 export const SPACE_CONFIG_ALIAS_FILES = [
     "spacefast.jsonc",
@@ -38,19 +37,18 @@ export const SPACE_CONFIG_CAPS = {
     injectSnippets: 16,
     /** Max `access.rules` entries in the file lane. */
     accessRules: 100,
-    /** Max `pages.theme` color token length. */
-    pagesColorChars: 64,
-    /** Max `pages.theme.logo` URL/path length. */
-    pagesLogoChars: 2000,
-    /** Max `pages.theme.name` display-name length. */
-    pagesNameChars: 120,
+    /** Max `theme` color token length. */
+    themeColorChars: 64,
+    /** Max `theme.logo` URL/path length. */
+    themeLogoChars: 2000,
+    /** Max `theme.name` display-name length. */
+    themeNameChars: 120,
 };
 /** Published JSON Schema URL for `sf.jsonc` ($schema autocomplete). */
 export const SPACE_CONFIG_SCHEMA_URL = `${BRAND.websiteOrigin}/schemas/sf.json`;
-// Platform-page theme tokens (access-plan §5.7 tier 1, X-16): colors, logo,
-// display name applied to the runtime's platform-rendered gate pages
-// (challenge/deny). Presentation only — never layout, behavior, or protocol.
-// Color grammar mirrors the SpaceTheme compiler allowlist (hex/rgb(a)/hsl(a)/
+// Pages theme tokens: visual values consumed by publish-rendered site pages.
+// Presentation only — never layout, behavior, or protocol.
+// Color grammar accepts hex/rgb(a)/hsl(a)/
 // named), categorically rejecting anything that could escape a style context.
 const PAGES_COLOR_PATTERN = new RegExp([
     "^(?:",
@@ -62,23 +60,24 @@ const PAGES_COLOR_PATTERN = new RegExp([
 ].join(""));
 // Logo: an https URL or a root-relative path into the space's own files.
 const PAGES_LOGO_PATTERN = /^(?:https:\/\/[^\s"'<>\\]+|\/[^\s"'<>\\]*)$/;
-const pagesColorSchema = z
+const pageThemeColorSchema = z
     .string()
     .trim()
-    .max(SPACE_CONFIG_CAPS.pagesColorChars)
+    .max(SPACE_CONFIG_CAPS.themeColorChars)
     .regex(PAGES_COLOR_PATTERN, "must be a hex, rgb(a), hsl(a), or named CSS color");
-// Font family stack for gate pages (access-plan §8 tier 3): mirrors the
-// SpaceTheme compiler's FONT_FAMILY_PATTERN allowlist (letters/digits/space/
+// Font family stack for Pages (letters/digits/space/
 // comma/hyphen/straight quotes only, no url()/src).
 const PAGES_FONT_FAMILY_PATTERN = /^[A-Za-z0-9 ,'"-]{1,256}$/;
-export const spacePagesThemeSchema = z
+export const spacePageThemeSchema = z
     .object({
-    accent: pagesColorSchema.optional().describe("Accent color for buttons/links on gate pages."),
-    background: pagesColorSchema.optional().describe("Page background color for gate pages."),
+    accent: pageThemeColorSchema.optional().describe("Accent color for Spacefast-authored pages."),
+    background: pageThemeColorSchema
+        .optional()
+        .describe("Background color for Spacefast-authored pages."),
     logo: z
         .string()
         .trim()
-        .max(SPACE_CONFIG_CAPS.pagesLogoChars)
+        .max(SPACE_CONFIG_CAPS.themeLogoChars)
         .regex(PAGES_LOGO_PATTERN, "must be an https:// URL or a root-relative path")
         .optional()
         .describe("Logo image (https URL or root-relative path) shown in the brand row."),
@@ -86,46 +85,30 @@ export const spacePagesThemeSchema = z
         .string()
         .trim()
         .min(1)
-        .max(SPACE_CONFIG_CAPS.pagesNameChars)
+        .max(SPACE_CONFIG_CAPS.themeNameChars)
         .optional()
-        .describe("Display name shown in the brand row of gate pages."),
-    // Free tier ("basic color scheme + fonts", access-plan §9): a validated
-    // font-family stack applied to gate pages, same grammar as the SpaceTheme
-    // compiler's typography.fontFamily.
-    fontFamily: z
+        .describe("Display name shown in the brand row of Pages defaults."),
+    font: z
         .string()
         .trim()
         .max(256)
         .regex(PAGES_FONT_FAMILY_PATTERN, "must be a plain font-family stack (no url()/src)")
         .optional()
-        .describe("Font-family stack applied to gate pages."),
+        .describe("Font-family stack applied to Spacefast-authored pages."),
+    hideSpacefastBranding: z
+        .boolean()
+        .optional()
+        .describe("Remove the Spacefast badge from default pages when the plan permits it."),
 })
-    .describe("Theme tokens for platform-rendered gate pages (challenge/deny).");
-// The `sf.theme.jsonc` escape-hatch file (access-plan §8 tier 3, wins over
-// `theme.json` and `spacefast.jsonc "pages.theme"`): same gate-page token
-// vocabulary as `pages.theme`, just from a dedicated file so authors/agents
-// can hand-tune presentation without touching the main project config. Paid
-// tier ("advanced theming", access-plan §9) — gated at compile by the
-// resolved plan entitlement, never at parse time.
-export const SF_THEME_JSONC_FILE = "sf.theme.jsonc";
-export const sfThemeJsoncSchema = spacePagesThemeSchema.describe("sf.theme.jsonc: the highest-precedence gate-page theme override file.");
-// The WordPress-compatible `theme.json` file (access-plan §8 tier 3, middle
-// precedence): free tier ("theme.json basics"). Only `settings.color.palette`
-// and `settings.typography.fontFamilies` feed gate-page tokens; every other
+    .strict()
+    .describe("Theme tokens for Spacefast-authored pages.");
+// WordPress-compatible `theme.json` is an inference input, not configuration.
+// Only `settings.color.palette` and `settings.typography.fontFamilies` infer
+// Pages tokens; every other
 // WP theme.json key is accepted-and-ignored (this is not a full WP_Theme_JSON
 // reimplementation, just the safe subset that reaches presentation-only gate
-// pages).
+// pages.
 export const THEME_JSON_FILE = "theme.json";
-// Custom chrome/shell for gate pages (access-plan §8 tier 2): the functional
-// challenge/deny fragment slots into `<div data-sf="content">` here so gate
-// pages inherit site look. Paid tier, same entitlement as full custom
-// 401.html/403.html.
-export const LAYOUT_TEMPLATE_FILE = ".spacefast/templates/layout.html";
-export const spacePagesConfigSchema = z
-    .object({
-    theme: spacePagesThemeSchema.optional(),
-})
-    .describe("Platform-page presentation: theme tokens applied to gate pages.");
 export const spaceBuildSettingsSchema = z
     .object({
     rootDirectory: z.string().trim().min(1).nullable().optional(),
@@ -242,12 +225,9 @@ export const spaceConfigSchema = z.object({
         .max(SPACE_CONFIG_CAPS.templates)
         .optional()
         .describe("Files that receive {{ vars.NAME }} substitution at finalize."),
-    theme: spaceThemeSchema
+    theme: spacePageThemeSchema
         .optional()
-        .describe("Platform-page theming: a validated preset subset of WordPress theme.json."),
-    pages: spacePagesConfigSchema
-        .optional()
-        .describe("Platform gate-page presentation: theme tokens (access-plan §5.7 tier 1)."),
+        .describe("Visual tokens for every Spacefast-authored page."),
     build: spaceBuildSettingsSchema
         .optional()
         .describe("Default settings for remote repository builds."),
@@ -297,6 +277,20 @@ export const spaceAccessConfigSchema = z
 // optional `space` link (slug or `spc_` id) resolved by CLI/publish flows.
 // Routing never lives here — redirects/rewrites/proxies/headers stay
 // exclusively in `_redirects`/`_headers` (one way per concern).
+// Client-side publish options (caching plan §6): consumed by the CLI/agent
+// publish tooling before upload, never by the runtime — like `$schema` and
+// `space`, this key lives only in the FILE shape and never reaches the space
+// `config` overlay.
+export const spacePublishOptionsSchema = z
+    .object({
+    fingerprint: z
+        .boolean()
+        .optional()
+        .describe("Publish-time asset fingerprinting: adds content-hashed immutable aliases " +
+        "(name.<sha256-8>.ext) for stable assets and rewrites exact HTML/CSS references. " +
+        "Originals keep serving unchanged. Default off."),
+})
+    .describe("Client publish-time options consumed by the Spacefast CLI, not the runtime.");
 export const spaceConfigFileSchema = spaceConfigSchema.extend({
     $schema: z
         .string()
@@ -308,6 +302,7 @@ export const spaceConfigFileSchema = spaceConfigSchema.extend({
         .optional()
         .describe("Optional space link: a space slug or spc_ id this project publishes to."),
     access: spaceAccessConfigSchema.optional(),
+    publish: spacePublishOptionsSchema.optional(),
 });
 /**
  * The published JSON Schema artifact for `sf.jsonc`, generated from the