@mj-biz-apps/orders-entities 0.0.1 → 5.2.0

package/dist/PaymentHeaderEntity.js

@@ -0,0 +1,80 @@
+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;
+};
+/**
+ * Shared (client + server) subclass for Payment Headers.
+ *
+ * Declares the optional `PaymentDetailID` embed — the receipt's own frozen
+ * instrument snapshot (D39 copy-on-use). `PaymentHeaderEntityServer` extends
+ * this class. Remove the declaration when CodeGen emits it from metadata.
+ */
+import { BaseEntity, ValidationErrorType } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { mjBizAppsOrdersPaymentHeaderEntity, } from './generated/entity_subclasses.js';
+import { IsSavePopulatedFieldError } from './save-populated-fields.js';
+const ENTITY = 'MJ_BizApps_Orders: Payment Headers';
+const DETAIL_ENTITY = 'MJ_BizApps_Orders: Payment Details';
+let PaymentHeaderEntity = class PaymentHeaderEntity extends mjBizAppsOrdersPaymentHeaderEntity {
+    ClearPaymentDetail() {
+        this.GetCompanion('PaymentDetailID_Object')?.Clear();
+    }
+    get ReferenceNumber() {
+        return this.PaymentDetailID_Object?.ReferenceNumber ?? null;
+    }
+    set ReferenceNumber(value) {
+        const trimmed = (value ?? '').trim();
+        const ref = trimmed.length ? trimmed : null;
+        if (ref) {
+            const detail = this.PaymentDetailID_EnsureObject();
+            detail.ReferenceNumber = ref;
+            if (this.ReceivingCompanyID && !detail.CompanyID) {
+                detail.CompanyID = this.ReceivingCompanyID;
+            }
+            if (this.PaymentTypeID && !detail.PaymentTypeID) {
+                detail.PaymentTypeID = this.PaymentTypeID;
+            }
+        }
+        else if (this.PaymentDetailID_Object) {
+            this.PaymentDetailID_Object.ReferenceNumber = null;
+            if (this.isPaymentDetailEmpty(this.PaymentDetailID_Object)) {
+                this.ClearPaymentDetail();
+            }
+        }
+    }
+    isPaymentDetailEmpty(detail) {
+        return (!detail.ReferenceNumber?.trim() &&
+            !detail.Brand?.trim() &&
+            !detail.Last4?.trim() &&
+            !detail.HolderName?.trim() &&
+            !detail.BankName?.trim() &&
+            !detail.RoutingLast4?.trim() &&
+            !detail.AccountLast4?.trim() &&
+            !detail.BankAccountType &&
+            !detail.ExpiryMonth &&
+            !detail.ExpiryYear &&
+            !detail.Notes?.trim() &&
+            !detail.ProviderInstrumentRef?.trim() &&
+            !detail.ProviderCustomerRef?.trim() &&
+            !detail.StoredValueAccountID);
+    }
+    Validate() {
+        const result = super.Validate();
+        this.dropSavePopulatedFieldErrors(result);
+        return result;
+    }
+    dropSavePopulatedFieldErrors(result) {
+        const kept = result.Errors.filter((error) => !IsSavePopulatedFieldError(error.Source ?? '', this.IsSaved, () => false));
+        if (kept.length === result.Errors.length)
+            return;
+        result.Errors = kept;
+        result.Success = kept.every((error) => error.Type !== ValidationErrorType.Failure);
+    }
+};
+PaymentHeaderEntity = __decorate([
+    RegisterClass(BaseEntity, ENTITY)
+], PaymentHeaderEntity);
+export { PaymentHeaderEntity };
+//# sourceMappingURL=PaymentHeaderEntity.js.map

