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

package/dist/OrderLineExtensionCompanion.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview `OrderLineExtensionCompanion` — weaves an extension entity (e.g. `EventOrderLine`)
+ * into an `OrderLine`, participating in validation, serialization, and server-side atomic persistence.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { BaseEntity, EntityCompanion, ValidationResult, type EntityCompanionDeserializeMode } from '@memberjunction/core';
+/**
+ * The wire shape for an order line extension.
+ */
+export type OrderLineExtensionWire = {
+    /** The extension entity name in MJ metadata (e.g. `'MJ_BizApps_Orders: Event Order Lines'`). */
+    EntityName: string;
+    /** The extension entity's field values. */
+    Fields: Record<string, unknown>;
+    /** Whether this extension record is a pending insert rather than an existing row. */
+    IsNew: boolean;
+};
+export declare class OrderLineExtensionCompanion extends EntityCompanion<OrderLineExtensionWire> {
+    /**
+     * Stable companion identifier.
+     */
+    readonly Name = "OrderLineExtension";
+    private _entityName;
+    private _entity;
+    private _wireData;
+    /** The extension entity name in metadata, if configured. */
+    get EntityName(): string | null;
+    /** The live extension entity instance, if provisioned. */
+    get Entity(): BaseEntity | null;
+    /** True when this companion has an extension entity attached or specified. */
+    get IsConfigured(): boolean;
+    /** True when the extension entity is persisted in the database. */
+    get IsSaved(): boolean;
+    /** True when the extension entity has uncommitted changes. */
+    get Dirty(): boolean;
+    /**
+     * Attaches an extension entity instance directly.
+     */
+    SetEntity(entity: BaseEntity | null): void;
+    /**
+     * Ensures an extension entity object exists, creating or hydrating one if necessary.
+     */
+    EnsureEntity(entityName?: string): Promise<BaseEntity | null>;
+    /** @inheritdoc */
+    Serialize(mode?: EntityCompanionDeserializeMode): Promise<OrderLineExtensionWire | null>;
+    /** @inheritdoc */
+    Deserialize(data: OrderLineExtensionWire, mode?: EntityCompanionDeserializeMode): Promise<void>;
+    /** @inheritdoc */
+    Validate(result: ValidationResult): void;
+    /** @inheritdoc */
+    AcceptChanges(): void;
+}
+//# sourceMappingURL=OrderLineExtensionCompanion.d.ts.map

package/dist/OrderLineExtensionCompanion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderLineExtensionCompanion.d.ts","sourceRoot":"","sources":["../src/OrderLineExtensionCompanion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACH,UAAU,EAEV,eAAe,EAEf,gBAAgB,EAChB,KAAK,8BAA8B,EAEtC,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,gGAAgG;IAChG,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,qFAAqF;IACrF,KAAK,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,2BAA4B,SAAQ,eAAe,CAAC,sBAAsB,CAAC;IACpF;;OAEG;IACH,SAAgB,IAAI,wBAAwB;IAE5C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,SAAS,CAAuC;IAExD,4DAA4D;IAC5D,IAAW,UAAU,IAAI,MAAM,GAAG,IAAI,CAErC;IAED,0DAA0D;IAC1D,IAAW,MAAM,IAAI,UAAU,GAAG,IAAI,CAErC;IAED,8EAA8E;IAC9E,IAAW,YAAY,IAAI,OAAO,CAEjC;IAED,mEAAmE;IACnE,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,8DAA8D;IAC9D,IAAoB,KAAK,IAAI,OAAO,CAKnC;IAED;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAMjD;;OAEG;IACU,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA2D1E,kBAAkB;IACI,SAAS,CAC3B,IAAI,GAAE,8BAA0C,GACjD,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAyBzC,kBAAkB;IACI,WAAW,CAC7B,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,8BAA0C,GACjD,OAAO,CAAC,IAAI,CAAC;IAoBhB,kBAAkB;IACF,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAgBxD,kBAAkB;IACF,aAAa,IAAI,IAAI;CAKxC"}

package/dist/OrderLineExtensionCompanion.js

