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

package/dist/OrderLineEntityServer.js

@@ -0,0 +1,260 @@
+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;
+};
+/**
+ * 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 { BaseEntity, RunView, ValidationErrorInfo, ValidationErrorType, } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { IsBooked, LineGross, NetAfterDiscount, OrderLineEntity } from '@mj-biz-apps/orders-entities';
+import { ORDER_HEADER_ENTITY } from './entity-names.js';
+import { RequireUUID } from './sql-guards.js';
+const ORDER_LINE_ENTITY = 'MJ_BizApps_Orders: Order Lines';
+const PRODUCT_ENTITY = 'MJ_BizApps_Orders: Products';
+function money(value) {
+    return Math.round((value + Number.EPSILON) * 100) / 100;
+}
+let OrderLineEntityServer = class OrderLineEntityServer extends OrderLineEntity {
+    constructor() {
+        super(...arguments);
+        /**
+         * 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.
+         */
+        this.ResolvedExtendedAmount = null;
+        /** Set by OrderEntityServer when saving lines as part of an order graph save/booking. */
+        this.BypassBookedCheck = false;
+    }
+    /**
+     * `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() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        // Quantity <> 0 is a DB CHECK; negative quantities are legal only as reversal slices
+        // (plan D16), which is a cross-field rule the database cannot express.
+        if (this.Quantity < 0 && !this.ReversesOrderLineID) {
+            result.Success = false;
+            result.Errors.push(new ValidationErrorInfo('Quantity', `A negative quantity is only valid on a reversal line. Set ReversesOrderLineID to the ` +
+                `line being reversed, or use a positive quantity.`, this.Quantity, ValidationErrorType.Failure));
+        }
+        await this.refuseNewLineOnBookedOrder(result);
+        return result;
+    }
+    /**
+     * 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.
+     */
+    async refuseNewLineOnBookedOrder(result) {
+        if (this.IsSaved || !this.OrderHeaderID || this.BypassBookedCheck)
+            return;
+        const rv = new RunView(this.ProviderToUse);
+        const lookup = await rv.RunView({
+            EntityName: ORDER_HEADER_ENTITY,
+            ExtraFilter: `ID='${RequireUUID(this.OrderHeaderID, 'OrderHeaderID')}'`,
+            Fields: ['ID', 'Status'],
+            ResultType: 'simple',
+        }, this.ContextCurrentUser);
+        const status = lookup?.Results?.[0]?.Status;
+        if (!status || !IsBooked(status))
+            return;
+        result.Success = false;
+        result.Errors.push(new ValidationErrorInfo('OrderHeaderID', `Order line cannot be added — the order is booked. Corrections to booked orders go through reversal orders.`, this.OrderHeaderID, ValidationErrorType.Failure));
+    }
+    /**
+     * 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.
+     */
+    async PrepareForSave() {
+        await this.stampCompanyFromProduct();
+        this.computeTotals();
+    }
+    async Save(options) {
+        await this.PrepareForSave();
+        const ok = await super.Save(options);
+        if (!ok) {
+            return false;
+        }
+        await this.persistExtension(options);
+        return true;
+    }
+    async persistExtension(options) {
+        if (!this.Extension.IsConfigured) {
+            return;
+        }
+        const ext = await this.Extension.EnsureEntity();
+        if (!ext) {
+            return;
+        }
+        if (this.ID && (!ext.Get('ID') || ext.Get('ID') !== this.ID)) {
+            ext.Set('ID', this.ID);
+        }
+        // If the extension is an IS-A child of this line, sync the saved parent state
+        // so the extension's inner save knows the parent row is already persisted in the database.
+        const parent = ext.ISAParent;
+        if (parent) {
+            await parent.LoadFromData(this.GetAll(), true);
+        }
+        // A persisted IS-A child with no leaf-owned dirt has nothing to write.
+        // Re-saving it re-enters BaseEntity's child-save path; after the parent
+        // row is already persisted, that path only re-hydrates from GetAll(),
+        // which includes parent virtuals the child does not own (e.g. OrderHeader).
+        if (parent && ext.IsSaved && !this.extensionHasLeafDirtyFields(ext)) {
+            return;
+        }
+        if (!ext.IsSaved || ext.Dirty) {
+            const saved = await ext.Save(options);
+            if (!saved) {
+                throw new Error(`Failed to save line extension '${this.Extension.EntityName}' for order line ${this.LineNumber}: ` +
+                    (ext.LatestResult?.CompleteMessage ?? 'unknown error'));
+            }
+        }
+    }
+    extensionHasLeafDirtyFields(ext) {
+        const parentNames = ext.EntityInfo.ParentEntityFieldNames;
+        return ext.Fields.some((f) => f.Dirty && !parentNames.has(f.Name));
+    }
+    /** Derived from the product, always — plan D6. */
+    async stampCompanyFromProduct() {
+        if (!this.ProductID)
+            return;
+        const rv = new RunView(this.ProviderToUse);
+        const result = await rv.RunView({
+            EntityName: PRODUCT_ENTITY,
+            ExtraFilter: `ID='${this.ProductID}'`,
+            Fields: ['ID', 'CompanyID'],
+            ResultType: 'simple',
+        }, this.ContextCurrentUser);
+        const product = result?.Results?.[0];
+        if (product?.CompanyID) {
+            this.CompanyID = product.CompanyID;
+        }
+    }
+    computeTotals() {
+        // ROUND THE DISCOUNT TO ITS COLUMN'S SCALE FIRST, and store the rounded value.
+        //
+        // `DiscountPct` is `DECIMAL(7,4)`. Computing with an unrounded rate and storing a rounded one
+        // makes the application and the database disagree about the same line: a third off 900 is
+        // 600.00 by full precision and 600.03 by the stored 0.3333.
+        //
+        // That disagreement does not surface until the line is UPDATED — which happens when
+        // `JournalEntryID` is stamped after booking. `computeTotals` runs again, now reading 0.3333
+        // back from the row, produces 600.03, and the immutability trigger correctly refuses to let
+        // booked money change. The confirm then fails with 'Failed to stamp JournalEntryID', which
+        // names neither the discount nor the rounding, and any DiscountPct with more than four
+        // decimal places is simply un-bookable.
+        //
+        // `savePendingLines` already does exactly this for `Quantity` and for exactly this reason;
+        // the discount never got the same treatment. Assigning the rounded value here means the two
+        // can never diverge again, whichever path set it.
+        // A BOOKED LINE'S MONEY IS FROZEN — so do not recompute it.
+        //
+        // Trigger 51003 already enforces this at the database, and that is precisely
+        // the problem: the line is saved a SECOND time to stamp JournalEntryID after
+        // booking, computeTotals runs again, and any figure it cannot reproduce from
+        // stored state alone comes out different. The trigger then correctly refuses
+        // the change and the whole confirm rolls back, reported as a stamping failure
+        // that names neither the total nor the cause.
+        //
+        // That is not hypothetical — it is how a flat-priced line failed: the exact
+        // extended amount is known while pricing is in flight, but the reloaded line
+        // has only quantity and a derived unit rate, which for a Flat rule cannot
+        // reproduce the total (3 × 33.33 = 99.99, not 100.00). Rather than make the
+        // arithmetic reproducible from a rate that provably cannot represent every
+        // total, respect the rule the trigger already states: once booked, these
+        // columns are history, not a derivation.
+        if (this.JournalEntryID)
+            return;
+        const pct = Math.round((this.DiscountPct ?? 0) * 1e4) / 1e4;
+        if (pct !== (this.DiscountPct ?? 0))
+            this.DiscountPct = pct;
+        // A ROLLUP PARENT CONTRIBUTES NOTHING (D45).
+        //
+        // An expanded bundle's parent line is customer-facing: it keeps its UnitPrice so an invoice
+        // can print "Gold Package — 100", but the money lives on the children, which carry the
+        // allocated shares. Letting the parent compute a line total as well would DOUBLE the order —
+        // and do it invisibly, because the parent's own arithmetic is perfectly correct and every
+        // child's is too. The header rollup trigger sums LineTotalGross across all lines, so zero
+        // here is what keeps it honest without the trigger needing to know bundles exist.
+        //
+        // Deliberately after the DiscountPct rounding above, so the stored rate stays consistent
+        // whether or not the line happens to be a parent.
+        if (this.IsRollupParent) {
+            this.LineTotalNet = 0;
+            this.LineTotalGross = 0;
+            return;
+        }
+        // `NetAfterDiscount` is shared with the charge/tax base in OrderEntityServer. It used to be
+        // computed independently in both places, and both clamped a reversal line to zero — see
+        // PricingBehavior for what that cost.
+        const net = NetAfterDiscount(LineGross(this.Quantity, this.UnitPrice, this.ResolvedExtendedAmount), pct, this.DiscountAmount ?? 0);
+        this.LineTotalNet = net;
+        this.LineTotalGross = money(net + (this.LineTax ?? 0) + (this.ChargeAmount ?? 0));
+    }
+};
+OrderLineEntityServer = __decorate([
+    RegisterClass(BaseEntity, ORDER_LINE_ENTITY)
+], OrderLineEntityServer);
+export { OrderLineEntityServer };
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadOrderLineEntityServer() {
+    // intentionally empty
+}
+//# sourceMappingURL=OrderLineEntityServer.js.map

