@spacefast/common 0.0.24 → 0.2.1

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

@@ -3,10 +3,9 @@ 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.
+ * Accepted config filenames in read precedence order, highest first. Must stay
+ * in step with the finalizer's `CONFIG_ACCEPTED_FILES`
+ * (crates/stattic-runtime-core protocol.rs), which is the selection authority.
  */
 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"];
@@ -35,6 +34,42 @@ export declare const SPACE_CONFIG_CAPS: {
     readonly themeNameChars: 120;
     /** Max top-level `name` (space display name) length. Matches the stored column. */
     readonly nameChars: 255;
+    /** Max `crons` entries. One provider crontab slot each, so the cap is small and hard. */
+    readonly crons: 8;
+    /** Max `crons[].path` length. */
+    readonly cronPathChars: 512;
+    /** Max `system.presentation.name` display-name length. */
+    readonly systemNameChars: 255;
+    /** Max length of any https URL or origin in the `system` manifest. */
+    readonly systemUrlChars: 2048;
+    /** Max `system.hostnames.apex` length (a DNS name never exceeds 253). */
+    readonly systemHostnameChars: 253;
+    /** Max `system.presentation.contacts` entries. */
+    readonly systemContacts: 32;
+    /** Max length of a `system.presentation.contacts` key. */
+    readonly systemContactKeyChars: 64;
+    /** Max length of a `system.presentation.contacts` value. */
+    readonly systemContactValueChars: 2048;
+    /** Max `system.api.allowedOrigins` entries. */
+    readonly systemApiAllowedOrigins: 32;
+    /** Max `system.tokenIssuers` entries. */
+    readonly systemTokenIssuers: 16;
+    /** Max `system.tokenIssuers[].issuer` length. */
+    readonly systemIssuerChars: 512;
+    /** Max `system.tokenIssuers[].keys` entries. */
+    readonly systemIssuerKeys: 16;
+    /** Max `system.tokenIssuers[].keys[].kid` length. */
+    readonly systemKeyIdChars: 64;
+    /** Exact raw Ed25519 public-key length after base64url encoding. */
+    readonly systemPublicKeyChars: 43;
+    /** Max `system.tokenIssuers[].proof` length. */
+    readonly systemProofChars: 4096;
+    /** Max `system.subscriptions` entries. */
+    readonly systemSubscriptions: 32;
+    /** Max `system.subscriptions[].events` entries. */
+    readonly systemSubscriptionEvents: 64;
+    /** Max length of a `system.subscriptions[].events` name. */
+    readonly systemEventChars: 128;
 };
 /** Published JSON Schema URL for `sf.jsonc` ($schema autocomplete). */
 export declare const SPACE_CONFIG_SCHEMA_URL: string;
@@ -71,7 +106,6 @@ 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;
@@ -166,14 +200,13 @@ export declare const spaceConfigFileAccessSchema: z.ZodUnion<readonly [z.ZodPipe
 }, "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.