@@ -0,0 +1,167 @@
+/**
+ * @fileoverview `OrderLineExtensionCompanion` — weaves an extension entity (e.g. `EventOrderLine`)
+ * into an `OrderLine`, participating in validation, serialization, and server-side atomic persistence.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { CompositeKey, EntityCompanion, KeyValuePair, } from '@memberjunction/core';
+export class OrderLineExtensionCompanion extends EntityCompanion {
+    constructor() {
+        super(...arguments);
+        /**
+         * Stable companion identifier.
+         */
+        this.Name = 'OrderLineExtension';
+        this._entityName = null;
+        this._entity = null;
+        this._wireData = null;
+    }
+    /** The extension entity name in metadata, if configured. */
+    get EntityName() {
+        return this._entity?.EntityInfo?.Name ?? this._entityName;
+    }
+    /** The live extension entity instance, if provisioned. */
+    get Entity() {
+        return this._entity;
+    }
+    /** True when this companion has an extension entity attached or specified. */
+    get IsConfigured() {
+        return !!this._entity || !!this._entityName || !!this._wireData;
+    }
+    /** True when the extension entity is persisted in the database. */
+    get IsSaved() {
+        return this._entity?.IsSaved ?? (!this._wireData?.IsNew && !!this._wireData);
+    }
+    /** True when the extension entity has uncommitted changes. */
+    get Dirty() {
+        if (this._entity) {
+            return !this._entity.IsSaved || this._entity.Dirty;
+        }
+        return !!this._wireData?.IsNew;
+    }
+    /**
+     * Attaches an extension entity instance directly.
+     */
+    SetEntity(entity) {
+        this._entity = entity;
+        this._entityName = entity?.EntityInfo?.Name ?? null;
+        this._wireData = null;
+    }
+    /**
+     * Ensures an extension entity object exists, creating or hydrating one if necessary.
+     */
+    async EnsureEntity(entityName) {
+        const targetName = entityName ?? this.EntityName;
+        if (!targetName) {
+            return null;
+        }
+        if (this._entity && (!entityName || this._entity.EntityInfo?.Name === entityName)) {
+            return this._entity;
+        }
+        const provider = this.Owner.ProviderToUse;
+        if (!provider) {
+            return null;
+        }
+        const ext = await provider.GetEntityObject(targetName, this.Owner.ContextCurrentUser);
+        if (!ext) {
+            return null;
+        }
+        const lineId = this.Owner.FirstPrimaryKey?.Value;
+        if (this._wireData) {
+            if (this._wireData.IsNew) {
+                ext.NewRecord();
+                if (lineId) {
+                    ext.Set('ID', lineId);
+                }
+                ext.SetMany(this._wireData.Fields, true);
+            }
+            else {
+                const key = new CompositeKey(ext.EntityInfo.PrimaryKeys.map(pk => new KeyValuePair(pk.Name, this._wireData.Fields[pk.Name] ?? lineId)));
+                const loaded = await ext.InnerLoad(key);
+                if (!loaded) {
+                    ext.NewRecord();
+                }
+                ext.SetMany(this._wireData.Fields, true);
+            }
+        }
+        else if (lineId && this.Owner.IsSaved) {
+            const key = new CompositeKey(ext.EntityInfo.PrimaryKeys.map(pk => new KeyValuePair(pk.Name, lineId)));
+            const loaded = await ext.InnerLoad(key);
+            if (!loaded) {
+                ext.NewRecord();
+                ext.Set('ID', lineId);
+            }
+        }
+        else {
+            ext.NewRecord();
+            if (lineId) {
+                ext.Set('ID', lineId);
+            }
+        }
+        this._entity = ext;
+        this._entityName = targetName;
+        return ext;
+    }
+    /** @inheritdoc */
+    async Serialize(mode = 'request') {
+        if (!this.IsConfigured) {
+            return null;
+        }
+        // In request mode, skip clean saved extensions to save bandwidth
+        if (mode !== 'result' && this._entity && this._entity.IsSaved && !this._entity.Dirty) {
+            return null;
+        }
+        if (this._entity) {
+            return {
+                EntityName: this._entity.EntityInfo?.Name ?? this._entityName ?? '',
+                Fields: this._entity.GetAll(),
+                IsNew: !this._entity.IsSaved,
+            };
+        }
+        if (this._wireData) {
+            return this._wireData;
+        }
+        return null;
+    }
+    /** @inheritdoc */
+    async Deserialize(data, mode = 'request') {
+        if (!data || !data.EntityName) {
+            this._entity = null;
+            this._entityName = null;
+            this._wireData = null;
+            return;
+        }
+        this._entityName = data.EntityName;
+        this._wireData = data;
+        const provider = this.Owner.ProviderToUse;
+        if (provider) {
+            await this.EnsureEntity(data.EntityName);
+            if (this._entity && mode === 'result') {
+                await this._entity.LoadFromData(data.Fields, true);
+            }
+        }
+    }
+    /** @inheritdoc */
+    Validate(result) {
+        if (this._entity) {
+            const extResult = this._entity.Validate();
+            if (!extResult.Success && extResult.Errors.length > 0) {
+                // If extension is an IS-A child, only include its own field errors, not parent chain duplicates
+                const ownErrors = this._entity.ISAParent
+                    ? extResult.Errors.filter(err => !this._entity.EntityInfo.ParentEntityFieldNames?.has(err.Source))
+                    : extResult.Errors;
+                if (ownErrors.length > 0) {
+                    result.Success = false;
+                    result.Errors.push(...ownErrors);
+                }
+            }
+        }
+    }
+    /** @inheritdoc */
+    AcceptChanges() {
+        if (this._wireData) {
+            this._wireData.IsNew = false;
+        }
+    }
+}
+//# sourceMappingURL=OrderLineExtensionCompanion.js.map

