@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/billing/billing-enums.shared.schemas.d.ts

@@ -170,4 +170,79 @@ export declare enum ReferredRewardType {
     FEATURE = "feature",
     TRIAL_EXTENSION = "trial_extension"
 }
+/**
+ * Prefix that marks a provider-metadata key as FRAMEWORK-AUTHORITATIVE.
+ *
+ * ## Why a reserved namespace exists at all
+ *
+ * A provider checkout session carries ONE flat `metadata` map, and two parties want to write into
+ * it: the framework (which needs to recognise the purchase when the provider echoes the session
+ * back on `checkout.session.completed`) and the application's own caller (who legitimately wants
+ * to tag the purchase for their analytics or reconciliation).
+ *
+ * Those two writers do not have the same authority. The framework's entries decide WHICH billing
+ * account is credited and HOW MUCH — the provider replays them verbatim inside a genuinely SIGNED
+ * webhook, so a signature proves the provider sent them, never that the framework wrote them. The
+ * caller's entries decide nothing.
+ *
+ * Sharing one un-partitioned namespace between those two authorities is what turned a caller-supplied
+ * map into a credit-minting primitive: the producer spread caller metadata LAST, so `billingAccountId`
+ * / `productKey` / `quantity` were simply overwritable, and the webhook consumer read the result back
+ * as trusted framework state. Ordering alone is not the fix — swapping the spread leaves an
+ * unmarked namespace in which the NEXT authoritative key is one careless line from being overridable
+ * again. The prefix makes the trust boundary a property of the KEY, so it survives refactors.
+ *
+ * The boundary is enforced in three places, deliberately overlapping:
+ * 1. the OPEN_CHECKOUT request DTO REFUSES any caller key carrying this prefix (loud, at the edge);
+ * 2. the metadata builder writes the reserved entries LAST (structural, cannot be forgotten);
+ * 3. the webhook consumer reads ONLY reserved keys, and re-derives the billing account from
+ *    provider-authoritative data rather than trusting the echoed value.
+ *
+ * @see BillingCheckoutMetadataKey for the reserved key vocabulary itself.
+ */
+export declare const BILLING_RESERVED_METADATA_KEY_PREFIX = "wildo_";
+/**
+ * The closed vocabulary of framework-authoritative provider-metadata keys.
+ *
+ * Every member MUST start with {@link BILLING_RESERVED_METADATA_KEY_PREFIX} — that is what makes the
+ * DTO's caller-key refusal and the consumer's read-only-reserved rule line up. A member added
+ * without the prefix would be silently overridable by a caller, which is the whole defect this
+ * vocabulary exists to prevent, so a pinned test asserts the prefix across every member.
+ *
+ * Named rather than inlined because each member carries a different obligation on the consumer side
+ * (one is cross-checked against provider truth, one selects the product, one is bounded and
+ * strictly parsed) and a bare string literal has nowhere to record that.
+ */
+export declare enum BillingCheckoutMetadataKey {
+    /**
+     * The billing account the checkout was opened FOR.
+     *
+     * Written for traceability and cross-checking only. The webhook consumer re-derives the account
+     * from the provider-authoritative customer id on the event and REFUSES the event if the echoed
+     * value disagrees — it is never used as the account to credit.
+     */
+    BILLING_ACCOUNT_ID = "wildo_billingAccountId",
+    /** The catalog product key purchased — selects the credit pool and credits-per-unit on top-up. */
+    PRODUCT_KEY = "wildo_productKey",
+    /**
+     * The purchased quantity, as a decimal integer string (provider metadata values are strings).
+     * Strictly parsed and bounded by {@link BILLING_CHECKOUT_MAX_QUANTITY} on the way back in.
+     */
+    QUANTITY = "wildo_quantity"
+}
+/**
+ * Upper bound on a single checkout's line-item quantity, applied on BOTH sides of the provider
+ * round trip: the OPEN_CHECKOUT request DTO refuses more, and the webhook consumer refuses to
+ * honour more.
+ *
+ * One shared constant rather than two, because a consumer bound lower than the producer bound would
+ * silently refuse legitimate large purchases the framework itself allowed to be billed — the
+ * failure mode where the customer is charged and the credits never arrive.
+ *
+ * The value is a framework policy ceiling, not a provider-derived one: it is deliberately far above
+ * any plausible self-serve purchase and far below the range where an unbounded quantity becomes a
+ * credit-minting primitive. An application whose catalog genuinely sells in larger units should
+ * raise it here, where both sides read it, rather than at either end.
+ */
+export declare const BILLING_CHECKOUT_MAX_QUANTITY = 999999;
 //# sourceMappingURL=billing-enums.shared.schemas.d.ts.map

