@whooshbang/contract-mock 2.0.0-rc.6 → 2.0.0-rc.8

package/CHANGELOG.md

@@ -5,6 +5,18 @@ recorded here.
 
 ## Unreleased
 
+## 2.0.0-rc.8
+
+### Changed
+
+- Deterministic service-notice email enrollment (FXO-3033), subscription changes without unused-time credits (FXO-2988) and updated subscriber copy (FXO-3000), through the rc.8 contract.
+
+## 2.0.0-rc.7
+
+### Changed
+
+- Deterministic in-app card, credit purchase, receipt address, invoice history and Team and Agency subscription-change scenarios through the rc.7 contract, including undoing a scheduled change (FXO-2941).
+
 ## 2.0.0-rc.6
 
 ### Added

package/dist/billing.d.ts

@@ -1,13 +1,15 @@
-import type { AutoTopUpSettings, UpdateAutoTopUpSettingsRequest, AutoTopUpSetup, BillingAccount, BillingEntitlements, BillingProjectSlots, ContractValidator, CreateSubscriptionCheckoutRequest, Problem, ProblemCode, Project, ProjectAttribution, SubscriptionCheckout, SubscriptionChange, WalletCheckout } from "@whooshbang/contracts";
+import type { AutoTopUpSettings, UpdateAutoTopUpSettingsRequest, BillingAccount, BillingEntitlements, BillingInvoiceCollection, BillingProjectSlots, CardSetup, ContractValidator, CreditPurchase, Problem, ProblemCode, Project, ProjectAttribution, SubscriptionChange, SubscriptionSelection } from "@whooshbang/contracts";
 import type { Hono } from "hono";
 import type { ContractMockBillingOptions, OrganizationScope } from "./types.js";
-interface CheckoutState {
-    readonly organizationId: string;
-    readonly resource: WalletCheckout | SubscriptionCheckout;
-    readonly purchaseCents?: number;
-    readonly selection?: CreateSubscriptionCheckoutRequest;
-    readonly selectedOffers?: BillingEntitlements["offers"];
-    applied: boolean;
+interface ChangeState {
+    organizationId: string;
+    resource: SubscriptionChange;
+    selectedOffers: BillingEntitlements["offers"];
+    quotedAt: string;
+    purchases: {
+        kind: BillingEntitlements["offers"][number]["kind"];
+        quantity: number;
+    }[];
 }
 /** Local, isolated financial fixtures. All state resets with the mock. The
  * production service independently verifies Stripe objects and signatures. */
@@ -15,18 +17,17 @@ export declare class MockBillingState {
     private readonly options;
     readonly cardSetups: Map<string, {
         organizationId: string;
-        revision: number;
-        resource: AutoTopUpSetup;
-        applied: boolean;
+        resource: CardSetup;
     }>;
-    private readonly automaticSettings;
-    private readonly accounts;
-    readonly checkouts: Map<string, CheckoutState>;
-    readonly changes: Map<string, {
+    readonly purchases: Map<string, {
         organizationId: string;
-        resource: SubscriptionChange;
-        selectedOffers: BillingEntitlements["offers"];
+        resource: CreditPurchase;
+        createdAt: string;
     }>;
+    private readonly automaticSettings;
+    private readonly accounts;
+    readonly changes: Map<string, ChangeState>;
+    private readonly invoices;
     readonly attribution: Map<string, boolean>;
     readonly replays: Map<string, {
         fingerprint: string;
@@ -36,19 +37,26 @@ export declare class MockBillingState {
     }>;
     readonly offers: BillingEntitlements["offers"];
     private sequence;
-    readAutoTopUp(organizationId: string): AutoTopUpSettings;
-    autoTopUpRevision(organizationId: string): number;
-    updateAutoTopUp(organizationId: string, input: UpdateAutoTopUpSettingsRequest): AutoTopUpSettings;
-    createCardSetup(organizationId: string): AutoTopUpSetup | null;
-    reconcileCardSetup(organizationId: string, id: string): "applied" | "unpaid" | "ignored";
     constructor(options?: ContractMockBillingOptions);
+    private id;
     private account;
-    readAccount(organizationId: string): BillingAccount;
+    private record;
+    private outcome;
+    readAccount(organizationId: string, now?: string): BillingAccount;
+    setReceiptEmail(organizationId: string, email: string | null): void;
+    createCardSetup(organizationId: string): CardSetup;
+    reconcileCardSetup(organizationId: string, id: string): CardSetup | null;
+    createCreditPurchase(organizationId: string, purchaseCents: number, now: string): CreditPurchase | "card_required";
+    settlePurchase(organizationId: string, id: string): CreditPurchase | null;
+    listInvoices(organizationId: string, page: number, limit: number): BillingInvoiceCollection;
+    readAutoTopUp(organizationId: string): AutoTopUpSettings;
+    updateAutoTopUp(organizationId: string, input: UpdateAutoTopUpSettingsRequest): AutoTopUpSettings;
     private changeOffers;
     private selectionTotal;
-    createChange(organizationId: string, selection: CreateSubscriptionCheckoutRequest, now: string): SubscriptionChange | null;
+    createChange(organizationId: string, selection: SubscriptionSelection, now: string): SubscriptionChange | null;
+    private apply;
     settleChange(organizationId: string, id: string, now: string): SubscriptionChange | null;
-    confirmChange(organizationId: string, id: string, charge: string, now: string): SubscriptionChange | null;
+    confirmChange(organizationId: string, id: string, charge: string, now: string): SubscriptionChange | "card_required" | null;
     readEntitlements(organizationId: string, now: string): BillingEntitlements;
     readAttribution(organizationId: string, projectId: string, now: string): ProjectAttribution;
     readSlots(organizationId: string, projects: readonly Project[], now: string): BillingProjectSlots;
@@ -58,8 +66,6 @@ export declare class MockBillingState {
      * answers never call this function, so retries and later failures do not debit. */
     hasCoreFunding(organizationId: string, now: string): boolean;
     fundLive(organizationId: string, sharedEmail: boolean, now: string): "wallet_insufficient" | "email_credit_insufficient" | null;
-    createCheckout(organizationId: string, selection: number | CreateSubscriptionCheckoutRequest): CheckoutState | null;
-    reconcile(checkout: CheckoutState, now: string): "applied" | "unpaid" | "ignored";
 }
 interface BillingHooks {
     state(): MockBillingState;
@@ -71,7 +77,7 @@ interface BillingHooks {
     reply<T>(body: T, validator: ContractValidator<T>, status?: number): Response;
     read<T>(request: Request, validator: ContractValidator<T>): Promise<T | Response>;
 }
-/** Register only published public resources. Synthetic vendor completion is
- * driven by a programmatic fixture, never a caller-supplied payment flag. */
+/** Register only published public resources. Synthetic card completion and
+ * charge outcomes are programmatic fixtures, never caller-supplied flags. */
 export declare function addMockBillingRoutes(app: Hono, hooks: BillingHooks): void;
 export {};