@arnaudjnn/billing-tools 15.23.0 → 16.0.0

package/dist/ladder.d.ts

@@ -0,0 +1,145 @@
+import { type PlanCatalog, type PlanModel } from "./plan-model.js";
+/**
+ * The seat types a member can BE on, cheapest first.
+ *
+ * `shared` types are excluded: they are the pool an API caller or a guest draws from, not a
+ * rung a person climbs, and including them made "the next seat up" point at something no
+ * human can be assigned.
+ *
+ * This ordering — non-shared, by monthly price — is the definition of "better seat" used by
+ * every function below. It is exported because a UI that renders the ladder has to sort it
+ * the same way, and the only alternative to publishing the rule is each caller guessing it.
+ */
+export declare function seatLadder(model: PlanModel): PlanModel["seatTypes"];
+/**
+ * The seat a member holds when nobody has assigned them one: the cheapest non-shared type.
+ *
+ * An UNASSIGNED member is not on "no seat" — they draw the plan's entry-level pack, which is
+ * what the meter measures them against and what their badge says. Treating absent as zero
+ * made the ladder offer a Standard member the Standard seat they were already effectively on,
+ * which is how this was caught: the button read "Assegna Posto Standard".
+ */
+export declare function defaultSeatOf(model: PlanModel): string | null;
+/** What a seat costs per month — the ordering "a better seat" means. An absent assignment
+ *  resolves to the default seat, not to nothing. */
+export declare function seatRank(model: PlanModel, seatType: string | null): number;
+/** The next seat type up, or null when they are already on the best one. */
+export declare function nextSeatUp(model: PlanModel, seatType: string | null): string | null;
+/**
+ * Is this the best seat the plan sells?
+ *
+ * `nextSeatUp(...) === null` already answered it, but only to a reader who knows that is what
+ * null means there. A screen deciding whether to offer an upgrade, and an agent asking the
+ * same question over the API, should not both have to know.
+ */
+export declare function isTopSeat(model: PlanModel, seatType: string | null): boolean;
+/**
+ * Does THIS plan sell that seat type?
+ *
+ * Against the org's own model, which is the check that was missing: the `assign_seat_type`
+ * tool validated against the union of seat keys across every plan in the catalogue, so a
+ * Premium key was "valid" for a workspace on a plan that does not sell it, and the write
+ * went through to a seat the meter then could not price.
+ *
+ * `shared` types count — an API caller genuinely holds one — so this is a wider question
+ * than `seatLadder`.
+ */
+export declare function seatTypeExists(model: PlanModel, seatType: string): boolean;
+/** What a plan costs a month at its default basket — the ordering "a better plan" means.
+ *  A quote-only plan ranks above everything priced, because nothing self-serve exceeds it. */
+export declare function planRank(model: PlanModel): number;
+export interface PlanActions {
+    /** The next plan up, or null when already at the top. */
+    upgradeTo: string | null;
+    /** The next plan down, or null when already at the bottom. */
+    downgradeTo: string | null;
+    /** Whether there is a paid subscription to end. False on a free plan — there
+     *  is nothing to cancel, so the action shouldn't be offered. */
+    canCancel: boolean;
+    /** The plan a cancellation lands on. */
+    cancelTo: string | null;
+}
+/**
+ * Which of upgrade / downgrade / cancel apply to an org on `currentPlan`.
+ *
+ * Pure, so a UI can hide what doesn't apply instead of offering an action that
+ * will be refused: no "upgrade" on the top plan, no "cancel" on a free one.
+ */
+export declare function planActions(plans: PlanCatalog, currentPlan: string | null): PlanActions;
+export interface PlanRequest {
+    id: string;
+    /** WorkOS user id of whoever asked. */
+    memberId: string;
+    /**
+     * WHAT they are asking to move: the workspace's plan, or their own seat.
+     *
+     * They are different asks with different prices and different approvers' reasoning — a
+     * seat upgrade costs one seat's difference and affects one person, a plan change moves
+     * everybody — but they queue in the same place, because to an owner they are one list of
+     * people waiting.
+     *
+     * Absent means "plan": the field was added after the queue existed, and a stored record
+     * without it is a plan request.
+     */
+    kind?: "plan" | "seat";
+    /** The target — a plan key, or a seat-type key when `kind` is "seat". */
+    plan: string;
+    status: "pending" | "done" | "denied";
+    createdAt: string;
+    /** Why they are asking, in their words. Optional, capped at 140 chars by the caller. */
+    note?: string;
+}
+/** Has the workspace already reached (or passed) what this request asked for? */
+export declare function isSatisfied(request: PlanRequest, plans: PlanCatalog, currentPlan: string | null, 
+/** The asker's seat type now — needed only for a seat request. */
+currentSeatType?: string | null): boolean;
+/**
+ * WHICH ask to offer someone who is out of usage. One decision, in one place.
+ *
+ * The ladder climbs the cheapest, most targeted rung first, and each rung exists because the
+ * one below it cannot help:
+ *
+ *   1. a better SEAT — their pack is what their seat includes, so the way to have more of it
+ *      is a bigger seat. A Standard member should be offered this, never a top-up: topping
+ *      up buys them a few days and leaves them in the same place next week.
+ *   2. CREDITS, where money can actually lift the wall: a `covers: "included"` window paces
+ *      only what the plan gives away, and a pack whose plan overflows to the wallet is the
+ *      same statement. Paying works, permanently and without anybody's permission, so
+ *      asking an owner for a free exception would be the worse of two available answers.
+ *   3. extra USAGE on the blocked window — the answer where money CANNOT help: a
+ *      `covers: "all"` window is the product's own pace and no purchase touches it, so an
+ *      exception somebody grants is the only door.
+ *   4. a PLAN change — for a plan with no per-member allowance at all. A pooled plan's
+ *      windows belong to the workspace, so there is nothing personal to raise and
+ *      `grant_top_up` refuses it outright.
+ *
+ * Rungs 2 and 3 were ONE rung, and it was wrong in whichever direction the deployment went.
+ * A plan whose card says pay-as-you-go sent a blocked member to ask an owner for something
+ * they could have bought in a click; a plan pacing the product offered credits that lift
+ * nothing, taking money for a wall that would still be there. Which of the two applies is
+ * not a preference — it is what `covers` says, so it is read rather than configured again.
+ *
+ * Returns null when nothing is blocked, which is when nothing should be offered — a control
+ * permanently on screen asks a question nobody at 40% can answer.
+ */
+export declare function nextUsageAsk(model: PlanModel | null, input: {
+    /** From `topUpTargetOf` — what, if anything, is refusing them, and whether paying lifts it. */
+    blocked: {
+        kind: "rate" | "pack";
+        covers?: "all" | "included";
+    } | null;
+    seatType?: string | null;
+    plans: PlanCatalog;
+    currentPlan?: string | null;
+}): {
+    ask: "seat";
+    to: string;
+} | {
+    ask: "credits";
+} | {
+    ask: "usage";
+} | {
+    ask: "plan";
+    to: string;
+} | null;
+//# sourceMappingURL=ladder.d.ts.map

