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

package/dist/FulfillOrderLinesOperation.js.map

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

package/dist/FulfillmentBehavior.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Fulfilment decisions, with no database in sight.
+ *
+ * WHAT FULFILMENT IS HERE, AND WHAT IT IS NOT (D15). It is a LOGISTICS fact: the thing left the
+ * building. It is emphatically not an accounting event — no journal entry fires on
+ * Posted → Fulfilled. Revenue was settled at booking and released on its own schedule; whether the
+ * box has shipped changes none of it.
+ *
+ * That disconnection is deliberate and worth restating, because "revenue on delivery" is the
+ * intuition everyone brings. Coupling them would make a warehouse delay silently restate a closed
+ * period.
+ *
+ * THE PART THAT NEEDS CARE. An order auto-advances to Fulfilled when NO line requires fulfilment —
+ * a subscription, a download, a donation. If even one line does, the order waits for a person. The
+ * hazard is the middle case: an order where some lines are fulfillable and some are not. Counting
+ * "all lines fulfilled" would hold such an order open forever, because the non-fulfillable lines
+ * never flip. Only the lines that CAN be fulfilled are allowed to hold it.
+ *
+ * CONNECTS TO:
+ *   CODE: FulfillmentEngine · FulfillOrderLinesOperation · GetFulfillmentQueueOperation
+ *   DOC:  plans/archive/bizapps-orders-master.md D15
+ */
+/** The per-line fulfilment states (schema: CK_OrderLine_FulfillmentStatus). */
+export type FulfillmentStatus = 'Pending' | 'Fulfilled' | 'Returned';
+/** What a line has to say for itself. */
+export interface FulfillableLine {
+    ID: string;
+    /** From the line's product TYPE. False for a subscription, a download, a donation. */
+    RequiresFulfillment: boolean;
+    /** Null when the type does not require fulfilment — the column is only meaningful when it does. */
+    FulfillmentStatus: FulfillmentStatus | null;
+    /** A reversal line is a return, not something to ship. */
+    ReversesOrderLineID: string | null;
+    /** A rollup parent is a display row; its children are the real goods (D45). */
+    IsRollupParent: boolean;
+}
+/**
+ * Does this line hold the order open?
+ *
+ * Four exclusions, each for its own reason:
+ *   · the product type does not require fulfilment — nothing to ship;
+ *   · it is a REVERSAL — goods coming back, tracked by the origin line's status, not this one;
+ *   · it is a ROLLUP PARENT — a bundle's display row, whose children carry the actual goods;
+ *   · it is already Fulfilled or Returned.
+ */
+export declare function IsAwaitingFulfillment(line: FulfillableLine): boolean;
+/** Every line still holding the order open. */
+export declare function AwaitingFulfillment(lines: FulfillableLine[]): FulfillableLine[];
+/**
+ * Should the order advance to Fulfilled?
+ *
+ * TRUE when nothing is awaiting fulfilment — which covers both the auto-advance case (no line ever
+ * required it) and the ordinary case (the last fulfillable line was just flipped).
+ *
+ * Deliberately NOT "every line is Fulfilled". On a mixed order the subscription line never flips,
+ * so that test would hold it open forever while the warehouse insists it shipped everything.
+ */
+export declare function ShouldAdvanceToFulfilled(lines: FulfillableLine[]): boolean;
+/**
+ * Would this order auto-advance without anyone touching it (D15)?
+ *
+ * Distinct from `ShouldAdvanceToFulfilled` in INTENT rather than result: this asks whether the order
+ * needs a fulfiller AT ALL, which is what decides whether it appears in the queue. An order that
+ * auto-advances should never show up there, and an order that has simply been fully worked should.
+ */
+export declare function AutoAdvances(lines: FulfillableLine[]): boolean;
+export type FlipRefusal = 'LineNotFound' | 'DoesNotRequireFulfillment' | 'AlreadyFulfilled' | 'IsReversal' | 'IsRollupParent' | 'OrderNotPosted';
+/**
+ * May this line be flipped to Fulfilled right now?
+ *
+ * Returns null when it may, or the reason when it may not. A refusal is a normal outcome — a
+ * fulfiller double-clicking a already-shipped line should be told so, not have it counted twice.
+ */
+export declare function RefuseFlip(line: FulfillableLine | null, orderStatus: string): FlipRefusal | null;
+/** Human wording for a refusal, so the caller does not have to invent one. */
+export declare function ExplainRefusal(reason: FlipRefusal, lineID: string): string;
+/** One order's position in the fulfilment queue. */
+export interface QueueGrouping {
+    OrderHeaderID: string;
+    AwaitingLineIDs: string[];
+    /** Every fulfillable line, whether or not still pending — the denominator for "3 of 5". */
+    FulfillableCount: number;
+}
+/**
+ * Group pending lines by order, in the shape a queue screen wants.
+ *
+ * Orders with nothing awaiting are omitted rather than listed as complete: a queue is work to do,
+ * and a screen full of finished orders is how a real backlog gets missed.
+ */
+export declare function GroupForQueue(lines: Array<FulfillableLine & {
+    OrderHeaderID: string;
+}>): QueueGrouping[];
+/**
+ * The initial `FulfillmentStatus` a line should be created with.
+ *
+ * NULL — not 'Pending' — when the type requires no fulfilment. The column's own documentation says
+ * null means "does not apply", and writing 'Pending' on a subscription would put it in the queue
+ * forever waiting for a shipment that does not exist.
+ */
+export declare function InitialFulfillmentStatus(requiresFulfillment: boolean): FulfillmentStatus | null;
+//# sourceMappingURL=FulfillmentBehavior.d.ts.map