package/dist/OrderLineExtensionCompanion.js.map

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

package/dist/OrderStatusBehavior.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview What an order's status MEANS, and which statuses it may move to — stated once.
+ *
+ * WHY THIS EXISTS. The database enforces the legal SET (`CK_OrderHeader_Status`) and nothing enforced
+ * the legal MOVES. `Voided → Confirmed` saved. A voided order could come back to life, keep its journal
+ * entries, and be shipped — every row individually valid, the CHECK constraint satisfied, and no test looking.
+ *
+ * The second half of the problem was quieter. Six modules each held their own opinion about what a
+ * status permits, written as ad-hoc string sets that had drifted apart:
+ *
+ *   `GetOverdueWorklist`   excludes Draft, Quoted, Voided
+ *   `DeliveryBehavior`     excludes Draft, Voided, Cancelled, Canceled
+ *   `InvoiceBehavior`      refuses Voided
+ *   `FulfillmentBehavior`  nothing before Confirmed
+ *   `ReversalResolver`     skips Draft, Voided
+ *
+ * So the statuses, the transitions and the predicates live here, pure and testable, and the entity
+ * server enforces them on the one path every write goes through.
+ *
+ * 3-WAY ORTHOGONAL LIFECYCLE MODEL:
+ * 1. `Status`: Pure commercial contract state (Draft <-> Quoted -> Confirmed; Voided <-> Draft/Quoted).
+ * 2. `FulfillmentStatus`: Operational delivery state (Pending | PartiallyFulfilled | Fulfilled | NotApplicable | Returned).
+ * 3. Financial/Payment Progress: Pure numeric facts (TotalGross, AmountPaid, Balance, IsOverdue).
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import type { mjBizAppsOrdersOrderHeaderEntity } from './generated/entity_subclasses.js';
+/** The four values `CK_OrderHeader_Status` permits. */
+export declare const ORDER_STATUSES: readonly ["Draft", "Quoted", "Confirmed", "Voided"];
+export type OrderStatus = mjBizAppsOrdersOrderHeaderEntity['Status'];
+export declare const ORDER_FULFILLMENT_STATUSES: readonly ["Pending", "PartiallyFulfilled", "Fulfilled", "NotApplicable", "Returned"];
+export type OrderFulfillmentStatus = mjBizAppsOrdersOrderHeaderEntity['FulfillmentStatus'];
+export declare function IsOrderStatus(value: string | null | undefined): value is OrderStatus;
+export declare function IsOrderFulfillmentStatus(value: string | null | undefined): value is OrderFulfillmentStatus;
+export interface TransitionVerdict {
+    Allowed: boolean;
+    /** Present when refused — says what was attempted and why it is not a move. */
+    Reason?: string;
+}
+/**
+ * May this order move from `from` to `to`?
+ *
+ * AN UNKNOWN STATUS IS REFUSED, not ignored. The CHECK constraint would catch it a moment later with
+ * a message naming a constraint rather than a status.
+ */
+export declare function CanTransition(from: string | null | undefined, to: string | null | undefined): TransitionVerdict;
+/** Every status reachable from this one, excluding staying put. Empty for a terminal status. */
+export declare function NextStatuses(from: OrderStatus): readonly OrderStatus[];
+/** Editable: lines may be added, repriced and removed. Booking has not happened. */
+export declare function IsEditable(status: string): boolean;
+/**
+ * May the Confirm *verb* be offered from this status?
+ *
+ * Separate from `CanTransition(from, 'Confirmed')` because a brand-new row may be
+ * *created* as Confirmed (back-office entry) but the on-screen verb is only for
+ * Draft and Quoted — the two states a person is still composing.
+ */
+export declare function CanOfferConfirm(status: string | null | undefined): TransitionVerdict;
+/**
+ * The order has booked — journal entries exist and the receivable is real.
+ */
+export declare function IsBooked(status: string): boolean;
+/** Nothing further will happen to this order of its own accord. */
+export declare function IsTerminal(status: string): boolean;
+/**
+ * May a document for this order be SENT to a customer as a bill?
+ */
+export declare function IsDeliverable(status: string): boolean;
+/** Does this order count toward what a customer owes? */
+export declare function CountsTowardReceivable(status: string): boolean;
+export interface FulfillableLineLike {
+    RequiresFulfillment?: boolean | null;
+    ReversesOrderLineID?: string | null;
+    IsRollupParent?: boolean | null;
+    FulfillmentStatus?: string | null;
+}
+/**
+ * Computes the header FulfillmentStatus rolled up across its order lines.
+ */
+export declare function DeriveHeaderFulfillmentStatus(lines: readonly FulfillableLineLike[]): OrderFulfillmentStatus;
+export type DerivedPaymentStatus = 'Unpaid' | 'PartiallyPaid' | 'Paid';
+/**
+ * Derives payment status purely from numeric financial totals.
+ */
+export declare function DerivePaymentStatus(totalGross: number | null | undefined, amountPaid: number | null | undefined, balance: number | null | undefined): DerivedPaymentStatus;
+//# sourceMappingURL=OrderStatusBehavior.d.ts.map

