@mj-biz-apps/orders-core-entities-server 5.18.0 → 5.20.0

package/dist/AdoptExternalInvoiceOperation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `Orders.AdoptExternalInvoice` — resolve a claimed unit by attaching the invoice the rail already holds.
+ *
+ * WHY THIS EXISTS. A send that times out leaves the unit claimed (`Sending`) deliberately: the rail
+ * may or may not have committed the invoice, and retrying blindly is how one billing unit becomes two
+ * invoices in a customer's inbox. Resolving that is a person's job and it has exactly two answers.
+ * The rail has nothing → re-issue with `AllowReissue`, which supersedes the claim. The rail HAS the
+ * invoice → bring its reference here.
+ *
+ * Until this operation existed only the first answer was implementable; the second was a hand edit in
+ * Explorer, which the claimed row's own message nonetheless told people to perform.
+ *
+ * IT READS THE INVOICE BACK AND REFUSES THREE WAYS, because a person is typing a reference off a
+ * screen and every one of these is a plausible slip:
+ *   · ARCHIVED — an invoice the rail has withdrawn is not one the customer holds. This is the slip
+ *     the total check cannot catch: a previously cancelled invoice for THIS unit ties exactly, by
+ *     construction, so adopting it would mark the unit Sent for ever against a document nobody has.
+ *     The unit would then be skipped by the sweep, refused by `CanSend`, and never billed.
+ *   · A DIFFERENT DOCUMENT — the rail carries our own `DocumentNumber` as its invoice number (the
+ *     send sets it), so a reference belonging to some other invoice is identifiable without guessing.
+ *     Compared only when the rail reports one; a rail that does not is left to the total check.
+ *   · A TOTAL THAT DOES NOT TIE — the same figure the send path proves, from the other direction.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { OrdersAdoptExternalInvoiceOperation as OrdersAdoptExternalInvoiceOperationBase, type OrdersAdoptExternalInvoiceInput, type OrdersAdoptExternalInvoiceOutput } from '@mj-biz-apps/orders-entities';
+export declare class AdoptExternalInvoiceOperation extends OrdersAdoptExternalInvoiceOperationBase {
+    protected InternalExecute(input: OrdersAdoptExternalInvoiceInput, provider: IMetadataProvider, user: UserInfo): Promise<OrdersAdoptExternalInvoiceOutput>;
+}
+/** Registers {@link AdoptExternalInvoiceOperation}. Called from the server bootstrap. */
+export declare function LoadAdoptExternalInvoiceOperation(): void;
+//# sourceMappingURL=AdoptExternalInvoiceOperation.d.ts.map

package/dist/AdoptExternalInvoiceOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdoptExternalInvoiceOperation.d.ts","sourceRoot":"","sources":["../src/AdoptExternalInvoiceOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAA6C,KAAK,iBAAiB,EAAyB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE/I,OAAO,EACH,mCAAmC,IAAI,uCAAuC,EAC9E,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACxC,MAAM,8BAA8B,CAAC;AActC,qBACa,6BAA8B,SAAQ,uCAAuC;cACtE,eAAe,CAC3B,KAAK,EAAE,+BAA+B,EACtC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,gCAAgC,CAAC;CAqI/C;AAiBD,yFAAyF;AACzF,wBAAgB,iCAAiC,IAAI,IAAI,CAExD"}

package/dist/AdoptExternalInvoiceOperation.js

