@spacefast/common 0.0.21 → 0.0.24

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

@@ -2,6 +2,13 @@ import { z } from "zod";
 export declare const SPACE_CONFIG_CANONICAL_FILE = "sf.jsonc";
 export declare const SPACE_CONFIG_ALIAS_FILES: readonly ["spacefast.jsonc", "spacefast.json", "sf.json", ".sf/sf.json", ".sf/config.jsonc", ".sf/config.json"];
 export declare const SPACE_CONFIG_ACCEPTED_FILES: readonly ["sf.jsonc", "spacefast.jsonc", "spacefast.json", "sf.json", ".sf/sf.json", ".sf/config.jsonc", ".sf/config.json"];
+/**
+ * Accepted config filenames in read precedence order, highest first. Kept in
+ * step with the finalizer's `CONFIG_PRECEDENCE` (crates/stattic-runtime-core
+ * protocol.rs) — the runtime compile is the selection authority, and a local
+ * read choosing a different file than the publish serves is a split brain.
+ */
+export declare const SPACE_CONFIG_PRECEDENCE: readonly ["sf.jsonc", "spacefast.jsonc", "spacefast.json", "sf.json", ".sf/sf.json", ".sf/config.jsonc", ".sf/config.json"];
 export declare const SPACE_CONFIG_PRIVATE_FILES: readonly ["sf.jsonc", "spacefast.jsonc", "spacefast.json", "sf.json", ".sf/sf.json", ".sf/config.jsonc", ".sf/config.json"];
 export declare const SPACE_CONFIG_CAPS: {
     /** Max raw `sf.jsonc` size in bytes. */
@@ -12,6 +19,7 @@ export declare const SPACE_CONFIG_CAPS: {
     readonly templates: 100;
     readonly metaTitleChars: 300;
     readonly metaDescriptionChars: 1000;
+    /** Max OG image or favicon path/URL length; enough for signed URLs while staying request-safe. */
     readonly metaImageChars: 2000;
     /** Max bytes per `inject` snippet. */
     readonly injectSnippetBytes: number;
@@ -53,15 +61,7 @@ export declare const spaceBuildSettingsSchema: z.ZodObject<{
     timeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type SpaceBuildSettings = z.infer<typeof spaceBuildSettingsSchema>;
-export declare const spacePlacementModeSchema: z.ZodEnum<{
-    shared: "shared";
-    dedicated: "dedicated";
-}>;
 export declare const spacePlacementConfigSchema: z.ZodObject<{
-    mode: z.ZodOptional<z.ZodEnum<{
-        shared: "shared";
-        dedicated: "dedicated";
-    }>>;
     burstable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type SpacePlacementConfig = z.infer<typeof spacePlacementConfigSchema>;
@@ -88,6 +88,7 @@ export declare const spaceConfigSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
+        favicon: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     superpowers: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -140,10 +141,6 @@ export declare const spaceConfigSchema: z.ZodObject<{
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     placement: z.ZodOptional<z.ZodObject<{
-        mode: z.ZodOptional<z.ZodEnum<{
-            shared: "shared";
-            dedicated: "dedicated";
-        }>>;
         burstable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     markdownNegotiation: z.ZodOptional<z.ZodBoolean>;
@@ -231,6 +228,7 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
         image: z.ZodOptional<z.ZodString>;
+        favicon: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     superpowers: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodBoolean>;
@@ -283,10 +281,6 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
         timeoutSeconds: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
     placement: z.ZodOptional<z.ZodObject<{
-        mode: z.ZodOptional<z.ZodEnum<{
-            shared: "shared";
-            dedicated: "dedicated";
-        }>>;
         burstable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     markdownNegotiation: z.ZodOptional<z.ZodBoolean>;

package/dist/contracts/space-config.js

@@ -1,6 +1,5 @@
 import { z } from "zod";
 import { serviceOrigin } from "../config/domains.js";
-import { normalizedSiteClass } from "./enums.js";
 import { GRANT_RESOURCE_PATTERN_LIMIT, normalizeGrantResourcePattern } from "./grants.js";
 export const SPACE_CONFIG_CANONICAL_FILE = "sf.jsonc";
 export const SPACE_CONFIG_ALIAS_FILES = [
@@ -15,6 +14,13 @@ export const SPACE_CONFIG_ACCEPTED_FILES = [
     SPACE_CONFIG_CANONICAL_FILE,
     ...SPACE_CONFIG_ALIAS_FILES,
 ];
+/**
+ * Accepted config filenames in read precedence order, highest first. Kept in
+ * step with the finalizer's `CONFIG_PRECEDENCE` (crates/stattic-runtime-core
+ * protocol.rs) — the runtime compile is the selection authority, and a local
+ * read choosing a different file than the publish serves is a split brain.
+ */
+export const SPACE_CONFIG_PRECEDENCE = SPACE_CONFIG_ACCEPTED_FILES;
 export const SPACE_CONFIG_PRIVATE_FILES = [...SPACE_CONFIG_ACCEPTED_FILES];
 // Config compiler parser-safety caps (internal-docs/platform.md "Config
 // compiler scale targets"): hard from launch, enforced by ONE shared validator
@@ -30,6 +36,7 @@ export const SPACE_CONFIG_CAPS = {
     templates: 100,
     metaTitleChars: 300,
     metaDescriptionChars: 1000,
+    /** Max OG image or favicon path/URL length; enough for signed URLs while staying request-safe. */
     metaImageChars: 2000,
     /** Max bytes per `inject` snippet. */
     injectSnippetBytes: 8 * 1024,
@@ -126,16 +133,12 @@ export const spaceBuildSettingsSchema = z
 })
     .strict()
     .describe("Remote build settings used by repository builds.");
-// Reuses the same shared/dedicated vocabulary as `normalizedSiteClass`
-// (enums.ts) rather than declaring a second "shared"/"dedicated" enum —
-// space placement mode and normalized site class are the same axis.
-export const spacePlacementModeSchema = normalizedSiteClass;
-// No region knob: a space binds to the site it was placed on at creation and
-// the only placement change that relocates it is shared -> dedicated. Data
-// location is chosen once, at creation, and never changes.
+// Every space gets its own site, so there is nothing to place between: no mode,
+// no region knob. `burstable` is the one real provider knob left — whether the
+// space's site may burst provider PHP workers. Data location is chosen once, at
+// creation, and never changes.
 export const spacePlacementConfigSchema = z
     .object({
-    mode: spacePlacementModeSchema.optional(),
     burstable: z.boolean().optional(),
 })
     .strict()
@@ -377,9 +380,10 @@ const spaceConfigBaseSchema = z.object({
         title: z.string().min(1).max(SPACE_CONFIG_CAPS.metaTitleChars).optional(),
         description: z.string().max(SPACE_CONFIG_CAPS.metaDescriptionChars).optional(),
         image: z.string().max(SPACE_CONFIG_CAPS.metaImageChars).optional(),
+        favicon: z.string().max(SPACE_CONFIG_CAPS.metaImageChars).optional(),
     })
         .optional()
-        .describe("Listing/viewer/OG metadata."),
+        .describe("Listing, viewer, sharing, and browser icon metadata."),
     superpowers: z
         .object({
         enabled: z.boolean().optional().describe("Master switch for platform-managed injections."),