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

package/src/lib/app-utils/bundle-intent.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * THE ADD-ONS A PLAN SELLS, AND THE BUNDLE A LINK ASKS FOR (AGL-3955).
+ *
+ * One list of add-on kinds and one parser for the add-ons a link, an upgrade
+ * proposal or a staff dialog names, so the Billing card, the bundle checkout
+ * link, the hand-off proposal (AGL-3956) and `/api/billing/checkout` agree on
+ * what `addons=siteCare,ai,extraHost:2` means.
+ *
+ * The kinds are `OrgSeatAddons`' keys: what `resolvePurchasedAddons` counts,
+ * what the webhook mirrors from Stripe, and what `/api/billing/addons` sells.
+ * The prices and ceilings here are the ones `billing-addons.ts` (server)
+ * re-exports, so a kind the link can preselect is always a kind the
+ * checkout can price.
+ *
+ * A link is typed by a person and passed through hops nobody controls, so
+ * the parser never throws and never guesses: an unknown token is dropped and
+ * reported, so the page can say so in one line instead of failing.
+ */
+import type { AiTierId, OrgPlan, OrgSeatAddons } from '../foundation/definitions/org-billing.types';
+import { resolveOrgEntitlements } from './plan-entitlements';
+/** An add-on kind: a key of `org.seatAddons`. */
+export type AddonKind = keyof Required<OrgSeatAddons>;
+/**
+ * Every add-on kind Billing sells, in the order the Billing card lists them.
+ * `/api/billing/addons`, the webhook's price map and the native add-ons
+ * screen all read this list.
+ */
+export declare const ADDON_KINDS: readonly AddonKind[];
+/** The org-wide 0/1 kinds: one purchase covers the workspace. */
+export declare const TOGGLE_ADDON_KIND_LIST: readonly AddonKind[];
+export declare function isAddonKind(value: unknown): value is AddonKind;
+/**
+ * Monthly USD per unit for an add-on on a plan (yearly prices are ×12 of
+ * this); null when the plan doesn't sell the kind. Single pricing source
+ * of truth: `PLAN_PRICING`, the three flat add-on constants and `AI_TIERS`
+ * (`tier` as `addonPriceId` reads it; absent, the tier a plan-named purchase
+ * means, `defaultAiTierForPlan`, AGL-3965).
+ */
+export declare function addonUnitUsd(kind: AddonKind, plan: OrgPlan, tier?: AiTierId | null): number | null;
+/**
+ * Max purchasable quantity per kind, from a purchases-free entitlement
+ * resolution (plan defaults + staff overrides only) so the ceiling does not
+ * drift as the org buys: seat/dataset kinds stop at the plan's hard max,
+ * hosts/registers use flat ceilings, the Event Calendar, Aglyn AI and Site
+ * Care are 0/1 toggles. POS registers additionally require the `pos`
+ * feature, and Site Care a plan that sells it (`planSellsSiteCare`), which is
+ * why the plan travels with the baseline.
+ *
+ * One definition for every reader: `/api/billing/addons` asks how many the
+ * org may buy on its plan, a plan change asks how many of what it bought the
+ * new plan can deliver, and a bundle link asks how many it may preselect.
+ */
+export declare function addonMaxForBaseline(kind: AddonKind, baseline: ReturnType<typeof resolveOrgEntitlements>, plan: OrgPlan): number;
+/** The ceiling a PLAN would impose on an add-on kind, purchases excluded. */
+export declare function addonMaxForPlan(kind: AddonKind, plan: OrgPlan): number;
+/** Whether a plan sells an add-on at all: priced, with a ceiling above zero. */
+export declare function planSellsAddon(kind: AddonKind, plan: OrgPlan): boolean;
+/** Quantities by kind, absent kinds meaning none. */
+export type BundleAddons = Partial<Record<AddonKind, number>>;
+/**
+ * What a link writes for each kind. `ai` and `extraHost` are the words the
+ * account owner chose (AGL-3955); the rest follow the same shape.
+ */
+export declare const BUNDLE_ADDON_TOKENS: Record<AddonKind, string>;
+/** One add-on a token names, with the Aglyn AI tier when it names one. */
+interface ParsedToken {
+    kind: AddonKind;
+    quantity: number;
+    tier?: AiTierId;
+}
+/**
+ * THE `ai:<tier>` TOKENS (AGL-3965).
+ *
+ * Aglyn AI is a tier chosen on its own, on any paid plan: `ai:boost` adds
+ * Aglyn AI Boost. The words are the tier ids, lower-cased as every token is,
+ * and resolve through `parseAiTierAddonKey`, the one spelling of the
+ * `ai:<tier>` key. A bare `ai` (or `ai:1`) still means "add it" and sells
+ * the plan's default tier (`defaultAiTierForPlan`). An unknown tier is
+ * dropped with the notice like any other unknown add-on, never read as
+ * "add whichever tier": that would sell a tier nobody chose.
+ */
+export declare const AI_ADDON_TIER_TOKENS: Readonly<Record<string, AiTierId>>;
+export declare function resolveAiAddonTier(tier: string): ParsedToken | null;
+export interface ParsedBundleAddons {
+    addons: BundleAddons;
+    /** The tokens nothing understood, as they were written. */
+    dropped: string[];
+    /** The Aglyn AI tier an `ai:<tier>` token named (AGL-3965), if any. */
+    aiTier?: AiTierId;
+}
+/**
+ * Read the add-ons a link, a proposal or a request names.
+ *
+ * Accepts the link form (`"siteCare,ai,extraHost:2"`), a list of tokens, or a
+ * map of kind → quantity or flag (`{ siteCare: true, hosts: 2 }`, the shape
+ * the native staff screens post from their toggles). Never throws: anything
+ * it cannot read is reported in `dropped` and left out.
+ */
+export declare function parseBundleAddons(input: unknown): ParsedBundleAddons;
+export interface FittedBundleAddons {
+    addons: BundleAddons;
+    /** Kinds the plan does not sell, dropped. */
+    notSold: AddonKind[];
+}
+/**
+ * The add-ons a plan can actually carry: kinds it does not sell are dropped,
+ * quantities are held to its ceiling. What a link preselects on one plan is
+ * re-fitted when the owner picks another, so the checkout is never asked for
+ * something it would refuse.
+ */
+export declare function fitBundleAddonsToPlan(addons: BundleAddons | null | undefined, plan: OrgPlan): FittedBundleAddons;
+/**
+ * The add-ons as the link writes them: `siteCare,ai:boost,extraHost:2`.
+ * Aglyn AI is written with its tier when one is named (AGL-3965), as bare
+ * `ai` otherwise.
+ */
+export declare function bundleAddonsParam(addons: BundleAddons | null | undefined, aiTier?: AiTierId | null): string;
+/** Whether any add-on is asked for. */
+export declare function hasBundleAddons(addons: BundleAddons | null | undefined): boolean;
+/**
+ * How each kind is named to a customer, singular. Aglyn AI carries its tier
+ * when one is named: "Aglyn AI Boost" (AGL-3965).
+ */
+export declare function bundleAddonLabel(kind: AddonKind, brand?: string, aiTier?: AiTierId | null): string;
+/** "Site Care", "2 × Extra site", "Aglyn AI Boost". */
+export declare function describeBundleAddon(kind: AddonKind, quantity: number, brand?: string, aiTier?: AiTierId | null): string;
+/** The longest coupon code a link carries. Stripe codes are far shorter. */
+export declare const BUNDLE_COUPON_MAX = 64;
+/**
+ * A promotion code as a link carries it, or undefined. Only the characters
+ * Stripe allows in a customer-facing code; anything else is not a code
+ * somebody was handed, and is dropped rather than sent to Stripe.
+ *
+ * The code is only APPLIED here. Codes are minted on the staff Coupons page,
+ * which audits them; nothing on this path creates one.
+ */
+export declare function normalizeBundleCoupon(raw: unknown): string | undefined;
+/**
+ * A domain name as a bundle carries it — lower-cased, no scheme, no path —
+ * or undefined. Whether it is for sale and at what price is the registrar's
+ * answer, re-checked at purchase; this only refuses what cannot be a name.
+ */
+export declare function normalizeBundleDomain(raw: unknown): string | undefined;
+/** "$15.99". */
+export declare function formatBundleCents(cents: number): string;
+/**
+ * The domain line a bundle shows (AGL-3955): "example.com — $15.99 first
+ * year, renews yearly at $15.99". The price is the registrar's at the moment
+ * the link was minted; the purchase re-checks it.
+ */
+export declare function bundleDomainLine(domain: {
+    name: string;
+    firstYearCents: number;
+    renewalCents: number;
+}): string;
+/**
+ * The bundle in one line, for an email, a dialog or a snackbar:
+ * "Starter with Site Care and Aglyn AI, billed yearly, code BOOTH25".
+ */
+export declare function describeBundle(bundle: {
+    plan: OrgPlan;
+    addons?: BundleAddons | null;
+    interval?: 'month' | 'year' | null;
+    coupon?: string | null;
+    /** The Aglyn AI tier, named with the AI add-on (AGL-3965). */
+    aiTier?: AiTierId | null;
+}, options?: {
+    brand?: string;
+}): string;
+export {};

