@stigmer/react 3.39.0 → 3.40.0

package/billing/PlanPicker.d.ts

@@ -0,0 +1,34 @@
+import type { Plan } from "@stigmer/protos/ai/stigmer/billing/plan/v1/api_pb";
+import { type PlanMove, type PlanStanding } from "./plan-state.js";
+/** Where Enterprise enquiries go by default. */
+export declare const ENTERPRISE_CONTACT_URL = "https://stigmer.ai/contact-sales";
+/** Props for {@link PlanPicker}. */
+export interface PlanPickerProps {
+    /** The plans that can be bought, cheapest first, as `buyablePlans` orders them. */
+    readonly plans: readonly Plan[];
+    /** Where the organization stands. */
+    readonly standing: PlanStanding;
+    /** The live period's end, which a cancel runs to. */
+    readonly periodEnd?: Date;
+    /**
+     * Whether the viewer may change the plan (`can_manage_billing`). Without
+     * it the comparison is read-only.
+     */
+    readonly canManage: boolean;
+    /** Called with the move a choice makes; the host confirms it. */
+    readonly onChoose: (move: PlanMove) => void;
+    /** Disables every choice, e.g. while a change is in flight. */
+    readonly disabled?: boolean;
+    /** Where "Talk to us" for Enterprise links. Defaults to {@link ENTERPRISE_CONTACT_URL}. */
+    readonly enterpriseHref?: string;
+    /** Additional CSS class names. */
+    readonly className?: string;
+}
+/**
+ * The plan comparison: Free, each plan that can be bought, and
+ * Enterprise, each with its price and what it offers today. A choice
+ * reports the move it makes (subscribe, switch, resume or cancel) for the
+ * host to confirm; the plan in force reads "Current plan".
+ */
+export declare function PlanPicker({ plans, standing, periodEnd, canManage, onChoose, disabled, enterpriseHref, className, }: PlanPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PlanPicker.d.ts.map

package/billing/PlanPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanPicker.d.ts","sourceRoot":"","sources":["../src/billing/PlanPicker.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mDAAmD,CAAC;AAS9E,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE7E,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,qCAAqC,CAAC;AAEzE,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,cAAuC,EACvC,SAAS,GACV,EAAE,eAAe,2CAkDjB"}

package/billing/PlanPicker.js

@@ -0,0 +1,46 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { Button } from "../button/index.js";
+import { UNSTYLED_LIST } from "../internal/element-resets.js";
+import { formatManagedOrganizations, formatMonthlyMinimum, explainUsageShare, offeredFeatures, } from "./plan-features.js";
+import { planMove } from "./plan-state.js";
+/** Where Enterprise enquiries go by default. */
+export const ENTERPRISE_CONTACT_URL = "https://stigmer.ai/contact-sales";
+/**
+ * The plan comparison: Free, each plan that can be bought, and
+ * Enterprise, each with its price and what it offers today. A choice
+ * reports the move it makes (subscribe, switch, resume or cancel) for the
+ * host to confirm; the plan in force reads "Current plan".
+ */
+export function PlanPicker({ plans, standing, periodEnd, canManage, onChoose, disabled, enterpriseHref = ENTERPRISE_CONTACT_URL, className, }) {
+    const freeMove = planMove(standing, "free", periodEnd);
+    return (_jsxs("ul", { className: cn(UNSTYLED_LIST, "stg:grid stg:gap-3 stg:sm:grid-cols-2", className), "aria-label": "Plans", children: [_jsx(PlanOption, { name: "Free", price: "$0/month", detail: "Usage is paid from credits.", features: ["Channels", "Sharing", "Unlimited members"], current: standing.kind === "free", action: canManage && freeMove !== null ? { label: "Move to Free", move: freeMove } : undefined, disabled: disabled, onChoose: onChoose }), plans.map((plan) => {
+                const move = planMove(standing, plan, periodEnd);
+                const managed = formatManagedOrganizations(plan.spec?.entitlements, plan.spec?.terms);
+                return (_jsx(PlanOption, { name: plan.metadata?.name ?? "", price: formatMonthlyMinimum(plan.spec?.terms), detail: explainUsageShare(plan.spec?.terms), features: [
+                        ...offeredFeatures(plan.spec?.entitlements).map((feature) => feature.label),
+                        ...(managed === "" ? [] : [managed]),
+                    ], current: move === null && standing.kind !== "free", action: canManage && move !== null ? { label: actionLabel(move), move } : undefined, disabled: disabled, onChoose: onChoose }, plan.metadata?.id ?? plan.metadata?.slug));
+            }), _jsxs("li", { className: "stg:flex stg:flex-col stg:rounded-lg stg:border stg:border-border stg:bg-card stg:p-4", children: [_jsx("p", { className: "stg:text-sm stg:font-medium stg:text-foreground", children: "Enterprise" }), _jsx("p", { className: "stg:mt-1 stg:text-xs stg:text-muted-foreground", children: "A dedicated deployment, SSO enforcement, an SLA and annual invoicing, quoted for your organization." }), _jsx("a", { href: enterpriseHref, target: "_blank", rel: "noreferrer", className: "stg:mt-3 stg:self-start stg:text-xs stg:font-medium stg:text-primary stg:hover:underline", children: "Talk to us" })] })] }));
+}
+function PlanOption({ name, price, detail, features, current, action, disabled, onChoose, }) {
+    return (_jsxs("li", { className: cn("stg:flex stg:flex-col stg:rounded-lg stg:border stg:bg-card stg:p-4", current ? "stg:border-primary" : "stg:border-border"), "aria-current": current ? "true" : undefined, children: [_jsxs("div", { className: "stg:flex stg:items-baseline stg:justify-between stg:gap-2", children: [_jsx("p", { className: "stg:text-sm stg:font-medium stg:text-foreground", children: name }), _jsx("p", { className: "stg:text-xs stg:tabular-nums stg:text-foreground", children: price })] }), detail !== "" && _jsx("p", { className: "stg:mt-1 stg:text-xs stg:text-muted-foreground", children: detail }), _jsx("ul", { className: cn(UNSTYLED_LIST, "stg:mt-2 stg:space-y-0.5 stg:text-xs stg:text-muted-foreground"), children: features.map((feature) => (_jsx("li", { children: feature }, feature))) }), _jsx("div", { className: "stg:mt-auto stg:pt-3", children: current ? (_jsx("span", { className: "stg:text-xs stg:font-medium stg:text-primary", children: "Current plan" })) : action ? (_jsx(Button, { variant: action.move.kind === "cancel" ? "outline" : "primary", size: "xs", disabled: disabled, onClick: () => onChoose(action.move), children: action.label })) : null })] }));
+}
+function actionLabel(move) {
+    switch (move.kind) {
+        case "subscribe":
+            return "Subscribe";
+        case "switch":
+            return `Switch to ${move.to.metadata?.name ?? "this plan"}`;
+        case "resume":
+            return `Keep ${move.to.metadata?.name ?? "this plan"}`;
+        case "cancel":
+            return "Move to Free";
+        default: {
+            const exhaustive = move;
+            return String(exhaustive);
+        }
+    }
+}
+//# sourceMappingURL=PlanPicker.js.map

package/billing/PlanPicker.js.map

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

package/billing/PlanSection.d.ts

@@ -0,0 +1,45 @@
+import type { BillingRedirect } from "./redirect.js";
+/** Props for {@link PlanSection}. */
+export interface PlanSectionProps {
+    /** The organization whose plan is shown. */
+    readonly orgId: string;
+    /**
+     * The organization is platform-managed: it runs on its integrator's
+     * plan, and the section says so instead of offering plans.
+     */
+    readonly managed?: boolean;
+    /** Whether the organization's billing account holds a saved card. */
+    readonly hasPaymentMethod: boolean;
+    /** Re-read the billing account, so a card saved on Stripe's page shows. */
+    readonly onRefreshAccount?: () => void;
+    /** The host's seam for Stripe-hosted pages (see {@link BillingRedirect}). */
+    readonly redirect?: BillingRedirect;
+    /**
+     * The plan the person was choosing when they left to save a card (the
+     * `plan` query Stripe returns with). The section reopens that choice for
+     * an explicit confirm; it never subscribes on its own.
+     */
+    readonly resumePlanId?: string;
+    /** Called once the resumed choice has been taken up, so the host can clear its query. */
+    readonly onResumeHandled?: () => void;
+    /** The clock the standing reads. Defaults to each render's time. */
+    readonly now?: Date;
+    /** Additional CSS class names. */
+    readonly className?: string;
+}
+/**
+ * An organization's plan on Stigmer Cloud: the current plan with its
+ * standing and the period's estimated invoice, the plan comparison, and
+ * the confirm step for a subscribe, switch, resume or cancel.
+ *
+ * Everyone who can view the organization's billing reads it; only those
+ * who can manage billing (its admins) see the choices. Renders nothing on
+ * an edition that serves no subscriptions.
+ *
+ * @example
+ * ```tsx
+ * <PlanSection orgId={orgId} hasPaymentMethod={hasCard} />
+ * ```
+ */
+export declare function PlanSection({ orgId, managed, hasPaymentMethod, onRefreshAccount, redirect, resumePlanId, onResumeHandled, now, className, }: PlanSectionProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=PlanSection.d.ts.map

package/billing/PlanSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanSection.d.ts","sourceRoot":"","sources":["../src/billing/PlanSection.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAWrD,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,GAAG,EACH,SAAS,GACV,EAAE,gBAAgB,kDA4JlB"}

package/billing/PlanSection.js

@@ -0,0 +1,136 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { cn } from "@stigmer/theme";
+import { getUserMessage } from "@stigmer/sdk";
+import { ApiResourceKind, useResourceAvailable } from "../deployment-mode.js";
+import { useCheckPermission } from "../iam-policy/useCheckPermission.js";
+import { ChangePlanDialog } from "./ChangePlanDialog.js";
+import { PlanCard } from "./PlanCard.js";
+import { PlanPicker } from "./PlanPicker.js";
+import { buyablePlans, featuresLost } from "./plan-features.js";
+import { planMove, planStanding, standingPlanId } from "./plan-state.js";
+import { useCancelSubscription, useChangePlan } from "./useChangePlan.js";
+import { useCreatePaymentMethodSetupSession } from "./useCreatePaymentMethodSetupSession.js";
+import { usePeriodEstimate } from "./usePeriodEstimate.js";
+import { usePlans } from "./usePlans.js";
+import { useSubscription } from "./useSubscription.js";
+/** How often, and how long, the section waits for a just-saved card to reach the account. */
+const CARD_POLL_MS = 2_000;
+const CARD_WAIT_MS = 30_000;
+/**
+ * An organization's plan on Stigmer Cloud: the current plan with its
+ * standing and the period's estimated invoice, the plan comparison, and
+ * the confirm step for a subscribe, switch, resume or cancel.
+ *
+ * Everyone who can view the organization's billing reads it; only those
+ * who can manage billing (its admins) see the choices. Renders nothing on
+ * an edition that serves no subscriptions.
+ *
+ * @example
+ * ```tsx
+ * <PlanSection orgId={orgId} hasPaymentMethod={hasCard} />
+ * ```
+ */
+export function PlanSection({ orgId, managed = false, hasPaymentMethod, onRefreshAccount, redirect, resumePlanId, onResumeHandled, now, className, }) {
+    const available = useResourceAvailable(ApiResourceKind.subscription);
+    const renderNow = now ?? new Date();
+    const catalog = usePlans({ includeRetired: true, enabled: available });
+    const current = useSubscription(available ? orgId : null);
+    const standing = planStanding(current.subscription, renderNow);
+    const livePlanId = standingPlanId(standing);
+    const estimate = usePeriodEstimate(orgId, { enabled: available && !managed && livePlanId !== "" });
+    const manage = useCheckPermission(available && orgId ? { kind: "organization", id: orgId } : null, "can_manage_billing");
+    const canManage = !managed && !manage.isLoading && manage.allowed;
+    const changer = useChangePlan();
+    const canceler = useCancelSubscription();
+    const setup = useCreatePaymentMethodSetupSession(redirect);
+    const [move, setMove] = useState(null);
+    const [awaitingCard, setAwaitingCard] = useState(false);
+    const buyable = useMemo(() => buyablePlans(catalog.plans ?? []), [catalog.plans]);
+    const planById = useCallback((planId) => catalog.plans?.find((plan) => plan.metadata?.id === planId), [catalog.plans]);
+    const planName = useCallback((planId) => planById(planId)?.metadata?.name ?? "your plan", [planById]);
+    const periodEndStamp = current.subscription?.status?.currentPeriodEnd;
+    const periodEnd = periodEndStamp === undefined ? undefined : timestampDate(periodEndStamp);
+    // Back from Stripe's card page: reopen the choice the person was making.
+    // Keyed by the plan resumed, and cleared once the host drops the query,
+    // because a desktop host stays mounted across returns and may resume again.
+    const resumedFor = useRef(null);
+    useEffect(() => {
+        if (resumePlanId === undefined || resumePlanId === "") {
+            resumedFor.current = null;
+            return;
+        }
+        if (resumedFor.current === resumePlanId || catalog.plans === null || current.isLoading) {
+            return;
+        }
+        resumedFor.current = resumePlanId;
+        const target = buyable.find((plan) => plan.metadata?.id === resumePlanId);
+        const resumedMove = target === undefined ? null : planMove(standing, target, periodEnd);
+        if (resumedMove !== null) {
+            setMove(resumedMove);
+            setAwaitingCard(!hasPaymentMethod);
+        }
+        onResumeHandled?.();
+    }, [resumePlanId, catalog.plans, current.isLoading, buyable, standing, periodEnd, hasPaymentMethod, onResumeHandled]);
+    // The card lands on the account by webhook a few seconds after Stripe's
+    // page returns; poll the account until it does, bounded.
+    useEffect(() => {
+        if (!awaitingCard)
+            return;
+        if (hasPaymentMethod) {
+            setAwaitingCard(false);
+            return;
+        }
+        const started = Date.now();
+        const timer = setInterval(() => {
+            if (Date.now() - started > CARD_WAIT_MS) {
+                setAwaitingCard(false);
+                clearInterval(timer);
+                return;
+            }
+            onRefreshAccount?.();
+        }, CARD_POLL_MS);
+        return () => clearInterval(timer);
+    }, [awaitingCard, hasPaymentMethod, onRefreshAccount]);
+    const close = useCallback(() => {
+        setMove(null);
+        setAwaitingCard(false);
+        changer.clearError();
+        canceler.clearError();
+        setup.clearError();
+    }, [changer.clearError, canceler.clearError, setup.clearError]);
+    const refreshAll = useCallback(() => {
+        current.refetch();
+        estimate.refetch();
+    }, [current.refetch, estimate.refetch]);
+    const confirm = useCallback(() => {
+        if (move === null)
+            return;
+        const done = move.kind === "cancel" ? canceler.cancel(orgId) : changer.changePlan(orgId, move.to.metadata?.id ?? "");
+        done.then(() => {
+            setMove(null);
+            refreshAll();
+        }, () => undefined);
+    }, [move, orgId, canceler.cancel, changer.changePlan, refreshAll]);
+    const addPaymentMethod = useCallback(() => {
+        const planId = move !== null && move.kind !== "cancel" ? move.to.metadata?.id : undefined;
+        setup.addPaymentMethod(orgId, planId).catch(() => undefined);
+    }, [move, orgId, setup.addPaymentMethod]);
+    if (!available) {
+        return null;
+    }
+    if (current.isLoading || catalog.isLoading) {
+        return (_jsx("div", { className: cn("stg:space-y-3", className), "aria-busy": "true", "aria-label": "Loading plan", children: _jsx("div", { className: "stg:h-24 stg:animate-pulse stg:rounded-lg stg:bg-muted-subtle" }) }));
+    }
+    const readError = current.error ?? catalog.error;
+    if (readError) {
+        return (_jsx("p", { className: cn("stg:text-xs stg:text-destructive", className), role: "alert", children: getUserMessage(readError) }));
+    }
+    const nameInForce = livePlanId === "" ? "Free" : planName(livePlanId);
+    const moveError = move?.kind === "cancel" ? canceler.error : (changer.error ?? setup.error);
+    const losing = move?.kind === "switch" ? featuresLost(planById(move.fromPlanId), move.to) : [];
+    return (_jsxs("section", { className: cn("stg:space-y-3", className), "aria-label": "Plan", children: [_jsx(PlanCard, { planName: nameInForce, standing: standing, estimate: estimate.estimate, estimateError: estimate.error, managed: managed }), !managed && (_jsx(PlanPicker, { plans: buyable, standing: standing, periodEnd: periodEnd, canManage: canManage, onChoose: setMove, disabled: changer.isSubmitting || canceler.isSubmitting })), _jsx(ChangePlanDialog, { move: move, planName: planName, losing: losing, hasPaymentMethod: hasPaymentMethod, awaitingPaymentMethod: awaitingCard, isSubmitting: changer.isSubmitting || canceler.isSubmitting || setup.isSubmitting, error: moveError, onConfirm: confirm, onAddPaymentMethod: addPaymentMethod, onClose: close })] }));
+}
+//# sourceMappingURL=PlanSection.js.map

package/billing/PlanSection.js.map

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

package/billing/UpgradeNotice.d.ts

@@ -0,0 +1,47 @@
+import { Feature } from "@stigmer/protos/ai/stigmer/platform/v1/entitlement_pb";
+/**
+ * The reason Stigmer Cloud refuses an act the organization's plan does not
+ * include (iam/team/v1 and tenancy/organization/v1 command.proto).
+ */
+export declare const PLAN_UPGRADE_REQUIRED = "PLAN_UPGRADE_REQUIRED";
+/** The billing page the notice links to by default: the settings route every client serves. */
+export declare const DEFAULT_BILLING_HREF = "/settings/billing";
+/**
+ * The feature a refusal says the organization's plan lacks, when `error`
+ * is Stigmer Cloud's `PLAN_UPGRADE_REQUIRED`; `null` for any other error.
+ */
+export declare function planUpgradeFeature(error: unknown): Feature | null;
+/** Props for {@link UpgradeNotice}. */
+export interface UpgradeNoticeProps {
+    /** The feature the organization's plan lacks. */
+    readonly feature: Feature;
+    /**
+     * The refusal, when there was one: its message is the server's own
+     * copy, which names the plan that unlocks the act. Absent, the notice is
+     * shown ahead of an attempt.
+     */
+    readonly error?: Error | null;
+    /**
+     * The plan that unlocks the feature, named ahead of an attempt, e.g. the
+     * cheapest one that includes it (`lowestPlanWith`). With a refusal,
+     * the server's copy names it instead.
+     */
+    readonly unlockingPlanName?: string;
+    /** Where the plans are, in the host's routing. Defaults to {@link DEFAULT_BILLING_HREF}. */
+    readonly billingHref?: string;
+    /** Additional CSS class names. */
+    readonly className?: string;
+}
+/**
+ * Says an act needs a plan that includes it, and where to change the plan,
+ * in place of a bare refusal. Everything the organization already has keeps
+ * working; only creating more is refused.
+ *
+ * @example
+ * ```tsx
+ * const feature = planUpgradeFeature(error);
+ * if (feature !== null) return <UpgradeNotice feature={feature} error={error} />;
+ * ```
+ */
+export declare function UpgradeNotice({ feature, error, unlockingPlanName, billingHref, className, }: UpgradeNoticeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=UpgradeNotice.d.ts.map

package/billing/UpgradeNotice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeNotice.d.ts","sourceRoot":"","sources":["../src/billing/UpgradeNotice.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,uDAAuD,CAAC;AAGhF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAQxD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAMjE;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,WAAkC,EAClC,SAAS,GACV,EAAE,kBAAkB,2CAqBpB"}

package/billing/UpgradeNotice.js

@@ -0,0 +1,49 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { getErrorReason, getUserMessage } from "@stigmer/sdk";
+import { Feature } from "@stigmer/protos/ai/stigmer/platform/v1/entitlement_pb";
+import { FEATURE_COPY, isNamedFeature } from "../internal/features.js";
+/**
+ * The reason Stigmer Cloud refuses an act the organization's plan does not
+ * include (iam/team/v1 and tenancy/organization/v1 command.proto).
+ */
+export const PLAN_UPGRADE_REQUIRED = "PLAN_UPGRADE_REQUIRED";
+/** The billing page the notice links to by default: the settings route every client serves. */
+export const DEFAULT_BILLING_HREF = "/settings/billing";
+/** The wire names the refusal's `feature` metadata carries. */
+const FEATURE_BY_WIRE_NAME = {
+    teams: Feature.teams,
+    managed_organizations: Feature.managed_organizations,
+};
+/**
+ * The feature a refusal says the organization's plan lacks, when `error`
+ * is Stigmer Cloud's `PLAN_UPGRADE_REQUIRED`; `null` for any other error.
+ */
+export function planUpgradeFeature(error) {
+    const reason = getErrorReason(error);
+    if (reason?.reason !== PLAN_UPGRADE_REQUIRED) {
+        return null;
+    }
+    return FEATURE_BY_WIRE_NAME[reason.metadata.feature ?? ""] ?? null;
+}
+/**
+ * Says an act needs a plan that includes it, and where to change the plan,
+ * in place of a bare refusal. Everything the organization already has keeps
+ * working; only creating more is refused.
+ *
+ * @example
+ * ```tsx
+ * const feature = planUpgradeFeature(error);
+ * if (feature !== null) return <UpgradeNotice feature={feature} error={error} />;
+ * ```
+ */
+export function UpgradeNotice({ feature, error, unlockingPlanName, billingHref = DEFAULT_BILLING_HREF, className, }) {
+    const label = isNamedFeature(feature) ? FEATURE_COPY[feature].label : "This feature";
+    const ahead = unlockingPlanName === undefined || unlockingPlanName === ""
+        ? `${label} are not included in this organization's plan.`
+        : `${label} need the ${unlockingPlanName} plan or above.`;
+    const message = error ? getUserMessage(error) : ahead;
+    return (_jsxs("div", { className: cn("stg:rounded-md stg:border stg:border-border stg:bg-muted-subtle stg:px-3 stg:py-2 stg:text-xs", className), role: "status", children: [_jsx("p", { className: "stg:text-foreground", children: message }), _jsx("a", { href: billingHref, className: "stg:mt-1 stg:inline-block stg:font-medium stg:text-primary stg:hover:underline", children: "View plans" })] }));
+}
+//# sourceMappingURL=UpgradeNotice.js.map

package/billing/UpgradeNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeNotice.js","sourceRoot":"","sources":["../src/billing/UpgradeNotice.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,uDAAuD,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,+FAA+F;AAC/F,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD,+DAA+D;AAC/D,MAAM,oBAAoB,GAAsC;IAC9D,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;CACrD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,MAAM,EAAE,MAAM,KAAK,qBAAqB,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC;AACrE,CAAC;AAwBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,iBAAiB,EACjB,WAAW,GAAG,oBAAoB,EAClC,SAAS,GACU;IACnB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC;IACrF,MAAM,KAAK,GACT,iBAAiB,KAAK,SAAS,IAAI,iBAAiB,KAAK,EAAE;QACzD,CAAC,CAAC,GAAG,KAAK,gDAAgD;QAC1D,CAAC,CAAC,GAAG,KAAK,aAAa,iBAAiB,iBAAiB,CAAC;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,+FAA+F,EAC/F,SAAS,CACV,EACD,IAAI,EAAC,QAAQ,aAEb,YAAG,SAAS,EAAC,qBAAqB,YAAE,OAAO,GAAK,EAChD,YAAG,IAAI,EAAE,WAAW,EAAE,SAAS,EAAC,gFAAgF,2BAE5G,IACA,CACP,CAAC;AACJ,CAAC"}

package/billing/credit-packs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credit-packs.d.ts","sourceRoot":"","sources":["../src/billing/credit-packs.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EAsBjD,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"credit-packs.d.ts","sourceRoot":"","sources":["../src/billing/credit-packs.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EAyBjD,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/billing/credit-packs.js

@@ -20,8 +20,11 @@ export const CREDIT_PACKS = [
         credits: 5_000,
     },
     {
+        // Named "Scale", not "Team", so it never reads as the Team plan on the
+        // page that sells both; its id stays "team", the wire value every
+        // purchase row and checkout call carries.
         packId: "team",
-        displayName: "Team",
+        displayName: "Scale",
         description: "For production workloads",
         priceCents: 20_000,
         credits: 20_000,

package/billing/credit-packs.js.map

@@ -1 +1 @@
-{"version":3,"file":"credit-packs.js","sourceRoot":"","sources":["../src/billing/credit-packs.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAA8B;IACrD;QACE,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,uBAAuB;QACpC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf;IACD;QACE,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf;IACD;QACE,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,MAAM;QAClB,OAAO,EAAE,MAAM;KAChB;CACF,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC;IAC5B,OAAO,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"credit-packs.js","sourceRoot":"","sources":["../src/billing/credit-packs.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAA8B;IACrD;QACE,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,uBAAuB;QACpC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf;IACD;QACE,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf;IACD;QACE,uEAAuE;QACvE,kEAAkE;QAClE,0CAA0C;QAC1C,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,MAAM;QAClB,OAAO,EAAE,MAAM;KAChB;CACF,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC;IAC5B,OAAO,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/billing/index.d.ts

@@ -1,15 +1,30 @@
 export { useBillingAccount } from "./useBillingAccount.js";
-export type { UseBillingAccountReturn } from "./useBillingAccount.js";
+export type { UseBillingAccountOptions, UseBillingAccountReturn } from "./useBillingAccount.js";
 export { useCreditLedger } from "./useCreditLedger.js";
 export type { UseCreditLedgerReturn, UseCreditLedgerOptions } from "./useCreditLedger.js";
 export { useBillingUsageReport } from "./useBillingUsageReport.js";
 export type { UseBillingUsageReportReturn } from "./useBillingUsageReport.js";
 export { useCustomerModelPricing } from "./useCustomerModelPricing.js";
 export type { UseCustomerModelPricingReturn } from "./useCustomerModelPricing.js";
+export { usePlans } from "./usePlans.js";
+export type { UsePlansOptions, UsePlansReturn } from "./usePlans.js";
+export { useSubscription } from "./useSubscription.js";
+export type { UseSubscriptionReturn } from "./useSubscription.js";
+export { useEntitlements } from "./useEntitlements.js";
+export type { UseEntitlementsOptions, UseEntitlementsReturn } from "./useEntitlements.js";
+export { usePeriodEstimate } from "./usePeriodEstimate.js";
+export type { UsePeriodEstimateOptions, UsePeriodEstimateReturn } from "./usePeriodEstimate.js";
 export { useCreateCheckoutSession } from "./useCreateCheckoutSession.js";
 export type { CreateCheckoutSessionInput, UseCreateCheckoutSessionReturn, } from "./useCreateCheckoutSession.js";
 export { useCreateBillingPortalSession } from "./useCreateBillingPortalSession.js";
 export type { UseCreateBillingPortalSessionReturn } from "./useCreateBillingPortalSession.js";
+export { useChangePlan, useCancelSubscription } from "./useChangePlan.js";
+export type { UseChangePlanReturn, UseCancelSubscriptionReturn } from "./useChangePlan.js";
+export { useCreatePaymentMethodSetupSession } from "./useCreatePaymentMethodSetupSession.js";
+export type { UseCreatePaymentMethodSetupSessionReturn } from "./useCreatePaymentMethodSetupSession.js";
+export type { BillingRedirect } from "./redirect.js";
+export { planStanding, planMove } from "./plan-state.js";
+export type { PlanStanding, PlanMove } from "./plan-state.js";
 export { useSetAutoRechargeConfig } from "./useSetAutoRechargeConfig.js";
 export type { SetAutoRechargeConfigInput, UseSetAutoRechargeConfigReturn, } from "./useSetAutoRechargeConfig.js";
 export { BillingSection } from "./BillingSection.js";
@@ -26,6 +41,16 @@ export { CreditLedgerTable } from "./CreditLedgerTable.js";
 export type { CreditLedgerTableProps } from "./CreditLedgerTable.js";
 export { LowBalanceBanner } from "./LowBalanceBanner.js";
 export type { LowBalanceBannerProps } from "./LowBalanceBanner.js";
+export { PlanSection } from "./PlanSection.js";
+export type { PlanSectionProps } from "./PlanSection.js";
+export { PlanCard } from "./PlanCard.js";
+export type { PlanCardProps } from "./PlanCard.js";
+export { PlanPicker, ENTERPRISE_CONTACT_URL } from "./PlanPicker.js";
+export type { PlanPickerProps } from "./PlanPicker.js";
+export { ChangePlanDialog, PAYMENT_METHOD_REQUIRED } from "./ChangePlanDialog.js";
+export type { ChangePlanDialogProps } from "./ChangePlanDialog.js";
+export { UpgradeNotice, planUpgradeFeature, PLAN_UPGRADE_REQUIRED, DEFAULT_BILLING_HREF } from "./UpgradeNotice.js";
+export type { UpgradeNoticeProps } from "./UpgradeNotice.js";
 export { CREDIT_PACKS, formatPackPrice, formatCreditCount } from "./credit-packs.js";
 export type { CreditPackInfo } from "./credit-packs.js";
 export { formatCreditBalance, formatLedgerAmount, ledgerEntryLabel, isCredit, isHold, formatLedgerDate, } from "./format.js";

package/billing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/billing/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAGlF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,YAAY,EAAE,mCAAmC,EAAE,MAAM,oCAAoC,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/billing/index.ts"],"names":[],"mappings":"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"}

package/billing/index.js

@@ -7,9 +7,16 @@ export { useBillingAccount } from "./useBillingAccount.js";
 export { useCreditLedger } from "./useCreditLedger.js";
 export { useBillingUsageReport } from "./useBillingUsageReport.js";
 export { useCustomerModelPricing } from "./useCustomerModelPricing.js";
+export { usePlans } from "./usePlans.js";
+export { useSubscription } from "./useSubscription.js";
+export { useEntitlements } from "./useEntitlements.js";
+export { usePeriodEstimate } from "./usePeriodEstimate.js";
 // Behavior hooks
 export { useCreateCheckoutSession } from "./useCreateCheckoutSession.js";
 export { useCreateBillingPortalSession } from "./useCreateBillingPortalSession.js";
+export { useChangePlan, useCancelSubscription } from "./useChangePlan.js";
+export { useCreatePaymentMethodSetupSession } from "./useCreatePaymentMethodSetupSession.js";
+export { planStanding, planMove } from "./plan-state.js";
 export { useSetAutoRechargeConfig } from "./useSetAutoRechargeConfig.js";
 // Styled components
 export { BillingSection } from "./BillingSection.js";
@@ -19,6 +26,11 @@ export { AutoRechargeCard } from "./AutoRechargeCard.js";
 export { CreditPackGrid } from "./CreditPackGrid.js";
 export { CreditLedgerTable } from "./CreditLedgerTable.js";
 export { LowBalanceBanner } from "./LowBalanceBanner.js";
+export { PlanSection } from "./PlanSection.js";
+export { PlanCard } from "./PlanCard.js";
+export { PlanPicker, ENTERPRISE_CONTACT_URL } from "./PlanPicker.js";
+export { ChangePlanDialog, PAYMENT_METHOD_REQUIRED } from "./ChangePlanDialog.js";
+export { UpgradeNotice, planUpgradeFeature, PLAN_UPGRADE_REQUIRED, DEFAULT_BILLING_HREF } from "./UpgradeNotice.js";
 // Credit pack catalog and formatting utilities
 export { CREDIT_PACKS, formatPackPrice, formatCreditCount } from "./credit-packs.js";
 export { formatCreditBalance, formatLedgerAmount, ledgerEntryLabel, isCredit, isHold, formatLedgerDate, } from "./format.js";

package/billing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/billing/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,yEAAyE;AACzE,oEAAoE;AACpE,iEAAiE;AAEjE,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,iBAAiB;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAMzE,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/billing/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,yEAAyE;AACzE,oEAAoE;AACpE,iEAAiE;AAEjE,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,iBAAiB;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAG7F,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAMzE,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGpH,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/billing/plan-features.d.ts

@@ -0,0 +1,60 @@
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Plan } from "@stigmer/protos/ai/stigmer/billing/plan/v1/api_pb";
+import { type PlanTerms } from "@stigmer/protos/ai/stigmer/billing/plan/v1/spec_pb";
+import { Feature, type Entitlements } from "@stigmer/protos/ai/stigmer/platform/v1/entitlement_pb";
+import { type NamedFeature } from "../internal/features.js";
+/**
+ * Features a plan may list ahead of the gate that serves them, which
+ * Stigmer Cloud does not offer yet. The console leaves them out of every
+ * comparison. Bring-your-own provider keys leaves this set when the proxy
+ * uses an organization's own key.
+ */
+export declare const NOT_YET_OFFERED: ReadonlySet<Feature>;
+/** One feature a plan offers today, with its words. */
+export interface OfferedFeature {
+    readonly feature: NamedFeature;
+    readonly label: string;
+    readonly description: string;
+}
+/** The features `entitlements` grant that Cloud offers today, in contract order. */
+export declare function offeredFeatures(entitlements: Entitlements | undefined): readonly OfferedFeature[];
+/**
+ * The plans an organization can subscribe to, cheapest monthly minimum
+ * first, so a comparison reads upward from Free; equal minimums keep the
+ * catalog's order. Retired rows and prepaid instruments are left out.
+ */
+export declare function buyablePlans(plans: readonly Plan[]): readonly Plan[];
+/** The cheapest plan that can be bought and includes `feature`, if any. */
+export declare function lowestPlanWith(plans: readonly Plan[], feature: Feature): Plan | undefined;
+/** What `from` offers that `to` does not: what a switch stops the organization creating. */
+export declare function featuresLost(from: Plan | undefined, to: Plan): readonly OfferedFeature[];
+/** A plan's monthly minimum, e.g. "$99.00/month". */
+export declare function formatMonthlyMinimum(terms: PlanTerms | undefined): string;
+/**
+ * A plan's usage share as its terms state it, for operators who read terms,
+ * e.g. "or 10% of provider cost, whichever is greater; the commission
+ * already paid on tokens counts toward it". Empty when the plan has no
+ * usage share.
+ */
+export declare function formatUsageShare(terms: PlanTerms | undefined): string;
+/**
+ * The same share as a customer reads it: usage stays paid from credits,
+ * and the commission on it counts toward the minimum up to the spend at
+ * which the plan costs nothing extra, e.g. "Usage is still paid from
+ * credits. The 10% commission on it counts toward the minimum, so from
+ * $990.00 a month in provider costs the plan costs nothing extra." Empty
+ * when the plan has no usage share.
+ */
+export declare function explainUsageShare(terms: PlanTerms | undefined): string;
+/** The usage share as a percentage, e.g. "10%" or "12.50%"; empty when there is none. */
+export declare function sharePercent(terms: PlanTerms | undefined): string;
+/** The managed organizations a plan includes and what each beyond costs, or empty. */
+export declare function formatManagedOrganizations(entitlements: Entitlements | undefined, terms: PlanTerms | undefined): string;
+/**
+ * A period boundary as a UTC calendar day, e.g. "Feb 28, 2027". Periods
+ * run anniversary to anniversary in UTC, the rule the invoice follows.
+ */
+export declare function formatPeriodDay(timestamp: Timestamp | undefined): string;
+/** An instant as its UTC calendar day, the way {@link formatPeriodDay} shows a period boundary. */
+export declare function formatDay(date: Date): string;
+//# sourceMappingURL=plan-features.d.ts.map

package/billing/plan-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-features.d.ts","sourceRoot":"","sources":["../src/billing/plan-features.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mDAAmD,CAAC;AAC9E,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,oDAAoD,CAAC;AAEpG,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,uDAAuD,CAAC;AACnG,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAO1F;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,OAAO,CAAwC,CAAC;AAE1F,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,cAAc,EAAE,CAMjG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,IAAI,EAAE,CASpE;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAIzF;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE,IAAI,GAAG,SAAS,cAAc,EAAE,CAGxF;AAQD,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAKrE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAYtE;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAMjE;AAED,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,KAAK,EAAE,SAAS,GAAG,SAAS,GAC3B,MAAM,CAWR;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAExE;AAED,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE5C"}