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

package/dist/PriceOrderOperation.js

@@ -0,0 +1,146 @@
+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;
+};
+/**
+ * @fileoverview `Orders.PriceOrder` — what a whole order comes to, persisting nothing.
+ *
+ * THE ONE RULE THAT MATTERS: this runs `OrderPricingService`, which is precisely what
+ * `OrderEntityServer.Save()` and `Orders.PreviewPrice` call. There is no second implementation to
+ * drift, which is the only way the number on the screen and the number in the ledger stay the same.
+ *
+ * WHY IT EXISTS ALONGSIDE `PreviewPrice`. That operation is a one-line call to the same service and
+ * reports one SKU's unit price. This one prices the whole header — promotions, charges, tax.
+ *
+ * WHAT IT REPLACED. An earlier `Orders.PreviewOrder` ran the REAL save inside a transaction that
+ * always rolled back, then read the computed values off the entities before they vanished. The
+ * reasoning was sound — a preview that reimplements pricing is a second copy of the rules — but the
+ * cost was not: it fired on every keystroke, so composing one order ran the full booking walk
+ * (journal entries, subscription decisions, entitlement grants, sequence numbers) dozens of times
+ * and discarded all of it, and the confirm was GATED on it. Extracting the pricing walk is what
+ * makes the honest version cheap: the decide step without the write.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { BaseRemotableOperation, Metadata, } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { RequireOptionalUUID, RequireUUID } from './sql-guards.js';
+import { OrderPricingService } from '@mj-biz-apps/orders-entities';
+const ORDER_LINE_ENTITY = 'MJ_BizApps_Orders: Order Lines';
+let PriceOrderOperation = class PriceOrderOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'Orders.PriceOrder';
+    }
+    async InternalExecute(input, provider, user) {
+        const empty = { Lines: [], Totals: { Net: 0, Discount: 0, Charges: 0, Tax: 0, Gross: 0 }, UnusableCodes: [] };
+        if (!input?.CompanyID)
+            return { Success: false, Message: 'CompanyID is required.', ...empty };
+        if (!input.Lines?.length)
+            return { Success: false, Message: 'At least one line is required.', ...empty };
+        // Caller-supplied ids reach SQL filter text downstream. Validated at the boundary so every
+        // frame below can trust them.
+        RequireUUID(input.CompanyID, 'CompanyID');
+        RequireOptionalUUID(input.OrderHeaderID, 'OrderHeaderID');
+        RequireOptionalUUID(input.BillToPersonID, 'BillToPersonID');
+        RequireOptionalUUID(input.BillToOrganizationID, 'BillToOrganizationID');
+        RequireOptionalUUID(input.ShipToAddressID, 'ShipToAddressID');
+        input.Lines.forEach((l, i) => RequireUUID(l.ProductID, `Lines[${i}].ProductID`));
+        // REAL LINE ENTITIES, NEVER SAVED.
+        //
+        // The pricing walk reads and writes OrderLine entities — that is what it does for the booking
+        // path, and reusing it verbatim is the entire point. So the input is materialised into
+        // entities, priced, and read back. `NewRecord()` is called and `Save()` never is.
+        const md = new Metadata();
+        const lines = [];
+        for (const spec of input.Lines) {
+            const line = await md.GetEntityObject(ORDER_LINE_ENTITY, user);
+            line.NewRecord();
+            line.ProductID = spec.ProductID;
+            line.Quantity = Number(spec.Quantity ?? 0);
+            // An absent UnitPrice must stay UNTOUCHED so the engine resolves one. Assigning 0 would
+            // look like a deliberate free line and suppress resolution — a silently free order.
+            if (spec.UnitPrice != null)
+                line.UnitPrice = spec.UnitPrice;
+            line.DiscountPct = spec.DiscountPct ?? 0;
+            if (spec.ServicePeriodStart)
+                line.ServicePeriodStart = new Date(spec.ServicePeriodStart);
+            if (spec.ServicePeriodEnd)
+                line.ServicePeriodEnd = new Date(spec.ServicePeriodEnd);
+            lines.push(line);
+        }
+        try {
+            const result = await new OrderPricingService({ Provider: provider, User: user }).Price({
+                OrderHeaderID: input.OrderHeaderID ?? null,
+                CompanyID: input.CompanyID,
+                BillToPersonID: input.BillToPersonID ?? null,
+                BillToOrganizationID: input.BillToOrganizationID ?? null,
+                OrderDate: input.OrderDate ?? null,
+                ShipToAddressID: input.ShipToAddressID ?? null,
+                Lines: lines,
+                PromotionCodes: input.PromotionCodes ?? [],
+                ManualDiscounts: (input.ManualDiscounts ?? []),
+                Charges: (input.Charges ?? []),
+            });
+            const priced = lines.map((line, i) => {
+                const gross = Math.round(Number(line.Quantity ?? 0) * Number(line.UnitPrice ?? 0) * 100) / 100;
+                const discount = Number(line.DiscountAmount ?? 0);
+                const charge = Number(line.ChargeAmount ?? 0);
+                const tax = Number(line.LineTax ?? 0);
+                const net = Math.round((gross - discount) * 100) / 100;
+                return {
+                    ProductID: line.ProductID,
+                    Quantity: Number(line.Quantity ?? 0),
+                    UnitPrice: Number(line.UnitPrice ?? 0),
+                    DiscountAmount: discount,
+                    ChargeAmount: charge,
+                    LineTax: tax,
+                    LineTotalNet: net,
+                    LineTotalGross: Math.round((net + charge + tax) * 100) / 100,
+                    Components: result.PriceComponents.get(line)?.Components?.map((c) => ({
+                        Kind: String(c.Kind ?? ''),
+                        Label: String(c.Label ?? ''),
+                        Amount: Number(c.Amount ?? 0),
+                    })),
+                    TaxExemptReason: result.TaxReasons.get(i) ?? null,
+                };
+            });
+            const sum = (pick) => Math.round(priced.reduce((t, l) => t + pick(l), 0) * 100) / 100;
+            return {
+                Success: true,
+                Lines: priced,
+                Totals: {
+                    Net: sum((l) => l.LineTotalNet),
+                    Discount: sum((l) => l.DiscountAmount),
+                    Charges: sum((l) => l.ChargeAmount),
+                    Tax: sum((l) => l.LineTax),
+                    Gross: sum((l) => l.LineTotalGross),
+                },
+                UnusableCodes: result.UnusableCodes,
+            };
+        }
+        catch (err) {
+            // A pricing failure is an ANSWER here, not a crash: the screen asks this on every edit,
+            // and "this cannot be priced, because X" is what the user needs to see.
+            return {
+                Success: false,
+                Message: err instanceof Error ? err.message : String(err),
+                ...empty,
+            };
+        }
+    }
+};
+PriceOrderOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.PriceOrder')
+], PriceOrderOperation);
+export { PriceOrderOperation };
+/**
+ * Force the class registration. Tree-shaking removes a class nobody imports, and the decorator only
+ * runs if the module is loaded — so the server's bootstrap calls this.
+ */
+export function LoadPriceOrderOperation() {
+    // no-op by design
+}
+//# sourceMappingURL=PriceOrderOperation.js.map

