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

package/dist/lib/panels/order-stages.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview Order lifecycle rules — pure, no Angular.
+ *
+ * Separate from the stepper COMPONENT on purpose. These rules mirror what the
+ * database triggers enforce, so they are the kind of logic that quietly diverges
+ * from the server's view of the same question — which makes them exactly the
+ * logic that should be unit-testable without a rendering environment.
+ *
+ * 3-way orthogonal model:
+ * 1. Commercial Status: Draft -> Quoted -> Confirmed; Voided <-> Draft/Quoted
+ * 2. Operational Fulfillment: Pending | PartiallyFulfilled | Fulfilled | NotApplicable | Returned
+ * 3. Payment: Real-time numeric balance
+ *
+ * @module @mj-biz-apps/orders-ng
+ */
+import type { mjBizAppsOrdersOrderHeaderEntity } from '@mj-biz-apps/orders-entities';
+/** The fixed order commercial stages. */
+export type MJOOrderStage = mjBizAppsOrdersOrderHeaderEntity['Status'];
+/** One stage as the stepper renders it. */
+export interface MJOStepperStage {
+    Stage: MJOOrderStage;
+    /** Whether this stage can be moved to from where the order is now. */
+    Reachable: boolean;
+    /**
+     * Why it cannot be reached, or what reaching it does. Shown as a tooltip — a
+     * disabled control that does not say why is just a dead end.
+     */
+    Note?: string | null;
+}
+/**
+ * Fired before a stage change is applied. Set `Cancel = true` to stop it.
+ *
+ * Follows MJ's Before/After cancelable event pattern: the `Before*` event carries
+ * a `Cancel` flag the listener flips, and the matching `After*` only fires on the
+ * non-canceled path.
+ */
+export declare class MJOStageChangeRequestEventArgs {
+    readonly From: MJOOrderStage;
+    readonly To: MJOOrderStage;
+    /** Set `true` to stop the move. `StageChanged` will not fire. */
+    Cancel: boolean;
+    /** Free-form, for telemetry and debugging. */
+    CancelReason?: string;
+    constructor(From: MJOOrderStage, To: MJOOrderStage);
+}
+/**
+ * The stage list for an order at a given status, with reachability applied and
+ * every blocked stage carrying its reason.
+ *
+ * The rules, and why each is what it is:
+ *
+ * - **Forward skipping is legal.** Draft straight to Confirmed is a real thing
+ *   people do; what is fixed is the ORDER of stages, not that each must be
+ *   visited.
+ * - **Nothing is reachable once confirmed.** After booking, corrections are
+ *   reversing orders rather than status changes.
+ * - **Voided is reachable only from Draft or Quoted**, and an unconfirmed voided order
+ *   can be reopened as Draft or Quoted.
+ *
+ * @param current Where the order is.
+ */
+export declare function BuildOrderStages(current: MJOOrderStage, _requiresFulfillment?: boolean): MJOStepperStage[];
+/**
+ * The verbs that actually apply to an order in a given state.
+ *
+ * Edit gating shows the state's REAL actions rather than a disabled Save: a
+ * confirmed order offers "Create reversal", not a greyed-out edit control that
+ * leaves the user guessing what they are allowed to do.
+ */
+export declare function ActionsForStage(current: MJOOrderStage): Array<{
+    Key: string;
+    Label: string;
+    Danger?: boolean;
+}>;
+//# sourceMappingURL=order-stages.d.ts.map

package/dist/lib/panels/order-stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-stages.d.ts","sourceRoot":"","sources":["../../../src/lib/panels/order-stages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAErF,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG,gCAAgC,CAAC,QAAQ,CAAC,CAAC;AAEvE,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,8BAA8B;aAMnB,IAAI,EAAE,aAAa;aACnB,EAAE,EAAE,aAAa;IANrC,iEAAiE;IAC1D,MAAM,UAAS;IACtB,8CAA8C;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa;CAExC;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,aAAa,EACtB,oBAAoB,CAAC,EAAE,OAAO,GAC/B,eAAe,EAAE,CA+BnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAwB/G"}

package/dist/lib/panels/order-stages.js

