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

package/dist/.build-stamp

@@ -1 +1 @@
-ffbbf3de488fa65a264bc00b14097f9d84d9da3428b766d0c2c6b74ccac9b249
+785f84b789c4fbc325a4d35f81dec979a2575832412363bbcf2fbbe87995e875

package/dist/index.cjs

@@ -664,6 +664,12 @@ var CONTRACT_ERROR_CODES = {
   CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED",
   CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED",
+  /**
+   * The offer changed between the checks of `conclude` and the transaction
+   * that consumed it, so the contract checked is not the one the offer now
+   * describes. Nothing was written; load the offer and conclude it again.
+   */
+  CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED"
@@ -1147,6 +1153,7 @@ var ERROR_MESSAGES_EN = {
   CHECKOUT_OFFER_EXPIRED: "Checkout offer '{offerId}' has expired and cannot be {action}",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "Checkout offer '{offerId}' has already been consumed and cannot be {action}",
   CHECKOUT_OFFER_NOT_CONSUMED: "CheckoutOffer '{offerId}' must be consumed before the contract is created",
+  CHECKOUT_OFFER_CHANGED: "Checkout offer '{offerId}' changed while it was being concluded. Load it again.",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SubscriptionContract '{contractId}' not found",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "No active subscription contract for tenant {tenantId}",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SubscriptionContract '{contractId}' is already closed",
@@ -1336,6 +1343,7 @@ var ERROR_MESSAGES_DE = {
   CHECKOUT_OFFER_EXPIRED: "Checkout-Angebot '{offerId}' ist abgelaufen \u2014 '{action}' ist nicht mehr m\xF6glich",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "Checkout-Angebot '{offerId}' wurde bereits eingel\xF6st \u2014 '{action}' ist nicht mehr m\xF6glich",
   CHECKOUT_OFFER_NOT_CONSUMED: "CheckoutOffer '{offerId}' muss eingel\xF6st sein, bevor der Vertrag entsteht",
+  CHECKOUT_OFFER_CHANGED: "Checkout-Angebot '{offerId}' hat sich w\xE4hrend des Abschlusses ge\xE4ndert. Bitte neu laden.",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SubscriptionContract '{contractId}' nicht gefunden",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "Kein aktiver Abo-Vertrag f\xFCr Mandant {tenantId}",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SubscriptionContract '{contractId}' ist bereits geschlossen",

package/dist/index.d.cts

@@ -3085,7 +3085,15 @@ interface SubscriptionContractRepository {
      * instead of drawing an extra pool connection (starvation guard, #70).
      */
     findActiveByTenantId(tenantId: string, asOf?: Date, tx?: TransactionContext): Promise<SubscriptionContractRecord | null>;
-    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    /** With `tx`, the contract is written on that transaction and undone with it. */
+    create(data: CreateSubscriptionContractData, tx?: TransactionContext): Promise<SubscriptionContractRecord>;
+    /**
+     * The contract concluded from a checkout offer (`originalOfferId`), or
+     * `null` when none was. An offer is consumed once and so yields one
+     * contract (`SC-MKT-017`); where an application's own path wrote two, the
+     * earliest is returned, so the answer does not depend on read order.
+     */
+    findByOriginalOfferId(offerId: string, tx?: TransactionContext): Promise<SubscriptionContractRecord | null>;
     terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
 }
 /**
@@ -4030,8 +4038,19 @@ interface CheckoutOfferRepository {
     findById(id: string): Promise<CheckoutOfferRow | null>;
     create(data: CreateCheckoutOfferData): Promise<CheckoutOfferRow>;
     update(id: string, data: UpdateCheckoutOfferData): Promise<CheckoutOfferRow>;
-    /** Sets `status = 'consumed'` + `consumedAt = NOW()`. */
-    consume(id: string): Promise<CheckoutOfferRow>;
+    /**
+     * Sets `status = 'consumed'` + `consumedAt = NOW()`, and only while the
+     * offer is still `open`: the write carries that condition, so of two
+     * callers consuming at once one succeeds and the other is refused with
+     * `CHECKOUT_OFFER_ALREADY_CONSUMED` (or `CHECKOUT_OFFER_EXPIRED`). A check
+     * before the write cannot decide it, because the status can change in
+     * between.
+     *
+     * With `tx`, the write runs on that transaction, so it is undone with
+     * everything else the transaction wrote. `CheckoutOfferService.conclude`
+     * depends on that; the persistence contract holds both.
+     */
+    consume(id: string, tx?: TransactionContext): Promise<CheckoutOfferRow>;
 }
 
 /** Which changes to list. */
@@ -4461,6 +4480,12 @@ declare const CONTRACT_ERROR_CODES: {
     readonly CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED";
     readonly CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED";
     readonly CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED";
+    /**
+     * The offer changed between the checks of `conclude` and the transaction
+     * that consumed it, so the contract checked is not the one the offer now
+     * describes. Nothing was written; load the offer and conclude it again.
+     */
+    readonly CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED";
     readonly SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND";
     readonly NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT";
     readonly SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED";
@@ -4576,6 +4601,12 @@ declare const PLATFORM_ERROR_CODES: {
     readonly CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED";
     readonly CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED";
     readonly CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED";
+    /**
+     * The offer changed between the checks of `conclude` and the transaction
+     * that consumed it, so the contract checked is not the one the offer now
+     * describes. Nothing was written; load the offer and conclude it again.
+     */
+    readonly CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED";
     readonly SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND";
     readonly NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT";
     readonly SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED";

package/dist/index.d.ts

@@ -3085,7 +3085,15 @@ interface SubscriptionContractRepository {
      * instead of drawing an extra pool connection (starvation guard, #70).
      */
     findActiveByTenantId(tenantId: string, asOf?: Date, tx?: TransactionContext): Promise<SubscriptionContractRecord | null>;
-    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    /** With `tx`, the contract is written on that transaction and undone with it. */
+    create(data: CreateSubscriptionContractData, tx?: TransactionContext): Promise<SubscriptionContractRecord>;
+    /**
+     * The contract concluded from a checkout offer (`originalOfferId`), or
+     * `null` when none was. An offer is consumed once and so yields one
+     * contract (`SC-MKT-017`); where an application's own path wrote two, the
+     * earliest is returned, so the answer does not depend on read order.
+     */
+    findByOriginalOfferId(offerId: string, tx?: TransactionContext): Promise<SubscriptionContractRecord | null>;
     terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
 }
 /**
@@ -4030,8 +4038,19 @@ interface CheckoutOfferRepository {
     findById(id: string): Promise<CheckoutOfferRow | null>;
     create(data: CreateCheckoutOfferData): Promise<CheckoutOfferRow>;
     update(id: string, data: UpdateCheckoutOfferData): Promise<CheckoutOfferRow>;
-    /** Sets `status = 'consumed'` + `consumedAt = NOW()`. */
-    consume(id: string): Promise<CheckoutOfferRow>;
+    /**
+     * Sets `status = 'consumed'` + `consumedAt = NOW()`, and only while the
+     * offer is still `open`: the write carries that condition, so of two
+     * callers consuming at once one succeeds and the other is refused with
+     * `CHECKOUT_OFFER_ALREADY_CONSUMED` (or `CHECKOUT_OFFER_EXPIRED`). A check
+     * before the write cannot decide it, because the status can change in
+     * between.
+     *
+     * With `tx`, the write runs on that transaction, so it is undone with
+     * everything else the transaction wrote. `CheckoutOfferService.conclude`
+     * depends on that; the persistence contract holds both.
+     */
+    consume(id: string, tx?: TransactionContext): Promise<CheckoutOfferRow>;
 }
 
 /** Which changes to list. */
@@ -4461,6 +4480,12 @@ declare const CONTRACT_ERROR_CODES: {
     readonly CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED";
     readonly CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED";
     readonly CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED";
+    /**
+     * The offer changed between the checks of `conclude` and the transaction
+     * that consumed it, so the contract checked is not the one the offer now
+     * describes. Nothing was written; load the offer and conclude it again.
+     */
+    readonly CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED";
     readonly SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND";
     readonly NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT";
     readonly SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED";
@@ -4576,6 +4601,12 @@ declare const PLATFORM_ERROR_CODES: {
     readonly CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED";
     readonly CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED";
     readonly CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED";
+    /**
+     * The offer changed between the checks of `conclude` and the transaction
+     * that consumed it, so the contract checked is not the one the offer now
+     * describes. Nothing was written; load the offer and conclude it again.
+     */
+    readonly CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED";
     readonly SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND";
     readonly NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT";
     readonly SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED";

package/dist/index.js

@@ -575,6 +575,12 @@ var CONTRACT_ERROR_CODES = {
   CHECKOUT_OFFER_EXPIRED: "CHECKOUT_OFFER_EXPIRED",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "CHECKOUT_OFFER_ALREADY_CONSUMED",
   CHECKOUT_OFFER_NOT_CONSUMED: "CHECKOUT_OFFER_NOT_CONSUMED",
+  /**
+   * The offer changed between the checks of `conclude` and the transaction
+   * that consumed it, so the contract checked is not the one the offer now
+   * describes. Nothing was written; load the offer and conclude it again.
+   */
+  CHECKOUT_OFFER_CHANGED: "CHECKOUT_OFFER_CHANGED",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SUBSCRIPTION_CONTRACT_NOT_FOUND",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "NO_ACTIVE_SUBSCRIPTION_CONTRACT",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SUBSCRIPTION_CONTRACT_ALREADY_CLOSED"
@@ -1058,6 +1064,7 @@ var ERROR_MESSAGES_EN = {
   CHECKOUT_OFFER_EXPIRED: "Checkout offer '{offerId}' has expired and cannot be {action}",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "Checkout offer '{offerId}' has already been consumed and cannot be {action}",
   CHECKOUT_OFFER_NOT_CONSUMED: "CheckoutOffer '{offerId}' must be consumed before the contract is created",
+  CHECKOUT_OFFER_CHANGED: "Checkout offer '{offerId}' changed while it was being concluded. Load it again.",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SubscriptionContract '{contractId}' not found",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "No active subscription contract for tenant {tenantId}",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SubscriptionContract '{contractId}' is already closed",
@@ -1247,6 +1254,7 @@ var ERROR_MESSAGES_DE = {
   CHECKOUT_OFFER_EXPIRED: "Checkout-Angebot '{offerId}' ist abgelaufen \u2014 '{action}' ist nicht mehr m\xF6glich",
   CHECKOUT_OFFER_ALREADY_CONSUMED: "Checkout-Angebot '{offerId}' wurde bereits eingel\xF6st \u2014 '{action}' ist nicht mehr m\xF6glich",
   CHECKOUT_OFFER_NOT_CONSUMED: "CheckoutOffer '{offerId}' muss eingel\xF6st sein, bevor der Vertrag entsteht",
+  CHECKOUT_OFFER_CHANGED: "Checkout-Angebot '{offerId}' hat sich w\xE4hrend des Abschlusses ge\xE4ndert. Bitte neu laden.",
   SUBSCRIPTION_CONTRACT_NOT_FOUND: "SubscriptionContract '{contractId}' nicht gefunden",
   NO_ACTIVE_SUBSCRIPTION_CONTRACT: "Kein aktiver Abo-Vertrag f\xFCr Mandant {tenantId}",
   SUBSCRIPTION_CONTRACT_ALREADY_CLOSED: "SubscriptionContract '{contractId}' ist bereits geschlossen",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/core",
-  "version": "1.0.0-rc.14",
+  "version": "1.0.0-rc.15",
   "description": "TypeScript contracts for SaaSiCat — capabilities, catalogs, subscriptions, entitlements, admin manifests, persistence ports — and the pure domain logic both server and browser run: error catalogues, plan-diff classification, promo arithmetic, feature requirements.",
   "type": "module",
   "main": "./dist/index.cjs",