package/dist/PriceOrderOperation.js.map

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

package/dist/ProductPriceEntityServer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ProductPrice server subclass — refuses an AMBIGUOUS rule set when it is written (plan D69).
+ *
+ * WHY AT WRITE TIME
+ * `PickPriceRule` reports a priority tie rather than resolving it, so an ambiguous set fails at
+ * ORDER time — which is the worst possible moment: a customer is waiting, the person who created
+ * the collision is elsewhere, and the failure looks like a bug in pricing rather than a gap in
+ * configuration. Catching it as the second rule is saved puts the error in front of the person who
+ * caused it, while they still have the context to fix it.
+ *
+ * It is deliberately NOT a database constraint. Ambiguity is not a property of a row — two rows are
+ * only ambiguous relative to a quantity and a moment, because non-overlapping quantity bands or
+ * disjoint seasons make equal priorities perfectly legitimate. A UNIQUE index would forbid a great
+ * deal of correct configuration to prevent one specific mistake.
+ *
+ * WHAT COUNTS AS A COLLISION
+ * Same product, same price list, same fee type, same priority, with OVERLAPPING quantity bands AND
+ * overlapping absolute windows. Recurrence is not considered: a monthly and a weekday rule can
+ * genuinely never coincide, and proving that here would mean reimplementing the applicability
+ * engine against every possible date. The order-time check remains the backstop for the cases this
+ * cannot see — this catches the common, obvious, avoidable ones.
+ *
+ * CONNECTS TO:
+ *   PURE:  ./PricingBehavior.ts (PickPriceRule — the reader this protects)
+ *   DOC:   plans/archive/pricing-schema.md
+ */
+import { ValidationResult } from '@memberjunction/core';
+import { mjBizAppsOrdersProductPriceEntity } from '@mj-biz-apps/orders-entities';
+export declare class ProductPriceEntityServer extends mjBizAppsOrdersProductPriceEntity {
+    /** BaseEntity skips ValidateAsync by default; without this the check never runs. */
+    get DefaultSkipAsyncValidation(): boolean;
+    ValidateAsync(): Promise<ValidationResult>;
+}
+//# sourceMappingURL=ProductPriceEntityServer.d.ts.map