package/dist/FulfillmentBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FulfillmentBehavior.d.ts","sourceRoot":"","sources":["../src/FulfillmentBehavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAErE,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,sFAAsF;IACtF,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mGAAmG;IACnG,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,0DAA0D;IAC1D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAKpE;AAED,+CAA+C;AAC/C,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAE/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAE9D;AAED,MAAM,MAAM,WAAW,GACjB,cAAc,GACd,2BAA2B,GAC3B,kBAAkB,GAClB,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,CAAC;AAKvB;;;;;GAKG;AACH,wBAAgB,UAAU,CACtB,IAAI,EAAE,eAAe,GAAG,IAAI,EAC5B,WAAW,EAAE,MAAM,GACpB,WAAW,GAAG,IAAI,CASpB;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA2B1E;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,KAAK,CAAC,eAAe,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,aAAa,EAAE,CAiBjB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,mBAAmB,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAE/F"}

package/dist/FulfillmentBehavior.js

@@ -0,0 +1,145 @@
+/**
+ * Fulfilment decisions, with no database in sight.
+ *
+ * WHAT FULFILMENT IS HERE, AND WHAT IT IS NOT (D15). It is a LOGISTICS fact: the thing left the
+ * building. It is emphatically not an accounting event — no journal entry fires on
+ * Posted → Fulfilled. Revenue was settled at booking and released on its own schedule; whether the
+ * box has shipped changes none of it.
+ *
+ * That disconnection is deliberate and worth restating, because "revenue on delivery" is the
+ * intuition everyone brings. Coupling them would make a warehouse delay silently restate a closed
+ * period.
+ *
+ * THE PART THAT NEEDS CARE. An order auto-advances to Fulfilled when NO line requires fulfilment —
+ * a subscription, a download, a donation. If even one line does, the order waits for a person. The
+ * hazard is the middle case: an order where some lines are fulfillable and some are not. Counting
+ * "all lines fulfilled" would hold such an order open forever, because the non-fulfillable lines
+ * never flip. Only the lines that CAN be fulfilled are allowed to hold it.
+ *
+ * CONNECTS TO:
+ *   CODE: FulfillmentEngine · FulfillOrderLinesOperation · GetFulfillmentQueueOperation
+ *   DOC:  plans/archive/bizapps-orders-master.md D15
+ */
+/**
+ * Does this line hold the order open?
+ *
+ * Four exclusions, each for its own reason:
+ *   · the product type does not require fulfilment — nothing to ship;
+ *   · it is a REVERSAL — goods coming back, tracked by the origin line's status, not this one;
+ *   · it is a ROLLUP PARENT — a bundle's display row, whose children carry the actual goods;
+ *   · it is already Fulfilled or Returned.
+ */
+export function IsAwaitingFulfillment(line) {
+    if (!line.RequiresFulfillment)
+        return false;
+    if (line.ReversesOrderLineID)
+        return false;
+    if (line.IsRollupParent)
+        return false;
+    return (line.FulfillmentStatus ?? 'Pending') === 'Pending';
+}
+/** Every line still holding the order open. */
+export function AwaitingFulfillment(lines) {
+    return lines.filter(IsAwaitingFulfillment);
+}
+/**
+ * Should the order advance to Fulfilled?
+ *
+ * TRUE when nothing is awaiting fulfilment — which covers both the auto-advance case (no line ever
+ * required it) and the ordinary case (the last fulfillable line was just flipped).
+ *
+ * Deliberately NOT "every line is Fulfilled". On a mixed order the subscription line never flips,
+ * so that test would hold it open forever while the warehouse insists it shipped everything.
+ */
+export function ShouldAdvanceToFulfilled(lines) {
+    return AwaitingFulfillment(lines).length === 0;
+}
+/**
+ * Would this order auto-advance without anyone touching it (D15)?
+ *
+ * Distinct from `ShouldAdvanceToFulfilled` in INTENT rather than result: this asks whether the order
+ * needs a fulfiller AT ALL, which is what decides whether it appears in the queue. An order that
+ * auto-advances should never show up there, and an order that has simply been fully worked should.
+ */
+export function AutoAdvances(lines) {
+    return !lines.some((l) => l.RequiresFulfillment && !l.ReversesOrderLineID && !l.IsRollupParent);
+}
+/** The statuses from which a line may be flipped to Fulfilled. */
+const ORDER_STATES_ALLOWING_FULFILLMENT = new Set(['Confirmed']);
+/**
+ * May this line be flipped to Fulfilled right now?
+ *
+ * Returns null when it may, or the reason when it may not. A refusal is a normal outcome — a
+ * fulfiller double-clicking a already-shipped line should be told so, not have it counted twice.
+ */
+export function RefuseFlip(line, orderStatus) {
+    if (!line)
+        return 'LineNotFound';
+    // Before Confirmed nothing is owed, so nothing can ship. Voided orders are out entirely.
+    if (!ORDER_STATES_ALLOWING_FULFILLMENT.has(orderStatus))
+        return 'OrderNotPosted';
+    if (line.IsRollupParent)
+        return 'IsRollupParent';
+    if (line.ReversesOrderLineID)
+        return 'IsReversal';
+    if (!line.RequiresFulfillment)
+        return 'DoesNotRequireFulfillment';
+    if ((line.FulfillmentStatus ?? 'Pending') !== 'Pending')
+        return 'AlreadyFulfilled';
+    return null;
+}
+/** Human wording for a refusal, so the caller does not have to invent one. */
+export function ExplainRefusal(reason, lineID) {
+    switch (reason) {
+        case 'LineNotFound':
+            return `Order line ${lineID} does not exist.`;
+        case 'OrderNotPosted':
+            return (`Order line ${lineID} cannot be fulfilled because its order is not Confirmed. ` +
+                `Nothing is owed until an order is confirmed, so nothing can ship.`);
+        case 'DoesNotRequireFulfillment':
+            return (`Order line ${lineID} is for a product type that requires no fulfilment — a subscription, ` +
+                `a download, a donation. There is nothing to ship, so there is nothing to mark.`);
+        case 'IsReversal':
+            return (`Order line ${lineID} is a reversal. Goods coming BACK are tracked on the line they ` +
+                `reverse, not by fulfilling the credit.`);
+        case 'IsRollupParent':
+            return (`Order line ${lineID} is a bundle's parent row, which carries no goods of its own. ` +
+                `Fulfil its component lines instead.`);
+        case 'AlreadyFulfilled':
+            return `Order line ${lineID} has already been fulfilled or returned.`;
+    }
+}
+/**
+ * Group pending lines by order, in the shape a queue screen wants.
+ *
+ * Orders with nothing awaiting are omitted rather than listed as complete: a queue is work to do,
+ * and a screen full of finished orders is how a real backlog gets missed.
+ */
+export function GroupForQueue(lines) {
+    const byOrder = new Map();
+    for (const line of lines) {
+        const fulfillable = line.RequiresFulfillment && !line.ReversesOrderLineID && !line.IsRollupParent;
+        if (!fulfillable)
+            continue;
+        let group = byOrder.get(line.OrderHeaderID);
+        if (!group) {
+            group = { OrderHeaderID: line.OrderHeaderID, AwaitingLineIDs: [], FulfillableCount: 0 };
+            byOrder.set(line.OrderHeaderID, group);
+        }
+        group.FulfillableCount++;
+        if (IsAwaitingFulfillment(line))
+            group.AwaitingLineIDs.push(line.ID);
+    }
+    return [...byOrder.values()].filter((g) => g.AwaitingLineIDs.length > 0);
+}
+/**
+ * The initial `FulfillmentStatus` a line should be created with.
+ *
+ * NULL — not 'Pending' — when the type requires no fulfilment. The column's own documentation says
+ * null means "does not apply", and writing 'Pending' on a subscription would put it in the queue
+ * forever waiting for a shipment that does not exist.
+ */
+export function InitialFulfillmentStatus(requiresFulfillment) {
+    return requiresFulfillment ? 'Pending' : null;
+}
+//# sourceMappingURL=FulfillmentBehavior.js.map

