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

package/dist/OrderJournalEntryFactory.js

@@ -0,0 +1,466 @@
+/**
+ * OrderJournalEntryFactory — turns an order's lines into balanced journal-entry drafts.
+ *
+ * Plan D10: ONE BOOKING JE PER ORDER LINE, always — even multiple lines of the same company. The
+ * "order-level journal entry" is a UI aggregation of the line JEs, never a row.
+ *
+ * Plan D11 — the booking entry per line:
+ *
+ *     Dr  Accounts Receivable      net (+ tax when the tax build lands)
+ *     Dr  Sales Discounts          discount            (contra; omitted when 0)
+ *         Cr  Sales                gross               (recognized at booking)
+ *         Cr  Deferred Revenue     gross               (deferred — released per the schedule)
+ *
+ * where net is the LINE'S OWN stored LineTotalNet — the authority, not a recomputation —
+ * discount = (rate-gross × DiscountPct) + DiscountAmount, and gross = net + discount.
+ * Both discount fields are applied because the line applies both.
+ * The entry balances by construction: net + discount = gross.
+ *
+ * Plan D14/D43 — RECOGNITION. The product's `RevenueRecognitionType` names a pluggable driver
+ * (see ./RevenueRecognition.ts) that returns a schedule of dates and amounts. For a DEFERRED type
+ * we emit one REAL FORWARD-DATED entry per schedule slice:
+ *
+ *     Dr  Deferred Revenue         slice
+ *         Cr  Sales                slice        (EffectiveDate = the recognition date)
+ *
+ * No materializer, no wake-up job — the ledger holds the future. A 12-month subscription books one
+ * AR/Deferred entry plus twelve dated release entries, all inside the same booking transaction.
+ * An UpFront line skips the deferral round-trip entirely and credits Sales directly.
+ *
+ * Plan D31 — DIMENSIONS. Each line's `OrderLineDimension` tags ride onto every JE line the line
+ * produces, so departmental/segment reporting survives into the ledger and through batch
+ * summarization. Where a resolved GL account link REQUIRES a dimension the line hasn't tagged, we
+ * fail loudly rather than book an entry that can't be reported on.
+ *
+ * NEGATIVE QUANTITIES are the reversal mechanism (plan D16) — they flow through the same
+ * arithmetic and mirror every entry, so returns and credit memos need no special path.
+ *
+ * CONNECTS TO:
+ *   RESOLVER: GLAccountResolver (./GLAccountResolver.ts) — role → account, with the company guard
+ *   DRIVERS:  RevenueRecognitionDriver (./RevenueRecognition.ts) — the schedule
+ *   CALLER:   OrderEntityServer.Save (./OrderEntityServer.ts) — owns the transaction
+ */
+import { RunView } from '@memberjunction/core';
+import { MJGlobal } from '@memberjunction/global';
+import { GL_ROLE, GLAccountResolutionError } from './GLAccountResolver.js';
+import { RevenueRecognitionDriver } from './RevenueRecognition.js';
+import { GIFT_CARD_PRODUCT_TYPE_CODE } from './GiftCardBehavior.js';
+/**
+ * Swap every line's debit and credit side. This is what "reversing" means in double-entry: the
+ * original `Dr AR / Cr Deferred Revenue` becomes `Dr Deferred Revenue / Cr AR`, at the same
+ * positive amount. Returns the input untouched when `reverse` is false, so callers can apply it
+ * unconditionally.
+ */
+function mirrorIf(reverse, lines) {
+    if (!reverse)
+        return lines;
+    return lines.map((l) => ({
+        ...l,
+        DebitAmount: l.CreditAmount,
+        CreditAmount: l.DebitAmount,
+    }));
+}
+function money(value) {
+    return Math.round((value + Number.EPSILON) * 100) / 100;
+}
+function isoDate(d) {
+    return new Date(d).toISOString().slice(0, 10);
+}
+export class OrderJournalEntryFactory {
+    constructor(_resolver, _orderLineEntityID, _subscriptionTermEntityID, _chargeTypeEntityID, _provider, _contextUser) {
+        this._resolver = _resolver;
+        this._orderLineEntityID = _orderLineEntityID;
+        this._subscriptionTermEntityID = _subscriptionTermEntityID;
+        this._chargeTypeEntityID = _chargeTypeEntityID;
+        this._provider = _provider;
+        this._contextUser = _contextUser;
+    }
+    /**
+     * Build every draft the order needs: one booking entry per line, plus the forward-dated
+     * recognition entries for deferred lines. Throws on the first line that cannot be resolved —
+     * booking is all-or-none, so partial results have no value.
+     */
+    async BuildDrafts(order, lines, 
+    /**
+     * Terms created for subscription lines during this confirm, keyed by OrderLineID (D46).
+     * Recognition entries anchor to the TERM — the release is caused by time passing over that
+     * coverage period. The booking entry stays on the line: that is caused by the sale.
+     */
+    termsByLine, 
+    /** Months per recognition slice, per line, from the subscription type's cadence (D45). */
+    recognitionMonthsByLine) {
+        if (lines.length === 0) {
+            throw new Error(`Order ${order.OrderNumber} has no lines to book.`);
+        }
+        const products = await this.loadProducts(lines.map((l) => l.ProductID));
+        const giftCardTypeIDs = await this.loadGiftCardTypeIDs();
+        const revRecTypes = await this.loadRevRecTypes();
+        const dimensions = await this.loadLineDimensions(lines.map((l) => l.ID));
+        const effectiveDate = this.effectiveDateOf(order);
+        const asOf = new Date(effectiveDate);
+        const drafts = [];
+        for (const line of lines) {
+            drafts.push(...(await this.buildLineDrafts(order, line, products, revRecTypes, dimensions, effectiveDate, asOf, giftCardTypeIDs, termsByLine?.get(line.ID), recognitionMonthsByLine?.get(line.ID))));
+        }
+        return drafts;
+    }
+    async buildLineDrafts(order, line, products, revRecTypes, dimensions, effectiveDate, asOf, giftCardTypeIDs, term, recognitionMonths) {
+        const product = products.get(line.ProductID);
+        if (!product) {
+            throw new Error(`Order line ${line.ID} references product ${line.ProductID}, which was not found.`);
+        }
+        const revRec = revRecTypes.get(product.RevenueRecognitionTypeID);
+        if (!revRec) {
+            throw new Error(`Product '${product.Name}' has no valid revenue recognition type — cannot determine ` +
+                `whether its revenue is earned at booking or over time.`);
+        }
+        // The line's company is the denormalized stamp of the product's company (plan D6).
+        const companyID = line.CompanyID ?? product.CompanyID;
+        const lineDims = dimensions.get(line.ID) ?? [];
+        // REVERSALS ARE MIRRORED, NOT NEGATED (D16). A negative quantity means "unwind this much of
+        // that purchase" — and the correct double-entry for unwinding is the SAME accounts with the
+        // debit and credit sides swapped, at a positive amount. Feeding a negative amount through
+        // instead produces `Dr AR -593.52`, which accounting rightly refuses: a ledger line with a
+        // negative debit is not a thing. So every amount below is computed on the ABSOLUTE quantity
+        // and the finished lines are flipped once, at the end, when the line reverses.
+        const isReversal = line.Quantity < 0;
+        // THE LINE IS THE AUTHORITY ON ITS OWN MONEY, and by booking time it has been
+        // computed and stored. This used to re-derive gross as quantity × UnitPrice —
+        // a fourth copy of a formula that is only correct for PerUnit pricing. On a
+        // Flat rule the unit price is a DERIVED rate that cannot always represent the
+        // total, so the entry mirrored the wrong figure: a flat 100 at quantity 3
+        // booked 99.99, at quantity 7 booked 100.03. The entry still BALANCED, which
+        // is exactly the failure this file's own header warns about — AR merely
+        // differs from the line total and nothing downstream reports it.
+        //
+        // Anchoring net to the stored LineTotalNet and deriving gross as net + discount
+        // keeps `net + discount = gross` true by construction, and makes the entry agree
+        // with the line by definition rather than by two computations happening to
+        // match. The rate is still used for the DISCOUNT split, which is the only part
+        // the line does not store separately.
+        const grossFromRate = money(Math.abs(line.Quantity) * line.UnitPrice);
+        // BOTH discount fields, and in the same order OrderLineEntityServer applies them (D70).
+        // The journal entry must mirror the line's arithmetic exactly — if the two disagree, the
+        // entry still BALANCES (AR simply differs from the line total) and nothing downstream
+        // reports it, which is the failure mode this whole area keeps producing.
+        const pctDiscount = money(grossFromRate * (line.DiscountPct ?? 0));
+        const amountDiscount = money(Math.min(Math.max(0, grossFromRate - pctDiscount), line.DiscountAmount ?? 0));
+        const discount = money(pctDiscount + amountDiscount);
+        const net = money(Math.abs(Number(line.LineTotalNet ?? 0)));
+        const gross = money(net + discount);
+        const tax = money(Math.abs(line.LineTax ?? 0));
+        const charges = money(Math.abs(line.ChargeAmount ?? 0));
+        const resolve = (role) => this._resolver.Resolve(role, product.ID, product.ProductCategoryID, companyID, asOf, product.ProductTypeID);
+        const arAccount = await resolve(GL_ROLE.AccountsReceivable);
+        const salesAccount = await resolve(GL_ROLE.Sales);
+        // SELLING A GIFT CARD EARNS NOTHING (D44). Money has come in and goods are owed, so the
+        // credit is a LIABILITY. Recognising here and again when the card is spent is the classic
+        // gift-card double-count, and it hides well: both entries balance, the order reconciles,
+        // and only the revenue figure is wrong.
+        //
+        // It also means NO revenue-recognition schedule. A deferred type releases on dates; a gift
+        // card releases when somebody spends it, which is an event on a different order entirely.
+        const isGiftCard = giftCardTypeIDs.has(product.ProductTypeID);
+        let bookingCreditAccount;
+        let creditLabel;
+        if (isGiftCard) {
+            try {
+                bookingCreditAccount = await resolve(GL_ROLE.GiftCardLiability);
+                creditLabel = 'Gift card liability';
+            }
+            catch {
+                // Same tolerance as Processing Fee: a role accounting has not seeded must not take
+                // the sale down. Deferred Revenue is the same SHAPE of obligation, so the entry stays
+                // correct and balanced — just coarser than a dedicated card liability. Reported
+                // rather than swallowed, because the difference matters at year end.
+                bookingCreditAccount = await resolve(GL_ROLE.DeferredRevenue);
+                creditLabel = 'Gift card liability (in Deferred Revenue)';
+                console.warn(`Order line ${line.ID}: no 'Gift Card Liability' GL account is linked for company ` +
+                    `${companyID}, so the card's liability was booked to Deferred Revenue instead. ` +
+                    `The entry balances and no revenue is overstated, but the two obligations are ` +
+                    `now indistinguishable on the balance sheet. Link a Gift Card Liability account.`);
+            }
+        }
+        else if (revRec.IsDeferred) {
+            // Deferred types park the credit in Deferred Revenue until the schedule releases it.
+            bookingCreditAccount = await resolve(GL_ROLE.DeferredRevenue);
+            creditLabel = 'Deferred revenue';
+        }
+        else {
+            bookingCreditAccount = salesAccount;
+            creditLabel = 'Sales';
+        }
+        let discountAccount = null;
+        if (discount !== 0) {
+            try {
+                discountAccount = await resolve(GL_ROLE.SalesDiscounts);
+            }
+            catch {
+                discountAccount = null; // plan D11 — net into the revenue credit instead
+            }
+        }
+        // ── the booking entry (D10/D11) ──
+        const bookingLines = [
+            {
+                GLAccountID: arAccount,
+                DebitAmount: money(net + tax + charges),
+                Description: `AR — ${product.Name}`,
+                Dimensions: lineDims,
+            },
+            {
+                GLAccountID: bookingCreditAccount,
+                CreditAmount: discountAccount ? gross : net,
+                Description: `${creditLabel} — ${product.Name}`,
+                Dimensions: lineDims,
+            },
+        ];
+        if (discountAccount) {
+            bookingLines.push({
+                GLAccountID: discountAccount,
+                DebitAmount: discount,
+                Description: `Discount — ${product.Name}`,
+                Dimensions: lineDims,
+            });
+        }
+        // ── CHARGE AND TAX CREDITS (D71) ──
+        // AR is debited for net + tax + charges, so every one of those needs a matching credit or
+        // the entry does not balance. Tax has been in the AR debit since booking was written and had
+        // no credit at all — it simply had never been non-zero, which is the kind of latent break
+        // that only surfaces the day the feature is used.
+        //
+        // Each charge credits an account resolved from its CHARGE TYPE, so shipping revenue and a
+        // tax liability go to different places without this factory knowing what either means. The
+        // role name is a lookup key, not a claim about the account's nature — a tax charge links to
+        // a liability account through the same mechanism.
+        const chargeCredits = await this.chargeCreditsFor(line, companyID, asOf);
+        for (const c of chargeCredits) {
+            bookingLines.push({
+                GLAccountID: c.GLAccountID,
+                CreditAmount: c.Amount,
+                Description: `${c.Label} — ${product.Name}`,
+                Dimensions: lineDims,
+            });
+        }
+        // Drop zero-amount lines. A fully-discounted line — a comped ticket, a 100%-off promotion —
+        // has net 0, and accounting rightly refuses a JE line for nothing (MALFORMED_DRAFT). The
+        // entry itself is still real and still balances: Dr Sales Discounts / Cr Sales for the
+        // discount. Without this a free item cannot be ordered at all, which is a legitimate thing
+        // to sell.
+        const bookingEntryLines = mirrorIf(isReversal, bookingLines.filter((l) => money(l.DebitAmount ?? 0) !== 0 || money(l.CreditAmount ?? 0) !== 0));
+        // NOTHING TO BOOK is a legitimate outcome, not a failure. A fully-comped line — 100% off, or
+        // a free item — nets to zero, and when the discount has no contra account it nets into the
+        // sales credit too, leaving an entry with no non-zero side. Double-entry needs two lines, so
+        // emitting one here would refuse the whole order for a line that has no ledger impact at all.
+        // The line still exists, still shows on the invoice, and still recognizes nothing.
+        const hasBooking = bookingEntryLines.length >= 2;
+        if (hasBooking) {
+            this.assertBalanced(bookingEntryLines, order, line, 'booking');
+        }
+        const out = hasBooking
+            ? [
+                {
+                    OrderLineID: line.ID,
+                    IsBooking: true,
+                    Draft: {
+                        EffectiveDate: effectiveDate,
+                        EntryType: 'OrderBooking',
+                        Description: `Order ${order.OrderNumber} line ${line.LineNumber} — ` +
+                            `${isReversal ? 'REVERSAL of ' : ''}${product.Name}`,
+                        LinkedEntityID: this._orderLineEntityID,
+                        LinkedRecordID: line.ID,
+                        Lines: bookingEntryLines,
+                    },
+                },
+            ]
+            : [];
+        // ── the forward-dated releases (D14/D43) ──
+        if (revRec.IsDeferred && !isGiftCard) {
+            // A subscription line's coverage window comes from its TERM (which applied anchoring,
+            // deferral and proration); a non-subscription deferred line uses the line's own dates.
+            const schedule = this.driverFor(revRec).BuildSchedule({
+                Amount: term ? term.Amount : net,
+                BookingDate: new Date(effectiveDate),
+                ServicePeriodStart: term ? term.StartDate : (line.ServicePeriodStart ? new Date(line.ServicePeriodStart) : null),
+                ServicePeriodEnd: term ? term.EndDate : (line.ServicePeriodEnd ? new Date(line.ServicePeriodEnd) : null),
+                ProductName: product.Name,
+                PeriodMonths: recognitionMonths,
+            });
+            for (const entry of schedule.Entries) {
+                const releaseLines = [
+                    {
+                        GLAccountID: bookingCreditAccount,
+                        DebitAmount: entry.Amount,
+                        Description: `Release deferred — ${product.Name}`,
+                        Dimensions: lineDims,
+                    },
+                    {
+                        GLAccountID: salesAccount,
+                        CreditAmount: entry.Amount,
+                        Description: `Revenue — ${product.Name}`,
+                        Dimensions: lineDims,
+                    },
+                ];
+                const releaseEntryLines = mirrorIf(isReversal, releaseLines);
+                this.assertBalanced(releaseEntryLines, order, line, 'recognition');
+                out.push({
+                    OrderLineID: line.ID,
+                    IsBooking: false,
+                    SubscriptionTermID: term?.ID,
+                    RecognitionEntry: entry,
+                    Draft: {
+                        EffectiveDate: isoDate(entry.RecognitionDate),
+                        EntryType: 'RevenueRecognition',
+                        Description: `Order ${order.OrderNumber} line ${line.LineNumber} — ` +
+                            `${isReversal ? 'unrecognize' : 'recognize'} ${product.Name}`,
+                        // D46: anchor to the TERM when there is one; otherwise the line (event
+                        // products are deferred but have no subscription and therefore no term).
+                        LinkedEntityID: term ? this._subscriptionTermEntityID : this._orderLineEntityID,
+                        LinkedRecordID: term ? term.ID : line.ID,
+                        Lines: releaseEntryLines,
+                    },
+                });
+            }
+        }
+        return out;
+    }
+    /** Resolve the driver through MJ's ClassFactory so subclasses registered on the same key win. */
+    driverFor(revRec) {
+        const driver = MJGlobal.Instance.ClassFactory.CreateInstance(RevenueRecognitionDriver, revRec.DriverClass);
+        if (!driver) {
+            throw new Error(`Revenue recognition type '${revRec.Code}' names driver '${revRec.DriverClass}', which is ` +
+                `not registered. Register a RevenueRecognitionDriver subclass under that key.`);
+        }
+        return driver;
+    }
+    /**
+     * Rounding at several independent places can drift a cent. Catch it here with a message that
+     * names the order line, rather than at the DB trigger, which cannot.
+     */
+    assertBalanced(lines, order, line, kind) {
+        const debits = money(lines.reduce((s, l) => s + (l.DebitAmount ?? 0), 0));
+        const credits = money(lines.reduce((s, l) => s + (l.CreditAmount ?? 0), 0));
+        if (debits !== credits) {
+            throw new Error(`The ${kind} entry for order ${order.OrderNumber} line ${line.LineNumber} does not balance: ` +
+                `debits ${debits} vs credits ${credits}. No entries were booked.`);
+        }
+    }
+    /** `OrderDate` is the accounting date (backdating is allowed and unguarded — D25). */
+    effectiveDateOf(order) {
+        return isoDate(order.OrderDate ? new Date(order.OrderDate) : new Date());
+    }
+    async loadProducts(productIDs) {
+        const inList = [...new Set(productIDs)].map((id) => `'${id}'`).join(',');
+        const rv = new RunView(this._provider);
+        const result = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Products',
+            ExtraFilter: `ID IN (${inList})`,
+            Fields: ['ID', 'CompanyID', 'ProductCategoryID', 'ProductTypeID', 'RevenueRecognitionTypeID', 'Name'],
+            ResultType: 'simple',
+        }, this._contextUser);
+        return new Map((result?.Results ?? []).map((p) => [p.ID, p]));
+    }
+    /**
+     * ProductType IDs whose Code marks them a gift card.
+     *
+     * Resolved by CODE rather than by a hardcoded ID because product types are per-deployment data,
+     * not seeded metadata with stable keys. One query for the whole draft build, not one per line.
+     */
+    async loadGiftCardTypeIDs() {
+        const rv = new RunView(this._provider);
+        const result = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Product Types',
+            ExtraFilter: `Code = '${GIFT_CARD_PRODUCT_TYPE_CODE}'`,
+            Fields: ['ID'],
+            ResultType: 'simple',
+        }, this._contextUser);
+        return new Set((result?.Results ?? []).map((r) => r.ID));
+    }
+    async loadRevRecTypes() {
+        const rv = new RunView(this._provider);
+        const result = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Revenue Recognition Types',
+            Fields: ['ID', 'Code', 'DriverClass', 'IsDeferred'],
+            ResultType: 'simple',
+        }, this._contextUser);
+        return new Map((result?.Results ?? []).map((t) => [t.ID, t]));
+    }
+    /** Plan D31 — the line's dimension tags ride onto every JE line it produces. */
+    async loadLineDimensions(lineIDs) {
+        const inList = lineIDs.map((id) => `'${id}'`).join(',');
+        const rv = new RunView(this._provider);
+        const result = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Order Line Dimensions',
+            ExtraFilter: `OrderLineID IN (${inList})`,
+            Fields: ['OrderLineID', 'DimensionID', 'DimensionValueID'],
+            ResultType: 'simple',
+        }, this._contextUser);
+        const map = new Map();
+        for (const row of result?.Results ?? []) {
+            const list = map.get(row.OrderLineID) ?? [];
+            list.push({ DimensionID: row.DimensionID, DimensionValueID: row.DimensionValueID });
+            map.set(row.OrderLineID, list);
+        }
+        return map;
+    }
+    /**
+     * The credit side of every charge allocated to this line, grouped by charge type (D71).
+     *
+     * Read from `OrderChargeAllocation`, which exists by the time booking runs because charges are
+     * written with the lines. Each charge type resolves its own GL account, so shipping revenue and
+     * a tax liability land in different places without this factory needing to know which is which.
+     *
+     * An unresolvable account is a HARD FAILURE, per the plan: a charge with nowhere to go must not
+     * book, because the entry would balance only by omitting it and the customer would be billed for
+     * something the ledger never recorded.
+     */
+    async chargeCreditsFor(line, companyID, asOf) {
+        const total = money(Math.abs(line.LineTax ?? 0)) + money(Math.abs(line.ChargeAmount ?? 0));
+        if (total === 0)
+            return [];
+        const rv = new RunView(this._provider);
+        const res = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Order Charge Allocations',
+            ExtraFilter: `OrderLineID = '${line.ID}'`,
+            ResultType: 'simple',
+            BypassCache: true,
+        }, this._contextUser);
+        const allocations = res?.Results ?? [];
+        if (!allocations.length)
+            return [];
+        // The allocation says WHICH CHARGE and HOW MUCH, but not what KIND of charge — the type
+        // lives on OrderCharge. RunView does not join, so the parent rows are read separately and
+        // matched in memory.
+        const chargeRes = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Order Charges',
+            ExtraFilter: `ID IN (${[...new Set(allocations.map((a) => `'${a.OrderChargeID}'`))].join(',')})`,
+            ResultType: 'simple',
+            BypassCache: true,
+        }, this._contextUser);
+        const chargeByID = new Map((chargeRes?.Results ?? []).map((c) => [String(c.ID).toLowerCase(), c]));
+        // One credit per charge TYPE, not per allocation row — several tax layers on one line each
+        // have their own account, but two shipping charges share theirs.
+        const byType = new Map();
+        for (const a of allocations) {
+            const parent = chargeByID.get(String(a.OrderChargeID).toLowerCase());
+            if (!parent?.ChargeTypeID)
+                continue;
+            const cur = byType.get(parent.ChargeTypeID) ?? { Amount: 0, Label: parent.ChargeType ?? 'Charge' };
+            cur.Amount = money(cur.Amount + Math.abs(Number(a.Amount ?? 0)));
+            byType.set(parent.ChargeTypeID, cur);
+        }
+        const out = [];
+        for (const [chargeTypeID, info] of byType) {
+            if (info.Amount === 0)
+                continue;
+            const account = await this._resolver.ResolveForRecord(GL_ROLE.Sales, this._chargeTypeEntityID, chargeTypeID, companyID, asOf);
+            if (!account) {
+                throw new GLAccountResolutionError(GL_ROLE.Sales, line.ProductID, `Charge '${info.Label}' has no GL account linked for company ${companyID}. Link one to the ` +
+                    `charge type before booking — a charge with nowhere to go would be billed to the customer ` +
+                    `and never recorded in the ledger.`);
+            }
+            out.push({ GLAccountID: account, Amount: info.Amount, Label: info.Label });
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=OrderJournalEntryFactory.js.map

package/dist/OrderJournalEntryFactory.js.map

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

package/dist/OrderLineEntityServer.d.ts

@@ -0,0 +1,90 @@
+/**
+ * OrderLineEntityServer — line-level invariants and engine-materialized totals.
+ *
+ * Two jobs, both of which must happen server-side because the journal entry is derived from them:
+ *
+ *   1. STAMP THE COMPANY (plan D6). `OrderLine.CompanyID` is a denormalized copy of the
+ *      product's company, captured at save time so the line records who owned the product at
+ *      transaction time even if product ownership later moves. It is derived, never authored —
+ *      whatever a caller passes is overwritten.
+ *
+ *   2. COMPUTE THE TOTALS. `LineTotalNet` / `LineTotalGross` are engine-materialized and never
+ *      user-entered:
+ *          LineTotalNet   = (Quantity × UnitPrice × (1 − DiscountPct)) − DiscountAmount
+ *          LineTotalGross = LineTotalNet + LineTax + ChargeAmount
+ *
+ *      DiscountPct and DiscountAmount are both applied, in that order, because they mean different
+ *      things: a percentage is a negotiated concession on the line, an amount is an allocated share
+ *      of a promotion (D70). The net is clamped TOWARD ZERO, in whichever direction the line runs —
+ *      a discount larger than the line is a configuration mistake and must not turn a sale into a
+ *      credit, but a reversal line (D16) is legitimately negative and must not be flattened to zero.
+ *      The rule lives in `PricingBehavior.NetAfterDiscount`, shared with the charge/tax base, because
+ *      it was written twice and both copies had the same bug.
+ *      The journal entry is built from the same arithmetic, so a client-supplied total can never
+ *      disagree with what was booked.
+ *
+ * The DB trigger (51003) freezes these columns once the parent order is Confirmed, so this runs
+ * meaningfully only while the order is still open.
+ *
+ * CONNECTS TO:
+ *   FACTORY: OrderJournalEntryFactory (./OrderJournalEntryFactory.ts) — mirrors this arithmetic
+ */
+import { EntitySaveOptions, ValidationResult } from '@memberjunction/core';
+import { OrderLineEntity } from '@mj-biz-apps/orders-entities';
+export declare class OrderLineEntityServer extends OrderLineEntity {
+    /**
+     * The exact extended amount the price rule computed, when a rule priced this line.
+     *
+     * TRANSIENT — not a column, and deliberately so. It is the pricing pass handing
+     * this line the figure it already computed exactly, rather than the line
+     * re-deriving it from a unit rate that cannot always represent it (see
+     * {@link LineGross}). Persisting it would add a column whose only job is to
+     * restate `LineTotalNet` before discount, and a second stored number that can
+     * disagree with the first is the thing worth avoiding.
+     *
+     * Null means "no rule priced this" — a hand-typed unit price, where the unit
+     * rate genuinely IS the authority — and the classic quantity × price applies.
+     */
+    ResolvedExtendedAmount: number | null;
+    /**
+     * `BaseEntity` skips `ValidateAsync` unless a subclass opts in, so without this the checks
+     * below never run when a line is saved on its own. The order's own `ValidateAsync` loops over
+     * its lines and would have covered the confirm path — except that one was skipped for the same
+     * reason, so in practice nothing here was enforced anywhere. See the note on
+     * `OrderEntityServer.DefaultSkipAsyncValidation`.
+     */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+    /** Set by OrderEntityServer when saving lines as part of an order graph save/booking. */
+    BypassBookedCheck: boolean;
+    /**
+     * A new line saved on its own (not through the order graph) still has to
+     * refuse a booked parent. Header.Validate covers the graph path; this
+     * covers the standalone path.
+     */
+    private refuseNewLineOnBookedOrder;
+    /**
+     * Populate the fields this line DERIVES rather than accepts, so it is valid before anything
+     * validates it.
+     *
+     * Public because the ORDER now has to call it. `Lines` is a related-record collection, and
+     * MJ validates every companion from the PARENT's save — deliberately, so a cross-record
+     * invariant sees the whole graph before the first row lands. But that runs before any child's
+     * own `Save()`, and `CompanyID` is stamped here, inside this class's `Save()`. The result was
+     * that every confirm failed with `Lines[0].CompanyID: Company cannot be null` — a NOT NULL
+     * column the line derives from its product and no caller ever authors.
+     *
+     * Idempotent, so the ordinary path (`Save()` calling it directly) is unaffected, and a line
+     * that was prepared by its order and then saved individually simply re-derives the same values.
+     */
+    PrepareForSave(): Promise<void>;
+    Save(options?: EntitySaveOptions): Promise<boolean>;
+    private persistExtension;
+    private extensionHasLeafDirtyFields;
+    /** Derived from the product, always — plan D6. */
+    private stampCompanyFromProduct;
+    private computeTotals;
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export declare function LoadOrderLineEntityServer(): void;
+//# sourceMappingURL=OrderLineEntityServer.d.ts.map

package/dist/OrderLineEntityServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderLineEntityServer.d.ts","sourceRoot":"","sources":["../src/OrderLineEntityServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAEH,iBAAiB,EAMjB,gBAAgB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAyC,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWtG,qBACa,qBAAsB,SAAQ,eAAe;IACtD;;;;;;;;;;;;OAYG;IACI,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEpD;;;;;;OAMG;IACH,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAuBhE,yFAAyF;IAClF,iBAAiB,UAAS;IAEjC;;;;OAIG;YACW,0BAA0B;IA2BxC;;;;;;;;;;;;;OAaG;IACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;YAW3D,gBAAgB;IAwC9B,OAAO,CAAC,2BAA2B;IAKnC,kDAAkD;YACpC,uBAAuB;IAoBrC,OAAO,CAAC,aAAa;CAkExB;AAED,0FAA0F;AAC1F,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}