@spacefast/common 0.0.12 → 0.0.17

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

@@ -17,14 +17,16 @@ export declare const SPACE_CONFIG_CAPS: {
     readonly injectSnippetBytes: number;
     /** Max snippets per `inject` array. */
     readonly injectSnippets: 16;
-    /** Max `access.rules` entries in the file lane. */
-    readonly accessRules: 100;
+    /** Max public WordPress sources exposed to repository builds. */
+    readonly dataSources: 32;
     /** 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;
+    /** Max top-level `name` (space display name) length. Matches the stored column. */
+    readonly nameChars: 255;
 };
 /** Published JSON Schema URL for `sf.jsonc` ($schema autocomplete). */
 export declare const SPACE_CONFIG_SCHEMA_URL: string;
@@ -63,6 +65,17 @@ export declare const spacePlacementConfigSchema: z.ZodObject<{
     burstable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type SpacePlacementConfig = z.infer<typeof spacePlacementConfigSchema>;
+export declare const dataSourceNameSchema: z.ZodString;
+export declare const wordpressDataSourceUrlSchema: z.ZodString;
+export declare const wordpressDataSourceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"wordpress">;
+    url: z.ZodString;
+}, z.core.$strict>;
+export type WordPressDataSource = z.infer<typeof wordpressDataSourceSchema>;
+export declare const spaceDataSourcesSchema: z.ZodPipe<z.ZodUnknown, z.ZodRecord<z.ZodString, z.ZodObject<{
+    kind: z.ZodLiteral<"wordpress">;
+    url: z.ZodString;
+}, z.core.$strict>>>;
 export declare const spaceConfigSchema: z.ZodObject<{
     index: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<false>]>>;
     fallback: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -141,70 +154,71 @@ export declare const spaceConfigSchema: z.ZodObject<{
         bodyEnd: z.ZodOptional<z.ZodArray<z.ZodString>>;
         noscript: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    dataSources: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodLiteral<"wordpress">;
+        url: z.ZodString;
+    }, z.core.$strict>>>>;
+    defaultDataSource: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type SpaceConfig = z.infer<typeof spaceConfigSchema>;
+export declare function compareDataSourceNames(left: string, right: string): number;
+export declare function resolveDefaultDataSourceName(config: Pick<SpaceConfig, "dataSources" | "defaultDataSource"> | null | undefined): string | null;
 export declare function spaceSuperpowersEnabled(config: SpaceConfig | null | undefined): boolean;
-export declare const spaceAccessConfigSchema: z.ZodObject<{
-    rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        match: z.ZodDefault<z.ZodObject<{
-            host: z.ZodOptional<z.ZodString>;
-            hostPattern: z.ZodOptional<z.ZodString>;
-            hostTemplate: z.ZodOptional<z.ZodString>;
-            pathPattern: z.ZodOptional<z.ZodString>;
-            channel: z.ZodOptional<z.ZodString>;
-            ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            agent: z.ZodOptional<z.ZodString>;
-            country: z.ZodOptional<z.ZodString>;
-            countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            header: z.ZodOptional<z.ZodObject<{
-                name: z.ZodString;
-                value: z.ZodString;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-        effect: z.ZodEnum<{
-            allow: "allow";
-            deny: "deny";
-            challenge: "challenge";
-        }>;
-        auth: z.ZodOptional<z.ZodObject<{
-            requiredGrants: z.ZodArray<z.ZodString>;
-            issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                kid: z.ZodString;
-                alg: z.ZodLiteral<"EdDSA">;
-                publicKey: z.ZodString;
-                grantNamespaces: z.ZodArray<z.ZodString>;
-            }, z.core.$strip>>>;
-            acquire: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                type: z.ZodLiteral<"password">;
-                ref: z.ZodString;
-                transport: z.ZodEnum<{
-                    basic: "basic";
-                    form: "form";
-                }>;
-                username: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"login">;
-                url: z.ZodString;
-                label: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>], "type">>>;
-        }, z.core.$strip>>;
-        managedBy: z.ZodOptional<z.ZodEnum<{
-            sharing: "sharing";
-            firewall: "firewall";
-            file_share: "file_share";
-            cast_reviewer: "cast_reviewer";
-            team_default: "team_default";
-        }>>;
-        expiresAt: z.ZodOptional<z.ZodNumber>;
-        reasonCode: z.ZodOptional<z.ZodString>;
-        message: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+export declare const spaceConfigFileAccessSchema: z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"public">, z.ZodTransform<{
+    public: string[];
+}, "public">>, z.ZodObject<{
+    public: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+}, z.core.$strict>]>;
+export type SpaceConfigFileAccess = z.infer<typeof spaceConfigFileAccessSchema>;
+/**
+ * Zero: a transactional app with its own database.
+ *
+ * Both entries are required because Zero is never inferred. A runtime that owns
+ * a database must not spring into existence from a directory shape, so the only
+ * way to get one is to say so — and once said, a server or client that cannot
+ * be resolved fails the publish rather than degrading to static files.
+ */
+export declare const spaceRuntimeZeroSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"zero">;
+    server: z.ZodString;
+    client: z.ZodString;
 }, z.core.$strip>;
