@happyvertical/smrt-subscriptions 0.51.19 → 0.51.24

package/dist/models/commercial.d.ts

@@ -1,7 +1,22 @@
 import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
 export type PricingStrategy = 'fixed_unit' | 'cost_plus' | 'multiplier' | 'tiered' | 'included_overage' | 'flat' | 'custom';
 export type SpendingPolicyBehavior = 'observe' | 'warn' | 'block' | 'approval_required';
-export type SpendingPeriod = 'day' | 'week' | 'month' | 'year' | 'rolling';
+/**
+ * `balance` is a prepaid credit balance: the policy's limit is the sum of its
+ * {@link CreditGrant}s and spend accumulates from `balanceFrom` onward.
+ */
+export type SpendingPeriod = 'day' | 'week' | 'month' | 'year' | 'rolling' | 'balance';
+/**
+ * Which charges a spending policy counts (#3059).
+ *
+ * - `billed`: provider charges payable by the policy tenant (`ClientCharge`
+ *   rows whose `tenantId` is the tenant) — the pre-#3059 behavior.
+ * - `retail`: what the tenant owes its reseller (`RetailCharge` rows).
+ * - `wholesale`: what the policy's parent (`setByTenantId`) pays the provider
+ *   for this tenant's usage (`ClientCharge` rows billed to the parent with
+ *   `usageTenantId` = the tenant). Requires a delegated policy.
+ */
+export type SpendingBasis = 'billed' | 'retail' | 'wholesale';
 export declare class PricingRule extends SmrtObject {
     tenantId?: string;
     ruleKey: string;
@@ -14,12 +29,21 @@ export declare class PricingRule extends SmrtObject {
     priority: number;
     terms: string;
     active: boolean;
+    /**
+     * The price book this rule belongs to (#3059), or empty for a tenant's
+     * direct pricing. Book rules are priced only through
+     * `CommercialUsageService.rateUsage()`; `price()` ignores them.
+     */
+    priceBookId: string;
     getTerms(): Record<string, unknown>;
     setTerms(value: Record<string, unknown>): void;
 }
 export declare class ClientCharge extends SmrtObject {
+    /** The payer: the usage tenant, or its billing owner when parent-billed. */
     tenantId?: string;
     usageEventId: string;
+    /** The tenant whose usage was charged; differs from `tenantId` for wholesale. */
+    usageTenantId: string;
     subscriberKind: string;
     subscriberExternalId: string;
     projectId: string;
@@ -44,6 +68,8 @@ export declare class ClientCharge extends SmrtObject {
     amount: number;
     currency: string;
     pricingRuleId: string;
+    /** Wholesale book that priced this charge, or empty for direct pricing. */
+    priceBookId: string;
     pricingSnapshot: string;
     status: 'draft' | 'approved' | 'adjusted';
     approvedAt: Date | null;
@@ -81,13 +107,47 @@ export declare class SpendingPolicy extends SmrtObject {
      * Spending cap in **integer minor units** of {@link currency}. Compared
      * directly against the sum of `ClientCharge.amount` + `BillingAdjustment`s
      * plus the caller's estimate, so it must carry the same unit (#2401).
+     * Must be zero for a `balance` policy, whose limit is its credit grants.
      */
     limitAmount: number;
     currency: string;
     behavior: SpendingPolicyBehavior;
     priority: number;
     active: boolean;
+    /** Which charges count toward the policy; see {@link SpendingBasis}. */
+    basis: SpendingBasis;
+    /**
+     * The parent tenant that set this policy on its child (#3059), or empty for
+     * a tenant's own policy. A delegated policy can be changed or deleted only
+     * by that parent, a system context, or a super-admin bypass.
+     */
+    setByTenantId: string;
+    /** Start of the spend window for a `balance` policy; defaults to creation. */
+    balanceFrom: Date | null;
     protected validateBeforeSave(): Promise<void>;
+    /**
+     * A balance policy's credit grants are scoped to its currency and period;
+     * changing either would silently detach the ledger, so create a new
+     * balance instead.
+     */
+    protected assertBalanceLedgerStable(rows: Array<Record<string, unknown> | null>): Promise<void>;
+    /**
+     * The rows this save can overwrite: by id and, because a new object may
+     * already carry a generated id, by conflict key (an upsert target).
+     */
+    protected persistedTargets(): Promise<Array<Record<string, unknown> | null>>;
+    /**
+     * A delegated policy belongs to the parent that set it: the constrained
+     * child cannot create one in a parent's name, loosen it, or delete it.
+     * The parent's-own-context allowance applies only where no tenancy
+     * interceptor is registered; with one, the interceptor refuses a parent
+     * writing the child's row, so parents change delegated policies through
+     * `ResellerBillingService.setDelegatedSpendingPolicy()` (set
+     * `active: false` to retire one).
+     * Checks both the persisted row (by id, or by conflict key for an upsert)
+     * and the incoming value.
+     */
+    protected assertDelegationAuthority(targets?: Array<Record<string, unknown> | null>): Promise<void>;
 }
 export declare class PricingRuleCollection extends SmrtCollection<PricingRule> {
     static readonly _itemClass: typeof PricingRule;

package/dist/models/commercial.d.ts.map

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

package/dist/models/index.d.ts

@@ -1,5 +1,7 @@
-export type { PricingStrategy, SpendingPeriod, SpendingPolicyBehavior, } from './commercial.js';
+export type { PricingStrategy, SpendingBasis, SpendingPeriod, SpendingPolicyBehavior, } from './commercial.js';
 export { BillingAdjustment, BillingAdjustmentCollection, ClientCharge, ClientChargeCollection, PricingRule, PricingRuleCollection, SpendingPolicy, SpendingPolicyCollection, } from './commercial.js';
+export type { PriceBookKind } from './reseller.js';
+export { CreditGrant, CreditGrantCollection, isCurrencyCode, isPriceBookKind, PriceBook, PriceBookAssignment, PriceBookCollection, RetailCharge, RetailChargeCollection, } from './reseller.js';
 export { SubscriptionPlan } from './SubscriptionPlan.js';
 export { TenantSubscription } from './TenantSubscription.js';
 export { TenantUsageMetric } from './TenantUsageMetric.js';

package/dist/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/models/reseller.d.ts

@@ -0,0 +1,107 @@
+import { SmrtCollection, SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * `wholesale` books price what a service provider charges a reseller for its
+ * children's usage; `retail` books price what a reseller charges its children.
+ */
+export type PriceBookKind = 'wholesale' | 'retail';
+export declare function isPriceBookKind(value: unknown): value is PriceBookKind;
+/** ISO 4217-shaped (three upper-case letters) currency code check. */
+export declare function isCurrencyCode(value: unknown): value is string;
+/**
+ * A named set of prices published by one seller tenant. Its prices are
+ * ordinary {@link PricingRule} rows that carry this book's id and the same
+ * tenant; one rule per currency gives a price in several currencies.
+ */
+export declare class PriceBook extends SmrtObject {
+    /** The seller that publishes and owns the book. */
+    tenantId?: string;
+    bookKey: string;
+    name: string;
+    kind: PriceBookKind;
+    active: boolean;
+    protected validateBeforeSave(): Promise<void>;
+}
+/**
+ * Which price books rate one child tenant's usage, keyed like the tenancy
+ * billing relationship it belongs to (one row per child). The reseller is
+ * recorded so an assignment made under one relationship never prices usage
+ * after the child moves to a different reseller.
+ *
+ * A system table managed through `ResellerBillingService`, like
+ * `_smrt_billing_relationships`; it has no generated API surface.
+ */
+export declare class PriceBookAssignment extends SmrtObject {
+    childTenantId: string;
+    resellerTenantId: string;
+    wholesalePriceBookId: string;
+    wholesaleCurrency: string;
+    retailPriceBookId: string;
+    retailCurrency: string;
+}
+/**
+ * What a reseller charges one child for one usage event, priced from the
+ * reseller's retail book. The provider's charge for the same event is the
+ * {@link ClientCharge} in `clientChargeId`, payable by the billing owner.
+ *
+ * `tenantId` is always the payer (the child), so tenant-scoped reads and the
+ * child's `retail`-basis spending policies see exactly what it owes.
+ */
+export declare class RetailCharge extends SmrtObject {
+    tenantId?: string;
+    resellerTenantId: string;
+    usageEventId: string;
+    clientChargeId: string;
+    subscriberKind: string;
+    subscriberExternalId: string;
+    projectId: string;
+    workRefType: string;
+    workRefId: string;
+    provider: string;
+    serviceKey: string;
+    metricKey: string;
+    /** Metered quantity; fractional, like `ClientCharge.quantity`. */
+    quantity: number;
+    /** Charge in integer minor units of {@link currency}. */
+    amount: number;
+    currency: string;
+    priceBookId: string;
+    pricingRuleId: string;
+    pricingSnapshot: string;
+    status: 'draft' | 'approved';
+    approvedAt: Date | null;
+    getPricingSnapshot(): Record<string, unknown>;
+    protected validateBeforeSave(): Promise<void>;
+}
+/**
+ * An append-only credit on a prepaid (`period: 'balance'`) spending policy.
+ * Positive amounts add credit; a negative amount reverses an earlier grant.
+ */
+export declare class CreditGrant extends SmrtObject {
+    /** The tenant whose balance is credited (the policy's tenant). */
+    tenantId?: string;
+    spendingPolicyId: string;
+    /** Signed credit in integer minor units of {@link currency}. */
+    amount: number;
+    currency: string;
+    reason: string;
+    source: string;
+    sourceId: string;
+    /** A parent tenant that granted the credit, or empty when self-granted. */
+    grantedByTenantId: string;
+    /** Append-only: history is corrected by a reversing grant, never removed. */
+    protected refuseDelete(): void;
+    protected validateBeforeSave(): Promise<void>;
+}
+export declare class PriceBookCollection extends SmrtCollection<PriceBook> {
+    static readonly _itemClass: typeof PriceBook;
+}
+export declare class PriceBookAssignmentCollection extends SmrtCollection<PriceBookAssignment> {
+    static readonly _itemClass: typeof PriceBookAssignment;
+}
+export declare class RetailChargeCollection extends SmrtCollection<RetailCharge> {
+    static readonly _itemClass: typeof RetailCharge;
+}
+export declare class CreditGrantCollection extends SmrtCollection<CreditGrant> {
+    static readonly _itemClass: typeof CreditGrant;
+}
+//# sourceMappingURL=reseller.d.ts.map

package/dist/models/reseller.d.ts.map

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

package/dist/services/commercial.d.ts

@@ -1,13 +1,39 @@
 import { SmrtClassOptions } from '@happyvertical/smrt-core';
+import { BillingRelationshipService } from '@happyvertical/smrt-tenancy';
 import { SqlAdapterType } from '@happyvertical/sql';
 import { TenantUsageMetricCollection } from '../collections/TenantUsageMetricCollection.js';
-import { BillingAdjustmentCollection, ClientCharge, ClientChargeCollection, PricingRule, PricingRuleCollection, SpendingPolicyCollection } from '../models/commercial.js';
+import { BillingAdjustmentCollection, ClientCharge, ClientChargeCollection, PricingRule, PricingRuleCollection, SpendingBasis, SpendingPolicyCollection } from '../models/commercial.js';
+import { CreditGrant, CreditGrantCollection, PriceBook, RetailCharge, RetailChargeCollection } from '../models/reseller.js';
+import { TenantUsageMetric } from '../models/TenantUsageMetric.js';
 import { RecordUsageOptions, SubscriberKind } from '../types.js';
 export interface PriceUsageOptions {
     usageEventId: string;
     approved?: boolean;
     at?: Date;
 }
+/** The released smrt-tenancy billing-owner read this package depends on. */
+export type BillingRelationshipReader = Pick<BillingRelationshipService, 'getRelationship'>;
+export interface RateUsageOptions extends PriceUsageOptions {
+    /** Resolves the usage tenant's reseller relationship and billing owner. */
+    billingRelationships: BillingRelationshipReader;
+}
+/**
+ * The outcome of rating one usage event (#3059). A usage event is rated
+ * exactly once: the first rating fixes the payer and price books, and later
+ * calls return the same records even if the billing owner has since changed.
+ */
+export interface UsageRating {
+    /** The tenant that produced the usage. */
+    usageTenantId: string;
+    /** Who pays the provider: the usage tenant, or its reseller. */
+    billingOwnerTenantId: string;
+    /** `direct` for self-billed usage, `wholesale` for reseller-billed usage. */
+    mode: 'direct' | 'wholesale';
+    /** The provider's charge, payable by {@link billingOwnerTenantId}. */
+    charge: ClientCharge;
+    /** The reseller's retail charge to the child, when a retail book applies. */
+    retailCharge: RetailCharge | null;
+}
 export interface CustomPricingContext {
     usage: {
         quantity: number;
@@ -44,11 +70,36 @@ export declare class CommercialUsageService {
     private readonly adjustments;
     private readonly billingStorage;
     private readonly customStrategies;
+    private resellerCollections?;
     constructor(usage: TenantUsageMetricCollection, rules: PricingRuleCollection, charges: ClientChargeCollection, adjustments: BillingAdjustmentCollection, billingStorage: CommercialBillingStorage);
     static create(options?: CommercialUsageServiceOptions): Promise<CommercialUsageService>;
     registerCustomStrategy(key: string, strategy: CustomPricingStrategy): void;
-    record(options: RecordUsageOptions): Promise<import('../index.js').TenantUsageMetric>;
+    record(options: RecordUsageOptions): Promise<TenantUsageMetric>;
     price(options: PriceUsageOptions): Promise<ClientCharge>;
+    /**
+     * Rate one usage event under its billing owner's price books (#3059).
+     *
+     * - No reseller relationship, or a `self`-billed one: the usage tenant pays
+     *   the provider directly, priced exactly as {@link price} prices it.
+     * - `reseller`-billed: the reseller pays the provider from the child's
+     *   assigned wholesale book (a {@link ClientCharge} with `tenantId` = the
+     *   reseller and `usageTenantId` = the child) and, when the child has a
+     *   retail book assigned, the child owes the reseller a
+     *   {@link RetailCharge}. Both records commit in one transaction.
+     *
+     * Rating is idempotent per usage event and frozen at first rating: a later
+     * billing-owner change never re-prices or double-charges an event that
+     * already has a provider charge, because `ClientCharge` holds exactly one
+     * row per usage event.
+     *
+     * Rating reads the seller's books across tenants; run it where the host's
+     * tenancy rules allow that (typically a system context).
+     */
+    rateUsage(options: RateUsageOptions): Promise<UsageRating>;
+    private rateResellerBilled;
+    private selectBookRule;
+    private frozenRating;
+    private getResellerCollections;
     private approveCharge;
     /**
      * Append a signed correction to an approved charge.
@@ -85,8 +136,13 @@ export interface SpendingDecision {
      */
     projectedAmount: number;
     matchedPolicyId: string | null;
+    /**
+     * For a prepaid `balance` policy: credit remaining before this estimate
+     * (grants minus spend), in integer minor units. Absent for other periods.
+     */
+    balanceAmount?: number;
 }
-interface SpendingEvaluationInput {
+export interface SpendingEvaluationInput {
     tenantId: string;
     subscriberKind?: SubscriberKind;
     subscriberExternalId?: string;
@@ -95,17 +151,102 @@ interface SpendingEvaluationInput {
     metricKey: string;
     /** Estimated cost of the pending call, in integer minor units (#2401). */
     estimatedAmount: number;
+    /**
+     * Per-basis estimates, in integer minor units, for policies whose basis
+     * prices the call differently (a retail estimate for `retail` policies, a
+     * wholesale estimate for `wholesale` ones). Falls back to
+     * {@link estimatedAmount}.
+     */
+    estimatedAmounts?: Partial<Record<SpendingBasis, number>>;
     currency: string;
     at?: Date;
 }
+/** Context handed to an {@link AutoTopUpHook} when a balance would run out. */
+export interface AutoTopUpRequest {
+    policyId: string;
+    tenantId: string;
+    /** The parent that set the policy, or empty for the tenant's own policy. */
+    setByTenantId: string;
+    currency: string;
+    /** Credit remaining before the estimate, in integer minor units. */
+    balanceAmount: number;
+    estimatedAmount: number;
+    /** How far the estimate overshoots the balance, in integer minor units. */
+    shortfall: number;
+}
+/**
+ * A top-up the hook has secured. `sourceId` makes it idempotent: the same
+ * `source`/`sourceId` pair is credited once however often it is returned.
+ */
+export interface AutoTopUpGrant {
+    amount: number;
+    sourceId: string;
+    source?: string;
+    reason?: string;
+}
+/**
+ * Host hook for prepaid balances. Called when a pending charge would exhaust a
+ * `balance` policy; return a grant to credit it (after the host has secured
+ * the funds) or nothing to let the policy's behavior apply. The evaluator
+ * never calls a payment provider itself.
+ */
+export type AutoTopUpHook = (request: AutoTopUpRequest) => AutoTopUpGrant | null | undefined | Promise<AutoTopUpGrant | null | undefined>;
+export interface SpendingPolicyEvaluatorOptions extends SmrtClassOptions {
+    autoTopUp?: AutoTopUpHook;
+    /**
+     * The smrt-tenancy relationship reader. When supplied, a delegated policy
+     * applies only while its `setByTenantId` is the tenant's current reseller;
+     * without it every delegated policy applies (fail closed).
+     */
+    billingRelationships?: BillingRelationshipReader;
+}
+export interface GrantCreditInput {
+    spendingPolicyId: string;
+    /** Signed, nonzero credit in integer minor units of the policy currency. */
+    amount: number;
+    reason?: string;
+    /** With `sourceId`, makes the grant idempotent (a payment or order id). */
+    source?: string;
+    sourceId?: string;
+    /** The parent granting credit on its child's delegated policy. */
+    grantedByTenantId?: string;
+}
+export interface SpendingPolicyEvaluatorExtensions {
+    retailCharges?: RetailChargeCollection;
+    credits?: CreditGrantCollection;
+    autoTopUp?: AutoTopUpHook;
+    billingRelationships?: BillingRelationshipReader;
+}
 export declare class SpendingPolicyEvaluator {
     private readonly policies;
     private readonly charges;
     private readonly adjustments;
-    constructor(policies: SpendingPolicyCollection, charges: ClientChargeCollection, adjustments: BillingAdjustmentCollection);
-    static create(options?: SmrtClassOptions): Promise<SpendingPolicyEvaluator>;
+    private readonly extensions;
+    private ledgers?;
+    constructor(policies: SpendingPolicyCollection, charges: ClientChargeCollection, adjustments: BillingAdjustmentCollection, extensions?: SpendingPolicyEvaluatorExtensions);
+    static create(options?: SpendingPolicyEvaluatorOptions): Promise<SpendingPolicyEvaluator>;
     evaluate(input: SpendingEvaluationInput): Promise<SpendingDecision>;
+    /**
+     * Drop delegated policies whose parent is no longer the tenant's reseller,
+     * when a relationship reader is configured.
+     */
+    private withoutStaleDelegations;
+    /**
+     * Credit a prepaid `balance` policy. A delegated policy accepts grants only
+     * from the parent that set it (or a system context / super-admin bypass).
+     */
+    grantCredit(input: GrantCreditInput): Promise<CreditGrant>;
+    private recordGrant;
     private evaluatePolicy;
+    /** Approved spend in the policy's window, currency, scope, and basis. */
+    private spentFor;
+    private sumProviderCharges;
+    private creditFor;
+    private getLedgers;
 }
-export {};
+/**
+ * The provider leg must be priced by someone other than the payer: a reseller
+ * (or its child) never publishes the wholesale book it is charged from.
+ */
+export declare function assertWholesalePublisher(book: PriceBook, resellerTenantId: string, childTenantId: string): void;
 //# sourceMappingURL=commercial.d.ts.map

package/dist/services/commercial.d.ts.map

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

package/dist/services/index.d.ts

@@ -1,6 +1,8 @@
 export type { EntitlementResolutionContext } from '../types.js';
-export type { CommercialBillingStorage, CommercialUsageServiceOptions, CustomPricingContext, CustomPricingStrategy, PriceUsageOptions, SpendingDecision, } from './commercial.js';
+export type { AutoTopUpGrant, AutoTopUpHook, AutoTopUpRequest, BillingRelationshipReader, CommercialBillingStorage, CommercialUsageServiceOptions, CustomPricingContext, CustomPricingStrategy, GrantCreditInput, PriceUsageOptions, RateUsageOptions, SpendingDecision, SpendingEvaluationInput, SpendingPolicyEvaluatorExtensions, SpendingPolicyEvaluatorOptions, UsageRating, } from './commercial.js';
 export { assertCommercialBillingStorageSupported, CommercialBillingStorageConfigurationError, CommercialUsageService, SpendingPolicyEvaluator, UnsupportedCommercialBillingStorageError, } from './commercial.js';
+export { type AssignPriceBooksInput, type DefinePriceBookPriceInput, type DelegatedSpendingPolicyInput, type GrantChildCreditInput, type PriceBookAssignmentView, type PriceBookLeg, type ResellerBillingAction, ResellerBillingService, type ResellerBillingServiceOptions, } from './reseller.js';
+export { ResellerBillingError, type ResellerBillingErrorCode, } from './reseller-errors.js';
 export { type SubscriptionPlanReader, SubscriptionResolver, type SubscriptionResolverReaders, type TenantSubscriptionReader, type UsageSummaryReader, } from './subscription-resolver.js';
 export { evaluateThreshold, evaluateThresholds, } from './threshold-evaluator.js';
 export { TenantUsageMeter } from './usage-meter.js';

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uCAAuC,EACvC,0CAA0C,EAC1C,sBAAsB,EACtB,uBAAuB,EACvB,wCAAwC,GACzC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,iCAAiC,EACjC,8BAA8B,EAC9B,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uCAAuC,EACvC,0CAA0C,EAC1C,sBAAsB,EACtB,uBAAuB,EACvB,wCAAwC,GACzC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/reseller-errors.d.ts

@@ -0,0 +1,7 @@
+export type ResellerBillingErrorCode = 'INVALID_TENANT' | 'INVALID_CURRENCY' | 'INVALID_AMOUNT' | 'PRICE_BOOK_NOT_FOUND' | 'PRICE_BOOK_INACTIVE' | 'PRICE_BOOK_KIND_MISMATCH' | 'PRICE_BOOK_OWNER_MISMATCH' | 'PRICE_BOOK_NOT_ASSIGNED' | 'NO_EFFECTIVE_PRICE' | 'RELATIONSHIP_REQUIRED' | 'POLICY_NOT_FOUND' | 'POLICY_NOT_BALANCE' | 'POLICY_CONFLICT' | 'ASSIGNMENT_CONFLICT';
+/** A reseller price book, rating, or delegated-spending rule was violated. */
+export declare class ResellerBillingError extends Error {
+    readonly code: ResellerBillingErrorCode;
+    constructor(message: string, code: ResellerBillingErrorCode);
+}
+//# sourceMappingURL=reseller-errors.d.ts.map

package/dist/services/reseller-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reseller-errors.d.ts","sourceRoot":"","sources":["../../src/services/reseller-errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,sBAAsB,GACtB,qBAAqB,GACrB,0BAA0B,GAC1B,2BAA2B,GAC3B,yBAAyB,GACzB,oBAAoB,GACpB,uBAAuB,GACvB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GACjB,qBAAqB,CAAC;AAE1B,8EAA8E;AAC9E,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,IAAI,EAAE,wBAAwB;gBAD9C,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,wBAAwB;CAKjD"}