package/dist/PaymentHeaderEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentHeaderEntity.js","sourceRoot":"","sources":["../src/PaymentHeaderEntity.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAuC,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAC9H,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACH,kCAAkC,GAErC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,MAAM,GAAG,oCAAoC,CAAC;AACpD,MAAM,aAAa,GAAG,oCAAoC,CAAC;AAGpD,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,kCAAkC;IAChE,kBAAkB;QACrB,IAAI,CAAC,YAAY,CAAiB,wBAAwB,CAAC,EAAE,KAAK,EAAE,CAAC;IACzE,CAAC;IAED,IAAW,eAAe;QACtB,OAAO,IAAI,CAAC,sBAAsB,EAAE,eAAe,IAAI,IAAI,CAAC;IAChE,CAAC;IAED,IAAW,eAAe,CAAC,KAAoB;QAC3C,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5C,IAAI,GAAG,EAAE,CAAC;YACN,MAAM,MAAM,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC;YACnD,MAAM,CAAC,eAAe,GAAG,GAAG,CAAC;YAC7B,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC/C,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC;YAC/C,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC9C,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YAC9C,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACrC,IAAI,CAAC,sBAAsB,CAAC,eAAe,GAAG,IAAI,CAAC;YACnD,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9B,CAAC;QACL,CAAC;IACL,CAAC;IAEM,oBAAoB,CAAC,MAA0C;QAClE,OAAO,CACH,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE;YAC/B,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;YACrB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;YACrB,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE;YAC1B,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE;YACxB,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE;YAC5B,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE;YAC5B,CAAC,MAAM,CAAC,eAAe;YACvB,CAAC,MAAM,CAAC,WAAW;YACnB,CAAC,MAAM,CAAC,UAAU;YAClB,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE;YACrB,CAAC,MAAM,CAAC,qBAAqB,EAAE,IAAI,EAAE;YACrC,CAAC,MAAM,CAAC,mBAAmB,EAAE,IAAI,EAAE;YACnC,CAAC,MAAM,CAAC,oBAAoB,CAC/B,CAAC;IACN,CAAC;IAEe,QAAQ;QACpB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,4BAA4B,CAAC,MAAwB;QACzD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAC7B,CAAC,KAAK,EAAE,EAAE,CACN,CAAC,yBAAyB,CACtB,KAAK,CAAC,MAAM,IAAI,EAAE,EAClB,IAAI,CAAC,OAAO,EACZ,GAAG,EAAE,CAAC,KAAK,CACd,CACR,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO;QACjD,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC;CACJ,CAAA;AAnEY,mBAAmB;IAD/B,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC;GACrB,mBAAmB,CAmE/B"}

package/dist/PricingDriverResolver.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Which pricing driver applies — and therefore whether a client may price locally.
+ *
+ * ## The question this answers
+ *
+ * Most pricing is metadata: price rules, tiers, lists, promotions, charge types, tax tables. A
+ * browser can run that walk itself against cached catalog data and show a total instantly, with no
+ * server round trip. What it cannot do is run a PLUGIN — a `BasePriceResolver` subclass, which is
+ * server-side code that may read anything and compute anything.
+ *
+ * So before pricing locally, a client has to know whether a plugin applies. That has to be
+ * answerable from METADATA, because asking the server defeats the point.
+ *
+ * ## Why the answer walks four levels
+ *
+ * The same shape `GLAccountResolver` already uses for accounts: the most specific answer wins.
+ *
+ * ```text
+ * Product.PricingDriverClass
+ *   ↳ ProductCategory.PricingDriverClass        (and up the parent chain)
+ *       ↳ ProductType.PricingDriverClass
+ *           ↳ OrderCompanyPolicy.PricingDriverClass
+ * ```
+ *
+ * A product may price specially on its own; a category may (event tickets); a type may (usage
+ * metering); a company may have a house resolver — which is where every plugin registered before the
+ * column existed is keyed, as `Company:<id>`.
+ *
+ * ## The direction of the safe answer
+ *
+ * `null` at every level means "no plugin", so price locally. **Anything else escalates.** When the
+ * data cannot be read at all this returns an ESCALATION rather than a local verdict: a failed lookup
+ * must not be mistaken for "no plugin found", because the two produce the same absence and only one
+ * of them is safe. Escalating costs a round trip; guessing costs a wrong price.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { type IRunViewProvider, type UserInfo } from '@memberjunction/core';
+/** Where a driver was found, so a caller can say WHY it escalated. */
+export type PricingDriverLevel = 'product' | 'category' | 'type' | 'company';
+export interface PricingDriverVerdict {
+    /** True when every level is null and the caller may run the metadata walk itself. */
+    CanPriceLocally: boolean;
+    /** The ClassFactory key to invoke, when one applies. */
+    DriverClass: string | null;
+    /** Which level supplied it — for diagnostics, and for explaining an escalation. */
+    Level: PricingDriverLevel | null;
+    /**
+     * Set when the verdict is an escalation caused by a FAILED LOOKUP rather than a found driver.
+     * Never silently treated as "no driver" — see the module note on the direction of the safe answer.
+     */
+    Unresolved?: string;
+}
+/**
+ * The driver for one product, or a verdict that it can be priced locally.
+ *
+ * @param productID - The product being priced.
+ * @param companyID - The selling company, for the last fallback level.
+ */
+export declare function ResolvePricingDriver(productID: string, companyID: string | null, provider: IRunViewProvider, user?: UserInfo): Promise<PricingDriverVerdict>;
+/**
+ * True when EVERY product on an order can be priced locally.
+ *
+ * All-or-nothing on purpose. Pricing is not per-line arithmetic — promotions stack against order
+ * totals, charges apportion across lines, tax computes on the discounted amount — so an order with
+ * one plugin-priced line cannot be half-computed locally and half on the server without the two
+ * halves disagreeing about the same totals.
+ */
+export declare function CanPriceOrderLocally(productIDs: string[], companyID: string | null, provider: IRunViewProvider, user?: UserInfo): Promise<PricingDriverVerdict>;
+//# sourceMappingURL=PricingDriverResolver.d.ts.map

