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

package/dist/checkout-offer/index.d.cts

@@ -1,42 +1,37 @@
-export { C as CheckoutOfferService } from '../checkout-offer.service-BLOv2HOo.cjs';
+export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferOptions, d as ConcludeCheckoutOfferWithin, e as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-CCVxG9b2.cjs';
 import { Type, CanActivate } from '@nestjs/common';
-export { C as CheckoutOfferControllerConfig, a as CheckoutOfferModule, b as CheckoutOfferModuleOptions } from '../checkout-offer.module-CVpWrzbe.cjs';
-import { CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot } from '@saasicat/core';
+export { a as CheckoutOfferConclusionOptions, b as CheckoutOfferControllerConfig, c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-DFhGy6JO.cjs';
+import { CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
+import '../subscription-contract.service-CfNApLuP.cjs';
+import '../subscriber.service-5W6Gi-1B.cjs';
+import '../promo.service-BYBu6dy3.cjs';
+import '../plan-catalog-source-DWe-BGY1.cjs';
 import '../di-CcNeq9v-.cjs';
 
 declare function buildCheckoutOfferController(guards: Array<Type<CanActivate>>): Type;
 
 /** Repository for `checkout_offers`. */
 declare const CHECKOUT_OFFER_REPOSITORY_TOKEN: unique symbol;
+/**
+ * The transaction an offer is concluded in: consuming it, writing its contract
+ * and the application's own writes commit or roll back together.
+ */
+declare const CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN: unique symbol;
 
-declare class CreateCheckoutOfferDto {
-    projectKey: string;
+declare class CreateCheckoutOfferDto implements CheckoutOfferSelection {
     planKey: string;
-    planVersionId?: string | null;
     billingCycle: 'monthly' | 'yearly';
-    promotionId?: string | null;
-    promoCode?: string | null;
-    bundles?: string[];
     bundleVersionIds?: string[];
-    priceBreakdown: CheckoutOfferPriceBreakdown;
-    lineItems?: CheckoutOfferLineItem[];
-    promotionSnapshots?: CheckoutOfferPromotionSnapshot[];
-    promoCodeSnapshot?: CheckoutOfferPromoCodeSnapshot | null;
+    promoCode?: string | null;
     locale?: string;
     validUntil?: string | null;
 }
-declare class UpdateCheckoutOfferDto {
+declare class UpdateCheckoutOfferDto implements CheckoutOfferSelectionUpdate {
     billingCycle?: 'monthly' | 'yearly';
-    promotionId?: string | null;
-    promoCode?: string | null;
-    bundles?: string[];
     bundleVersionIds?: string[];
-    priceBreakdown?: CheckoutOfferPriceBreakdown;
-    lineItems?: CheckoutOfferLineItem[];
-    promotionSnapshots?: CheckoutOfferPromotionSnapshot[];
-    promoCodeSnapshot?: CheckoutOfferPromoCodeSnapshot | null;
+    promoCode?: string | null;
     locale?: string;
     validUntil?: string | null;
 }
 
-export { CHECKOUT_OFFER_REPOSITORY_TOKEN, CreateCheckoutOfferDto, UpdateCheckoutOfferDto, buildCheckoutOfferController };
+export { CHECKOUT_OFFER_REPOSITORY_TOKEN, CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN, CreateCheckoutOfferDto, UpdateCheckoutOfferDto, buildCheckoutOfferController };

package/dist/checkout-offer/index.d.ts

@@ -1,42 +1,37 @@
-export { C as CheckoutOfferService } from '../checkout-offer.service-BLOv2HOo.js';
+export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferOptions, d as ConcludeCheckoutOfferWithin, e as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-BeHgYikI.js';
 import { Type, CanActivate } from '@nestjs/common';
-export { C as CheckoutOfferControllerConfig, a as CheckoutOfferModule, b as CheckoutOfferModuleOptions } from '../checkout-offer.module-CMtiQJTT.js';
-import { CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot } from '@saasicat/core';
+export { a as CheckoutOfferConclusionOptions, b as CheckoutOfferControllerConfig, c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-x7SP_dX4.js';
+import { CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
+import '../subscription-contract.service-CPZrTM9C.js';
+import '../subscriber.service-5W6Gi-1B.js';
+import '../promo.service-CFjfF0Xm.js';
+import '../plan-catalog-source-DWe-BGY1.js';
 import '../di-CcNeq9v-.js';
 
 declare function buildCheckoutOfferController(guards: Array<Type<CanActivate>>): Type;
 
 /** Repository for `checkout_offers`. */
 declare const CHECKOUT_OFFER_REPOSITORY_TOKEN: unique symbol;
+/**
+ * The transaction an offer is concluded in: consuming it, writing its contract
+ * and the application's own writes commit or roll back together.
+ */
+declare const CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN: unique symbol;
 
-declare class CreateCheckoutOfferDto {
-    projectKey: string;
+declare class CreateCheckoutOfferDto implements CheckoutOfferSelection {
     planKey: string;
-    planVersionId?: string | null;
     billingCycle: 'monthly' | 'yearly';
-    promotionId?: string | null;
-    promoCode?: string | null;
-    bundles?: string[];
     bundleVersionIds?: string[];
-    priceBreakdown: CheckoutOfferPriceBreakdown;
-    lineItems?: CheckoutOfferLineItem[];
-    promotionSnapshots?: CheckoutOfferPromotionSnapshot[];
-    promoCodeSnapshot?: CheckoutOfferPromoCodeSnapshot | null;
+    promoCode?: string | null;
     locale?: string;
     validUntil?: string | null;
 }
-declare class UpdateCheckoutOfferDto {
+declare class UpdateCheckoutOfferDto implements CheckoutOfferSelectionUpdate {
     billingCycle?: 'monthly' | 'yearly';
-    promotionId?: string | null;
-    promoCode?: string | null;
-    bundles?: string[];
     bundleVersionIds?: string[];
-    priceBreakdown?: CheckoutOfferPriceBreakdown;
-    lineItems?: CheckoutOfferLineItem[];
-    promotionSnapshots?: CheckoutOfferPromotionSnapshot[];
-    promoCodeSnapshot?: CheckoutOfferPromoCodeSnapshot | null;
+    promoCode?: string | null;
     locale?: string;
     validUntil?: string | null;
 }
 
-export { CHECKOUT_OFFER_REPOSITORY_TOKEN, CreateCheckoutOfferDto, UpdateCheckoutOfferDto, buildCheckoutOfferController };
+export { CHECKOUT_OFFER_REPOSITORY_TOKEN, CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN, CreateCheckoutOfferDto, UpdateCheckoutOfferDto, buildCheckoutOfferController };

package/dist/checkout-offer/index.js

@@ -1,20 +1,34 @@
-import "../chunk-DBZGV3HC.js";
+import "../chunk-DFOW3JVO.js";
 import {
-  CHECKOUT_OFFER_REPOSITORY_TOKEN,
   CheckoutOfferModule,
-  CheckoutOfferService,
   CreateCheckoutOfferDto,
   UpdateCheckoutOfferDto,
   buildCheckoutOfferController
-} from "../chunk-WUDYIPYH.js";
-import "../chunk-BSK6YBLI.js";
+} from "../chunk-TOEFN7DN.js";
+import {
+  CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
+  CheckoutOfferPricing,
+  CheckoutOfferService
+} from "../chunk-55QEDAMX.js";
+import "../chunk-3RLWML2S.js";
+import "../chunk-NDLC5GYK.js";
+import "../chunk-KPEMTBOP.js";
+import "../chunk-TBBZWZQT.js";
+import "../chunk-VBRYPU7V.js";
+import "../chunk-6PJE7EWO.js";
+import "../chunk-3QVGA6JX.js";
+import "../chunk-WOEJ6K7M.js";
+import "../chunk-LF6J4YYN.js";
 import "../chunk-YSC46BGM.js";
-import "../chunk-AOQJEYOL.js";
-import "../chunk-SABTXESR.js";
+import "../chunk-FEQZCWUL.js";
+import "../chunk-J7NJRK3K.js";
 import "../chunk-SHUYVCID.js";
 export {
   CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
   CheckoutOfferModule,
+  CheckoutOfferPricing,
   CheckoutOfferService,
   CreateCheckoutOfferDto,
   UpdateCheckoutOfferDto,

package/dist/checkout-offer.module-DFhGy6JO.d.cts

@@ -0,0 +1,58 @@
+import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
+import { SubscriptionContractRepository, SubscriberRepository, TransactionRunner, CheckoutOfferRepository, BundleRepository, PlanRepository, PromotionRepository, CatalogEntryRepository } from '@saasicat/core';
+import { P as ProviderSpec } from './di-CcNeq9v-.cjs';
+
+interface CheckoutOfferControllerConfig {
+    /** Class-level guards; `[]` for auth-free public endpoints. */
+    guards: Array<Type<CanActivate>>;
+}
+/** What `CheckoutOfferService.conclude` writes through, and in one transaction. */
+interface CheckoutOfferConclusionOptions {
+    /** Writes the contract an offer becomes, on the conclusion's transaction. */
+    subscriptionContractRepository: ProviderSpec<SubscriptionContractRepository>;
+    /** Finds the party the contract is with, or creates a sign-up's on the same transaction. */
+    subscriberRepository: ProviderSpec<SubscriberRepository>;
+    /** The transaction consuming the offer, the contract and the application's writes share. */
+    transactionRunner: ProviderSpec<TransactionRunner>;
+}
+interface CheckoutOfferModuleOptions {
+    checkoutOfferRepository: ProviderSpec<CheckoutOfferRepository>;
+    /**
+     * Bundle versions an offer can book: their prices, and whether they are
+     * still bookable on consume. Without it an offer carries no add-ons, and
+     * one that names a bundle version is refused.
+     */
+    bundleRepository?: ProviderSpec<BundleRepository>;
+    /**
+     * REQUIRED: the plan version on sale and its price, which every offer is
+     * priced from. Also the plan features for the requires validation.
+     */
+    planRepository: ProviderSpec<PlanRepository>;
+    /**
+     * The catalogue promotions an offer applies, the same ones the public
+     * catalogue shows. Without it an offer carries no promotion.
+     */
+    promotionRepository?: ProviderSpec<PromotionRepository>;
+    /**
+     * Optional for the requires validation (#35 P6): requires source =
+     * curated FeatureCatalogEntries. Without wiring, the validation is
+     * skipped (graceful).
+     */
+    catalogEntryRepository?: ProviderSpec<CatalogEntryRepository>;
+    /**
+     * Enables `CheckoutOfferService.conclude`, which consumes an offer and
+     * writes its contract in one transaction. Without it, `conclude` refuses
+     * to run rather than writing the two apart.
+     */
+    conclusion?: CheckoutOfferConclusionOptions;
+    /** Controller mount for `/public/checkout-offer`. Omitted = service only. */
+    controller?: CheckoutOfferControllerConfig;
+    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+    extraProviders?: Provider[];
+    global?: boolean;
+}
+declare class CheckoutOfferModule {
+    static forRoot(options: CheckoutOfferModuleOptions): DynamicModule;
+}
+
+export { type CheckoutOfferModuleOptions as C, type CheckoutOfferConclusionOptions as a, type CheckoutOfferControllerConfig as b, CheckoutOfferModule as c };

package/dist/checkout-offer.module-x7SP_dX4.d.ts

@@ -0,0 +1,58 @@
+import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
+import { SubscriptionContractRepository, SubscriberRepository, TransactionRunner, CheckoutOfferRepository, BundleRepository, PlanRepository, PromotionRepository, CatalogEntryRepository } from '@saasicat/core';
+import { P as ProviderSpec } from './di-CcNeq9v-.js';
+
+interface CheckoutOfferControllerConfig {
+    /** Class-level guards; `[]` for auth-free public endpoints. */
+    guards: Array<Type<CanActivate>>;
+}
+/** What `CheckoutOfferService.conclude` writes through, and in one transaction. */
+interface CheckoutOfferConclusionOptions {
+    /** Writes the contract an offer becomes, on the conclusion's transaction. */
+    subscriptionContractRepository: ProviderSpec<SubscriptionContractRepository>;
+    /** Finds the party the contract is with, or creates a sign-up's on the same transaction. */
+    subscriberRepository: ProviderSpec<SubscriberRepository>;
+    /** The transaction consuming the offer, the contract and the application's writes share. */
+    transactionRunner: ProviderSpec<TransactionRunner>;
+}
+interface CheckoutOfferModuleOptions {
+    checkoutOfferRepository: ProviderSpec<CheckoutOfferRepository>;
+    /**
+     * Bundle versions an offer can book: their prices, and whether they are
+     * still bookable on consume. Without it an offer carries no add-ons, and
+     * one that names a bundle version is refused.
+     */
+    bundleRepository?: ProviderSpec<BundleRepository>;
+    /**
+     * REQUIRED: the plan version on sale and its price, which every offer is
+     * priced from. Also the plan features for the requires validation.
+     */
+    planRepository: ProviderSpec<PlanRepository>;
+    /**
+     * The catalogue promotions an offer applies, the same ones the public
+     * catalogue shows. Without it an offer carries no promotion.
+     */
+    promotionRepository?: ProviderSpec<PromotionRepository>;
+    /**
+     * Optional for the requires validation (#35 P6): requires source =
+     * curated FeatureCatalogEntries. Without wiring, the validation is
+     * skipped (graceful).
+     */
+    catalogEntryRepository?: ProviderSpec<CatalogEntryRepository>;
+    /**
+     * Enables `CheckoutOfferService.conclude`, which consumes an offer and
+     * writes its contract in one transaction. Without it, `conclude` refuses
+     * to run rather than writing the two apart.
+     */
+    conclusion?: CheckoutOfferConclusionOptions;
+    /** Controller mount for `/public/checkout-offer`. Omitted = service only. */
+    controller?: CheckoutOfferControllerConfig;
+    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+    extraProviders?: Provider[];
+    global?: boolean;
+}
+declare class CheckoutOfferModule {
+    static forRoot(options: CheckoutOfferModuleOptions): DynamicModule;
+}
+
+export { type CheckoutOfferModuleOptions as C, type CheckoutOfferConclusionOptions as a, type CheckoutOfferControllerConfig as b, CheckoutOfferModule as c };

package/dist/checkout-offer.service-BeHgYikI.d.ts

@@ -0,0 +1,242 @@
+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-CPZrTM9C.js';
+import { S as SubscriberService } from './subscriber.service-5W6Gi-1B.js';
+import { a as PromoCodesService } from './promo.service-CFjfF0Xm.js';
+
+type Cycle = 'monthly' | 'yearly';
+/** What pricing needs to know about a selection. */
+interface CheckoutOfferPricingInput {
+    planKey: string;
+    billingCycle: Cycle;
+    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 {
+    planVersionId: string;
+    bundles: string[];
+    bundleVersionIds: string[];
+    promotionId: string | null;
+    promoCode: string | null;
+    priceBreakdown: CheckoutOfferPriceBreakdown;
+    lineItems: CheckoutOfferLineItem[];
+    promotionSnapshots: CheckoutOfferPromotionSnapshot[];
+    promoCodeSnapshot: CheckoutOfferPromoCodeSnapshot | null;
+}
+declare class CheckoutOfferPricing {
+    private readonly settings;
+    private readonly plans;
+    private readonly bundles;
+    private readonly promotions;
+    private readonly promoCodes;
+    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>;
+    /**
+     * Throws unless the offer's stored amounts are what this pricing makes of
+     * its own selection: the plan and bundle versions it froze, and the
+     * promotions as they stood when it was last priced.
+     */
+    assertPricedByCatalogue(offer: CheckoutOfferRow): Promise<void>;
+    private compute;
+    /** The plan version on sale for new bookings, as the public catalogue resolves it. */
+    private planVersionOnSale;
+    /** A plan without a list price is not sold at one (`SC-PRIC-011`). */
+    private assertPlanPriced;
+    private bundleVersionsFor;
+    private pricePlan;
+    private priceBundle;
+    private line;
+    /**
+     * The promo code's discount on the plan, after its promotion.
+     *
+     * Eligibility is the promo module's to decide, and it decides on its own
+     * terms: status, validity, the plan and rhythm the code is limited to. Only
+     * the amount is computed here, on the price this offer actually carries.
+     */
+    private pricePromoCode;
+}
+
+/** What concluding an offer produced: the consumed offer and its contract. */
+interface ConcludedCheckoutOffer {
+    offer: CheckoutOfferRow;
+    contract: SubscriptionContractRecord;
+}
+/** How an offer is concluded, and for whom. */
+interface ConcludeCheckoutOfferOptions extends CreateContractFromOfferOptions {
+    /**
+     * The subscriber of a tenant that does not have one yet, created on the
+     * conclusion's transaction before its contract — what a sign-up passes,
+     * `subscriberFromRegistration(pending)` giving the details. Left out, the
+     * tenant's existing subscriber is the party; a tenant with neither is
+     * refused with `SUBSCRIBER_REQUIRED`, and one that already has a subscriber
+     * with `SUBSCRIBER_ALREADY_EXISTS`.
+     */
+    subscriber?: NewSubscriberDetails;
+    /**
+     * The transaction to conclude on, when the caller already holds one. A
+     * sign-up's activation does: the gateway's confirmation is claimed on it,
+     * and the offer, the subscriber, the contract and `within` are written on
+     * it and undone with it. Left out, the conclusion opens a transaction of
+     * its own.
+     */
+    tx?: TransactionContext;
+}
+/**
+ * The application's own writes that belong to concluding an offer, such as
+ * starting its subscription. They run on the same transaction, after the offer
+ * is consumed and its contract written; throwing undoes all of it.
+ */
+type ConcludeCheckoutOfferWithin = (tx: TransactionContext, concluded: ConcludedCheckoutOffer) => Promise<void>;
+declare class CheckoutOfferService {
+    private readonly repo;
+    private readonly pricing;
+    private readonly bundles;
+    private readonly plans;
+    private readonly catalogEntries;
+    private readonly contracts;
+    private readonly transactions;
+    private readonly subscribers;
+    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. 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
+     * as `Subscription.packageSnapshot`.
+     *
+     * Refused unless every add-on is still bookable and the stored amounts are
+     * what the catalogue makes of the offer's own selection, so an offer whose
+     * amounts were written by anything but the pricing never becomes a contract.
+     *
+     * The plan, the add-ons and the promotions are priced as they stood when the
+     * offer was priced; a promo code is checked with the promo module as it
+     * stands now. A code is redeemed when the contract is concluded, so one that
+     * has expired or run out of redemptions since refuses the offer with
+     * `CHECKOUT_OFFER_PROMO_CODE_NOT_ACCEPTED`; `CHECKOUT_OFFER_PRICE_NOT_CURRENT`
+     * is kept for amounts that no longer match.
+     */
+    consume(id: string): Promise<CheckoutOfferRow>;
+    /**
+     * Consumes an offer and creates its contract in one transaction, together
+     * with the application's own writes in `within`, so an offer is never
+     * consumed without its contract, and no contract is written for an offer
+     * that stays open.
+     *
+     * Everything that can refuse runs before the transaction: what `consume`
+     * checks, and the checks the contract the offer becomes is held to. Inside
+     * it, the offer is consumed on the condition that it is still open, the
+     * contract is written, and `within` runs; an error in any of them undoes
+     * the others, and the offer can be concluded again.
+     *
+     * An offer that is already concluded for the same tenant answers with its
+     * contract rather than a refusal, so a caller retrying after a lost answer,
+     * or losing a race to another call for that tenant, gets the conclusion that
+     * stands; `within` does not run again, its writes committed with it. A
+     * conclusion for another tenant is refused with
+     * `CHECKOUT_OFFER_ALREADY_CONSUMED`, and an offer changed between the checks
+     * and the transaction with `CHECKOUT_OFFER_CHANGED`, nothing written.
+     *
+     * The contract is between the tenant's subscriber and the configured
+     * issuer. A sign-up creates the tenant in `within` and has no subscriber
+     * yet, so it passes `subscriber`, which is created on the same transaction
+     * before the contract; whether one may be created, or whether the tenant
+     * has one, is asked before the transaction with the other checks.
+     *
+     * A promo code on the offer is redeemed in `within`, with
+     * `PromoCodesService.redeemInTransaction` on the same transaction. Before
+     * the transaction the code is only checked the way pricing checks it; the
+     * redemption checks the rest, the customer and the remaining redemptions,
+     * 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;
+    /**
+     * The conclusion that stands for this tenant, if the offer has one. An offer
+     * carries no tenant and its id travels in a link, so a conclusion for
+     * another tenant is not an answer: that caller is refused as before.
+     */
+    private standingConclusion;
+    private conclusionPorts;
+    /**
+     * Before anything is written: the subscriber to create is one that may be
+     * created, or the tenant already has the party the contract is with.
+     */
+    private assertParty;
+    /**
+     * #35 P6 — server-side requires validation: the dependencies of all
+     * features (plan ∪ selected bundles) must be covered within the
+     * selection, otherwise an offer would be created whose features cannot
+     * work at the tenant (an app-specific validateModuleDependencies check is
+     * thereby replaced on the platform side). The requires source are the
+     * curated FeatureCatalogEntries; without CatalogEntryRepository it is
+     * skipped (graceful — no requires data available).
+     */
+    private assertFeatureRequiresSatisfied;
+    /**
+     * Plan features preferably from the server SSOT (PlanRepository); fallback
+     * is the frozen featuresSnapshot of the plan LineItem (adapter without
+     * PlanRepository wiring).
+     */
+    private resolvePlanFeatures;
+    /** Bundle features from the BundleVersions; fallback featuresSnapshot. */
+    private resolveBundleFeatures;
+    private assertBundleVersionsStillBookable;
+    private assertOpen;
+    private isExpired;
+}
+
+export { CheckoutOfferPricing as C, type PricedCheckoutOffer as P, type CheckoutOfferPricingInput as a, CheckoutOfferService as b, type ConcludeCheckoutOfferOptions as c, type ConcludeCheckoutOfferWithin as d, type ConcludedCheckoutOffer as e };