package/dist/OrderStatusBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderStatusBehavior.d.ts","sourceRoot":"","sources":["../src/OrderStatusBehavior.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AAEtF,uDAAuD;AACvD,eAAO,MAAM,cAAc,qDAAsD,CAAC;AAElF,MAAM,MAAM,WAAW,GAAG,gCAAgC,CAAC,QAAQ,CAAC,CAAC;AAErE,eAAO,MAAM,0BAA0B,sFAM7B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,gCAAgC,CAAC,mBAAmB,CAAC,CAAC;AAE3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,WAAW,CAEpF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,IAAI,sBAAsB,CAE1G;AAwBD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CA0C/G;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,WAAW,EAAE,CAEtE;AAID,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAWpF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,MAAM,WAAW,mBAAmB;IAChC,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG,sBAAsB,CAe3G;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,eAAe,GAAG,MAAM,CAAC;AAEvE;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,oBAAoB,CAQtB"}

package/dist/OrderStatusBehavior.js

@@ -0,0 +1,160 @@
+/** The four values `CK_OrderHeader_Status` permits. */
+export const ORDER_STATUSES = ['Draft', 'Quoted', 'Confirmed', 'Voided'];
+export const ORDER_FULFILLMENT_STATUSES = [
+    'Pending',
+    'PartiallyFulfilled',
+    'Fulfilled',
+    'NotApplicable',
+    'Returned',
+];
+export function IsOrderStatus(value) {
+    return !!value && ORDER_STATUSES.includes(value);
+}
+export function IsOrderFulfillmentStatus(value) {
+    return !!value && ORDER_FULFILLMENT_STATUSES.includes(value);
+}
+/**
+ * Where each commercial status may go.
+ *
+ * THE SHAPE OF THE LIFECYCLE.
+ * - `Draft` and `Quoted` are the two pre-booking editable states. They may move to each other
+ *   freely, or be moved to `Voided` (pre-booking void), or advance to `Confirmed` (booking gate).
+ * - `Voided` (unconfirmed): An unconfirmed order in `Voided` may be reopened back to `Draft` or
+ *   `Quoted`. Direct transition from `Voided` to `Confirmed` is blocked (must reopen as Draft/Quote first).
+ * - `Confirmed` is the irreversible booking gate: it books journal entries (D8), which is why
+ *   nothing returns to an editable state or moves to `Voided` from there.
+ * - Post-booking cancellations/corrections go through **Reversal Orders** (D16/D53) rather than in-place
+ *   status changes to `Voided`, ensuring correcting journal entries are properly recorded.
+ *
+ * A status may always be re-saved as itself — an ordinary row update that touches other columns.
+ */
+const TRANSITIONS = {
+    Draft: ['Quoted', 'Confirmed', 'Voided'],
+    Quoted: ['Draft', 'Confirmed', 'Voided'],
+    Confirmed: [],
+    Voided: ['Draft', 'Quoted'],
+};
+/**
+ * May this order move from `from` to `to`?
+ *
+ * AN UNKNOWN STATUS IS REFUSED, not ignored. The CHECK constraint would catch it a moment later with
+ * a message naming a constraint rather than a status.
+ */
+export function CanTransition(from, to) {
+    // A new order has no previous status; it may be created in any legal state. Creating one directly
+    // as Confirmed is exactly what back-office entry does: save at Confirmed (D17).
+    if (from == null || from === '') {
+        return IsOrderStatus(to)
+            ? { Allowed: true }
+            : { Allowed: false, Reason: `'${to}' is not an order status. Use one of: ${ORDER_STATUSES.join(', ')}.` };
+    }
+    if (!IsOrderStatus(from)) {
+        return { Allowed: false, Reason: `'${from}' is not an order status, so nothing can move from it.` };
+    }
+    if (!IsOrderStatus(to)) {
+        return { Allowed: false, Reason: `'${to}' is not an order status. Use one of: ${ORDER_STATUSES.join(', ')}.` };
+    }
+    // Re-saving a row without changing its status is not a transition.
+    if (from === to)
+        return { Allowed: true };
+    if (TRANSITIONS[from].includes(to))
+        return { Allowed: true };
+    if (IsBooked(from) && to === 'Voided') {
+        return {
+            Allowed: false,
+            Reason: `A booked order (${from}) cannot be voided in-place. Create a reversal order to cancel or refund lines (D53).`,
+        };
+    }
+    if (from === 'Voided' && to === 'Confirmed') {
+        return {
+            Allowed: false,
+            Reason: `A voided order cannot be confirmed directly. Reopen it as Draft or Quoted first.`,
+        };
+    }
+    const onward = TRANSITIONS[from];
+    return {
+        Allowed: false,
+        Reason: onward.length
+            ? `An order cannot go from ${from} to ${to}. From ${from} it may only become: ${onward.join(', ')}.`
+            : `${from} is final. An order cannot leave it, so it cannot become ${to}.`,
+    };
+}
+/** Every status reachable from this one, excluding staying put. Empty for a terminal status. */
+export function NextStatuses(from) {
+    return TRANSITIONS[from];
+}
+// ── What a status PERMITS ────────────────────────────────────────────────────────────────────────
+/** Editable: lines may be added, repriced and removed. Booking has not happened. */
+export function IsEditable(status) {
+    return status === 'Draft' || status === 'Quoted';
+}
+/**
+ * May the Confirm *verb* be offered from this status?
+ *
+ * Separate from `CanTransition(from, 'Confirmed')` because a brand-new row may be
+ * *created* as Confirmed (back-office entry) but the on-screen verb is only for
+ * Draft and Quoted — the two states a person is still composing.
+ */
+export function CanOfferConfirm(status) {
+    if (status == null || status === '') {
+        return { Allowed: true };
+    }
+    if (IsBooked(status)) {
+        return { Allowed: false, Reason: 'This order is already booked.' };
+    }
+    if (status === 'Voided') {
+        return { Allowed: false, Reason: 'Reopen this voided order as a Draft or Quote before confirming.' };
+    }
+    return CanTransition(status, 'Confirmed');
+}
+/**
+ * The order has booked — journal entries exist and the receivable is real.
+ */
+export function IsBooked(status) {
+    return status === 'Confirmed';
+}
+/** Nothing further will happen to this order of its own accord. */
+export function IsTerminal(status) {
+    return IsOrderStatus(status) && TRANSITIONS[status].length === 0;
+}
+/**
+ * May a document for this order be SENT to a customer as a bill?
+ */
+export function IsDeliverable(status) {
+    return status !== 'Draft' && status !== 'Voided';
+}
+/** Does this order count toward what a customer owes? */
+export function CountsTowardReceivable(status) {
+    return IsBooked(status);
+}
+/**
+ * Computes the header FulfillmentStatus rolled up across its order lines.
+ */
+export function DeriveHeaderFulfillmentStatus(lines) {
+    const fulfillable = lines.filter((l) => !!l.RequiresFulfillment && !l.ReversesOrderLineID && !l.IsRollupParent);
+    if (fulfillable.length === 0) {
+        return 'NotApplicable';
+    }
+    const fulfilledCount = fulfillable.filter((l) => l.FulfillmentStatus === 'Fulfilled').length;
+    if (fulfilledCount === fulfillable.length) {
+        return 'Fulfilled';
+    }
+    if (fulfilledCount > 0) {
+        return 'PartiallyFulfilled';
+    }
+    return 'Pending';
+}
+/**
+ * Derives payment status purely from numeric financial totals.
+ */
+export function DerivePaymentStatus(totalGross, amountPaid, balance) {
+    const gross = Number(totalGross ?? 0);
+    const paid = Number(amountPaid ?? 0);
+    const bal = balance != null ? Number(balance) : gross - paid;
+    if (bal <= 0 && gross > 0)
+        return 'Paid';
+    if (paid > 0)
+        return 'PartiallyPaid';
+    return 'Unpaid';
+}
+//# sourceMappingURL=OrderStatusBehavior.js.map

