@saasicat/nest 1.0.0-rc.14 → 1.0.0-rc.15

package/dist/.build-stamp

@@ -1 +1 @@
-d16cb942d700188830a8fcabcf7358a1569dbb615945cef61e725d328e2b63bb
+5b5c697fcb7f0f396443441223db4c63896950ff67b89351b80f193bfc738b7d

package/dist/_entries.cjs

@@ -4962,9 +4962,14 @@ var SubscriptionContractService = class {
     }
     return subscriptionContractToInvoiceSnapshot(contract);
   }
-  async create(data) {
+  /** With `tx`, the contract is written on that transaction and undone with it. */
+  async create(data, tx) {
     this.assertCreateData(data);
-    return this.repo.create(this.cloneCreateData(data));
+    return this.repo.create(this.cloneCreateData(data), tx);
+  }
+  /** The contract concluded from a checkout offer, or `null` when none was. */
+  findByOriginalOfferId(offerId, tx) {
+    return this.repo.findByOriginalOfferId(offerId, tx);
   }
   async terminate(contractId, data) {
     const existing = await this.getById(contractId);
@@ -5002,6 +5007,20 @@ var SubscriptionContractService = class {
         }
       });
     }
+    return this.dataFromOffer(offer, options);
+  }
+  /**
+   * The contract an offer becomes, checked the way `create` checks it, before
+   * anything is written. Unlike `createDataFromOffer` it takes an offer that
+   * is still open: concluding an offer refuses a contract it could not create
+   * before the offer is consumed, rather than after.
+   */
+  prepareFromOffer(offer, options) {
+    const data = this.dataFromOffer(offer, options);
+    this.assertCreateData(data);
+    return data;
+  }
+  dataFromOffer(offer, options) {
     const lineItems = this.lineItemsFromOffer(offer);
     return {
       tenantId: options.tenantId,
@@ -13933,6 +13952,7 @@ __name(runSeedGateFromFile, "runSeedGateFromFile");
 var checkout_offer_exports = {};
 __export(checkout_offer_exports, {
   CHECKOUT_OFFER_REPOSITORY_TOKEN: () => CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN: () => CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
   CheckoutOfferModule: () => CheckoutOfferModule,
   CheckoutOfferPricing: () => CheckoutOfferPricing,
   CheckoutOfferService: () => CheckoutOfferService,
@@ -13942,6 +13962,7 @@ __export(checkout_offer_exports, {
 });
 
 // src/checkout-offer/checkout-offer.service.ts
+var import_node_util = require("util");
 var import_common63 = require("@nestjs/common");
 var import_core40 = require("@saasicat/core");
 
@@ -14349,6 +14370,7 @@ __name(promoCodeNotAccepted, "promoCodeNotAccepted");
 
 // src/checkout-offer/checkout-offer.tokens.ts
 var CHECKOUT_OFFER_REPOSITORY_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/CheckoutOfferRepository");
+var CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN = /* @__PURE__ */ Symbol.for("saasicat/nest/CheckoutOfferTransactionRunner");
 
 // src/checkout-offer/checkout-offer.service.ts
 function _ts_decorate67(decorators, target, key, desc) {
@@ -14378,12 +14400,16 @@ var CheckoutOfferService = class {
   bundles;
   plans;
   catalogEntries;
-  constructor(repo, pricing, bundles = null, plans = null, catalogEntries = null) {
+  contracts;
+  transactions;
+  constructor(repo, pricing, bundles = null, plans = null, catalogEntries = null, contracts = null, transactions = null) {
     this.repo = repo;
     this.pricing = pricing;
     this.bundles = bundles;
     this.plans = plans;
     this.catalogEntries = catalogEntries;
+    this.contracts = contracts;
+    this.transactions = transactions;
   }
   list(filter) {
     return this.repo.list(filter);
@@ -14473,11 +14499,101 @@ var CheckoutOfferService = class {
    * is kept for amounts that no longer match.
    */
   async consume(id) {
+    await this.assertConsumable(id);
+    return this.repo.consume(id);
+  }
+  /**
+   * 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.
+   *
+   * 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.
+   */
+  async conclude(id, options, within) {
+    const { contracts, transactions } = this.conclusionPorts();
+    const { tenantId } = options;
+    const standing = await this.standingConclusion(await this.getById(id), contracts, tenantId);
+    if (standing) return standing;
+    const existing = await this.assertConsumable(id);
+    const checked = contracts.prepareFromOffer(existing, options);
+    let consumeFailed = false;
+    try {
+      return await transactions.run(async (tx) => {
+        consumeFailed = false;
+        let offer;
+        try {
+          offer = await this.repo.consume(id, tx);
+        } catch (error) {
+          consumeFailed = true;
+          throw error;
+        }
+        const data = contracts.prepareFromOffer(offer, options);
+        if (!(0, import_node_util.isDeepStrictEqual)(data, checked)) throw offerChanged(id);
+        const contract = await contracts.create(data, tx);
+        const concluded = {
+          offer,
+          contract
+        };
+        if (within) await within(tx, concluded);
+        return concluded;
+      });
+    } catch (error) {
+      if (!consumeFailed) throw error;
+      const offer = await this.repo.findById(id).catch(() => null);
+      const concludedMeanwhile = await this.standingConclusion(offer, contracts, tenantId).catch(() => null);
+      if (concludedMeanwhile) return concludedMeanwhile;
+      throw error;
+    }
+  }
+  async assertConsumable(id) {
     const existing = await this.getById(id);
     this.assertOpen(existing, "consumed");
     await this.assertBundleVersionsStillBookable(existing);
     await this.pricing.assertPricedByCatalogue(existing);
-    return this.repo.consume(id);
+    return existing;
+  }
+  /**
+   * 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.
+   */
+  async standingConclusion(offer, contracts, tenantId) {
+    if (!offer || offer.status !== "consumed") return null;
+    const contract = await contracts.findByOriginalOfferId(offer.id);
+    return contract && contract.tenantId === tenantId ? {
+      offer,
+      contract
+    } : null;
+  }
+  conclusionPorts() {
+    if (!this.contracts || !this.transactions) {
+      throw new Error("CheckoutOfferService.conclude needs the subscription contract repository and a transaction runner: pass `conclusion` to CheckoutOfferModule.forRoot, or give SaaSiCatModule.forRoot a persistence bundle that has both.");
+    }
+    return {
+      contracts: this.contracts,
+      transactions: this.transactions
+    };
   }
   /**
    * #35 P6 — server-side requires validation: the dependencies of all
@@ -14615,15 +14731,31 @@ CheckoutOfferService = _ts_decorate67([
   _ts_param45(3, (0, import_common63.Inject)(PLAN_REPOSITORY_TOKEN)),
   _ts_param45(4, (0, import_common63.Optional)()),
   _ts_param45(4, (0, import_common63.Inject)(CATALOG_ENTRY_REPOSITORY_TOKEN)),
+  _ts_param45(5, (0, import_common63.Optional)()),
+  _ts_param45(5, (0, import_common63.Inject)(SubscriptionContractService)),
+  _ts_param45(6, (0, import_common63.Optional)()),
+  _ts_param45(6, (0, import_common63.Inject)(CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN)),
   _ts_metadata55("design:type", Function),
   _ts_metadata55("design:paramtypes", [
     typeof CheckoutOfferRepository === "undefined" ? Object : CheckoutOfferRepository,
     typeof CheckoutOfferPricing === "undefined" ? Object : CheckoutOfferPricing,
     Object,
     Object,
+    Object,
+    Object,
     Object
   ])
 ], CheckoutOfferService);
+function offerChanged(offerId) {
+  return new import_common63.ConflictException({
+    code: import_core40.CONTRACT_ERROR_CODES.CHECKOUT_OFFER_CHANGED,
+    message: `Checkout offer '${offerId}' changed while it was being concluded. Load it again.`,
+    params: {
+      offerId
+    }
+  });
+}
+__name(offerChanged, "offerChanged");
 
 // src/checkout-offer/checkout-offer.controller.ts
 var import_common64 = require("@nestjs/common");
@@ -14840,6 +14972,9 @@ var CheckoutOfferModule = class _CheckoutOfferModule {
     if (!options.planRepository) {
       throw new Error("CheckoutOfferModule: `planRepository` is required \u2014 every offer is priced from the plan version on sale, and an offer without it would have to take its price from the request.");
     }
+    if (options.conclusion && (!options.conclusion.subscriptionContractRepository || !options.conclusion.transactionRunner)) {
+      throw new Error("CheckoutOfferModule: `conclusion` needs both `subscriptionContractRepository` and `transactionRunner` \u2014 concluding an offer writes the contract and consumes the offer in one transaction, and without either it would do only half.");
+    }
     const controllers = [];
     if (options.controller) {
       controllers.push(buildCheckoutOfferController(options.controller.guards));
@@ -14861,6 +14996,11 @@ var CheckoutOfferModule = class _CheckoutOfferModule {
         ...options.catalogEntryRepository ? [
           asProvider(CATALOG_ENTRY_REPOSITORY_TOKEN, options.catalogEntryRepository)
         ] : [],
+        ...options.conclusion ? [
+          asProvider(SUBSCRIPTION_CONTRACT_REPOSITORY_TOKEN, options.conclusion.subscriptionContractRepository),
+          asProvider(CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN, options.conclusion.transactionRunner),
+          SubscriptionContractService
+        ] : [],
         CheckoutOfferPricing,
         CheckoutOfferService,
         ...options.extraProviders ?? []
@@ -16122,9 +16262,11 @@ function composeAdminStats({ options, persistence }) {
   ];
 }
 __name(composeAdminStats, "composeAdminStats");
-function composeCheckoutOffer({ options, persistence }) {
+function composeCheckoutOffer({ options, adapters, persistence }) {
   const config = options.checkoutOffer;
   if (!config) return [];
+  const contractRepository = config.conclusion?.subscriptionContractRepository ?? persistence?.entitlement?.subscriptionContractRepository;
+  const transactionRunner = config.conclusion?.transactionRunner ?? adapters.transactionRunner;
   return [
     CheckoutOfferModule.forRoot({
       ...config,
@@ -16132,6 +16274,13 @@ function composeCheckoutOffer({ options, persistence }) {
       planRepository: config.planRepository ?? persistence?.catalog?.planRepository,
       promotionRepository: config.promotionRepository ?? persistence?.catalog?.promotionRepository,
       catalogEntryRepository: config.catalogEntryRepository ?? persistence?.catalog?.catalogEntryRepository,
+      // Named by hand, it is passed on even when half of it resolves to
+      // nothing, so the module refuses to start the same way it does when
+      // wired directly; derived from the bundle, it is wired when both exist.
+      conclusion: config.conclusion || contractRepository && transactionRunner ? {
+        subscriptionContractRepository: contractRepository,
+        transactionRunner
+      } : void 0,
       imports: config.imports ?? options.imports
     })
   ];
@@ -20098,6 +20247,7 @@ __export(src_exports, {
   CATALOG_FEATURE_UI_REGISTRY_TOKEN: () => CATALOG_FEATURE_UI_REGISTRY_TOKEN,
   CATALOG_SERVICE_CONFIG_TOKEN: () => CATALOG_SERVICE_CONFIG_TOKEN,
   CHECKOUT_OFFER_REPOSITORY_TOKEN: () => CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN: () => CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
   CODE_MAX_LENGTH: () => CODE_MAX_LENGTH,
   CODE_MIN_LENGTH: () => CODE_MIN_LENGTH,
   CODE_PATTERN: () => CODE_PATTERN,
@@ -20615,6 +20765,12 @@ var FakeSubscriptionContractRepository = class {
     ].filter((row) => row.tenantId === tenantId).filter((row) => this.isActiveAt(row, asOf)).sort((a, b) => b.effectiveFrom.getTime() - a.effectiveFrom.getTime())[0];
     return active ? this.cloneRecord(active) : null;
   }
+  async findByOriginalOfferId(offerId) {
+    const first = [
+      ...this.byId.values()
+    ].find((row) => row.originalOfferId === offerId);
+    return first ? this.cloneRecord(first) : null;
+  }
   async create(data) {
     const now = /* @__PURE__ */ new Date();
     const id = `contract-${this.nextContractId++}`;

package/dist/billing/index.d.cts

@@ -9,7 +9,7 @@ export { Type as NestType } from '@nestjs/common';
 import { Reflector, BaseExceptionFilter } from '@nestjs/core';
 import { c as EntitlementService } from '../aggregation-BHo7a_In.cjs';
 import { P as ProviderSpec } from '../di-CcNeq9v-.cjs';
-import { S as SubscriptionContractService } from '../subscription-contract.service-hD87MKyg.cjs';
+import { S as SubscriptionContractService } from '../subscription-contract.service-wMqIPFkS.cjs';
 import '../promo.service-CBMm9RU7.cjs';
 import '../admin-audit.service-4P3Djdxk.cjs';
 import '../contract-line-item-money-BWWQhRul.cjs';

package/dist/billing/index.d.ts

@@ -9,7 +9,7 @@ export { Type as NestType } from '@nestjs/common';
 import { Reflector, BaseExceptionFilter } from '@nestjs/core';
 import { c as EntitlementService } from '../aggregation-CtIjlWHT.js';
 import { P as ProviderSpec } from '../di-CcNeq9v-.js';
-import { S as SubscriptionContractService } from '../subscription-contract.service-hD87MKyg.js';
+import { S as SubscriptionContractService } from '../subscription-contract.service-wMqIPFkS.js';
 import '../promo.service-CBMm9RU7.js';
 import '../admin-audit.service-4P3Djdxk.js';
 import '../contract-line-item-money-BWWQhRul.js';

package/dist/billing/index.js

@@ -20,7 +20,7 @@ import {
   computeCarriedTrialEndsAt,
   computeNextPeriod,
   decideRenewal
-} from "../chunk-KOZYQS53.js";
+} from "../chunk-2TACP6MQ.js";
 import {
   AddSubscriptionBundleDto,
   BILLING_FEATURE_UI_REGISTRY_TOKEN,
@@ -80,8 +80,7 @@ import {
   resolveBundleCancelEffectiveAt,
   resolvePlanAnchorDay,
   retreatOneCycle
-} from "../chunk-O4M5HC2B.js";
-import "../chunk-E2GFA4J2.js";
+} from "../chunk-62WEP34A.js";
 import {
   AUDIT_CONTEXT_RESOLVER_TOKEN,
   CANCELLATION_NOTICE_DAYS_TOKEN,
@@ -98,20 +97,22 @@ import {
   classifyPlanDiff
 } from "../chunk-O6I7X4OG.js";
 import "../chunk-DQEU4UNU.js";
-import "../chunk-O2J2HDXA.js";
-import "../chunk-FAH62CAJ.js";
-import "../chunk-DR2SQNMX.js";
+import "../chunk-LEZ6KYQ7.js";
 import {
   cyclesSoldFor,
   resolveBundlePriceNet
 } from "../chunk-KPEMTBOP.js";
-import "../chunk-YSC46BGM.js";
 import {
   SUBSCRIPTION_BUNDLE_CONFIG_TOKEN,
   SUBSCRIPTION_BUNDLE_REPOSITORY_TOKEN
-} from "../chunk-HRUVUY5E.js";
-import "../chunk-VBRYPU7V.js";
+} from "../chunk-JMV6J7YP.js";
 import "../chunk-OUDSQ3PU.js";
+import "../chunk-VBRYPU7V.js";
+import "../chunk-AOQJEYOL.js";
+import "../chunk-QUZU2M33.js";
+import "../chunk-O2J2HDXA.js";
+import "../chunk-FAH62CAJ.js";
+import "../chunk-YSC46BGM.js";
 import "../chunk-57V6ZTI6.js";
 import {
   PLAN_CATALOG_READ_SINK_TOKEN,
@@ -132,9 +133,7 @@ import {
 } from "../chunk-UUDUEQXA.js";
 import "../chunk-5BCYJ3QY.js";
 import "../chunk-QSBMFY4I.js";
-import "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
-import "../chunk-QUZU2M33.js";
 import "../chunk-SHUYVCID.js";
 export {
   AUDIT_CONTEXT_RESOLVER_TOKEN,

package/dist/catalog/index.js

@@ -6,7 +6,7 @@ import {
   runSeedGateFromFile,
   seedGateExitCode,
   validateSeedAgainstSnapshot
-} from "../chunk-FKAWM74T.js";
+} from "../chunk-45B4OQOO.js";
 import "../chunk-74SCJ4HF.js";
 import {
   ADVISORY_STRICT_MODE_CODES,
@@ -57,15 +57,12 @@ import {
   resolveValidityWindow,
   validateBundleDraft,
   validatePlanDraft
-} from "../chunk-AFZQ7GTQ.js";
+} from "../chunk-GYI3E2YY.js";
 import "../chunk-O6I7X4OG.js";
 import "../chunk-DQEU4UNU.js";
-import "../chunk-O2J2HDXA.js";
 import "../chunk-KPEMTBOP.js";
-import "../chunk-YSC46BGM.js";
 import "../chunk-JVAEKTJ4.js";
 import "../chunk-OUDSQ3PU.js";
-import "../chunk-57V6ZTI6.js";
 import {
   BUNDLE_REPOSITORY_TOKEN,
   CATALOG_ENTRY_REPOSITORY_TOKEN,
@@ -76,8 +73,11 @@ import {
   PLAN_REPOSITORY_TOKEN,
   PROMOTION_REPOSITORY_TOKEN
 } from "../chunk-AOQJEYOL.js";
-import "../chunk-SABTXESR.js";
 import "../chunk-QUZU2M33.js";
+import "../chunk-O2J2HDXA.js";
+import "../chunk-YSC46BGM.js";
+import "../chunk-57V6ZTI6.js";
+import "../chunk-SABTXESR.js";
 import "../chunk-SHUYVCID.js";
 export {
   ADVISORY_STRICT_MODE_CODES,

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

@@ -1,7 +1,8 @@
-export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, P as PricedCheckoutOffer } from '../checkout-offer.service-C5-YWUrp.cjs';
+export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferWithin, d as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-Dknxgj6W.cjs';
 import { Type, CanActivate } from '@nestjs/common';
-export { a as CheckoutOfferControllerConfig, b as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-B1O0H8EQ.cjs';
+export { a as CheckoutOfferConclusionOptions, b as CheckoutOfferControllerConfig, c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-BOX9yAWq.cjs';
 import { CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
+import '../subscription-contract.service-wMqIPFkS.cjs';
 import '../promo.service-CBMm9RU7.cjs';
 import '../di-CcNeq9v-.cjs';
 
@@ -9,6 +10,11 @@ declare function buildCheckoutOfferController(guards: Array<Type<CanActivate>>):
 
 /** 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 implements CheckoutOfferSelection {
     planKey: string;
@@ -26,4 +32,4 @@ declare class UpdateCheckoutOfferDto implements CheckoutOfferSelectionUpdate {
     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,7 +1,8 @@
-export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, P as PricedCheckoutOffer } from '../checkout-offer.service-BIGkcWNe.js';
+export { C as CheckoutOfferPricing, a as CheckoutOfferPricingInput, b as CheckoutOfferService, c as ConcludeCheckoutOfferWithin, d as ConcludedCheckoutOffer, P as PricedCheckoutOffer } from '../checkout-offer.service-BZumQOmZ.js';
 import { Type, CanActivate } from '@nestjs/common';
-export { a as CheckoutOfferControllerConfig, b as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-BVXEDXex.js';
+export { a as CheckoutOfferConclusionOptions, b as CheckoutOfferControllerConfig, c as CheckoutOfferModule, C as CheckoutOfferModuleOptions } from '../checkout-offer.module-B-DF2I_-.js';
 import { CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
+import '../subscription-contract.service-wMqIPFkS.js';
 import '../promo.service-CBMm9RU7.js';
 import '../di-CcNeq9v-.js';
 
@@ -9,6 +10,11 @@ declare function buildCheckoutOfferController(guards: Array<Type<CanActivate>>):
 
 /** 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 implements CheckoutOfferSelection {
     planKey: string;
@@ -26,4 +32,4 @@ declare class UpdateCheckoutOfferDto implements CheckoutOfferSelectionUpdate {
     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,25 +1,28 @@
 import "../chunk-DFOW3JVO.js";
 import {
   CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
   CheckoutOfferModule,
   CheckoutOfferPricing,
   CheckoutOfferService,
   CreateCheckoutOfferDto,
   UpdateCheckoutOfferDto,
   buildCheckoutOfferController
-} from "../chunk-L7PTXFJE.js";
-import "../chunk-FAH62CAJ.js";
-import "../chunk-DR2SQNMX.js";
+} from "../chunk-H3GVIQVK.js";
+import "../chunk-LEZ6KYQ7.js";
 import "../chunk-KPEMTBOP.js";
+import "../chunk-VBRYPU7V.js";
+import "../chunk-AOQJEYOL.js";
+import "../chunk-FAH62CAJ.js";
 import "../chunk-YSC46BGM.js";
 import "../chunk-UUDUEQXA.js";
 import "../chunk-5BCYJ3QY.js";
 import "../chunk-QSBMFY4I.js";
-import "../chunk-AOQJEYOL.js";
 import "../chunk-SABTXESR.js";
 import "../chunk-SHUYVCID.js";
 export {
   CHECKOUT_OFFER_REPOSITORY_TOKEN,
+  CHECKOUT_OFFER_TRANSACTION_RUNNER_TOKEN,
   CheckoutOfferModule,
   CheckoutOfferPricing,
   CheckoutOfferService,

package/dist/{checkout-offer.module-BVXEDXex.d.ts → checkout-offer.module-B-DF2I_-.d.ts}

@@ -1,11 +1,18 @@
 import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
-import { CheckoutOfferRepository, BundleRepository, PlanRepository, PromotionRepository, CatalogEntryRepository } from '@saasicat/core';
+import { SubscriptionContractRepository, 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>;
+    /** The transaction consuming the offer, the contract and the application's writes share. */
+    transactionRunner: ProviderSpec<TransactionRunner>;
+}
 interface CheckoutOfferModuleOptions {
     checkoutOfferRepository: ProviderSpec<CheckoutOfferRepository>;
     /**
@@ -30,6 +37,12 @@ interface CheckoutOfferModuleOptions {
      * 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>;
@@ -40,4 +53,4 @@ declare class CheckoutOfferModule {
     static forRoot(options: CheckoutOfferModuleOptions): DynamicModule;
 }
 
-export { type CheckoutOfferModuleOptions as C, type CheckoutOfferControllerConfig as a, CheckoutOfferModule as b };
+export { type CheckoutOfferModuleOptions as C, type CheckoutOfferConclusionOptions as a, type CheckoutOfferControllerConfig as b, CheckoutOfferModule as c };

package/dist/{checkout-offer.module-B1O0H8EQ.d.cts → checkout-offer.module-BOX9yAWq.d.cts}

@@ -1,11 +1,18 @@
 import { Type, CanActivate, DynamicModule, ForwardReference, Provider } from '@nestjs/common';
-import { CheckoutOfferRepository, BundleRepository, PlanRepository, PromotionRepository, CatalogEntryRepository } from '@saasicat/core';
+import { SubscriptionContractRepository, 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>;
+    /** The transaction consuming the offer, the contract and the application's writes share. */
+    transactionRunner: ProviderSpec<TransactionRunner>;
+}
 interface CheckoutOfferModuleOptions {
     checkoutOfferRepository: ProviderSpec<CheckoutOfferRepository>;
     /**
@@ -30,6 +37,12 @@ interface CheckoutOfferModuleOptions {
      * 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>;
@@ -40,4 +53,4 @@ declare class CheckoutOfferModule {
     static forRoot(options: CheckoutOfferModuleOptions): DynamicModule;
 }
 
-export { type CheckoutOfferModuleOptions as C, type CheckoutOfferControllerConfig as a, CheckoutOfferModule as b };
+export { type CheckoutOfferModuleOptions as C, type CheckoutOfferConclusionOptions as a, type CheckoutOfferControllerConfig as b, CheckoutOfferModule as c };

package/dist/{checkout-offer.service-BIGkcWNe.d.ts → checkout-offer.service-BZumQOmZ.d.ts}

@@ -1,4 +1,5 @@
-import { PlanCatalog, PlanRepository, BundleRepository, PromotionRepository, CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot, CheckoutOfferRow, CheckoutOfferRepository, CatalogEntryRepository, CheckoutOfferFilter, CheckoutOfferSelection, CheckoutOfferSelectionUpdate } from '@saasicat/core';
+import { PlanCatalog, PlanRepository, BundleRepository, PromotionRepository, CheckoutOfferPriceBreakdown, CheckoutOfferLineItem, CheckoutOfferPromotionSnapshot, CheckoutOfferPromoCodeSnapshot, CheckoutOfferRow, CheckoutOfferRepository, CatalogEntryRepository, TransactionRunner, CheckoutOfferFilter, CheckoutOfferSelection, CheckoutOfferSelectionUpdate, TransactionContext, SubscriptionContractRecord } from '@saasicat/core';
+import { S as SubscriptionContractService, C as CreateContractFromOfferOptions } from './subscription-contract.service-wMqIPFkS.js';
 import { a as PromoCodesService } from './promo.service-CBMm9RU7.js';
 
 type Cycle = 'monthly' | 'yearly';
@@ -56,13 +57,26 @@ declare class CheckoutOfferPricing {
     private pricePromoCode;
 }
 
+/** What concluding an offer produced: the consumed offer and its contract. */
+interface ConcludedCheckoutOffer {
+    offer: CheckoutOfferRow;
+    contract: SubscriptionContractRecord;
+}
+/**
+ * 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;
-    constructor(repo: CheckoutOfferRepository, pricing: CheckoutOfferPricing, bundles?: BundleRepository | null, plans?: PlanRepository | null, catalogEntries?: CatalogEntryRepository | null);
+    private readonly contracts;
+    private readonly transactions;
+    constructor(repo: CheckoutOfferRepository, pricing: CheckoutOfferPricing, bundles?: BundleRepository | null, plans?: PlanRepository | null, catalogEntries?: CatalogEntryRepository | null, contracts?: SubscriptionContractService | null, transactions?: TransactionRunner | null);
     list(filter: CheckoutOfferFilter): Promise<CheckoutOfferRow[]>;
     getById(id: string): Promise<CheckoutOfferRow>;
     /** Prices what the caller chose and stores it as an open offer. */
@@ -89,6 +103,43 @@ declare class CheckoutOfferService {
      * 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.
+     *
+     * 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.
+     */
+    conclude(id: string, options: CreateContractFromOfferOptions, 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;
     /**
      * #35 P6 — server-side requires validation: the dependencies of all
      * features (plan ∪ selected bundles) must be covered within the
@@ -112,4 +163,4 @@ declare class CheckoutOfferService {
     private isExpired;
 }
 
-export { CheckoutOfferPricing as C, type PricedCheckoutOffer as P, type CheckoutOfferPricingInput as a, CheckoutOfferService as b };
+export { CheckoutOfferPricing as C, type PricedCheckoutOffer as P, type CheckoutOfferPricingInput as a, CheckoutOfferService as b, type ConcludeCheckoutOfferWithin as c, type ConcludedCheckoutOffer as d };