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

package/dist/lib/services/pricing-scheduler.service.js

@@ -0,0 +1,292 @@
+import { Injectable } from '@angular/core';
+import { Metadata } from '@memberjunction/core';
+import { MJO_ENTITIES } from '../data/entity-names.js';
+import { CanPriceOrderLocally, OrderPricingService, OrdersPriceOrderOperation } from '@mj-biz-apps/orders-entities';
+import * as i0 from "@angular/core";
+/**
+ * `MJOPricingScheduler` — the seam between a draft and the engine.
+ *
+ * Every screen that composes an order goes through here, so the debounce, the
+ * out-of-order guard and the staleness bookkeeping exist once instead of in each
+ * screen that happens to need them.
+ *
+ * ## How pricing works here, and why it is not a preview
+ *
+ * This used to call `Orders.PreviewOrder`, which performed a REAL save inside a
+ * transaction that always rolled back and read the computed values off the
+ * entities before they vanished. 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 the result, so a failure in a run nobody would ever
+ * read blocked the run that mattered.
+ *
+ * It now calls **`Orders.PriceOrder`**, which runs `OrderPricingService` — the same
+ * walk `Save()` uses — and writes nothing. `Orders.PreviewPrice` is a one-line
+ * wrapper around that same service, not a second resolver.
+ *
+ * WHY DEBOUNCE AND SEQUENCE-GUARD (unchanged, and still necessary). Pricing is a
+ * server round trip fired as the user types. Two things go wrong without care, and
+ * both show a wrong number rather than an obvious failure:
+ *
+ * - **Too many calls.** Un-debounced, every keystroke prices every line.
+ * - **Out-of-order responses.** Request 3 can return after request 4. Applying it
+ *   would show prices for a draft the user has already moved past — stale money
+ *   presented as current. Every response carries the sequence number it was issued
+ *   with, and anything not from the newest request is discarded.
+ *
+ * Provided in root: the debounce state is per-draft, not per-service, so one
+ * instance serves the whole app.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * const order = await md.GetEntityObject<OrderHeaderEntity>(MJO_ENTITIES.OrderHeader);
+ * this.stop = draft.Subscribe(() => this.orders.SchedulePricing(draft, s => this.Pricing = s));
+ * ```
+ */
+export class MJOPricingScheduler {
+    /** Milliseconds of quiet before a pricing pass fires. */
+    DebounceMs = 350;
+    sequence = 0;
+    applied = 0;
+    timer = null;
+    /**
+     * Price a draft's lines after a quiet period, calling back with each state change.
+     *
+     * Calling again before the timer elapses replaces the pending request rather
+     * than queueing another — the user is still typing, and only the final state
+     * is worth asking about.
+     */
+    SchedulePricing(order, onState) {
+        if (this.timer)
+            clearTimeout(this.timer);
+        // Announce immediately that what is on screen no longer matches the draft,
+        // so the strip dims now rather than after the round trip.
+        onState({ Result: null, Loading: true, Error: null });
+        this.timer = setTimeout(() => {
+            void this.PriceNow(order, onState);
+        }, this.DebounceMs);
+    }
+    /**
+     * Price a draft's lines immediately, bypassing the debounce.
+     *
+     * ## Locally when it can, on the server when it must
+     *
+     * `OrderPricingService` runs in this browser — it lives in the entities package and uses nothing
+     * but `RunView`, which is network-transparent. So the common order prices with no round trip at
+     * all: the metadata walk reads price rules, tiers, charge types and tax tables through the
+     * provider and answers immediately.
+     *
+     * Two things it cannot do here, and both must ESCALATE rather than be approximated:
+     *
+     *   · a **pricing plugin**. `BasePriceResolver` subclasses are server-side code, and the class
+     *     factory on this tier has none of them registered — so `ResolvePrice` would fall through to
+     *     the DEFAULT resolver and return a confident, wrong number. `CanPriceOrderLocally` reads the
+     *     `PricingDriverClass` metadata to find out before that happens.
+     *   · a **promotion code**. Whether a code still applies depends on redemption counts that change
+     *     with orders other people are placing right now. No staleness is acceptable for that, so any
+     *     code at all sends the whole pass to the server.
+     *
+     * The escalation is all-or-nothing because pricing is not per-line arithmetic: promotions stack
+     * against order totals, charges apportion across lines, tax computes on the discounted amount. An
+     * order half-priced here and half there would disagree with itself about the same totals.
+     *
+     * Either way the answer comes from ONE implementation, which is the property the whole
+     * arrangement exists to preserve.
+     */
+    async PriceNow(order, onState) {
+        if (!order.Lines.Count) {
+            onState({ Result: null, Loading: false, Error: null });
+            return;
+        }
+        const issued = ++this.sequence;
+        try {
+            const local = await this.priceLocally(order, issued, onState);
+            if (local)
+                return;
+            // ONE round trip for the WHOLE order, not one per line.
+            //
+            // This used to fan out a PreviewPrice call per line and sum the answers, which cannot be
+            // right however fast it is: promotions stack against ORDER totals, charges apportion
+            // ACROSS lines, and tax computes on the discounted amount. A per-line answer is blind to
+            // all three, which is why PreviewPrice's own description calls its result advisory.
+            //
+            // `Orders.PriceOrder` runs the same OrderPricingService the booking walk runs, so what
+            // the screen shows and what the ledger books come from one implementation.
+            const op = new OrdersPriceOrderOperation();
+            const result = await op.Execute({
+                OrderHeaderID: order.ID ?? null,
+                CompanyID: order.CompanyID,
+                BillToPersonID: order.BillToPersonID ?? null,
+                BillToOrganizationID: order.BillToOrganizationID ?? null,
+                OrderDate: order.OrderDate ? new Date(order.OrderDate).toISOString() : null,
+                ShipToAddressID: order.ShipToAddressID ?? null,
+                Lines: order.Lines.Items.map((l) => ({
+                    ProductID: l.ProductID,
+                    Quantity: Number(l.Quantity ?? 0),
+                    // A STATED price is passed through and PINS the line. An absent one is what
+                    // tells the engine to resolve — sending 0 would read as a deliberate free line.
+                    UnitPrice: l.GetFieldByName('UnitPrice')?.Dirty ? Number(l.UnitPrice) : null,
+                    DiscountPct: Number(l.DiscountPct ?? 0),
+                })),
+                PromotionCodes: order.PromotionCodes.Codes,
+            });
+            // Discard anything overtaken by a newer request.
+            if (issued <= this.applied)
+                return;
+            this.applied = issued;
+            if (!result.Success || !result.Output?.Success) {
+                onState({
+                    Result: null,
+                    Loading: false,
+                    Error: result.Output?.Message ?? result.ErrorMessage ?? 'The order could not be priced.',
+                });
+                return;
+            }
+            onState({ Result: this.summarize(order, result.Output), Loading: false, Error: null });
+        }
+        catch (e) {
+            if (issued <= this.applied)
+                return;
+            this.applied = issued;
+            onState({
+                Result: null,
+                Loading: false,
+                Error: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    /**
+     * Run the real pricing walk in this browser, or report that it cannot.
+     *
+     * @returns True when it priced and reported state; false when the caller must escalate.
+     */
+    async priceLocally(order, issued, onState) {
+        // A code sends the whole pass to the server: redemption caps and per-customer limits change
+        // with orders being placed right now, and there is no staleness that makes a cached answer
+        // safe. This is checked first because it is free.
+        if (order.PromotionCodes.Codes.length)
+            return false;
+        if (!order.CompanyID)
+            return false;
+        const md = new Metadata();
+        const provider = Metadata.Provider;
+        const verdict = await CanPriceOrderLocally(order.Lines.Items.map((l) => l.ProductID), order.CompanyID, provider, md.CurrentUser);
+        if (!verdict.CanPriceLocally)
+            return false;
+        // REAL LINE ENTITIES, NEVER SAVED — the same shape `Orders.PriceOrder` builds server-side,
+        // because it is the same walk. `NewRecord()` is called and `Save()` is not.
+        const lines = [];
+        for (const source of order.Lines.Items) {
+            const line = await md.GetEntityObject(MJO_ENTITIES.OrderLine);
+            line.NewRecord();
+            line.ProductID = source.ProductID;
+            line.Quantity = Number(source.Quantity ?? 0);
+            // A STATED price PINS the line; an absent one is what tells the engine to resolve.
+            // Assigning 0 would read as a deliberate free line.
+            if (source.GetFieldByName('UnitPrice')?.Dirty)
+                line.UnitPrice = Number(source.UnitPrice);
+            line.DiscountPct = Number(source.DiscountPct ?? 0);
+            lines.push(line);
+        }
+        const result = await new OrderPricingService({
+            Provider: Metadata.Provider,
+            User: md.CurrentUser,
+        }).Price({
+            OrderHeaderID: order.ID ?? null,
+            CompanyID: order.CompanyID,
+            BillToPersonID: order.BillToPersonID ?? null,
+            BillToOrganizationID: order.BillToOrganizationID ?? null,
+            OrderDate: order.OrderDate ?? null,
+            ShipToAddressID: order.ShipToAddressID ?? null,
+            Lines: lines,
+            PromotionCodes: [],
+            ManualDiscounts: [],
+            Charges: [],
+        });
+        if (issued <= this.applied)
+            return true; // overtaken, but it WAS handled
+        this.applied = issued;
+        // Read back off the entities the walk just stamped — the same fields `Orders.PriceOrder`
+        // reads before returning, so the two paths produce the same summary from the same numbers.
+        const priced = lines.map((line, i) => ({
+            UnitPrice: Number(line.UnitPrice ?? 0),
+            DiscountAmount: Number(line.DiscountAmount ?? 0),
+            LineTotalNet: Math.round((Number(line.Quantity ?? 0) * Number(line.UnitPrice ?? 0) - Number(line.DiscountAmount ?? 0)) * 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;
+        onState({
+            Result: this.summarize(order, {
+                Lines: priced,
+                Totals: {
+                    Net: sum((l) => l.LineTotalNet),
+                    Discount: sum((l) => l.DiscountAmount),
+                    Gross: sum((l) => l.LineTotalNet),
+                },
+            }),
+            Loading: false,
+            Error: null,
+        });
+        return true;
+    }
+    /**
+     * Turn the engine's answer into what the strip renders.
+     *
+     * Totals come from the SERVER's figures rather than being re-added here. Summing on the client
+     * is how the screen and the ledger drift: the engine apportions discounts and charges across
+     * lines with its own rounding, and a second addition in a different order lands a penny out.
+     */
+    summarize(order, out) {
+        const lines = out.Lines.map((priced, i) => {
+            const line = order.Lines.Items[i];
+            const stated = line?.GetFieldByName('UnitPrice')?.Dirty === true;
+            const extended = round(Number(priced.UnitPrice) * Number(line?.Quantity ?? 0));
+            return {
+                // Positional: an unsaved line has no id, and the engine answers by position.
+                ClientKey: line?.ID ?? String(i),
+                ExtendedAmount: extended,
+                UnitPrice: Number(priced.UnitPrice),
+                NetAmount: Number(priced.LineTotalNet),
+                PriceListName: null,
+                Error: null,
+                // Null means "priced and found nothing", which the badge renders as *no price rule*.
+                // A resolved price with no list is base pricing, and must not read as unpriced.
+                PriceSource: priced.UnitPrice > 0 ? (stated ? 'stated' : 'base price') : null,
+                Components: (priced.Components ?? []),
+                WasStated: stated,
+            };
+        });
+        return {
+            Lines: lines,
+            Totals: {
+                ListSubtotal: round(out.Totals.Net + out.Totals.Discount),
+                DiscountTotal: round(out.Totals.Discount),
+                NetTotal: round(out.Totals.Net),
+                GrossTotal: round(out.Totals.Gross),
+            },
+            HasUnpricedLines: lines.some((l) => l.UnitPrice === null || l.UnitPrice === 0),
+        };
+    }
+    CancelPending() {
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+    }
+    static ɵfac = function MJOPricingScheduler_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || MJOPricingScheduler)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: MJOPricingScheduler, factory: MJOPricingScheduler.ɵfac, providedIn: 'root' });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(MJOPricingScheduler, [{
+        type: Injectable,
+        args: [{ providedIn: 'root' }]
+    }], null, null); })();
+/** Round to cents the way the engine does, so client and server agree on the last penny. */
+function round(value) {
+    return Math.round((Number(value) + Number.EPSILON) * 100) / 100;
+}
+//# sourceMappingURL=pricing-scheduler.service.js.map

package/dist/lib/services/pricing-scheduler.service.js.map

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

package/dist/lib/services/save-error.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Turning a save rejection into something a person can act on.
+ *
+ * Lives here rather than in the page it serves, for two reasons. It is pure —
+ * no Angular, no injection — so it is testable as a plain function, and putting
+ * it in the component file meant a unit test importing it dragged the whole
+ * component graph in and demanded the JIT compiler. And more than one screen
+ * saves an order, so more than one will want the same treatment.
+ */
+/**
+ * Turn a save rejection into a sentence a person can act on.
+ *
+ * The save path throws with a SERIALISED validation result, so the raw
+ * `error.message` is a JSON blob — a user clicking Save saw
+ * `{"Source":"OrderNumber","Message":"Order Number cannot be null","Value":null,
+ * "Type":"Failure"}` across the footer. Everything they needed was the one
+ * sentence buried in the middle of it.
+ *
+ * Falls back to the raw text whenever the shape is not what we expect. An
+ * unparseable error is still better shown than swallowed — the point is to
+ * prefer the readable form, never to hide information.
+ */
+export declare function ReadableSaveError(error: unknown): string;
+//# sourceMappingURL=save-error.d.ts.map

package/dist/lib/services/save-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-error.d.ts","sourceRoot":"","sources":["../../../src/lib/services/save-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBxD"}

package/dist/lib/services/save-error.js

@@ -0,0 +1,47 @@
+/**
+ * Turning a save rejection into something a person can act on.
+ *
+ * Lives here rather than in the page it serves, for two reasons. It is pure —
+ * no Angular, no injection — so it is testable as a plain function, and putting
+ * it in the component file meant a unit test importing it dragged the whole
+ * component graph in and demanded the JIT compiler. And more than one screen
+ * saves an order, so more than one will want the same treatment.
+ */
+/**
+ * Turn a save rejection into a sentence a person can act on.
+ *
+ * The save path throws with a SERIALISED validation result, so the raw
+ * `error.message` is a JSON blob — a user clicking Save saw
+ * `{"Source":"OrderNumber","Message":"Order Number cannot be null","Value":null,
+ * "Type":"Failure"}` across the footer. Everything they needed was the one
+ * sentence buried in the middle of it.
+ *
+ * Falls back to the raw text whenever the shape is not what we expect. An
+ * unparseable error is still better shown than swallowed — the point is to
+ * prefer the readable form, never to hide information.
+ */
+export function ReadableSaveError(error) {
+    const raw = error instanceof Error ? error.message : String(error);
+    // Whichever bracket comes FIRST. Preferring '{' looked equivalent and was not:
+    // for an ARRAY of failures it sliced from the inner brace, leaving a trailing
+    // "},{...}]" that could not parse — so a multi-complaint save, the case most in
+    // need of tidying, was the one that fell back to raw JSON.
+    const brace = raw.indexOf('{');
+    const bracket = raw.indexOf('[');
+    const start = brace < 0 ? bracket : bracket < 0 ? brace : Math.min(brace, bracket);
+    if (start < 0)
+        return raw;
+    try {
+        const parsed = JSON.parse(raw.slice(start));
+        const failures = Array.isArray(parsed) ? parsed : [parsed];
+        const messages = failures.map((f) => f?.Message).filter((m) => !!m);
+        // Several complaints read as a list, not one run-on sentence.
+        if (messages.length)
+            return messages.join(' · ');
+    }
+    catch {
+        // Not JSON after all — fall through to the raw text.
+    }
+    return raw;
+}
+//# sourceMappingURL=save-error.js.map

package/dist/lib/services/save-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-error.js","sourceRoot":"","sources":["../../../src/lib/services/save-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,+EAA+E;IAC/E,8EAA8E;IAC9E,gFAAgF;IAChF,2DAA2D;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnF,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1B,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAqB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAwB,CAAC,CAAC;QAC/F,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,8DAA8D;QAC9D,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACL,qDAAqD;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}