package/dist/OrderLineEntityServer.js.map

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

package/dist/OrdersSettings.d.ts

@@ -0,0 +1,36 @@
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/** Setting keys, in one place so a typo is a compile error rather than a silent default. */
+export declare const ORDERS_SETTING: {
+    /**
+     * Whether confirming an order stamps the ship-to/bill-to organization from the named person's
+     * affiliation when the organization was left blank (D64).
+     */
+    readonly AutoPopulateOrganizationFromPerson: "AutoPopulateOrganizationFromPerson";
+    /**
+     * Comma-separated `RelationshipType` NAMES that count as an organizational affiliation for the
+     * rule above. Names rather than IDs because `RelationshipType` is a seeded lookup in
+     * bizapps-common — extensible data, so a deployment can add its own type and list it here
+     * without a schema change on either side.
+     */
+    readonly OrganizationAffiliationRelationshipTypes: "OrganizationAffiliationRelationshipTypes";
+};
+export declare class OrdersSettings {
+    private static _localOverrides;
+    /**
+     * Load the settings cache. Idempotent and cheap after the first call; the entity servers invoke
+     * it on the booking path so callers rarely need to.
+     */
+    static Load(provider: IMetadataProvider, user: UserInfo): Promise<void>;
+    /** Override a setting value for tests. Pass undefined to remove the override. */
+    static SetOverride(key: string, value: string | undefined): void;
+    /** Clear all test overrides. */
+    static ClearOverrides(): void;
+    /** The `__mj_BizAppsOrders` Application ID, or undefined when the app row is absent. */
+    private static applicationID;
+    private static raw;
+    /** Stamp the organization from the person's affiliation when it was left blank (D64). */
+    static get AutoPopulateOrganizationFromPerson(): boolean;
+    /** `RelationshipType` names that count as an organizational affiliation. */
+    static get OrganizationAffiliationRelationshipTypes(): string[];
+}
+//# sourceMappingURL=OrdersSettings.d.ts.map