package/dist/PricingDriverResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PricingDriverResolver.d.ts","sourceRoot":"","sources":["../src/PricingDriverResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAW,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErF,sEAAsE;AACtE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACjC,qFAAqF;IACrF,eAAe,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mFAAmF;IACnF,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAwBD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,oBAAoB,CAAC,CA0F/B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAM/B"}

package/dist/PricingDriverResolver.js

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview Which pricing driver applies — and therefore whether a client may price locally.
+ *
+ * ## The question this answers
+ *
+ * Most pricing is metadata: price rules, tiers, lists, promotions, charge types, tax tables. A
+ * browser can run that walk itself against cached catalog data and show a total instantly, with no
+ * server round trip. What it cannot do is run a PLUGIN — a `BasePriceResolver` subclass, which is
+ * server-side code that may read anything and compute anything.
+ *
+ * So before pricing locally, a client has to know whether a plugin applies. That has to be
+ * answerable from METADATA, because asking the server defeats the point.
+ *
+ * ## Why the answer walks four levels
+ *
+ * The same shape `GLAccountResolver` already uses for accounts: the most specific answer wins.
+ *
+ * ```text
+ * Product.PricingDriverClass
+ *   ↳ ProductCategory.PricingDriverClass        (and up the parent chain)
+ *       ↳ ProductType.PricingDriverClass
+ *           ↳ OrderCompanyPolicy.PricingDriverClass
+ * ```
+ *
+ * A product may price specially on its own; a category may (event tickets); a type may (usage
+ * metering); a company may have a house resolver — which is where every plugin registered before the
+ * column existed is keyed, as `Company:<id>`.
+ *
+ * ## The direction of the safe answer
+ *
+ * `null` at every level means "no plugin", so price locally. **Anything else escalates.** When the
+ * data cannot be read at all this returns an ESCALATION rather than a local verdict: a failed lookup
+ * must not be mistaken for "no plugin found", because the two produce the same absence and only one
+ * of them is safe. Escalating costs a round trip; guessing costs a wrong price.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { RunView } from '@memberjunction/core';
+/** Price locally — nothing anywhere names a plugin. */
+const LOCAL = { CanPriceLocally: false, DriverClass: null, Level: null };
+const PRODUCT_ENTITY = 'MJ_BizApps_Orders: Products';
+const CATEGORY_ENTITY = 'MJ_BizApps_Orders: Product Categories';
+const TYPE_ENTITY = 'MJ_BizApps_Orders: Product Types';
+const POLICY_ENTITY = 'MJ_BizApps_Orders: Order Company Policies';
+const UUID = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+/**
+ * The driver for one product, or a verdict that it can be priced locally.
+ *
+ * @param productID - The product being priced.
+ * @param companyID - The selling company, for the last fallback level.
+ */
+export async function ResolvePricingDriver(productID, companyID, provider, user) {
+    if (!UUID.test(productID ?? '')) {
+        return { ...LOCAL, CanPriceLocally: false, Unresolved: `'${productID}' is not a product id.` };
+    }
+    const rv = new RunView(provider);
+    const productRes = await rv.RunView({
+        EntityName: PRODUCT_ENTITY,
+        ExtraFilter: `ID = '${productID}'`,
+        Fields: ['ID', 'ProductTypeID', 'ProductCategoryID', 'PricingDriverClass'],
+        ResultType: 'simple',
+    }, user);
+    if (!productRes?.Success) {
+        return { ...LOCAL, Unresolved: `Could not read the product: ${productRes?.ErrorMessage ?? 'unknown error'}` };
+    }
+    const product = productRes.Results?.[0];
+    if (!product) {
+        return { ...LOCAL, Unresolved: `Product ${productID} does not exist.` };
+    }
+    if (product.PricingDriverClass) {
+        return { CanPriceLocally: false, DriverClass: product.PricingDriverClass, Level: 'product' };
+    }
+    // UP THE CATEGORY CHAIN. Walked one level at a time rather than read as a tree, because the
+    // nearest ancestor that names a driver wins and a deeper one must not override it.
+    let categoryID = product.ProductCategoryID;
+    const seen = new Set();
+    while (categoryID && UUID.test(categoryID)) {
+        if (seen.has(categoryID.toLowerCase()))
+            break; // a cycle is bad data, not an infinite loop
+        seen.add(categoryID.toLowerCase());
+        const catRes = await rv.RunView({
+            EntityName: CATEGORY_ENTITY,
+            ExtraFilter: `ID = '${categoryID}'`,
+            Fields: ['ID', 'ParentProductCategoryID', 'PricingDriverClass'],
+            ResultType: 'simple',
+        }, user);
+        if (!catRes?.Success) {
+            return { ...LOCAL, Unresolved: `Could not read product category ${categoryID}.` };
+        }
+        const category = catRes.Results?.[0];
+        if (!category)
+            break;
+        if (category.PricingDriverClass) {
+            return { CanPriceLocally: false, DriverClass: category.PricingDriverClass, Level: 'category' };
+        }
+        categoryID = category.ParentProductCategoryID;
+    }
+    if (product.ProductTypeID && UUID.test(product.ProductTypeID)) {
+        const typeRes = await rv.RunView({
+            EntityName: TYPE_ENTITY,
+            ExtraFilter: `ID = '${product.ProductTypeID}'`,
+            Fields: ['PricingDriverClass'],
+            ResultType: 'simple',
+        }, user);
+        if (!typeRes?.Success) {
+            return { ...LOCAL, Unresolved: `Could not read product type ${product.ProductTypeID}.` };
+        }
+        const driver = typeRes.Results?.[0]?.PricingDriverClass;
+        if (driver)
+            return { CanPriceLocally: false, DriverClass: driver, Level: 'type' };
+    }
+    if (companyID && UUID.test(companyID)) {
+        const policyRes = await rv.RunView({
+            EntityName: POLICY_ENTITY,
+            ExtraFilter: `ID = '${companyID}'`,
+            Fields: ['PricingDriverClass'],
+            ResultType: 'simple',
+        }, user);
+        if (!policyRes?.Success) {
+            return { ...LOCAL, Unresolved: `Could not read the company pricing policy.` };
+        }
+        const driver = policyRes.Results?.[0]?.PricingDriverClass;
+        if (driver)
+            return { CanPriceLocally: false, DriverClass: driver, Level: 'company' };
+    }
+    // Nothing anywhere names a plugin: the metadata walk is the whole answer, so a client may run it.
+    return { CanPriceLocally: true, DriverClass: null, Level: null };
+}
+/**
+ * True when EVERY product on an order can be priced locally.
+ *
+ * All-or-nothing on purpose. Pricing is not per-line arithmetic — promotions stack against order
+ * totals, charges apportion across lines, tax computes on the discounted amount — so an order with
+ * one plugin-priced line cannot be half-computed locally and half on the server without the two
+ * halves disagreeing about the same totals.
+ */
+export async function CanPriceOrderLocally(productIDs, companyID, provider, user) {
+    for (const productID of [...new Set(productIDs)]) {
+        const verdict = await ResolvePricingDriver(productID, companyID, provider, user);
+        if (!verdict.CanPriceLocally)
+            return verdict;
+    }
+    return { CanPriceLocally: true, DriverClass: null, Level: null };
+}
+//# sourceMappingURL=PricingDriverResolver.js.map

