@saasicat/nest 1.0.0-rc.20 → 1.0.0-rc.21

package/dist/{checkout-offer.service-Bk5mHEoR.d.cts → checkout-offer.service-CCVxG9b2.d.cts}

@@ -1,7 +1,7 @@
-import { PlanCatalog, PlanRepository, BundleRepository, PromotionRepository, CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot, CheckoutOfferRow, CheckoutOfferRepository, CatalogEntryRepository, TransactionRunner, CheckoutOfferFilter, CheckoutOfferSelection, CheckoutOfferSelectionUpdate, NewSubscriberDetails, TransactionContext, SubscriptionContractRecord } from '@saasicat/core';
-import { S as SubscriptionContractService, C as CreateContractFromOfferOptions } from './subscription-contract.service-D7Qb_Ns-.cjs';
-import { S as SubscriberService } from './subscriber.service-BZsvHw1V.cjs';
-import { a as PromoCodesService } from './promo.service-CBMm9RU7.cjs';
+import { PlanCatalogSettings, PlanRepository, BundleRepository, PromotionRepository, CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot, CheckoutOfferRow, CheckoutOfferRepository, CatalogEntryRepository, TransactionRunner, CheckoutOfferFilter, CheckoutOfferSelection, CheckoutOfferSelectionUpdate, NewSubscriberDetails, TransactionContext, SubscriptionContractRecord } from '@saasicat/core';
+import { S as SubscriptionContractService, C as CreateContractFromOfferOptions } from './subscription-contract.service-CfNApLuP.cjs';
+import { S as SubscriberService } from './subscriber.service-5W6Gi-1B.cjs';
+import { a as PromoCodesService } from './promo.service-BYBu6dy3.cjs';
 
 type Cycle = 'monthly' | 'yearly';
 /** What pricing needs to know about a selection. */