package/dist/ladder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ladder.d.ts","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"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"}

package/dist/ladder.js

@@ -0,0 +1,196 @@
+import { defaultBasket, exhaustedPolicy, normalizePlans, planModel, } from "./plan-model.js";
+// The RUNGS: what "a better seat" and "a better plan" mean, and which one to offer a
+// member who is blocked.
+//
+// ── Why this is its own module ──────────────────────────────────────────────
+//
+// All of it is arithmetic over the catalogue — a plain object in, a key out, no adapter,
+// no Stripe, no WorkOS. It used to live half in `subscription.ts` (which imports Stripe to
+// move a subscription) and half in `plan-request.ts` (which needs an adapter to queue an
+// ask), so a pricing page, a seat picker or a config file could not reach a single rung
+// without loading the engine. Neither module could put it on the `/plans` leaf, and the
+// leaf is asserted pure — so the ordering rule got re-implemented in consumer UIs instead,
+// once per screen, which is how a seat picker and the meter can disagree about which seat
+// somebody is on.
+//
+// Both former homes re-export from here, so nothing internal moved.
+// ── Seats ───────────────────────────────────────────────────────────────────
+/**
+ * The seat types a member can BE on, cheapest first.
+ *
+ * `shared` types are excluded: they are the pool an API caller or a guest draws from, not a
+ * rung a person climbs, and including them made "the next seat up" point at something no
+ * human can be assigned.
+ *
+ * This ordering — non-shared, by monthly price — is the definition of "better seat" used by
+ * every function below. It is exported because a UI that renders the ladder has to sort it
+ * the same way, and the only alternative to publishing the rule is each caller guessing it.
+ */
+export function seatLadder(model) {
+    return [...model.seatTypes]
+        .filter((s) => !s.shared)
+        .sort((a, b) => a.price.monthly - b.price.monthly);
+}
+/**
+ * The seat a member holds when nobody has assigned them one: the cheapest non-shared type.
+ *
+ * An UNASSIGNED member is not on "no seat" — they draw the plan's entry-level pack, which is
+ * what the meter measures them against and what their badge says. Treating absent as zero
+ * made the ladder offer a Standard member the Standard seat they were already effectively on,
+ * which is how this was caught: the button read "Assegna Posto Standard".
+ */
+export function defaultSeatOf(model) {
+    return seatLadder(model)[0]?.key ?? null;
+}
+/** What a seat costs per month — the ordering "a better seat" means. An absent assignment
+ *  resolves to the default seat, not to nothing. */
+export function seatRank(model, seatType) {
+    const key = seatType ?? defaultSeatOf(model);
+    if (!key)
+        return 0;
+    return model.seatTypes.find((s) => s.key === key)?.price.monthly ?? 0;
+}
+/** The next seat type up, or null when they are already on the best one. */
+export function nextSeatUp(model, seatType) {
+    const above = seatLadder(model).filter((s) => s.price.monthly > seatRank(model, seatType));
+    return above[0]?.key ?? null;
+}
+/**
+ * Is this the best seat the plan sells?
+ *
+ * `nextSeatUp(...) === null` already answered it, but only to a reader who knows that is what
+ * null means there. A screen deciding whether to offer an upgrade, and an agent asking the
+ * same question over the API, should not both have to know.
+ */
+export function isTopSeat(model, seatType) {
+    return seatLadder(model).length > 0 && nextSeatUp(model, seatType) === null;
+}
+/**
+ * Does THIS plan sell that seat type?
+ *
+ * Against the org's own model, which is the check that was missing: the `assign_seat_type`
+ * tool validated against the union of seat keys across every plan in the catalogue, so a
+ * Premium key was "valid" for a workspace on a plan that does not sell it, and the write
+ * went through to a seat the meter then could not price.
+ *
+ * `shared` types count — an API caller genuinely holds one — so this is a wider question
+ * than `seatLadder`.
+ */
+export function seatTypeExists(model, seatType) {
+    return model.seatTypes.some((s) => s.key === seatType);
+}
+// ── Plans ───────────────────────────────────────────────────────────────────
+/** What a plan costs a month at its default basket — the ordering "a better plan" means.
+ *  A quote-only plan ranks above everything priced, because nothing self-serve exceeds it. */
+export function planRank(model) {
+    if (model.sale === "quote")
+        return Number.MAX_SAFE_INTEGER;
+    const basket = defaultBasket(model);
+    if (model.sells.kind === "flat")
+        return model.sells.price.monthly;
+    return model.seatTypes.reduce((sum, s) => sum + (basket[s.key] ?? 0) * s.price.monthly, 0);
+}
+/**
+ * Which of upgrade / downgrade / cancel apply to an org on `currentPlan`.
+ *
+ * Pure, so a UI can hide what doesn't apply instead of offering an action that
+ * will be refused: no "upgrade" on the top plan, no "cancel" on a free one.
+ */
+export function planActions(plans, currentPlan) {
+    const models = normalizePlans(plans)
+        .filter((m) => m.sale !== "legacy" && !m.display?.hidden)
+        .sort((a, b) => planRank(a) - planRank(b));
+    const free = models.find((m) => m.sale === "free") ?? null;
+    const current = currentPlan ? models.find((m) => m.key === currentPlan) : null;
+    // No recorded plan behaves as the free tier: nothing is being billed.
+    const rank = current ? planRank(current) : (free ? planRank(free) : 0);
+    const above = models.filter((m) => planRank(m) > rank);
+    const below = models.filter((m) => planRank(m) < rank);
+    const isPaid = current ? current.sells.kind !== "nothing" && current.sale !== "free" : false;
+    return {
+        upgradeTo: above[0]?.key ?? null,
+        downgradeTo: below[below.length - 1]?.key ?? null,
+        canCancel: isPaid,
+        cancelTo: free?.key ?? null,
+    };
+}
+/** Has the workspace already reached (or passed) what this request asked for? */
+export function isSatisfied(request, plans, currentPlan, 
+/** The asker's seat type now — needed only for a seat request. */
+currentSeatType) {
+    if (request.kind === "seat") {
+        const model = currentPlan ? planModel(plans, currentPlan) : null;
+        if (!model)
+            return false;
+        return seatRank(model, currentSeatType ?? null) >= seatRank(model, request.plan);
+    }
+    const want = planModel(plans, request.plan);
+    const have = currentPlan ? planModel(plans, currentPlan) : null;
+    if (!want || !have)
+        return false;
+    return planRank(have) >= planRank(want);
+}
+/**
+ * WHICH ask to offer someone who is out of usage. One decision, in one place.
+ *
+ * The ladder climbs the cheapest, most targeted rung first, and each rung exists because the
+ * one below it cannot help:
+ *
+ *   1. a better SEAT — their pack is what their seat includes, so the way to have more of it
+ *      is a bigger seat. A Standard member should be offered this, never a top-up: topping
+ *      up buys them a few days and leaves them in the same place next week.
+ *   2. CREDITS, where money can actually lift the wall: a `covers: "included"` window paces
+ *      only what the plan gives away, and a pack whose plan overflows to the wallet is the
+ *      same statement. Paying works, permanently and without anybody's permission, so
+ *      asking an owner for a free exception would be the worse of two available answers.
+ *   3. extra USAGE on the blocked window — the answer where money CANNOT help: a
+ *      `covers: "all"` window is the product's own pace and no purchase touches it, so an
+ *      exception somebody grants is the only door.
+ *   4. a PLAN change — for a plan with no per-member allowance at all. A pooled plan's
+ *      windows belong to the workspace, so there is nothing personal to raise and
+ *      `grant_top_up` refuses it outright.
+ *
+ * Rungs 2 and 3 were ONE rung, and it was wrong in whichever direction the deployment went.
+ * A plan whose card says pay-as-you-go sent a blocked member to ask an owner for something
+ * they could have bought in a click; a plan pacing the product offered credits that lift
+ * nothing, taking money for a wall that would still be there. Which of the two applies is
+ * not a preference — it is what `covers` says, so it is read rather than configured again.
+ *
+ * Returns null when nothing is blocked, which is when nothing should be offered — a control
+ * permanently on screen asks a question nobody at 40% can answer.
+ */
+export function nextUsageAsk(model, input) {
+    if (!input.blocked)
+        return null;
+    // Can the customer pay their own way past this? Two conditions, and both are necessary:
+    // the plan has to SELL credits, and the wall has to be one credits reach. A pack is
+    // reachable when the plan overflows to the wallet; a rate window only when it covers the
+    // included allowance alone.
+    const sellsCredits = Boolean(model?.replenish?.purchase || model?.replenish?.autoReload);
+    const payable = sellsCredits &&
+        (input.blocked.kind === "pack"
+            // Through `exhaustedPolicy`, not `cap.onExhausted`: an agent and a shared seat always
+            // overflow to the wallet whatever the cap declares, and a `cap: wallet` plan has no
+            // `onExhausted` field at all.
+            ? exhaustedPolicy(model, { seatType: input.seatType ?? undefined }) === "wallet"
+            : input.blocked.covers === "included");
+    if (model?.sells.kind === "seats") {
+        const better = nextSeatUp(model, input.seatType ?? null);
+        // The seat still comes first, even when credits would work: it raises the pack AND the
+        // pace every cycle, where credits are this week's answer bought again next week.
+        if (better)
+            return { ask: "seat", to: better };
+        // On the best seat: buy more if that is possible, otherwise ask for an exception.
+        return payable ? { ask: "credits" } : { ask: "usage" };
+    }
+    // A pooled plan has nothing personal to raise — but if it sells credits and the pool
+    // overflows to the wallet, paying is still a real answer and a better one than asking
+    // the workspace to change plan.
+    if (payable)
+        return { ask: "credits" };
+    // No seats, so nothing per-member to raise. The only route is the workspace buying more
+    // product — and if there is nothing above them, there is nothing to offer at all.
+    const up = planActions(input.plans, input.currentPlan ?? null).upgradeTo;
+    return up ? { ask: "plan", to: up } : null;
+}
+//# sourceMappingURL=ladder.js.map