package/dist/PricingDriverResolver.js.map

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

package/dist/PromotionCodesCompanion.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview `PromotionCodesCompanion` — the codes a customer presented, riding with the order.
+ *
+ * ## Why this is a companion and not a related-record collection
+ *
+ * Charges and manual discounts became collections because they have child ROWS with an
+ * `OrderHeaderID` — a client can stage one and the engine completes it. A promotion code has no such
+ * row. `PromotionCode` is catalog metadata (which codes exist); the RESULT of applying one is an
+ * `OrderAdjustment` with `PromotionCodeID` set, and only the engine can produce that.
+ *
+ * At compose time the browser holds a **string**. It does not know the code's id, whether this
+ * customer qualifies, what the promotion is worth against these lines, whether it stacks with
+ * another, or whether the promotion has hit its redemption cap — that last one depending on orders
+ * other people placed a second ago. Forcing it into a collection would mean inventing a table to
+ * hold a request, which is the mirror problem wearing a different hat.
+ *
+ * So it is what MJ's companion abstraction is actually for: state that belongs to the record, is not
+ * one of its fields, and has to cross the wire.
+ *
+ * ## What this fixes
+ *
+ * `OrderEntityServer._promotionCodes` was a transient array only the server could populate. While
+ * `OrderDraft` existed its hydrator carried the codes across; when the draft was deleted nothing
+ * replaced that path, so a code typed on screen was priced into the PREVIEW — `Orders.PriceOrder`
+ * receives them directly — and then silently dropped at confirm. The customer saw a discount and was
+ * billed full price, with every total on the order agreeing with every other total.
+ *
+ * ## Contributes nothing to the save plan, deliberately
+ *
+ * A code is an input. It produces no row of its own, so there is nothing for it to write; the
+ * adjustment rows the engine derives from it are written by the promotion engine, inside the booking
+ * transaction, where the decision is actually made.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { EntityCompanion, type EntityCompanionDeserializeMode } from '@memberjunction/core';
+/** The wire shape: just the codes, in the order the customer gave them. */
+export type PromotionCodesWire = string[];
+export declare class PromotionCodesCompanion extends EntityCompanion<PromotionCodesWire> {
+    /**
+     * The wire key. **Published contract** — renaming it silently drops codes from in-flight
+     * payloads written by the other side of a rolling deploy, and a dropped code is a discount the
+     * customer was promised and did not get.
+     */
+    readonly Name = "PromotionCodes";
+    private codes;
+    /** The codes presented, de-duplicated and trimmed. */
+    get Codes(): string[];
+    set Codes(value: string[]);
+    /** Present a code. Adding one twice is not two discounts, so it is not two entries. */
+    Add(code: string): void;
+    /** Withdraw a code the customer removed before saving. */
+    Remove(code: string): void;
+    Clear(): void;
+    /**
+     * `null` when there are no codes, so an ordinary save does not pay to ship an empty array.
+     */
+    Serialize(): Promise<PromotionCodesWire | null>;
+    /**
+     * Restores the codes from the other tier.
+     *
+     * `mode` is ignored on purpose. A code list is a REQUEST in both directions: there is no
+     * server-authoritative version of "what the customer typed" to overwrite the client's copy with,
+     * and the engine's verdict on each code travels back separately as `UnusablePromotionCodes` —
+     * which says WHY a code did nothing, and is the thing worth showing.
+     */
+    Deserialize(data: PromotionCodesWire, _mode: EntityCompanionDeserializeMode): Promise<void>;
+    /**
+     * Dirty when any code is present.
+     *
+     * Load-bearing rather than tidy: an order whose ONLY change is a promotion code must still save.
+     * Reporting clean here would return early from `Save()` and drop the code — the same silent loss
+     * this companion exists to end, reintroduced one level down.
+     */
+    get Dirty(): boolean;
+}
+//# sourceMappingURL=PromotionCodesCompanion.d.ts.map

