@mj-biz-apps/orders-entities 5.22.0 → 5.23.0

package/dist/SubscriptionTermEntity.js

@@ -0,0 +1,56 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview `SubscriptionTermEntity` — shared entity subclass for Subscription Terms.
+ *
+ * A term is written once, when the order line that bought it is confirmed. Its dates and amount are
+ * what the journal entries and the recognition schedule were built from, and what the renewal keys
+ * off. Nothing guarded them, so a booked term's end date could be moved on any save — which is also
+ * how a term was extended at no charge with no value recorded and no approval sought.
+ *
+ * So a saved term's dates and amount are fixed. Extending one is a concession: record it as a
+ * Duration `OrderConcession`, which values it at the term's own rate and routes it for approval. The
+ * approved concession applies the extension, and that server-side write is the only one this admits
+ * (`BookedTermEditSanctioned`).
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { BaseEntity, ValidationErrorInfo, ValidationErrorType } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { mjBizAppsOrdersSubscriptionTermEntity } from './generated/entity_subclasses.js';
+/** Term columns the booking and the recognition schedule were built from. */
+export const SUBSCRIPTION_TERM_BOOKED_FIELDS = ['StartDate', 'EndDate', 'Amount'];
+let SubscriptionTermEntity = class SubscriptionTermEntity extends mjBizAppsOrdersSubscriptionTermEntity {
+    Validate() {
+        const result = super.Validate();
+        this.refuseBookedTermEdits(result);
+        return result;
+    }
+    /**
+     * True only for the server's own amendment write. The server subclass overrides it; here, where
+     * any caller could set a flag, nothing is sanctioned.
+     */
+    BookedTermEditSanctioned() {
+        return false;
+    }
+    refuseBookedTermEdits(result) {
+        if (!this.IsSaved || this.BookedTermEditSanctioned())
+            return;
+        const dirty = SUBSCRIPTION_TERM_BOOKED_FIELDS.filter((name) => this.GetFieldByName(name)?.Dirty === true);
+        if (dirty.length === 0)
+            return;
+        result.Success = false;
+        result.Errors.push(new ValidationErrorInfo(dirty[0], `A booked term cannot change ${dirty.join(', ')}: the order's journal entries and the ` +
+            `recognition schedule were built from them. To extend a term at no charge, record a ` +
+            `Duration concession against it; approving it applies the extension.`, this.GetFieldByName(dirty[0])?.Value, ValidationErrorType.Failure));
+    }
+};
+SubscriptionTermEntity = __decorate([
+    RegisterClass(BaseEntity, 'MJ_BizApps_Orders: Subscription Terms')
+], SubscriptionTermEntity);
+export { SubscriptionTermEntity };
+//# sourceMappingURL=SubscriptionTermEntity.js.map

package/dist/SubscriptionTermEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionTermEntity.js","sourceRoot":"","sources":["../src/SubscriptionTermEntity.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,mBAAmB,EAAyB,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,qCAAqC,EAAE,MAAM,+BAA+B,CAAC;AAEtF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAGpF,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,qCAAqC;IAC7D,QAAQ;QACpB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;OAGG;IACO,wBAAwB;QAC9B,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,qBAAqB,CAAC,MAAwB;QAClD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,wBAAwB,EAAE;YAAE,OAAO;QAC7D,MAAM,KAAK,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;QAC1G,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,MAAM,CAAC,MAAM,CAAC,IAAI,CACd,IAAI,mBAAmB,CACnB,KAAK,CAAC,CAAC,CAAC,EACR,+BAA+B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC;YACnF,qFAAqF;YACrF,qEAAqE,EACzE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EACpC,mBAAmB,CAAC,OAAO,CAC9B,CACJ,CAAC;IACN,CAAC;CACJ,CAAA;AA/BY,sBAAsB;IADlC,aAAa,CAAC,UAAU,EAAE,uCAAuC,CAAC;GACtD,sBAAsB,CA+BlC"}