package/src/lib/app-utils/bundle-intent.js

@@ -0,0 +1,386 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * THE ADD-ONS A PLAN SELLS, AND THE BUNDLE A LINK ASKS FOR (AGL-3955).
+ *
+ * One list of add-on kinds and one parser for the add-ons a link, an upgrade
+ * proposal or a staff dialog names, so the Billing card, the bundle checkout
+ * link, the hand-off proposal (AGL-3956) and `/api/billing/checkout` agree on
+ * what `addons=siteCare,ai,extraHost:2` means.
+ *
+ * The kinds are `OrgSeatAddons`' keys: what `resolvePurchasedAddons` counts,
+ * what the webhook mirrors from Stripe, and what `/api/billing/addons` sells.
+ * The prices and ceilings here are the ones `billing-addons.ts` (server)
+ * re-exports, so a kind the link can preselect is always a kind the
+ * checkout can price.
+ *
+ * A link is typed by a person and passed through hops nobody controls, so
+ * the parser never throws and never guesses: an unknown token is dropped and
+ * reported, so the page can say so in one line instead of failing.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { AI_TIER_IDS, AI_TIERS, aiAddonName, aiTierAddonKey, aiTierName, defaultAiTierForPlan, EVENT_CALENDAR_ADDON_MONTHLY_USD, EXTRA_HOSTS_ADDON_MAX, PLAN_LABELS, parseAiTierAddonKey, PLAN_PRICING, planSellsAiTiers, planSellsSiteCare, POS_REGISTER_ADDON_MONTHLY_USD, POS_REGISTERS_ADDON_MAX, resolveOrgEntitlements, SITE_CARE_ADDON_MONTHLY_USD, UNLIMITED } from "./plan-entitlements.js";
+/**
+ * Every add-on kind Billing sells, in the order the Billing card lists them.
+ * `/api/billing/addons`, the webhook's price map and the native add-ons
+ * screen all read this list.
+ */ export const ADDON_KINDS = [
+    'managers',
+    'members',
+    'datasets',
+    'hosts',
+    'posRegisters',
+    'eventCalendar',
+    'aiAddon',
+    'siteCare'
+];
+/** The org-wide 0/1 kinds: one purchase covers the workspace. */ export const TOGGLE_ADDON_KIND_LIST = [
+    'eventCalendar',
+    'aiAddon',
+    'siteCare'
+];
+export function isAddonKind(value) {
+    return typeof value === 'string' && ADDON_KINDS.includes(value);
+}
+/**
+ * Monthly USD per unit for an add-on on a plan (yearly prices are ×12 of
+ * this); null when the plan doesn't sell the kind. Single pricing source
+ * of truth: `PLAN_PRICING`, the three flat add-on constants and `AI_TIERS`
+ * (`tier` as `addonPriceId` reads it; absent, the tier a plan-named purchase
+ * means, `defaultAiTierForPlan`, AGL-3965).
+ */ export function addonUnitUsd(kind, plan, tier) {
+    const pricing = PLAN_PRICING[plan];
+    switch(kind){
+        case 'managers':
+            return pricing.extraSeatMonthlyUsd;
+        case 'members':
+            return pricing.extraCollaboratorMonthlyUsd;
+        case 'datasets':
+            return pricing.extraDatasetMonthlyUsd;
+        case 'hosts':
+            return pricing.extraHostMonthlyUsd;
+        case 'posRegisters':
+            return POS_REGISTER_ADDON_MONTHLY_USD;
+        case 'eventCalendar':
+            return EVENT_CALENDAR_ADDON_MONTHLY_USD;
+        case 'aiAddon':
+            {
+                const chosen = planSellsAiTiers(plan) ? tier != null ? tier : defaultAiTierForPlan(plan) : null;
+                return chosen ? AI_TIERS[chosen].monthlyUsd : null;
+            }
+        case 'siteCare':
+            return SITE_CARE_ADDON_MONTHLY_USD;
+    }
+}
+/**
+ * Max purchasable quantity per kind, from a purchases-free entitlement
+ * resolution (plan defaults + staff overrides only) so the ceiling does not
+ * drift as the org buys: seat/dataset kinds stop at the plan's hard max,
+ * hosts/registers use flat ceilings, the Event Calendar, Aglyn AI and Site
+ * Care are 0/1 toggles. POS registers additionally require the `pos`
+ * feature, and Site Care a plan that sells it (`planSellsSiteCare`), which is
+ * why the plan travels with the baseline.
+ *
+ * One definition for every reader: `/api/billing/addons` asks how many the
+ * org may buy on its plan, a plan change asks how many of what it bought the
+ * new plan can deliver, and a bundle link asks how many it may preselect.
+ */ export function addonMaxForBaseline(kind, baseline, plan) {
+    const bounded = (included, max)=>Number.isFinite(max) ? Math.max(0, max - included) : EXTRA_HOSTS_ADDON_MAX;
+    switch(kind){
+        case 'managers':
+            return bounded(baseline.managersPerOrg, baseline.maxManagersPerOrg);
+        case 'members':
+            return bounded(baseline.membersPerHost, baseline.maxMembersPerHost);
+        case 'datasets':
+            return bounded(baseline.datasetsPerOrg, baseline.maxDatasetsPerOrg);
+        case 'hosts':
+            return baseline.hostLimit === UNLIMITED ? 0 : EXTRA_HOSTS_ADDON_MAX;
+        case 'posRegisters':
+            return baseline.features.pos ? POS_REGISTERS_ADDON_MAX : 0;
+        case 'eventCalendar':
+            return 1;
+        case 'aiAddon':
+            // Org-wide like the Event Calendar: one purchase, of one tier, on any
+            // plan that sells tiers (AGL-3965) — not Free, not Enterprise.
+            return planSellsAiTiers(plan) ? 1 : 0;
+        case 'siteCare':
+            // Flat-priced, so the price map cannot say "not sold here" the way it
+            // does for Aglyn AI. This ceiling is the rule that keeps Free (no
+            // subscription) and Enterprise (quoted per deal) from buying it.
+            return planSellsSiteCare(plan) ? 1 : 0;
+    }
+}
+/** The ceiling a PLAN would impose on an add-on kind, purchases excluded. */ export function addonMaxForPlan(kind, plan) {
+    return addonMaxForBaseline(kind, resolveOrgEntitlements({
+        plan
+    }), plan);
+}
+/** Whether a plan sells an add-on at all: priced, with a ceiling above zero. */ export function planSellsAddon(kind, plan) {
+    return addonUnitUsd(kind, plan) != null && addonMaxForPlan(kind, plan) > 0;
+}
+/**
+ * What a link writes for each kind. `ai` and `extraHost` are the words the
+ * account owner chose (AGL-3955); the rest follow the same shape.
+ */ export const BUNDLE_ADDON_TOKENS = {
+    managers: 'extraSeat',
+    members: 'extraMember',
+    datasets: 'extraDataset',
+    hosts: 'extraHost',
+    posRegisters: 'posRegister',
+    eventCalendar: 'eventCalendar',
+    aiAddon: 'ai',
+    siteCare: 'siteCare'
+};
+/**
+ * Every spelling the parser accepts, lower-cased: the written token, the
+ * stored kind, and the plurals a person types.
+ */ const TOKEN_KINDS = (()=>{
+    const map = {};
+    const add = (kind, ...words)=>{
+        for (const word of [
+            kind,
+            BUNDLE_ADDON_TOKENS[kind],
+            ...words
+        ]){
+            map[word.toLowerCase()] = kind;
+        }
+    };
+    add('managers', 'extraSeats', 'seats', 'managerSeats');
+    add('members', 'extraMembers', 'collaborators', 'collaboratorSeats');
+    add('datasets', 'extraDatasets');
+    add('hosts', 'extraHosts', 'extraSite', 'extraSites', 'sites');
+    add('posRegisters', 'registers', 'register');
+    add('eventCalendar', 'events', 'calendar');
+    add('aiAddon', 'aglynAi');
+    add('siteCare', 'site-care', 'site_care', 'care');
+    return map;
+})();
+/** The most of a quantity kind a link may ask for, before the plan's ceiling. */ const MAX_LINK_QUANTITY = 999;
+/**
+ * THE `ai:<tier>` TOKENS (AGL-3965).
+ *
+ * Aglyn AI is a tier chosen on its own, on any paid plan: `ai:boost` adds
+ * Aglyn AI Boost. The words are the tier ids, lower-cased as every token is,
+ * and resolve through `parseAiTierAddonKey`, the one spelling of the
+ * `ai:<tier>` key. A bare `ai` (or `ai:1`) still means "add it" and sells
+ * the plan's default tier (`defaultAiTierForPlan`). An unknown tier is
+ * dropped with the notice like any other unknown add-on, never read as
+ * "add whichever tier": that would sell a tier nobody chose.
+ */ export const AI_ADDON_TIER_TOKENS = Object.freeze(Object.fromEntries(AI_TIER_IDS.map((tier)=>[
+        tier.toLowerCase(),
+        tier
+    ])));
+export function resolveAiAddonTier(tier) {
+    const word = tier.trim().toLowerCase();
+    if (!Object.prototype.hasOwnProperty.call(AI_ADDON_TIER_TOKENS, word)) return null;
+    const parsed = parseAiTierAddonKey(aiTierAddonKey(AI_ADDON_TIER_TOKENS[word]));
+    return parsed ? {
+        kind: 'aiAddon',
+        quantity: 1,
+        tier: parsed
+    } : null;
+}
+/** One token, `kind` or `kind:quantity`, or null when nothing understands it. */ function parseToken(raw) {
+    const token = raw.trim();
+    if (!token) return null;
+    const [name, ...rest] = token.split(':');
+    const kind = TOKEN_KINDS[name.trim().toLowerCase()];
+    if (!kind) return null;
+    const value = rest.join(':').trim();
+    if (!value) return {
+        kind,
+        quantity: 1
+    };
+    if (/^\d+$/.test(value)) {
+        const quantity = Math.min(MAX_LINK_QUANTITY, Number(value));
+        if (quantity < 1) return null;
+        return {
+            kind,
+            quantity: TOGGLE_ADDON_KIND_LIST.includes(kind) ? 1 : quantity
+        };
+    }
+    return kind === 'aiAddon' ? resolveAiAddonTier(value) : null;
+}
+/**
+ * Read the add-ons a link, a proposal or a request names.
+ *
+ * Accepts the link form (`"siteCare,ai,extraHost:2"`), a list of tokens, or a
+ * map of kind → quantity or flag (`{ siteCare: true, hosts: 2 }`, the shape
+ * the native staff screens post from their toggles). Never throws: anything
+ * it cannot read is reported in `dropped` and left out.
+ */ export function parseBundleAddons(input) {
+    const addons = {};
+    const dropped = [];
+    let aiTier;
+    const take = (parsed, raw)=>{
+        var _addons_parsed_kind;
+        if (!parsed) {
+            if (raw.trim()) dropped.push(raw.trim().slice(0, 40));
+            return;
+        }
+        addons[parsed.kind] = Math.max((_addons_parsed_kind = addons[parsed.kind]) != null ? _addons_parsed_kind : 0, parsed.quantity);
+        // The first tier named wins: one workspace holds one tier.
+        if (parsed.tier && !aiTier) aiTier = parsed.tier;
+    };
+    if (typeof input === 'string') {
+        for (const raw of input.split(/[,\s]+/))take(parseToken(raw), raw);
+    } else if (Array.isArray(input)) {
+        for (const raw of input){
+            if (typeof raw === 'string') take(parseToken(raw), raw);
+        }
+    } else if (input && typeof input === 'object') {
+        for (const [name, value] of Object.entries(input)){
+            const off = value === false || value === 0 || value === null || value === undefined || value === '' || value === 'false' || value === '0';
+            if (off) continue;
+            const quantity = value === true || value === 'true' ? '' : typeof value === 'number' || typeof value === 'string' ? String(value) : '';
+            take(parseToken(quantity ? `${name}:${quantity}` : name), name);
+        }
+    }
+    return _extends({
+        addons,
+        dropped
+    }, aiTier ? {
+        aiTier
+    } : {});
+}
+/**
+ * The add-ons a plan can actually carry: kinds it does not sell are dropped,
+ * quantities are held to its ceiling. What a link preselects on one plan is
+ * re-fitted when the owner picks another, so the checkout is never asked for
+ * something it would refuse.
+ */ export function fitBundleAddonsToPlan(addons, plan) {
+    const fitted = {};
+    const notSold = [];
+    for (const kind of ADDON_KINDS){
+        var _ref;
+        const wanted = Math.floor(Number((_ref = addons == null ? void 0 : addons[kind]) != null ? _ref : 0));
+        if (!(wanted > 0)) continue;
+        if (!planSellsAddon(kind, plan)) {
+            notSold.push(kind);
+            continue;
+        }
+        fitted[kind] = Math.min(wanted, addonMaxForPlan(kind, plan));
+    }
+    return {
+        addons: fitted,
+        notSold
+    };
+}
+/**
+ * The add-ons as the link writes them: `siteCare,ai:boost,extraHost:2`.
+ * Aglyn AI is written with its tier when one is named (AGL-3965), as bare
+ * `ai` otherwise.
+ */ export function bundleAddonsParam(addons, aiTier) {
+    return ADDON_KINDS.filter((kind)=>{
+        var _ref;
+        return ((_ref = addons == null ? void 0 : addons[kind]) != null ? _ref : 0) > 0;
+    }).map((kind)=>{
+        var _ref;
+        if (kind === 'aiAddon' && aiTier) return aiTierAddonKey(aiTier);
+        const quantity = (_ref = addons == null ? void 0 : addons[kind]) != null ? _ref : 0;
+        return quantity > 1 ? `${BUNDLE_ADDON_TOKENS[kind]}:${quantity}` : BUNDLE_ADDON_TOKENS[kind];
+    }).join(',');
+}
+/** Whether any add-on is asked for. */ export function hasBundleAddons(addons) {
+    return ADDON_KINDS.some((kind)=>{
+        var _ref;
+        return ((_ref = addons == null ? void 0 : addons[kind]) != null ? _ref : 0) > 0;
+    });
+}
+/**
+ * How each kind is named to a customer, singular. Aglyn AI carries its tier
+ * when one is named: "Aglyn AI Boost" (AGL-3965).
+ */ export function bundleAddonLabel(kind, brand, aiTier) {
+    switch(kind){
+        case 'managers':
+            return 'Extra manager seat';
+        case 'members':
+            return 'Extra collaborator seat';
+        case 'datasets':
+            return 'Extra dataset';
+        case 'hosts':
+            return 'Extra site';
+        case 'posRegisters':
+            return 'POS register';
+        case 'eventCalendar':
+            return 'Event Calendar';
+        case 'aiAddon':
+            return aiTier ? aiTierName(aiTier, brand) : aiAddonName(brand);
+        case 'siteCare':
+            return 'Site Care';
+    }
+}
+/** "Site Care", "2 × Extra site", "Aglyn AI Boost". */ export function describeBundleAddon(kind, quantity, brand, aiTier) {
+    const label = bundleAddonLabel(kind, brand, aiTier);
+    return quantity > 1 ? `${quantity} × ${label}` : label;
+}
+/** The longest coupon code a link carries. Stripe codes are far shorter. */ export const BUNDLE_COUPON_MAX = 64;
+/**
+ * A promotion code as a link carries it, or undefined. Only the characters
+ * Stripe allows in a customer-facing code; anything else is not a code
+ * somebody was handed, and is dropped rather than sent to Stripe.
+ *
+ * The code is only APPLIED here. Codes are minted on the staff Coupons page,
+ * which audits them; nothing on this path creates one.
+ */ export function normalizeBundleCoupon(raw) {
+    if (typeof raw !== 'string') return undefined;
+    const code = raw.trim();
+    if (!code || code.length > BUNDLE_COUPON_MAX) return undefined;
+    return /^[A-Za-z0-9_-]+$/.test(code) ? code : undefined;
+}
+/**
+ * A domain name as a bundle carries it — lower-cased, no scheme, no path —
+ * or undefined. Whether it is for sale and at what price is the registrar's
+ * answer, re-checked at purchase; this only refuses what cannot be a name.
+ */ export function normalizeBundleDomain(raw) {
+    if (typeof raw !== 'string') return undefined;
+    const name = raw.trim().toLowerCase().replace(/^https?:\/\//, '').replace(/\/.*$/, '').replace(/\.$/, '');
+    if (!name || name.length > 253) return undefined;
+    const labels = name.split('.');
+    if (labels.length < 2) return undefined;
+    const ok = labels.every((label)=>/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/.test(label));
+    return ok && /^[a-z]{2,63}$/.test(labels[labels.length - 1]) ? name : undefined;
+}
+/** "$15.99". */ export function formatBundleCents(cents) {
+    return `$${(Math.max(0, Math.round(cents)) / 100).toFixed(2)}`;
+}
+/**
+ * The domain line a bundle shows (AGL-3955): "example.com — $15.99 first
+ * year, renews yearly at $15.99". The price is the registrar's at the moment
+ * the link was minted; the purchase re-checks it.
+ */ export function bundleDomainLine(domain) {
+    return `${domain.name} — ${formatBundleCents(domain.firstYearCents)} first year, ` + `renews yearly at ${formatBundleCents(domain.renewalCents)}`;
+}
+/**
+ * The bundle in one line, for an email, a dialog or a snackbar:
+ * "Starter with Site Care and Aglyn AI, billed yearly, code BOOTH25".
+ */ export function describeBundle(bundle, options = {}) {
+    var _PLAN_LABELS_bundle_plan;
+    const parts = ADDON_KINDS.filter((kind)=>{
+        var _ref;
+        var _bundle_addons;
+        return ((_ref = (_bundle_addons = bundle.addons) == null ? void 0 : _bundle_addons[kind]) != null ? _ref : 0) > 0;
+    }).map((kind)=>{
+        var _ref;
+        var _bundle_addons;
+        return describeBundleAddon(kind, (_ref = (_bundle_addons = bundle.addons) == null ? void 0 : _bundle_addons[kind]) != null ? _ref : 0, options.brand, bundle.aiTier);
+    });
+    const addons = parts.length === 0 ? '' : parts.length === 1 ? ` with ${parts[0]}` : ` with ${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`;
+    const interval = bundle.interval === 'year' ? ', billed yearly' : bundle.interval === 'month' ? ', billed monthly' : '';
+    const coupon = bundle.coupon ? `, code ${bundle.coupon}` : '';
+    return `${(_PLAN_LABELS_bundle_plan = PLAN_LABELS[bundle.plan]) != null ? _PLAN_LABELS_bundle_plan : bundle.plan}${addons}${interval}${coupon}`;
+}
+
+//# sourceMappingURL=bundle-intent.js.map

package/src/lib/app-utils/bundle-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/bundle-intent.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * THE ADD-ONS A PLAN SELLS, AND THE BUNDLE A LINK ASKS FOR (AGL-3955).\n *\n * One list of add-on kinds and one parser for the add-ons a link, an upgrade\n * proposal or a staff dialog names, so the Billing card, the bundle checkout\n * link, the hand-off proposal (AGL-3956) and `/api/billing/checkout` agree on\n * what `addons=siteCare,ai,extraHost:2` means.\n *\n * The kinds are `OrgSeatAddons`' keys: what `resolvePurchasedAddons` counts,\n * what the webhook mirrors from Stripe, and what `/api/billing/addons` sells.\n * The prices and ceilings here are the ones `billing-addons.ts` (server)\n * re-exports, so a kind the link can preselect is always a kind the\n * checkout can price.\n *\n * A link is typed by a person and passed through hops nobody controls, so\n * the parser never throws and never guesses: an unknown token is dropped and\n * reported, so the page can say so in one line instead of failing.\n */\n\nimport type {\n  AiTierId,\n  OrgPlan,\n  OrgSeatAddons,\n} from '../foundation/definitions/org-billing.types'\nimport {\n  AI_TIER_IDS,\n  AI_TIERS,\n  aiAddonName,\n  aiTierAddonKey,\n  aiTierName,\n  defaultAiTierForPlan,\n  EVENT_CALENDAR_ADDON_MONTHLY_USD,\n  EXTRA_HOSTS_ADDON_MAX,\n  PLAN_LABELS,\n  parseAiTierAddonKey,\n  PLAN_PRICING,\n  planSellsAiTiers,\n  planSellsSiteCare,\n  POS_REGISTER_ADDON_MONTHLY_USD,\n  POS_REGISTERS_ADDON_MAX,\n  resolveOrgEntitlements,\n  SITE_CARE_ADDON_MONTHLY_USD,\n  UNLIMITED,\n} from './plan-entitlements'\n\n/** An add-on kind: a key of `org.seatAddons`. */\nexport type AddonKind = keyof Required<OrgSeatAddons>\n\n/**\n * Every add-on kind Billing sells, in the order the Billing card lists them.\n * `/api/billing/addons`, the webhook's price map and the native add-ons\n * screen all read this list.\n */\nexport const ADDON_KINDS: readonly AddonKind[] = [\n  'managers',\n  'members',\n  'datasets',\n  'hosts',\n  'posRegisters',\n  'eventCalendar',\n  'aiAddon',\n  'siteCare',\n]\n\n/** The org-wide 0/1 kinds: one purchase covers the workspace. */\nexport const TOGGLE_ADDON_KIND_LIST: readonly AddonKind[] = [\n  'eventCalendar',\n  'aiAddon',\n  'siteCare',\n]\n\nexport function isAddonKind(value: unknown): value is AddonKind {\n  return typeof value === 'string' && (ADDON_KINDS as readonly string[]).includes(value)\n}\n\n/**\n * Monthly USD per unit for an add-on on a plan (yearly prices are ×12 of\n * this); null when the plan doesn't sell the kind. Single pricing source\n * of truth: `PLAN_PRICING`, the three flat add-on constants and `AI_TIERS`\n * (`tier` as `addonPriceId` reads it; absent, the tier a plan-named purchase\n * means, `defaultAiTierForPlan`, AGL-3965).\n */\nexport function addonUnitUsd(\n  kind: AddonKind,\n  plan: OrgPlan,\n  tier?: AiTierId | null,\n): number | null {\n  const pricing = PLAN_PRICING[plan]\n  switch (kind) {\n    case 'managers':\n      return pricing.extraSeatMonthlyUsd\n    case 'members':\n      return pricing.extraCollaboratorMonthlyUsd\n    case 'datasets':\n      return pricing.extraDatasetMonthlyUsd\n    case 'hosts':\n      return pricing.extraHostMonthlyUsd\n    case 'posRegisters':\n      return POS_REGISTER_ADDON_MONTHLY_USD\n    case 'eventCalendar':\n      return EVENT_CALENDAR_ADDON_MONTHLY_USD\n    case 'aiAddon': {\n      const chosen = planSellsAiTiers(plan) ? (tier ?? defaultAiTierForPlan(plan)) : null\n      return chosen ? AI_TIERS[chosen].monthlyUsd : null\n    }\n    case 'siteCare':\n      return SITE_CARE_ADDON_MONTHLY_USD\n  }\n}\n\n/**\n * Max purchasable quantity per kind, from a purchases-free entitlement\n * resolution (plan defaults + staff overrides only) so the ceiling does not\n * drift as the org buys: seat/dataset kinds stop at the plan's hard max,\n * hosts/registers use flat ceilings, the Event Calendar, Aglyn AI and Site\n * Care are 0/1 toggles. POS registers additionally require the `pos`\n * feature, and Site Care a plan that sells it (`planSellsSiteCare`), which is\n * why the plan travels with the baseline.\n *\n * One definition for every reader: `/api/billing/addons` asks how many the\n * org may buy on its plan, a plan change asks how many of what it bought the\n * new plan can deliver, and a bundle link asks how many it may preselect.\n */\nexport function addonMaxForBaseline(\n  kind: AddonKind,\n  baseline: ReturnType<typeof resolveOrgEntitlements>,\n  plan: OrgPlan,\n): number {\n  const bounded = (included: number, max: number) =>\n    Number.isFinite(max) ? Math.max(0, max - included) : EXTRA_HOSTS_ADDON_MAX\n  switch (kind) {\n    case 'managers':\n      return bounded(baseline.managersPerOrg, baseline.maxManagersPerOrg)\n    case 'members':\n      return bounded(baseline.membersPerHost, baseline.maxMembersPerHost)\n    case 'datasets':\n      return bounded(baseline.datasetsPerOrg, baseline.maxDatasetsPerOrg)\n    case 'hosts':\n      return baseline.hostLimit === UNLIMITED ? 0 : EXTRA_HOSTS_ADDON_MAX\n    case 'posRegisters':\n      return baseline.features.pos ? POS_REGISTERS_ADDON_MAX : 0\n    case 'eventCalendar':\n      return 1\n    case 'aiAddon':\n      // Org-wide like the Event Calendar: one purchase, of one tier, on any\n      // plan that sells tiers (AGL-3965) — not Free, not Enterprise.\n      return planSellsAiTiers(plan) ? 1 : 0\n    case 'siteCare':\n      // Flat-priced, so the price map cannot say \"not sold here\" the way it\n      // does for Aglyn AI. This ceiling is the rule that keeps Free (no\n      // subscription) and Enterprise (quoted per deal) from buying it.\n      return planSellsSiteCare(plan) ? 1 : 0\n  }\n}\n\n/** The ceiling a PLAN would impose on an add-on kind, purchases excluded. */\nexport function addonMaxForPlan(kind: AddonKind, plan: OrgPlan): number {\n  return addonMaxForBaseline(\n    kind,\n    resolveOrgEntitlements({ plan } as never),\n    plan,\n  )\n}\n\n/** Whether a plan sells an add-on at all: priced, with a ceiling above zero. */\nexport function planSellsAddon(kind: AddonKind, plan: OrgPlan): boolean {\n  return addonUnitUsd(kind, plan) != null && addonMaxForPlan(kind, plan) > 0\n}\n\n/** Quantities by kind, absent kinds meaning none. */\nexport type BundleAddons = Partial<Record<AddonKind, number>>\n\n/**\n * What a link writes for each kind. `ai` and `extraHost` are the words the\n * account owner chose (AGL-3955); the rest follow the same shape.\n */\nexport const BUNDLE_ADDON_TOKENS: Record<AddonKind, string> = {\n  managers: 'extraSeat',\n  members: 'extraMember',\n  datasets: 'extraDataset',\n  hosts: 'extraHost',\n  posRegisters: 'posRegister',\n  eventCalendar: 'eventCalendar',\n  aiAddon: 'ai',\n  siteCare: 'siteCare',\n}\n\n/**\n * Every spelling the parser accepts, lower-cased: the written token, the\n * stored kind, and the plurals a person types.\n */\nconst TOKEN_KINDS: Record<string, AddonKind> = (() => {\n  const map: Record<string, AddonKind> = {}\n  const add = (kind: AddonKind, ...words: string[]) => {\n    for (const word of [kind, BUNDLE_ADDON_TOKENS[kind], ...words]) {\n      map[word.toLowerCase()] = kind\n    }\n  }\n  add('managers', 'extraSeats', 'seats', 'managerSeats')\n  add('members', 'extraMembers', 'collaborators', 'collaboratorSeats')\n  add('datasets', 'extraDatasets')\n  add('hosts', 'extraHosts', 'extraSite', 'extraSites', 'sites')\n  add('posRegisters', 'registers', 'register')\n  add('eventCalendar', 'events', 'calendar')\n  add('aiAddon', 'aglynAi')\n  add('siteCare', 'site-care', 'site_care', 'care')\n  return map\n})()\n\n/** The most of a quantity kind a link may ask for, before the plan's ceiling. */\nconst MAX_LINK_QUANTITY = 999\n\n/** One add-on a token names, with the Aglyn AI tier when it names one. */\ninterface ParsedToken {\n  kind: AddonKind\n  quantity: number\n  tier?: AiTierId\n}\n\n/**\n * THE `ai:<tier>` TOKENS (AGL-3965).\n *\n * Aglyn AI is a tier chosen on its own, on any paid plan: `ai:boost` adds\n * Aglyn AI Boost. The words are the tier ids, lower-cased as every token is,\n * and resolve through `parseAiTierAddonKey`, the one spelling of the\n * `ai:<tier>` key. A bare `ai` (or `ai:1`) still means \"add it\" and sells\n * the plan's default tier (`defaultAiTierForPlan`). An unknown tier is\n * dropped with the notice like any other unknown add-on, never read as\n * \"add whichever tier\": that would sell a tier nobody chose.\n */\nexport const AI_ADDON_TIER_TOKENS: Readonly<Record<string, AiTierId>> = Object.freeze(\n  Object.fromEntries(AI_TIER_IDS.map((tier) => [tier.toLowerCase(), tier])),\n)\n\nexport function resolveAiAddonTier(tier: string): ParsedToken | null {\n  const word = tier.trim().toLowerCase()\n  if (!Object.prototype.hasOwnProperty.call(AI_ADDON_TIER_TOKENS, word)) return null\n  const parsed = parseAiTierAddonKey(aiTierAddonKey(AI_ADDON_TIER_TOKENS[word]))\n  return parsed ? { kind: 'aiAddon', quantity: 1, tier: parsed } : null\n}\n\nexport interface ParsedBundleAddons {\n  addons: BundleAddons\n  /** The tokens nothing understood, as they were written. */\n  dropped: string[]\n  /** The Aglyn AI tier an `ai:<tier>` token named (AGL-3965), if any. */\n  aiTier?: AiTierId\n}\n\n/** One token, `kind` or `kind:quantity`, or null when nothing understands it. */\nfunction parseToken(raw: string): ParsedToken | null {\n  const token = raw.trim()\n  if (!token) return null\n  const [name, ...rest] = token.split(':')\n  const kind = TOKEN_KINDS[name.trim().toLowerCase()]\n  if (!kind) return null\n  const value = rest.join(':').trim()\n  if (!value) return { kind, quantity: 1 }\n  if (/^\\d+$/.test(value)) {\n    const quantity = Math.min(MAX_LINK_QUANTITY, Number(value))\n    if (quantity < 1) return null\n    return {\n      kind,\n      quantity: (TOGGLE_ADDON_KIND_LIST as readonly string[]).includes(kind) ? 1 : quantity,\n    }\n  }\n  return kind === 'aiAddon' ? resolveAiAddonTier(value) : null\n}\n\n/**\n * Read the add-ons a link, a proposal or a request names.\n *\n * Accepts the link form (`\"siteCare,ai,extraHost:2\"`), a list of tokens, or a\n * map of kind → quantity or flag (`{ siteCare: true, hosts: 2 }`, the shape\n * the native staff screens post from their toggles). Never throws: anything\n * it cannot read is reported in `dropped` and left out.\n */\nexport function parseBundleAddons(input: unknown): ParsedBundleAddons {\n  const addons: BundleAddons = {}\n  const dropped: string[] = []\n  let aiTier: AiTierId | undefined\n  const take = (parsed: ParsedToken | null, raw: string) => {\n    if (!parsed) {\n      if (raw.trim()) dropped.push(raw.trim().slice(0, 40))\n      return\n    }\n    addons[parsed.kind] = Math.max(addons[parsed.kind] ?? 0, parsed.quantity)\n    // The first tier named wins: one workspace holds one tier.\n    if (parsed.tier && !aiTier) aiTier = parsed.tier\n  }\n  if (typeof input === 'string') {\n    for (const raw of input.split(/[,\\s]+/)) take(parseToken(raw), raw)\n  } else if (Array.isArray(input)) {\n    for (const raw of input) {\n      if (typeof raw === 'string') take(parseToken(raw), raw)\n    }\n  } else if (input && typeof input === 'object') {\n    for (const [name, value] of Object.entries(input as Record<string, unknown>)) {\n      const off =\n        value === false ||\n        value === 0 ||\n        value === null ||\n        value === undefined ||\n        value === '' ||\n        value === 'false' ||\n        value === '0'\n      if (off) continue\n      const quantity =\n        value === true || value === 'true'\n          ? ''\n          : typeof value === 'number' || typeof value === 'string'\n            ? String(value)\n            : ''\n      take(parseToken(quantity ? `${name}:${quantity}` : name), name)\n    }\n  }\n  return { addons, dropped, ...(aiTier ? { aiTier } : {}) }\n}\n\nexport interface FittedBundleAddons {\n  addons: BundleAddons\n  /** Kinds the plan does not sell, dropped. */\n  notSold: AddonKind[]\n}\n\n/**\n * The add-ons a plan can actually carry: kinds it does not sell are dropped,\n * quantities are held to its ceiling. What a link preselects on one plan is\n * re-fitted when the owner picks another, so the checkout is never asked for\n * something it would refuse.\n */\nexport function fitBundleAddonsToPlan(\n  addons: BundleAddons | null | undefined,\n  plan: OrgPlan,\n): FittedBundleAddons {\n  const fitted: BundleAddons = {}\n  const notSold: AddonKind[] = []\n  for (const kind of ADDON_KINDS) {\n    const wanted = Math.floor(Number(addons?.[kind] ?? 0))\n    if (!(wanted > 0)) continue\n    if (!planSellsAddon(kind, plan)) {\n      notSold.push(kind)\n      continue\n    }\n    fitted[kind] = Math.min(wanted, addonMaxForPlan(kind, plan))\n  }\n  return { addons: fitted, notSold }\n}\n\n/**\n * The add-ons as the link writes them: `siteCare,ai:boost,extraHost:2`.\n * Aglyn AI is written with its tier when one is named (AGL-3965), as bare\n * `ai` otherwise.\n */\nexport function bundleAddonsParam(\n  addons: BundleAddons | null | undefined,\n  aiTier?: AiTierId | null,\n): string {\n  return ADDON_KINDS.filter((kind) => (addons?.[kind] ?? 0) > 0)\n    .map((kind) => {\n      if (kind === 'aiAddon' && aiTier) return aiTierAddonKey(aiTier)\n      const quantity = addons?.[kind] ?? 0\n      return quantity > 1 ? `${BUNDLE_ADDON_TOKENS[kind]}:${quantity}` : BUNDLE_ADDON_TOKENS[kind]\n    })\n    .join(',')\n}\n\n/** Whether any add-on is asked for. */\nexport function hasBundleAddons(addons: BundleAddons | null | undefined): boolean {\n  return ADDON_KINDS.some((kind) => (addons?.[kind] ?? 0) > 0)\n}\n\n/**\n * How each kind is named to a customer, singular. Aglyn AI carries its tier\n * when one is named: \"Aglyn AI Boost\" (AGL-3965).\n */\nexport function bundleAddonLabel(\n  kind: AddonKind,\n  brand?: string,\n  aiTier?: AiTierId | null,\n): string {\n  switch (kind) {\n    case 'managers':\n      return 'Extra manager seat'\n    case 'members':\n      return 'Extra collaborator seat'\n    case 'datasets':\n      return 'Extra dataset'\n    case 'hosts':\n      return 'Extra site'\n    case 'posRegisters':\n      return 'POS register'\n    case 'eventCalendar':\n      return 'Event Calendar'\n    case 'aiAddon':\n      return aiTier ? aiTierName(aiTier, brand) : aiAddonName(brand)\n    case 'siteCare':\n      return 'Site Care'\n  }\n}\n\n/** \"Site Care\", \"2 × Extra site\", \"Aglyn AI Boost\". */\nexport function describeBundleAddon(\n  kind: AddonKind,\n  quantity: number,\n  brand?: string,\n  aiTier?: AiTierId | null,\n): string {\n  const label = bundleAddonLabel(kind, brand, aiTier)\n  return quantity > 1 ? `${quantity} × ${label}` : label\n}\n\n/** The longest coupon code a link carries. Stripe codes are far shorter. */\nexport const BUNDLE_COUPON_MAX = 64\n\n/**\n * A promotion code as a link carries it, or undefined. Only the characters\n * Stripe allows in a customer-facing code; anything else is not a code\n * somebody was handed, and is dropped rather than sent to Stripe.\n *\n * The code is only APPLIED here. Codes are minted on the staff Coupons page,\n * which audits them; nothing on this path creates one.\n */\nexport function normalizeBundleCoupon(raw: unknown): string | undefined {\n  if (typeof raw !== 'string') return undefined\n  const code = raw.trim()\n  if (!code || code.length > BUNDLE_COUPON_MAX) return undefined\n  return /^[A-Za-z0-9_-]+$/.test(code) ? code : undefined\n}\n\n/**\n * A domain name as a bundle carries it — lower-cased, no scheme, no path —\n * or undefined. Whether it is for sale and at what price is the registrar's\n * answer, re-checked at purchase; this only refuses what cannot be a name.\n */\nexport function normalizeBundleDomain(raw: unknown): string | undefined {\n  if (typeof raw !== 'string') return undefined\n  const name = raw\n    .trim()\n    .toLowerCase()\n    .replace(/^https?:\\/\\//, '')\n    .replace(/\\/.*$/, '')\n    .replace(/\\.$/, '')\n  if (!name || name.length > 253) return undefined\n  const labels = name.split('.')\n  if (labels.length < 2) return undefined\n  const ok = labels.every((label) => /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/.test(label))\n  return ok && /^[a-z]{2,63}$/.test(labels[labels.length - 1]) ? name : undefined\n}\n\n/** \"$15.99\". */\nexport function formatBundleCents(cents: number): string {\n  return `$${(Math.max(0, Math.round(cents)) / 100).toFixed(2)}`\n}\n\n/**\n * The domain line a bundle shows (AGL-3955): \"example.com — $15.99 first\n * year, renews yearly at $15.99\". The price is the registrar's at the moment\n * the link was minted; the purchase re-checks it.\n */\nexport function bundleDomainLine(domain: {\n  name: string\n  firstYearCents: number\n  renewalCents: number\n}): string {\n  return (\n    `${domain.name} — ${formatBundleCents(domain.firstYearCents)} first year, ` +\n    `renews yearly at ${formatBundleCents(domain.renewalCents)}`\n  )\n}\n\n/**\n * The bundle in one line, for an email, a dialog or a snackbar:\n * \"Starter with Site Care and Aglyn AI, billed yearly, code BOOTH25\".\n */\nexport function describeBundle(\n  bundle: {\n    plan: OrgPlan\n    addons?: BundleAddons | null\n    interval?: 'month' | 'year' | null\n    coupon?: string | null\n    /** The Aglyn AI tier, named with the AI add-on (AGL-3965). */\n    aiTier?: AiTierId | null\n  },\n  options: { brand?: string } = {},\n): string {\n  const parts = ADDON_KINDS.filter((kind) => (bundle.addons?.[kind] ?? 0) > 0).map((kind) =>\n    describeBundleAddon(kind, bundle.addons?.[kind] ?? 0, options.brand, bundle.aiTier),\n  )\n  const addons =\n    parts.length === 0\n      ? ''\n      : parts.length === 1\n        ? ` with ${parts[0]}`\n        : ` with ${parts.slice(0, -1).join(', ')} and ${parts[parts.length - 1]}`\n  const interval =\n    bundle.interval === 'year'\n      ? ', billed yearly'\n      : bundle.interval === 'month'\n        ? ', billed monthly'\n        : ''\n  const coupon = bundle.coupon ? `, code ${bundle.coupon}` : ''\n  return `${PLAN_LABELS[bundle.plan] ?? bundle.plan}${addons}${interval}${coupon}`\n}\n"],"names":["AI_TIER_IDS","AI_TIERS","aiAddonName","aiTierAddonKey","aiTierName","defaultAiTierForPlan","EVENT_CALENDAR_ADDON_MONTHLY_USD","EXTRA_HOSTS_ADDON_MAX","PLAN_LABELS","parseAiTierAddonKey","PLAN_PRICING","planSellsAiTiers","planSellsSiteCare","POS_REGISTER_ADDON_MONTHLY_USD","POS_REGISTERS_ADDON_MAX","resolveOrgEntitlements","SITE_CARE_ADDON_MONTHLY_USD","UNLIMITED","ADDON_KINDS","TOGGLE_ADDON_KIND_LIST","isAddonKind","value","includes","addonUnitUsd","kind","plan","tier","pricing","extraSeatMonthlyUsd","extraCollaboratorMonthlyUsd","extraDatasetMonthlyUsd","extraHostMonthlyUsd","chosen","monthlyUsd","addonMaxForBaseline","baseline","bounded","included","max","Number","isFinite","Math","managersPerOrg","maxManagersPerOrg","membersPerHost","maxMembersPerHost","datasetsPerOrg","maxDatasetsPerOrg","hostLimit","features","pos","addonMaxForPlan","planSellsAddon","BUNDLE_ADDON_TOKENS","managers","members","datasets","hosts","posRegisters","eventCalendar","aiAddon","siteCare","TOKEN_KINDS","map","add","words","word","toLowerCase","MAX_LINK_QUANTITY","AI_ADDON_TIER_TOKENS","Object","freeze","fromEntries","resolveAiAddonTier","trim","prototype","hasOwnProperty","call","parsed","quantity","parseToken","raw","token","name","rest","split","join","test","min","parseBundleAddons","input","addons","dropped","aiTier","take","push","slice","Array","isArray","entries","off","undefined","String","fitBundleAddonsToPlan","fitted","notSold","wanted","floor","bundleAddonsParam","filter","hasBundleAddons","some","bundleAddonLabel","brand","describeBundleAddon","label","BUNDLE_COUPON_MAX","normalizeBundleCoupon","code","length","normalizeBundleDomain","replace","labels","ok","every","formatBundleCents","cents","round","toFixed","bundleDomainLine","domain","firstYearCents","renewalCents","describeBundle","bundle","options","parts","interval","coupon"],"mappings":"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"}