package/dist/esm/billing/billing-enums.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-enums.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/billing-enums.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAIzH;;;;;;;;;;;GAWG;AACH,oBAAY,WAAW;IACrB,gEAAgE;IAChE,IAAI,SAAS;IACb,6DAA6D;IAC7D,KAAK,UAAU;IACf,kEAAkE;IAClE,OAAO,YAAY;IACnB,6EAA6E;IAC7E,QAAQ,aAAa;IACrB,sEAAsE;IACtE,WAAW,gBAAgB;IAC3B,0EAA0E;IAC1E,IAAI,SAAS;CACd;AAED;;;;GAIG;AACH,oBAAY,cAAc;IACxB,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAID;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,iBAAiB,sBAAsB;IACvC,IAAI,SAAS;IACb,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,aAAa,kBAAkB;CAChC;AAMD;;GAEG;AACH,oBAAY,yBAAyB;IACnC,SAAS,cAAc;IACvB,kBAAkB,uBAAuB;CAC1C;AAED;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,MAAM,WAAW;CAClB;AAMD;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,gBAAgB,qBAAqB;IACrC,QAAQ,aAAa;CACtB;AAMD;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,aAAa,kBAAkB;CAChC;AAID;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC1B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;CACxB;AAID;;GAEG;AACH,oBAAY,aAAa;IACvB,sBAAsB;IACtB,MAAM,WAAW;IACjB,0BAA0B;IAC1B,cAAc,mBAAmB;IACjC,uBAAuB;IACvB,QAAQ,aAAa;IACrB,yBAAyB;IACzB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,UAAU,eAAe;IACzB,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,eAAe,oBAAoB;CACpC"}
+{"version":3,"file":"billing-enums.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/billing-enums.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAIzH;;;;;;;;;;;GAWG;AACH,oBAAY,WAAW;IACrB,gEAAgE;IAChE,IAAI,SAAS;IACb,6DAA6D;IAC7D,KAAK,UAAU;IACf,kEAAkE;IAClE,OAAO,YAAY;IACnB,6EAA6E;IAC7E,QAAQ,aAAa;IACrB,sEAAsE;IACtE,WAAW,gBAAgB;IAC3B,0EAA0E;IAC1E,IAAI,SAAS;CACd;AAED;;;;GAIG;AACH,oBAAY,cAAc;IACxB,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAID;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,iBAAiB,sBAAsB;IACvC,IAAI,SAAS;IACb,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,SAAS,cAAc;IACvB,aAAa,kBAAkB;CAChC;AAMD;;GAEG;AACH,oBAAY,yBAAyB;IACnC,SAAS,cAAc;IACvB,kBAAkB,uBAAuB;CAC1C;AAED;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,MAAM,WAAW;CAClB;AAMD;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,gBAAgB,qBAAqB;IACrC,QAAQ,aAAa;CACtB;AAMD;;;;;GAKG;AACH,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,aAAa,kBAAkB;CAChC;AAID;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC1B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;CACxB;AAID;;GAEG;AACH,oBAAY,aAAa;IACvB,sBAAsB;IACtB,MAAM,WAAW;IACjB,0BAA0B;IAC1B,cAAc,mBAAmB;IACjC,uBAAuB;IACvB,QAAQ,aAAa;IACrB,yBAAyB;IACzB,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,YAAY;IACtB,UAAU,eAAe;IACzB,YAAY,iBAAiB;CAC9B;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,eAAe,oBAAoB;CACpC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,oCAAoC,WAAW,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,oBAAY,0BAA0B;IACpC;;;;;;OAMG;IACH,kBAAkB,2BAA2B;IAC7C,kGAAkG;IAClG,WAAW,qBAAqB;IAChC;;;OAGG;IACH,QAAQ,mBAAmB;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,6BAA6B,SAAU,CAAC"}

package/dist/esm/billing/billing-enums.shared.schemas.js

@@ -196,4 +196,81 @@ export var ReferredRewardType;
     ReferredRewardType["FEATURE"] = "feature";
     ReferredRewardType["TRIAL_EXTENSION"] = "trial_extension";
 })(ReferredRewardType || (ReferredRewardType = {}));
-//# sourceMappingURL=billing-enums.shared.schemas.js.map
+// ── Provider checkout metadata: the framework/caller trust boundary ─────────────
+/**
+ * Prefix that marks a provider-metadata key as FRAMEWORK-AUTHORITATIVE.
+ *
+ * ## Why a reserved namespace exists at all
+ *
+ * A provider checkout session carries ONE flat `metadata` map, and two parties want to write into
+ * it: the framework (which needs to recognise the purchase when the provider echoes the session
+ * back on `checkout.session.completed`) and the application's own caller (who legitimately wants
+ * to tag the purchase for their analytics or reconciliation).
+ *
+ * Those two writers do not have the same authority. The framework's entries decide WHICH billing
+ * account is credited and HOW MUCH — the provider replays them verbatim inside a genuinely SIGNED
+ * webhook, so a signature proves the provider sent them, never that the framework wrote them. The
+ * caller's entries decide nothing.
+ *
+ * Sharing one un-partitioned namespace between those two authorities is what turned a caller-supplied
+ * map into a credit-minting primitive: the producer spread caller metadata LAST, so `billingAccountId`
+ * / `productKey` / `quantity` were simply overwritable, and the webhook consumer read the result back
+ * as trusted framework state. Ordering alone is not the fix — swapping the spread leaves an
+ * unmarked namespace in which the NEXT authoritative key is one careless line from being overridable
+ * again. The prefix makes the trust boundary a property of the KEY, so it survives refactors.
+ *
+ * The boundary is enforced in three places, deliberately overlapping:
+ * 1. the OPEN_CHECKOUT request DTO REFUSES any caller key carrying this prefix (loud, at the edge);
+ * 2. the metadata builder writes the reserved entries LAST (structural, cannot be forgotten);
+ * 3. the webhook consumer reads ONLY reserved keys, and re-derives the billing account from
+ *    provider-authoritative data rather than trusting the echoed value.
+ *
+ * @see BillingCheckoutMetadataKey for the reserved key vocabulary itself.
+ */
+export const BILLING_RESERVED_METADATA_KEY_PREFIX = 'wildo_';
+/**
+ * The closed vocabulary of framework-authoritative provider-metadata keys.
+ *
+ * Every member MUST start with {@link BILLING_RESERVED_METADATA_KEY_PREFIX} — that is what makes the
+ * DTO's caller-key refusal and the consumer's read-only-reserved rule line up. A member added
+ * without the prefix would be silently overridable by a caller, which is the whole defect this
+ * vocabulary exists to prevent, so a pinned test asserts the prefix across every member.
+ *
+ * Named rather than inlined because each member carries a different obligation on the consumer side
+ * (one is cross-checked against provider truth, one selects the product, one is bounded and
+ * strictly parsed) and a bare string literal has nowhere to record that.
+ */
+export var BillingCheckoutMetadataKey;
+(function (BillingCheckoutMetadataKey) {
+    /**
+     * The billing account the checkout was opened FOR.
+     *
+     * Written for traceability and cross-checking only. The webhook consumer re-derives the account
+     * from the provider-authoritative customer id on the event and REFUSES the event if the echoed
+     * value disagrees — it is never used as the account to credit.
+     */
+    BillingCheckoutMetadataKey["BILLING_ACCOUNT_ID"] = "wildo_billingAccountId";
+    /** The catalog product key purchased — selects the credit pool and credits-per-unit on top-up. */
+    BillingCheckoutMetadataKey["PRODUCT_KEY"] = "wildo_productKey";
+    /**
+     * The purchased quantity, as a decimal integer string (provider metadata values are strings).
+     * Strictly parsed and bounded by {@link BILLING_CHECKOUT_MAX_QUANTITY} on the way back in.
+     */
+    BillingCheckoutMetadataKey["QUANTITY"] = "wildo_quantity";
+})(BillingCheckoutMetadataKey || (BillingCheckoutMetadataKey = {}));
+/**
+ * Upper bound on a single checkout's line-item quantity, applied on BOTH sides of the provider
+ * round trip: the OPEN_CHECKOUT request DTO refuses more, and the webhook consumer refuses to
+ * honour more.
+ *
+ * One shared constant rather than two, because a consumer bound lower than the producer bound would
+ * silently refuse legitimate large purchases the framework itself allowed to be billed — the
+ * failure mode where the customer is charged and the credits never arrive.
+ *
+ * The value is a framework policy ceiling, not a provider-derived one: it is deliberately far above
+ * any plausible self-serve purchase and far below the range where an unbounded quantity becomes a
+ * credit-minting primitive. An application whose catalog genuinely sells in larger units should
+ * raise it here, where both sides read it, rather than at either end.
+ */
+export const BILLING_CHECKOUT_MAX_QUANTITY = 999_999;
+//# sourceMappingURL=billing-enums.shared.schemas.js.map

