@spacefast/common 0.0.23 → 0.0.26

package/dist/contracts/features.js

@@ -1,10 +1,20 @@
 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").
+// 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.
 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
@@ -14,7 +24,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
@@ -23,15 +33,8 @@ 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 platform spec "Abuse Posture"; internal plan data — never on
     // the PlanPolicyResponse wire shape). WORST_CASE_QUOTAS
     // .maxEgressBytesPerSpacePerDay stays the absolute platform ceiling.
     egressBytesPerDay: planLimitValueSchema,
@@ -44,9 +47,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 +67,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 +77,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 +100,6 @@ const UNLIMITED_LIMITS = {
     teamMembers: "unlimited",
     subTeams: "unlimited",
     externalDomainGroups: "unlimited",
-    versionRetentionDays: "unlimited",
-    versionGatedKeepDays: "unlimited",
     egressBytesPerDay: "unlimited",
     maxFileBytes: "unlimited",
     maxVersionFiles: "unlimited",
@@ -113,7 +107,6 @@ const UNLIMITED_LIMITS = {
     auditLogRetentionHours: "unlimited",
     buildAccessLogRetentionHours: "unlimited",
     buildsDeploysMonthly: "unlimited",
-    analyticsRetentionDays: "unlimited",
     shareLinksPerSpace: "unlimited",
     invitesPerSpace: "unlimited",
     inviteEmailsPerSpaceDaily: "unlimited",
@@ -135,13 +128,16 @@ export const PLAN_DEFINITIONS = {
         code: "free",
         name: "Free",
         monthlyPriceUsd: 0,
+        yearlyPriceUsd: 0,
+        // 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,
-            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,24 +145,26 @@ 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,
+        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,61 +172,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,
+        name: "Pro",
+        monthlyPriceUsd: 49.99,
+        yearlyPriceUsd: 499,
+        includedSeats: 10,
+        extraSeatPriceUsd: { monthly: 4.99, yearly: 49.99 },
         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.
-            teamMembers: 15,
+            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: 10,
             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 +260,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;
+}