package/dist/ladder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ladder.js","sourceRoot":"","sources":["../src/ladder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,SAAS,GAGV,MAAM,iBAAiB,CAAC;AAEzB,qFAAqF;AACrF,yBAAyB;AACzB,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,yFAAyF;AACzF,2FAA2F;AAC3F,yFAAyF;AACzF,wFAAwF;AACxF,wFAAwF;AACxF,2FAA2F;AAC3F,0FAA0F;AAC1F,kBAAkB;AAClB,EAAE;AACF,oEAAoE;AAEpE,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,OAAO,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;SACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;AAC3C,CAAC;AAED;oDACoD;AACpD,MAAM,UAAU,QAAQ,CAAC,KAAgB,EAAE,QAAuB;IAChE,MAAM,GAAG,GAAG,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,QAAuB;IAClE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3F,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,QAAuB;IACjE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,QAAgB;IAC/D,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,+EAA+E;AAE/E;8FAC8F;AAC9F,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACvC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,gBAAgB,CAAC;IAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IAClE,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC;AAcD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,WAA0B;IACxE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC;SACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,sEAAsE;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7F,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI;QAChC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI;QACjD,SAAS,EAAE,MAAM;QACjB,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI;KAC5B,CAAC;AACJ,CAAC;AA4BD,iFAAiF;AACjF,MAAM,UAAU,WAAW,CACzB,OAAoB,EACpB,KAAkB,EAClB,WAA0B;AAC1B,kEAAkE;AAClE,eAA+B;IAE/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjE,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,OAAO,QAAQ,CAAC,KAAK,EAAE,eAAe,IAAI,IAAI,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAuB,EACvB,KAMC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEhC,wFAAwF;IACxF,oFAAoF;IACpF,yFAAyF;IACzF,4BAA4B;IAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,IAAI,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACzF,MAAM,OAAO,GACX,YAAY;QACZ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;YAC5B,sFAAsF;YACtF,oFAAoF;YACpF,8BAA8B;YAC9B,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC,KAAK,QAAQ;YAChF,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAE3C,IAAI,KAAK,EAAE,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QACzD,uFAAuF;QACvF,iFAAiF;QACjF,IAAI,MAAM;YAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAC/C,kFAAkF;QAClF,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IACzD,CAAC;IAED,qFAAqF;IACrF,sFAAsF;IACtF,gCAAgC;IAChC,IAAI,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;IAEvC,wFAAwF;IACxF,kFAAkF;IAClF,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC;IACzE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/plan-request.d.ts