package/dist/esm/billing/billing-enums.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing-enums.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/billing-enums.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"billing-enums.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/billing-enums.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Billing Enums (Shared)\n *\n * All billing-system enums used across backend, frontend, and shared models.\n * These supersede the legacy enums from billing.shared.schemas.ts.\n *\n * Enums shared with the standard billing interface (PricingModel, BillingInterval,\n * TaxDisplayMode, SubscriptionStatus) are defined in @wildo-ai/external-connectors-models\n * and re-exported here for convenience.\n *\n * @see billing-and-features-system.md §6 (Billing Schemas)\n */\n\nexport { PricingModel, BillingInterval, TaxDisplayMode, SubscriptionStatus } from '@wildo-ai/external-connectors-models';\n\n// ── Product & Pricing ──────────────────────────────────────────────\n\n/**\n * Product types available in the billing catalog.\n *\n * | Type        | Creates subscription? | Repeatable? | Grants features? | Usage tracked? |\n * |-------------|----------------------|-------------|------------------|----------------|\n * | PLAN        | Yes (exclusive)      | No (switch) | Yes              | No             |\n * | ADDON       | Yes (stackable)      | No (toggle) | Yes              | No             |\n * | METERED     | Yes                  | No          | Optional         | Yes            |\n * | ONE_TIME    | No                   | No (once)   | Optional         | No             |\n * | CREDIT_PACK | No                   | Yes         | No (credits)     | Credits-based  |\n * | ITEM        | No                   | Yes         | Optional         | No             |\n */\nexport enum ProductType {\n  /** Subscription plan, mutually exclusive per billing account */\n  PLAN = 'plan',\n  /** Optional subscription add-on, stackable on top of plan */\n  ADDON = 'addon',\n  /** Usage-based subscription (consumption reported to provider) */\n  METERED = 'metered',\n  /** Single purchase, once per billing account (e.g., setup fee, migration) */\n  ONE_TIME = 'one_time',\n  /** Buy a pack of credits/tokens (repeatable, consumable over time) */\n  CREDIT_PACK = 'credit_pack',\n  /** Purchasable item, repeatable (e.g., report generation, data export) */\n  ITEM = 'item',\n}\n\n/**\n * Limit grant mode: how this product's limits compose with other products.\n * - SET: absolute value (replaces, used for PLAN base limits)\n * - ADD: additive (stacks on top, used for ADDON bonus limits)\n */\nexport enum LimitGrantMode {\n  SET = 'set',\n  ADD = 'add',\n}\n\n// ── Billing Lifecycle ──────────────────────────────────────────────\n\n/**\n * Proration behavior for plan changes (upgrade/downgrade).\n */\nexport enum ProrationBehavior {\n  CREATE_PRORATIONS = 'create_prorations',\n  NONE = 'none',\n  ALWAYS_INVOICE = 'always_invoice',\n}\n\n/**\n * Billing timing: when to apply plan changes.\n */\nexport enum BillingTiming {\n  IMMEDIATE = 'immediate',\n  AT_PERIOD_END = 'at_period_end',\n}\n\n// BillingInterval: re-exported from @wildo-ai/external-connectors-models (see top of file)\n\n// ── Metering & Usage ───────────────────────────────────────────────\n\n/**\n * Metering aggregation window for usage records.\n */\nexport enum MeteringAggregationWindow {\n  PER_FLUSH = 'per_flush',\n  PER_BILLING_PERIOD = 'per_billing_period',\n}\n\n/**\n * Usage aggregation type for metered prices.\n */\nexport enum UsageAggregationType {\n  SUM = 'sum',\n  MAX = 'max',\n  LAST = 'last',\n}\n\n/**\n * Usage record source type.\n */\nexport enum UsageSourceType {\n  OPERATION = 'operation',\n  RESOURCE_COUNT = 'resource_count',\n  CUSTOM = 'custom',\n}\n\n// ── Tax ────────────────────────────────────────────────────────────\n\n// TaxDisplayMode: re-exported from @wildo-ai/external-connectors-models (see top of file)\n\n/**\n * Tax calculation mode: provider-managed or disabled.\n */\nexport enum TaxCalculationMode {\n  PROVIDER_MANAGED = 'provider_managed',\n  DISABLED = 'disabled',\n}\n\n// ── Subscription & Invoice Status ──────────────────────────────────\n\n// SubscriptionStatus: re-exported from @wildo-ai/external-connectors-models (see top of file)\n\n/**\n * Invoice status values (maps to Stripe invoice statuses).\n *\n * Invoices are created and managed entirely by the billing provider.\n * We store a thin reference for status tracking and quick display.\n */\nexport enum InvoiceStatus {\n  DRAFT = 'draft',\n  OPEN = 'open',\n  PAID = 'paid',\n  VOID = 'void',\n  UNCOLLECTIBLE = 'uncollectible',\n}\n\n// ── Billing Scope ──────────────────────────────────────────────────\n\n/**\n * Billing-compatible scope types.\n * Subset of ResourcePrimaryScope — excludes APPLICATION which has no billing variants.\n * Used by scope-agnostic billing resources (e.g., Referrals) that reference\n * billing accounts across different polymorphic collections.\n */\nexport enum BillingScopeType {\n  ORGANIZATIONS = 'organizations',\n  USER_SELF = 'user_self',\n}\n\n// ── Promotions & Referrals ─────────────────────────────────────────\n\n/**\n * Promotion type.\n */\nexport enum PromotionType {\n  /** Direct discount */\n  COUPON = 'coupon',\n  /** Code-based discount */\n  PROMOTION_CODE = 'promotion_code',\n  /** Referral program */\n  REFERRAL = 'referral',\n  /** Special deal/offer */\n  DEAL = 'deal',\n}\n\n/**\n * Discount type for promotions.\n */\nexport enum DiscountType {\n  PERCENTAGE = 'percentage',\n  FIXED_AMOUNT = 'fixed_amount',\n}\n\n/**\n * Promotion duration (how long the discount applies).\n */\nexport enum PromotionDuration {\n  ONCE = 'once',\n  REPEATING = 'repeating',\n  FOREVER = 'forever',\n}\n\n/**\n * Referral status lifecycle.\n */\nexport enum ReferralStatus {\n  PENDING = 'pending',\n  ACCEPTED = 'accepted',\n  CONVERTED = 'converted',\n  EXPIRED = 'expired',\n  CANCELLED = 'cancelled',\n}\n\n/**\n * Reward type for the referrer (person who referred).\n */\nexport enum ReferrerRewardType {\n  CREDIT = 'credit',\n  DISCOUNT = 'discount',\n  FEATURE = 'feature',\n  COMMISSION = 'commission',\n}\n\n/**\n * Reward type for the referred (new customer).\n */\nexport enum ReferredRewardType {\n  CREDIT = 'credit',\n  DISCOUNT = 'discount',\n  FEATURE = 'feature',\n  TRIAL_EXTENSION = 'trial_extension',\n}\n\n// ── Provider checkout metadata: the framework/caller trust boundary ─────────────\n\n/**\n * Prefix that marks a provider-metadata key as FRAMEWORK-AUTHORITATIVE.\n *\n * ## Why a reserved namespace exists at all\n *\n * A provider checkout session carries ONE flat `metadata` map, and two parties want to write into\n * it: the framework (which needs to recognise the purchase when the provider echoes the session\n * back on `checkout.session.completed`) and the application's own caller (who legitimately wants\n * to tag the purchase for their analytics or reconciliation).\n *\n * Those two writers do not have the same authority. The framework's entries decide WHICH billing\n * account is credited and HOW MUCH — the provider replays them verbatim inside a genuinely SIGNED\n * webhook, so a signature proves the provider sent them, never that the framework wrote them. The\n * caller's entries decide nothing.\n *\n * Sharing one un-partitioned namespace between those two authorities is what turned a caller-supplied\n * map into a credit-minting primitive: the producer spread caller metadata LAST, so `billingAccountId`\n * / `productKey` / `quantity` were simply overwritable, and the webhook consumer read the result back\n * as trusted framework state. Ordering alone is not the fix — swapping the spread leaves an\n * unmarked namespace in which the NEXT authoritative key is one careless line from being overridable\n * again. The prefix makes the trust boundary a property of the KEY, so it survives refactors.\n *\n * The boundary is enforced in three places, deliberately overlapping:\n * 1. the OPEN_CHECKOUT request DTO REFUSES any caller key carrying this prefix (loud, at the edge);\n * 2. the metadata builder writes the reserved entries LAST (structural, cannot be forgotten);\n * 3. the webhook consumer reads ONLY reserved keys, and re-derives the billing account from\n *    provider-authoritative data rather than trusting the echoed value.\n *\n * @see BillingCheckoutMetadataKey for the reserved key vocabulary itself.\n */\nexport const BILLING_RESERVED_METADATA_KEY_PREFIX = 'wildo_';\n\n/**\n * The closed vocabulary of framework-authoritative provider-metadata keys.\n *\n * Every member MUST start with {@link BILLING_RESERVED_METADATA_KEY_PREFIX} — that is what makes the\n * DTO's caller-key refusal and the consumer's read-only-reserved rule line up. A member added\n * without the prefix would be silently overridable by a caller, which is the whole defect this\n * vocabulary exists to prevent, so a pinned test asserts the prefix across every member.\n *\n * Named rather than inlined because each member carries a different obligation on the consumer side\n * (one is cross-checked against provider truth, one selects the product, one is bounded and\n * strictly parsed) and a bare string literal has nowhere to record that.\n */\nexport enum BillingCheckoutMetadataKey {\n  /**\n   * The billing account the checkout was opened FOR.\n   *\n   * Written for traceability and cross-checking only. The webhook consumer re-derives the account\n   * from the provider-authoritative customer id on the event and REFUSES the event if the echoed\n   * value disagrees — it is never used as the account to credit.\n   */\n  BILLING_ACCOUNT_ID = 'wildo_billingAccountId',\n  /** The catalog product key purchased — selects the credit pool and credits-per-unit on top-up. */\n  PRODUCT_KEY = 'wildo_productKey',\n  /**\n   * The purchased quantity, as a decimal integer string (provider metadata values are strings).\n   * Strictly parsed and bounded by {@link BILLING_CHECKOUT_MAX_QUANTITY} on the way back in.\n   */\n  QUANTITY = 'wildo_quantity',\n}\n\n/**\n * Upper bound on a single checkout's line-item quantity, applied on BOTH sides of the provider\n * round trip: the OPEN_CHECKOUT request DTO refuses more, and the webhook consumer refuses to\n * honour more.\n *\n * One shared constant rather than two, because a consumer bound lower than the producer bound would\n * silently refuse legitimate large purchases the framework itself allowed to be billed — the\n * failure mode where the customer is charged and the credits never arrive.\n *\n * The value is a framework policy ceiling, not a provider-derived one: it is deliberately far above\n * any plausible self-serve purchase and far below the range where an unbounded quantity becomes a\n * credit-minting primitive. An application whose catalog genuinely sells in larger units should\n * raise it here, where both sides read it, rather than at either end.\n */\nexport const BILLING_CHECKOUT_MAX_QUANTITY = 999_999;\n"]}