package/dist/PromotionCodesCompanion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromotionCodesCompanion.d.ts","sourceRoot":"","sources":["../src/PromotionCodesCompanion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,EAAE,eAAe,EAAE,KAAK,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAE5F,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG,MAAM,EAAE,CAAC;AAE1C,qBAAa,uBAAwB,SAAQ,eAAe,CAAC,kBAAkB,CAAC;IAC5E;;;;OAIG;IACH,SAAgB,IAAI,oBAAoB;IAExC,OAAO,CAAC,KAAK,CAAgB;IAE7B,sDAAsD;IACtD,IAAW,KAAK,IAAI,MAAM,EAAE,CAE3B;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAE/B;IAED,uFAAuF;IAChF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,0DAA0D;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAI5D;;;;;;;OAOG;IACU,WAAW,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxG;;;;;;OAMG;IACH,IAAoB,KAAK,IAAI,OAAO,CAEnC;CACJ"}

package/dist/PromotionCodesCompanion.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview `PromotionCodesCompanion` — the codes a customer presented, riding with the order.
+ *
+ * ## Why this is a companion and not a related-record collection
+ *
+ * Charges and manual discounts became collections because they have child ROWS with an
+ * `OrderHeaderID` — a client can stage one and the engine completes it. A promotion code has no such
+ * row. `PromotionCode` is catalog metadata (which codes exist); the RESULT of applying one is an
+ * `OrderAdjustment` with `PromotionCodeID` set, and only the engine can produce that.
+ *
+ * At compose time the browser holds a **string**. It does not know the code's id, whether this
+ * customer qualifies, what the promotion is worth against these lines, whether it stacks with
+ * another, or whether the promotion has hit its redemption cap — that last one depending on orders
+ * other people placed a second ago. Forcing it into a collection would mean inventing a table to
+ * hold a request, which is the mirror problem wearing a different hat.
+ *
+ * So it is what MJ's companion abstraction is actually for: state that belongs to the record, is not
+ * one of its fields, and has to cross the wire.
+ *
+ * ## What this fixes
+ *
+ * `OrderEntityServer._promotionCodes` was a transient array only the server could populate. While
+ * `OrderDraft` existed its hydrator carried the codes across; when the draft was deleted nothing
+ * replaced that path, so a code typed on screen was priced into the PREVIEW — `Orders.PriceOrder`
+ * receives them directly — and then silently dropped at confirm. The customer saw a discount and was
+ * billed full price, with every total on the order agreeing with every other total.
+ *
+ * ## Contributes nothing to the save plan, deliberately
+ *
+ * A code is an input. It produces no row of its own, so there is nothing for it to write; the
+ * adjustment rows the engine derives from it are written by the promotion engine, inside the booking
+ * transaction, where the decision is actually made.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { EntityCompanion } from '@memberjunction/core';
+export class PromotionCodesCompanion extends EntityCompanion {
+    constructor() {
+        super(...arguments);
+        /**
+         * The wire key. **Published contract** — renaming it silently drops codes from in-flight
+         * payloads written by the other side of a rolling deploy, and a dropped code is a discount the
+         * customer was promised and did not get.
+         */
+        this.Name = 'PromotionCodes';
+        this.codes = [];
+    }
+    /** The codes presented, de-duplicated and trimmed. */
+    get Codes() {
+        return [...this.codes];
+    }
+    set Codes(value) {
+        this.codes = normalize(value);
+    }
+    /** Present a code. Adding one twice is not two discounts, so it is not two entries. */
+    Add(code) {
+        this.codes = normalize([...this.codes, code]);
+    }
+    /** Withdraw a code the customer removed before saving. */
+    Remove(code) {
+        const key = code.trim().toLowerCase();
+        this.codes = this.codes.filter((c) => c.toLowerCase() !== key);
+    }
+    Clear() {
+        this.codes = [];
+    }
+    /**
+     * `null` when there are no codes, so an ordinary save does not pay to ship an empty array.
+     */
+    async Serialize() {
+        return this.codes.length ? [...this.codes] : null;
+    }
+    /**
+     * Restores the codes from the other tier.
+     *
+     * `mode` is ignored on purpose. A code list is a REQUEST in both directions: there is no
+     * server-authoritative version of "what the customer typed" to overwrite the client's copy with,
+     * and the engine's verdict on each code travels back separately as `UnusablePromotionCodes` —
+     * which says WHY a code did nothing, and is the thing worth showing.
+     */
+    async Deserialize(data, _mode) {
+        this.codes = normalize(Array.isArray(data) ? data : []);
+    }
+    /**
+     * Dirty when any code is present.
+     *
+     * Load-bearing rather than tidy: an order whose ONLY change is a promotion code must still save.
+     * Reporting clean here would return early from `Save()` and drop the code — the same silent loss
+     * this companion exists to end, reintroduced one level down.
+     */
+    get Dirty() {
+        return this.codes.length > 0;
+    }
+}
+/** Trimmed, non-empty, case-insensitively de-duplicated, first occurrence wins. */
+function normalize(values) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of values ?? []) {
+        const code = String(raw ?? '').trim();
+        if (!code)
+            continue;
+        const key = code.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(code);
+    }
+    return out;
+}
+//# sourceMappingURL=PromotionCodesCompanion.js.map