-export declare const spacePublishOptionsSchema: z.ZodObject<{
-    fingerprint: z.ZodOptional<z.ZodBoolean>;
+/**
+ * Functions: the worker `sf publish` compiles.
+ *
+ * Every field beyond `kind` is optional because the normal case is detection: a
+ * project with `handler.ts` or an OpenNext build needs no configuration at all.
+ * These exist for the layouts detection cannot guess — a worker somewhere
+ * unusual, or a compatibility date the author wants pinned rather than
+ * defaulted.
+ */
+export declare const spaceRuntimeFunctionsSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"functions">;
+    entry: z.ZodOptional<z.ZodString>;
+    database: z.ZodDefault<z.ZodBoolean>;
+    compatibilityDate: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type SpacePublishOptions = z.infer<typeof spacePublishOptionsSchema>;
+/**
+ * The one runtime declaration, discriminated on `kind`.
+ *
+ * One block, one kind — a version cannot express two runtimes at once, so the
+ * ambiguity never has to be resolved downstream. File-only on purpose: a
+ * runtime is a fact about the content of a version, so it rolls forward and
+ * back with the version instead of being set through the API config overlay.
+ */
+export declare const spaceRuntimeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"zero">;
+    server: z.ZodString;
+    client: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"functions">;
+    entry: z.ZodOptional<z.ZodString>;
+    database: z.ZodDefault<z.ZodBoolean>;
+    compatibilityDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export type SpaceRuntimeZeroConfig = z.infer<typeof spaceRuntimeZeroSchema>;
+export type SpaceRuntimeFunctionsConfig = z.infer<typeof spaceRuntimeFunctionsSchema>;
+export type SpaceRuntimeConfig = z.infer<typeof spaceRuntimeSchema>;
 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<{
@@ -285,66 +299,22 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
     }, z.core.$strip>>;
     $schema: z.ZodOptional<z.ZodString>;
     space: z.ZodOptional<z.ZodString>;
-    access: z.ZodOptional<z.ZodObject<{
-        rules: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            id: z.ZodOptional<z.ZodString>;
-            match: z.ZodDefault<z.ZodObject<{
-                host: z.ZodOptional<z.ZodString>;
-                hostPattern: z.ZodOptional<z.ZodString>;
-                hostTemplate: z.ZodOptional<z.ZodString>;
-                pathPattern: z.ZodOptional<z.ZodString>;
-                channel: z.ZodOptional<z.ZodString>;
-                ipCidrs: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                agent: z.ZodOptional<z.ZodString>;
-                country: z.ZodOptional<z.ZodString>;
-                countryNotIn: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                header: z.ZodOptional<z.ZodObject<{
-                    name: z.ZodString;
-                    value: z.ZodString;
-                }, z.core.$strip>>;
-            }, z.core.$strip>>;
-            effect: z.ZodEnum<{
-                allow: "allow";
-                deny: "deny";
-                challenge: "challenge";
-            }>;
-            auth: z.ZodOptional<z.ZodObject<{
-                requiredGrants: z.ZodArray<z.ZodString>;
-                issuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    kid: z.ZodString;
-                    alg: z.ZodLiteral<"EdDSA">;
-                    publicKey: z.ZodString;
-                    grantNamespaces: z.ZodArray<z.ZodString>;
-                }, z.core.$strip>>>;
-                acquire: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-                    type: z.ZodLiteral<"password">;
-                    ref: z.ZodString;
-                    transport: z.ZodEnum<{
-                        basic: "basic";
-                        form: "form";
-                    }>;
-                    username: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>, z.ZodObject<{
-                    type: z.ZodLiteral<"login">;
-                    url: z.ZodString;
-                    label: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>], "type">>>;
-            }, z.core.$strip>>;
-            managedBy: z.ZodOptional<z.ZodEnum<{
-                sharing: "sharing";
-                firewall: "firewall";
-                file_share: "file_share";
-                cast_reviewer: "cast_reviewer";
-                team_default: "team_default";
-            }>>;
-            expiresAt: z.ZodOptional<z.ZodNumber>;
-            reasonCode: z.ZodOptional<z.ZodString>;
-            message: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    publish: z.ZodOptional<z.ZodObject<{
-        fingerprint: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
+    name: z.ZodOptional<z.ZodString>;
+    access: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodLiteral<"public">, z.ZodTransform<{
+        public: string[];
+    }, "public">>, z.ZodObject<{
+        public: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strict>]>>;
+    runtime: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"zero">;
+        server: z.ZodString;
+        client: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"functions">;
+        entry: z.ZodOptional<z.ZodString>;
+        database: z.ZodDefault<z.ZodBoolean>;
+        compatibilityDate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
 export type SpaceConfigFile = z.infer<typeof spaceConfigFileSchema>;
 /**