@mj-biz-apps/orders-core-entities-server 5.21.0 → 5.23.0

package/dist/AccountingBridge.d.ts

@@ -17,7 +17,7 @@
  * resolves by key — but that is a different package (`accounting-server`, wired up by the host app's
  * resolver paths) and is unaffected by how this one is imported.
  */
-import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { BaseRemotableOperation, IMetadataProvider, UserInfo } from '@memberjunction/core';
 import { GLAccountResolver, type ResolverEntityIDs } from './GLAccountResolver.js';
 import type { IntercompanyLookup } from './PaymentAllocationFactory.js';
 /** The subset of `AccountingEngineBase` used here, declared structurally so there is no type import. */
@@ -158,4 +158,68 @@ export interface CreateJournalEntriesOutcome {
  * @throws when the operation is unregistered, the call fails, or accounting refuses the drafts
  */
 export declare function SubmitJournalEntryDrafts(drafts: unknown[], what: string, provider: IMetadataProvider, user: UserInfo): Promise<CreateJournalEntriesOutcome>;
+/** One exception type as `Accounting.GetFinanceExceptionTypes` reports it. */
+export interface FinanceExceptionTypeInfo {
+    Code: string;
+    IsActive: boolean;
+    Configuration: Record<string, unknown>;
+}
+/** One exception to raise, in the shape `Accounting.RaiseFinanceExceptions` takes. */
+export interface FinanceExceptionToRaise {
+    TypeCode: string;
+    /** MJ entity name; accounting resolves it to SourceEntityID. */
+    SourceEntityName: string;
+    SourceRecordID: string;
+    CompanyID: string;
+    Amount?: number | null;
+    /** `YYYY-MM-DD` — the month the exception belongs to. */
+    ExceptionDate: string;
+    Summary: string;
+    DedupeKey: string;
+    SourceCreatedByUserID?: string | null;
+    /** True when a creator exists but has no linked login. */
+    CreatorUnresolved?: boolean;
+}
+/** What `Accounting.RaiseFinanceExceptions` answers with. */
+export interface RaiseFinanceExceptionsOutcome {
+    Success: boolean;
+    Results: Array<{
+        Index: number;
+        FinanceExceptionID?: string;
+        Created: boolean;
+        Skipped?: boolean;
+    }>;
+    Errors?: Array<{
+        Index?: number;
+        Code: string;
+        Message: string;
+    }>;
+}
+/**
+ * The accounting operation registered under `key`, or a throw naming `what` could not be done.
+ *
+ * `TryCreateInstance`, not `CreateInstance`: for an unregistered key `CreateInstance` hands back a
+ * hollow `BaseRemotableOperation` rather than null, so a null check alone would never fire and the
+ * call would route with no operation key.
+ */
+export declare function ResolveAccountingOperation<I, O>(key: string, what: string): BaseRemotableOperation<I, O>;
+/**
+ * The ACTIVE configuration of one finance exception type, or null when accounting has no such type
+ * or has switched it off — in which case the caller skips. No defaults are invented here: the
+ * thresholds are finance's to set, and a guessed one would raise a list nobody asked for.
+ *
+ * @throws when the operation is unregistered or the read fails
+ */
+export declare function GetActiveFinanceExceptionType(code: string, provider: IMetadataProvider, user: UserInfo): Promise<FinanceExceptionTypeInfo | null>;
+/**
+ * Raise finance exceptions into accounting's review list and return its payload.
+ *
+ * SIDE EFFECT, DELIBERATELY NAMED: this writes review rows. It joins the CALLER'S transaction when
+ * there is one, so a raise made at save time commits or rolls back with the save. Idempotent on
+ * (type, dedupe key) on accounting's side: a repeat returns `Created: false`.
+ *
+ * @param what names the act in the error message
+ * @throws when the operation is unregistered, the call fails, or accounting refuses the batch
+ */
+export declare function RaiseFinanceExceptions(exceptions: FinanceExceptionToRaise[], what: string, provider: IMetadataProvider, user: UserInfo): Promise<RaiseFinanceExceptionsOutcome>;
 //# sourceMappingURL=AccountingBridge.d.ts.map

package/dist/AccountingBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountingBridge.d.ts","sourceRoot":"","sources":["../src/AccountingBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA0B,iBAAiB,EAAY,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrG,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAQxE,wGAAwG;AACxG,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,OAAO,EAAE;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,QAAQ,CAAC;QACvB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;KAChC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,oBAAoB,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,IAAI,GACf;QAAE,IAAI,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACvE;;;;OAIG;IACH,cAAc,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;QAC1C,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;IACH,cAAc,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD;;;;;OAKG;IACH,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnE,eAAe,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7F;;;;;;;OAOG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC/E;;;OAGG;IACH,2BAA2B,CACvB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,IAAI,GACf;QACC,KAAK,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,KAAK,CAAC;gBAAE,WAAW,EAAE,MAAM,CAAC;gBAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QAC5G,OAAO,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,KAAK,CAAC;gBAAE,WAAW,EAAE,MAAM,CAAC;gBAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KACjH,GAAG,IAAI,CAAC;CACZ;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,IAAI,iBAAiB,CAOpD;AAED,yEAAyE;AACzE,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,uBAAuB,CAAC,CAOlC;AAED,sDAAsD;AACtD,wBAAsB,sBAAsB,CACxC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,iBAAiB,CAAC,CA2C5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CACzC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,kBAAkB,CAAC,CAoB7B;AAED,2FAA2F;AAC3F,MAAM,WAAW,2BAA2B;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EAAE,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,2BAA2B,CAAC,CA4BtC"}
+{"version":3,"file":"AccountingBridge.d.ts","sourceRoot":"","sources":["../src/AccountingBridge.ts"],"names":[],"mappings":"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"}

package/dist/AccountingBridge.js

@@ -17,7 +17,7 @@
  * resolves by key — but that is a different package (`accounting-server`, wired up by the host app's
  * resolver paths) and is unaffected by how this one is imported.
  */
-import { BaseRemotableOperation, Metadata } from '@memberjunction/core';
+import { BaseRemotableOperation, LogStatus, Metadata } from '@memberjunction/core';
 import { MJGlobal } from '@memberjunction/global';
 import { AccountingEngineBase, pickActiveLinkIndex } from '@mj-biz-apps/accounting-engine-base';
 import { GLAccountResolver } from './GLAccountResolver.js';
@@ -167,4 +167,78 @@ export async function SubmitJournalEntryDrafts(drafts, what, provider, user) {
     }
     return payload;
 }