@@ -1,26 +1,7 @@
-import { type PlanCatalog, type PlanModel } from "./plan-model.js";
+import { type PlanRequest } from "./ladder.js";
+import { type PlanCatalog } from "./plan-model.js";
 import type { BillingAdapter } from "./types.js";
-export interface PlanRequest {
-    id: string;
-    /** WorkOS user id of whoever asked. */
-    memberId: string;
-    /**
-     * WHAT they are asking to move: the workspace's plan, or their own seat.
-     *
-     * They are different asks with different prices and different approvers' reasoning — a
-     * seat upgrade costs one seat's difference and affects one person, a plan change moves
-     * everybody — but they queue in the same place, because to an owner they are one list of
-     * "people who need more". Absent means `plan`, so records written before seats existed
-     * still read.
-     */
-    kind?: "plan" | "seat";
-    /** The plan, or the seat type, they are asking to move to. */
-    plan: string;
-    status: "pending" | "done" | "denied";
-    createdAt: string;
-    /** Free text from the asker, trimmed hard — this shares one metadata value. */
-    note?: string;
-}
+export { defaultSeatOf, isSatisfied, isTopSeat, nextSeatUp, nextUsageAsk, seatLadder, seatRank, seatTypeExists, type PlanRequest, } from "./ladder.js";
 /** Every request, newest first. */
 export declare function listPlanRequests(adapter: BillingAdapter, orgId: string): Promise<PlanRequest[]>;
 /**
@@ -34,24 +15,6 @@ export declare function pendingPlanRequest(adapter: BillingAdapter, orgId: strin
     currentPlan?: string | null;
     currentSeatType?: string | null;
 }): Promise<PlanRequest | null>;
-/** Has the workspace already reached (or passed) what this request asked for? */
-export declare function isSatisfied(request: PlanRequest, plans: PlanCatalog, currentPlan: string | null, 
-/** The asker's seat type now — needed only for a seat request. */
-currentSeatType?: string | null): boolean;
-/**
- * The seat a member holds when nobody has assigned them one: the cheapest non-shared type.
- *
- * An UNASSIGNED member is not on "no seat" — they draw the plan's entry-level pack, which is
- * what the meter measures them against and what their badge says. Treating absent as zero
- * made the ladder offer a Standard member the Standard seat they were already effectively on,
- * which is how this was caught: the button read "Assegna Posto Standard".
- */
-export declare function defaultSeatOf(model: PlanModel): string | null;
-/** What a seat costs per month — the ordering "a better seat" means. An absent assignment
- *  resolves to the default seat, not to nothing. */
-export declare function seatRank(model: PlanModel, seatType: string | null): number;
-/** The next seat type up, or null when they are already on the best one. */
-export declare function nextSeatUp(model: PlanModel, seatType: string | null): string | null;
 /**
  * Ask to move up a SEAT — the answer when a better seat exists.
  *
@@ -109,53 +72,4 @@ export declare function requestPlanChange(adapter: BillingAdapter, orgId: string
  * reading of "approve".
  */
 export declare function resolvePlanRequest(adapter: BillingAdapter, orgId: string, requestId: string, status: "done" | "denied"): Promise<PlanRequest | null>;
