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

package/dist/index.js

@@ -87,27 +87,33 @@ function pickActivePromo(promotions, targetKey, locale, cycle, today = /* @__PUR
   return matches[0] ?? null;
 }
 function applyPromo(promo, basePrice) {
+  const result = boundedPromo(promo, basePrice);
+  return result && result.discounted < result.original ? result : null;
+}
+function boundedPromo(promo, basePrice) {
   if (!promo || basePrice === null || basePrice === void 0) return null;
   if (promo.type === "percent" && typeof promo.value === "number") {
+    const pct = withinBounds(promo.value, 100);
     return {
       kind: "percent",
-      discounted: Math.round(basePrice * (100 - promo.value)) / 100,
+      discounted: Math.round(basePrice * (100 - pct)) / 100,
       original: basePrice,
-      pct: promo.value
+      pct
     };
   }
   if (promo.type === "amount" && typeof promo.value === "number") {
+    const saved = withinBounds(promo.value, basePrice);
     return {
       kind: "amount",
-      discounted: Math.max(0, basePrice - promo.value),
+      discounted: Math.round((basePrice - saved) * 100) / 100,
       original: basePrice,
-      saved: promo.value
+      saved
     };
   }
-  if (promo.type === "intro" && typeof promo.value === "object") {
+  if (promo.type === "intro" && typeof promo.value === "object" && promo.value !== null) {
     return {
       kind: "intro",
-      discounted: promo.value.price,
+      discounted: withinBounds(promo.value.price, basePrice),
       original: basePrice,
       months: promo.value.months
     };
@@ -117,6 +123,14 @@ function applyPromo(promo, basePrice) {
   }
   return null;
 }
+function withinBounds(value, upper) {
+  return Math.min(Math.max(value, 0), Math.max(upper, 0));
+}
+function promotionOnPrice(promotions, targetKey, locale, cycle, basePrice, today = /* @__PURE__ */ new Date(), targetType = "PLAN") {
+  const promotion = pickActivePromo(promotions, targetKey, locale, cycle, today, targetType);
+  const result = applyPromo(promotion, basePrice);
+  return promotion && result ? { promotion, result } : null;
+}
 
 // src/quota-value.ts
 function readQuotaValue(value) {
@@ -413,6 +427,12 @@ var CATALOG_ERROR_CODES = {
   FEATURE_NOT_FOUND: "FEATURE_NOT_FOUND",
   QUOTA_NOT_FOUND: "QUOTA_NOT_FOUND",
   PROMOTION_NOT_FOUND: "PROMOTION_NOT_FOUND",
+  /**
+   * A promotion's value is not one its type takes: a percentage above 0 and
+   * at most 100, an amount above 0, an intro price of at least 0 for a whole
+   * number of months, or a whole number of free months.
+   */
+  PROMOTION_VALUE_INVALID: "PROMOTION_VALUE_INVALID",
   MARKETING_PROJECTION_NOT_FOUND: "MARKETING_PROJECTION_NOT_FOUND",
   // ── already exists ──
   PLAN_ALREADY_EXISTS: "PLAN_ALREADY_EXISTS",
@@ -572,6 +592,13 @@ var CONTRACT_ERROR_CODES = {
   SUBSCRIPTION_CONTRACT_LINE_ITEM_TAX_MISMATCH: "SUBSCRIPTION_CONTRACT_LINE_ITEM_TAX_MISMATCH",
   SUBSCRIPTION_CONTRACT_TAX_RATE_NOT_PERCENT: "SUBSCRIPTION_CONTRACT_TAX_RATE_NOT_PERCENT",
   SUBSCRIPTION_CONTRACT_LINE_ITEM_CURRENCY_MISMATCH: "SUBSCRIPTION_CONTRACT_LINE_ITEM_CURRENCY_MISMATCH",
+  /**
+   * The lines do not add up to a total the contract states, counted as often
+   * as each falls due in one period. `field` names the total.
+   */
+  SUBSCRIPTION_CONTRACT_LINES_DO_NOT_ADD_UP: "SUBSCRIPTION_CONTRACT_LINES_DO_NOT_ADD_UP",
+  /** Something that takes money off states a negative amount. */
+  SUBSCRIPTION_CONTRACT_DISCOUNT_NEGATIVE: "SUBSCRIPTION_CONTRACT_DISCOUNT_NEGATIVE",
   SUBSCRIPTION_CONTRACT_TERMINATION_BEFORE_START: "SUBSCRIPTION_CONTRACT_TERMINATION_BEFORE_START",
   // ── stage 3 ──
   CHECKOUT_OFFER_NOT_FOUND: "CHECKOUT_OFFER_NOT_FOUND",
@@ -1114,6 +1141,30 @@ function oneOf(allowed, value, column, id) {
   }
   return match;
 }
+var FOREIGN_PAYMENT_METHOD_REFERENCE = "FOREIGN_PAYMENT_METHOD_REFERENCE";
+var ForeignPaymentMethodReferenceError = class extends Error {
+  constructor(gatewayAccount, paymentMethodRef) {
+    super(
+      `Payment method '${paymentMethodRef}' of account '${gatewayAccount}' belongs to another subscriber. A reference belongs to exactly one, so it is not handed out.`
+    );
+    this.gatewayAccount = gatewayAccount;
+    this.paymentMethodRef = paymentMethodRef;
+    this.name = "ForeignPaymentMethodReferenceError";
+  }
+  gatewayAccount;
+  paymentMethodRef;
+  code = FOREIGN_PAYMENT_METHOD_REFERENCE;
+};
+function isForeignPaymentMethodReferenceError(error) {
+  return error instanceof Error && error.code === FOREIGN_PAYMENT_METHOD_REFERENCE;
+}
+function refuseForeignPaymentMethodReference(recorded, subscriberId) {
+  if (recorded.subscriberId === subscriberId) return;
+  throw new ForeignPaymentMethodReferenceError(
+    recorded.gatewayAccount,
+    recorded.paymentMethodRef
+  );
+}
 
 // src/subscription-contract-mapping.ts
 function toSubscriptionContractRecord(row, lineItems) {
@@ -1324,6 +1375,7 @@ var ERROR_MESSAGES_EN = {
   FEATURE_NOT_FOUND: "Feature '{featureKey}' not found",
   QUOTA_NOT_FOUND: "Quota '{quotaKey}' not found",
   PROMOTION_NOT_FOUND: "Promotion '{promotionId}' not found",
+  PROMOTION_VALUE_INVALID: "The value of a '{type}' promotion is not one its type takes: a percentage above 0 and at most 100, an amount above 0, an intro price of at least 0 for a whole number of months, or a whole number of free months.",
   MARKETING_PROJECTION_NOT_FOUND: "MarketingProjection '{projectionId}' not found",
   PLAN_ALREADY_EXISTS: "Plan '{planKey}' already exists",
   BUNDLE_ALREADY_EXISTS: "Bundle '{bundleKey}' already exists",
@@ -1378,7 +1430,7 @@ var ERROR_MESSAGES_EN = {
   // ── promo ──
   PROMO_CODE_NOT_FOUND: "Code not found",
   PROMO_CODE_ALREADY_EXISTS: "The code already exists.",
-  PROMO_CODE_HAS_REDEMPTIONS: "The code already has redemptions \u2014 it cannot be soft-deleted. Pause it instead.",
+  PROMO_CODE_HAS_REDEMPTIONS: "The code already has redemptions, or checkouts holding one \u2014 it cannot be soft-deleted. Pause it instead.",
   PROMO_CODE_NOT_REDEEMABLE: "Code cannot be redeemed: {reason}",
   PROMO_CODE_FORMAT_INVALID: 'The code may only contain upper-case letters, digits, "-" and "_" (4\u201332 characters).',
   PROMO_PERCENT_OUT_OF_RANGE: "The percentage must be between 0 and 100.",
@@ -1408,6 +1460,8 @@ var ERROR_MESSAGES_EN = {
   SUBSCRIPTION_CONTRACT_TAX_RATE_NOT_PERCENT: "A subscription contract states a tax rate of {taxRate} at {field}, which is not a percentage: a rate lies from 0 to 100, and a value between 0 and 1 is refused as a fraction.",
   SUBSCRIPTION_CONTRACT_TERMINATION_BEFORE_START: "effectiveUntil must be after the effectiveFrom of the contract.",
   SUBSCRIPTION_CONTRACT_LINE_ITEM_CURRENCY_MISMATCH: "A line item must be booked in the currency its contract was priced in.",
+  SUBSCRIPTION_CONTRACT_LINES_DO_NOT_ADD_UP: "The line items of a subscription contract add up to {lines} for {field}, but the contract states {stated}.",
+  SUBSCRIPTION_CONTRACT_DISCOUNT_NEGATIVE: "A subscription contract states a discount of {amount} at {field}; a discount takes money off and is never negative.",
   CHECKOUT_OFFER_NOT_FOUND: "CheckoutOffer '{offerId}' not found",
   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}",
@@ -1531,6 +1585,7 @@ var ERROR_MESSAGES_DE = {
   FEATURE_NOT_FOUND: "Feature '{featureKey}' nicht gefunden",
   QUOTA_NOT_FOUND: "Quota '{quotaKey}' nicht gefunden",
   PROMOTION_NOT_FOUND: "Promotion '{promotionId}' nicht gefunden",
+  PROMOTION_VALUE_INVALID: "Der Wert einer Aktion vom Typ '{type}' passt nicht zu ihrem Typ: ein Prozentsatz \xFCber 0 und h\xF6chstens 100, ein Betrag \xFCber 0, ein Einf\xFChrungspreis ab 0 f\xFCr eine ganze Zahl von Monaten oder eine ganze Zahl von Gratismonaten.",
   MARKETING_PROJECTION_NOT_FOUND: "MarketingProjection '{projectionId}' nicht gefunden",
   PLAN_ALREADY_EXISTS: "Plan '{planKey}' gibt es bereits",
   BUNDLE_ALREADY_EXISTS: "Bundle '{bundleKey}' gibt es bereits",
@@ -1585,7 +1640,7 @@ var ERROR_MESSAGES_DE = {
   // ── promo ──
   PROMO_CODE_NOT_FOUND: "Code nicht gefunden",
   PROMO_CODE_ALREADY_EXISTS: "Diesen Code gibt es bereits.",
-  PROMO_CODE_HAS_REDEMPTIONS: "Der Code wurde bereits eingel\xF6st \u2014 er l\xE4sst sich nicht per Soft-Delete entfernen. Pausiere ihn stattdessen.",
+  PROMO_CODE_HAS_REDEMPTIONS: "Der Code wurde bereits eingel\xF6st oder ist f\xFCr einen laufenden Checkout reserviert \u2014 er l\xE4sst sich nicht per Soft-Delete entfernen. Pausiere ihn stattdessen.",
   PROMO_CODE_NOT_REDEEMABLE: "Der Code l\xE4sst sich nicht einl\xF6sen: {reason}",
   PROMO_CODE_FORMAT_INVALID: 'Der Code darf nur Gro\xDFbuchstaben, Ziffern, "-" und "_" enthalten (4\u201332 Zeichen).',
   PROMO_PERCENT_OUT_OF_RANGE: "Der Prozentwert muss zwischen 0 und 100 liegen.",
@@ -1614,6 +1669,8 @@ var ERROR_MESSAGES_DE = {
   SUBSCRIPTION_CONTRACT_LINE_ITEM_TAX_MISMATCH: "taxAmount einer Position muss exakt priceGross minus priceNet sein.",
   SUBSCRIPTION_CONTRACT_TAX_RATE_NOT_PERCENT: "Ein Abo-Vertrag nennt bei {field} einen Steuersatz von {taxRate}, der kein Prozentsatz ist: Ein Satz liegt zwischen 0 und 100, und ein Wert zwischen 0 und 1 wird als Bruch abgelehnt.",
   SUBSCRIPTION_CONTRACT_LINE_ITEM_CURRENCY_MISMATCH: "Eine Position muss in der W\xE4hrung gebucht sein, in der ihr Vertrag bepreist ist.",
+  SUBSCRIPTION_CONTRACT_LINES_DO_NOT_ADD_UP: "Die Positionen eines Abo-Vertrags ergeben {lines} f\xFCr {field}, der Vertrag nennt aber {stated}.",
+  SUBSCRIPTION_CONTRACT_DISCOUNT_NEGATIVE: "Ein Abo-Vertrag nennt bei {field} einen Rabatt von {amount}; ein Rabatt zieht Geld ab und ist nie negativ.",
   SUBSCRIPTION_CONTRACT_TERMINATION_BEFORE_START: "effectiveUntil muss nach dem effectiveFrom des Vertrags liegen.",
   CHECKOUT_OFFER_NOT_FOUND: "CheckoutOffer '{offerId}' nicht gefunden",
   CHECKOUT_OFFER_EXPIRED: "Checkout-Angebot '{offerId}' ist abgelaufen \u2014 '{action}' ist nicht mehr m\xF6glich",
@@ -1670,6 +1727,7 @@ export {
   ERROR_MESSAGES_DE,
   ERROR_MESSAGES_EN,
   FEATURE_NOT_LICENSED,
+  ForeignPaymentMethodReferenceError,
   LEGAL_IDENTITY_FIELDS,
   MARKETING_PRIORITY_MAX,
   MARKETING_PRIORITY_MIN,
@@ -1714,6 +1772,7 @@ export {
   formatErrorMessage,
   identityCorrectionDelta,
   isBundleRedundant,
+  isForeignPaymentMethodReferenceError,
   isPaymentCallbackRejectedError,
   isPlatformUserExistsError,
   isVersionEditable,
@@ -1725,9 +1784,11 @@ export {
   planCatalogSettingsOf,
   previousUtcDay,
   promoStatus,
+  promotionOnPrice,
   readQuotaRecord,
   readQuotaValue,
   recordedIssuerIdentity,
+  refuseForeignPaymentMethodReference,
   resolveBundleAvailability,
   resolveErrorMessage,
   sameLegalIdentity,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/core",
-  "version": "1.0.0-rc.20",
+  "version": "1.0.0-rc.21",
   "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",