package/dist/OrderStatusBehavior.js.map

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

package/dist/PartyAffiliationBehavior.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview `PartyAffiliationBehavior` — party and employer resolution helpers.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { type IRunViewProvider, type UserInfo } from '@memberjunction/core';
+export type ActiveEmployerRow = {
+    ToOrganizationID: string;
+    StartDate?: Date | string | null;
+    EndDate?: Date | string | null;
+};
+/**
+ * Active Employee relationship to an organization as of `asOf`.
+ * Zero matches → null. One match → that org. Several → the longest-lasting
+ * (earliest StartDate / longest span; a null StartDate counts as longest).
+ */
+export declare function ResolveActiveEmployerOrganization(provider: IRunViewProvider, personID: string, asOf?: Date, user?: UserInfo): Promise<string | null>;
+/** @deprecated Use {@link ResolveActiveEmployerOrganization} — multiple employers now pick the longest-lasting. */
+export declare function ResolveSingularActiveEmployerOrganization(provider: IRunViewProvider, personID: string, asOf?: Date, user?: UserInfo): Promise<string | null>;
+//# sourceMappingURL=PartyAffiliationBehavior.d.ts.map

package/dist/PartyAffiliationBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartyAffiliationBehavior.d.ts","sourceRoot":"","sources":["../src/PartyAffiliationBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAW,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAUF;;;;GAIG;AACH,wBAAsB,iCAAiC,CACnD,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,IAAiB,EACvB,IAAI,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BxB;AAED,mHAAmH;AACnH,wBAAsB,yCAAyC,CAC3D,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,IAAiB,EACvB,IAAI,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB"}

