@aglyn/aglyn 1.0.0-beta.270 → 1.0.0-beta.272

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

@@ -362,7 +362,10 @@ export const PLAN_ENTITLEMENTS = {
             removeBranding: true,
             scheduledPublishing: false,
             aiAssist: true,
-            aiGenerative: false,
+            // One pool (AGL-3965): the plan's included credits pay for generation
+            // as well as assist on every paid plan, and an Aglyn AI tier adds
+            // credits on top rather than opening this door.
+            aiGenerative: true,
             workflows: true,
             dataStore: true,
             videoMedia: false,
@@ -481,7 +484,7 @@ export const PLAN_ENTITLEMENTS = {
             removeBranding: true,
             scheduledPublishing: false,
             aiAssist: true,
-            aiGenerative: false,
+            aiGenerative: true,
             workflows: true,
             dataStore: true,
             videoMedia: true,
@@ -552,7 +555,7 @@ export const PLAN_ENTITLEMENTS = {
             removeBranding: true,
             scheduledPublishing: true,
             aiAssist: true,
-            aiGenerative: false,
+            aiGenerative: true,
             workflows: true,
             dataStore: true,
             videoMedia: true,
@@ -626,7 +629,7 @@ export const PLAN_ENTITLEMENTS = {
             removeBranding: true,
             scheduledPublishing: true,
             aiAssist: true,
-            aiGenerative: false,
+            aiGenerative: true,
             workflows: true,
             dataStore: true,
             videoMedia: true,
@@ -697,7 +700,7 @@ export const PLAN_ENTITLEMENTS = {
             removeBranding: true,
             scheduledPublishing: true,
             aiAssist: true,
-            aiGenerative: false,
+            aiGenerative: true,
             workflows: true,
             dataStore: true,
             videoMedia: true,
@@ -772,7 +775,7 @@ export const PLAN_ENTITLEMENTS = {
             removeBranding: true,
             scheduledPublishing: true,
             aiAssist: true,
-            aiGenerative: false,
+            aiGenerative: true,
             workflows: true,
             dataStore: true,
             videoMedia: true,
@@ -1016,52 +1019,149 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
  * deal) — `planSellsSiteCare` is that rule. `resolveOrgEntitlements` flips
  * the org-wide `features.siteCare` from any purchased quantity >= 1.
  */ export const SITE_CARE_ADDON_MONTHLY_USD = 49;
+/**
+ * Site Care's included time (AGL-3959): about an hour of staff work a month,
+ * no rollover. `SITE_CARE_INCLUDED_BLOCK_MINUTES` is the step each request is
+ * counted against it in, always rounded up — a 10-minute change uses one
+ * 15-minute block. The timer's actual minutes are still logged beside it.
+ */ export const SITE_CARE_INCLUDED_MINUTES = 60;
+/** The block a request counts against the included hour in (AGL-3959). */ export const SITE_CARE_INCLUDED_BLOCK_MINUTES = 15;
+/**
+ * Site Care extra time (AGL-3959): $79 per STARTED hour past the included
+ * hour in a month. Billed in whole hours, rounded up — any part of an hour is
+ * the full rate — and never less than the hours the owner approved. Only with
+ * the owner's recorded yes, as an invoice item on the next subscription
+ * invoice; never recurring. `site-care.ts` holds the arithmetic.
+ */ export const SITE_CARE_EXTRA_HOUR_USD = 79;
+/**
+ * Site Care projects (AGL-3970): work that adds a page, a form, a design or
+ * a campaign is a flat quote, never hourly. The quote is the estimated hours
+ * × `SITE_CARE_EXTRA_HOUR_USD`, rounded up to the whole hour, and never below
+ * the published starting price of the kind of project it is. These three are
+ * those starting prices, as `/pricing` publishes them.
+ */ export const SITE_CARE_PROJECT_LANDING_PAGE_FROM_USD = 249;
+/** A redesign's published starting price (AGL-3970). */ export const SITE_CARE_PROJECT_REDESIGN_FROM_USD = 749;
+/** A logo or brand kit's published starting price (AGL-3970). */ export const SITE_CARE_PROJECT_BRAND_KIT_FROM_USD = 349;
+/**
+ * A project priced ABOVE this is billed half up front and half at launch, on
+ * two invoices from the same record; at or below it, in full up front
+ * (AGL-3970). `site-care-project.ts` holds the arithmetic.
+ */ export const SITE_CARE_PROJECT_SPLIT_ABOVE_USD = 500;
 /**
  * POS Pro register add-on (AGL-329): $89/mo per extra register/location
  * (Shopify POS Pro parity). Purchased add-ons land as a per-org
  * `posRegisters` entitlement override, which
  * `resolveOrgEntitlements` already applies over the plan default.
  */ export const POS_REGISTER_ADDON_MONTHLY_USD = 89;
+/** The tiers, smallest first — the order every picker lists them in. */ export const AI_TIER_IDS = [
+    'spark',
+    'boost',
+    'plus',
+    'max',
+    'ultra',
+    'studio'
+];
+export const AI_TIERS = {
+    spark: {
+        label: 'Spark',
+        monthlyUsd: 9,
+        yearlyUsd: 108,
+        credits: 4000
+    },
+    boost: {
+        label: 'Boost',
+        monthlyUsd: 19,
+        yearlyUsd: 228,
+        credits: 9000
+    },
+    plus: {
+        label: 'Plus',
+        monthlyUsd: 39,
+        yearlyUsd: 468,
+        credits: 19000
+    },
+    max: {
+        label: 'Max',
+        monthlyUsd: 69,
+        yearlyUsd: 828,
+        credits: 34000
+    },
+    ultra: {
+        label: 'Ultra',
+        monthlyUsd: 99,
+        yearlyUsd: 1188,
+        credits: 49000
+    },
+    studio: {
+        label: 'Studio',
+        monthlyUsd: 299,
+        yearlyUsd: 3588,
+        credits: 149000
+    }
+};
 /**
- * The Aglyn AI add-on's credit band (AGL-2896): the credits a month the
- * add-on ADDS to the plan's `assistCreditsPerMonth` when
- * `seatAddons.aiAddon` is set. One pool and one meter — the add-on widens
- * the band the assist meter already draws on rather than opening a second
- * one, so `resolveAssistCreditBudget`, the overage price and the hard-cap
- * switch all see one number.
- *
- * ## Sized against the add-on's own price
- *
- * A credit is `ASSIST_CREDIT_COST_USD` of provider spend, so each band is a
- * cost figure: 1,000 credits are $1.00. Every band here costs at most 50% of
- * `PlanPricing.aiAddonMonthlyUsd` at full consumption — Starter $4 of $9,
- * Pro $9 of $19, Business $19 of $39, Scale $34 of $69, Advanced $49 of
- * $99, Agency $149 of $299 — which is the same line-margin floor
- * (`ASSIST_CREDIT_MIN_MARGIN_PCT`) every retail assist rate clears.
- * `tier-margin-floor.spec.ts` holds the whole tier non-negative with the
- * add-on band at 100% and the add-on's revenue counted, and pins each band's
- * share of its price.
- *
- * ## Free and Enterprise
- *
- * Free is 0: the plan sells no add-on (`aiAddonMonthlyUsd` is null), so a
- * quantity written onto a Free org adds nothing. Enterprise is finite at
- * twice Agency's, the rule every Enterprise fallback follows since the
- * 2026-09-07 decision (AGL-2654) — never `UNLIMITED`, for the reason
- * `ENTERPRISE_ASSIST_CREDITS_PER_MONTH` gives: an unbounded band reads back
- * as zero off the wire. Enterprise carries `aiGenerative` in the agreement
- * and its price is null too, so this figure is what a contract that names
- * the add-on starts from before its own number is written.
- */ export const AI_ADDON_CREDITS_PER_MONTH = {
-    free: 0,
-    starter: 4000,
-    pro: 9000,
-    business: 19000,
-    scale: 34000,
-    advanced: 49000,
-    agency: 149000,
-    enterprise: 298000
+ * The tier an add-on bought before AGL-3965 is (AGL-3965): the one with the
+ * same price and the same band the plan sold it at, so a workspace that
+ * held "the Pro add-on" holds Boost — $19, 9,000 credits — and neither its
+ * bill nor its credits move. Read when `aiTier` is absent and to classify a
+ * per-plan `STRIPE_PRICE_{PLAN}_AI_ADDON` item still on a subscription.
+ */ export const LEGACY_AI_ADDON_TIER_BY_PLAN = {
+    starter: 'spark',
+    pro: 'boost',
+    business: 'plus',
+    scale: 'max',
+    advanced: 'ultra',
+    agency: 'studio'
 };
+/**
+ * The tier a purchase that names a plan and no tier means (AGL-3965): a
+ * `?plan=pro&ai=1` deep link, a checkout posting `aiAddon: true` alone. The
+ * tier with that plan's old price and band, so a link published before tiers
+ * existed still sells what it quoted. Null where the plan sells no tier.
+ */ export function defaultAiTierForPlan(plan) {
+    var _LEGACY_AI_ADDON_TIER_BY_PLAN_plan;
+    if (!planSellsAiTiers(plan)) return null;
+    return (_LEGACY_AI_ADDON_TIER_BY_PLAN_plan = LEGACY_AI_ADDON_TIER_BY_PLAN[plan]) != null ? _LEGACY_AI_ADDON_TIER_BY_PLAN_plan : null;
+}
+/** Whether a value is one of the tier ids. */ export function isAiTierId(value) {
+    return typeof value === 'string' && AI_TIER_IDS.includes(value);
+}
+/** `ai:<tier>` for a tier. */ export function aiTierAddonKey(tier) {
+    return `ai:${tier}`;
+}
+/**
+ * The tier an `ai:<tier>` key names, or null for anything else — another
+ * add-on's key, a bare `ai`, an unknown tier, a non-string. Exact and
+ * case-sensitive: a key is read off a link, and guessing is the expensive
+ * direction to be wrong in (`parseOnboardingPlanIntent` reads `?ai=` the
+ * same way).
+ */ export function parseAiTierAddonKey(key) {
+    if (typeof key !== 'string' || !key.startsWith('ai:')) return null;
+    const tier = key.slice(3);
+    return isAiTierId(tier) ? tier : null;
+}
+/**
+ * Every tier as an `ai:<tier>` add-on, smallest first — what a picker that
+ * offers "Aglyn AI" beside the other add-ons lists. Empty for a plan that
+ * sells no tier (Free, Enterprise) when a plan is given.
+ */ export function listAiTierAddons(plan) {
+    if (plan !== undefined && !planSellsAiTiers(plan)) return [];
+    return AI_TIER_IDS.map((tier)=>({
+            key: aiTierAddonKey(tier),
+            tier,
+            label: AI_TIERS[tier].label,
+            monthlyUsd: AI_TIERS[tier].monthlyUsd,
+            yearlyUsd: AI_TIERS[tier].yearlyUsd,
+            credits: AI_TIERS[tier].credits
+        }));
+}
+/**
+ * Whether a plan may buy an Aglyn AI tier (AGL-3965): every paid self-serve
+ * plan. Not Free, which has no subscription to carry it, and not Enterprise,
+ * whose AI is in the agreement.
+ */ export function planSellsAiTiers(plan) {
+    return planSellsSiteCare(plan);
+}
 /**
  * The generative add-on's name as a person sees it (AGL-2896): the brand,
  * then "AI". Read from the platform brand by default and from the org's
@@ -1108,7 +1208,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         extraDataGbMonthlyUsd: null,
         extraApiRequestsUsdPer1k: null,
         extraAssistCreditsUsdPer1k: null,
-        aiAddonMonthlyUsd: null,
         extraContactsUsdPer1k: null,
         extraEmailSendsUsdPer1k: null,
         meteredInfraPassThrough: false
@@ -1129,7 +1228,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         // the silent free overage, and this rate without the band is a fee
         // advertised on a quantity the plan never sold.
         extraAssistCreditsUsdPer1k: 3,
-        aiAddonMonthlyUsd: 9,
         extraContactsUsdPer1k: 1,
         // No email band to be "over" — see `emailSendsPerMonth` on the Starter
         // entitlements. `emailSendsOverage` returns 0 for any non-positive band,
@@ -1148,7 +1246,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         extraDataGbMonthlyUsd: 0.36,
         extraApiRequestsUsdPer1k: null,
         extraAssistCreditsUsdPer1k: 3,
-        aiAddonMonthlyUsd: 19,
         extraContactsUsdPer1k: 0.75,
         extraEmailSendsUsdPer1k: 2.25,
         meteredInfraPassThrough: true
@@ -1163,7 +1260,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         extraDataGbMonthlyUsd: 0.36,
         extraApiRequestsUsdPer1k: 0.5,
         extraAssistCreditsUsdPer1k: 2.75,
-        aiAddonMonthlyUsd: 39,
         extraContactsUsdPer1k: 0.5,
         extraEmailSendsUsdPer1k: 2,
         meteredInfraPassThrough: true
@@ -1178,7 +1274,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         extraDataGbMonthlyUsd: 0.36,
         extraApiRequestsUsdPer1k: 0.35,
         extraAssistCreditsUsdPer1k: 2.5,
-        aiAddonMonthlyUsd: 69,
         extraContactsUsdPer1k: 0.4,
         extraEmailSendsUsdPer1k: 1.9,
         meteredInfraPassThrough: true
@@ -1196,7 +1291,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         // or above $0.234 (AGL-3444).
         extraApiRequestsUsdPer1k: 0.25,
         extraAssistCreditsUsdPer1k: 2.25,
-        aiAddonMonthlyUsd: 99,
         // FLOORED at the 50% retail margin, not stepped down again. The ladder
         // above it descends $1.00 → $0.75 → $0.50 → $0.40, and one more step
         // would have reached $0.25 against a `perContactMonth` cost of $0.20 per
@@ -1230,7 +1324,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         // FLOORED at the 50% retail margin — see Advanced's.
         extraApiRequestsUsdPer1k: 0.25,
         extraAssistCreditsUsdPer1k: 2,
-        aiAddonMonthlyUsd: 299,
         // $0.40, because the band it meters is now FINITE.
         //
         // This row has been wrong in both directions. It shipped $0.20 against an
@@ -1273,7 +1366,6 @@ fillPluginPlanEntitlements(PLAN_ENTITLEMENTS);
         extraDataGbMonthlyUsd: null,
         extraApiRequestsUsdPer1k: null,
         extraAssistCreditsUsdPer1k: null,
-        aiAddonMonthlyUsd: null,
         extraContactsUsdPer1k: null,
         extraEmailSendsUsdPer1k: null,
         meteredInfraPassThrough: false
@@ -1622,8 +1714,11 @@ function trimmedOrNull(value) {
     const addons = (_ref = org == null ? void 0 : org.seatAddons) != null ? _ref : {};
     const seats = (quantity, price)=>Math.max(0, quantity != null ? quantity : 0) * (price != null ? price : 0);
     return (annual ? pricing.basePriceAnnualMonthlyUsd : pricing.basePriceMonthlyUsd) + seats(addons.managers, pricing.extraSeatMonthlyUsd) + seats(addons.members, pricing.extraCollaboratorMonthlyUsd) + seats(addons.datasets, pricing.extraDatasetMonthlyUsd) + seats(addons.hosts, pricing.extraHostMonthlyUsd) + seats(addons.posRegisters, POS_REGISTER_ADDON_MONTHLY_USD) + seats(addons.eventCalendar, EVENT_CALENDAR_ADDON_MONTHLY_USD) + seats(siteCareUnits(addons), SITE_CARE_ADDON_MONTHLY_USD) + // A toggle, not a quantity: one purchase covers the org, so a stored
-    // quantity above one bills once.
-    seats(aiAddonUnits(addons), pricing.aiAddonMonthlyUsd);
+    // quantity above one bills once, at its tier's price (AGL-3965).
+    aiTierMonthlyUsd(aiTierOfPurchase(org));
+}
+/** A tier's monthly price, or 0 for no tier. */ function aiTierMonthlyUsd(tier) {
+    return tier ? AI_TIERS[tier].monthlyUsd : 0;
 }
 /**
  * How many Aglyn AI add-ons a purchase map counts as: 0 or 1 (AGL-2896).
@@ -2449,6 +2544,65 @@ function resolvePlan(org) {
  */ export function hasAiAddon(org) {
     return aiAddonUnits(resolvePurchasedAddons(org)) === 1;
 }
+/**
+ * Which Aglyn AI tier the org's purchase map holds (AGL-3965), whether or
+ * not the subscription is still paying for it — `resolveAiTier` is the
+ * reading that drops a dead one. `org.aiTier` when it names a tier;
+ * otherwise, for an add-on bought before tiers existed, the tier with that
+ * plan's old price and band (`LEGACY_AI_ADDON_TIER_BY_PLAN`). Null when no
+ * add-on is held or the plan sells no tier (Free, Enterprise).
+ */ export function aiTierOfPurchase(org) {
+    var _LEGACY_AI_ADDON_TIER_BY_PLAN_;
+    if (aiAddonUnits(org == null ? void 0 : org.seatAddons) !== 1) return null;
+    if (!planSellsAiTiers(org == null ? void 0 : org.plan)) return null;
+    if (isAiTierId(org == null ? void 0 : org.aiTier)) return org.aiTier;
+    return (_LEGACY_AI_ADDON_TIER_BY_PLAN_ = LEGACY_AI_ADDON_TIER_BY_PLAN[org == null ? void 0 : org.plan]) != null ? _LEGACY_AI_ADDON_TIER_BY_PLAN_ : null;
+}
+/**
+ * The Aglyn AI tier that currently applies (AGL-3965): bought, on a
+ * subscription still paying for it, on a plan that sells tiers. The ONE
+ * reading every surface that shows or counts a tier goes through.
+ */ export function resolveAiTier(org) {
+    return hasAiAddon(org) ? aiTierOfPurchase(org) : null;
+}
+/**
+ * What `seatAddons.aiAddon` adds on an Enterprise org (AGL-2896, kept by
+ * AGL-3965): twice Studio's band, the figure the per-plan table carried as
+ * twice Agency's (the rule every Enterprise fallback follows since AGL-2654),
+ * and still what a contract that names the add-on starts from before its own
+ * number is written. Enterprise buys no tier — its AI is in the agreement —
+ * so this is the contract figure kept, not a price; finite, never
+ * `UNLIMITED`, for the reason `ENTERPRISE_ASSIST_CREDITS_PER_MONTH` gives.
+ */ export const ENTERPRISE_AI_ADDON_CREDITS_PER_MONTH = AI_TIERS.studio.credits * 2;
+/**
+ * The Aglyn AI add-on's per-unit quota as `resolveOrgEntitlements` folds it
+ * (AGL-3965): the purchased tier's credits, on a plan that sells tiers;
+ * Enterprise's contract figure (`ENTERPRISE_AI_ADDON_CREDITS_PER_MONTH`);
+ * else 0 (Free). The AI plugin declares its seat add-on with this as
+ * `quota.perUnit`.
+ */ export function aiTierQuotaPerUnit(org, plan) {
+    if (plan === 'enterprise') return ENTERPRISE_AI_ADDON_CREDITS_PER_MONTH;
+    if (!planSellsAiTiers(plan)) return 0;
+    const tier = aiTierOfPurchase(org);
+    return tier ? AI_TIERS[tier].credits : 0;
+}
+/**
+ * The credits a month the org's Aglyn AI add-on adds to its plan's included
+ * band (AGL-3965) — 0 with none held. The SAME figure `resolveOrgEntitlements`
+ * folds into `assistCreditsPerMonth` (`aiTierQuotaPerUnit`), so a surface
+ * quoting "your tier adds" and the meter agree.
+ */ export function aiTierCreditsPerMonth(org) {
+    if (!hasAiAddon(org)) return 0;
+    return aiTierQuotaPerUnit(org, resolveEffectivePlan(org));
+}
+/**
+ * Whether this org can buy or change an Aglyn AI tier itself (AGL-3965): a
+ * plan that sells tiers, and not one a staff comp grants — a comp has no
+ * subscription to put the tier on (`compPricing`).
+ */ export function orgCanBuyAiTier(org) {
+    return !resolvePlanComp(org) && planSellsAiTiers(resolveEffectivePlan(org));
+}
+/** "Aglyn AI Boost": the product name, then the tier's. */ export const aiTierName = (tier, brand = PLATFORM_BRAND_NAME)=>`${aiAddonName(brand)} ${AI_TIERS[tier].label}`;
 /**
  * Whether the org's Site Care add-on currently applies (AGL-3954): bought,
  * and on a subscription that is still paying for it, so a dead subscription
@@ -2652,7 +2806,7 @@ function resolvePlan(org) {
     // `hostLimit` and purchased sites do. The per-unit figure is the PLAN's,
     // read off the effective plan rather than the stored one, so a dead
     // subscription that resolved to free adds free's figure.
-    const folded = foldPluginSeatAddons(resolved, purchased, resolvePlan(org));
+    const folded = foldPluginSeatAddons(resolved, purchased, resolvePlan(org), org != null ? org : {});
     if (!extraHosts && !eventCalendar && !siteCare && folded === resolved) {
         return resolved;
     }
@@ -2693,7 +2847,7 @@ function resolvePlan(org) {
  * quota each names gains its per-plan figure per unit, and its features
  * switch on. Returns the input object untouched when nothing applies, so a
  * caller can tell "nothing folded" from "folded to the same numbers".
- */ function foldPluginSeatAddons(resolved, purchased, plan) {
+ */ function foldPluginSeatAddons(resolved, purchased, plan, org) {
     let out = resolved;
     for (const addon of listPluginSeatAddons()){
         var _addon_features;
@@ -2703,8 +2857,9 @@ function resolvePlan(org) {
             features: _extends({}, out.features)
         });
         if (addon.quota) {
-            var _addon_quota_perUnitByPlan_plan, _bag_addon_quota_key;
-            const perUnit = (_addon_quota_perUnitByPlan_plan = addon.quota.perUnitByPlan[plan]) != null ? _addon_quota_perUnitByPlan_plan : 0;
+            var _ref, _bag_addon_quota_key;
+            var _addon_quota_perUnitByPlan;
+            const perUnit = addon.quota.perUnit ? addon.quota.perUnit(org, plan) : (_ref = (_addon_quota_perUnitByPlan = addon.quota.perUnitByPlan) == null ? void 0 : _addon_quota_perUnitByPlan[plan]) != null ? _ref : 0;
             const bag = next;
             const current = Number((_bag_addon_quota_key = bag[addon.quota.key]) != null ? _bag_addon_quota_key : 0);
             bag[addon.quota.key] = (Number.isFinite(current) ? current : 0) + perUnit * units;