package/dist/OrdersSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrdersSettings.d.ts","sourceRoot":"","sources":["../src/OrdersSettings.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,iBAAiB,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAM7E,4FAA4F;AAC5F,eAAO,MAAM,cAAc;IACvB;;;OAGG;;IAEH;;;;;OAKG;;CAEG,CAAC;AAiDX,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAA6B;IAE3D;;;OAGG;WACiB,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpF,iFAAiF;WACnE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAqBvE,gCAAgC;WAClB,cAAc,IAAI,IAAI;IAKpC,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,aAAa;IAK5B,OAAO,CAAC,MAAM,CAAC,GAAG;IAYlB,yFAAyF;IACzF,WAAkB,kCAAkC,IAAI,OAAO,CAK9D;IAED,4EAA4E;IAC5E,WAAkB,wCAAwC,IAAI,MAAM,EAAE,CAKrE;CAEJ"}

package/dist/OrdersSettings.js

@@ -0,0 +1,147 @@
+/**
+ * Typed access to this app's settings (plan D63).
+ *
+ * MJ already owns the mechanism: `__mj.ApplicationSetting` rows scoped to an `Application`, cached
+ * and auto-refreshed by `ApplicationSettingEngine` in `@memberjunction/core-entities`. This is NOT a
+ * second engine — it is a thin typed façade over that one, so callers read
+ * `OrdersSettings.AutoPopulateOrganizationFromPerson` (a real boolean, default applied) instead of
+ * parsing `"true"` at each call site and re-deciding the default every time.
+ *
+ * WHY A FAÇADE AT ALL
+ * `GetSetting` returns `string | undefined`. Every consumer would otherwise repeat the same three
+ * decisions — what the key is called, what the default is, and how to coerce — and they would drift.
+ * Naming the defaults in one place is what makes "the setting is off" and "the setting was never
+ * configured" behave identically on purpose rather than by accident.
+ *
+ * The engine is a BaseEngine, so `AutoRefresh` (default true) propagates a change made through the
+ * entity API without a restart. Callers must still have called `Config()` once — the entity servers
+ * do that on the booking path.
+ *
+ * CONNECTS TO:
+ *   ENGINE: ApplicationSettingEngine (@memberjunction/core-entities)
+ *   TABLE:  __mj.ApplicationSetting, scoped to the '__mj_BizAppsOrders' Application row
+ */
+import { ApplicationSettingEngine } from '@memberjunction/core-entities';
+import { Metadata } from '@memberjunction/core';
+/** The `MJ: Applications` row this app's settings hang off. */
+const ORDERS_APPLICATION_NAME = '__mj_BizAppsOrders';
+/** Setting keys, in one place so a typo is a compile error rather than a silent default. */
+export const ORDERS_SETTING = {
+    /**
+     * Whether confirming an order stamps the ship-to/bill-to organization from the named person's
+     * affiliation when the organization was left blank (D64).
+     */
+    AutoPopulateOrganizationFromPerson: 'AutoPopulateOrganizationFromPerson',
+    /**
+     * Comma-separated `RelationshipType` NAMES that count as an organizational affiliation for the
+     * rule above. Names rather than IDs because `RelationshipType` is a seeded lookup in
+     * bizapps-common — extensible data, so a deployment can add its own type and list it here
+     * without a schema change on either side.
+     */
+    OrganizationAffiliationRelationshipTypes: 'OrganizationAffiliationRelationshipTypes',
+};
+/**
+ * Defaults, applied when a setting is absent.
+ *
+ * `Employee` only, deliberately. The seeded types include `Vendor`, `Customer` and `Friend`, and a
+ * person being a VENDOR to an organization must not make that organization their bill-to. Widening
+ * this is a data change, not a release — which is the whole point of it being a setting.
+ */
+const DEFAULTS = {
+    AutoPopulateOrganizationFromPerson: true,
+    OrganizationAffiliationRelationshipTypes: ['Employee'],
+};
+/** Anything other than an explicit falsey string is true — an unparseable value should not disable a feature silently. */
+function asBoolean(raw, fallback) {
+    if (raw == null)
+        return fallback;
+    const v = raw.trim().toLowerCase();
+    if (['false', '0', 'no', 'off'].includes(v))
+        return false;
+    if (['true', '1', 'yes', 'on'].includes(v))
+        return true;
+    return fallback;
+}
+function asList(raw, fallback) {
+    if (raw == null)
+        return [...fallback];
+    const parts = raw
+        .split(',')
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+    // An explicitly EMPTY list means "no type qualifies", which switches the feature off just as
+    // surely as the boolean does. That is a legitimate way to configure it, so it is honoured
+    // rather than being treated as "unset" and silently replaced by the default.
+    return parts;
+}
+const OVERRIDES_STORE_KEY = '__orders_settings_overrides__';
+function getOverridesMap() {
+    const g = globalThis;
+    if (!g[OVERRIDES_STORE_KEY]) {
+        g[OVERRIDES_STORE_KEY] = new Map();
+    }
+    return g[OVERRIDES_STORE_KEY];
+}
+export class OrdersSettings {
+    static { this._localOverrides = new Map(); }
+    /**
+     * Load the settings cache. Idempotent and cheap after the first call; the entity servers invoke
+     * it on the booking path so callers rarely need to.
+     */
+    static async Load(provider, user) {
+        await ApplicationSettingEngine.Instance.Config(false, user, provider);
+    }
+    /** Override a setting value for tests. Pass undefined to remove the override. */
+    static SetOverride(key, value) {
+        const map = getOverridesMap();
+        if (value === undefined) {
+            map.delete(key);
+            this._localOverrides.delete(key);
+        }
+        else {
+            map.set(key, value);
+            this._localOverrides.set(key, value);
+        }
+        try {
+            const engine = ApplicationSettingEngine.Instance;
+            for (const s of engine.ApplicationSettings) {
+                if (s.Name === key) {
+                    s.Value = value ?? '';
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    /** Clear all test overrides. */
+    static ClearOverrides() {
+        this._localOverrides.clear();
+        getOverridesMap().clear();
+    }
+    /** The `__mj_BizAppsOrders` Application ID, or undefined when the app row is absent. */
+    static applicationID() {
+        const apps = new Metadata().Applications;
+        return apps?.find((a) => a.Name === ORDERS_APPLICATION_NAME || a.Name === 'MJ_BizApps_Orders' || a.Name === 'Orders')?.ID;
+    }
+    static raw(key) {
+        if (this._localOverrides.has(key)) {
+            return this._localOverrides.get(key);
+        }
+        const map = getOverridesMap();
+        if (map.has(key)) {
+            return map.get(key);
+        }
+        const appID = this.applicationID();
+        return ApplicationSettingEngine.Instance.GetSetting(key, appID);
+    }
+    /** Stamp the organization from the person's affiliation when it was left blank (D64). */
+    static get AutoPopulateOrganizationFromPerson() {
+        return asBoolean(this.raw(ORDERS_SETTING.AutoPopulateOrganizationFromPerson), DEFAULTS.AutoPopulateOrganizationFromPerson);
+    }
+    /** `RelationshipType` names that count as an organizational affiliation. */
+    static get OrganizationAffiliationRelationshipTypes() {
+        return asList(this.raw(ORDERS_SETTING.OrganizationAffiliationRelationshipTypes), DEFAULTS.OrganizationAffiliationRelationshipTypes);
+    }
+}
+//# sourceMappingURL=OrdersSettings.js.map

package/dist/OrdersSettings.js.map

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

package/dist/PaymentAllocationFactory.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Intercompany balancing on the payment side — the other half of D13.
+ *
+ * THE BUG THIS FIXES
+ * Capture booked `Dr Cash / Cr AR` against the RECEIVING company and nothing else. When company A
+ * collected cash settling a line owned by company B, A's receivable was credited for money A was
+ * never owed, and B's receivable stayed open forever. Both books misstated, nothing reconciling
+ * them, and no assertion anywhere would fail — the entry balanced perfectly. The `payment-ledger`
+ * suite missed it entirely because every check used a single-company order.
+ *
+ * THE SHAPE (plans/archive/intercompany-balancing.md §2)
+ * ONE JOURNAL ENTRY PER (PAYMENT LINE × COMPANY). This is the provenance rule booking already
+ * uses — an OrderLine produces a JE that points back at the line — extended to the payment side.
+ *
+ *   Receiving company:  Dr Cash            the whole payment-line amount
+ *                       Cr AR              its OWN share (omitted when it owns no line)
+ *                       Cr Due To <other>  one line per other company, never netted
+ *
+ *   Each other company: Dr Due From <receiving>   its share
+ *                       Cr AR                     its share
+ *
+ * For a single-company order this collapses to exactly the previous behaviour — one entry,
+ * `Dr Cash / Cr AR`. Multi-company is the general case, not a special one.
+ *
+ * WHY EVERY ENTRY IS SINGLE-COMPANY: accounting derives an entry's company from its ACCOUNTS
+ * (their CH-2) and D6 hard-blocks cross-company mapping, so an entry spanning companies could not
+ * be booked at all. The shape is forced, not chosen.
+ *
+ * WHY THE DUE-TO CREDITS STAY SEPARATE: `Cr Due To B 200` and `Cr Due To C 300` are two lines, not
+ * one netted `Cr Due To 500`. Aggregation is recoverable downstream; the derivation is not.
+ *
+ * A MISSING PAIR IS FATAL. There is no fallback account, because a guessed intercompany account
+ * still balances — the misposting would be invisible until two entities' books disagree.
+ *
+ * CONNECTS TO:
+ *   LOOKUP:   AccountingEngineBase.ResolveIntercompanyAccounts (BA-D26, bizapps-accounting)
+ *   RESOLVER: GLAccountResolver (./GLAccountResolver.ts)
+ *   CALLER:   PaymentLineEntityServer (./PaymentLineEntityServer.ts)
+ *   DOC:      plans/archive/intercompany-balancing.md
+ */
+import { type GLAccountResolver } from './GLAccountResolver.js';
+import type { PaymentJEDraft } from './PaymentJournalEntryFactory.js';
+/** One order line's contribution, as far as allocation is concerned. */
+export interface OrderLineShare {
+    OrderLineID: string;
+    /** The company that OWNS the line — the product's company (D6), already stamped on the line. */
+    CompanyID: string;
+    /** The line's gross amount. Used as the pro-rating weight. */
+    Amount: number;
+}
+/** What one company is owed out of a single payment line. */
+export interface CompanyShare {
+    CompanyID: string;
+    Amount: number;
+}
+/** The intercompany account pair for an ordered company pair, or null when none is configured. */
+export interface IntercompanyPair {
+    DueToGLAccountID: string;
+    DueFromGLAccountID: string;
+}
+/**
+ * Looks up the pair for (source collected on behalf of target), as of a date.
+ * Injected rather than imported so the allocation math is unit-testable without an engine.
+ */
+export type IntercompanyLookup = (sourceCompanyID: string, targetCompanyID: string, asOf: Date) => IntercompanyPair | null;
+export interface PaymentLineAllocationContext {
+    PaymentLineID: string;
+    PaymentNumber: string;
+    OrderNumber: string;
+    /** What this payment line applies to the order. Always positive; `IsReversal` sets direction. */
+    Amount: number;
+    /** Where the cash landed. */
+    ReceivingCompanyID: string;
+    /** Every line on the order this payment line settles. */
+    OrderLines: OrderLineShare[];
+    /**
+     * Set when the payment line targets ONE order line (`PaymentLine.OrderLineID`). Then the whole
+     * amount belongs to that line's company and no pro-rating happens — the simpler case, not the
+     * harder one, because one line means one company means no intercompany legs at all.
+     */
+    TargetOrderLineID?: string | null;
+    PaymentDate: Date;
+    /** True when un-applying (a refund or a negative allocation) — every entry mirrors. */
+    IsReversal: boolean;
+}
+export interface PaymentAllocationResult {
+    /** One draft per company. The receiving company's is always first. */
+    Drafts: PaymentJEDraft[];
+    /** The per-company split that produced them — surfaced for assertions and diagnostics. */
+    Shares: CompanyShare[];
+}
+export declare class IntercompanyPairMissingError extends Error {
+    readonly SourceCompanyID: string;
+    readonly TargetCompanyID: string;
+    constructor(SourceCompanyID: string, TargetCompanyID: string, message: string);
+}
+/**
+ * Split a payment-line amount across the companies owning the order's lines.
+ *
+ * Pure and exported for unit tests — this is where the money actually gets divided, and a rounding
+ * slip here would show up as an unbalanced entry or a cent stranded on the wrong company's books.
+ *
+ * Targeting one order line short-circuits the whole thing: the amount belongs to that line's
+ * company outright. Otherwise each company gets its proportional share of the order's total, and
+ * **the largest share absorbs the rounding residue** so the parts always sum to the whole.
+ */
+export declare function AllocateByCompany(amount: number, orderLines: OrderLineShare[], targetOrderLineID?: string | null): CompanyShare[];
+export declare class PaymentAllocationFactory {
+    private readonly _resolver;
+    private readonly _intercompany;
+    private readonly _paymentLineEntityID;
+    constructor(_resolver: GLAccountResolver, _intercompany: IntercompanyLookup, _paymentLineEntityID: string);
+    /**
+     * Build every journal entry a single payment line causes.
+     *
+     * The caller owns the transaction and the write; this computes only.
+     */
+    BuildAllocationDrafts(ctx: PaymentLineAllocationContext): Promise<PaymentAllocationResult>;
+    private toDraft;
+    /**
+     * Balance each entry before it leaves this class.
+     *
+     * Accounting validates too, but its rejection arrives as `MALFORMED_DRAFT` strings from inside
+     * a remote operation. Failing here names the payment, the order and the amounts.
+     */
+    private assertBalanced;
+}
+//# sourceMappingURL=PaymentAllocationFactory.d.ts.map

package/dist/PaymentAllocationFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentAllocationFactory.d.ts","sourceRoot":"","sources":["../src/PaymentAllocationFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,iCAAiC,CAAC;AAErF,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,kGAAkG;AAClG,MAAM,WAAW,gBAAgB;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC7B,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,IAAI,KACT,gBAAgB,GAAG,IAAI,CAAC;AAE7B,MAAM,WAAW,4BAA4B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,IAAI,CAAC;IAClB,uFAAuF;IACvF,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACpC,sEAAsE;IACtE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,0FAA0F;IAC1F,MAAM,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,qBAAa,4BAA6B,SAAQ,KAAK;aAE/B,eAAe,EAAE,MAAM;aACvB,eAAe,EAAE,MAAM;gBADvB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvC,OAAO,EAAE,MAAM;CAKtB;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,EAAE,EAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,GAClC,YAAY,EAAE,CAqDhB;AAED,qBAAa,wBAAwB;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAFpB,SAAS,EAAE,iBAAiB,EAC5B,aAAa,EAAE,kBAAkB,EACjC,oBAAoB,EAAE,MAAM;IAGjD;;;;OAIG;IACU,qBAAqB,CAAC,GAAG,EAAE,4BAA4B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAiGvG,OAAO,CAAC,OAAO;IAcf;;;;;OAKG;IACH,OAAO,CAAC,cAAc;CAUzB"}