package/dist/checkout-choices.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Choice groups a checkout widget offers the buyer — "choose N of these M options" — and the check
+ * the buyer's picks pass.
+ *
+ * The groups live in the widget's Configuration (`choiceGroups`). Unlike a question's answer, a
+ * pick decides what the buyer is entitled to: it is recorded on the order line as Order Line
+ * Choices, a Product Entitlement with a matching `ChoiceGroupKey` / `ChoiceOptionValue` grants only
+ * on a line that carries it, and a renewal copies the picks onto its own line.
+ *
+ * Pure; no database, no provider. The browser runs the same check to gate the Pay button, and the
+ * server runs it on the picks it stored before it opens a payment intent or completes the
+ * checkout — the server check is the one that counts. Picks are judged against the widget's own
+ * groups, never against anything the buyer sent.
+ */
+/** One option of a choice group. A bare string is both its value and its label. */
+export interface CheckoutChoiceOption {
+    value: string;
+    label: string;
+}
+export interface CheckoutChoiceGroup {
+    /** Stable identifier, recorded on the line as `GroupKey` and matched by `ProductEntitlement.ChoiceGroupKey`. */
+    key: string;
+    /** The group as the buyer sees it, e.g. "Choose your department". */
+    label: string;
+    options: Array<string | CheckoutChoiceOption>;
+    /** Fewest options the buyer must pick. 0 makes the group optional. */
+    min: number;
+    /** Most options the buyer may pick. At least `min`, and no more than the number of options. */
+    max: number;
+}
+/** The buyer's picks, keyed by group key: the option values chosen. */
+export type CheckoutChoicesInput = Record<string, string[]>;
+/** One pick that passed the check, shaped as the order line records it. */
+export interface ResolvedCheckoutChoice {
+    GroupKey: string;
+    GroupLabel: string;
+    OptionValue: string;
+    OptionLabel: string;
+}
+export interface CheckoutChoicesCheck {
+    /** Every pick, in the widget's group and option order. Empty when `Error` is set. */
+    Choices: ResolvedCheckoutChoice[];
+    /** Why the picks were refused, worded for the buyer. */
+    Error?: string;
+}
+/** Column widths of OrderLineChoice. */
+export declare const MAX_CHECKOUT_CHOICE_KEY_LENGTH = 100;
+export declare const MAX_CHECKOUT_CHOICE_LABEL_LENGTH = 500;
+/** Message for a widget whose `choiceGroups` cannot be read; the checkout is refused, not skipped. */
+export declare const INVALID_CHECKOUT_CHOICE_GROUPS_MESSAGE = "This checkout is not configured correctly (its choices are invalid).";
+export declare function CheckoutChoiceOptionValue(option: string | CheckoutChoiceOption): string;
+export declare function CheckoutChoiceOptionLabel(option: string | CheckoutChoiceOption): string;
+/**
+ * The widget's choice groups, or an error when `choiceGroups` is present but malformed.
+ *
+ * A malformed list refuses the checkout rather than dropping the bad entries: a group that
+ * silently disappeared would sell the product without the pick its entitlements depend on.
+ */
+export declare function ReadCheckoutChoiceGroups(raw: unknown): {
+    Groups: CheckoutChoiceGroup[];
+    Error?: string;
+};
+/** How many options a group asks for, worded for the buyer: "exactly 2", "1 to 3", "up to 2". */
+export declare function DescribeChoiceCount(group: CheckoutChoiceGroup): string;
+/**
+ * Check the buyer's picks against the widget's choice groups.
+ *
+ * Refuses: picks that are not an object of lists, a group the widget does not offer, an option
+ * that is not one of the group's, more picks than `max`, and — unless `partial` — fewer than `min`.
+ * A repeated option counts once. `partial` is for the draft, which is priced before the buyer has
+ * finished choosing; the payment intent and completion check in full.
+ */
+export declare function CheckChoicesAgainstGroups(groups: CheckoutChoiceGroup[], picks: unknown, options?: {
+    partial?: boolean;
+}): CheckoutChoicesCheck;
+/** {@link ReadCheckoutChoiceGroups} then {@link CheckChoicesAgainstGroups}, for a raw Configuration value. */
+export declare function CheckCheckoutChoices(rawGroups: unknown, picks: unknown, options?: {
+    partial?: boolean;
+}): CheckoutChoicesCheck;
+/** Resolved picks back into the input shape, as the session metadata stores them. */
+export declare function ChoicesForStorage(choices: ResolvedCheckoutChoice[]): CheckoutChoicesInput;
+//# sourceMappingURL=checkout-choices.d.ts.map

package/dist/checkout-choices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-choices.d.ts","sourceRoot":"","sources":["../src/checkout-choices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAChC,gHAAgH;IAChH,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,oBAAoB,CAAC,CAAC;IAC9C,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,GAAG,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAE5D,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACjC,qFAAqF;IACrF,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD,sGAAsG;AACtG,eAAO,MAAM,sCAAsC,yEAAyE,CAAC;AAE7H,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,MAAM,CAEvF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,MAAM,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAYxG;AAsBD,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAItE;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,mBAAmB,EAAE,EAC7B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,oBAAoB,CAwCtB;AAED,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,oBAAoB,CAI9H;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,oBAAoB,CAIzF"}