package/dist/ProductPriceEntityServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductPriceEntityServer.d.ts","sourceRoot":"","sources":["../src/ProductPriceEntityServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAA8D,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEpH,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAqCjF,qBACa,wBAAyB,SAAQ,iCAAiC;IAC3E,oFAAoF;IACpF,IAAoB,0BAA0B,IAAI,OAAO,CAExD;IAEqB,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAmDnE"}

package/dist/ProductPriceEntityServer.js

@@ -0,0 +1,97 @@
+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;
+};
+/**
+ * ProductPrice server subclass — refuses an AMBIGUOUS rule set when it is written (plan D69).
+ *
+ * WHY AT WRITE TIME
+ * `PickPriceRule` reports a priority tie rather than resolving it, so an ambiguous set fails at
+ * ORDER time — which is the worst possible moment: a customer is waiting, the person who created
+ * the collision is elsewhere, and the failure looks like a bug in pricing rather than a gap in
+ * configuration. Catching it as the second rule is saved puts the error in front of the person who
+ * caused it, while they still have the context to fix it.
+ *
+ * It is deliberately NOT a database constraint. Ambiguity is not a property of a row — two rows are
+ * only ambiguous relative to a quantity and a moment, because non-overlapping quantity bands or
+ * disjoint seasons make equal priorities perfectly legitimate. A UNIQUE index would forbid a great
+ * deal of correct configuration to prevent one specific mistake.
+ *
+ * WHAT COUNTS AS A COLLISION
+ * Same product, same price list, same fee type, same priority, with OVERLAPPING quantity bands AND
+ * overlapping absolute windows. Recurrence is not considered: a monthly and a weekday rule can
+ * genuinely never coincide, and proving that here would mean reimplementing the applicability
+ * engine against every possible date. The order-time check remains the backstop for the cases this
+ * cannot see — this catches the common, obvious, avoidable ones.
+ *
+ * CONNECTS TO:
+ *   PURE:  ./PricingBehavior.ts (PickPriceRule — the reader this protects)
+ *   DOC:   plans/archive/pricing-schema.md
+ */
+import { BaseEntity, RunView, ValidationErrorInfo } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { mjBizAppsOrdersProductPriceEntity } from '@mj-biz-apps/orders-entities';
+const PRODUCT_PRICE_ENTITY = 'MJ_BizApps_Orders: Product Prices';
+/** Do two [min,max] bands overlap? Null bounds are open. */
+function bandsOverlap(aMin, aMax, bMin, bMax) {
+    const lo1 = aMin ?? -Infinity;
+    const hi1 = aMax ?? Infinity;
+    const lo2 = bMin ?? -Infinity;
+    const hi2 = bMax ?? Infinity;
+    return lo1 <= hi2 && lo2 <= hi1;
+}
+/** Do two date windows overlap? Null end is open. */
+function windowsOverlap(aFrom, aTo, bFrom, bTo) {
+    const s1 = new Date(aFrom).getTime();
+    const e1 = aTo ? new Date(aTo).getTime() : Infinity;
+    const s2 = new Date(bFrom).getTime();
+    const e2 = bTo ? new Date(bTo).getTime() : Infinity;
+    return s1 <= e2 && s2 <= e1;
+}
+let ProductPriceEntityServer = class ProductPriceEntityServer extends mjBizAppsOrdersProductPriceEntity {
+    /** BaseEntity skips ValidateAsync by default; without this the check never runs. */
+    get DefaultSkipAsyncValidation() {
+        return false;
+    }
+    async ValidateAsync() {
+        const result = await super.ValidateAsync();
+        if (this.Status !== 'Active')
+            return result; // an inactive rule collides with nothing
+        // Statically imported. A dynamic `import()` here violated the house rule and bought nothing:
+        // `@memberjunction/core` is already imported at the top of this file for BaseEntity.
+        const rv = new RunView(this.ProviderToUse);
+        const listClause = this.PriceListID ? `PriceListID = '${this.PriceListID}'` : `PriceListID IS NULL`;
+        const notSelf = this.IsSaved ? ` AND ID <> '${this.ID}'` : '';
+        const res = await rv.RunView({
+            EntityName: PRODUCT_PRICE_ENTITY,
+            ExtraFilter: `ProductID = '${this.ProductID}' AND Status = 'Active' AND ${listClause} ` +
+                `AND FeeType = '${String(this.FeeType).replace(/'/g, "''")}' ` +
+                `AND Priority = ${Number(this.Priority)}${notSelf}`,
+            ResultType: 'simple',
+            BypassCache: true,
+        }, this.ContextCurrentUser);
+        // Loud on failure: silently answering "no siblings" would let the ambiguity through, and the
+        // whole point is that the ambiguity is otherwise invisible until an order fails.
+        if (!res?.Success) {
+            throw new Error(`ProductPriceEntityServer: could not check for conflicting price rules: ${res?.ErrorMessage ?? 'unknown error'}`);
+        }
+        const clash = (res.Results ?? []).find((o) => bandsOverlap(this.MinQuantity, this.MaxQuantity, o.MinQuantity, o.MaxQuantity) &&
+            windowsOverlap(this.EffectiveFrom, this.EffectiveTo, o.EffectiveFrom, o.EffectiveTo));
+        if (clash) {
+            result.Success = false;
+            result.Errors.push(new ValidationErrorInfo('ProductPriceEntityServer.ValidateAsync', `This price rule collides with an existing one: both have priority ${this.Priority}, overlapping ` +
+                `quantity bands and overlapping effective windows for the same product, price list and fee ` +
+                `type. The other is ${clash.Description?.trim() || clash.ID}. Pricing resolves by highest ` +
+                `priority and refuses to break a tie, so an order using either quantity would fail. Give one ` +
+                `of them a different priority, narrow a quantity band, or separate the date windows.`, null));
+        }
+        return result;
+    }
+};
+ProductPriceEntityServer = __decorate([
+    RegisterClass(BaseEntity, PRODUCT_PRICE_ENTITY)
+], ProductPriceEntityServer);
+export { ProductPriceEntityServer };
+//# sourceMappingURL=ProductPriceEntityServer.js.map