package/dist/PartyAffiliationBehavior.js

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview `PartyAffiliationBehavior` — party and employer resolution helpers.
+ *
+ * @module @mj-biz-apps/orders-entities
+ */
+import { RunView } from '@memberjunction/core';
+function durationMs(row, asOf) {
+    const start = row.StartDate ? new Date(row.StartDate).getTime() : 0;
+    const endRaw = row.EndDate ? new Date(row.EndDate).getTime() : asOf.getTime();
+    const end = Number.isFinite(endRaw) ? endRaw : asOf.getTime();
+    const begin = Number.isFinite(start) ? start : 0;
+    return Math.max(0, end - begin);
+}
+/**
+ * Active Employee relationship to an organization as of `asOf`.
+ * Zero matches → null. One match → that org. Several → the longest-lasting
+ * (earliest StartDate / longest span; a null StartDate counts as longest).
+ */
+export async function ResolveActiveEmployerOrganization(provider, personID, asOf = new Date(), user) {
+    if (!personID || !provider)
+        return null;
+    const rv = new RunView(provider);
+    const date = asOf.toISOString().slice(0, 10);
+    try {
+        const res = await rv.RunView({
+            EntityName: 'MJ_BizApps_Common: Relationships',
+            ExtraFilter: `FromPersonID='${personID.replace(/'/g, "''")}' AND ToOrganizationID IS NOT NULL ` +
+                `AND Status='Active' ` +
+                `AND (StartDate IS NULL OR StartDate <= '${date}') ` +
+                `AND (EndDate IS NULL OR EndDate >= '${date}') ` +
+                `AND RelationshipType IN ('Employer', 'Employee', 'Employment')`,
+            Fields: ['ToOrganizationID', 'StartDate', 'EndDate'],
+            ResultType: 'simple',
+            BypassCache: true,
+        }, user);
+        const rows = (res?.Success ? res.Results : null) ?? [];
+        if (rows.length === 0)
+            return null;
+        if (rows.length === 1)
+            return rows[0].ToOrganizationID ?? null;
+        const best = [...rows].sort((a, b) => durationMs(b, asOf) - durationMs(a, asOf))[0];
+        return best?.ToOrganizationID ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** @deprecated Use {@link ResolveActiveEmployerOrganization} — multiple employers now pick the longest-lasting. */
+export async function ResolveSingularActiveEmployerOrganization(provider, personID, asOf = new Date(), user) {
+    return ResolveActiveEmployerOrganization(provider, personID, asOf, user);
+}
+//# sourceMappingURL=PartyAffiliationBehavior.js.map

package/dist/PartyAffiliationBehavior.js.map

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

package/dist/PaymentHeaderEntity.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared (client + server) subclass for Payment Headers.
+ *
+ * Declares the optional `PaymentDetailID` embed — the receipt's own frozen
+ * instrument snapshot (D39 copy-on-use). `PaymentHeaderEntityServer` extends
+ * this class. Remove the declaration when CodeGen emits it from metadata.
+ */
+import { ValidationResult } from '@memberjunction/core';
+import { mjBizAppsOrdersPaymentHeaderEntity, mjBizAppsOrdersPaymentDetailEntity } from './generated/entity_subclasses.js';
+export declare class PaymentHeaderEntity extends mjBizAppsOrdersPaymentHeaderEntity {
+    ClearPaymentDetail(): void;
+    get ReferenceNumber(): string | null;
+    set ReferenceNumber(value: string | null);
+    isPaymentDetailEmpty(detail: mjBizAppsOrdersPaymentDetailEntity): boolean;
+    Validate(): ValidationResult;
+    private dropSavePopulatedFieldErrors;
+}
+//# sourceMappingURL=PaymentHeaderEntity.d.ts.map

package/dist/PaymentHeaderEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentHeaderEntity.d.ts","sourceRoot":"","sources":["../src/PaymentHeaderEntity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAwE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE9H,OAAO,EACH,kCAAkC,EAClC,kCAAkC,EACrC,MAAM,+BAA+B,CAAC;AAMvC,qBACa,mBAAoB,SAAQ,kCAAkC;IAChE,kBAAkB,IAAI,IAAI;IAIjC,IAAW,eAAe,IAAI,MAAM,GAAG,IAAI,CAE1C;IAED,IAAW,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAkB9C;IAEM,oBAAoB,CAAC,MAAM,EAAE,kCAAkC,GAAG,OAAO;IAmBhE,QAAQ,IAAI,gBAAgB;IAM5C,OAAO,CAAC,4BAA4B;CAavC"}