-/**
- * WHICH ask to offer someone who is out of usage. One decision, in one place.
- *
- * The ladder climbs the cheapest, most targeted rung first, and each rung exists because the
- * one below it cannot help:
- *
- *   1. a better SEAT — their pack is what their seat includes, so the way to have more of it
- *      is a bigger seat. A Standard member should be offered this, never a top-up: topping
- *      up buys them a few days and leaves them in the same place next week.
- *   2. CREDITS, where money can actually lift the wall: a `covers: "included"` window paces
- *      only what the plan gives away, and a pack whose plan overflows to the wallet is the
- *      same statement. Paying works, permanently and without anybody's permission, so
- *      asking an owner for a free exception would be the worse of two available answers.
- *   3. extra USAGE on the blocked window — the answer where money CANNOT help: a
- *      `covers: "all"` window is the product's own pace and no purchase touches it, so an
- *      exception somebody grants is the only door.
- *   4. a PLAN change — for a plan with no per-member allowance at all. A pooled plan's
- *      windows belong to the workspace, so there is nothing personal to raise and
- *      `grant_top_up` refuses it outright.
- *
- * Rungs 2 and 3 were ONE rung, and it was wrong in whichever direction the deployment went.
- * A plan whose card says pay-as-you-go sent a blocked member to ask an owner for something
- * they could have bought in a click; a plan pacing the product offered credits that lift
- * nothing, taking money for a wall that would still be there. Which of the two applies is
- * not a preference — it is what `covers` says, so it is read rather than configured again.
- *
- * Returns null when nothing is blocked, which is when nothing should be offered — a control
- * permanently on screen asks a question nobody at 40% can answer.
- */
-export declare function nextUsageAsk(model: PlanModel | null, input: {
-    /** From `topUpTargetOf` — what, if anything, is refusing them, and whether paying lifts it. */
-    blocked: {
-        kind: "rate" | "pack";
-        covers?: "all" | "included";
-    } | null;
-    seatType?: string | null;
-    plans: PlanCatalog;
-    currentPlan?: string | null;
-}): {
-    ask: "seat";
-    to: string;
-} | {
-    ask: "credits";
-} | {
-    ask: "usage";
-} | {
-    ask: "plan";
-    to: string;
-} | null;
 //# sourceMappingURL=plan-request.d.ts.map