package/dist/ProductPriceEntityServer.js.map

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

package/dist/RefundPaymentOperation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Orders.RefundPayment — refund a captured payment, atomically (plan D17).
+ *
+ * WHAT A REFUND IS HERE
+ * A NEW `PaymentHeader` that reverses an existing one, not an edit of the original. The original
+ * capture is history: it happened, it has a journal entry, and rewriting it would destroy the audit
+ * trail of money that genuinely moved. `ReversesPaymentHeaderID` links the two.
+ *
+ * The reversal carries `Status='Refunded'`, which is what makes `PaymentHeaderEntityServer` book the
+ * MIRROR of the capture entry (D53): `Dr AR / Cr Cash`, positive amounts. The receivable comes back,
+ * the bank goes down. The reversal's `PaymentLine` then un-applies the cash from the order, and the
+ * rollup triggers move `Balance` / `PaymentStatus` back on their own (D41).
+ *
+ * THE GUARDS, all of which are the reason this is an operation and not a form:
+ *   - the payment must exist and be `Captured` — a Pending or Failed payment never took money
+ *   - never more than was captured, counting refunds already issued (partial refunds accumulate)
+ *   - never a second full refund of the same payment
+ *   - the refund's applications mirror the original's, so a payment split across three orders
+ *     refunds proportionally rather than dumping the whole reversal on the first one
+ *
+ * FAILURE MODEL: logical refusals come back INSIDE the output as `Success: false` with a reason —
+ * the same contract accounting's operations and `Orders.CancelSubscription` use. Only genuine faults
+ * throw.
+ *
+ * CONNECTS TO:
+ *   BOOKING: PaymentHeaderEntityServer.Save — the reversal books through the ordinary path
+ *   TABLES:  __mj_BizAppsOrders.{PaymentHeader,PaymentLine,PaymentDetail}
+ */
+import { BaseRemotableOperation, IMetadataProvider, UserInfo } from '@memberjunction/core';
+export interface RefundPaymentInput {
+    PaymentHeaderID: string;
+    /** Omit for a full refund of whatever remains refundable. */
+    Amount?: number;
+    Reason?: string;
+    /** Provider's refund id, when the money moved through one. */
+    ProviderRefundID?: string;
+    /** Compute and validate without writing — for a confirmation screen. */
+    Preview?: boolean;
+}
+export interface RefundPaymentOutput {
+    Success: boolean;
+    Message?: string;
+    /** What was (or would be) refunded. */
+    RefundAmount?: number;
+    /** Still refundable AFTER this refund. */
+    RemainingRefundable?: number;
+    RefundPaymentHeaderID?: string;
+    RefundPaymentNumber?: string;
+    /** The reversing journal entry, when one was booked. */
+    JournalEntryID?: string;
+}
+export declare class RefundPaymentOperation extends BaseRemotableOperation<RefundPaymentInput, RefundPaymentOutput> {
+    OperationKey: string;
+    protected InternalExecute(input: RefundPaymentInput, provider: IMetadataProvider, user: UserInfo): Promise<RefundPaymentOutput>;
+    private loadPayment;
+    /** Total already refunded against this payment — partial refunds accumulate. */
+    private refundedSoFar;
+}
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export declare function LoadRefundPaymentOperation(): void;
+//# sourceMappingURL=RefundPaymentOperation.d.ts.map