package/dist/checkout-choices.js

@@ -0,0 +1,143 @@
+/**
+ * Choice groups a checkout widget offers the buyer — "choose N of these M options" — and the check
+ * the buyer's picks pass.
+ *
+ * The groups live in the widget's Configuration (`choiceGroups`). Unlike a question's answer, a
+ * pick decides what the buyer is entitled to: it is recorded on the order line as Order Line
+ * Choices, a Product Entitlement with a matching `ChoiceGroupKey` / `ChoiceOptionValue` grants only
+ * on a line that carries it, and a renewal copies the picks onto its own line.
+ *
+ * Pure; no database, no provider. The browser runs the same check to gate the Pay button, and the
+ * server runs it on the picks it stored before it opens a payment intent or completes the
+ * checkout — the server check is the one that counts. Picks are judged against the widget's own
+ * groups, never against anything the buyer sent.
+ */
+/** Column widths of OrderLineChoice. */
+export const MAX_CHECKOUT_CHOICE_KEY_LENGTH = 100;
+export const MAX_CHECKOUT_CHOICE_LABEL_LENGTH = 500;
+/** Message for a widget whose `choiceGroups` cannot be read; the checkout is refused, not skipped. */
+export const INVALID_CHECKOUT_CHOICE_GROUPS_MESSAGE = 'This checkout is not configured correctly (its choices are invalid).';
+export function CheckoutChoiceOptionValue(option) {
+    return typeof option === 'string' ? option : option.value;
+}
+export function CheckoutChoiceOptionLabel(option) {
+    return typeof option === 'string' ? option : option.label;
+}
+/**
+ * The widget's choice groups, or an error when `choiceGroups` is present but malformed.
+ *
+ * A malformed list refuses the checkout rather than dropping the bad entries: a group that
+ * silently disappeared would sell the product without the pick its entitlements depend on.
+ */
+export function ReadCheckoutChoiceGroups(raw) {
+    if (raw === undefined || raw === null)
+        return { Groups: [] };
+    if (!Array.isArray(raw))
+        return { Groups: [], Error: INVALID_CHECKOUT_CHOICE_GROUPS_MESSAGE };
+    const keys = new Set();
+    for (const g of raw) {
+        if (!IsValidChoiceGroup(g) || keys.has(g.key)) {
+            return { Groups: [], Error: INVALID_CHECKOUT_CHOICE_GROUPS_MESSAGE };
+        }
+        keys.add(g.key);
+    }
+    return { Groups: raw };
+}
+function IsValidChoiceGroup(g) {
+    if (!g || typeof g !== 'object')
+        return false;
+    const c = g;
+    if (typeof c.key !== 'string' || !c.key.trim() || c.key.length > MAX_CHECKOUT_CHOICE_KEY_LENGTH)
+        return false;
+    if (typeof c.label !== 'string' || !c.label.trim() || c.label.length > MAX_CHECKOUT_CHOICE_LABEL_LENGTH)
+        return false;
+    if (!Array.isArray(c.options) || c.options.length === 0)
+        return false;
+    const values = new Set();
+    for (const o of c.options) {
+        const value = typeof o === 'string' ? o : o && typeof o === 'object' ? o.value : undefined;
+        const label = typeof o === 'string' ? o : o && typeof o === 'object' ? o.label : undefined;
+        if (typeof value !== 'string' || !value || value.length > MAX_CHECKOUT_CHOICE_KEY_LENGTH || values.has(value))
+            return false;
+        if (typeof label !== 'string' || !label || label.length > MAX_CHECKOUT_CHOICE_LABEL_LENGTH)
+            return false;
+        values.add(value);
+    }
+    if (!Number.isInteger(c.min) || !Number.isInteger(c.max))
+        return false;
+    const min = c.min;
+    const max = c.max;
+    return min >= 0 && max >= 1 && min <= max && max <= values.size;
+}
+/** How many options a group asks for, worded for the buyer: "exactly 2", "1 to 3", "up to 2". */
+export function DescribeChoiceCount(group) {
+    if (group.min === group.max)
+        return `exactly ${group.min}`;
+    if (group.min === 0)
+        return `up to ${group.max}`;
+    return `${group.min} to ${group.max}`;
+}
+/**
+ * Check the buyer's picks against the widget's choice groups.
+ *
+ * Refuses: picks that are not an object of lists, a group the widget does not offer, an option
+ * that is not one of the group's, more picks than `max`, and — unless `partial` — fewer than `min`.
+ * A repeated option counts once. `partial` is for the draft, which is priced before the buyer has
+ * finished choosing; the payment intent and completion check in full.
+ */
+export function CheckChoicesAgainstGroups(groups, picks, options) {
+    const refuse = (error) => ({ Choices: [], Error: error });
+    if (picks !== undefined && picks !== null && (typeof picks !== 'object' || Array.isArray(picks))) {
+        return refuse('The checkout choices could not be read.');
+    }
+    const input = (picks ?? {});
+    const offered = new Set(groups.map((g) => g.key));
+    for (const key of Object.keys(input)) {
+        if (!offered.has(key))
+            return refuse('A choice was sent for a group this checkout does not offer.');
+    }
+    const resolved = [];
+    for (const g of groups) {
+        const raw = input[g.key];
+        if (raw !== undefined && raw !== null && !Array.isArray(raw)) {
+            return refuse(`The choices for "${g.label}" could not be read.`);
+        }
+        const chosen = new Set();
+        for (const v of (raw ?? [])) {
+            if (typeof v !== 'string')
+                return refuse(`The choices for "${g.label}" could not be read.`);
+            chosen.add(v);
+        }
+        for (const v of chosen) {
+            if (!g.options.some((o) => CheckoutChoiceOptionValue(o) === v)) {
+                return refuse(`"${v}" is not one of the options for "${g.label}".`);
+            }
+        }
+        if (chosen.size > g.max || (!options?.partial && chosen.size < g.min)) {
+            return refuse(`Please choose ${DescribeChoiceCount(g)} for "${g.label}".`);
+        }
+        // Option order, not the order the buyer clicked, so the record reads the same either way.
+        for (const o of g.options) {
+            const value = CheckoutChoiceOptionValue(o);
+            if (!chosen.has(value))
+                continue;
+            resolved.push({ GroupKey: g.key, GroupLabel: g.label, OptionValue: value, OptionLabel: CheckoutChoiceOptionLabel(o) });
+        }
+    }
+    return { Choices: resolved };
+}
+/** {@link ReadCheckoutChoiceGroups} then {@link CheckChoicesAgainstGroups}, for a raw Configuration value. */
+export function CheckCheckoutChoices(rawGroups, picks, options) {
+    const read = ReadCheckoutChoiceGroups(rawGroups);
+    if (read.Error)
+        return { Choices: [], Error: read.Error };
+    return CheckChoicesAgainstGroups(read.Groups, picks, options);
+}
+/** Resolved picks back into the input shape, as the session metadata stores them. */
+export function ChoicesForStorage(choices) {
+    const stored = {};
+    for (const c of choices)
+        (stored[c.GroupKey] ??= []).push(c.OptionValue);
+    return stored;
+}
+//# sourceMappingURL=checkout-choices.js.map