package/dist/esm/billing/billing-types.shared.schemas.d.ts

@@ -7,14 +7,9 @@
  *
  * @see billing-and-features-system.md §6.2c (Supporting Types)
  */
+import { z } from 'zod';
 import type { MoneyValue } from '@wildo-ai/zod-decorators';
-import type { BillingAccount } from './billing-account.shared.schemas.js';
-import type { BillingSubscriptionBase } from './subscription.shared.schemas.js';
-import type { Product } from './product.shared.schemas.js';
-import type { Price } from './price.shared.schemas.js';
-import type { InvoiceRef } from './invoice-ref.shared.schemas.js';
-import type { Promotion } from './promotions.shared.schemas.js';
-import type { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas';
 export type { StandardBilling_SubscriptionData, StandardBilling_InvoicePreview } from '@wildo-ai/external-connectors-models';
 /**
  * Invoice preview: returned by previewPlanChange() to show prorated cost before committing.
@@ -38,44 +33,211 @@ export interface InvoicePreview {
 /**
  * Usage summary: aggregated usage data for the frontend UsageDashboard.
  * Computed from UsageRecords, keyed by metered product key.
+ *
+ * Authored as a Zod schema (not a bare interface) so it can compose into
+ * `BillingStateResponseSchema` — the runtime contract wired as the `GET_STATE`
+ * custom operation's `customResponseDto`. `UsageSummary` is derived from it to
+ * keep the type and the runtime shape from drifting.
  */
-export interface UsageSummary {
-    /** Usage per metered product, keyed by product key */
-    byProduct: Record<string, {
-        currentPeriodUsage: number;
-        /** Previous period (for trend display) */
-        previousPeriodUsage?: number;
-        /** Usage limit (from product/subscription, if applicable) */
-        limit?: number;
-        /** Last usage recorded at */
-        lastRecordedAt?: Date;
-    }>;
-}
+export declare const UsageSummarySchema: z.ZodObject<{
+    byProduct: z.ZodRecord<z.ZodString, z.ZodObject<{
+        currentPeriodUsage: z.ZodNumber;
+        previousPeriodUsage: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        lastRecordedAt: z.ZodOptional<z.ZodDate>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UsageSummary = z.infer<typeof UsageSummarySchema>;
+/**
+ * Per-pool credit balance projection embedded in the aggregated billing state.
+ *
+ * A lean view (NOT the full `CreditPool` resource) built by the billing-state
+ * facade purely for the frontend balance display, keyed by pool key.
+ */
+export declare const CreditPoolBalanceSchema: z.ZodObject<{
+    available: z.ZodNumber;
+    totalPurchased: z.ZodNumber;
+    totalConsumed: z.ZodNumber;
+}, z.core.$strip>;
+export type CreditPoolBalance = z.infer<typeof CreditPoolBalanceSchema>;
 /**
  * Aggregated billing state returned by the lazy facade endpoint.
  * Single source of truth for frontend BillingProvider and backend controller.
+ *
+ * Authored as a Zod schema (not a bare interface) because the `GET_STATE`
+ * custom operation wires it as its `customResponseDto`. That operation borrows
+ * the COUNT verb for its route/verb via `resourceOperationLike` but returns
+ * THIS aggregated shape — so without a `customResponseDto` the DTO builder would
+ * assign it the COUNT default envelope (`{ count }`), and the service output
+ * would fail `transformOutput`'s `internalDto.parse` → HTTP 500. The composed
+ * schema gives the builder the real runtime contract to validate against and to
+ * project the external response. `BillingStateResponse` is derived from it so the
+ * type and the runtime contract cannot drift.
  */
-export interface BillingStateResponse {
-    billingAccount: BillingAccount | null;
-    subscription: BillingSubscriptionBase | null;
-    products: Product[];
-    prices: Price[];
-    invoices: InvoiceRef[];
-    usage: UsageSummary;
-    creditPools: Record<string, {
-        available: number;
-        totalPurchased: number;
-        totalConsumed: number;
-    }>;
-    /**
-     * Scope/product-visible promotions for the current billing surface.
-     *
-     * This list intentionally excludes promotions that are inactive, exhausted,
-     * unsynced with the billing provider, or targeted only at products outside the
-     * current scope. It is not a promise that every entry is redeemable for any
-     * arbitrary checkout item the user might pick next.
-     */
-    activePromotions: Promotion[];
-    scopeType: ResourcePrimaryScope;
-}
+export declare const BillingStateResponseSchema: z.ZodObject<{
+    billingAccount: z.ZodNullable<z.ZodObject<{
+        _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        providerCustomerId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
+        providerRef: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+        updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    }, z.core.$strip>>;
+    subscription: z.ZodNullable<z.ZodObject<{
+        _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        billingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
+        status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/external-connectors-models").SubscriptionStatus>>>>>;
+        items: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodArray<z.ZodObject<{
+            _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+            productId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+            priceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+            quantity: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodNumber>>;
+            providerSubscriptionItemId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        currentPeriodStart: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDate>>;
+        currentPeriodEnd: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDate>>>;
+        trialStart: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>;
+        trialEnd: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>>;
+        cancelAtPeriodEnd: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+        cancelledAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>;
+        cancellationReason: z.ZodOptional<z.ZodString>;
+        discount: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodObject<{
+            providerCouponId: z.ZodOptional<z.ZodString>;
+            percentOff: z.ZodOptional<z.ZodNumber>;
+            amountOff: z.ZodOptional<z.ZodNumber>;
+            currency: z.ZodOptional<z.ZodString>;
+            duration: z.ZodOptional<z.ZodString>;
+            durationInMonths: z.ZodOptional<z.ZodNumber>;
+            end: z.ZodOptional<z.ZodDate>;
+        }, z.core.$strip>>>;
+        providerSubscriptionId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+        updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    }, z.core.$strip>>;
+    products: z.ZodArray<z.ZodObject<{
+        _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./billing-enums.shared.schemas").ProductType>>>>>;
+        key: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
+        targetScopes: z.ZodArray<z.ZodEnum<typeof ResourcePrimaryScope>>;
+        grantedFeatures: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        grantedLimits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            value: z.ZodNumber;
+            mode: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").LimitGrantMode>>;
+        }, z.core.$strip>>>>;
+        planTier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        planTierOrder: z.ZodOptional<z.ZodNumber>;
+        requiredPlanTiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        taxDisplayMode: z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/external-connectors-models").TaxDisplayMode>>;
+        purchaseConfig: z.ZodOptional<z.ZodObject<{
+            maxQuantityPerPurchase: z.ZodOptional<z.ZodNumber>;
+            creditsPerUnit: z.ZodOptional<z.ZodNumber>;
+            creditPoolKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        behaviorPolicy: z.ZodOptional<z.ZodObject<{
+            trial: z.ZodOptional<z.ZodObject<{
+                days: z.ZodDefault<z.ZodNumber>;
+                requirePaymentMethod: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            upgrade: z.ZodOptional<z.ZodObject<{
+                proration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").ProrationBehavior>>;
+                timing: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").BillingTiming>>;
+            }, z.core.$strip>>;
+            downgrade: z.ZodOptional<z.ZodObject<{
+                proration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").ProrationBehavior>>;
+                timing: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").BillingTiming>>;
+            }, z.core.$strip>>;
+            cancellation: z.ZodOptional<z.ZodObject<{
+                allowImmediate: z.ZodDefault<z.ZodBoolean>;
+                defaultBehavior: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").BillingTiming>>;
+            }, z.core.$strip>>;
+            metering: z.ZodOptional<z.ZodObject<{
+                flushIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+                aggregationWindow: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").MeteringAggregationWindow>>;
+                preFlushAggregation: z.ZodDefault<z.ZodBoolean>;
+                retryPolicy: z.ZodDefault<z.ZodObject<{
+                    maxRetries: z.ZodDefault<z.ZodNumber>;
+                    backoffMultiplier: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        providerProductId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        sortOrder: z.ZodDefault<z.ZodNumber>;
+        isPublic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+        isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+        updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    }, z.core.$strip>>;
+    prices: z.ZodArray<z.ZodObject<{
+        _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        productId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        model: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("@wildo-ai/external-connectors-models").PricingModel>>>;
+        unitPrice: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+        interval: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/external-connectors-models").BillingInterval>>>;
+        intervalCount: z.ZodDefault<z.ZodNumber>;
+        tiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            upTo: z.ZodNullable<z.ZodNumber>;
+            unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+            flatPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+        }, z.core.$strip>>>;
+        packageSize: z.ZodOptional<z.ZodNumber>;
+        usageAggregation: z.ZodOptional<z.ZodEnum<typeof import("./billing-enums.shared.schemas").UsageAggregationType>>;
+        taxBehavior: z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/external-connectors-models").TaxDisplayMode>>;
+        providerPriceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        isDefault: z.ZodDefault<z.ZodBoolean>;
+        isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+        createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    }, z.core.$strip>>;
+    invoices: z.ZodArray<z.ZodObject<{
+        _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        billingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./billing-enums.shared.schemas").InvoiceStatus>>>>;
+        total: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>>;
+        hostedInvoiceUrl: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
+        invoicePdfUrl: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
+        providerInvoiceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+        createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+        updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    }, z.core.$strip>>;
+    usage: z.ZodObject<{
+        byProduct: z.ZodRecord<z.ZodString, z.ZodObject<{
+            currentPeriodUsage: z.ZodNumber;
+            previousPeriodUsage: z.ZodOptional<z.ZodNumber>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            lastRecordedAt: z.ZodOptional<z.ZodDate>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    creditPools: z.ZodRecord<z.ZodString, z.ZodObject<{
+        available: z.ZodNumber;
+        totalPurchased: z.ZodNumber;
+        totalConsumed: z.ZodNumber;
+    }, z.core.$strip>>;
+    activePromotions: z.ZodArray<z.ZodObject<{
+        _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+        type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./billing-enums.shared.schemas").PromotionType>>>>;
+        name: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        code: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        discountType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./billing-enums.shared.schemas").DiscountType>>>;
+        discountPercentage: z.ZodOptional<z.ZodNumber>;
+        discountFixedAmount: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+        duration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").PromotionDuration>>;
+        durationInMonths: z.ZodOptional<z.ZodNumber>;
+        applicableProducts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        maxRedemptions: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        timesRedeemed: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodNumber>>;
+        validFrom: z.ZodOptional<z.ZodDate>;
+        validUntil: z.ZodOptional<z.ZodDate>;
+        isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+        providerCouponId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        providerPromotionId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+        updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    }, z.core.$strip>>;
+    scopeType: z.ZodEnum<typeof ResourcePrimaryScope>;
+}, z.core.$strip>;
+export type BillingStateResponse = z.infer<typeof BillingStateResponseSchema>;
 //# sourceMappingURL=billing-types.shared.schemas.d.ts.map

package/dist/esm/billing/billing-types.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-types.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/billing-types.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAMlF,YAAY,EAAE,gCAAgC,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAI7H;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,KAAK,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,wCAAwC;IACxC,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAID;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,0CAA0C;QAC1C,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,6DAA6D;QAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,6BAA6B;QAC7B,cAAc,CAAC,EAAE,IAAI,CAAC;KACvB,CAAC,CAAC;CACJ;AAID;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClG;;;;;;;OAOG;IACH,gBAAgB,EAAE,SAAS,EAAE,CAAC;IAC9B,SAAS,EAAE,oBAAoB,CAAC;CACjC"}
+{"version":3,"file":"billing-types.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/billing-types.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAO3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAM7E,YAAY,EAAE,gCAAgC,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AAI7H;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,4DAA4D;IAC5D,SAAS,EAAE,KAAK,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,UAAU,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,wCAAwC;IACxC,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAc7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/esm/billing/billing-types.shared.schemas.js

@@ -7,4 +7,79 @@
  *
  * @see billing-and-features-system.md §6.2c (Supporting Types)
  */
-//# sourceMappingURL=billing-types.shared.schemas.js.map
+import { z } from 'zod';
+import { BillingAccountSchema } from './billing-account.shared.schemas.js';
+import { BillingSubscriptionBaseSchema } from './subscription.shared.schemas.js';
+import { ProductSchema } from './product.shared.schemas.js';
+import { PriceSchema } from './price.shared.schemas.js';
+import { InvoiceRefSchema } from './invoice-ref.shared.schemas.js';
+import { PromotionSchema } from './promotions.shared.schemas.js';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+// ── Usage Summary ──────────────────────────────────────────────────
+/**
+ * Usage summary: aggregated usage data for the frontend UsageDashboard.
+ * Computed from UsageRecords, keyed by metered product key.
+ *
+ * Authored as a Zod schema (not a bare interface) so it can compose into
+ * `BillingStateResponseSchema` — the runtime contract wired as the `GET_STATE`
+ * custom operation's `customResponseDto`. `UsageSummary` is derived from it to
+ * keep the type and the runtime shape from drifting.
+ */
+export const UsageSummarySchema = z.object({
+    /** Usage per metered product, keyed by product key */
+    byProduct: z.record(z.string(), z.object({
+        currentPeriodUsage: z.number(),
+        /** Previous period (for trend display) */
+        previousPeriodUsage: z.number().optional(),
+        /** Usage limit (from product/subscription, if applicable) */
+        limit: z.number().optional(),
+        /** Last usage recorded at */
+        lastRecordedAt: z.date().optional(),
+    })),
+});
+// ── Billing State Response ─────────────────────────────────────────
+/**
+ * Per-pool credit balance projection embedded in the aggregated billing state.
+ *
+ * A lean view (NOT the full `CreditPool` resource) built by the billing-state
+ * facade purely for the frontend balance display, keyed by pool key.
+ */
+export const CreditPoolBalanceSchema = z.object({
+    available: z.number(),
+    totalPurchased: z.number(),
+    totalConsumed: z.number(),
+});
+/**
+ * Aggregated billing state returned by the lazy facade endpoint.
+ * Single source of truth for frontend BillingProvider and backend controller.
+ *
+ * Authored as a Zod schema (not a bare interface) because the `GET_STATE`
+ * custom operation wires it as its `customResponseDto`. That operation borrows
+ * the COUNT verb for its route/verb via `resourceOperationLike` but returns
+ * THIS aggregated shape — so without a `customResponseDto` the DTO builder would
+ * assign it the COUNT default envelope (`{ count }`), and the service output
+ * would fail `transformOutput`'s `internalDto.parse` → HTTP 500. The composed
+ * schema gives the builder the real runtime contract to validate against and to
+ * project the external response. `BillingStateResponse` is derived from it so the
+ * type and the runtime contract cannot drift.
+ */
+export const BillingStateResponseSchema = z.object({
+    billingAccount: BillingAccountSchema.nullable(),
+    subscription: BillingSubscriptionBaseSchema.nullable(),
+    products: z.array(ProductSchema),
+    prices: z.array(PriceSchema),
+    invoices: z.array(InvoiceRefSchema),
+    usage: UsageSummarySchema,
+    creditPools: z.record(z.string(), CreditPoolBalanceSchema),
+    /**
+     * Scope/product-visible promotions for the current billing surface.
+     *
+     * This list intentionally excludes promotions that are inactive, exhausted,
+     * unsynced with the billing provider, or targeted only at products outside the
+     * current scope. It is not a promise that every entry is redeemable for any
+     * arbitrary checkout item the user might pick next.
+     */
+    activePromotions: z.array(PromotionSchema),
+    scopeType: z.enum(ResourcePrimaryScope),
+});
+//# sourceMappingURL=billing-types.shared.schemas.js.map

package/dist/esm/billing/billing-types.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing-types.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/billing-types.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"billing-types.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/billing-types.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AA8B7E,sEAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,sDAAsD;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,CACjB,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC;QACP,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC9B,0CAA0C;QAC1C,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1C,6DAA6D;QAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,6BAA6B;QAC7B,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC,CACH;CACF,CAAC,CAAC;AAGH,sEAAsE;AAEtE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1B,CAAC,CAAC;AAGH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,cAAc,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC/C,YAAY,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IACtD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACnC,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC;IAC1D;;;;;;;OAOG;IACH,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;CACxC,CAAC,CAAC","sourcesContent":["/**\n * Billing Supporting Types (Shared)\n *\n * Types used by the billing API, frontend hooks, and provider interface.\n * These are NOT DB schemas — they are API response shapes, provider abstractions,\n * and aggregated views.\n *\n * @see billing-and-features-system.md §6.2c (Supporting Types)\n */\n\nimport { z } from 'zod';\nimport type { MoneyValue } from '@wildo-ai/zod-decorators';\nimport { BillingAccountSchema } from './billing-account.shared.schemas';\nimport { BillingSubscriptionBaseSchema } from './subscription.shared.schemas';\nimport { ProductSchema } from './product.shared.schemas';\nimport { PriceSchema } from './price.shared.schemas';\nimport { InvoiceRefSchema } from './invoice-ref.shared.schemas';\nimport { PromotionSchema } from './promotions.shared.schemas';\nimport { ResourcePrimaryScope } from '../resources/resources.shared.schemas';\n\n// ── Provider Canonical Types ───────────────────────────────────────\n// StandardBilling_SubscriptionData and StandardBilling_InvoicePreview are\n// defined in @wildo-ai/external-connectors-models (standard billing interface)\n// and re-exported here for convenience.\nexport type { StandardBilling_SubscriptionData, StandardBilling_InvoicePreview } from '@wildo-ai/external-connectors-models';\n\n// ── Invoice Preview ────────────────────────────────────────────────\n\n/**\n * Invoice preview: returned by previewPlanChange() to show prorated cost before committing.\n * Data comes from provider (Stripe's upcoming invoice API), NOT stored locally.\n *\n * All monetary amounts use MoneyValue for bigint precision and self-contained currency.\n */\nexport interface InvoicePreview {\n  /** Prorated amount to charge/credit */\n  amount: MoneyValue;\n  /** Line items breakdown (what changed, prorated amounts) */\n  lineItems: Array<{\n    description: string;\n    amount: MoneyValue;\n    quantity: number;\n  }>;\n  /** When this amount would be charged */\n  periodStart: Date;\n  periodEnd: Date;\n}\n\n// ── Usage Summary ──────────────────────────────────────────────────\n\n/**\n * Usage summary: aggregated usage data for the frontend UsageDashboard.\n * Computed from UsageRecords, keyed by metered product key.\n *\n * Authored as a Zod schema (not a bare interface) so it can compose into\n * `BillingStateResponseSchema` — the runtime contract wired as the `GET_STATE`\n * custom operation's `customResponseDto`. `UsageSummary` is derived from it to\n * keep the type and the runtime shape from drifting.\n */\nexport const UsageSummarySchema = z.object({\n  /** Usage per metered product, keyed by product key */\n  byProduct: z.record(\n    z.string(),\n    z.object({\n      currentPeriodUsage: z.number(),\n      /** Previous period (for trend display) */\n      previousPeriodUsage: z.number().optional(),\n      /** Usage limit (from product/subscription, if applicable) */\n      limit: z.number().optional(),\n      /** Last usage recorded at */\n      lastRecordedAt: z.date().optional(),\n    }),\n  ),\n});\nexport type UsageSummary = z.infer<typeof UsageSummarySchema>;\n\n// ── Billing State Response ─────────────────────────────────────────\n\n/**\n * Per-pool credit balance projection embedded in the aggregated billing state.\n *\n * A lean view (NOT the full `CreditPool` resource) built by the billing-state\n * facade purely for the frontend balance display, keyed by pool key.\n */\nexport const CreditPoolBalanceSchema = z.object({\n  available: z.number(),\n  totalPurchased: z.number(),\n  totalConsumed: z.number(),\n});\nexport type CreditPoolBalance = z.infer<typeof CreditPoolBalanceSchema>;\n\n/**\n * Aggregated billing state returned by the lazy facade endpoint.\n * Single source of truth for frontend BillingProvider and backend controller.\n *\n * Authored as a Zod schema (not a bare interface) because the `GET_STATE`\n * custom operation wires it as its `customResponseDto`. That operation borrows\n * the COUNT verb for its route/verb via `resourceOperationLike` but returns\n * THIS aggregated shape — so without a `customResponseDto` the DTO builder would\n * assign it the COUNT default envelope (`{ count }`), and the service output\n * would fail `transformOutput`'s `internalDto.parse` → HTTP 500. The composed\n * schema gives the builder the real runtime contract to validate against and to\n * project the external response. `BillingStateResponse` is derived from it so the\n * type and the runtime contract cannot drift.\n */\nexport const BillingStateResponseSchema = z.object({\n  billingAccount: BillingAccountSchema.nullable(),\n  subscription: BillingSubscriptionBaseSchema.nullable(),\n  products: z.array(ProductSchema),\n  prices: z.array(PriceSchema),\n  invoices: z.array(InvoiceRefSchema),\n  usage: UsageSummarySchema,\n  creditPools: z.record(z.string(), CreditPoolBalanceSchema),\n  /**\n   * Scope/product-visible promotions for the current billing surface.\n   *\n   * This list intentionally excludes promotions that are inactive, exhausted,\n   * unsynced with the billing provider, or targeted only at products outside the\n   * current scope. It is not a promise that every entry is redeemable for any\n   * arbitrary checkout item the user might pick next.\n   */\n  activePromotions: z.array(PromotionSchema),\n  scopeType: z.enum(ResourcePrimaryScope),\n});\nexport type BillingStateResponse = z.infer<typeof BillingStateResponseSchema>;\n"]}