package/dist/PromotionCodesCompanion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromotionCodesCompanion.js","sourceRoot":"","sources":["../src/PromotionCodesCompanion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,EAAE,eAAe,EAAuC,MAAM,sBAAsB,CAAC;AAK5F,MAAM,OAAO,uBAAwB,SAAQ,eAAmC;IAAhF;;QACI;;;;WAIG;QACa,SAAI,GAAG,gBAAgB,CAAC;QAEhC,UAAK,GAAa,EAAE,CAAC;IAuDjC,CAAC;IArDG,sDAAsD;IACtD,IAAW,KAAK;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,IAAW,KAAK,CAAC,KAAe;QAC5B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,uFAAuF;IAChF,GAAG,CAAC,IAAY;QACnB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,0DAA0D;IACnD,MAAM,CAAC,IAAY;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,SAAS;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,WAAW,CAAC,IAAwB,EAAE,KAAqC;QACpF,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,IAAoB,KAAK;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;CACJ;AAED,mFAAmF;AACnF,SAAS,SAAS,CAAC,MAAmC;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/booked-money.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What a booked order may not change — stated once, enforced from Validate().
+ *
+ * Confirm books journal entries. A later edit that adds a line, reprices one, or
+ * restates the initial tender would leave the ledger pointing at a different
+ * amount than the order. Trigger 51003 freezes money columns on an *existing*
+ * line update; it does not stop inserting a new line onto a confirmed order.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+/** Line columns that change what was booked. */
+export declare const ORDER_LINE_MONEY_FIELDS: readonly ["Quantity", "UnitPrice", "DiscountPct", "DiscountAmount", "LineTax", "ChargeAmount", "LineTotalNet", "LineTotalGross"];
+/** Header columns that change what was booked. */
+export declare const ORDER_HEADER_MONEY_FIELDS: readonly ["InitialPaymentTypeID", "InitialPaymentAmount", "InitialPaymentDetailID", "CompanyID"];
+export interface BookedMoneyEditFacts {
+    NewLineCount: number;
+    RemovedLineCount: number;
+    DirtyLineMoneyFields: string[];
+    ChargesChanged: boolean;
+    AdjustmentsChanged: boolean;
+    DirtyHeaderMoneyFields: string[];
+}
+/**
+ * Human-readable refusal, or null when this save does not touch booked money.
+ */
+export declare function BookedMoneyEditMessage(facts: BookedMoneyEditFacts): string | null;
+//# sourceMappingURL=booked-money.d.ts.map

