@aglyn/aglyn 1.0.0-beta.227 → 1.0.0-beta.229

package/src/lib/app-utils/plan-entitlements.js

@@ -23,34 +23,31 @@ import { declaredMeterReading, pluginCostAxes, pluginCostAxisFields } from "../p
 import { planQuotaOf, pluginPlanFeatureRow, pluginPlanQuotaRow, pluginPlanQuotas } from "../plugin-manager/plugin-plan-entitlements.js";
 /** Sentinel for quotas a plan does not cap; `checkQuota` always allows. */ export const UNLIMITED = Number.POSITIVE_INFINITY;
 /**
- * How many saved form definitions one site may hold, on every plan that can
- * build them at all.
- *
- * ⛔ **Not a tier lever, and must not become one.** The website-building field
- * does not meter form COUNT: Squarespace, HubSpot and Mailchimp publish no cap
- * whatsoever, Webflow abandoned the lever above its free tier, and of the two
- * that do meter it one is Wix (4/10/25/75) and the other is Jotform
- * (5/25/50/100), a form-first product where a form IS the billable unit. What
- * this platform meters on the forms axis is `formSubmissionsPerMonth`, which
- * is tiered, metered and part of a charged price.
- *
- * So this is an abuse ceiling wearing an entitlement's clothes. It rides
- * `formsPerHost` because that is where `checkQuota` can refuse a create inside
- * the counting transaction, not because the number is sold — and it resolves
- * to the same value on Starter through Enterprise. Only Free differs, and only
- * because the form entity rides `reusableComponents`, which Free lacks.
- *
- * The value clears every published competitor number by 5x and the largest
- * real catalog by far, and it stays STRICTLY below `FORMS_MAX_PER_HOST` — the
- * page size two listing reads use. The gap is deliberate: a catalog can sit
- * above this ceiling when a per-org override is withdrawn, and the two
- * numbers must stay tellable apart so a surface reading the window where it
- * means the ceiling is never accidentally right. `forms.spec.ts` pins both
- * halves.
- *
- * A per-org `entitlements.formsPerHost` override still resolves ahead of this,
- * so a contract can raise or lower it for one org without moving the ceiling
- * everyone else is measured against.
+ * How many saved form definitions one site may hold on the plans at the top
+ * of the ladder: Scale, Advanced, Agency and Enterprise.
+ *
+ * Since 2026-10-06 the saved-form catalog IS a tier lever (AGL-3597): Free 1,
+ * Starter 5, Pro 25, Business 100, and this ceiling above them. Before that
+ * date every paid plan carried this number and Free carried none, which made
+ * a Starter catalog of 500 forms a give-away no pricing page listed. The
+ * ladder sits close to the published form-count ladders in the field (Wix
+ * 4/10/25/75, Jotform 5/25/50/100), and the allowance is listed on the
+ * pricing pages as "Saved forms per site".
+ *
+ * A form is no longer gated by `reusableComponents`: a Free site can save its
+ * one form, and only components stay Starter-and-above. The count is refused
+ * at the CREATE and nowhere else, so a site already holding more than its new
+ * allowance keeps every form it has; it only cannot add another.
+ *
+ * The value stays STRICTLY below `FORMS_MAX_PER_HOST` — the page size two
+ * listing reads use. The gap is deliberate: a catalog can sit above this
+ * ceiling when a per-org override is withdrawn, and the two numbers must stay
+ * tellable apart so a surface reading the window where it means the ceiling
+ * is never accidentally right. `forms.spec.ts` pins both halves.
+ *
+ * A per-org `entitlements.formsPerHost` override still resolves ahead of the
+ * plan's number, so a contract can raise or lower it for one org without
+ * moving the allowance everyone else on the plan is measured against.
  */ export const FORMS_PER_HOST_CEILING = 500;
 /**
  * Is this quota value "no cap"? (AGL-2482; AGL-2223 is the same class.)
@@ -173,19 +170,17 @@ export const PLAN_ENTITLEMENTS = {
         maxManagersPerOrg: 1,
         maxMembersPerHost: 1,
         bandwidthGb: 2,
-        // No saved-form CATALOG on Free: the form entity rides
-        // `reusableComponents`, which is Starter-and-above, so
-        // `/api/hosts/resources` refuses the create on the entitlement before it
-        // ever reaches this number. Zero is what a Free site actually gets.
+        // One saved form per Free site (AGL-3597). The saved form does not ride
+        // `reusableComponents` — components stay Starter-and-above, a form does
+        // not — so `/api/hosts/resources` refuses a second form on this number,
+        // with the upgrade path, rather than refusing the first on a feature.
         //
-        // It does NOT mean a Free site has no forms. A `Form` node placed on a
-        // page needs no definition to collect, and the 20 submissions above are
-        // the band those replies spend.
+        // A `Form` node placed on a page still needs no definition to collect,
+        // and the 20 submissions above are the band those replies spend.
         //
-        // Every other plan carries `FORMS_PER_HOST_CEILING`. This is the one
-        // number on the axis that differs, and it differs because the entitlement
-        // gate above it says so, not because the catalog is sold by the tier.
-        formsPerHost: 0,
+        // The ladder: Free 1, Starter 5, Pro 25, Business 100, and
+        // `FORMS_PER_HOST_CEILING` on Scale and above.
+        formsPerHost: 1,
         variablesPerHost: 3,
         functionsPerHost: 1,
         workflowsPerHost: 0,
@@ -296,7 +291,7 @@ export const PLAN_ENTITLEMENTS = {
         maxMembersPerHost: 10,
         // Sized by the same annual-price invariant as Pro's — see that band.
         bandwidthGb: 15,
-        formsPerHost: FORMS_PER_HOST_CEILING,
+        formsPerHost: 5,
         variablesPerHost: 25,
         functionsPerHost: 10,
         workflowsPerHost: 3,
@@ -421,7 +416,7 @@ export const PLAN_ENTITLEMENTS = {
         // `meteredInfraPassThrough` is true here, so traffic past the band BILLS
         // at the page-view pass-through rather than being refused or absorbed.
         bandwidthGb: 25,
-        formsPerHost: FORMS_PER_HOST_CEILING,
+        formsPerHost: 25,
         variablesPerHost: 100,
         functionsPerHost: 50,
         workflowsPerHost: 25,
@@ -513,7 +508,7 @@ export const PLAN_ENTITLEMENTS = {
         maxMembersPerHost: 100,
         // Sized by the same annual-price invariant as Pro's — see that band.
         bandwidthGb: 45,
-        formsPerHost: FORMS_PER_HOST_CEILING,
+        formsPerHost: 100,
         variablesPerHost: 1000,
         functionsPerHost: 250,
         workflowsPerHost: 100,
@@ -823,8 +818,8 @@ export const PLAN_ENTITLEMENTS = {
     // ceiling still flags and pages staff at 3× the band, and does NOT degrade
     // the render on this plan — see `bandwidthCeilingDegradesRender`.
     //
-    // `formsPerHost` is the same flat ceiling every plan carries; it bounds a
-    // collection, not a tier, and the 2026-08-30 decision withdrew the ladder.
+    // `formsPerHost` is `FORMS_PER_HOST_CEILING`, the top of the saved-form
+    // ladder (AGL-3597), shared with Scale, Advanced and Agency.
     enterprise: {
         hostLimit: 200,
         screensPerHost: UNLIMITED,