package/dist/FulfillmentBehavior.js.map

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

package/dist/GLAccountResolver.d.ts

@@ -0,0 +1,123 @@
+/**
+ * GLAccountResolver — turns a (product, role) pair into a concrete GL account UUID.
+ *
+ * Accounting's `CreateJournalEntries` contract takes `GLAccountID`, never a role name, so the
+ * role→account walk is the CALLER's job (plan D5). Accounting supplies only the per-record link
+ * primitive — `AccountingEngineBase.ResolveLinkedAccount(entityId, recordId, role, asOfDate)` —
+ * and this class implements the precedence over it:
+ *
+ *     Product  →  its ProductCategory  →  that category's ancestors
+ *              →  its ProductType  →  the line's Company
+ *
+ * Company is the last resort (the accounting-org default). Product Type sits above
+ * the company default so a type can name Sales once and every product of that type
+ * inherits it, while a category or product can still override.
+ *
+ * Most specific wins; the first link found at any level ends the walk. Nothing resolves → we
+ * FAIL LOUDLY (plan D5: "fail loudly" — never silently book to a default account).
+ *
+ * COMPANY INVARIANT (plan D6): the resolved account MUST belong to the order line's company.
+ * Accounting derives a JE's company from `GLAccount.CompanyID` and takes no CompanyID in its
+ * contract (their CH-2), so a mis-resolved account would silently book revenue to the wrong
+ * legal entity with nothing downstream to catch it. This class is therefore the ONLY place that
+ * invariant can be enforced, and it hard-blocks — cross-company mapping is refused entirely.
+ *
+ * CONNECTS TO:
+ *   PRIMITIVE: AccountingEngineBase.ResolveLinkedAccount (@mj-biz-apps/accounting-engine-base)
+ *   CALLER:    OrderJournalEntryFactory (./OrderJournalEntryFactory.ts)
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/** GL account roles this app books against (seeded by accounting's metadata). */
+export declare const GL_ROLE: {
+    readonly AccountsReceivable: "Accounts Receivable";
+    readonly Sales: "Sales";
+    readonly SalesDiscounts: "Sales Discounts";
+    readonly DeferredRevenue: "Deferred Revenue";
+    readonly SalesReturnsAndAllowances: "Sales Returns and Allowances";
+    /** Where captured cash lands. Company-level only — a payment has no product to walk from. */
+    readonly Cash: "Cash";
+    /**
+     * The provider's cut on a capture (D18). NOT seeded by accounting's starter roles, so callers
+     * must tolerate it failing to resolve — see PaymentJournalEntryFactory, which books the gross
+     * to Cash and reports the shortfall rather than silently misstating the bank line.
+     */
+    readonly ProcessingFee: "Processing Fee";
+    /**
+     * What the company OWES on an unredeemed gift card (D44).
+     *
+     * Selling a gift card earns nothing — money has come in and goods are owed — so the credit leg
+     * is a liability, not revenue. Recognising at issue and again at redemption is the classic
+     * gift-card double-count, and it is invisible in the ledger because both entries balance.
+     *
+     * NOT seeded by accounting's starter roles, so callers must tolerate it failing to resolve. The
+     * fallback is Deferred Revenue, which is the same SHAPE of obligation and keeps the entry
+     * correct and balanced — just coarser than a dedicated card liability. See
+     * OrderJournalEntryFactory, which records that it fell back rather than doing it silently.
+     */
+    readonly GiftCardLiability: "Gift Card Liability";
+};
+export type GLRole = (typeof GL_ROLE)[keyof typeof GL_ROLE];
+/** MJ Entity IDs for the records the account links hang off. */
+export interface ResolverEntityIDs {
+    Product: string;
+    ProductCategory: string;
+    ProductType: string;
+    Company: string;
+}
+export declare class GLAccountResolutionError extends Error {
+    readonly Role: string;
+    readonly ProductID: string;
+    constructor(Role: string, ProductID: string, message: string);
+}
+/**
+ * Resolves role→account for products, caching the category tree for the life of one booking.
+ * Construct per unit of work; do not hold across requests (the category tree is read once).
+ */
+export declare class GLAccountResolver {
+    private readonly _entityIDs;
+    private readonly _provider;
+    private readonly _contextUser;
+    /** Injected so this class stays testable without a live accounting engine. */
+    private readonly _resolveLink;
+    private readonly _categoryParent;
+    private _categoriesLoaded;
+    constructor(_entityIDs: ResolverEntityIDs, _provider: IMetadataProvider, _contextUser: UserInfo, 
+    /** Injected so this class stays testable without a live accounting engine. */
+    _resolveLink: (entityId: string, recordId: string, role: string, asOf: Date, 
+    /** When given, only links whose ACCOUNT belongs to this company are considered (D71). */
+    forCompanyID?: string) => {
+        GLAccountID: string;
+        CompanyID: string;
+    } | null);
+    /**
+     * Walk product → category → ancestors → product type → company for `role`.
+     *
+     * @param expectedCompanyID the order line's company; the resolved account must belong to it
+     * @returns the resolved GL account UUID
+     * @throws GLAccountResolutionError when nothing resolves, or when the account's company differs
+     */
+    Resolve(role: GLRole, 
+    /**
+     * NULL for company-level roles. A payment clears a receivable for a COMPANY — there is no
+     * product or category to walk from, so the company default is both the start and the end of
+     * the resolution.
+     */
+    productID: string | null, productCategoryID: string | null, expectedCompanyID: string, asOf: Date, productTypeID?: string | null): Promise<string>;
+    /**
+     * Resolve a link for an ARBITRARY record, with no walk (D71).
+     *
+     * The product walk answers "what account does this product's revenue go to". Some things are not
+     * products and have no category tree — a charge type, for instance — so they are looked up
+     * directly. Returns null rather than throwing: the caller knows whether the absence is fatal.
+     *
+     * The company invariant still applies. An account belonging to another company is refused for
+     * exactly the reason D6 gives: accounting derives the entry's company FROM the account, so a
+     * mis-resolved one books to the wrong legal entity with nothing downstream to catch it.
+     */
+    ResolveForRecord(role: GLRole, entityID: string, recordID: string, expectedCompanyID: string, asOf: Date): Promise<string | null>;
+    /** Category, then each ancestor, nearest first. */
+    private resolveUpCategoryTree;
+    /** One read of the category tree per booking — the walk is pointer-chasing after this. */
+    private ensureCategoriesLoaded;
+}
+//# sourceMappingURL=GLAccountResolver.d.ts.map

