@spacefast/common 0.0.26 → 0.2.2

package/dist/contracts/features.d.ts

@@ -12,11 +12,9 @@ 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" | "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 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.comments" | "content.managed" | "sites.dedicated_runtime" | "collab.drawing" | "tags" | "functions" | "spaces.slug_rename" | "pages.templates" | "branding.hide")[];
 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";
@@ -27,9 +25,15 @@ export declare const featureKeySchema: z.ZodEnum<{
     "domains.domain_connect": "domains.domain_connect";
     "domains.proxy_bindings": "domains.proxy_bindings";
     "collab.notices": "collab.notices";
-    "collab.drawing": "collab.drawing";
+    "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";
 }>;
 export type FeatureKey = RuntimeFeatureKey;
 export declare const FEATURE_OVERRIDE_STATES: readonly ["enabled", "disabled", "kill_switch"];
@@ -142,12 +146,15 @@ export type PlanDefinition = {
     externalProxy: boolean;
     /** Paid full-page takeover templates under _pages/. */
     pagesTemplates: boolean;
-    /** Paid removal of the tasteful Spacefast badge from designed defaults. */
+    /** Paid removal of the Spacefast badge from designed defaults. */
     hideSpacefastBranding: boolean;
     runtimePhpWorkers: number;
 };
 export type FeatureDefinition = RuntimeFeatureDefinition;