@@ -0,0 +1,100 @@
+/**
+ * Fired before a stage change is applied. Set `Cancel = true` to stop it.
+ *
+ * Follows MJ's Before/After cancelable event pattern: the `Before*` event carries
+ * a `Cancel` flag the listener flips, and the matching `After*` only fires on the
+ * non-canceled path.
+ */
+export class MJOStageChangeRequestEventArgs {
+    From;
+    To;
+    /** Set `true` to stop the move. `StageChanged` will not fire. */
+    Cancel = false;
+    /** Free-form, for telemetry and debugging. */
+    CancelReason;
+    constructor(From, To) {
+        this.From = From;
+        this.To = To;
+    }
+}
+/** The commercial stage progression, excluding the terminal `Voided`. */
+const STAGE_ORDER = ['Draft', 'Quoted', 'Confirmed'];
+/**
+ * The stage list for an order at a given status, with reachability applied and
+ * every blocked stage carrying its reason.
+ *
+ * The rules, and why each is what it is:
+ *
+ * - **Forward skipping is legal.** Draft straight to Confirmed is a real thing
+ *   people do; what is fixed is the ORDER of stages, not that each must be
+ *   visited.
+ * - **Nothing is reachable once confirmed.** After booking, corrections are
+ *   reversing orders rather than status changes.
+ * - **Voided is reachable only from Draft or Quoted**, and an unconfirmed voided order
+ *   can be reopened as Draft or Quoted.
+ *
+ * @param current Where the order is.
+ */
+export function BuildOrderStages(current, _requiresFulfillment) {
+    if (current === 'Voided') {
+        return [
+            { Stage: 'Voided', Reachable: false, Note: 'This unconfirmed order is currently voided.' },
+            { Stage: 'Draft', Reachable: true, Note: 'Reopen as draft for editing.' },
+            { Stage: 'Quoted', Reachable: true, Note: 'Reopen as quote.' },
+        ];
+    }
+    const at = STAGE_ORDER.indexOf(current);
+    return STAGE_ORDER.map((stage, i) => {
+        if (i <= at)
+            return { Stage: stage, Reachable: false, Note: null };
+        switch (stage) {
+            case 'Quoted':
+                return {
+                    Stage: stage,
+                    Reachable: true,
+                    Note: 'Optional — going straight to Confirmed is legal.',
+                };
+            case 'Confirmed':
+                return {
+                    Stage: stage,
+                    Reachable: at < STAGE_ORDER.indexOf('Confirmed'),
+                    Note: 'Books one journal entry per line. Fires exactly once, and is not undoable.',
+                };
+            default:
+                return { Stage: stage, Reachable: false, Note: null };
+        }
+    });
+}
+/**
+ * The verbs that actually apply to an order in a given state.
+ *
+ * Edit gating shows the state's REAL actions rather than a disabled Save: a
+ * confirmed order offers "Create reversal", not a greyed-out edit control that
+ * leaves the user guessing what they are allowed to do.
+ */
+export function ActionsForStage(current) {
+    switch (current) {
+        case 'Draft':
+        case 'Quoted':
+            return [
+                { Key: 'save', Label: 'Save draft' },
+                { Key: 'confirm', Label: 'Confirm order' },
+                { Key: 'void', Label: 'Void', Danger: true },
+            ];
+        case 'Confirmed':
+            return [
+                { Key: 'reverse', Label: 'Create reversal…' },
+                { Key: 'payment', Label: 'Take payment' },
+                { Key: 'document', Label: 'Bill' },
+            ];
+        case 'Voided':
+            return [
+                { Key: 'reopen-draft', Label: 'Reopen as draft' },
+                { Key: 'reopen-quoted', Label: 'Reopen as quote' },
+                { Key: 'document', Label: 'Bill' },
+            ];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=order-stages.js.map

package/dist/lib/panels/order-stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-stages.js","sourceRoot":"","sources":["../../../src/lib/panels/order-stages.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,MAAM,OAAO,8BAA8B;IAMnB;IACA;IANpB,iEAAiE;IAC1D,MAAM,GAAG,KAAK,CAAC;IACtB,8CAA8C;IACvC,YAAY,CAAU;IAC7B,YACoB,IAAmB,EACnB,EAAiB;QADjB,SAAI,GAAJ,IAAI,CAAe;QACnB,OAAE,GAAF,EAAE,CAAe;IAClC,CAAC;CACP;AAED,yEAAyE;AACzE,MAAM,WAAW,GAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAC5B,OAAsB,EACtB,oBAA8B;IAE9B,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO;YACH,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,6CAA6C,EAAE;YAC1F,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,8BAA8B,EAAE;YACzE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE;SACjE,CAAC;IACN,CAAC;IAED,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAChC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAEnE,QAAQ,KAAK,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACT,OAAO;oBACH,KAAK,EAAE,KAAK;oBACZ,SAAS,EAAE,IAAI;oBACf,IAAI,EAAE,kDAAkD;iBAC3D,CAAC;YACN,KAAK,WAAW;gBACZ,OAAO;oBACH,KAAK,EAAE,KAAK;oBACZ,SAAS,EAAE,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC;oBAChD,IAAI,EAAE,4EAA4E;iBACrF,CAAC;YACN;gBACI,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC9D,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,OAAsB;IAClD,QAAQ,OAAO,EAAE,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ;YACT,OAAO;gBACH,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE;gBACpC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC1C,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;aAC/C,CAAC;QACN,KAAK,WAAW;YACZ,OAAO;gBACH,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE;gBAC7C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE;gBACzC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;aACrC,CAAC;QACN,KAAK,QAAQ;YACT,OAAO;gBACH,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,iBAAiB,EAAE;gBACjD,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE;gBAClD,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;aACrC,CAAC;QACN;YACI,OAAO,EAAE,CAAC;IAClB,CAAC;AACL,CAAC"}

package/dist/lib/panels/party-orders-overview.component.d.ts

@@ -0,0 +1,79 @@
+import { OnInit } from '@angular/core';
+import { type IMetadataProvider, type IRunQueryProvider } from '@memberjunction/core';
+import { BaseFormComponent } from '@memberjunction/ng-base-forms';
+import type { PartyKind } from '../form-panels/party-order-stats.js';
+import * as i0 from "@angular/core";
+interface OrderRow {
+    ID: string;
+    OrderNumber: string;
+    OrderDate: Date | string | null;
+    Status: string;
+    FulfillmentStatus?: string;
+    IsOverdue?: boolean | number;
+    TotalGross: number;
+    AmountPaid: number;
+    Balance: number;
+}
+interface SubRow {
+    ID: string;
+    SubscriptionNumber: string;
+    Product: string;
+    SubscriptionType: string;
+    Status: string;
+    StartDate: Date | string | null;
+    EndDate: Date | string | null;
+    AutoRenew: boolean;
+}
+interface MonthSpend {
+    MonthOffset?: number;
+    MonthLabel: string;
+    MonthShort: string;
+    Amount: number;
+    HeightPct: number;
+    IsPeak: boolean;
+}
+interface TimelineItem {
+    Title: string;
+    Subtitle: string;
+    TimeAgo: string;
+    Icon: string;
+    Tone: 'info' | 'success' | 'warning' | 'primary';
+    EntityName?: string;
+    RecordID?: string;
+}
+export declare class PartyOrdersOverviewComponent implements OnInit {
+    Mode: PartyKind;
+    PartyID: string;
+    FormComponent?: BaseFormComponent;
+    Provider?: IMetadataProvider;
+    RunQueryProvider?: IRunQueryProvider;
+    private navigationService;
+    private cdr;
+    Loading: boolean;
+    MaximizedCardId: string | null;
+    Orders: OrderRow[];
+    Subscriptions: SubRow[];
+    SpendMonths: MonthSpend[];
+    AvgOrderValue: number;
+    LifetimeValue: number;
+    Timeline: TimelineItem[];
+    ngOnInit(): Promise<void>;
+    LoadOverviewData(): Promise<void>;
+    private LoadViaRunView;
+    private ParseJsonArray;
+    private ProcessSpendTrajectory;
+    private SynthesizeTimeline;
+    OnTimelineItemClick(item: TimelineItem): void;
+    OnOrderClick(orderId: string): void;
+    OnSubClick(subId: string): void;
+    OnActionClick(action: string): void;
+    FormatCurrency(val: number | null | undefined): string;
+    FormatDate(d: Date | string | null | undefined): string;
+    GetPaymentStatus(ord: OrderRow): string;
+    GetPaymentBadgeClass(status: string | null | undefined): string;
+    GetStatusBadgeClass(status: string | null | undefined): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PartyOrdersOverviewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PartyOrdersOverviewComponent, "mjo-party-orders-overview", never, { "Mode": { "alias": "Mode"; "required": true; }; "PartyID": { "alias": "PartyID"; "required": true; }; "FormComponent": { "alias": "FormComponent"; "required": false; }; "Provider": { "alias": "Provider"; "required": false; }; "RunQueryProvider": { "alias": "RunQueryProvider"; "required": false; }; }, {}, never, never, true, never>;
+}
+export {};
+//# sourceMappingURL=party-orders-overview.component.d.ts.map

package/dist/lib/panels/party-orders-overview.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"party-orders-overview.component.d.ts","sourceRoot":"","sources":["../../../src/lib/panels/party-orders-overview.component.ts"],"names":[],"mappings":"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"}