package/dist/GLAccountResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GLAccountResolver.d.ts","sourceRoot":"","sources":["../src/GLAccountResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,iBAAiB,EAA6B,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG9F,iFAAiF;AACjF,eAAO,MAAM,OAAO;;;;;;IAMhB,6FAA6F;;IAE7F;;;;OAIG;;IAEH;;;;;;;;;;;OAWG;;CAEG,CAAC;AAEX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE5D,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;aAE3B,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;gBADjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjC,OAAO,EAAE,MAAM;CAKtB;AAOD;;;GAGG;AACH,qBAAa,iBAAiB;IAKtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,YAAY;IARjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IACpE,OAAO,CAAC,iBAAiB,CAAS;gBAGb,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,QAAQ;IACvC,8EAA8E;IAC7D,YAAY,EAAE,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI;IACV,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,KACpB;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAG1D;;;;;;OAMG;IACU,OAAO,CAChB,IAAI,EAAE,MAAM;IACZ;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,IAAI,EACV,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC9B,OAAO,CAAC,MAAM,CAAC;IAuClB;;;;;;;;;;OAUG;IACU,gBAAgB,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,IAAI,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAczB,mDAAmD;YACrC,qBAAqB;IAqBnC,0FAA0F;YAC5E,sBAAsB;CAkBvC"}