package/dist/booked-money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booked-money.d.ts","sourceRoot":"","sources":["../src/booked-money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,kIAS1B,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,kGAK5B,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,MAAM,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CA6BjF"}

package/dist/booked-money.js

@@ -0,0 +1,67 @@
+/**
+ * What a booked order may not change — stated once, enforced from Validate().
+ *
+ * Confirm books journal entries. A later edit that adds a line, reprices one, or
+ * restates the initial tender would leave the ledger pointing at a different
+ * amount than the order. Trigger 51003 freezes money columns on an *existing*
+ * line update; it does not stop inserting a new line onto a confirmed order.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+/** Line columns that change what was booked. */
+export const ORDER_LINE_MONEY_FIELDS = [
+    'Quantity',
+    'UnitPrice',
+    'DiscountPct',
+    'DiscountAmount',
+    'LineTax',
+    'ChargeAmount',
+    'LineTotalNet',
+    'LineTotalGross',
+];
+/** Header columns that change what was booked. */
+export const ORDER_HEADER_MONEY_FIELDS = [
+    'InitialPaymentTypeID',
+    'InitialPaymentAmount',
+    'InitialPaymentDetailID',
+    'CompanyID',
+];
+/**
+ * Human-readable refusal, or null when this save does not touch booked money.
+ */
+export function BookedMoneyEditMessage(facts) {
+    const parts = [];
+    if (facts.NewLineCount > 0) {
+        parts.push(facts.NewLineCount === 1 ? 'add a line' : `add ${facts.NewLineCount} lines`);
+    }
+    if (facts.RemovedLineCount > 0) {
+        parts.push(facts.RemovedLineCount === 1 ? 'remove a line' : `remove ${facts.RemovedLineCount} lines`);
+    }
+    if (facts.DirtyLineMoneyFields.length > 0) {
+        parts.push(`change ${uniqueJoin(facts.DirtyLineMoneyFields)}`);
+    }
+    if (facts.ChargesChanged) {
+        parts.push('change charges');
+    }
+    if (facts.AdjustmentsChanged) {
+        parts.push('change adjustments');
+    }
+    if (facts.DirtyHeaderMoneyFields.length > 0) {
+        parts.push(`change ${uniqueJoin(facts.DirtyHeaderMoneyFields)}`);
+    }
+    if (parts.length === 0)
+        return null;
+    return (`This order is booked — it cannot ${joinList(parts)}. ` +
+        `Voiding (and a reversal order) is how booked money is undone, not an edit of the original.`);
+}
+function uniqueJoin(names) {
+    return joinList([...new Set(names)]);
+}
+function joinList(parts) {
+    if (parts.length === 1)
+        return parts[0];
+    if (parts.length === 2)
+        return `${parts[0]} or ${parts[1]}`;
+    return `${parts.slice(0, -1).join(', ')}, or ${parts[parts.length - 1]}`;
+}
+//# sourceMappingURL=booked-money.js.map

package/dist/booked-money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booked-money.js","sourceRoot":"","sources":["../src/booked-money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,UAAU;IACV,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,SAAS;IACT,cAAc;IACd,cAAc;IACd,gBAAgB;CACV,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,WAAW;CACL,CAAC;AAWX;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CACN,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,QAAQ,CAC9E,CAAC;IACN,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACN,KAAK,CAAC,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,gBAAgB,QAAQ,CAC5F,CAAC;IACN,CAAC;IACD,IAAI,KAAK,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,sBAAsB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,UAAU,UAAU,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,CACH,oCAAoC,QAAQ,CAAC,KAAK,CAAC,IAAI;QACvD,4FAA4F,CAC/F,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,KAAe;IAC/B,OAAO,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAe;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}