package/dist/RefundPaymentOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RefundPaymentOperation.d.ts","sourceRoot":"","sources":["../src/RefundPaymentOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EACH,sBAAsB,EAEtB,iBAAiB,EAIjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAY9B,MAAM,WAAW,kBAAkB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAiBD,qBACa,sBAAuB,SAAQ,sBAAsB,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;IAChG,YAAY,SAA0B;cAE7B,eAAe,CAC3B,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,mBAAmB,CAAC;YAyGjB,WAAW;IA8BzB,gFAAgF;YAClE,aAAa;CAc9B;AAED,8FAA8F;AAC9F,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/RefundPaymentOperation.js

@@ -0,0 +1,177 @@
+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;
+};
+/**
+ * Orders.RefundPayment — refund a captured payment, atomically (plan D17).
+ *
+ * WHAT A REFUND IS HERE
+ * A NEW `PaymentHeader` that reverses an existing one, not an edit of the original. The original
+ * capture is history: it happened, it has a journal entry, and rewriting it would destroy the audit
+ * trail of money that genuinely moved. `ReversesPaymentHeaderID` links the two.
+ *
+ * The reversal carries `Status='Refunded'`, which is what makes `PaymentHeaderEntityServer` book the
+ * MIRROR of the capture entry (D53): `Dr AR / Cr Cash`, positive amounts. The receivable comes back,
+ * the bank goes down. The reversal's `PaymentLine` then un-applies the cash from the order, and the
+ * rollup triggers move `Balance` / `PaymentStatus` back on their own (D41).
+ *
+ * THE GUARDS, all of which are the reason this is an operation and not a form:
+ *   - the payment must exist and be `Captured` — a Pending or Failed payment never took money
+ *   - never more than was captured, counting refunds already issued (partial refunds accumulate)
+ *   - never a second full refund of the same payment
+ *   - the refund's applications mirror the original's, so a payment split across three orders
+ *     refunds proportionally rather than dumping the whole reversal on the first one
+ *
+ * FAILURE MODEL: logical refusals come back INSIDE the output as `Success: false` with a reason —
+ * the same contract accounting's operations and `Orders.CancelSubscription` use. Only genuine faults
+ * throw.
+ *
+ * CONNECTS TO:
+ *   BOOKING: PaymentHeaderEntityServer.Save — the reversal books through the ordinary path
+ *   TABLES:  __mj_BizAppsOrders.{PaymentHeader,PaymentLine,PaymentDetail}
+ */
+import { BaseRemotableOperation, LogError, RunView, } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { RequireUUID } from './sql-guards.js';
+import { BuildUnapplyLines, CreateReversingPayment, LoadAppliedAllocations, } from './PaymentReversalFactory.js';
+const PAYMENT_HEADER_ENTITY = 'MJ_BizApps_Orders: Payment Headers';
+const money = (v) => Math.round((v + Number.EPSILON) * 100) / 100;
+let RefundPaymentOperation = class RefundPaymentOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'Orders.RefundPayment';
+    }
+    async InternalExecute(input, provider, user) {
+        // Caller-supplied ids reach SQL filter text downstream. Validated here,
+        // at the boundary, so every frame below this one can trust them.
+        RequireUUID(input.PaymentHeaderID, 'PaymentHeaderID');
+        const payment = await this.loadPayment(provider, user, input.PaymentHeaderID);
+        if (!payment) {
+            return { Success: false, Message: `No payment found with ID '${input.PaymentHeaderID}'.` };
+        }
+        if (payment.Status !== 'Captured') {
+            return {
+                Success: false,
+                Message: `Payment ${payment.PaymentNumber} is ${payment.Status}, not Captured. ` +
+                    `Only a captured payment has money to refund.`,
+            };
+        }
+        const alreadyRefunded = await this.refundedSoFar(provider, user, payment.ID);
+        const refundable = money(payment.Amount - alreadyRefunded);
+        if (refundable <= 0) {
+            return {
+                Success: false,
+                Message: `Payment ${payment.PaymentNumber} has already been fully refunded ` +
+                    `(${alreadyRefunded} of ${payment.Amount}).`,
+                RemainingRefundable: 0,
+            };
+        }
+        const requested = money(input.Amount ?? refundable);
+        if (requested <= 0) {
+            return { Success: false, Message: `A refund must be greater than zero, got ${requested}.` };
+        }
+        if (requested > refundable) {
+            return {
+                Success: false,
+                Message: `Cannot refund ${requested} of payment ${payment.PaymentNumber}: only ${refundable} ` +
+                    `remains refundable (${payment.Amount} captured, ${alreadyRefunded} already refunded).`,
+                RemainingRefundable: refundable,
+            };
+        }
+        const applications = await LoadAppliedAllocations(provider, user, payment.ID);
+        if (applications.length === 0) {
+            return {
+                Success: false,
+                Message: `Payment ${payment.PaymentNumber} is not applied to any order, so there is nothing ` +
+                    `to un-apply. Refund it at the provider instead.`,
+            };
+        }
+        if (input.Preview) {
+            return {
+                Success: true,
+                Message: `${requested} of ${payment.PaymentNumber} is refundable.`,
+                RefundAmount: requested,
+                RemainingRefundable: money(refundable - requested),
+            };
+        }
+        const dbProvider = provider;
+        await dbProvider.BeginTransaction();
+        try {
+            // The un-apply lines are built BEFORE the header is saved and ride its Lines collection,
+            // because the header's save is what checks the D68 invariant — saving it first with no
+            // allocations would fail on a payment that is about to be perfectly consistent.
+            const lines = await BuildUnapplyLines(provider, user, applications, requested);
+            const refund = await CreateReversingPayment(provider, user, payment, {
+                Amount: requested,
+                Reason: input.Reason ?? null,
+                ProviderRefundID: input.ProviderRefundID ?? null,
+            }, lines);
+            await dbProvider.CommitTransaction();
+            return {
+                Success: true,
+                Message: `Refunded ${requested} of payment ${payment.PaymentNumber} as ${refund.Number}.`,
+                RefundAmount: requested,
+                RemainingRefundable: money(refundable - requested),
+                RefundPaymentHeaderID: refund.ID,
+                RefundPaymentNumber: refund.Number,
+                JournalEntryID: refund.JournalEntryID,
+            };
+        }
+        catch (err) {
+            LogError(`Orders.RefundPayment failed for ${input.PaymentHeaderID}: ${err}`);
+            try {
+                await dbProvider.RollbackTransaction();
+            }
+            catch (rollbackErr) {
+                LogError(`Rollback failed after refund error: ${rollbackErr}`);
+            }
+            return { Success: false, Message: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    // ─── Reads ─────────────────────────────────────────────────────────────────
+    async loadPayment(provider, user, id) {
+        const rv = new RunView(provider);
+        const result = await rv.RunView({
+            EntityName: PAYMENT_HEADER_ENTITY,
+            ExtraFilter: `ID='${id}'`,
+            Fields: [
+                'ID',
+                'PaymentNumber',
+                'ReceivingCompanyID',
+                'BillToOrganizationID',
+                'BillToPersonID',
+                'PaymentTypeID',
+                'PaymentDetailID',
+                'Amount',
+                'ProcessingFeeAmount',
+                'Status',
+            ],
+            ResultType: 'simple',
+            BypassCache: true,
+        }, user);
+        return result?.Results?.[0] ?? null;
+    }
+    /** Total already refunded against this payment — partial refunds accumulate. */
+    async refundedSoFar(provider, user, paymentID) {
+        const rv = new RunView(provider);
+        const result = await rv.RunView({
+            EntityName: PAYMENT_HEADER_ENTITY,
+            ExtraFilter: `ReversesPaymentHeaderID='${paymentID}' AND Status='Refunded'`,
+            Fields: ['Amount'],
+            ResultType: 'simple',
+            BypassCache: true,
+        }, user);
+        return money((result?.Results ?? []).reduce((sum, r) => sum + Math.abs(Number(r.Amount ?? 0)), 0));
+    }
+};
+RefundPaymentOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.RefundPayment')
+], RefundPaymentOperation);
+export { RefundPaymentOperation };
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export function LoadRefundPaymentOperation() {
+    // intentionally empty
+}
+//# sourceMappingURL=RefundPaymentOperation.js.map