package/dist/GLAccountResolver.js

@@ -0,0 +1,175 @@
+/**
+ * GLAccountResolver — turns a (product, role) pair into a concrete GL account UUID.
+ *
+ * Accounting's `CreateJournalEntries` contract takes `GLAccountID`, never a role name, so the
+ * role→account walk is the CALLER's job (plan D5). Accounting supplies only the per-record link
+ * primitive — `AccountingEngineBase.ResolveLinkedAccount(entityId, recordId, role, asOfDate)` —
+ * and this class implements the precedence over it:
+ *
+ *     Product  →  its ProductCategory  →  that category's ancestors
+ *              →  its ProductType  →  the line's Company
+ *
+ * Company is the last resort (the accounting-org default). Product Type sits above
+ * the company default so a type can name Sales once and every product of that type
+ * inherits it, while a category or product can still override.
+ *
+ * Most specific wins; the first link found at any level ends the walk. Nothing resolves → we
+ * FAIL LOUDLY (plan D5: "fail loudly" — never silently book to a default account).
+ *
+ * COMPANY INVARIANT (plan D6): the resolved account MUST belong to the order line's company.
+ * Accounting derives a JE's company from `GLAccount.CompanyID` and takes no CompanyID in its
+ * contract (their CH-2), so a mis-resolved account would silently book revenue to the wrong
+ * legal entity with nothing downstream to catch it. This class is therefore the ONLY place that
+ * invariant can be enforced, and it hard-blocks — cross-company mapping is refused entirely.
+ *
+ * CONNECTS TO:
+ *   PRIMITIVE: AccountingEngineBase.ResolveLinkedAccount (@mj-biz-apps/accounting-engine-base)
+ *   CALLER:    OrderJournalEntryFactory (./OrderJournalEntryFactory.ts)
+ */
+import { RunView } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+/** GL account roles this app books against (seeded by accounting's metadata). */
+export const GL_ROLE = {
+    AccountsReceivable: 'Accounts Receivable',
+    Sales: 'Sales',
+    SalesDiscounts: 'Sales Discounts',
+    DeferredRevenue: 'Deferred Revenue',
+    SalesReturnsAndAllowances: 'Sales Returns and Allowances',
+    /** Where captured cash lands. Company-level only — a payment has no product to walk from. */
+    Cash: 'Cash',
+    /**
+     * The provider's cut on a capture (D18). NOT seeded by accounting's starter roles, so callers
+     * must tolerate it failing to resolve — see PaymentJournalEntryFactory, which books the gross
+     * to Cash and reports the shortfall rather than silently misstating the bank line.
+     */
+    ProcessingFee: 'Processing Fee',
+    /**
+     * What the company OWES on an unredeemed gift card (D44).
+     *
+     * Selling a gift card earns nothing — money has come in and goods are owed — so the credit leg
+     * is a liability, not revenue. Recognising at issue and again at redemption is the classic
+     * gift-card double-count, and it is invisible in the ledger because both entries balance.
+     *
+     * NOT seeded by accounting's starter roles, so callers must tolerate it failing to resolve. The
+     * fallback is Deferred Revenue, which is the same SHAPE of obligation and keeps the entry
+     * correct and balanced — just coarser than a dedicated card liability. See
+     * OrderJournalEntryFactory, which records that it fell back rather than doing it silently.
+     */
+    GiftCardLiability: 'Gift Card Liability',
+};
+export class GLAccountResolutionError extends Error {
+    constructor(Role, ProductID, message) {
+        super(message);
+        this.Role = Role;
+        this.ProductID = ProductID;
+        this.name = 'GLAccountResolutionError';
+    }
+}
+/**
+ * Resolves role→account for products, caching the category tree for the life of one booking.
+ * Construct per unit of work; do not hold across requests (the category tree is read once).
+ */
+export class GLAccountResolver {
+    constructor(_entityIDs, _provider, _contextUser, 
+    /** Injected so this class stays testable without a live accounting engine. */
+    _resolveLink) {
+        this._entityIDs = _entityIDs;
+        this._provider = _provider;
+        this._contextUser = _contextUser;
+        this._resolveLink = _resolveLink;
+        this._categoryParent = new Map();
+        this._categoriesLoaded = false;
+    }
+    /**
+     * Walk product → category → ancestors → product type → company for `role`.
+     *
+     * @param expectedCompanyID the order line's company; the resolved account must belong to it
+     * @returns the resolved GL account UUID
+     * @throws GLAccountResolutionError when nothing resolves, or when the account's company differs
+     */
+    async Resolve(role, 
+    /**
+     * NULL for company-level roles. A payment clears a receivable for a COMPANY — there is no
+     * product or category to walk from, so the company default is both the start and the end of
+     * the resolution.
+     */
+    productID, productCategoryID, expectedCompanyID, asOf, productTypeID) {
+        const company = expectedCompanyID;
+        const hit = (productID ? this._resolveLink(this._entityIDs.Product, productID, role, asOf, company) : null) ??
+            (await this.resolveUpCategoryTree(role, productCategoryID, asOf, company)) ??
+            (productTypeID
+                ? this._resolveLink(this._entityIDs.ProductType, productTypeID, role, asOf, company)
+                : null) ??
+            this._resolveLink(this._entityIDs.Company, expectedCompanyID, role, asOf, company);
+        if (!hit) {
+            throw new GLAccountResolutionError(role, productID, productID
+                ? `No GL account is linked for role '${role}'. Checked the product, its category ` +
+                    `tree, its product type, and the company default for company ${expectedCompanyID}. ` +
+                    `Link an account for this role (product, category, product type, or company) before booking.`
+                : `No GL account is linked for role '${role}' at the company level for company ` +
+                    `${expectedCompanyID}. This role is resolved company-wide (there is no product ` +
+                    `involved), so link an account to the company before booking.`);
+        }
+        // Plan D6 — hard block. Accounting takes no CompanyID; the account IS the company.
+        if (!UUIDsEqual(hit.CompanyID, expectedCompanyID)) {
+            throw new GLAccountResolutionError(role, productID, `GL account ${hit.GLAccountID} resolved for role '${role}' belongs to company ` +
+                `${hit.CompanyID}, but this books to company ${expectedCompanyID}. ` +
+                `Cross-company account mapping is refused — the journal entry would book revenue ` +
+                `to the wrong legal entity.`);
+        }
+        return hit.GLAccountID;
+    }
+    /**
+     * Resolve a link for an ARBITRARY record, with no walk (D71).
+     *
+     * The product walk answers "what account does this product's revenue go to". Some things are not
+     * products and have no category tree — a charge type, for instance — so they are looked up
+     * directly. Returns null rather than throwing: the caller knows whether the absence is fatal.
+     *
+     * The company invariant still applies. An account belonging to another company is refused for
+     * exactly the reason D6 gives: accounting derives the entry's company FROM the account, so a
+     * mis-resolved one books to the wrong legal entity with nothing downstream to catch it.
+     */
+    async ResolveForRecord(role, entityID, recordID, expectedCompanyID, asOf) {
+        const hit = this._resolveLink(entityID, recordID, role, asOf, expectedCompanyID);
+        if (!hit)
+            return null;
+        if (!UUIDsEqual(hit.CompanyID, expectedCompanyID)) {
+            throw new GLAccountResolutionError(role, recordID, `GL account ${hit.GLAccountID} resolved for role '${role}' belongs to company ${hit.CompanyID}, ` +
+                `but this books to company ${expectedCompanyID}. Cross-company account mapping is refused.`);
+        }
+        return hit.GLAccountID;
+    }
+    /** Category, then each ancestor, nearest first. */
+    async resolveUpCategoryTree(role, startCategoryID, asOf, forCompanyID) {
+        if (!startCategoryID)
+            return null;
+        await this.ensureCategoriesLoaded();
+        const seen = new Set();
+        let current = startCategoryID;
+        while (current && !seen.has(current)) {
+            seen.add(current); // cycle guard — the DB CHECK blocks self-parenting, not longer loops
+            const hit = this._resolveLink(this._entityIDs.ProductCategory, current, role, asOf, forCompanyID);
+            if (hit)
+                return hit;
+            current = this._categoryParent.get(current) ?? null;
+        }
+        return null;
+    }
+    /** One read of the category tree per booking — the walk is pointer-chasing after this. */
+    async ensureCategoriesLoaded() {
+        if (this._categoriesLoaded)
+            return;
+        const rv = new RunView(this._provider);
+        const result = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Product Categories',
+            Fields: ['ID', 'ParentProductCategoryID'],
+            ResultType: 'simple',
+        }, this._contextUser);
+        for (const row of result?.Results ?? []) {
+            this._categoryParent.set(row.ID, row.ParentProductCategoryID ?? null);
+        }
+        this._categoriesLoaded = true;
+    }
+}
+//# sourceMappingURL=GLAccountResolver.js.map