package/dist/checkout-choices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-choices.js","sourceRoot":"","sources":["../src/checkout-choices.ts"],"names":[],"mappings":"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"}

package/dist/configuration-types.d.ts

@@ -6,6 +6,7 @@
  *
  * @module @mj-biz-apps/orders-entities/configuration-types
  */
+import type { CheckoutChoiceGroup } from './checkout-choices.js';
 import type { CheckoutQuestion } from './checkout-questions.js';
 export interface CustomUIThemeConfiguration {
     primaryColor?: string;
@@ -128,6 +129,14 @@ export interface CheckoutWidgetConfiguration {
      * Answers. A required question blocks the payment intent and completion until answered.
      */
     questions?: CheckoutQuestion[];
+    /**
+     * Groups the buyer chooses from before paying: "choose N of these M options". Each pick is
+     * recorded on the order line as an Order Line Choice, and a Product Entitlement with a matching
+     * `ChoiceGroupKey` / `ChoiceOptionValue` grants only on a line that carries it. Picks outside
+     * `min`..`max`, or options not in the list, block the payment intent and completion. The widget
+     * must sell a single line.
+     */
+    choiceGroups?: CheckoutChoiceGroup[];
     /**
      * The PaymentProvider row id used to open payment intents for this widget's sessions.
      * Admin-authored, server-resolved — never accepted from the client. Required before a

package/dist/configuration-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-types.d.ts","sourceRoot":"","sources":["../src/configuration-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configuration-types.d.ts","sourceRoot":"","sources":["../src/configuration-types.ts"],"names":[],"mappings":"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"}