+/**
+ * The accounting operation registered under `key`, or a throw naming `what` could not be done.
+ *
+ * `TryCreateInstance`, not `CreateInstance`: for an unregistered key `CreateInstance` hands back a
+ * hollow `BaseRemotableOperation` rather than null, so a null check alone would never fire and the
+ * call would route with no operation key.
+ */
+export function ResolveAccountingOperation(key, what) {
+    const resolved = MJGlobal.Instance.ClassFactory.TryCreateInstance(BaseRemotableOperation, key);
+    const op = resolved.Resolved ? resolved.Instance : null;
+    if (!op) {
+        throw new Error(`The '${key}' operation is not registered. The BizApps Accounting server package must be loaded before orders can ${what}.`);
+    }
+    return op;
+}
+/**
+ * The ACTIVE configuration of one finance exception type, or null when accounting has no such type
+ * or has switched it off — in which case the caller skips. No defaults are invented here: the
+ * thresholds are finance's to set, and a guessed one would raise a list nobody asked for.
+ *
+ * @throws when the operation is unregistered or the read fails
+ */
+export async function GetActiveFinanceExceptionType(code, provider, user) {
+    const key = 'Accounting.GetFinanceExceptionTypes';
+    const op = ResolveAccountingOperation(key, `read the ${code} exception type`);
+    const result = await op.Execute({ Codes: [code] }, { provider, user });
+    if (!result.Success) {
+        throw new Error(`${key} did not execute: ${result.ErrorMessage ?? result.ResultCode ?? 'unknown error'}`);
+    }
+    const payload = result.Output;
+    if (!payload)
+        throw new Error(`${key} returned no payload.`);
+    if (!payload.Success) {
+        throw new Error(`${key} failed. ${(payload.Errors ?? []).map((e) => `${e.Code}: ${e.Message}`).join('; ')}`);
+    }
+    const type = (payload.Types ?? []).find((t) => t.Code === code);
+    if (!type) {
+        LogStatus(`Finance exception type ${code} is not defined in accounting; nothing is raised for it.`);
+        return null;
+    }
+    if (!type.IsActive) {
+        LogStatus(`Finance exception type ${code} is inactive; nothing is raised for it.`);
+        return null;
+    }
+    return { ...type, Configuration: type.Configuration ?? {} };
+}
+/**
+ * Raise finance exceptions into accounting's review list and return its payload.
+ *
+ * SIDE EFFECT, DELIBERATELY NAMED: this writes review rows. It joins the CALLER'S transaction when
+ * there is one, so a raise made at save time commits or rolls back with the save. Idempotent on
+ * (type, dedupe key) on accounting's side: a repeat returns `Created: false`.
+ *
+ * @param what names the act in the error message
+ * @throws when the operation is unregistered, the call fails, or accounting refuses the batch
+ */
+export async function RaiseFinanceExceptions(exceptions, what, provider, user) {
+    const key = 'Accounting.RaiseFinanceExceptions';
+    const op = ResolveAccountingOperation(key, `raise ${what}`);
+    const result = await op.Execute({ Exceptions: exceptions }, { provider, user });
+    if (!result.Success) {
+        throw new Error(`${key} did not execute for ${what}: ${result.ErrorMessage ?? result.ResultCode ?? 'unknown error'}`);
+    }
+    const payload = result.Output;
+    if (!payload)
+        throw new Error(`${key} returned no payload for ${what}.`);
+    if (!payload.Success) {
+        const detail = (payload.Errors ?? [])
+            .map((e) => `${e.Index != null ? `#${e.Index} ` : ''}${e.Code}: ${e.Message}`)
+            .join('; ');
+        throw new Error(`Raising ${what} failed. ${detail}`);
+    }
+    return payload;
+}
 //# sourceMappingURL=AccountingBridge.js.map

package/dist/AccountingBridge.js.map

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

package/dist/AmendArrangementOperation.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Orders.AmendArrangement — change a booked arrangement and keep it alive (golive #221).
+ *
+ * Case B, a term extended at no charge, is what this supports today: the caller names a term and its new end
+ * date, with the reason. `Preview` returns what the extension would do — its value, the staged entries it
+ * offsets and the new schedule — and writes nothing. Otherwise it records a Duration `OrderConcession`, which
+ * is valued and routed for approval like any other; the extension takes effect when that concession is
+ * approved, in the approval's own transaction (see ./TermExtension.ts). A requester within their own authority
+ * is approved on save, so the extension applies in this call.
+ *
+ * A change of amount (case A) is refused until its credit-memo path exists.
+ *
+ * A confirmed order's payment terms (#309): the caller names the order and its new terms instead of a term. It
+ * records a Terms `OrderConcession`, which always waits for someone other than the requester to approve it; the
+ * terms and the due date change when it is approved (see ./PaymentTermsChange.ts). `Preview` returns the change in
+ * days to payment and the new due date.
+ *
+ * CONNECTS TO:
+ *   PLAN:    ./TermExtension.ts (CheckTermExtension) · ./PaymentTermsChange.ts (CheckTermsChange)
+ *   RECORDS: OrderConcessionEntityServer (value, approval, application)
+ */
+import { BaseRemotableOperation, type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+export type AmendmentReasonCategory = 'Retention' | 'Referral' | 'Other';
+export interface AmendArrangementInput {
+    /** The booked term to amend. Not given with `NewPaymentTermsTypeID`. */
+    SubscriptionTermID?: string;
+    /** The term's new end date. Must be later than its current end. */
+    NewEndDate?: string;
+    /** The confirmed order whose payment terms change. Given with `NewPaymentTermsTypeID`. */
+    OrderHeaderID?: string;
+    /** The order's new payment terms. */
+    NewPaymentTermsTypeID?: string;
+    /** A change of amount. Not supported yet; refused. */
+    NewAmount?: number;
+    ReasonCategory: AmendmentReasonCategory;
+    Reason: string;
+    /** Return what the amendment would do without writing anything. */
+    Preview?: boolean;
+}
+export interface AmendArrangementEntry {
+    EffectiveDate: string;
+    Amount: number;
+    /** For an offset, the staged entry it cancels. */
+    Offsets?: string;
+}
+export interface AmendArrangementOutput {
+    Success: boolean;
+    Message?: string;
+    CurrentEndDate?: string;
+    NewEndDate?: string;
+    /** The day the extension takes effect: staged entries from here on are replaced. */
+    EffectiveDate?: string;
+    /** What the added days are worth at the term's own rate. */
+    Value?: number;
+    /** What the replaced entries were going to recognise, and the new schedule now does. */
+    Respread?: number;
+    Offsets?: AmendArrangementEntry[];
+    NewSchedule?: AmendArrangementEntry[];
+    /** A change of payment terms: the terms before and after, by name. */
+    CurrentPaymentTerms?: string | null;
+    NewPaymentTerms?: string;
+    /** Days to payment the new terms move by: positive when the customer pays later. */
+    DaysChange?: number;
+    CurrentDueDate?: string | null;
+    NewDueDate?: string | null;
+    /** Set when recorded: the concession, and whether it is Approved (applied) or Pending (awaiting approval). */
+    OrderConcessionID?: string;
+    Status?: string;
+}
+export declare class AmendArrangementOperation extends BaseRemotableOperation<AmendArrangementInput, AmendArrangementOutput> {
+    OperationKey: string;
+    protected InternalExecute(input: AmendArrangementInput, provider: IMetadataProvider, user: UserInfo): Promise<AmendArrangementOutput>;
+    private amendPaymentTerms;
+    private currentEnd;
+}
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export declare function LoadAmendArrangementOperation(): void;
+//# sourceMappingURL=AmendArrangementOperation.d.ts.map

package/dist/AmendArrangementOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmendArrangementOperation.d.ts","sourceRoot":"","sources":["../src/AmendArrangementOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACH,sBAAsB,EAEtB,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EAChB,MAAM,sBAAsB,CAAC;AAa9B,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IAClC,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,uBAAuB,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8GAA8G;IAC9G,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,qBACa,yBAA0B,SAAQ,sBAAsB,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;IACzG,YAAY,SAA6B;cAEhC,eAAe,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC;YAgFpB,iBAAiB;YAoDjB,UAAU;CAiB3B;AAMD,8FAA8F;AAC9F,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/AmendArrangementOperation.js

@@ -0,0 +1,187 @@
+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.AmendArrangement — change a booked arrangement and keep it alive (golive #221).
+ *
+ * Case B, a term extended at no charge, is what this supports today: the caller names a term and its new end
+ * date, with the reason. `Preview` returns what the extension would do — its value, the staged entries it
+ * offsets and the new schedule — and writes nothing. Otherwise it records a Duration `OrderConcession`, which
+ * is valued and routed for approval like any other; the extension takes effect when that concession is
+ * approved, in the approval's own transaction (see ./TermExtension.ts). A requester within their own authority
+ * is approved on save, so the extension applies in this call.
+ *
+ * A change of amount (case A) is refused until its credit-memo path exists.
+ *
+ * A confirmed order's payment terms (#309): the caller names the order and its new terms instead of a term. It
+ * records a Terms `OrderConcession`, which always waits for someone other than the requester to approve it; the
+ * terms and the due date change when it is approved (see ./PaymentTermsChange.ts). `Preview` returns the change in
+ * days to payment and the new due date.
+ *
+ * CONNECTS TO:
+ *   PLAN:    ./TermExtension.ts (CheckTermExtension) · ./PaymentTermsChange.ts (CheckTermsChange)
+ *   RECORDS: OrderConcessionEntityServer (value, approval, application)
+ */
+import { BaseRemotableOperation, RunView, } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { AsDateValue, ConcessionValue, InclusiveDays, } from '@mj-biz-apps/orders-entities';
+import { ORDER_CONCESSION_ENTITY } from './entity-names.js';
+import { RequireOptionalDay, RequireUUID } from './sql-guards.js';
+import { CheckTermsChange } from './PaymentTermsChange.js';
+import { CheckTermExtension } from './TermExtension.js';
+const REASON_CATEGORIES = ['Retention', 'Referral', 'Other'];
+let AmendArrangementOperation = class AmendArrangementOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'Orders.AmendArrangement';
+    }
+    async InternalExecute(input, provider, user) {
+        if (!REASON_CATEGORIES.includes(input.ReasonCategory)) {
+            return { Success: false, Message: `ReasonCategory must be one of ${REASON_CATEGORIES.join(', ')}.` };
+        }
+        if (!input.Reason?.trim())
+            return { Success: false, Message: 'An amendment must state its reason.' };
+        if (input.NewPaymentTermsTypeID != null || input.OrderHeaderID != null) {
+            if (input.SubscriptionTermID != null || input.NewEndDate != null || input.NewAmount != null) {
+                return { Success: false, Message: 'A change of payment terms is amended on its own, without a term, end date or amount.' };
+            }
+            return this.amendPaymentTerms(input, provider, user);
+        }
+        let newEnd;
+        try {
+            RequireUUID(input.SubscriptionTermID, 'SubscriptionTermID');
+            newEnd = AsDateValue(RequireOptionalDay(input.NewEndDate, 'NewEndDate'));
+        }
+        catch (e) {
+            return { Success: false, Message: String(e.message) };
+        }
+        if (input.NewAmount != null) {
+            return { Success: false, Message: 'Changing the amount of a booked arrangement is not supported yet.' };
+        }
+        if (!newEnd)
+            return { Success: false, Message: 'NewEndDate is required.' };
+        const termID = input.SubscriptionTermID;
+        const current = await this.currentEnd(termID, provider, user);
+        if (typeof current === 'string')
+            return { Success: false, Message: current };
+        const addedDays = Math.round((newEnd.getTime() - current.getTime()) / 86_400_000);
+        const checked = await CheckTermExtension({ SubscriptionTermID: termID, AddedDays: addedDays, RequestedByUserID: user.ID }, { Provider: provider, User: user });
+        if (typeof checked === 'string')
+            return { Success: false, Message: checked };
+        const summary = {
+            Success: true,
+            CurrentEndDate: day(checked.CurrentEndDate),
+            NewEndDate: day(checked.NewEndDate),
+            EffectiveDate: day(checked.EffectiveDate),
+            Value: ConcessionValue({
+                Form: 'Duration',
+                TermAmount: checked.TermAmount,
+                TermDays: InclusiveDays(checked.TermStartDate, checked.CurrentEndDate),
+                AddedDays: addedDays,
+            }).Value,
+            Respread: checked.Plan.Remaining,
+            Offsets: checked.Plan.Offsets.map((d, i) => ({
+                EffectiveDate: d.EffectiveDate,
+                Amount: d.Lines.reduce((sum, l) => sum + Number(l.DebitAmount ?? 0), 0),
+                Offsets: checked.Plan.Targets[i].EntryNumber,
+            })),
+            NewSchedule: checked.Plan.Respread.map((d) => ({ EffectiveDate: d.EffectiveDate, Amount: d.Lines[0].DebitAmount ?? 0 })),
+        };
+        if (input.Preview) {
+            return { ...summary, Message: `Term would end ${summary.NewEndDate} instead of ${summary.CurrentEndDate}.` };
+        }
+        const concession = await provider.GetEntityObject(ORDER_CONCESSION_ENTITY, user);
+        concession.NewRecord();
+        concession.DeliveryForm = 'Duration';
+        concession.SubscriptionTermID = termID;
+        concession.AddedDays = addedDays;
+        concession.ReasonCategory = input.ReasonCategory;
+        concession.Reason = input.Reason.trim();
+        if (!(await concession.Save())) {
+            return { Success: false, Message: concession.LatestResult?.CompleteMessage ?? 'The amendment could not be recorded.' };
+        }
+        return {
+            ...summary,
+            OrderConcessionID: concession.ID,
+            Status: concession.Status,
+            Value: Number(concession.ComputedValue),
+            Message: concession.Status === 'Approved'
+                ? `Term extended to ${summary.NewEndDate}. Accounting has been asked to confirm the re-cut.`
+                : `The extension to ${summary.NewEndDate} is awaiting approval; it takes effect when approved.`,
+        };
+    }
+    async amendPaymentTerms(input, provider, user) {
+        let checked;
+        try {
+            checked = await CheckTermsChange({
+                OrderHeaderID: RequireUUID(input.OrderHeaderID, 'OrderHeaderID'),
+                NewPaymentTermsTypeID: RequireUUID(input.NewPaymentTermsTypeID, 'NewPaymentTermsTypeID'),
+            }, { Provider: provider, User: user });
+        }
+        catch (e) {
+            return { Success: false, Message: String(e.message) };
+        }
+        if (typeof checked === 'string')
+            return { Success: false, Message: checked };
+        const summary = {
+            Success: true,
+            CurrentPaymentTerms: checked.PriorTermsName,
+            NewPaymentTerms: checked.NewTermsName,
+            DaysChange: checked.DaysChange,
+            CurrentDueDate: checked.CurrentDueDate,
+            NewDueDate: checked.NewDueDate,
+        };
+        if (input.Preview) {
+            return {
+                ...summary,
+                Message: `Order ${checked.OrderNumber} would move to ${checked.NewTermsName}, due ${checked.NewDueDate ?? 'on receipt'}.`,
+            };
+        }
+        const concession = await provider.GetEntityObject(ORDER_CONCESSION_ENTITY, user);
+        concession.NewRecord();
+        concession.DeliveryForm = 'Terms';
+        concession.OrderHeaderID = checked.OrderHeaderID;
+        concession.NewPaymentTermsTypeID = checked.NewPaymentTermsTypeID;
+        concession.ReasonCategory = input.ReasonCategory;
+        concession.Reason = (input.Reason ?? '').trim();
+        if (!(await concession.Save())) {
+            return { Success: false, Message: concession.LatestResult?.CompleteMessage ?? 'The amendment could not be recorded.' };
+        }
+        return {
+            ...summary,
+            OrderConcessionID: concession.ID,
+            Status: concession.Status,
+            Message: `The change to ${checked.NewTermsName} is awaiting approval; it takes effect when approved.`,
+        };
+    }
+    async currentEnd(termID, provider, user) {
+        const rv = new RunView(provider);
+        const res = await rv.RunView({
+            EntityName: 'MJ_BizApps_Orders: Subscription Terms',
+            ExtraFilter: `ID = '${RequireUUID(termID, 'SubscriptionTermID')}'`,
+            Fields: ['EndDate'],
+            ResultType: 'simple',
+            BypassCache: true,
+        }, user);
+        const term = res?.Results?.[0];
+        if (!term)
+            return `Subscription term ${termID} was not found.`;
+        const d = new Date(term.EndDate);
+        return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+    }
+};
+AmendArrangementOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.AmendArrangement')
+], AmendArrangementOperation);
+export { AmendArrangementOperation };
+function day(d) {
+    return d.toISOString().slice(0, 10);
+}
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export function LoadAmendArrangementOperation() {
+    // intentionally empty
+}
+//# sourceMappingURL=AmendArrangementOperation.js.map