package/dist/GLAccountResolver.js.map

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

package/dist/GetFulfillmentQueueOperation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview `Orders.GetFulfillmentQueue` — what still has to leave the building.
+ *
+ * WHY THIS IS AN OPERATION AND NOT A VIEW, and not a stored flag. The queue is every line still
+ * awaiting shipment, which changes as lines are FLIPPED rather than as anything is written to the
+ * order. A column would need a job whose only purpose is keeping it honest, and the day that job
+ * failed the warehouse would quietly stop seeing work — the worst possible failure mode for a
+ * backlog, because it looks like there is nothing to do.
+ *
+ * WHAT DOES NOT APPEAR HERE, each for its own reason:
+ *   · lines whose product TYPE requires no fulfilment — a subscription, a download, a donation;
+ *   · REVERSAL lines — goods coming back are tracked on the line they reverse, not by shipping a
+ *     credit;
+ *   · a bundle's ROLLUP PARENT — a display row whose children carry the actual goods (D45).
+ *
+ * Getting any of those wrong fills the queue with work nobody can do, which is how a real queue
+ * stops being read.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { OrdersGetFulfillmentQueueOperation as OrdersGetFulfillmentQueueOperationBase, type OrdersGetFulfillmentQueueInput, type OrdersGetFulfillmentQueueOutput } from '@mj-biz-apps/orders-entities';
+/**
+ * Assemble the fulfilment queue.
+ *
+ * Orders come back OLDEST CONFIRMED FIRST — the order a warehouse should work them in. Not by size,
+ * and not by customer: the oldest promise is the one most at risk of being broken.
+ */
+export declare class GetFulfillmentQueueOperation extends OrdersGetFulfillmentQueueOperationBase {
+    protected InternalExecute(input: OrdersGetFulfillmentQueueInput, provider: IMetadataProvider, user: UserInfo): Promise<OrdersGetFulfillmentQueueOutput>;
+    private empty;
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export declare function LoadGetFulfillmentQueueOperation(): void;
+//# sourceMappingURL=GetFulfillmentQueueOperation.d.ts.map

package/dist/GetFulfillmentQueueOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetFulfillmentQueueOperation.d.ts","sourceRoot":"","sources":["../src/GetFulfillmentQueueOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAGH,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,kCAAkC,IAAI,sCAAsC,EAC5E,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EAGvC,MAAM,8BAA8B,CAAC;AActC;;;;;GAKG;AACH,qBACa,4BAA6B,SAAQ,sCAAsC;cACpE,eAAe,CAC3B,KAAK,EAAE,8BAA8B,EACrC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,+BAA+B,CAAC;IA4M3C,OAAO,CAAC,KAAK;CAUhB;AAED,0FAA0F;AAC1F,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}