@@ -11,6 +11,16 @@ interface CheckoutOfferPricingInput {
     bundleVersionIds: readonly string[];
     promoCode: string | null;
     locale: string;
+    /**
+     * The offer when it is priced again. A slot of its promo code held for its
+     * checkout is its own, not counted against it.
+     */
+    checkoutOfferId?: string;
+    /**
+     * Priced as the offer is concluded: its held slot also keeps the code as it
+     * stood when the slot was taken.
+     */
+    concluding?: boolean;
 }
 /** The part of a stored offer the server computes. */
 interface PricedCheckoutOffer {
@@ -25,12 +35,12 @@ interface PricedCheckoutOffer {
     promoCodeSnapshot: CheckoutOfferPromoCodeSnapshot | null;
 }
 declare class CheckoutOfferPricing {
-    private readonly catalog;
+    private readonly settings;
     private readonly plans;
     private readonly bundles;
     private readonly promotions;
     private readonly promoCodes;
-    constructor(catalog: PlanCatalog, plans: PlanRepository, bundles?: BundleRepository | null, promotions?: PromotionRepository | null, promoCodes?: PromoCodesService | null);
+    constructor(settings: PlanCatalogSettings, plans: PlanRepository, bundles?: BundleRepository | null, promotions?: PromotionRepository | null, promoCodes?: PromoCodesService | null);
     /** Prices a selection against the plan version on sale now. */
     price(input: CheckoutOfferPricingInput, asOf?: Date): Promise<PricedCheckoutOffer>;
     /**
@@ -98,16 +108,43 @@ declare class CheckoutOfferService {
     private readonly contracts;
     private readonly transactions;
     private readonly subscribers;
-    constructor(repo: CheckoutOfferRepository, pricing: CheckoutOfferPricing, bundles?: BundleRepository | null, plans?: PlanRepository | null, catalogEntries?: CatalogEntryRepository | null, contracts?: SubscriptionContractService | null, transactions?: TransactionRunner | null, subscribers?: SubscriberService | null);
+    private readonly promoCodes;
+    constructor(repo: CheckoutOfferRepository, pricing: CheckoutOfferPricing, bundles?: BundleRepository | null, plans?: PlanRepository | null, catalogEntries?: CatalogEntryRepository | null, contracts?: SubscriptionContractService | null, transactions?: TransactionRunner | null, subscribers?: SubscriberService | null, promoCodes?: PromoCodesService | null);
     list(filter: CheckoutOfferFilter): Promise<CheckoutOfferRow[]>;
     getById(id: string): Promise<CheckoutOfferRow>;
     /** Prices what the caller chose and stores it as an open offer. */
     create(selection: CheckoutOfferSelection): Promise<CheckoutOfferRow>;
     /**
      * Customization in onboarding — only while the offer is `open`. The plan
-     * stays; whatever else changes, the whole offer is priced again.
+     * stays; whatever else changes, the whole offer is priced again. A slot of
+     * its promo code held for its checkout stays with it while the code does,
+     * and is given back when the code is changed or removed.
      */
     update(id: string, change: CheckoutOfferSelectionUpdate): Promise<CheckoutOfferRow>;
+    /**
+     * Holds a slot of the offer's promo code for its checkout until `until` —
+     * what a sign-up does as its checkout starts, until a confirmation of its
+     * payment form can no longer arrive — so that the code cannot run out
+     * before the payment is confirmed and the offer concluded. A live slot the
+     * offer holds of that code already moves to `until`, never earlier. The
+     * conclusion turns the slot into the redemption; the slot goes back when
+     * the offer's code changes or `until` passes.
+     *
+     * Refused, and nothing held, when the offer is no longer open or its code
+     * cannot be held: `PROMO_CODE_NOT_REDEEMABLE` with the reason a preview
+     * gives, `EXHAUSTED` when every slot is redeemed or held. An offer without
+     * a code holds nothing.
+     */
+    holdPromoCode(id: string, hold: {
+        email?: string;
+        until: Date;
+    }): Promise<void>;
+    /**
+     * Gives back the slot held for the offer's checkout while it is still held
+     * until `heldUntil`, as the caller wrote it. A slot another start of the
+     * checkout moved later stays with the form that start opened.
+     */
+    releasePromoCodeHold(id: string, heldUntil: Date): Promise<void>;
     /**
      * Freezes the offer (`status = 'consumed'`). Returns the final
      * snapshot — the caller (registration/billing) writes it
@@ -158,6 +195,12 @@ declare class CheckoutOfferService {
      * where a refusal still undoes everything. Nothing checks the code again
      * after `within`, so a redemption that takes its last slot does not refuse
      * the offer it was redeemed for.
+     *
+     * A slot held for the offer's checkout (`holdPromoCode`) is the offer's own
+     * throughout: the checks before the transaction do not count it against
+     * the code and accept the code as it stood when the slot was held, and the
+     * redemption in `within` takes that slot rather than a free one. A slot
+     * `within` did not redeem is given back before the conclusion commits.
      */
     conclude(id: string, options: ConcludeCheckoutOfferOptions, within?: ConcludeCheckoutOfferWithin): Promise<ConcludedCheckoutOffer>;
     private assertConsumable;

package/dist/{chunk-AOQJEYOL.js → chunk-3QVGA6JX.js}

@@ -7,6 +7,7 @@ var PROMOTION_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/Promo
 var MARKETING_SETTINGS_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/MarketingSettingsRepository");
 var CATALOG_SERVICE_CONFIG_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/CatalogServiceConfig");
 var CATALOG_FEATURE_UI_REGISTRY_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/CatalogFeatureUiRegistry");
+var NEW_PAYMENT_METHODS_SOURCE_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/NewPaymentMethodsSource");
 
 export {
   PLAN_REPOSITORY_TOKEN,
@@ -16,5 +17,6 @@ export {
   PROMOTION_REPOSITORY_TOKEN,
   MARKETING_SETTINGS_REPOSITORY_TOKEN,
   CATALOG_SERVICE_CONFIG_TOKEN,
-  CATALOG_FEATURE_UI_REGISTRY_TOKEN
+  CATALOG_FEATURE_UI_REGISTRY_TOKEN,
+  NEW_PAYMENT_METHODS_SOURCE_TOKEN
 };