package/dist/plan-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-request.d.ts","sourceRoot":"","sources":["../src/plan-request.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan-request.d.ts","sourceRoot":"","sources":["../src/plan-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,OAAO,EACL,aAAa,EACb,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAgFrB,mCAAmC;AACnC,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAErG;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzF,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAI7B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC;IACT,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,GAAG,YAAY,CAAC;CAC7F,CAAC,CA4BD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC;IACT,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,GAAG,YAAY,CAAC;CAC7F,CAAC,CAsCD;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,GACxB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAW7B"}

package/dist/plan-request.js

@@ -1,5 +1,9 @@
-import { planActions, planRank } from "./subscription.js";
-import { exhaustedPolicy, normalizePlans, planModel } from "./plan-model.js";
+import { isSatisfied, nextSeatUp, planActions, seatRank, } from "./ladder.js";
+import { normalizePlans, planModel } from "./plan-model.js";
+// The rungs themselves are pure arithmetic and live in `ladder.ts`, which a pricing page or
+// a seat picker can import without this module's adapter. Re-exported here so every existing
+// import path keeps working.
+export { defaultSeatOf, isSatisfied, isTopSeat, nextSeatUp, nextUsageAsk, seatLadder, seatRank, seatTypeExists, } from "./ladder.js";
 // "Can we move up a plan?" — the ask a member makes when extra allowance is not the answer.
 //
 // ── Why this is not a top-up ────────────────────────────────────────────────