-export declare const PLAN_DEFINITIONS: Record<PlanCode, PlanDefinition>;
+type PlanCatalog = {
+    [Code in PlanCode]: PlanDefinition;
+};
+export declare const PLAN_DEFINITIONS: PlanCatalog;
 export declare const FEATURE_DEFINITIONS: Readonly<{
     readonly zero: {
         readonly key: "zero";
@@ -159,26 +166,6 @@ 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;
@@ -279,8 +266,18 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
         readonly enabledForA8c: boolean;
         readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
     };
-    readonly "collab.drawing": {
-        readonly key: "collab.drawing";
+    readonly "collab.comments": {
+        readonly key: "collab.comments";
+        readonly name: string;
+        readonly description: string;
+        readonly defaultEnabled: boolean;
+    } & {
+        readonly enabledInDevelopment?: boolean;
+        readonly enabledForA8c: boolean;
+        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
+    };
+    readonly "content.managed": {
+        readonly key: "content.managed";
         readonly name: string;
         readonly description: string;
         readonly defaultEnabled: boolean;
@@ -299,6 +296,36 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
         readonly enabledForA8c: boolean;
         readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
     };
+    readonly "collab.drawing": {
+        readonly key: "collab.drawing";
+        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;
@@ -309,18 +336,37 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
         readonly enabledForA8c: boolean;
         readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
     };
+    readonly "pages.templates": {
+        readonly key: "pages.templates";
+        readonly name: string;
+        readonly description: string;
+        readonly defaultEnabled: boolean;
+    } & {
+        readonly enabledInDevelopment?: boolean;
+        readonly enabledForA8c: boolean;
+        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
+    };
+    readonly "branding.hide": {
+        readonly key: "branding.hide";
+        readonly name: string;
+        readonly description: string;
+        readonly defaultEnabled: boolean;
+    } & {
+        readonly enabledInDevelopment?: boolean;
+        readonly enabledForA8c: boolean;
+        readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
+    };
 }>;
 export declare const featureStateSourceSchema: z.ZodEnum<{
     default: "default";
     override: "override";
     env: "env";
     kill_switch: "kill_switch";
+    dependency: "dependency";
 }>;
 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";
@@ -331,9 +377,15 @@ export declare const FeatureStateSchema: z.ZodObject<{
         "domains.domain_connect": "domains.domain_connect";
         "domains.proxy_bindings": "domains.proxy_bindings";
         "collab.notices": "collab.notices";
-        "collab.drawing": "collab.drawing";
+        "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";
     }>;
     enabled: z.ZodBoolean;
     source: z.ZodEnum<{
@@ -341,6 +393,7 @@ export declare const FeatureStateSchema: z.ZodObject<{
         override: "override";
         env: "env";
         kill_switch: "kill_switch";
+        dependency: "dependency";
     }>;
 }, z.core.$strip>;
 export declare const FeatureStateResponseSchema: z.ZodObject<{
@@ -353,8 +406,6 @@ 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";
@@ -365,14 +416,18 @@ export declare const FeatureStateResponseSchema: z.ZodObject<{
         "domains.domain_connect": "domains.domain_connect";
         "domains.proxy_bindings": "domains.proxy_bindings";
         "collab.notices": "collab.notices";
-        "collab.drawing": "collab.drawing";
+        "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";
     }>, 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";
@@ -383,9 +438,15 @@ export declare const FeatureStateResponseSchema: z.ZodObject<{
             "domains.domain_connect": "domains.domain_connect";
             "domains.proxy_bindings": "domains.proxy_bindings";
             "collab.notices": "collab.notices";
-            "collab.drawing": "collab.drawing";
+            "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";
         }>;
         enabled: z.ZodBoolean;
         source: z.ZodEnum<{
@@ -393,6 +454,7 @@ export declare const FeatureStateResponseSchema: z.ZodObject<{
             override: "override";
             env: "env";
             kill_switch: "kill_switch";
+            dependency: "dependency";
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -405,3 +467,4 @@ 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;
+export {};

package/dist/contracts/features.js

@@ -1,10 +1,9 @@
 import { z } from "zod";
 import { FEATURE_RUNTIME_DEFINITIONS, FEATURE_RUNTIME_KEYS, } from "./feature-lifecycle.js";
-// Spec plan vocabulary (the platform spec "Plans And Limits").
-// `enterprise` and `internal` are named plans without self-serve pricing.
-// Codes are wire/storage vocabulary and never change with marketing renames:
-// `personal` sells as "Plus" and `work` as "Pro" (2026-08 rename) — display
-// names live on PlanDefinition.name.
+// Spec plan vocabulary (the platform spec "Plans And Limits"). `enterprise` and
+// `internal` have no self-serve pricing. Codes never change with marketing
+// renames: `personal` sells as "Plus", `work` as "Pro". Display names live on
+// PlanDefinition.name.
 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";
@@ -33,13 +32,12 @@ export const planLimitsSchema = z
     teamMembers: planLimitValueSchema,
     subTeams: planLimitValueSchema,
     externalDomainGroups: planLimitValueSchema,
-    // Per-space daily bandwidth cap feeding the egress kill-switch sweep
-    // (the platform spec "Abuse Posture"; internal plan data — never on
-    // the PlanPolicyResponse wire shape). WORST_CASE_QUOTAS
-    // .maxEgressBytesPerSpacePerDay stays the absolute platform ceiling.
+    // Per-space daily bandwidth cap feeding the egress kill-switch sweep.
+    // Internal plan data, never on the PlanPolicyResponse wire shape;
+    // WORST_CASE_QUOTAS.maxEgressBytesPerSpacePerDay stays the platform ceiling.
     egressBytesPerDay: planLimitValueSchema,
     maxFileBytes: planLimitValueSchema,
-    // Files per version. Plan policy may LOWER the 100k contract ceiling
+    // Files per version. Plan policy may lower the 100k contract ceiling
     // (Free 20,000), never raise it; the validator clamps at the ceiling.
     maxVersionFiles: planLimitValueSchema,
     routingRules: planLimitValueSchema,
@@ -50,7 +48,7 @@ export const planLimitsSchema = z
     // Access-surface abuse ceilings: generous by default, enterprise unlimited.
     // Active (non-revoked, non-expired) share links per space.
     shareLinksPerSpace: planLimitValueSchema,
-    // Active invites per space (§5.3 — enforced when invites land).
+    // Active invites per space (§5.3; enforced when invites land).
     invitesPerSpace: planLimitValueSchema,
     // Invite emails per space / per account, daily (§5.3 abuse posture).
     inviteEmailsPerSpaceDaily: planLimitValueSchema,
@@ -59,17 +57,14 @@ export const planLimitsSchema = z
     pendingAccessRequestsPerSpace: planLimitValueSchema,
 })
     .describe("Named plan limit table.");
-// Resolved team entitlements: plan limits after add-on grants plus the
-// capability dials that are not number|"unlimited" limits. Served by
-// `GET /v1/teams/{teamId}/entitlements`.
+// Served by `GET /v1/teams/{teamId}/entitlements`. The capability dials are the
+// entitlements that are not number|"unlimited" limits.
 export const teamEntitlementsSchema = z
     .object({
     planCode: planCodeSchema,
     limits: planLimitsSchema,
     externalProxy: z.boolean().describe("Whether external proxy upstreams compile on this plan."),
-    dedicatedRuntime: z
-        .literal(true)
-        .describe("Dedicated runtime availability. Every team receives its own runtime site."),
+    dedicatedRuntime: z.literal(true).describe("Every team receives its own runtime site."),
     pagesTemplates: z
         .boolean()
         .describe("Whether _pages/*.html full-page takeovers compile for this team."),
@@ -82,9 +77,8 @@ export const teamEntitlementsSchema = z
         .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.
-// `egressBytesPerDay` (abuse posture) is internal plan data — never on a wire
-// shape, mirroring PlanPolicyResponse's deliberate exclusion.
+// Wire projection of TeamEntitlements. `egressBytesPerDay` is internal
+// abuse-posture data and never on a wire shape, mirroring PlanPolicyResponse.
 export const teamEntitlementsResponseSchema = teamEntitlementsSchema
     .extend({
     limits: planLimitsSchema.omit({
@@ -113,9 +107,8 @@ const UNLIMITED_LIMITS = {
     inviteEmailsPerAccountDaily: "unlimited",
     pendingAccessRequestsPerSpace: "unlimited",
 };
-// The §5.1 access abuse-ceiling table (X-40): applied verbatim to every
-// self-serve plan; enterprise/internal stay unlimited. These sit far above
-// honest use — they are abuse ceilings, not upsell levers.
+// The §5.1 access abuse-ceiling table, applied verbatim to every self-serve
+// plan; enterprise/internal stay unlimited. Abuse ceilings, not upsell levers.
 const ACCESS_QUOTA_DEFAULTS = {
     shareLinksPerSpace: 100,
     invitesPerSpace: 500,
@@ -159,7 +152,7 @@ export const PLAN_DEFINITIONS = {
         yearlyPriceUsd: 49.99,
         includedSeats: 3,
         // Each paid seat also raises usage limits (builds, domains, emails,
-        // versions) via additive grants — the seat price is not access alone.
+        // versions) via additive grants. The seat price is not access alone.
         extraSeatPriceUsd: { monthly: 4.99, yearly: 49.99 },
         limits: {
             ...UNLIMITED_LIMITS,
@@ -201,7 +194,7 @@ export const PLAN_DEFINITIONS = {
         hideSpacefastBranding: true,
         runtimePhpWorkers: 4,
     },
-    // Footnote-only publicly ("custom — talk to us"); manual grant, never self-serve.
+    // Footnote-only publicly ("custom, talk to us"); manual grant, never self-serve.
     enterprise: {
         code: "enterprise",
         name: "Enterprise",
@@ -231,9 +224,10 @@ export const PLAN_DEFINITIONS = {
 };
 export const FEATURE_DEFINITIONS = FEATURE_RUNTIME_DEFINITIONS;
 export const featureStateSourceSchema = z
-    .enum(["kill_switch", "env", "override", "default"])
+    .enum(["kill_switch", "env", "override", "default", "dependency"])
     .describe("Layer that decides the flag: kill_switch (emergency off), env (SPACEFAST_FLAG_* variable), " +
-    "override (feature_overrides row), default (plan/code default).");
+    "override (feature_overrides row), default (plan/code default), dependency (a required " +
+    "feature is off).");
 export const FeatureStateSchema = z.object({
     key: featureKeySchema,
     enabled: z.boolean().describe("Whether the feature is enabled for the requesting actor."),