@spacefast/common 0.0.11 → 0.0.13

package/dist/contracts/feature-lifecycle.d.ts

@@ -1,7 +1,503 @@
 import type { FeatureRegistryEntry } from "./feature-lifecycle-core.js";
-import { launchEntries as compiledLaunchEntries } from "./generated-feature-launch-entries.js";
+import type { PlanCode } from "./features.js";
 export { FEATURE_ASSIGNMENT_SCOPES, FEATURE_EXECUTION_ACTOR_POLICIES, FEATURE_OWNER_IDS, FEATURE_STAGES, freezeFeatureRegistryEntry, validateFeatureLifecycleRegistry, } from "./feature-lifecycle-core.js";
 export type { FeatureAssignmentScope, FeatureExecutionActorPolicy, FeatureOwnerId, FeatureRegistryEntry, FeatureStage, } from "./feature-lifecycle-core.js";
-export type LifecycleFeatureKey = (typeof compiledLaunchEntries)[number]["key"];
+type RuntimeFeaturePolicy = {
+    readonly enabledInDevelopment?: boolean;
+    readonly enabledForA8c: boolean;
+    readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
+};
+type RuntimeFeatureDefinitionShape<K extends string> = {
+    readonly key: K;
+    readonly name: string;
+    readonly description: string;
+    readonly defaultEnabled: boolean;
+} & RuntimeFeaturePolicy;
+declare const featureEntries: readonly [{
+    readonly cohort: "launch";
+    readonly key: "plans.paid.available";
+    readonly name: "Paid plans available";
+    readonly description: "Controls whether paid plan upgrade and management surfaces are available.";
+    readonly stage: "internal";
+    readonly surface: false;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: null;
+    readonly owner: "team:commerce";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: null;
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor"];
+    readonly downRamp: {
+        readonly code: "paid_acquisition_stop";
+        readonly summary: "Deny new acquisition; allow cancel, portal, provider reconciliation and purchase recovery.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "anonymous.publishing";
+    readonly name: "Anonymous publishing";
+    readonly description: "Allows unauthenticated space creation and publishing.";
+    readonly stage: "ga";
+    readonly surface: true;
+    readonly defaultEnabled: true;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["global"];
+    readonly docs: {
+        readonly channel: "public";
+        readonly slug: "/docs/publishing/anonymous";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:publishing";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-07-26";
+    readonly removeAfter: "2026-08-11";
+    readonly gaAt: "2026-07-12";
+    readonly allowedActorPolicies: readonly ["request_actor", "global_policy"];
+    readonly downRamp: {
+        readonly code: "anonymous_publish_stop";
+        readonly 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.";
+    };
+}, {
+    readonly key: "beta.enrollment_gate";
+    readonly name: "Beta enrollment gate";
+    readonly description: "Gates the whole API behind private-beta enrollment; non-enrolled credentials get 403 not_enrolled.";
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+}, {
+    readonly key: "domains.search";
+    readonly name: "Domain search";
+    readonly description: "Allows domain availability search and suggestion surfaces.";
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "domains.catalog";
+    readonly name: "Domain catalog";
+    readonly description: "Controls authenticated domain product/catalog operations; public suggestions, availability and WHOIS remain unflagged.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: null;
+    readonly assignmentScopes: readonly ["user", "team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/domains/catalog";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:domains";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor"];
+    readonly downRamp: {
+        readonly code: "domain_catalog_hide";
+        readonly summary: "Hide authenticated catalog; public suggestions, availability and WHOIS remain.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "domains.registration";
+    readonly name: "Domain registration";
+    readonly description: "Allows domain registration, purchase, and transfer-in surfaces.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["user", "team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/domains/registration";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:domains";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor", "persisted_request_actor"];
+    readonly downRamp: {
+        readonly code: "domain_registration_stop";
+        readonly summary: "Deny new customer mutations and unstarted provider submits; generic existing-domain read plus service-only reconciliation/compensation for externally committed work continue.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "domains.dns_management";
+    readonly name: "DNS management";
+    readonly description: "Allows customer DNS zone, nameserver, and record-management surfaces.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["user", "team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/domains/dns-management";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:domains";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor", "persisted_request_actor"];
+    readonly downRamp: {
+        readonly code: "dns_management_stop";
+        readonly summary: "Deny customer mutation and unstarted provider apply; generic authoritative read plus service-only rollback/reconciliation for externally committed work continue.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "domains.wpcom_dns";
+    readonly name: "WordPress.com DNS automation";
+    readonly description: "Manage a domain's DNS through the owner's WordPress.com account.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/domains/wpcom-dns";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:domains";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor"];
+    readonly downRamp: {
+        readonly code: "wpcom_dns_stop";
+        readonly summary: "Deny new automation; service/operator detach and reconciliation continue.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "domains.domain_connect";
+    readonly name: "Domain Connect";
+    readonly description: "One-click DNS setup at providers that implement Domain Connect.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["user", "team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/domains/domain-connect";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:domains";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor", "persisted_request_actor"];
+    readonly downRamp: {
+        readonly code: "domain_connect_stop";
+        readonly summary: "Deny new setup and every uncommitted callback; after an authenticated external commit, narrowly typed service-only reconciliation or compensation continues idempotently.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "domains.proxy_bindings";
+    readonly name: "Domain proxy bindings";
+    readonly description: "Allow a team to proxy custom-domain traffic to an external HTTP upstream.";
+    readonly stage: "private_beta";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {
+            readonly internal: true;
+        };
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "public";
+        readonly slug: "/docs/domains/proxy-bindings";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:domains";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["resource_team"];
+    readonly downRamp: {
+        readonly code: "proxy_binding_stop";
+        readonly summary: "Deny new binds; discoverable authenticated read/detach plus service reconciliation continue.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "collab.notices";
+    readonly name: "Realtime notices";
+    readonly description: "Reserved kill-switch for future realtime preview notices.";
+    readonly stage: "internal";
+    readonly surface: false;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: null;
+    readonly owner: "team:collaboration";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: null;
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["resource_team"];
+    readonly downRamp: {
+        readonly code: "notices_stop";
+        readonly summary: "Stop mint/publish; service/operator revoke and cleanup continue.";
+    };
+}, {
+    readonly key: "collab.drawing";
+    readonly name: "Collab drawing";
+    readonly description: "Enables drawing feedback in the Collab overlay.";
+    readonly defaultEnabled: true;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "sites.dedicated_runtime";
+    readonly name: "Dedicated runtime sites";
+    readonly description: "Allows teams to create dedicated WP.Cloud sites and place team spaces on them.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/sites/dedicated-runtime";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:runtime";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor", "resource_team"];
+    readonly downRamp: {
+        readonly code: "dedicated_runtime_stop";
+        readonly 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.";
+    };
+}, {
+    readonly key: "shelf";
+    readonly name: "Shelf";
+    readonly description: "Exposes the per-user artifact shelf: dashboard curation and public /shelf/{handle} pages.";
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "build.content_pipeline";
+    readonly name: "Content pipeline";
+    readonly description: "Controls publish/finalize use of the content transformation pipeline.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: null;
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/build/content-pipeline";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:build-platform";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["resource_team"];
+    readonly downRamp: {
+        readonly code: "content_pipeline_stop";
+        readonly summary: "Deny next build/finalize; completed immutable output remains.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "tags";
+    readonly name: "Spacefast Tag Manager";
+    readonly description: "Enables Spacefast Tag Manager command surfaces, SDK configuration, and governed tag workflows.";
+    readonly stage: "private_beta";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "public";
+        readonly slug: "/docs/tags";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:tag-manager";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["request_actor", "resource_team"];
+    readonly downRamp: {
+        readonly code: "tags_stop";
+        readonly summary: "Deny every customer Tag API and dynamic module delivery; internal operator export/cleanup and platform-generated inert marker bytes remain.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "zero";
+    readonly name: "Spacefast Zero";
+    readonly description: "Enables Spacefast Zero command surfaces and hosted Zero app workflows.";
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {
+            readonly enterprise: true;
+            readonly internal: true;
+        };
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/zero";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:zero";
+    readonly requires: readonly ["sites.dedicated_runtime"];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["resource_team"];
+    readonly downRamp: {
+        readonly code: "zero_stop";
+        readonly summary: "Stop activation/invocation; operator export/delete/migration recovery remain.";
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "functions";
+    readonly name: "Spacefast Functions";
+    readonly description: string;
+    readonly stage: "internal";
+    readonly surface: true;
+    readonly defaultEnabled: false;
+    readonly runtime: {
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["team", "global"];
+    readonly docs: {
+        readonly channel: "handbook";
+        readonly slug: "/features/functions";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:zero";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-27";
+    readonly reviewAfter: "2026-08-26";
+    readonly removeAfter: "2026-10-25";
+    readonly gaAt: null;
+    readonly allowedActorPolicies: readonly ["resource_team"];
+    readonly downRamp: {
+        readonly code: "functions_stop";
+        readonly summary: string;
+    };
+}, {
+    readonly cohort: "launch";
+    readonly key: "spaces.slug_rename";
+    readonly name: "Space slug rename";
+    readonly description: "Renames a space and its managed hostname while retained former hostnames temporarily redirect to the current address.";
+    readonly stage: "ga";
+    readonly surface: true;
+    readonly defaultEnabled: true;
+    readonly runtime: {
+        readonly enabledInDevelopment: true;
+        readonly enabledForA8c: true;
+        readonly planDefaults: {};
+    };
+    readonly assignmentScopes: readonly ["user", "team", "global"];
+    readonly docs: {
+        readonly channel: "public";
+        readonly slug: "/docs/spaces/rename";
+        readonly feedbackUrl: null;
+    };
+    readonly owner: "team:spaces";
+    readonly requires: readonly [];
+    readonly lifecycleAdoptedAt: "2026-07-12";
+    readonly reviewAfter: "2026-08-11";
+    readonly removeAfter: "2026-10-10";
+    readonly gaAt: "2026-07-27";
+    readonly allowedActorPolicies: readonly ["request_actor"];
+    readonly downRamp: {
+        readonly code: "slug_rename_stop";
+        readonly summary: "Deny new slug renames while already-committed hostname redirects and runtime convergence continue.";
+    };
+}];
+type FeatureEntry = (typeof featureEntries)[number];
+type LifecycleFeatureEntry = Extract<FeatureEntry, {
+    readonly cohort: "launch";
+}>;
+type RuntimeFeatureEntry = Extract<FeatureEntry, {
+    readonly runtime: object;
+}>;
+export type LifecycleFeatureKey = LifecycleFeatureEntry["key"];
+export type RuntimeFeatureKey = RuntimeFeatureEntry["key"];
+export type RuntimeFeatureDefinition<K extends RuntimeFeatureKey = RuntimeFeatureKey> = RuntimeFeatureDefinitionShape<K>;
 export declare const FEATURE_LIFECYCLE_REGISTRY: readonly FeatureRegistryEntry<LifecycleFeatureKey>[];
+type RuntimeDefinitionRecord<K extends string> = {
+    readonly [Key in K]: RuntimeFeatureDefinitionShape<Key>;
+};
+export declare const FEATURE_RUNTIME_KEYS: readonly RuntimeFeatureKey[];
+export declare const FEATURE_RUNTIME_DEFINITIONS: Readonly<RuntimeDefinitionRecord<"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 FEATURE_LIFECYCLE_BY_KEY: ReadonlyMap<LifecycleFeatureKey, FeatureRegistryEntry<LifecycleFeatureKey>>;