@@ -91,52 +95,6 @@ export async function pendingPlanRequest(adapter, orgId, memberId, opts) {
         return null;
     return isSatisfied(open, opts.plans, opts.currentPlan ?? null, opts.currentSeatType ?? null) ? null : open;
 }
-/** Has the workspace already reached (or passed) what this request asked for? */
-export function isSatisfied(request, plans, currentPlan, 
-/** The asker's seat type now — needed only for a seat request. */
-currentSeatType) {
-    if (request.kind === "seat") {
-        const model = currentPlan ? planModel(plans, currentPlan) : null;
-        if (!model)
-            return false;
-        return seatRank(model, currentSeatType ?? null) >= seatRank(model, request.plan);
-    }
-    const want = planModel(plans, request.plan);
-    const have = currentPlan ? planModel(plans, currentPlan) : null;
-    if (!want || !have)
-        return false;
-    return planRank(have) >= planRank(want);
-}
-/**
- * The seat a member holds when nobody has assigned them one: the cheapest non-shared type.
- *
- * An UNASSIGNED member is not on "no seat" — they draw the plan's entry-level pack, which is
- * what the meter measures them against and what their badge says. Treating absent as zero
- * made the ladder offer a Standard member the Standard seat they were already effectively on,
- * which is how this was caught: the button read "Assegna Posto Standard".
- */
-export function defaultSeatOf(model) {
-    const ladder = [...model.seatTypes]
-        .filter((s) => !s.shared)
-        .sort((a, b) => a.price.monthly - b.price.monthly);
-    return ladder[0]?.key ?? null;
-}
-/** What a seat costs per month — the ordering "a better seat" means. An absent assignment
- *  resolves to the default seat, not to nothing. */
-export function seatRank(model, seatType) {
-    const key = seatType ?? defaultSeatOf(model);
-    if (!key)
-        return 0;
-    return model.seatTypes.find((s) => s.key === key)?.price.monthly ?? 0;
-}
-/** The next seat type up, or null when they are already on the best one. */
-export function nextSeatUp(model, seatType) {
-    const ladder = [...model.seatTypes]
-        .filter((s) => !s.shared)
-        .sort((a, b) => a.price.monthly - b.price.monthly);
-    const above = ladder.filter((s) => s.price.monthly > seatRank(model, seatType));
-    return above[0]?.key ?? null;
-}
 /**
  * Ask to move up a SEAT — the answer when a better seat exists.
  *
@@ -238,67 +196,4 @@ export async function resolvePlanRequest(adapter, orgId, requestId, status) {
     await write(adapter, orgId, list.map((r) => (r.id === requestId ? updated : r)));
     return updated;
 }
-/**
- * WHICH ask to offer someone who is out of usage. One decision, in one place.
- *
- * The ladder climbs the cheapest, most targeted rung first, and each rung exists because the
- * one below it cannot help:
- *
- *   1. a better SEAT — their pack is what their seat includes, so the way to have more of it
- *      is a bigger seat. A Standard member should be offered this, never a top-up: topping
- *      up buys them a few days and leaves them in the same place next week.
- *   2. CREDITS, where money can actually lift the wall: a `covers: "included"` window paces
- *      only what the plan gives away, and a pack whose plan overflows to the wallet is the
- *      same statement. Paying works, permanently and without anybody's permission, so
- *      asking an owner for a free exception would be the worse of two available answers.
- *   3. extra USAGE on the blocked window — the answer where money CANNOT help: a
- *      `covers: "all"` window is the product's own pace and no purchase touches it, so an
- *      exception somebody grants is the only door.
- *   4. a PLAN change — for a plan with no per-member allowance at all. A pooled plan's
- *      windows belong to the workspace, so there is nothing personal to raise and
- *      `grant_top_up` refuses it outright.
- *
- * Rungs 2 and 3 were ONE rung, and it was wrong in whichever direction the deployment went.
- * A plan whose card says pay-as-you-go sent a blocked member to ask an owner for something
- * they could have bought in a click; a plan pacing the product offered credits that lift
- * nothing, taking money for a wall that would still be there. Which of the two applies is
- * not a preference — it is what `covers` says, so it is read rather than configured again.
- *
- * Returns null when nothing is blocked, which is when nothing should be offered — a control
- * permanently on screen asks a question nobody at 40% can answer.
- */
-export function nextUsageAsk(model, input) {
-    if (!input.blocked)
-        return null;
-    // Can the customer pay their own way past this? Two conditions, and both are necessary:
-    // the plan has to SELL credits, and the wall has to be one credits reach. A pack is
-    // reachable when the plan overflows to the wallet; a rate window only when it covers the
-    // included allowance alone.
-    const sellsCredits = Boolean(model?.replenish?.purchase || model?.replenish?.autoReload);
-    const payable = sellsCredits &&
-        (input.blocked.kind === "pack"
-            // Through `exhaustedPolicy`, not `cap.onExhausted`: an agent and a shared seat always
-            // overflow to the wallet whatever the cap declares, and a `cap: wallet` plan has no
-            // `onExhausted` field at all.
-            ? exhaustedPolicy(model, { seatType: input.seatType ?? undefined }) === "wallet"
-            : input.blocked.covers === "included");
-    if (model?.sells.kind === "seats") {
-        const better = nextSeatUp(model, input.seatType ?? null);
-        // The seat still comes first, even when credits would work: it raises the pack AND the
-        // pace every cycle, where credits are this week's answer bought again next week.
-        if (better)
-            return { ask: "seat", to: better };
-        // On the best seat: buy more if that is possible, otherwise ask for an exception.
-        return payable ? { ask: "credits" } : { ask: "usage" };
-    }
-    // A pooled plan has nothing personal to raise — but if it sells credits and the pool
-    // overflows to the wallet, paying is still a real answer and a better one than asking
-    // the workspace to change plan.
-    if (payable)
-        return { ask: "credits" };
-    // No seats, so nothing per-member to raise. The only route is the workspace buying more
-    // product — and if there is nothing above them, there is nothing to offer at all.
-    const up = planActions(input.plans, input.currentPlan ?? null).upgradeTo;
-    return up ? { ask: "plan", to: up } : null;
-}
 //# sourceMappingURL=plan-request.js.map