+ * Both entries are required because Zero is never inferred: a runtime that owns
+ * a database must not spring into existence from a directory shape. Once
+ * declared, 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">;
@@ -184,24 +217,23 @@ export declare const spaceRuntimeZeroSchema: z.ZodObject<{
  * 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.
+ * project with `handler.ts` or an OpenNext build needs no configuration. These
+ * exist for the layouts detection cannot guess.
  */
 export declare const spaceRuntimeFunctionsSchema: z.ZodObject<{
     kind: z.ZodLiteral<"functions">;
     entry: z.ZodOptional<z.ZodString>;
     database: z.ZodDefault<z.ZodBoolean>;
+    fetch: z.ZodOptional<z.ZodBoolean>;
     compatibilityDate: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
- * The one runtime declaration, discriminated on `kind`.
+ * The one runtime declaration, discriminated on `kind`. A version cannot
+ * express two runtimes at once.
  *
- * 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.
+ * 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">;
@@ -211,11 +243,173 @@ export declare const spaceRuntimeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"functions">;
     entry: z.ZodOptional<z.ZodString>;
     database: z.ZodDefault<z.ZodBoolean>;
+    fetch: z.ZodOptional<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>;
+/**
+ * Scheduled requests: the provider crontab asks this space for these paths on
+ * these schedules. File-only for the same reason `runtime` is.
+ *
+ * The Rust config compiler is the selection authority for both fields; this
+ * schema exists so an editor and an agent get the same answer before publish.
+ */
+export declare const SPACE_CRON_NAMED_SCHEDULES: readonly ["hourly", "daily", "twicedaily", "weekly"];
+/**
+ * The wp.cloud schedule grammar: a named interval, an `Nh`/`Nd`/`Nw` count, or
+ * a five-field crontab expression. No `@daily` macros and no month/day names.
+ * The provider does not accept them either.
+ */
+export declare function isSpaceCronSchedule(schedule: string): boolean;
+/**
+ * The artifact key for a cron path — the shared slug normalizer, so an accented
+ * path folds the same way it does everywhere else. Two paths that produce one
+ * key are rejected, so a key names exactly one schedule.
+ */
+export declare function spaceCronKey(path: string): string;
+/** Generated runtime file the serving engine reads, written only when a version declares a cron. */
+export declare const SPACE_CRONS_ARTIFACT_PATH = "__spacefast/crons.json";
+export declare const SPACE_CRONS_ARTIFACT_VERSION = 1;
+/** One compiled cron, as the artifact carries it. */
+export type SpaceCronEntry = {
+    /** Slug of `path`; unique within a version. */
+    key: string;
+    path: string;
+    /** Verbatim as declared, never normalized or expanded. */
+    schedule: string;
+};
+export type SpaceCronsArtifact = {
+    version: typeof SPACE_CRONS_ARTIFACT_VERSION;
+    crons: SpaceCronEntry[];
+};
+export declare const spaceCronSchema: z.ZodObject<{
+    path: z.ZodString;
+    schedule: z.ZodString;
+}, z.core.$strip>;
+export declare const spaceCronsSchema: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    schedule: z.ZodString;
+}, z.core.$strip>>;
+export type SpaceCronConfig = z.infer<typeof spaceCronSchema>;
+export declare const systemPresentationSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodString>;
+    supportUrl: z.ZodOptional<z.ZodString>;
+    claimOrigin: z.ZodOptional<z.ZodString>;
+    accessHandoffOrigin: z.ZodOptional<z.ZodString>;
+    problemDocsBaseUrl: z.ZodOptional<z.ZodString>;
+    contacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const systemHostnamesSchema: z.ZodObject<{
+    apex: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const systemApiSchema: z.ZodObject<{
+    origin: z.ZodOptional<z.ZodString>;
+    allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const systemTokenIssuerSchema: z.ZodObject<{
+    issuer: z.ZodString;
+    keys: z.ZodArray<z.ZodObject<{
+        kid: z.ZodString;
+        publicKey: z.ZodString;
+    }, z.core.$strict>>;
+    proof: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const systemSubscriptionSchema: z.ZodObject<{
+    url: z.ZodString;
+    events: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const spaceSystemManifestSchema: z.ZodObject<{
+    presentation: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        supportUrl: z.ZodOptional<z.ZodString>;
+        claimOrigin: z.ZodOptional<z.ZodString>;
+        accessHandoffOrigin: z.ZodOptional<z.ZodString>;
+        problemDocsBaseUrl: z.ZodOptional<z.ZodString>;
+        contacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+    hostnames: z.ZodOptional<z.ZodObject<{
+        apex: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    api: z.ZodOptional<z.ZodObject<{
+        origin: z.ZodOptional<z.ZodString>;
+        allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    tokenIssuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        issuer: z.ZodString;
+        keys: z.ZodArray<z.ZodObject<{
+            kid: z.ZodString;
+            publicKey: z.ZodString;
+        }, z.core.$strict>>;
+        proof: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        events: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>>;
+    plans: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        features: z.ZodArray<z.ZodEnum<{
+            zero: "zero";
+            "plans.paid.available": "plans.paid.available";
+            "anonymous.publishing": "anonymous.publishing";
+            "beta.enrollment_gate": "beta.enrollment_gate";
+            "domains.search": "domains.search";
+            "domains.registration": "domains.registration";
+            "domains.dns_management": "domains.dns_management";
+            "domains.wpcom_dns": "domains.wpcom_dns";
+            "domains.domain_connect": "domains.domain_connect";
+            "domains.proxy_bindings": "domains.proxy_bindings";
+            "collab.notices": "collab.notices";
+            "collab.comments": "collab.comments";
+            "content.managed": "content.managed";
+            "sites.dedicated_runtime": "sites.dedicated_runtime";
+            "collab.drawing": "collab.drawing";
+            tags: "tags";
+            functions: "functions";
+            "spaces.slug_rename": "spaces.slug_rename";
+            "pages.templates": "pages.templates";
+            "branding.hide": "branding.hide";
+        }>>;
+        quotas: z.ZodObject<{
+            spaces: z.ZodOptional<z.ZodNumber>;
+            storageBytes: z.ZodOptional<z.ZodNumber>;
+            buildMinutesPerMonth: z.ZodOptional<z.ZodNumber>;
+            customDomains: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        quotaPolicy: z.ZodOptional<z.ZodEnum<{
+            warn: "warn";
+            block: "block";
+        }>>;
+    }, z.core.$strict>>>;
+    defaultPlan: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SpaceSystemManifest = z.infer<typeof spaceSystemManifestSchema>;
+/**
+ * The presentation slice of the system manifest, as a standalone schema.
+ * The presentation materializer re-parses the frozen declaration through this
+ * before storing it, so origins-https and within-schema bounds are re-asserted
+ * defensively at reconcile time and not just trusted from finalize.
+ */
+export type SpaceSystemPresentation = z.infer<typeof systemPresentationSchema>;
+/**
+ * A single declared token issuer / event subscription, as standalone schemas.
+ * The issuer and subscription materializers re-parse the frozen declaration
+ * through these before materializing — key shape, issuer https, subscription
+ * url https, and within-schema bounds re-asserted defensively at reconcile
+ * time, not trusted from finalize.
+ */
+export type SpaceSystemTokenIssuer = z.infer<typeof systemTokenIssuerSchema>;
+export type SpaceSystemSubscription = z.infer<typeof systemSubscriptionSchema>;
+/**
+ * The `api` slice of the system manifest, as a standalone schema. The api-origin
+ * materializer re-parses the frozen declaration through this before storing it
+ * to `tenants.api_origins_json` — origins https and within-schema bounds
+ * re-asserted defensively at reconcile time, not trusted from finalize.
+ */
+export type SpaceSystemApi = z.infer<typeof systemApiSchema>;
 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<{
@@ -307,8 +501,78 @@ export declare const spaceConfigFileSchema: z.ZodObject<{
         kind: z.ZodLiteral<"functions">;
         entry: z.ZodOptional<z.ZodString>;
         database: z.ZodDefault<z.ZodBoolean>;
+        fetch: z.ZodOptional<z.ZodBoolean>;
         compatibilityDate: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "kind">>;
+    crons: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        schedule: z.ZodString;
+    }, z.core.$strip>>>;
+    system: z.ZodOptional<z.ZodObject<{
+        presentation: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            logo: z.ZodOptional<z.ZodString>;
+            supportUrl: z.ZodOptional<z.ZodString>;
+            claimOrigin: z.ZodOptional<z.ZodString>;
+            accessHandoffOrigin: z.ZodOptional<z.ZodString>;
+            problemDocsBaseUrl: z.ZodOptional<z.ZodString>;
+            contacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
+        hostnames: z.ZodOptional<z.ZodObject<{
+            apex: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        api: z.ZodOptional<z.ZodObject<{
+            origin: z.ZodOptional<z.ZodString>;
+            allowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        tokenIssuers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            issuer: z.ZodString;
+            keys: z.ZodArray<z.ZodObject<{
+                kid: z.ZodString;
+                publicKey: z.ZodString;
+            }, z.core.$strict>>;
+            proof: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            events: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>>;
+        plans: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            features: z.ZodArray<z.ZodEnum<{
+                zero: "zero";
+                "plans.paid.available": "plans.paid.available";
+                "anonymous.publishing": "anonymous.publishing";
+                "beta.enrollment_gate": "beta.enrollment_gate";
+                "domains.search": "domains.search";
+                "domains.registration": "domains.registration";
+                "domains.dns_management": "domains.dns_management";
+                "domains.wpcom_dns": "domains.wpcom_dns";
+                "domains.domain_connect": "domains.domain_connect";
+                "domains.proxy_bindings": "domains.proxy_bindings";
+                "collab.notices": "collab.notices";
+                "collab.comments": "collab.comments";
+                "content.managed": "content.managed";
+                "sites.dedicated_runtime": "sites.dedicated_runtime";
+                "collab.drawing": "collab.drawing";
+                tags: "tags";
+                functions: "functions";
+                "spaces.slug_rename": "spaces.slug_rename";
+                "pages.templates": "pages.templates";
+                "branding.hide": "branding.hide";
+            }>>;
+            quotas: z.ZodObject<{
+                spaces: z.ZodOptional<z.ZodNumber>;
+                storageBytes: z.ZodOptional<z.ZodNumber>;
+                buildMinutesPerMonth: z.ZodOptional<z.ZodNumber>;
+                customDomains: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strict>;
+            quotaPolicy: z.ZodOptional<z.ZodEnum<{
+                warn: "warn";
+                block: "block";
+            }>>;
+        }, z.core.$strict>>>;
+        defaultPlan: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export type SpaceConfigFile = z.infer<typeof spaceConfigFileSchema>;
 /**