package/dist/AmendArrangementOperation.js.map

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

package/dist/BasePaymentProvider.d.ts

@@ -73,6 +73,11 @@ export interface CreateIntentRequest {
     ProviderInstrumentRef?: string | null;
     /** Free-form, echoed back on webhooks. Useful for reconciliation, never load-bearing. */
     Metadata?: Record<string, string>;
+    /**
+     * What the gateway's dashboard shows for this charge — see `FormatIntentDescription`. Display
+     * only, like `Metadata`: nothing reads it back.
+     */
+    Description?: string | null;
     /**
      * OUR idempotency key. Sent to gateways that support one so a retried create does not open a
      * second intent — and therefore does not charge the customer twice.
@@ -89,6 +94,20 @@ export interface CreateIntentResult {
     /** For a hosted-checkout flow — where to send the customer. */
     HostedUrl?: string;
 }
+/**
+ * Details attached to an intent after it was opened. Checkout opens its intent before the order exists,
+ * so the order number and id can only reach the gateway afterwards (#327).
+ */
+export interface UpdateIntentRequest {
+    ProviderIntentID: string;
+    Description?: string | null;
+    /** Merged into what the intent already carries; keys not named here are left alone. */
+    Metadata?: Record<string, string>;
+}
+export interface UpdateIntentResult {
+    Success: boolean;
+    Reason?: string;
+}
 export interface CaptureRequest {
     ProviderIntentID: string;
     /** Omit for the full authorised amount. Major units. */
@@ -227,6 +246,8 @@ export declare class BasePaymentProvider {
      * Stripe's POST. This is a SERVER retrieve with our key, not a client claim.
      */
     RetrieveIntent(_request: RetrieveIntentRequest): Promise<RetrieveIntentResult>;
+    /** Attach display details to an intent already opened. Moves no money and changes no status. */
+    UpdateIntent(_request: UpdateIntentRequest): Promise<UpdateIntentResult>;
     Refund(_request: RefundRequest): Promise<RefundResult>;
     /**
      * Verify that a webhook really came from the gateway.

package/dist/BasePaymentProvider.d.ts.map

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

package/dist/BasePaymentProvider.js

@@ -69,6 +69,10 @@ export class BasePaymentProvider {
     async RetrieveIntent(_request) {
         return { Success: false, Reason: this.notImplemented('retrieving a payment intent') };
     }
+    /** Attach display details to an intent already opened. Moves no money and changes no status. */
+    async UpdateIntent(_request) {
+        return { Success: false, Reason: this.notImplemented('updating a payment intent') };
+    }
     async Refund(_request) {
         return { Success: false, Reason: this.notImplemented('refunding a payment') };
     }

package/dist/BasePaymentProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"BasePaymentProvider.js","sourceRoot":"","sources":["../src/BasePaymentProvider.ts"],"names":[],"mappings":"AA6KA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,mBAAmB;IAW5B,gGAAgG;IAChG,IAAW,iBAAiB;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAW,qBAAqB;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,IAAW,iBAAiB;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,QAA6B;QACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,2BAA2B,CAAC,EAAE,CAAC;IACxF,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,QAAwB;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CAAC,QAA+B;QACvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,6BAA6B,CAAC,EAAE,CAAC;IAC1F,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,QAAuB;QACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,aAAa,CACtB,QAAgB,EAChB,QAA4C;QAE5C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,eAAe,2BAA2B,EAAE,CAAC;IAC5G,CAAC;IAED,kGAAkG;IAC3F,iBAAiB,CAAC,QAAgB;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IAES,cAAc,CAAC,IAAY;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS,CAAC;QAChD,OAAO,CACH,QAAQ,IAAI,uCAAuC,IAAI,kCAAkC;YACzF,oEAAoE;YACpE,iEAAiE,CACpE,CAAC;IACN,CAAC;CACJ;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB;IACnC,sBAAsB;AAC1B,CAAC"}
+{"version":3,"file":"BasePaymentProvider.js","sourceRoot":"","sources":["../src/BasePaymentProvider.ts"],"names":[],"mappings":"AAkMA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,mBAAmB;IAW5B,gGAAgG;IAChG,IAAW,iBAAiB;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAW,qBAAqB;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,IAAW,iBAAiB;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,QAA6B;QACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,2BAA2B,CAAC,EAAE,CAAC;IACxF,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,QAAwB;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,cAAc,CAAC,QAA+B;QACvD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,6BAA6B,CAAC,EAAE,CAAC;IAC1F,CAAC;IAED,gGAAgG;IACzF,KAAK,CAAC,YAAY,CAAC,QAA6B;QACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,2BAA2B,CAAC,EAAE,CAAC;IACxF,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,QAAuB;QACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,aAAa,CACtB,QAAgB,EAChB,QAA4C;QAE5C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,eAAe,2BAA2B,EAAE,CAAC;IAC5G,CAAC;IAED,kGAAkG;IAC3F,iBAAiB,CAAC,QAAgB;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IAES,cAAc,CAAC,IAAY;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS,CAAC;QAChD,OAAO,CACH,QAAQ,IAAI,uCAAuC,IAAI,kCAAkC;YACzF,oEAAoE;YACpE,iEAAiE,CACpE,CAAC;IACN,CAAC;CACJ;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB;IACnC,sBAAsB;AAC1B,CAAC"}

package/dist/BundleEngine.d.ts

@@ -32,7 +32,13 @@ import { mjBizAppsOrdersOrderLineEntity } from '@mj-biz-apps/orders-entities';
  * Was a structural duck-type built on `Get`/`Set` — which meant every field this module touched
  * was a string literal the compiler could not check. It is the order-line entity; say so.
  */
-export type ExpandableLine = mjBizAppsOrdersOrderLineEntity;
+/**
+ * An order line as expansion handles it. `WrittenByBundleExpansion` is the server line's transient
+ * mark that expansion wrote its parent (see `OrderLineEntityServer.refuseParentNotFromExpansion`).
+ */
+export type ExpandableLine = mjBizAppsOrdersOrderLineEntity & {
+    WrittenByBundleExpansion?: boolean;
+};
 export interface BundleExpansionOutcome {
     /** How many parent lines were expanded. */
     Expanded: number;

package/dist/BundleEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BundleEngine.d.ts","sourceRoot":"","sources":["../src/BundleEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAEH,iBAAiB,EAGjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkC,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAgB9G,6GAA6G;AAC7G;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAE5D,MAAM,WAAW,sBAAsB;IACnC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,EACvC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC,CA2HjC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACtC,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CA6DjB"}
+{"version":3,"file":"BundleEngine.d.ts","sourceRoot":"","sources":["../src/BundleEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAEH,iBAAiB,EAGjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkC,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAgB9G,6GAA6G;AAC7G;;;;;GAKG;AACH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,8BAA8B,GAAG;IAAE,wBAAwB,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAErG,MAAM,WAAW,sBAAsB;IACnC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACnC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,EACvC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC,CA4HjC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACtC,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,MAAM,CAAC,CA6DjB"}

package/dist/BundleEngine.js

@@ -121,6 +121,7 @@ export async function ExpandBundleLines(lines, makeLine, provider, user) {
             row.Quantity = child.Quantity;
             row.UnitPrice = child.UnitPrice;
             row.ParentOrderLineID = line.ID;
+            row.WrittenByBundleExpansion = true;
             row.SourceBundleProductID = line.ProductID;
             row.IsRollupParent = false;
             row.IsQuantityOverridden = false;