@spacefast/common 0.0.21 → 0.0.24

package/dist/contracts/features.d.ts

@@ -10,6 +10,8 @@ export declare const planCodeSchema: z.ZodEnum<{
 }>;
 export type PlanCode = z.infer<typeof planCodeSchema>;
 export declare const DEFAULT_PLAN_CODE: PlanCode;
+export declare const SELF_SERVE_PLAN_CODES: readonly ["personal", "work"];
+export declare const PUBLIC_PLAN_CODES: readonly ["free", "personal", "work", "enterprise"];
 export declare const FEATURE_KEYS: readonly ("zero" | "plans.paid.available" | "anonymous.publishing" | "beta.enrollment_gate" | "domains.search" | "domains.registration" | "domains.dns_management" | "domains.wpcom_dns" | "domains.domain_connect" | "domains.proxy_bindings" | "collab.notices" | "collab.drawing" | "sites.dedicated_runtime" | "shelf" | "tags" | "functions" | "spaces.slug_rename")[];
 export declare const featureKeySchema: z.ZodEnum<{
     zero: "zero";
@@ -45,8 +47,6 @@ export declare const planLimitsSchema: z.ZodObject<{
     teamMembers: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     subTeams: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     externalDomainGroups: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-    versionRetentionDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-    versionGatedKeepDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     egressBytesPerDay: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     maxFileBytes: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     maxVersionFiles: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
@@ -54,7 +54,6 @@ export declare const planLimitsSchema: z.ZodObject<{
     auditLogRetentionHours: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     buildAccessLogRetentionHours: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     buildsDeploysMonthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-    analyticsRetentionDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     shareLinksPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     invitesPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     inviteEmailsPerSpaceDaily: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
@@ -75,8 +74,6 @@ export declare const teamEntitlementsSchema: z.ZodObject<{
         teamMembers: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         subTeams: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         externalDomainGroups: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-        versionRetentionDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-        versionGatedKeepDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         egressBytesPerDay: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         maxFileBytes: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         maxVersionFiles: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
@@ -84,7 +81,6 @@ export declare const teamEntitlementsSchema: z.ZodObject<{
         auditLogRetentionHours: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         buildAccessLogRetentionHours: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         buildsDeploysMonthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-        analyticsRetentionDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         shareLinksPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         invitesPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         inviteEmailsPerSpaceDaily: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
@@ -92,11 +88,10 @@ export declare const teamEntitlementsSchema: z.ZodObject<{
         pendingAccessRequestsPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
     }, z.core.$strip>;
     externalProxy: z.ZodBoolean;
-    dedicatedRuntime: z.ZodBoolean;
+    dedicatedRuntime: z.ZodLiteral<true>;
     pagesTemplates: z.ZodBoolean;
     hideSpacefastBranding: z.ZodBoolean;
     runtimePhpWorkers: z.ZodNumber;
-    analyticsHourlyGranularity: z.ZodBoolean;
     versionDiagnosticsIncluded: z.ZodBoolean;
 }, z.core.$strip>;
 export type TeamEntitlements = z.infer<typeof teamEntitlementsSchema>;
@@ -109,11 +104,10 @@ export declare const teamEntitlementsResponseSchema: z.ZodObject<{
         enterprise: "enterprise";
     }>;
     externalProxy: z.ZodBoolean;
-    dedicatedRuntime: z.ZodBoolean;
+    dedicatedRuntime: z.ZodLiteral<true>;
     pagesTemplates: z.ZodBoolean;
     hideSpacefastBranding: z.ZodBoolean;
     runtimePhpWorkers: z.ZodNumber;
-    analyticsHourlyGranularity: z.ZodBoolean;
     versionDiagnosticsIncluded: z.ZodBoolean;
     limits: z.ZodObject<{
         teamMembers: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
@@ -126,7 +120,6 @@ export declare const teamEntitlementsResponseSchema: z.ZodObject<{
         auditLogRetentionHours: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         buildAccessLogRetentionHours: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         buildsDeploysMonthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-        analyticsRetentionDays: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         shareLinksPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         invitesPerSpace: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         inviteEmailsPerSpaceDaily: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
@@ -138,15 +131,21 @@ export type PlanDefinition = {
     code: PlanCode;
     name: string;
     monthlyPriceUsd: number | null;
+    yearlyPriceUsd: number | null;
+    /** Editor memberships included in the base plan price. */
+    includedSeats: number | "unlimited";
+    /** Additional editor price by interval; null means the plan never meters seats. */
+    extraSeatPriceUsd: {
+        monthly: number;
+        yearly: number;
+    } | null;
     limits: PlanLimits;
     externalProxy: boolean;
-    dedicatedRuntime: boolean;
     /** Paid full-page takeover templates under _pages/. */
     pagesTemplates: boolean;
     /** Paid removal of the tasteful Spacefast badge from designed defaults. */
     hideSpacefastBranding: boolean;
     runtimePhpWorkers: number;
-    analyticsHourlyGranularity: boolean;
 };
 export type FeatureDefinition = RuntimeFeatureDefinition;
 export declare const PLAN_DEFINITIONS: Record<PlanCode, PlanDefinition>;
@@ -417,3 +416,6 @@ export declare function normalizePlanCode(planCode: string | null | undefined):
 export declare function featureDefaultForPlan(key: FeatureKey, planCode: string | null | undefined): boolean;
 /** Numeric value of a plan limit; `null` means unlimited. */
 export declare function planLimitNumber(value: PlanLimitValue): number | null;
+/** Extra editor quantity billed on a paid Stripe subscription. */
+export declare function extraSeatQuantity(editorMemberships: number, includedSeats: number | "unlimited"): number;
+export declare function planPriceUsd(plan: PlanDefinition, interval: "monthly" | "yearly"): number | null;

package/dist/contracts/features.js

@@ -5,6 +5,13 @@ import { FEATURE_RUNTIME_DEFINITIONS, FEATURE_RUNTIME_KEYS, } from "./feature-li
 export const PLAN_CODES = ["free", "personal", "work", "enterprise", "internal"];
 export const planCodeSchema = z.enum(PLAN_CODES).describe("Plan code.");
 export const DEFAULT_PLAN_CODE = "free";
+export const SELF_SERVE_PLAN_CODES = ["personal", "work"];
+export const PUBLIC_PLAN_CODES = [
+    "free",
+    "personal",
+    "work",
+    "enterprise",
+];
 export const FEATURE_KEYS = FEATURE_RUNTIME_KEYS;
 export const featureKeySchema = z.enum(FEATURE_KEYS).describe("Feature flag key.");
 // Feature override states (env `SPACEFAST_FLAG_*` and the feature_overrides
@@ -23,13 +30,6 @@ export const planLimitsSchema = z
     teamMembers: planLimitValueSchema,
     subTeams: planLimitValueSchema,
     externalDomainGroups: planLimitValueSchema,
-    // Version retention (charter arbitration A3, internal plan data — never on
-    // the PlanPolicyResponse wire shape): `versionRetentionDays` is the included
-    // full-retention window; after it versions stay stored but gated until
-    // `versionGatedKeepDays` from readyAt, then retention-delete with notice.
-    // Live and channel-referenced versions are never retention-deleted.
-    versionRetentionDays: planLimitValueSchema,
-    versionGatedKeepDays: planLimitValueSchema,
     // Per-space daily bandwidth cap feeding the egress kill-switch sweep
     // (internal-docs/platform.md "Abuse Posture"; internal plan data — never on
     // the PlanPolicyResponse wire shape). WORST_CASE_QUOTAS
@@ -44,9 +44,6 @@ export const planLimitsSchema = z
     buildAccessLogRetentionHours: planLimitValueSchema,
     // One pooled limit on purpose: pricing never separates user pushes from CI builds.
     buildsDeploysMonthly: planLimitValueSchema,
-    // Queryable analytics history window. Storage retains rollups for everyone
-    // (env-bounded); this only clamps how far back the analytics API serves.
-    analyticsRetentionDays: planLimitValueSchema,
     // Access-surface abuse ceilings: generous by default, enterprise unlimited.
     // Active (non-revoked, non-expired) share links per space.
     shareLinksPerSpace: planLimitValueSchema,
@@ -67,7 +64,9 @@ export const teamEntitlementsSchema = z
     planCode: planCodeSchema,
     limits: planLimitsSchema,
     externalProxy: z.boolean().describe("Whether external proxy upstreams compile on this plan."),
-    dedicatedRuntime: z.boolean().describe("Whether the team can use dedicated runtime sites."),
+    dedicatedRuntime: z
+        .literal(true)
+        .describe("Dedicated runtime availability. Every team receives its own runtime site."),
     pagesTemplates: z
         .boolean()
         .describe("Whether _pages/*.html full-page takeovers compile for this team."),
@@ -75,23 +74,17 @@ export const teamEntitlementsSchema = z
         .boolean()
         .describe("Whether theme.hideSpacefastBranding removes the badge from default pages."),
     runtimePhpWorkers: z.number().int().describe("PHP workers per serving site."),
-    analyticsHourlyGranularity: z
-        .boolean()
-        .describe("Whether analytics series resolve to hourly buckets (daily otherwise)."),
     versionDiagnosticsIncluded: z
         .boolean()
         .describe("Whether version diagnostics are included with the plan."),
 })
     .describe("Resolved entitlements for a team: plan limits after add-on grants.");
 // Wire projection of TeamEntitlements for GET /v1/teams/{teamId}/entitlements.
-// `versionRetentionDays`/`versionGatedKeepDays` (charter A3) and
-// `egressBytesPerDay` (abuse posture) are internal plan data — never on a wire
+// `egressBytesPerDay` (abuse posture) is internal plan data — never on a wire
 // shape, mirroring PlanPolicyResponse's deliberate exclusion.
 export const teamEntitlementsResponseSchema = teamEntitlementsSchema
     .extend({
     limits: planLimitsSchema.omit({
-        versionRetentionDays: true,
-        versionGatedKeepDays: true,
         egressBytesPerDay: true,
     }),
 })
@@ -104,8 +97,6 @@ const UNLIMITED_LIMITS = {
     teamMembers: "unlimited",
     subTeams: "unlimited",
     externalDomainGroups: "unlimited",
-    versionRetentionDays: "unlimited",
-    versionGatedKeepDays: "unlimited",
     egressBytesPerDay: "unlimited",
     maxFileBytes: "unlimited",
     maxVersionFiles: "unlimited",
@@ -113,7 +104,6 @@ const UNLIMITED_LIMITS = {
     auditLogRetentionHours: "unlimited",
     buildAccessLogRetentionHours: "unlimited",
     buildsDeploysMonthly: "unlimited",
-    analyticsRetentionDays: "unlimited",
     shareLinksPerSpace: "unlimited",
     invitesPerSpace: "unlimited",
     inviteEmailsPerSpaceDaily: "unlimited",
@@ -135,13 +125,14 @@ export const PLAN_DEFINITIONS = {
         code: "free",
         name: "Free",
         monthlyPriceUsd: 0,
+        yearlyPriceUsd: 0,
+        includedSeats: 3,
+        extraSeatPriceUsd: null,
         limits: {
             storageBytes: 5 * GB,
             teamMembers: 3,
             subTeams: 0,
             externalDomainGroups: 3,
-            versionRetentionDays: 30, // included full-retention window (charter A3)
-            versionGatedKeepDays: 183, // kept gated ~6 months from readyAt, then deleted
             egressBytesPerDay: 100 * GB, // = worst-case ceiling; tunable per plan
             maxFileBytes: 50 * MB,
             maxVersionFiles: 20_000,
@@ -149,20 +140,20 @@ export const PLAN_DEFINITIONS = {
             auditLogRetentionHours: 48,
             buildAccessLogRetentionHours: 48,
             buildsDeploysMonthly: 100,
-            analyticsRetentionDays: 30,
             ...ACCESS_QUOTA_DEFAULTS,
         },
         externalProxy: false,
-        dedicatedRuntime: false,
         pagesTemplates: false,
         hideSpacefastBranding: false,
         runtimePhpWorkers: 2,
-        analyticsHourlyGranularity: false,
     },
     personal: {
         code: "personal",
         name: "Personal",
         monthlyPriceUsd: 5,
+        yearlyPriceUsd: 60,
+        includedSeats: 5,
+        extraSeatPriceUsd: { monthly: 1, yearly: 12 },
         limits: {
             ...UNLIMITED_LIMITS,
             storageBytes: 20 * GB,
@@ -174,61 +165,61 @@ export const PLAN_DEFINITIONS = {
             auditLogRetentionHours: MONTH_HOURS,
             buildAccessLogRetentionHours: MONTH_HOURS,
             buildsDeploysMonthly: 1000,
-            analyticsRetentionDays: 365,
             ...ACCESS_QUOTA_DEFAULTS,
         },
         externalProxy: true,
-        dedicatedRuntime: false,
         pagesTemplates: true,
         hideSpacefastBranding: true,
         runtimePhpWorkers: 4,
-        analyticsHourlyGranularity: true,
     },
     work: {
         code: "work",
         name: "Work",
         monthlyPriceUsd: 15,
+        yearlyPriceUsd: 180,
+        includedSeats: 15,
+        extraSeatPriceUsd: { monthly: 1, yearly: 12 },
         limits: {
             ...UNLIMITED_LIMITS,
             storageBytes: 50 * GB,
-            // 15 seats included; the $1/seat add-on rides EntitlementGrant
-            // ({ limit: "teamMembers", add: n }) — grants are no-ops on
-            // "unlimited" limits, so this must stay numeric.
+            // The catalog keeps the included quantity numeric for display and seat
+            // billing. An active paid Stripe source lifts admission separately so
+            // editors beyond this number can be added and reconciled automatically.
             teamMembers: 15,
             subTeams: 0,
             ...ACCESS_QUOTA_DEFAULTS,
         },
         externalProxy: true,
-        dedicatedRuntime: false,
         pagesTemplates: true,
         hideSpacefastBranding: true,
         runtimePhpWorkers: 4,
-        analyticsHourlyGranularity: true,
     },
     // Footnote-only publicly ("custom — talk to us"); manual grant, never self-serve.
     enterprise: {
         code: "enterprise",
         name: "Enterprise",
         monthlyPriceUsd: null,
+        yearlyPriceUsd: null,
+        includedSeats: "unlimited",
+        extraSeatPriceUsd: null,
         limits: { ...UNLIMITED_LIMITS },
         externalProxy: true,
-        dedicatedRuntime: true,
         pagesTemplates: true,
         hideSpacefastBranding: true,
         runtimePhpWorkers: 4,
-        analyticsHourlyGranularity: true,
     },
     internal: {
         code: "internal",
         name: "Internal",
         monthlyPriceUsd: null,
+        yearlyPriceUsd: null,
+        includedSeats: "unlimited",
+        extraSeatPriceUsd: null,
         limits: { ...UNLIMITED_LIMITS },
         externalProxy: true,
-        dedicatedRuntime: true,
         pagesTemplates: true,
         hideSpacefastBranding: true,
         runtimePhpWorkers: 4,
-        analyticsHourlyGranularity: true,
     },
 };
 export const FEATURE_DEFINITIONS = FEATURE_RUNTIME_DEFINITIONS;
@@ -262,3 +253,13 @@ export function featureDefaultForPlan(key, planCode) {
 export function planLimitNumber(value) {
     return value === "unlimited" ? null : value;
 }
+/** Extra editor quantity billed on a paid Stripe subscription. */
+export function extraSeatQuantity(editorMemberships, includedSeats) {
+    if (!Number.isInteger(editorMemberships) || editorMemberships < 0) {
+        throw new RangeError("Editor membership count must be a non-negative integer.");
+    }
+    return includedSeats === "unlimited" ? 0 : Math.max(0, editorMemberships - includedSeats);
+}
+export function planPriceUsd(plan, interval) {
+    return interval === "monthly" ? plan.monthlyPriceUsd : plan.yearlyPriceUsd;
+}

package/dist/contracts/functions.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { runtimeKindSchema, type ExecutionCapabilities } from "./execution.js";
+import { type ExecutionCapabilities } from "./execution.js";
 /**
  * Spacefast Functions: tenant workers run as Cloudflare Dynamic Workers.
  *
@@ -37,6 +37,13 @@ import { runtimeKindSchema, type ExecutionCapabilities } from "./execution.js";
  * than transactional. That is why capsules are a different product rather
  * than a placement option — see `endpointIsPortable` in `./execution.js`.
  */
+/**
+ * The tag a compiled worker artifact carries — in `functionsSourceFinalizeSchema`
+ * and the runtime config built from it — so the PHP origin can tell what it is
+ * dispatching (`functions-dispatch.php` refuses a config tagged anything else).
+ * It is a property of the artifact the tree produced, not a kind a space or a
+ * version declares: a publish can carry this beside a capsule.
+ */
 export declare const FUNCTIONS_RUNTIME_KIND = "functions";
 export declare const FUNCTIONS_SOURCE_METADATA_KEY = "spacefastFunctions";
 export declare const FUNCTIONS_PLATFORM_ROUTE_PREFIX = "/__spacefast/functions";
@@ -45,6 +52,17 @@ export declare const FUNCTIONS_RUNTIME_ROUTE_PATHS: {
     /** Where a dispatched worker calls back for brokered capabilities. */
     readonly relay: "/__spacefast/functions/relay";
 };
+/**
+ * Where invocation counts are reported, on the CONTROL PLANE rather than the
+ * space origin.
+ *
+ * The two destinations are separate on purpose. Logs are the tenant's content
+ * and stay on their own origin; usage is a number the platform bills from and
+ * goes straight to us. Sharing one channel would make either destination a
+ * plausible place to look for the other's data, and would put log volume on the
+ * path that has to stay cheap.
+ */
+export declare const FUNCTIONS_USAGE_INTAKE_PATH = "/v1/runtime/functions/usage";
 /** Public, signed read path. Distinct from storage so the token is never a filename. */
 export declare const FUNCTIONS_BUNDLE_ROUTE_PREFIX = "/__spacefast/functions/b";
 export declare const FUNCTIONS_RUNTIME_STORAGE_ROOT = "__spacefast/functions";
@@ -215,7 +233,13 @@ export declare const functionsWorkerArtifactSchema: z.ZodObject<{
         env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, z.core.$strip>>;
+    platform: z.ZodDefault<z.ZodObject<{
+        nextCache: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type FunctionsWorkerArtifact = z.infer<typeof functionsWorkerArtifactSchema>;
 /**
@@ -227,19 +251,25 @@ export type FunctionsWorkerArtifact = z.infer<typeof functionsWorkerArtifactSche
  * *grants*, resolved by the control plane at finalize so the origin forwards a
  * decision rather than making one. Anything absent fails closed at the relay.
  */
-export declare const FUNCTIONS_DISPATCH_CAPABILITIES: readonly ["db.read", "db.write", "fetch", "log"];
+export declare const FUNCTIONS_DISPATCH_CAPABILITIES: readonly ["storage.read", "storage.write", "db.read", "db.write", "fetch", "log", "next.cache", "gravatar.profile", "spam.check", "email.send"];
 export declare const functionsDispatchCapabilitySchema: z.ZodEnum<{
     fetch: "fetch";
+    "storage.read": "storage.read";
+    "storage.write": "storage.write";
     "db.read": "db.read";
     "db.write": "db.write";
     log: "log";
+    "next.cache": "next.cache";
+    "gravatar.profile": "gravatar.profile";
+    "spam.check": "spam.check";
+    "email.send": "email.send";
 }>;
 export type FunctionsDispatchCapability = z.infer<typeof functionsDispatchCapabilitySchema>;
 /**
  * Resolves a build's declared capabilities into the grant a dispatch carries.
  *
- * Three of the six declared capabilities have no dispatch counterpart, and each
- * for its own reason:
+ * Three declared capabilities have no dispatch counterpart, each for its own
+ * reason:
  *
  * - `env` is not a runtime call at all. Values are resolved at finalize and
  *   travel in the config, so a worker reading `env` reaches nothing.
@@ -251,9 +281,16 @@ export type FunctionsDispatchCapability = z.infer<typeof functionsDispatchCapabi
  * touches the database, not how. Narrowing it would take per-statement analysis
  * we do not do, and guessing "read-only" from a declaration would be a grant
  * the author never asked for and cannot see.
+ *
+ * The three platform-service grants are named for the operation an author
+ * reaches for, and each covers its service's whole operation set for the same
+ * reason `db` widens: a declaration says a handler uses spam checking, not that
+ * it never files a correction.
  */
-export declare function functionsDispatchCapabilities(capabilities: ExecutionCapabilities): FunctionsDispatchCapability[];
-/** Everything except `log` needs the relay to mean anything. */
+export declare function functionsDispatchCapabilities(capabilities: ExecutionCapabilities, platform?: {
+    nextCache?: boolean;
+}): FunctionsDispatchCapability[];
+/** Logs and the host-local Next cache do not transit the origin relay. */
 export declare function functionsGrantNeedsRelay(granted: readonly FunctionsDispatchCapability[]): boolean;
 /**
  * What the space origin needs in order to dispatch to the host on its own. The
@@ -286,6 +323,19 @@ export declare const functionsRelayConfigSchema: z.ZodObject<{
     maxConcurrentCalls: z.ZodNumber;
 }, z.core.$strict>;
 export type FunctionsRelayConfig = z.infer<typeof functionsRelayConfigSchema>;
+/**
+ * Where the execution host reports how much this version ran.
+ *
+ * Absent means uncounted, not refused: a space whose configuration predates
+ * usage reporting must keep serving, and an execution tier that cannot reach
+ * the control plane must never fail a request over it. Counting is reporting
+ * only — nothing here throttles, and no limit is enforced anywhere from it.
+ */
+export declare const functionsUsageConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    token: z.ZodString;
+}, z.core.$strict>;
+export type FunctionsUsageConfig = z.infer<typeof functionsUsageConfigSchema>;
 /**
  * What a build declares about its worker — everything the CLI can know from the
  * author's project alone.
@@ -331,7 +381,13 @@ export declare const functionsSourceFinalizeSchema: z.ZodObject<{
             env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
+        platform: z.ZodDefault<z.ZodObject<{
+            nextCache: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     variables: z.ZodDefault<z.ZodObject<{
         source: z.ZodLiteral<"spacefast-variables">;
@@ -343,9 +399,10 @@ export type FunctionsSourceFinalize = z.infer<typeof functionsSourceFinalizeSche
  * The document the control plane sends to the runtime, which the engine stores
  * beside the version's files and the origin reads on every dispatch.
  *
- * It is the build's declaration plus the four things only the platform can
- * supply: where to dispatch, what the worker is allowed to do, the credential
- * that lets it do those things, and the resolved values of its variables.
+ * It is the build's declaration plus the things only the platform can supply:
+ * where to dispatch, what the worker is allowed to do, the credentials that let
+ * it do those things and report what it did, and the resolved values of its
+ * variables.
  */
 export declare const functionsRuntimeConfigSchema: z.ZodObject<{
     runtimeKind: z.ZodLiteral<"functions">;
@@ -381,7 +438,13 @@ export declare const functionsRuntimeConfigSchema: z.ZodObject<{
             env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+            email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         }, z.core.$strip>>;
+        platform: z.ZodDefault<z.ZodObject<{
+            nextCache: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
     }, z.core.$strict>;
     variables: z.ZodDefault<z.ZodObject<{
         source: z.ZodLiteral<"spacefast-variables">;
@@ -393,9 +456,15 @@ export declare const functionsRuntimeConfigSchema: z.ZodObject<{
     }, z.core.$strict>;
     grantedCapabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         fetch: "fetch";
+        "storage.read": "storage.read";
+        "storage.write": "storage.write";
         "db.read": "db.read";
         "db.write": "db.write";
         log: "log";
+        "next.cache": "next.cache";
+        "gravatar.profile": "gravatar.profile";
+        "spam.check": "spam.check";
+        "email.send": "email.send";
     }>>>;
     relay: z.ZodDefault<z.ZodNullable<z.ZodObject<{
         url: z.ZodString;
@@ -403,6 +472,10 @@ export declare const functionsRuntimeConfigSchema: z.ZodObject<{
         maxBatchStatements: z.ZodNumber;
         maxConcurrentCalls: z.ZodNumber;
     }, z.core.$strict>>>;
+    usage: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        token: z.ZodString;
+    }, z.core.$strict>>>;
     variableValues: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strict>;
 export type FunctionsRuntimeConfig = z.infer<typeof functionsRuntimeConfigSchema>;
@@ -442,7 +515,13 @@ export declare const functionsDeployMetadataSchema: z.ZodObject<{
                 env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
                 realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
                 logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+                email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
             }, z.core.$strip>>;
+            platform: z.ZodDefault<z.ZodObject<{
+                nextCache: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>;
         }, z.core.$strict>;
         variables: z.ZodDefault<z.ZodObject<{
             source: z.ZodLiteral<"spacefast-variables">;
@@ -467,6 +546,7 @@ export declare function createFunctionsSourceFinalize(input: {
     compatibilityFlags?: string[];
     routes?: z.input<typeof functionsRouteSchema>[];
     capabilities?: ExecutionCapabilities;
+    nextCache?: boolean;
     variableNames?: string[];
 }): FunctionsSourceFinalize;
 /**
@@ -485,10 +565,12 @@ export declare const functionsExecutionStateSchema: z.ZodEnum<{
 }>;
 export type FunctionsExecutionState = z.infer<typeof functionsExecutionStateSchema>;
 /**
- * What a live worker is, as the `app` member of a space's runtime status.
+ * What a live worker is, as the `worker` member of a space's runtime status.
+ *
+ * It carries no kind tag. The member it rides in already says which product
+ * answered, and the same tree can carry a capsule beside it — a discriminant
+ * here could only repeat the field name or contradict its sibling.
  *
- * Shaped like `zeroAppSchema` and discriminated by the same `runtimeKind`, so a
- * reader switches on one field rather than probing for which product answered.
  * No `versionId`: the status response it rides in already names the live
  * version.
  *
@@ -498,7 +580,6 @@ export type FunctionsExecutionState = z.infer<typeof functionsExecutionStateSche
  * branches on, and stating it twice invites the two to disagree.
  */
 export declare const functionsAppSchema: z.ZodObject<{
-    runtimeKind: z.ZodLiteral<"functions">;
     artifactId: z.ZodString;
     appName: z.ZodString;
     entry: z.ZodString;
@@ -524,6 +605,9 @@ export declare const functionsAppSchema: z.ZodObject<{
         env: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         realtime: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         logging: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        gravatar: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        spam: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        email: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, z.core.$strip>>;
     executionState: z.ZodEnum<{
         ready: "ready";
@@ -538,60 +622,3 @@ export declare const functionsAppSchema: z.ZodObject<{
     }, z.core.$strict>;
 }, z.core.$strict>;
 export type FunctionsApp = z.infer<typeof functionsAppSchema>;
-/**
- * The wire shape of the origin's log-read route, not a public API contract.
- *
- * Handler logs reach callers through `GET /v1/spaces/:spaceId/logs/runtime`,
- * which serves the platform's own `runtimeLogListResponseSchema` for both
- * execution tiers. These aliases describe the hop underneath it: a worker tails
- * its output to the origin that dispatched it, and the control plane reads it
- * back from there. Keeping them named after this product is the point — the
- * origin is the only place a wp.cloud-hosted space keeps anything, and Zero's
- * records never travel this path at all.
- */
-export declare const functionsLogEntrySchema: z.ZodObject<{
-    id: z.ZodString;
-    timestamp: z.ZodString;
-    level: z.ZodEnum<{
-        info: "info";
-        error: "error";
-        debug: "debug";
-        warn: "warn";
-    }>;
-    requestId: z.ZodNullable<z.ZodString>;
-    versionId: z.ZodNullable<z.ZodString>;
-    handlerName: z.ZodNullable<z.ZodString>;
-    message: z.ZodString;
-    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strict>;
-export type FunctionsLogEntry = z.infer<typeof functionsLogEntrySchema>;
-export declare const functionsLogListQuerySchema: z.ZodObject<{
-    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    cursor: z.ZodOptional<z.ZodString>;
-    requestId: z.ZodOptional<z.ZodString>;
-    handlerName: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
-export type FunctionsLogListQuery = z.infer<typeof functionsLogListQuerySchema>;
-export declare const functionsLogListResponseSchema: z.ZodObject<{
-    data: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        timestamp: z.ZodString;
-        level: z.ZodEnum<{
-            info: "info";
-            error: "error";
-            debug: "debug";
-            warn: "warn";
-        }>;
-        requestId: z.ZodNullable<z.ZodString>;
-        versionId: z.ZodNullable<z.ZodString>;
-        handlerName: z.ZodNullable<z.ZodString>;
-        message: z.ZodString;
-        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strict>>;
-    pagination: z.ZodObject<{
-        nextCursor: z.ZodNullable<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-export type FunctionsLogListResponse = z.infer<typeof functionsLogListResponseSchema>;
-/** Narrows a space's live runtime kind to this product. */
-export declare function isFunctionsRuntime(kind: z.infer<typeof runtimeKindSchema> | null): boolean;