@spacefast/common 0.0.23 → 0.0.26

package/dist/contracts/feature-lifecycle.js

@@ -1,5 +1,5 @@
 import { freezeFeatureRegistryEntry } from "./feature-lifecycle-core.js";
-export { FEATURE_ASSIGNMENT_SCOPES, FEATURE_EXECUTION_ACTOR_POLICIES, FEATURE_OWNER_IDS, FEATURE_STAGES, freezeFeatureRegistryEntry, validateFeatureLifecycleRegistry, } from "./feature-lifecycle-core.js";
+export { FEATURE_OWNER_IDS, FEATURE_STAGES, freezeFeatureRegistryEntry, validateFeatureLifecycleRegistry, } from "./feature-lifecycle-core.js";
 const featureEntries = Object.freeze([
     {
         cohort: "launch",
@@ -13,7 +13,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: null,
         owner: "team:commerce",
         requires: [],
@@ -21,7 +20,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: null,
         gaAt: null,
-        allowedActorPolicies: ["request_actor"],
         downRamp: {
             code: "paid_acquisition_stop",
             summary: "Deny new acquisition; allow cancel, portal, provider reconciliation and purchase recovery.",
@@ -39,7 +37,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["global"],
         docs: {
             channel: "public",
             slug: "/docs/publishing/anonymous",
@@ -51,7 +48,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-07-26",
         removeAfter: "2026-08-11",
         gaAt: "2026-07-12",
-        allowedActorPolicies: ["request_actor", "global_policy"],
         downRamp: {
             code: "anonymous_publish_stop",
             summary: "Deny new anonymous content/version/upload authorization or commit/finalize/promote/push side effects; already-issued bounded staging ingress stays quarantined, while static serving and service cleanup remain.",
@@ -87,7 +83,6 @@ const featureEntries = Object.freeze([
         surface: true,
         defaultEnabled: false,
         runtime: null,
-        assignmentScopes: ["user", "team", "global"],
         docs: {
             channel: "handbook",
             slug: "/features/domains/catalog",
@@ -99,7 +94,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["request_actor"],
         downRamp: {
             code: "domain_catalog_hide",
             summary: "Hide authenticated catalog; public suggestions, availability and WHOIS remain.",
@@ -118,7 +112,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["user", "team", "global"],
         docs: {
             channel: "handbook",
             slug: "/features/domains/registration",
@@ -130,7 +123,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["request_actor", "persisted_request_actor"],
         downRamp: {
             code: "domain_registration_stop",
             summary: "Deny new customer mutations and unstarted provider submits; generic existing-domain read plus service-only reconciliation/compensation for externally committed work continue.",
@@ -149,7 +141,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["user", "team", "global"],
         docs: {
             channel: "handbook",
             slug: "/features/domains/dns-management",
@@ -161,7 +152,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["request_actor", "persisted_request_actor"],
         downRamp: {
             code: "dns_management_stop",
             summary: "Deny customer mutation and unstarted provider apply; generic authoritative read plus service-only rollback/reconciliation for externally committed work continue.",
@@ -179,7 +169,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "handbook",
             slug: "/features/domains/wpcom-dns",
@@ -191,7 +180,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["request_actor"],
         downRamp: {
             code: "wpcom_dns_stop",
             summary: "Deny new automation; service/operator detach and reconciliation continue.",
@@ -209,7 +197,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["user", "team", "global"],
         docs: {
             channel: "handbook",
             slug: "/features/domains/domain-connect",
@@ -221,7 +208,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["request_actor", "persisted_request_actor"],
         downRamp: {
             code: "domain_connect_stop",
             summary: "Deny new setup and every uncommitted callback; after an authenticated external commit, narrowly typed service-only reconciliation or compensation continues idempotently.",
@@ -241,7 +227,6 @@ const featureEntries = Object.freeze([
                 internal: true,
             },
         },
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "public",
             slug: "/docs/spaces/proxy-routes",
@@ -253,7 +238,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["resource_team"],
         downRamp: {
             code: "proxy_binding_stop",
             summary: "Deny new binds; discoverable authenticated read/detach plus service reconciliation continue.",
@@ -263,7 +247,7 @@ const featureEntries = Object.freeze([
         cohort: "launch",
         key: "collab.notices",
         name: "Realtime notices",
-        description: "Reserved kill-switch for future realtime preview notices.",
+        description: "Live: the Space notice room. Turns on the dashboard's realtime comment feed and the overlay's notice chips. Not an authorization — who may watch a Space's feed is decided by its Grants.",
         stage: "internal",
         surface: false,
         defaultEnabled: false,
@@ -271,7 +255,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: null,
         owner: "team:collaboration",
         requires: [],
@@ -279,7 +262,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: null,
         gaAt: null,
-        allowedActorPolicies: ["resource_team"],
         downRamp: {
             code: "notices_stop",
             summary: "Stop mint/publish; service/operator revoke and cleanup continue.",
@@ -301,9 +283,8 @@ const featureEntries = Object.freeze([
         key: "sites.dedicated_runtime",
         name: "Dedicated runtime sites",
         description: "Allows teams to create dedicated WP.Cloud sites and place team spaces on them.",
-        // Availability and billing are separate decisions: the public surface is
-        // on, while the dedicatedRuntime entitlement still decides which teams may
-        // allocate the isolated infrastructure it exposes.
+        // Every Space owns its runtime site. The flag remains only as the
+        // operational down-ramp for new placement and materialization.
         stage: "ga",
         surface: true,
         defaultEnabled: true,
@@ -312,7 +293,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "public",
             slug: "/docs/apps",
@@ -324,23 +304,11 @@ const featureEntries = Object.freeze([
         reviewAfter: null,
         removeAfter: "2026-11-01",
         gaAt: "2026-08-05",
-        allowedActorPolicies: ["request_actor", "resource_team"],
         downRamp: {
             code: "dedicated_runtime_stop",
             summary: "Deny customer mutation and new placement/materialization immediately; serve-time revocation of already-materialized output lands with the deferred runtime-proof slice; operator recovery/export/delete remain; downloaded bytes cannot be recalled.",
         },
     },
-    {
-        key: "shelf",
-        name: "Shelf",
-        description: "Exposes the per-user artifact shelf: dashboard curation and public /shelf/{handle} pages.",
-        defaultEnabled: false,
-        runtime: {
-            enabledInDevelopment: true,
-            enabledForA8c: true,
-            planDefaults: {},
-        },
-    },
     {
         cohort: "launch",
         key: "build.content_pipeline",
@@ -350,7 +318,6 @@ const featureEntries = Object.freeze([
         surface: true,
         defaultEnabled: false,
         runtime: null,
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "handbook",
             slug: "/features/build/content-pipeline",
@@ -362,7 +329,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["resource_team"],
         downRamp: {
             code: "content_pipeline_stop",
             summary: "Deny next build/finalize; completed immutable output remains.",
@@ -381,7 +347,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "public",
             slug: "/docs/tags",
@@ -393,7 +358,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: null,
-        allowedActorPolicies: ["request_actor", "resource_team"],
         downRamp: {
             code: "tags_stop",
             summary: "Deny every customer Tag API and dynamic module delivery; internal operator export/cleanup and platform-generated inert marker bytes remain.",
@@ -404,8 +368,8 @@ const featureEntries = Object.freeze([
         key: "zero",
         name: "Spacefast Zero",
         description: "Enables Spacefast Zero command surfaces and hosted Zero app workflows.",
-        // Zero is public. The flag remains only as the canonical operational
-        // down-ramp; dedicatedRuntime is the one customer eligibility decision.
+        // Zero is public on every plan. The flag remains only as the canonical
+        // operational down-ramp.
         stage: "ga",
         surface: true,
         defaultEnabled: true,
@@ -413,19 +377,17 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "public",
             slug: "/docs/apps/zero",
             feedbackUrl: null,
         },
         owner: "team:zero",
-        requires: ["sites.dedicated_runtime"],
+        requires: [],
         lifecycleAdoptedAt: "2026-07-12",
         reviewAfter: null,
         removeAfter: "2026-11-01",
         gaAt: "2026-08-05",
-        allowedActorPolicies: ["resource_team"],
         downRamp: {
             code: "zero_stop",
             summary: "Stop activation/invocation; operator export/delete/migration recovery remain.",
@@ -437,32 +399,29 @@ const featureEntries = Object.freeze([
         name: "Spacefast Functions",
         description: "Dispatches a version's dynamic requests to the execution host. Compiling the worker at publish is not gated: " +
             "the CLI always ships the bundle, and this flag decides whether anything runs it.",
-        // Functions remains a private beta: public docs carry the badge and this
-        // flag still decides who dispatches.
-        stage: "private_beta",
+        // Functions is public on every plan. The flag remains only as the
+        // operational down-ramp for dispatch.
+        stage: "ga",
         surface: true,
-        defaultEnabled: false,
+        defaultEnabled: true,
         runtime: {
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["team", "global"],
         docs: {
             channel: "public",
             slug: "/docs/apps/functions",
             feedbackUrl: null,
         },
         owner: "team:zero",
-        // Deliberately no `sites.dedicated_runtime` requirement, unlike Zero: a
-        // worker executes on Cloudflare rather than on the space's box, and reaches
-        // the database only through the broker. Shared placement is safe here in a
-        // way it is not for a capsule.
+        // A worker executes on Cloudflare rather than on the space's box and
+        // reaches the database only through the broker, so dispatch has no
+        // dedicated-runtime lifecycle dependency.
         requires: [],
         lifecycleAdoptedAt: "2026-07-27",
-        reviewAfter: "2026-09-02",
+        reviewAfter: null,
         removeAfter: "2026-11-01",
-        gaAt: null,
-        allowedActorPolicies: ["resource_team"],
+        gaAt: "2026-08-12",
         downRamp: {
             code: "functions_stop",
             summary: "Stop emitting dispatch configuration at finalize; published bundles stay on disk as inert content and the " +
@@ -483,7 +442,6 @@ const featureEntries = Object.freeze([
             enabledForA8c: true,
             planDefaults: {},
         },
-        assignmentScopes: ["user", "team", "global"],
         docs: {
             channel: "public",
             slug: "/docs/spaces/rename",
@@ -495,7 +453,6 @@ const featureEntries = Object.freeze([
         reviewAfter: "2026-08-11",
         removeAfter: "2026-10-10",
         gaAt: "2026-07-27",
-        allowedActorPolicies: ["request_actor"],
         downRamp: {
             code: "slug_rename_stop",
             summary: "Deny new slug renames while already-committed hostname redirects and runtime convergence continue.",

package/dist/contracts/features.d.ts

@@ -10,9 +10,13 @@ export declare const planCodeSchema: z.ZodEnum<{
 }>;
 export type PlanCode = z.infer<typeof planCodeSchema>;
 export declare const DEFAULT_PLAN_CODE: PlanCode;
-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 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" | "tags" | "functions" | "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" | "spaces.slug_rename")[];
 export declare const featureKeySchema: z.ZodEnum<{
     zero: "zero";
+    tags: "tags";
+    functions: "functions";
     "plans.paid.available": "plans.paid.available";
     "anonymous.publishing": "anonymous.publishing";
     "beta.enrollment_gate": "beta.enrollment_gate";
@@ -25,9 +29,6 @@ export declare const featureKeySchema: z.ZodEnum<{
     "collab.notices": "collab.notices";
     "collab.drawing": "collab.drawing";
     "sites.dedicated_runtime": "sites.dedicated_runtime";
-    shelf: "shelf";
-    tags: "tags";
-    functions: "functions";
     "spaces.slug_rename": "spaces.slug_rename";
 }>;
 export type FeatureKey = RuntimeFeatureKey;
@@ -45,8 +46,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 +53,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 +73,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 +80,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 +87,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,16 +103,15 @@ 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<{
+        storageBytes: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         teamMembers: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         subTeams: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
-        storageBytes: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         externalDomainGroups: 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">]>;
@@ -126,7 +119,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 +130,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>;
@@ -161,6 +159,26 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
         readonly enabledForA8c: boolean;
         readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
     };
+    readonly tags: {
+        readonly key: "tags";
+        readonly name: string;
+        readonly description: string;
+        readonly defaultEnabled: boolean;
+    } & {
+        readonly enabledInDevelopment?: boolean;
+        readonly enabledForA8c: boolean;
+        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
+    };
+    readonly functions: {
+        readonly key: "functions";
+        readonly name: string;
+        readonly description: string;
+        readonly defaultEnabled: boolean;
+    } & {
+        readonly enabledInDevelopment?: boolean;
+        readonly enabledForA8c: boolean;
+        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
+    };
     readonly "plans.paid.available": {
         readonly key: "plans.paid.available";
         readonly name: string;
@@ -281,36 +299,6 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
         readonly enabledForA8c: boolean;
         readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
     };
-    readonly shelf: {
-        readonly key: "shelf";
-        readonly name: string;
-        readonly description: string;
-        readonly defaultEnabled: boolean;
-    } & {
-        readonly enabledInDevelopment?: boolean;
-        readonly enabledForA8c: boolean;
-        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
-    };
-    readonly tags: {
-        readonly key: "tags";
-        readonly name: string;
-        readonly description: string;
-        readonly defaultEnabled: boolean;
-    } & {
-        readonly enabledInDevelopment?: boolean;
-        readonly enabledForA8c: boolean;
-        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
-    };
-    readonly functions: {
-        readonly key: "functions";
-        readonly name: string;
-        readonly description: string;
-        readonly defaultEnabled: boolean;
-    } & {
-        readonly enabledInDevelopment?: boolean;
-        readonly enabledForA8c: boolean;
-        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
-    };
     readonly "spaces.slug_rename": {
         readonly key: "spaces.slug_rename";
         readonly name: string;
@@ -325,12 +313,14 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
 export declare const featureStateSourceSchema: z.ZodEnum<{
     default: "default";
     override: "override";
-    kill_switch: "kill_switch";
     env: "env";
+    kill_switch: "kill_switch";
 }>;
 export declare const FeatureStateSchema: z.ZodObject<{
     key: z.ZodEnum<{
         zero: "zero";
+        tags: "tags";
+        functions: "functions";
         "plans.paid.available": "plans.paid.available";
         "anonymous.publishing": "anonymous.publishing";
         "beta.enrollment_gate": "beta.enrollment_gate";
@@ -343,17 +333,14 @@ export declare const FeatureStateSchema: z.ZodObject<{
         "collab.notices": "collab.notices";
         "collab.drawing": "collab.drawing";
         "sites.dedicated_runtime": "sites.dedicated_runtime";
-        shelf: "shelf";
-        tags: "tags";
-        functions: "functions";
         "spaces.slug_rename": "spaces.slug_rename";
     }>;
     enabled: z.ZodBoolean;
     source: z.ZodEnum<{
         default: "default";
         override: "override";
-        kill_switch: "kill_switch";
         env: "env";
+        kill_switch: "kill_switch";
     }>;
 }, z.core.$strip>;
 export declare const FeatureStateResponseSchema: z.ZodObject<{
@@ -366,6 +353,8 @@ export declare const FeatureStateResponseSchema: z.ZodObject<{
     }>;
     features: z.ZodRecord<z.ZodEnum<{
         zero: "zero";
+        tags: "tags";
+        functions: "functions";
         "plans.paid.available": "plans.paid.available";
         "anonymous.publishing": "anonymous.publishing";
         "beta.enrollment_gate": "beta.enrollment_gate";
@@ -378,13 +367,12 @@ export declare const FeatureStateResponseSchema: z.ZodObject<{
         "collab.notices": "collab.notices";
         "collab.drawing": "collab.drawing";
         "sites.dedicated_runtime": "sites.dedicated_runtime";
-        shelf: "shelf";
-        tags: "tags";
-        functions: "functions";
         "spaces.slug_rename": "spaces.slug_rename";
     }>, z.ZodObject<{
         key: z.ZodEnum<{
             zero: "zero";
+            tags: "tags";
+            functions: "functions";
             "plans.paid.available": "plans.paid.available";
             "anonymous.publishing": "anonymous.publishing";
             "beta.enrollment_gate": "beta.enrollment_gate";
@@ -397,17 +385,14 @@ export declare const FeatureStateResponseSchema: z.ZodObject<{
             "collab.notices": "collab.notices";
             "collab.drawing": "collab.drawing";
             "sites.dedicated_runtime": "sites.dedicated_runtime";
-            shelf: "shelf";
-            tags: "tags";
-            functions: "functions";
             "spaces.slug_rename": "spaces.slug_rename";
         }>;
         enabled: z.ZodBoolean;
         source: z.ZodEnum<{
             default: "default";
             override: "override";
-            kill_switch: "kill_switch";
             env: "env";
+            kill_switch: "kill_switch";
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -417,3 +402,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;