@@ -0,0 +1,188 @@
+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.AdoptExternalInvoice` — resolve a claimed unit by attaching the invoice the rail already holds.
+ *
+ * WHY THIS EXISTS. A send that times out leaves the unit claimed (`Sending`) deliberately: the rail
+ * may or may not have committed the invoice, and retrying blindly is how one billing unit becomes two
+ * invoices in a customer's inbox. Resolving that is a person's job and it has exactly two answers.
+ * The rail has nothing → re-issue with `AllowReissue`, which supersedes the claim. The rail HAS the
+ * invoice → bring its reference here.
+ *
+ * Until this operation existed only the first answer was implementable; the second was a hand edit in
+ * Explorer, which the claimed row's own message nonetheless told people to perform.
+ *
+ * IT READS THE INVOICE BACK AND REFUSES THREE WAYS, because a person is typing a reference off a
+ * screen and every one of these is a plausible slip:
+ *   · ARCHIVED — an invoice the rail has withdrawn is not one the customer holds. This is the slip
+ *     the total check cannot catch: a previously cancelled invoice for THIS unit ties exactly, by
+ *     construction, so adopting it would mark the unit Sent for ever against a document nobody has.
+ *     The unit would then be skipped by the sweep, refused by `CanSend`, and never billed.
+ *   · A DIFFERENT DOCUMENT — the rail carries our own `DocumentNumber` as its invoice number (the
+ *     send sets it), so a reference belonging to some other invoice is identifiable without guessing.
+ *     Compared only when the rail reports one; a rail that does not is left to the total check.
+ *   · A TOTAL THAT DOES NOT TIE — the same figure the send path proves, from the other direction.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { BaseRemotableOperation, LogError, RunView } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { OrdersAdoptExternalInvoiceOperation as OrdersAdoptExternalInvoiceOperationBase, } from '@mj-biz-apps/orders-entities';
+import { DecideAdoption, money } from './ExternalInvoiceBehavior.js';
+import { ResolveInvoiceRail } from './InvoiceRailResolver.js';
+import { ORDER_HEADER_ENTITY } from './entity-names.js';
+import { LoadExternalInvoiceByID, stampHeaderDocumentNumber, stampScheduleRow, updateExternalInvoice, } from './IssueExternalInvoiceOperation.js';
+import { RequireUUID } from './sql-guards.js';
+let AdoptExternalInvoiceOperation = class AdoptExternalInvoiceOperation extends OrdersAdoptExternalInvoiceOperationBase {
+    async InternalExecute(input, provider, user) {
+        try {
+            const id = RequireUUID(input?.ExternalInvoiceID, 'ExternalInvoiceID');
+            const ref = (input?.ExternalInvoiceRef ?? '').trim();
+            const preview = !!input?.Preview;
+            if (!ref) {
+                return { Success: false, ResultCode: 'ERROR', Message: 'ExternalInvoiceRef is required: this operation exists to record the reference the rail already holds.' };
+            }
+            const row = await LoadExternalInvoiceByID(id, provider, user);
+            if (!row)
+                return { Success: false, ResultCode: 'ERROR', Message: `No external invoice with ID ${id}.` };
+            if (row.Status === 'Sent') {
+                return {
+                    Success: row.ExternalInvoiceRef === ref,
+                    ResultCode: 'ALREADY_ADOPTED',
+                    Message: row.ExternalInvoiceRef === ref
+                        ? `${row.DocumentNumber} already carries ${ref}; nothing to do.`
+                        : `${row.DocumentNumber} is already Sent as ${row.ExternalInvoiceRef}, not ${ref}. Refusing to repoint a live invoice — cancel it instead if it is wrong.`,
+                    ExternalInvoiceID: row.ID,
+                    ExternalInvoiceRef: row.ExternalInvoiceRef,
+                    DocumentNumber: row.DocumentNumber,
+                };
+            }
+            if (row.Status !== 'Sending') {
+                return {
+                    Success: false,
+                    ResultCode: 'NOT_CLAIMED',
+                    Message: `${row.DocumentNumber} is ${row.Status}, not a claimed send. This operation resolves a send that was never confirmed; a ${row.Status.toLowerCase()} unit is issued again instead.`,
+                    ExternalInvoiceID: row.ID,
+                    DocumentNumber: row.DocumentNumber,
+                };
+            }
+            // The rail's own view decides this, not the person's typing.
+            const rail = await ResolveInvoiceRail(String(row.PaymentProviderID), provider, user);
+            const snap = await rail.GetInvoice(ref);
+            if (snap.Success === false) {
+                return { Success: false, ResultCode: 'ERROR', Message: `${rail.Config.Name} could not be read for ${ref}: ${snap.Reason}`, ExternalInvoiceID: row.ID, ExternalInvoiceRef: ref };
+            }
+            if (!snap.Value) {
+                return {
+                    Success: false,
+                    ResultCode: 'NOT_FOUND_ON_RAIL',
+                    Message: `${rail.Config.Name} has no invoice ${ref}. If the rail really holds nothing for this unit, send it again with AllowReissue instead of adopting.`,
+                    ExternalInvoiceID: row.ID,
+                    ExternalInvoiceRef: ref,
+                    DocumentNumber: row.DocumentNumber,
+                };
+            }
+            const total = money(snap.Value.Total);
+            const amount = money(Number(row.Amount ?? 0));
+            const verdict = DecideAdoption({
+                ExternalInvoiceRef: ref,
+                DocumentNumber: row.DocumentNumber,
+                UnitAmount: amount,
+                RailArchived: snap.Value.Archived,
+                RailInvoiceNumber: snap.Value.InvoiceNumber,
+                RailTotal: total,
+                RailName: rail.Config.Name,
+            });
+            if (!verdict.OK) {
+                return {
+                    Success: false,
+                    // An archived invoice is the rail holding nothing LIVE for this unit, which is the
+                    // re-issue answer; the other two are the tie check refusing a mismatch.
+                    ResultCode: verdict.Code === 'ARCHIVED' ? 'NOT_FOUND_ON_RAIL' : 'TIE_FAILED',
+                    Message: verdict.Code === 'ARCHIVED' ? `${verdict.Reason} Send it again with AllowReissue.` : verdict.Reason,
+                    ExternalInvoiceID: row.ID,
+                    ExternalInvoiceRef: ref,
+                    DocumentNumber: row.DocumentNumber,
+                    ExternalTotal: total,
+                    Amount: amount,
+                };
+            }
+            if (preview) {
+                return {
+                    Success: true,
+                    ResultCode: 'PREVIEWED',
+                    Message: `Would record ${ref} against ${row.DocumentNumber} for ${amount.toFixed(2)} and mark it Sent.`,
+                    ExternalInvoiceID: row.ID,
+                    ExternalInvoiceRef: ref,
+                    DocumentNumber: row.DocumentNumber,
+                    ExternalTotal: total,
+                    Amount: amount,
+                };
+            }
+            const now = new Date();
+            await updateExternalInvoice(provider, user, String(row.ID), {
+                Status: 'Sent',
+                ExternalInvoiceRef: ref,
+                // The rail issued it at some unknown earlier moment; this is when we learned of it.
+                SentAt: row.SentAt ?? now,
+                ExternalTotal: total,
+                ExternalDueAmount: money(snap.Value.DueAmount),
+                ExternalStatus: snap.Value.Status,
+                LastSyncedAt: now,
+                LastError: null,
+            });
+            // THE SAME DENORMALISATION A SEND PERFORMS (step 9 of the issue path, the #239/#242
+            // contract). Without it an adopted instalment reads as never sent on its own row and on
+            // the order header, which is where a person looks — the worklist is unaffected either way
+            // because it keys off this table, so the inconsistency would have been silent.
+            if (row.OrderHeaderPaymentScheduleID) {
+                await stampScheduleRow(provider, user, String(row.OrderHeaderPaymentScheduleID), {
+                    ExternalSystem: rail.Config.TypeCode,
+                    ExternalInvoiceRef: ref,
+                    SentAt: row.SentAt ? new Date(row.SentAt) : now,
+                });
+            }
+            const header = await loadHeaderStampTarget(String(row.OrderHeaderID), provider, user);
+            if (header)
+                await stampHeaderDocumentNumber(provider, user, header, rail.Config.PaymentProviderID, String(row.DocumentNumber));
+            return {
+                Success: true,
+                ResultCode: 'ADOPTED',
+                Message: `${row.DocumentNumber} now carries ${rail.Config.Name} invoice ${ref} for ${amount.toFixed(2)}.`,
+                ExternalInvoiceID: row.ID,
+                ExternalInvoiceRef: ref,
+                DocumentNumber: row.DocumentNumber,
+                ExternalTotal: total,
+                Amount: amount,
+            };
+        }
+        catch (err) {
+            LogError(`Orders.AdoptExternalInvoice failed: ${err}`);
+            return { Success: false, ResultCode: 'ERROR', Message: err instanceof Error ? err.message : String(err) };
+        }
+    }
+};
+AdoptExternalInvoiceOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.AdoptExternalInvoice')
+], AdoptExternalInvoiceOperation);
+export { AdoptExternalInvoiceOperation };
+/** Just enough of the order for the display-only header stamp; a miss skips the stamp, never the adopt. */
+async function loadHeaderStampTarget(orderID, provider, user) {
+    const rv = new RunView(provider);
+    const r = await rv.RunView({
+        EntityName: ORDER_HEADER_ENTITY,
+        ExtraFilter: `ID = '${RequireUUID(orderID, 'OrderHeaderID')}'`,
+        Fields: ['ID', 'OrderNumber', 'ExternalDocumentNumber'],
+        ResultType: 'simple',
+    }, user);
+    return r.Results?.[0] ?? null;
+}
+/** Registers {@link AdoptExternalInvoiceOperation}. Called from the server bootstrap. */
+export function LoadAdoptExternalInvoiceOperation() {
+    void AdoptExternalInvoiceOperation;
+}
+//# sourceMappingURL=AdoptExternalInvoiceOperation.js.map

package/dist/AdoptExternalInvoiceOperation.js.map

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

package/dist/BaseInvoiceRail.d.ts

@@ -0,0 +1,159 @@
+/**
+ * @fileoverview The outbound invoice seam — `BaseInvoiceRail`.
+ *
+ * A RAIL is the system a customer actually holds our invoice in and pays through: Bill.com today,
+ * possibly Business Central later. Orders remains the receivable of record; the rail is delivery and
+ * collection. This base names the five things a rail has to do and nothing else:
+ *
+ *   EnsureCustomer     our bill-to party  → the rail's customer id
+ *   IssueInvoice       one billing unit   → the rail's invoice id
+ *   GetInvoice         the rail's view of an invoice we issued (total, due, status, archived)
+ *   CancelInvoice      withdraw an unpaid invoice on the rail
+ *   FetchPaymentsSince every receivable payment the rail has changed since a watermark
+ *
+ * WHY NOT `BaseDeliveryChannel`. That seam carries a rendered HTML document and email recipients; a
+ * rail needs structured facts (amount, due date, lines, the frozen document number) and hands back a
+ * reference we must persist. Different inputs, different outputs, different idempotency — so a
+ * different base (design §3, D-B1).
+ *
+ * WHY NOT `BasePaymentProvider`. That seam is about taking money at a till: intents, capture, refund.
+ * A rail issues documents and reports money that arrived on its own. The two share a type code and a
+ * `PaymentProvider` row so that "which Bill.com organisation is this company" is configured once.
+ *
+ * THE BASE IS NOT DECORATED, on purpose — the resolver detects "nothing registered under this code"
+ * by seeing the base class come back (same trick as `BaseDeliveryChannel`).
+ *
+ * REFUSAL IS A RESULT, NOT AN EXCEPTION. `RailResult` carries `Transient`, which is what lets the
+ * sweep retry a timeout and never retry "this customer has no email address".
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import type { IMetadataProvider, UserInfo } from '@memberjunction/core';
+/** The bill-to party, flattened to what a rail's customer record needs. */
+export interface RailCustomerFacts {
+    PartyKind: 'Organization' | 'Person';
+    /** Our party id — sent as the rail's account number so the link is recoverable from the rail side. */
+    PartyID: string;
+    Name: string;
+    Email: string | null;
+    AddressLines: string[];
+    City: string | null;
+    State: string | null;
+    PostalCode: string | null;
+    Country: string | null;
+}
+export interface RailInvoiceLine {
+    Description: string;
+    Quantity: number;
+    UnitPrice: number;
+}
+/** One billing unit, ready to send. Built by `ExternalInvoiceBehavior.BuildExternalInvoicePayload`. */
+export interface RailInvoiceFacts {
+    /** The frozen document number — `ORD-1234`, `ORD-1234-2`. Sent as the rail's invoice number. */
+    DocumentNumber: string;
+    /** `YYYY-MM-DD`. */
+    InvoiceDate: string;
+    /** `YYYY-MM-DD`, or null for "on receipt". */
+    DueDate: string | null;
+    /** What the lines must total, to the cent. */
+    Amount: number;
+    ExternalCustomerRef: string;
+    Lines: RailInvoiceLine[];
+    Memo: string | null;
+}
+/** The rail's own view of an invoice we issued. */
+export interface RailInvoiceSnapshot {
+    ExternalInvoiceRef: string;
+    InvoiceNumber: string | null;
+    Total: number;
+    /** What is still owed on the rail's books, net of applied credits and payments (cleared or scheduled). */
+    DueAmount: number;
+    /** Payment promised but not yet cleared. */
+    ScheduledAmount: number;
+    Status: string | null;
+    Archived: boolean;
+}
+/** One receivable payment as the rail reports it. `InvoicePayments` is the fan-out to our invoices. */
+export interface RailPaymentRecord {
+    ExternalPaymentRef: string;
+    ExternalCustomerRef: string | null;
+    Amount: number;
+    UnappliedAmount: number;
+    /** `YYYY-MM-DD` when known. */
+    PaymentDate: string | null;
+    /** The rail's status string, verbatim — classified by `ExternalPaymentBehavior`, never here. */
+    Status: string | null;
+    /** True when the rail moved the money itself; false when a person recorded money that arrived elsewhere. */
+    OnlinePayment: boolean | null;
+    /**
+     * ISO-4217 as the rail reports it, or null when it reports none.
+     *
+     * Orders books a capture in the receiving company's functional currency and applies no rate, so a
+     * payment in anything else must be REFUSED rather than booked one-for-one. Null is treated as
+     * "the rail did not say", which the poller resolves against the company rather than assuming.
+     */
+    CurrencyCode: string | null;
+    ReceivablesType: string | null;
+    /** The rail's updated-time, ISO — the watermark candidate. */
+    UpdatedAt: string | null;
+    InvoicePayments: Array<{
+        ExternalInvoiceRef: string;
+        Amount: number;
+        PaymentDate: string | null;
+    }>;
+    /** The record as received, for the audit trail. */
+    Raw: Record<string, unknown>;
+}
+/**
+ * Success carries the value; refusal carries a reason and whether trying again could change the
+ * answer. `Transient: true` is a timeout, a 5xx, a lost session. `Transient: false` is "the customer
+ * has no email" — retrying that is noise.
+ */
+export type RailResult<T> = {
+    Success: true;
+    Value: T;
+} | {
+    Success: false;
+    Reason: string;
+    Transient: boolean;
+};
+/** What the resolver reads off the `PaymentProvider` row and hands to the rail. */
+export interface InvoiceRailConfig {
+    PaymentProviderID: string;
+    TypeCode: string;
+    CompanyID: string;
+    Name: string;
+    IsLiveMode: boolean;
+    /** The `MJ: Company Integrations` row the connector resolves credentials from. */
+    CompanyIntegrationID: string | null;
+}
+export declare class BaseInvoiceRail {
+    Config: InvoiceRailConfig;
+    Provider?: IMetadataProvider;
+    User?: UserInfo;
+    /**
+     * Is this rail configured well enough to be called at all? Resolves the integration row and the
+     * credential's environment; makes NO network call. A refusal here is a CONFIGURATION fault the
+     * operations raise as an error (no row written, nothing marked Failed), so a bad provider row
+     * cannot poison every unit in a sweep — and a preview run surfaces it before go-live.
+     */
+    CheckConfiguration(): Promise<RailResult<true>>;
+    EnsureCustomer(_facts: RailCustomerFacts): Promise<RailResult<{
+        ExternalCustomerRef: string;
+    }>>;
+    IssueInvoice(_facts: RailInvoiceFacts): Promise<RailResult<{
+        ExternalInvoiceRef: string;
+    }>>;
+    GetInvoice(_externalInvoiceRef: string): Promise<RailResult<RailInvoiceSnapshot | null>>;
+    CancelInvoice(_externalInvoiceRef: string): Promise<RailResult<{
+        Archived: true;
+    }>>;
+    FetchPaymentsSince(_watermark: string | null): Promise<RailResult<{
+        Payments: RailPaymentRecord[];
+        NewWatermark: string | null;
+    }>>;
+    protected notImplemented<T>(what: string): RailResult<T>;
+}
+/** Tree-shaking anchor for the base — keeps the class reachable for the resolver's fallback check. */
+export declare function LoadBaseInvoiceRail(): void;
+//# sourceMappingURL=BaseInvoiceRail.d.ts.map

package/dist/BaseInvoiceRail.d.ts.map

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

package/dist/BaseInvoiceRail.js

@@ -0,0 +1,41 @@
+export class BaseInvoiceRail {
+    /**
+     * Is this rail configured well enough to be called at all? Resolves the integration row and the
+     * credential's environment; makes NO network call. A refusal here is a CONFIGURATION fault the
+     * operations raise as an error (no row written, nothing marked Failed), so a bad provider row
+     * cannot poison every unit in a sweep — and a preview run surfaces it before go-live.
+     */
+    async CheckConfiguration() {
+        return { Success: true, Value: true };
+    }
+    async EnsureCustomer(_facts) {
+        return this.notImplemented('ensuring a customer');
+    }
+    async IssueInvoice(_facts) {
+        return this.notImplemented('issuing an invoice');
+    }
+    async GetInvoice(_externalInvoiceRef) {
+        return this.notImplemented('reading an invoice');
+    }
+    async CancelInvoice(_externalInvoiceRef) {
+        return this.notImplemented('cancelling an invoice');
+    }
+    async FetchPaymentsSince(_watermark) {
+        return this.notImplemented('fetching payments');
+    }
+    notImplemented(what) {
+        const code = this.Config?.TypeCode ?? 'unknown';
+        return {
+            Success: false,
+            Transient: false,
+            Reason: `The '${code}' invoice rail does not implement ${what}. Register a subclass with ` +
+                `@RegisterClass(BaseInvoiceRail, '${code}') and call its Load* anchor from the server bootstrap — ` +
+                `without the anchor the decorator is tree-shaken away and the class is silently absent.`,
+        };
+    }
+}
+/** Tree-shaking anchor for the base — keeps the class reachable for the resolver's fallback check. */
+export function LoadBaseInvoiceRail() {
+    void BaseInvoiceRail;
+}
+//# sourceMappingURL=BaseInvoiceRail.js.map

package/dist/BaseInvoiceRail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseInvoiceRail.js","sourceRoot":"","sources":["../src/BaseInvoiceRail.ts"],"names":[],"mappings":"AA8HA,MAAM,OAAO,eAAe;IAKxB;;;;;OAKG;IACI,KAAK,CAAC,kBAAkB;QAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,MAAyB;QACjD,OAAO,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IACtD,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,MAAwB;QAC9C,OAAO,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,mBAA2B;QAC/C,OAAO,IAAI,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;IACrD,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,mBAA2B;QAClD,OAAO,IAAI,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;IACxD,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAC3B,UAAyB;QAEzB,OAAO,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IACpD,CAAC;IAES,cAAc,CAAI,IAAY;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,SAAS,CAAC;QAChD,OAAO;YACH,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,MAAM,EACF,QAAQ,IAAI,qCAAqC,IAAI,6BAA6B;gBAClF,oCAAoC,IAAI,2DAA2D;gBACnG,wFAAwF;SAC/F,CAAC;IACN,CAAC;CACJ;AAED,sGAAsG;AACtG,MAAM,UAAU,mBAAmB;IAC/B,KAAK,eAAe,CAAC;AACzB,CAAC"}

package/dist/BasePaymentProvider.d.ts

@@ -94,6 +94,8 @@ export interface CaptureRequest {
     /** Omit for the full authorised amount. Major units. */
     Amount?: number;
     CurrencyCode: string;
+    /** The gift card being spent, when the tender is one. Only the stored-value driver reads it. */
+    StoredValueAccountID?: string | null;
 }
 export interface RetrieveIntentRequest {
     ProviderIntentID: string;
@@ -207,6 +209,14 @@ export declare class BasePaymentProvider {
      * switch would invite exactly that.
      */
     get SettlesAsynchronously(): boolean;
+    /**
+     * Whether capturing a payment against this provider means asking the gateway to MOVE money.
+     * True for a till (Stripe): capture calls the gateway and needs an intent. False for a rail that
+     * collected the money on its own (Bill.com): the payment is RECORDED, not collected, so there is no
+     * intent and nothing to capture — `PaymentHeaderEntityServer` books it like a check, but keeps
+     * `PaymentProviderID` so the money stays attributed to the rail it arrived on.
+     */
+    get CollectsAtCapture(): boolean;
     CreateIntent(_request: CreateIntentRequest): Promise<CreateIntentResult>;
     Capture(_request: CaptureRequest): Promise<CaptureResult>;
     /**

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

@@ -43,6 +43,16 @@ export class BasePaymentProvider {
     get SettlesAsynchronously() {
         return false;
     }
+    /**
+     * Whether capturing a payment against this provider means asking the gateway to MOVE money.
+     * True for a till (Stripe): capture calls the gateway and needs an intent. False for a rail that
+     * collected the money on its own (Bill.com): the payment is RECORDED, not collected, so there is no
+     * intent and nothing to capture — `PaymentHeaderEntityServer` books it like a check, but keeps
+     * `PaymentProviderID` so the money stays attributed to the rail it arrived on.
+     */
+    get CollectsAtCapture() {
+        return true;
+    }
     async CreateIntent(_request) {
         return { Success: false, Reason: this.notImplemented('creating a payment intent') };
     }

package/dist/BasePaymentProvider.js.map

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

package/dist/BillComGateway.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview The connector-facing seam for Bill.com.
+ *
+ * Everything that touches `@memberjunction/connector-bill-com` goes through here, for two reasons:
+ *
+ *   1. The rail can be unit-tested with the wire stubbed — `UseBillComGatewaySeams` swaps the whole
+ *      surface, the same way `AccountingERPEngine.UseSeams` does for the ERP verbs. Standing up a
+ *      fake Bill.com over HTTP and asserting against our own mock would prove less.
+ *   2. There is exactly one place that knows how an `MJ: Company Integrations` row becomes a live
+ *      connector instance (`ConnectorFactory.Resolve` on the `MJ: Integrations` row behind it), and
+ *      how the connector's generic verbs are spelled. The connector ships no domain methods — create
+ *      customer, create invoice and read payments are all the engine's metadata-driven CRUD.
+ *
+ * CREDENTIALS NEVER PASS THROUGH HERE. The connector reads them itself from the Company Integration's
+ * `CredentialID`. The only credential fact this file reads is the `environment` flag, so the rail can
+ * refuse a live provider row pointed at a sandbox credential (design §7).
+ *
+ * PAGINATION IS DRAINED HERE. The engine's `FetchChanges` returns one page and a cursor; the poller
+ * wants "everything since the watermark", so the default gateway walks the pages. The hard stop of
+ * 200 pages (20,000 rows) is a fuse, not a target — a payments object that large in one pass means
+ * the watermark is wrong.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import type { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import type { MJCompanyIntegrationEntity } from '@memberjunction/core-entities';
+import { type CRUDResult, type ExternalRecord, type FetchBatchResult } from '@memberjunction/integration-engine';
+export interface BillComGatewaySeams {
+    loadCompanyIntegration(companyIntegrationID: string, provider: IMetadataProvider, user: UserInfo): Promise<MJCompanyIntegrationEntity>;
+    /**
+     * Which BILL gateway this connection actually talks to.
+     *
+     * `Known` carries `'sandbox'` or `'production'`; `Unknown` carries why it could not be read. It is a
+     * discriminated result rather than a nullable string because the caller must REFUSE on Unknown —
+     * an environment nobody can read is exactly the case where sandbox money gets recorded as cash.
+     */
+    loadCredentialEnvironment(ci: MJCompanyIntegrationEntity, provider: IMetadataProvider, user: UserInfo): Promise<RailEnvironment>;
+    createRecord(ci: MJCompanyIntegrationEntity, object: string, attrs: Record<string, unknown>, user: UserInfo): Promise<CRUDResult>;
+    updateRecord(ci: MJCompanyIntegrationEntity, object: string, externalID: string, attrs: Record<string, unknown>, user: UserInfo): Promise<CRUDResult>;
+    getRecord(ci: MJCompanyIntegrationEntity, object: string, externalID: string, user: UserInfo): Promise<ExternalRecord | null>;
+    /** Every record changed since the watermark, all pages drained. */
+    fetchChanges(ci: MJCompanyIntegrationEntity, object: string, watermark: string | null, user: UserInfo): Promise<FetchBatchResult>;
+    /**
+     * `POST /invoices/{id}/archive` — BILL's only way to archive an invoice. Verified live 2026-09-21
+     * (spike S1): `PUT {archived:true}` is refused with 400 because PUT is a full replace that demands
+     * `customer` and `invoiceLineItems`; the archive verb returns 200 with `archived: true`,
+     * `recordStatus: INACTIVE`, and is idempotent. Delegates to the connector's own `ArchiveInvoice`
+     * since 0.3.2 (Integrations #391); earlier builds have no such verb and this refuses with a
+     * sentence rather than failing obscurely.
+     */
+    archiveInvoice(ci: MJCompanyIntegrationEntity, externalID: string, user: UserInfo): Promise<CRUDResult>;
+}
+/** Swap the wire for tests. Pass null to restore the real connector path. */
+export declare function UseBillComGatewaySeams(s: BillComGatewaySeams | null): void;
+export declare function CurrentBillComGatewaySeams(): BillComGatewaySeams | null;
+/** `sandbox` or `production`, or the reason it could not be determined. Never a silent default. */
+export type RailEnvironment = {
+    Known: true;
+    Environment: 'sandbox' | 'production';
+} | {
+    Known: false;
+    Reason: string;
+};
+/**
+ * Read the effective environment out of a credential or Configuration blob.
+ *
+ * `apiUrl` OUTRANKS `environment`, because it outranks it in the connector: `ResolveBaseURL` uses an
+ * explicit apiUrl and only falls back to the environment string. Trusting `environment` alone let
+ * `{environment: 'production', apiUrl: '<stage>'}` pass a live provider's check and then talk to
+ * sandbox — and the reverse, which is the one that records play money as revenue.
+ */
+export declare function environmentFrom(blob: string | null | undefined, whereFrom: string): RailEnvironment;
+/**
+ * BILL reports validation failures as an ARRAY of `{severity, message}` (seen live: PUT without a
+ * customer → `[{message: "customer: must not be null"}, …]`), which the engine's `ExtractErrorMessage`
+ * does not read. Joins those; falls back to `message`/`error` on an object; null when there is no text.
+ */
+export declare function billComErrorText(body: unknown): string | null;
+export declare function DefaultBillComGateway(provider: IMetadataProvider): BillComGatewaySeams;
+/** The gateway to use: the test seams when set, else the real connector path. */
+export declare function BillComGateway(provider: IMetadataProvider): BillComGatewaySeams;
+//# sourceMappingURL=BillComGateway.d.ts.map

package/dist/BillComGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BillComGateway.d.ts","sourceRoot":"","sources":["../src/BillComGateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,0BAA0B,EAA2C,MAAM,+BAA+B,CAAC;AACzH,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGnI,MAAM,WAAW,mBAAmB;IAChC,sBAAsB,CAAC,oBAAoB,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvI;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,EAAE,0BAA0B,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjI,YAAY,CAAC,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClI,YAAY,CAAC,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtJ,SAAS,CAAC,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9H,mEAAmE;IACnE,YAAY,CAAC,EAAE,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClI;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,EAAE,0BAA0B,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3G;AAaD,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,GAAG,IAAI,CAEvE;AAED,mGAAmG;AACnG,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,SAAS,GAAG,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAoBnG;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW7D;AAeD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,mBAAmB,CAiFtF;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,mBAAmB,CAE/E"}