@spacefast/common 0.0.24 → 0.2.1

package/dist/contracts/features.d.ts

@@ -12,7 +12,7 @@ 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 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";
     "plans.paid.available": "plans.paid.available";
@@ -25,12 +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";
-    shelf: "shelf";
+    "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"];
@@ -110,9 +113,9 @@ export declare const teamEntitlementsResponseSchema: z.ZodObject<{
     runtimePhpWorkers: z.ZodNumber;
     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">]>;
@@ -143,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";
@@ -260,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;
@@ -280,8 +296,8 @@ export declare const FEATURE_DEFINITIONS: Readonly<{
         readonly enabledForA8c: boolean;
         readonly planDefaults: Readonly<Partial<Record<PlanCode, boolean>>>;
     };
-    readonly shelf: {
-        readonly key: "shelf";
+    readonly "collab.drawing": {
+        readonly key: "collab.drawing";
         readonly name: string;
         readonly description: string;
         readonly defaultEnabled: boolean;
@@ -320,12 +336,33 @@ 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";
-    kill_switch: "kill_switch";
     env: "env";
+    kill_switch: "kill_switch";
+    dependency: "dependency";
 }>;
 export declare const FeatureStateSchema: z.ZodObject<{
     key: z.ZodEnum<{
@@ -340,19 +377,23 @@ 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";
-        shelf: "shelf";
+        "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<{
         default: "default";
         override: "override";
-        kill_switch: "kill_switch";
         env: "env";
+        kill_switch: "kill_switch";
+        dependency: "dependency";
     }>;
 }, z.core.$strip>;
 export declare const FeatureStateResponseSchema: z.ZodObject<{
@@ -375,12 +416,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";
-        shelf: "shelf";
+        "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";
@@ -394,19 +438,23 @@ 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";
-            shelf: "shelf";
+            "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<{
             default: "default";
             override: "override";
-            kill_switch: "kill_switch";
             env: "env";
+            kill_switch: "kill_switch";
+            dependency: "dependency";
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -419,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,7 +1,9 @@
 import { z } from "zod";
 import { FEATURE_RUNTIME_DEFINITIONS, FEATURE_RUNTIME_KEYS, } from "./feature-lifecycle.js";
-// Spec plan vocabulary (internal-docs/platform.md "Plans And Limits").
-// `enterprise` and `internal` are named plans without self-serve pricing.
+// 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";
@@ -21,7 +23,7 @@ export const featureOverrideStateSchema = z.enum(FEATURE_OVERRIDE_STATES);
 export const planLimitValueSchema = z
     .union([z.number().int().nonnegative(), z.literal("unlimited")])
     .describe('Plan limit value; "unlimited" when the plan does not limit this axis.');
-// Named plan limit table (internal-docs/platform.md "Plans And Limits",
+// Named plan limit table (the platform spec "Plans And Limits",
 // Free/Personal/Work columns verbatim). Keys mirror `PlanPolicyResponse.limits`
 // so plan policy is a projection of this data, never a re-derivation.
 export const planLimitsSchema = z
@@ -30,13 +32,12 @@ export const planLimitsSchema = z
     teamMembers: planLimitValueSchema,
     subTeams: planLimitValueSchema,
     externalDomainGroups: 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
-    // .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,
@@ -47,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,
@@ -56,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."),
@@ -79,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({
@@ -110,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,
@@ -126,11 +122,13 @@ export const PLAN_DEFINITIONS = {
         name: "Free",
         monthlyPriceUsd: 0,
         yearlyPriceUsd: 0,
-        includedSeats: 3,
+        // Free is single-player: the owner is the only editor. Reviewers and
+        // agent principals are not seats.
+        includedSeats: 1,
         extraSeatPriceUsd: null,
         limits: {
-            storageBytes: 5 * GB,
-            teamMembers: 3,
+            storageBytes: 10 * GB,
+            teamMembers: 1,
             subTeams: 0,
             externalDomainGroups: 3,
             egressBytesPerDay: 100 * GB, // = worst-case ceiling; tunable per plan
@@ -149,15 +147,17 @@ export const PLAN_DEFINITIONS = {
     },
     personal: {
         code: "personal",
-        name: "Personal",
-        monthlyPriceUsd: 5,
-        yearlyPriceUsd: 60,
-        includedSeats: 5,
-        extraSeatPriceUsd: { monthly: 1, yearly: 12 },
+        name: "Plus",
+        monthlyPriceUsd: 4.99,
+        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.
+        extraSeatPriceUsd: { monthly: 4.99, yearly: 49.99 },
         limits: {
             ...UNLIMITED_LIMITS,
-            storageBytes: 20 * GB,
-            teamMembers: 5,
+            storageBytes: 50 * GB,
+            teamMembers: 3,
             subTeams: 0,
             externalDomainGroups: 10,
             maxFileBytes: 1 * GB,
@@ -174,18 +174,18 @@ export const PLAN_DEFINITIONS = {
     },
     work: {
         code: "work",
-        name: "Work",
-        monthlyPriceUsd: 15,
-        yearlyPriceUsd: 180,
-        includedSeats: 15,
-        extraSeatPriceUsd: { monthly: 1, yearly: 12 },
+        name: "Pro",
+        monthlyPriceUsd: 49.99,
+        yearlyPriceUsd: 499,
+        includedSeats: 10,
+        extraSeatPriceUsd: { monthly: 4.99, yearly: 49.99 },
         limits: {
             ...UNLIMITED_LIMITS,
-            storageBytes: 50 * GB,
+            storageBytes: 200 * GB,
             // 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,
+            teamMembers: 10,
             subTeams: 0,
             ...ACCESS_QUOTA_DEFAULTS,
         },
@@ -194,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",
@@ -224,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."),