package/dist/RefundPaymentOperation.js.map

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

package/dist/RevenueRecognition.d.ts

@@ -0,0 +1,76 @@
+/** What a driver is given. Deliberately plain data — no entities, no provider, no I/O. */
+export interface RevRecContext {
+    /** The line's net amount to be recognized (after discount, before tax). */
+    Amount: number;
+    /** The order's accounting date — when the sale was booked. */
+    BookingDate: Date;
+    /** Coverage window, when the line has one (subscriptions, services). */
+    ServicePeriodStart?: Date | null;
+    ServicePeriodEnd?: Date | null;
+    /** For informative descriptions only. */
+    ProductName?: string;
+    /**
+     * Months per recognition slice (D45 `RecognitionCadence`). Absent = monthly. This is how a
+     * subscription that recognizes QUARTERLY gets 4 slices a year instead of 12 — the cadence is
+     * the subscription type's rule, not the driver's assumption.
+     */
+    PeriodMonths?: number;
+}
+export interface RevRecEntry {
+    /** The date this slice is earned — becomes the JE's EffectiveDate. */
+    RecognitionDate: Date;
+    Amount: number;
+    /** Period bounds. They land on the forward-dated journal entry, which IS the schedule (D84). */
+    PeriodStart: Date;
+    PeriodEnd: Date;
+}
+export interface RevRecSchedule {
+    Entries: RevRecEntry[];
+}
+/**
+ * Base driver. Subclass, override `BuildSchedule` (or just the protected helpers), and register
+ * under an existing key to replace a shipped type:
+ *
+ *     @RegisterClass(RevenueRecognitionDriver, 'EvenOverTime')
+ *     export class OurEvenOverTime extends EvenOverTimeDriver { ... }
+ */
+export declare abstract class RevenueRecognitionDriver {
+    /** Compute when and how much is earned. Pure: no I/O, no side effects. */
+    abstract BuildSchedule(context: RevRecContext): RevRecSchedule;
+    /**
+     * Split `amount` across `periods`, front-loading the rounding remainder into the first period
+     * so the slices always sum EXACTLY to the amount.
+     */
+    protected AllocateEvenly(amount: number, periods: number): number[];
+    /** Whole months between two dates, minimum 1. */
+    protected MonthSpan(start: Date, end: Date): number;
+    protected RequireServicePeriod(context: RevRecContext, driver: string): {
+        start: Date;
+        end: Date;
+    };
+}
+/**
+ * UpFront — 100% earned when the sale is booked. One-time goods and services.
+ * The booking entry credits Sales directly; there is no deferral round-trip.
+ */
+export declare class UpFrontDriver extends RevenueRecognitionDriver {
+    BuildSchedule(context: RevRecContext): RevRecSchedule;
+}
+/**
+ * EvenOverTime — straight-line across the line's service period. Most subscriptions.
+ * A 12-month $1,200 subscription produces 12 monthly $100 entries dated on the anniversaries.
+ */
+export declare class EvenOverTimeDriver extends RevenueRecognitionDriver {
+    BuildSchedule(context: RevRecContext): RevRecSchedule;
+}
+/**
+ * AllBackEnd — 100% earned on the END date. Events and milestone deliverables, where nothing is
+ * earned until the thing actually happens: cash is collected up front and sits in Deferred Revenue
+ * until the event date.
+ */
+export declare class AllBackEndDriver extends RevenueRecognitionDriver {
+    BuildSchedule(context: RevRecContext): RevRecSchedule;
+}
+/** Tree-shaking anchor — the shipped drivers must be registered before booking runs. */
+export declare function LoadRevenueRecognitionDrivers(): void;
+//# sourceMappingURL=RevenueRecognition.d.ts.map

package/dist/RevenueRecognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevenueRecognition.d.ts","sourceRoot":"","sources":["../src/RevenueRecognition.ts"],"names":[],"mappings":"AA0BA,0FAA0F;AAC1F,MAAM,WAAW,aAAa;IAC1B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,EAAE,IAAI,CAAC;IAClB,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,sEAAsE;IACtE,eAAe,EAAE,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;CAC1B;AAcD;;;;;;GAMG;AACH,8BAAsB,wBAAwB;IAC1C,0EAA0E;aAC1D,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc;IAErE;;;OAGG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAQnE,iDAAiD;IACjD,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM;IAMnD,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE;CAUrG;AAED;;;GAGG;AACH,qBACa,aAAc,SAAQ,wBAAwB;IAChD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc;CAI/D;AAED;;;GAGG;AACH,qBACa,kBAAmB,SAAQ,wBAAwB;IACrD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc;CAc/D;AAED;;;;GAIG;AACH,qBACa,gBAAiB,SAAQ,wBAAwB;IACnD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc;CAI/D;AAED,wFAAwF;AACxF,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}