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

package/dist/CapturePaymentOperation.js

@@ -0,0 +1,463 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview `Orders.CapturePayment` — take a payment and allocate it, in one transaction.
+ *
+ * WHY THIS EXISTS AT ALL. A payment is a HEADER plus its ALLOCATION LINES, and
+ * `PaymentHeaderEntityServer.Lines` is a TRANSIENT collection rather than a column. CodeGen cannot
+ * emit it on the client entity, so a browser `entity.Save()` has nowhere to put the allocations.
+ * That is precisely the situation `Orders.SaveOrder` was built for, and it needs the same answer.
+ *
+ * A two-step create-then-allocate flow was rejected: between the steps there would be a captured
+ * payment with no allocations in the database — cash recorded against nothing — and any failure in
+ * the second step would leave it there permanently.
+ *
+ * READ WHAT THE ENGINE COMPUTED; DO NOT RECOMPUTE. The fee, the net, and every order rollup are
+ * read back from the saved rows. Recomputing them here would eventually disagree with the ledger,
+ * and the disagreement surfaces as a balanced journal entry for the wrong amount — which nothing
+ * downstream can catch.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { BaseRemotableOperation, RunView, } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { OrdersCapturePaymentOperation as OrdersCapturePaymentOperationBase, } from '@mj-biz-apps/orders-entities';
+import { RequireOptionalUUID, RequireUUID } from './sql-guards.js';
+import { ResolvePaymentProvider } from './PaymentProviderResolver.js';
+import { LoadOrdersEngine, OrdersEngine } from '@mj-biz-apps/orders-entities';
+const PAYMENT_HEADER_ENTITY = 'MJ_BizApps_Orders: Payment Headers';
+const PAYMENT_LINE_ENTITY = 'MJ_BizApps_Orders: Payment Lines';
+const PAYMENT_DETAIL_ENTITY = 'MJ_BizApps_Orders: Payment Details';
+const PAYMENT_TYPE_ENTITY = 'MJ_BizApps_Orders: Payment Types';
+const ORDER_HEADER_ENTITY = 'MJ_BizApps_Orders: Order Headers';
+const money = (n) => Math.round((Number(n) + Number.EPSILON) * 100) / 100;
+const key = (id) => (id ?? '').toLowerCase();
+const quote = (ids) => [...new Set(ids.map((i) => `'${i}'`))].join(',');
+let CapturePaymentOperation = class CapturePaymentOperation extends OrdersCapturePaymentOperationBase {
+    async InternalExecute(input, provider, user) {
+        const blockers = [];
+        const rv = new RunView(provider);
+        // ── 1. VALIDATE AT THE BOUNDARY ──
+        // The page checks these before emitting, but this is the trust boundary and must not rely on
+        // that. Ids are validated because they reach SQL filter text: `GetOverdueWorklist`
+        // interpolated a caller-supplied id straight into ExtraFilter, and `' OR 1=1 --` widened the
+        // result set rather than erroring.
+        let receivingCompanyID;
+        try {
+            receivingCompanyID = RequireUUID(input?.ReceivingCompanyID, 'ReceivingCompanyID');
+        }
+        catch (e) {
+            return this.refuse([this.blocker('BadCompanyID', String(e.message))]);
+        }
+        // Validated at the boundary like every other caller-supplied id, even though this one reaches
+        // an entity Set() rather than a filter: the FilterInjection guard is a floor, not a ceiling,
+        // and an id that is not an id should be refused where the caller can still read the reason.
+        try {
+            RequireOptionalUUID(input?.PaymentIntentID, 'PaymentIntentID');
+        }
+        catch (e) {
+            return this.refuse([this.blocker('BadPaymentIntentID', String(e.message))]);
+        }
+        const allocations = input?.Allocations ?? [];
+        if (!allocations.length) {
+            blockers.push(this.blocker('NoAllocations', 'A payment must say where the money lands. Send at least one allocation.', 'Allocate the payment to one or more orders before capturing.'));
+        }
+        // Validated even though these are Set() onto an entity rather than interpolated into a
+        // filter. The guard test enforces "every caller-supplied id is checked" with no exceptions,
+        // which is the right rule: an id that is safe because of where it happens to be used today
+        // stops being safe the moment somebody reads it back in a query.
+        let orgID = null;
+        let personID = null;
+        try {
+            orgID = input?.BillToOrganizationID ? RequireUUID(input.BillToOrganizationID, 'BillToOrganizationID') : null;
+            personID = input?.BillToPersonID ? RequireUUID(input.BillToPersonID, 'BillToPersonID') : null;
+        }
+        catch (e) {
+            return this.refuse([this.blocker('BadPayerID', String(e.message))]);
+        }
+        if (!!orgID === !!personID) {
+            blockers.push(this.blocker('PayerAmbiguous', orgID
+                ? 'A payment names ONE payer. Both an organization and a person were given.'
+                : 'A payment names one payer. Neither an organization nor a person was given.', 'Set exactly one of BillToOrganizationID or BillToPersonID.'));
+        }
+        for (const [i, a] of allocations.entries()) {
+            try {
+                RequireUUID(a?.OrderHeaderID, `Allocations[${i}].OrderHeaderID`);
+                if (a?.OrderLineID)
+                    RequireUUID(a.OrderLineID, `Allocations[${i}].OrderLineID`);
+            }
+            catch (e) {
+                blockers.push(this.blocker('BadOrderID', String(e.message)));
+                continue;
+            }
+            if (!(Number(a?.Amount ?? 0) > 0)) {
+                blockers.push(this.blocker('NonPositiveAllocation', `Allocation ${i + 1} is for ${a?.Amount ?? 0}. Every allocation must be a positive amount — ` +
+                    `un-applying money is a different operation.`));
+            }
+        }
+        // D68: the amount received must equal what was allocated. A mismatch means either cash
+        // recorded against nothing, or an order credited with money that never arrived. Refused
+        // rather than silently adjusted, because both directions are wrong in ways that reconcile.
+        const amount = money(Number(input?.Amount ?? 0));
+        const allocated = money(allocations.reduce((s, a) => s + Number(a?.Amount ?? 0), 0));
+        if (!(amount > 0)) {
+            blockers.push(this.blocker('NonPositiveAmount', `A payment must be for a positive amount, got ${amount}.`));
+        }
+        else if (amount !== allocated) {
+            blockers.push(this.blocker('AllocationMismatch', `The payment is for ${amount} but its allocations total ${allocated}, leaving ` +
+                `${money(amount - allocated)} unaccounted for. Every part of a payment must land on an order (D68).`, 'Adjust the allocations so they sum to the amount received.'));
+        }
+        if (blockers.length)
+            return this.refuse(blockers);
+        // ── 2. IDEMPOTENCY ──
+        // Checked BEFORE any write. A repeat call returns the ORIGINAL payment rather than taking
+        // money again or reporting a spurious failure.
+        //
+        // THIS LOOKUP IS AN OPTIMISATION, NOT THE GUARANTEE — and mutation testing proved it.
+        // Disabling this block alone leaves CP9 passing, because the insert then hits
+        // UX_PaymentHeader_IdempotencyKey and the duplicate-key handler below returns the original
+        // payment anyway. CP9 only fails when BOTH are disabled. The two are deliberately redundant:
+        // the INDEX is what makes a genuine race safe (two concurrent requests, neither having seen
+        // the other's row), while this lookup makes the common case — a user double-clicking a
+        // second later — cheap and legible rather than a caught exception.
+        const idempotencyKey = (input?.IdempotencyKey ?? '').trim() || null;
+        if (idempotencyKey && !input?.Preview) {
+            const existing = await rv.RunView({
+                EntityName: PAYMENT_HEADER_ENTITY,
+                ExtraFilter: `IdempotencyKey = '${idempotencyKey.replace(/'/g, "''")}'`,
+                ResultType: 'simple',
+            }, user);
+            const found = existing.Results?.[0];
+            if (found) {
+                const out = await this.project(found.ID, provider, user, rv);
+                return { ...out, WasRetry: true, IdempotencyKey: idempotencyKey };
+            }
+        }
+        // ── 3. RESOLVE THE TENDER ──
+        // By code, so the client does not have to resolve a lookup to take money. An unknown code is
+        // refused by NAME rather than falling back to a default: a payment silently recorded as the
+        // wrong kind is invisible until somebody reconciles.
+        //
+        // Read from the lookup cache rather than queried per capture: payment types are eleven rows
+        // of seeded metadata read on every payment, and `Code` is unique, so the `IsActive` filter
+        // that used to live in the SQL is the same test applied here.
+        const code = (input?.TenderCode ?? '').trim();
+        await LoadOrdersEngine(provider, user);
+        const cachedTender = OrdersEngine.Instance.PaymentTypeByCode(code);
+        const tenderRow = cachedTender?.IsActive ? cachedTender : undefined;
+        if (!tenderRow) {
+            return this.refuse([
+                this.blocker('UnknownTender', `There is no active payment type with code '${code}'.`, 'Payment types are seeded metadata — check the code, or add the type.'),
+            ]);
+        }
+        if (tenderRow.IsReversal) {
+            return this.refuse([
+                this.blocker('ReversalTender', `'${code}' is a REVERSAL payment type and cannot be used to take money. Use Orders.RefundPayment.`),
+            ]);
+        }
+        // ── 4. THE ORDERS MUST EXIST AND BELONG TO THE RECEIVING COMPANY ──
+        const orderIDs = [...new Set(allocations.map((a) => a.OrderHeaderID))];
+        const orders = await rv.RunView({ EntityName: ORDER_HEADER_ENTITY, ExtraFilter: `ID IN (${quote(orderIDs)})`, ResultType: 'simple' }, user);
+        const orderByID = new Map((orders.Results ?? []).map((o) => [key(o.ID), o]));
+        for (const id of orderIDs) {
+            const order = orderByID.get(key(id));
+            if (!order) {
+                blockers.push(this.blocker('OrderNotFound', `Order ${id} does not exist.`));
+            }
+            else if (key(order.CompanyID) !== key(receivingCompanyID)) {
+                // Cash collected by one company against another's order is the intercompany case,
+                // and it is handled by ALLOCATION, not by mis-stating who received the money.
+                blockers.push(this.blocker('OrderCompanyMismatch', `Order ${order.OrderNumber} belongs to a different company than the one receiving this payment.`, 'Capture against the company that owns the order, or allocate across companies from that side.'));
+            }
+        }
+        if (blockers.length)
+            return this.refuse(blockers);
+        // ── 5. WRITE ──
+        // Preview runs the REAL capture and rolls back. Not a second model of the arithmetic: a
+        // preview that reimplements the calculation eventually disagrees with the capture.
+        const dbProvider = provider;
+        const preview = !!input?.Preview;
+        await dbProvider.BeginTransaction();
+        try {
+            const paymentID = await this.writePayment(input, { receivingCompanyID, paymentTypeID: tenderRow.ID, amount, idempotencyKey }, provider, user);
+            const out = await this.project(paymentID, provider, user, rv);
+            if (preview) {
+                await dbProvider.RollbackTransaction();
+                return { ...out, WasPreview: true, IdempotencyKey: idempotencyKey };
+            }
+            await dbProvider.CommitTransaction();
+            return { ...out, WasPreview: false, WasRetry: false, IdempotencyKey: idempotencyKey };
+        }
+        catch (e) {
+            await dbProvider.RollbackTransaction();
+            const message = String(e?.message ?? e);
+            // A UNIQUE violation on the token means a concurrent request won the race — which is the
+            // index doing its job. Report it as a retry rather than a failure.
+            if (idempotencyKey && /UX_PaymentHeader_IdempotencyKey|duplicate key/i.test(message)) {
+                const again = await rv.RunView({
+                    EntityName: PAYMENT_HEADER_ENTITY,
+                    ExtraFilter: `IdempotencyKey = '${idempotencyKey.replace(/'/g, "''")}'`,
+                    ResultType: 'simple',
+                }, user);
+                const found = again.Results?.[0];
+                if (found) {
+                    const out = await this.project(found.ID, provider, user, rv);
+                    return { ...out, WasRetry: true, IdempotencyKey: idempotencyKey };
+                }
+            }
+            return this.refuse([this.blocker('CaptureFailed', message)]);
+        }
+    }
+    /**
+     * Header + detail + allocation lines, saved ONCE.
+     *
+     * The allocations go onto the transient `Lines` collection and are written inside the header's
+     * own transaction — the whole reason this operation exists. Status is set to Captured BEFORE the
+     * save, because `savePendingLines` books from that collection and a header saved Pending would
+     * persist its lines without booking anything.
+     */
+    async writePayment(input, ctx, provider, user) {
+        // The SERVER subclass: `Lines` (set below) lives there, and the class factory returns it for
+        // this key regardless of what we ask for.
+        const header = await provider.GetEntityObject(PAYMENT_HEADER_ENTITY, user);
+        header.NewRecord();
+        // A payment number is a cash-receipt document number, minted gap-consciously from the same
+        // PaymentSequence the confirm path and the account-credit path use — one sequence, so the
+        // numbers a customer sees never collide or skip regardless of which door the payment came in.
+        header.PaymentNumber = await this.nextPaymentNumber(provider);
+        header.ReceivingCompanyID = ctx.receivingCompanyID;
+        header.PaymentTypeID = ctx.paymentTypeID;
+        header.Amount = ctx.amount;
+        header.PaymentDate = input?.PaymentDate ? new Date(input.PaymentDate) : new Date();
+        if (input?.BillToOrganizationID)
+            header.BillToOrganizationID = input.BillToOrganizationID;
+        if (input?.BillToPersonID)
+            header.BillToPersonID = input.BillToPersonID;
+        if (input?.Reference)
+            header.Description = input.Reference;
+        if (input?.Notes)
+            header.Notes = input.Notes;
+        if (ctx.idempotencyKey)
+            header.IdempotencyKey = ctx.idempotencyKey;
+        // The instrument, when the tender needs one. Its own row (D38/D39): a payment gets its OWN
+        // copy rather than pointing at a wallet entry that can later change.
+        if (input?.PaymentDetail) {
+            const detail = await provider.GetEntityObject(PAYMENT_DETAIL_ENTITY, user);
+            detail.NewRecord();
+            detail.CompanyID = ctx.receivingCompanyID;
+            detail.PaymentTypeID = ctx.paymentTypeID;
+            if (input.PaymentDetail.ReferenceNumber)
+                detail.ReferenceNumber = input.PaymentDetail.ReferenceNumber;
+            if (input.PaymentDetail.ProviderInstrumentRef) {
+                detail.ProviderInstrumentRef = input.PaymentDetail.ProviderInstrumentRef;
+            }
+            if (input.PaymentDetail.SourceCustomerPaymentMethodID) {
+                detail.SourceCustomerPaymentMethodID = input.PaymentDetail.SourceCustomerPaymentMethodID;
+            }
+            if (input.PaymentDetail.InstrumentDate)
+                detail.InstrumentDate = new Date(input.PaymentDetail.InstrumentDate);
+            if (!(await detail.Save())) {
+                throw new Error(`Could not record the payment instrument: ${detail.LatestResult?.CompleteMessage ?? 'no reason given'}`);
+            }
+            header.PaymentDetailID = detail.ID;
+            if (input.PaymentDetail.PaymentProviderID) {
+                header.PaymentProviderID = input.PaymentDetail.PaymentProviderID;
+            }
+        }
+        // THE LINK THAT MAKES A GATEWAY CAPTURE POSSIBLE. `settleWithProvider` reads the gateway's own
+        // intent string through this row; without it a provider-backed payment is refused with
+        // "there is nothing for the gateway to capture", which is precisely the state this whole path
+        // sat in before `Orders.OpenPaymentIntent` existed.
+        if (input?.PaymentIntentID) {
+            header.PaymentIntentID = input.PaymentIntentID;
+        }
+        const lines = [];
+        for (const a of input?.Allocations ?? []) {
+            const line = await provider.GetEntityObject(PAYMENT_LINE_ENTITY, user);
+            line.NewRecord();
+            line.OrderHeaderID = a.OrderHeaderID;
+            line.Amount = money(Number(a.Amount));
+            if (a.OrderLineID)
+                line.OrderLineID = a.OrderLineID;
+            line.AllocatedAt = new Date();
+            if (user?.ID)
+                line.AllocatedByUserID = user.ID;
+            lines.push(line);
+        }
+        // Attached, not assigned — the collection stamps the foreign key.
+        for (const line of lines)
+            header.Lines.Add(line);
+        // CAPTURED FOR EVERY RAIL THAT ANSWERS IMMEDIATELY. `savePendingLines` books each allocation
+        // from this collection, and a header saved Pending would persist the lines with nothing
+        // booked — a captured payment with no cash leg, which balances and is wrong.
+        //
+        // PENDING FOR A RAIL THAT DOES NOT (D77). A bank debit has moved no money when this runs: the
+        // bank answers days later. Writing `Captured` would send `settleWithProvider` to a driver whose
+        // Capture is a READ, which correctly refuses an intent that is still processing — so the whole
+        // capture would fail and there would be no way to record the debit at all. `Pending` records
+        // exactly what is true (submitted, waiting), the allocations persist unbooked, and the webhook
+        // promotes it when the bank confirms — at which point `bookPersistedLines` settles the cash
+        // leg. The debt is deliberate and is discharged in exactly one place.
+        const settlesLate = await this.settlesAsynchronously(header, provider, user);
+        header.Status = settlesLate ? 'Pending' : 'Captured';
+        if (!(await header.Save())) {
+            throw new Error(`Could not capture the payment: ${header.LatestResult?.CompleteMessage ?? 'no reason given'}`);
+        }
+        return header.ID;
+    }
+    /**
+     * Whether this payment's gateway settles on someone else's schedule.
+     *
+     * Asked of the DRIVER, not of configuration — see `BasePaymentProvider.SettlesAsynchronously` for
+     * why an operator must not be able to declare that ACH settles instantly.
+     *
+     * FALSE WHEN ANYTHING GOES WRONG, deliberately. A payment with no provider is a recorded one
+     * (cheque, cash) and captures immediately; a provider that cannot be resolved is a configuration
+     * fault that the save path is about to report far more clearly than a status guess here would.
+     * Defaulting to the existing behaviour keeps every rail that worked before working unchanged.
+     */
+    async settlesAsynchronously(header, provider, user) {
+        const providerID = header.PaymentProviderID;
+        if (!providerID)
+            return false;
+        try {
+            const driver = await ResolvePaymentProvider(providerID, provider, user);
+            return driver.SettlesAsynchronously === true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Read back what the engine computed.
+     *
+     * Every number here comes from the saved rows — the fee the driver decided, the rollups the
+     * triggers moved. Nothing is recalculated, because a second calculation is a second opinion, and
+     * the one that reaches the screen would not be the one in the ledger.
+     */
+    async project(paymentID, provider, user, rv) {
+        const header = await rv.RunView({ EntityName: PAYMENT_HEADER_ENTITY, ExtraFilter: `ID = '${paymentID}'`, ResultType: 'simple' }, user);
+        const row = header.Results?.[0];
+        if (!row) {
+            return this.refuse([this.blocker('PaymentNotFound', `Payment ${paymentID} could not be read back.`)]);
+        }
+        const lines = await rv.RunView({ EntityName: PAYMENT_LINE_ENTITY, ExtraFilter: `PaymentHeaderID = '${paymentID}'`, ResultType: 'simple' }, user);
+        const orderIDs = [...new Set((lines.Results ?? []).map((l) => l.OrderHeaderID))];
+        const effects = [];
+        if (orderIDs.length) {
+            const orders = await rv.RunView({ EntityName: ORDER_HEADER_ENTITY, ExtraFilter: `ID IN (${quote(orderIDs)})`, ResultType: 'simple' }, user);
+            for (const o of orders.Results ?? []) {
+                effects.push({
+                    OrderHeaderID: o.ID,
+                    OrderNumber: o.OrderNumber,
+                    AmountPaid: money(Number(o.AmountPaid ?? 0)),
+                    Balance: money(Number(o.Balance ?? 0)),
+                    PaymentStatus: o.PaymentStatus,
+                    // Over-payment is ACCEPTED (D68). The surplus is a negative balance and becomes
+                    // spendable credit — the account-credit screen depends on these existing.
+                    HasCredit: Number(o.Balance ?? 0) < 0,
+                });
+            }
+        }
+        const entries = await this.readEntries(paymentID, provider, user, rv);
+        return {
+            Success: true,
+            PaymentHeaderID: row.ID,
+            PaymentNumber: row.PaymentNumber,
+            Status: row.Status,
+            Amount: money(Number(row.Amount ?? 0)),
+            ProcessingFeeAmount: money(Number(row.ProcessingFeeAmount ?? 0)),
+            NetAmount: money(Number(row.NetAmount ?? row.Amount ?? 0)),
+            OrderEffects: effects,
+            JournalEntries: entries,
+            EntryCount: entries.length,
+            AllBalanced: entries.every((e) => e.Balanced),
+            Blockers: [],
+        };
+    }
+    /** The entries this payment's allocations produced, found through accounting's D25 provenance pair. */
+    async readEntries(paymentID, provider, user, rv) {
+        const rows = await rv.RunView({
+            EntityName: 'MJ_BizApps_Accounting: Journal Entry Lines',
+            ExtraFilter: `JournalEntryID IN (SELECT je.ID FROM __mj_BizAppsAccounting.JournalEntry je ` +
+                `WHERE LOWER(je.LinkedRecordID) IN (SELECT LOWER(CAST(pl.ID AS NVARCHAR(400))) ` +
+                `FROM __mj_BizAppsOrders.PaymentLine pl WHERE pl.PaymentHeaderID = '${paymentID}') ` +
+                `OR LOWER(je.LinkedRecordID) = LOWER('${paymentID}'))`,
+            ResultType: 'simple',
+        }, user).catch(() => ({ Results: [] }));
+        const byEntry = new Map();
+        for (const r of (rows.Results ?? [])) {
+            const id = String(r.JournalEntryID ?? r.EntryID ?? '');
+            if (!id)
+                continue;
+            let entry = byEntry.get(key(id));
+            if (!entry) {
+                entry = {
+                    CompanyID: String(r.CompanyID ?? ''),
+                    CompanyName: String(r.Company ?? ''),
+                    JournalEntryID: id,
+                    EntryType: String(r.EntryType ?? 'PaymentCapture'),
+                    Balanced: true,
+                    Lines: [],
+                };
+                byEntry.set(key(id), entry);
+            }
+            const debit = Number(r.DebitAmount ?? 0);
+            const credit = Number(r.CreditAmount ?? 0);
+            entry.Lines.push({
+                Side: debit > 0 ? 'Dr' : 'Cr',
+                AccountRole: String(r.Code ?? ''),
+                AccountName: String(r.GLAccount ?? r.AccountName ?? ''),
+                Amount: money(debit > 0 ? debit : credit),
+            });
+        }
+        for (const entry of byEntry.values()) {
+            const dr = entry.Lines.filter((l) => l.Side === 'Dr').reduce((s, l) => s + l.Amount, 0);
+            const cr = entry.Lines.filter((l) => l.Side === 'Cr').reduce((s, l) => s + l.Amount, 0);
+            entry.Balanced = Math.abs(money(dr - cr)) < 0.005;
+        }
+        return [...byEntry.values()];
+    }
+    /** Gap-conscious payment numbering — the same sequence every other capture path uses. */
+    async nextPaymentNumber(db) {
+        const rows = (await db.ExecuteSQL(`
+            DECLARE @seq TABLE (Seq INT);
+            UPDATE __mj_BizAppsOrders.PaymentSequence WITH (UPDLOCK, HOLDLOCK)
+            SET NextSequenceNumber = NextSequenceNumber + 1
+            OUTPUT deleted.NextSequenceNumber INTO @seq(Seq)
+            WHERE ID = 1;
+            SELECT Seq FROM @seq;`));
+        const seq = rows?.[0]?.Seq;
+        if (!seq) {
+            throw new Error('Could not obtain the next payment number — PaymentSequence (ID=1) is missing.');
+        }
+        return `PAY-${String(seq).padStart(6, '0')}`;
+    }
+    blocker(code, message, hint) {
+        return { Code: code, Message: message, ResolutionHint: hint ?? null, LineNumber: null };
+    }
+    refuse(blockers) {
+        return {
+            Success: false,
+            Message: blockers.map((b) => b.Message).join(' '),
+            Blockers: blockers,
+            OrderEffects: [],
+            JournalEntries: [],
+            EntryCount: 0,
+            AllBalanced: true,
+        };
+    }
+};
+CapturePaymentOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.CapturePayment')
+], CapturePaymentOperation);
+export { CapturePaymentOperation };
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadCapturePaymentOperation() {
+    // intentionally empty
+}
+//# sourceMappingURL=CapturePaymentOperation.js.map

package/dist/CapturePaymentOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CapturePaymentOperation.js","sourceRoot":"","sources":["../src/CapturePaymentOperation.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAEH,sBAAsB,EACtB,OAAO,GAKV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACH,6BAA6B,IAAI,iCAAiC,GASrE,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE9E,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;AACnE,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAC/D,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;AACnE,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAC/D,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAE/D,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC1F,MAAM,GAAG,GAAG,CAAC,EAA6B,EAAU,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAChF,MAAM,KAAK,GAAG,CAAC,GAAa,EAAU,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAGnF,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,iCAAiC;IAChE,KAAK,CAAC,eAAe,CAC3B,KAAgC,EAChC,QAA2B,EAC3B,IAAc;QAEd,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,QAAuC,CAAC,CAAC;QAEhE,oCAAoC;QACpC,6FAA6F;QAC7F,mFAAmF;QACnF,6FAA6F;QAC7F,mCAAmC;QACnC,IAAI,kBAA0B,CAAC;QAC/B,IAAI,CAAC;YACD,kBAAkB,GAAG,WAAW,CAAC,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;QAED,8FAA8F;QAC9F,6FAA6F;QAC7F,4FAA4F;QAC5F,IAAI,CAAC;YACD,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CACR,eAAe,EACf,yEAAyE,EACzE,8DAA8D,CACjE,CACJ,CAAC;QACN,CAAC;QAED,uFAAuF;QACvF,4FAA4F;QAC5F,2FAA2F;QAC3F,iEAAiE;QACjE,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,CAAC;YACD,KAAK,GAAG,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7G,QAAQ,GAAG,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClG,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CACR,gBAAgB,EAChB,KAAK;gBACD,CAAC,CAAC,0EAA0E;gBAC5E,CAAC,CAAC,4EAA4E,EAClF,4DAA4D,CAC/D,CACJ,CAAC;QACN,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC;gBACD,WAAW,CAAC,CAAC,EAAE,aAAa,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;gBACjE,IAAI,CAAC,EAAE,WAAW;oBAAE,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;YACpF,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxE,SAAS;YACb,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CACR,uBAAuB,EACvB,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC,iDAAiD;oBACzF,6CAA6C,CACpD,CACJ,CAAC;YACN,CAAC;QACL,CAAC;QAED,uFAAuF;QACvF,wFAAwF;QACxF,2FAA2F;QAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,gDAAgD,MAAM,GAAG,CAAC,CAAC,CAAC;QAChH,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CACR,oBAAoB,EACpB,sBAAsB,MAAM,8BAA8B,SAAS,YAAY;gBAC3E,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,wEAAwE,EACxG,4DAA4D,CAC/D,CACJ,CAAC;QACN,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAElD,uBAAuB;QACvB,0FAA0F;QAC1F,+CAA+C;QAC/C,EAAE;QACF,sFAAsF;QACtF,8EAA8E;QAC9E,2FAA2F;QAC3F,6FAA6F;QAC7F,4FAA4F;QAC5F,uFAAuF;QACvF,mEAAmE;QACnE,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QACpE,IAAI,cAAc,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAC7B;gBACI,UAAU,EAAE,qBAAqB;gBACjC,WAAW,EAAE,qBAAqB,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;gBACvE,UAAU,EAAE,QAAQ;aACvB,EACD,IAAI,CACP,CAAC;YACF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC7D,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;YACtE,CAAC;QACL,CAAC;QAED,8BAA8B;QAC9B,6FAA6F;QAC7F,4FAA4F;QAC5F,qDAAqD;QACrD,EAAE;QACF,4FAA4F;QAC5F,2FAA2F;QAC3F,8DAA8D;QAC9D,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,MAAM,CAAC;gBACf,IAAI,CAAC,OAAO,CACR,eAAe,EACf,8CAA8C,IAAI,IAAI,EACtD,sEAAsE,CACzE;aACJ,CAAC,CAAC;QACP,CAAC;QACD,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,MAAM,CAAC;gBACf,IAAI,CAAC,OAAO,CACR,gBAAgB,EAChB,IAAI,IAAI,0FAA0F,CACrG;aACJ,CAAC,CAAC;QACP,CAAC;QAED,qEAAqE;QACrE,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,EACpG,IAAI,CACP,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC;YAChF,CAAC;iBAAM,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC1D,kFAAkF;gBAClF,8EAA8E;gBAC9E,QAAQ,CAAC,IAAI,CACT,IAAI,CAAC,OAAO,CACR,sBAAsB,EACtB,SAAS,KAAK,CAAC,WAAW,sEAAsE,EAChG,+FAA+F,CAClG,CACJ,CAAC;YACN,CAAC;QACL,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAElD,iBAAiB;QACjB,wFAAwF;QACxF,mFAAmF;QACnF,MAAM,UAAU,GAAG,QAA2C,CAAC;QAC/D,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC;QACjC,MAAM,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CACrC,KAAK,EACL,EAAE,kBAAkB,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAC3E,QAAQ,EACR,IAAI,CACP,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YAE9D,IAAI,OAAO,EAAE,CAAC;gBACV,MAAM,UAAU,CAAC,mBAAmB,EAAE,CAAC;gBACvC,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;YACxE,CAAC;YACD,MAAM,UAAU,CAAC,iBAAiB,EAAE,CAAC;YACrC,OAAO,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;QAC1F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,UAAU,CAAC,mBAAmB,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,CAAE,CAAW,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;YACnD,yFAAyF;YACzF,mEAAmE;YACnE,IAAI,cAAc,IAAI,gDAAgD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAC1B;oBACI,UAAU,EAAE,qBAAqB;oBACjC,WAAW,EAAE,qBAAqB,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;oBACvE,UAAU,EAAE,QAAQ;iBACvB,EACD,IAAI,CACP,CAAC;gBACF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBACjC,IAAI,KAAK,EAAE,CAAC;oBACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC7D,OAAO,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;gBACtE,CAAC;YACL,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,YAAY,CACtB,KAAgC,EAChC,GAAyG,EACzG,QAA2B,EAC3B,IAAc;QAEd,6FAA6F;QAC7F,0CAA0C;QAC1C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAA4B,qBAAqB,EAAE,IAAI,CAAC,CAAC;QACtG,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,2FAA2F;QAC3F,0FAA0F;QAC1F,8FAA8F;QAC9F,MAAM,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAA2C,CAAC,CAAC;QACjG,MAAM,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;QACnD,MAAM,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QACzC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC3B,MAAM,CAAC,WAAW,GAAG,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACnF,IAAI,KAAK,EAAE,oBAAoB;YAAE,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAC,oBAAoB,CAAC;QAC1F,IAAI,KAAK,EAAE,cAAc;YAAE,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QACxE,IAAI,KAAK,EAAE,SAAS;YAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC;QAC3D,IAAI,KAAK,EAAE,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC7C,IAAI,GAAG,CAAC,cAAc;YAAE,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC;QAEnE,2FAA2F;QAC3F,qEAAqE;QACrE,IAAI,KAAK,EAAE,aAAa,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAqC,qBAAqB,EAAE,IAAI,CAAC,CAAC;YAC/G,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,kBAAkB,CAAC;YAC1C,MAAM,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;YACzC,IAAI,KAAK,CAAC,aAAa,CAAC,eAAe;gBAAE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,eAAe,CAAC;YACtG,IAAI,KAAK,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;gBAC5C,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC;YAC7E,CAAC;YACD,IAAI,KAAK,CAAC,aAAa,CAAC,6BAA6B,EAAE,CAAC;gBACpD,MAAM,CAAC,6BAA6B,GAAG,KAAK,CAAC,aAAa,CAAC,6BAA6B,CAAC;YAC7F,CAAC;YACD,IAAI,KAAK,CAAC,aAAa,CAAC,cAAc;gBAAE,MAAM,CAAC,cAAc,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;YAC7G,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACX,4CAA4C,MAAM,CAAC,YAAY,EAAE,eAAe,IAAI,iBAAiB,EAAE,CAC1G,CAAC;YACN,CAAC;YACD,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;gBACxC,MAAM,CAAC,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC;YACrE,CAAC;QACL,CAAC;QAED,+FAA+F;QAC/F,uFAAuF;QACvF,8FAA8F;QAC9F,oDAAoD;QACpD,IAAI,KAAK,EAAE,eAAe,EAAE,CAAC;YACzB,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;QACnD,CAAC;QAED,MAAM,KAAK,GAAuC,EAAE,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAmC,mBAAmB,EAAE,IAAI,CAAC,CAAC;YACzG,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC;YACrC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,CAAC,WAAW;gBAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;YACpD,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,EAAE,EAAE;gBAAE,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,kEAAkE;QAClE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEjD,6FAA6F;QAC7F,wFAAwF;QACxF,6EAA6E;QAC7E,EAAE;QACF,8FAA8F;QAC9F,gGAAgG;QAChG,+FAA+F;QAC/F,6FAA6F;QAC7F,+FAA+F;QAC/F,4FAA4F;QAC5F,sEAAsE;QACtE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAErD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACX,kCAAkC,MAAM,CAAC,YAAY,EAAE,eAAe,IAAI,iBAAiB,EAAE,CAChG,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;OAUG;IACK,KAAK,CAAC,qBAAqB,CAC/B,MAA0C,EAC1C,QAA2B,EAC3B,IAAc;QAEd,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC5C,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACxE,OAAO,MAAM,CAAC,qBAAqB,KAAK,IAAI,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,OAAO,CACjB,SAAiB,EACjB,QAA2B,EAC3B,IAAc,EACd,EAAW;QAEX,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAO5B,EAAE,UAAU,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,SAAS,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1G,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,WAAW,SAAS,0BAA0B,CAAC,CAAC,CAAC,CAAC;QAC1G,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAC1B,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,sBAAsB,SAAS,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,EAC1G,IAAI,CACP,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAEjF,MAAM,OAAO,GAAgC,EAAE,CAAC;QAChD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAO3B,EAAE,UAAU,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,EACpG,IAAI,CACP,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC;oBACT,aAAa,EAAE,CAAC,CAAC,EAAE;oBACnB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;oBAC5C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;oBACtC,aAAa,EAAE,CAAC,CAAC,aAAa;oBAC9B,gFAAgF;oBAChF,0EAA0E;oBAC1E,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC;iBACxC,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAEtE,OAAO;YACH,OAAO,EAAE,IAAI;YACb,eAAe,EAAE,GAAG,CAAC,EAAE;YACvB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YACtC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,CAAC,CAAC;YAChE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;YAC1D,YAAY,EAAE,OAAO;YACrB,cAAc,EAAE,OAAO;YACvB,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC7C,QAAQ,EAAE,EAAE;SACf,CAAC;IACN,CAAC;IAED,uGAAuG;IAC/F,KAAK,CAAC,WAAW,CACrB,SAAiB,EACjB,QAA2B,EAC3B,IAAc,EACd,EAAW;QAEX,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAUzB;YACI,UAAU,EAAE,4CAA4C;YACxD,WAAW,EACP,8EAA8E;gBAC9E,gFAAgF;gBAChF,sEAAsE,SAAS,KAAK;gBACpF,wCAAwC,SAAS,KAAK;YAC1D,UAAU,EAAE,QAAQ;SACvB,EACD,IAAI,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAa,EAAE,CAAC,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;QACvD,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAmC,EAAE,CAAC;YACrE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,EAAE;gBAAE,SAAS;YAClB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,KAAK,GAAG;oBACJ,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;oBACpC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;oBACpC,cAAc,EAAE,EAAE;oBAClB,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,gBAAgB,CAAC;oBAClD,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,EAAE;iBACZ,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;YAC3C,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;gBAC7B,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBACjC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;gBACvD,MAAM,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;aAC5C,CAAC,CAAC;QACP,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACxF,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACxF,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,yFAAyF;IACjF,KAAK,CAAC,iBAAiB,CAAC,EAAwB;QACpD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC;;;;;;kCAMR,CAAC,CAA2B,CAAC;QAEvD,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;QACrG,CAAC;QACD,OAAO,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACjD,CAAC;IAEO,OAAO,CAAC,IAAY,EAAE,OAAe,EAAE,IAAa;QACxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC5F,CAAC;IAEO,MAAM,CAAC,QAAyB;QACpC,OAAO;YACH,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACjD,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,EAAE;YAClB,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,IAAI;SACpB,CAAC;IACN,CAAC;CACJ,CAAA;AAnhBY,uBAAuB;IADnC,aAAa,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;GAClD,uBAAuB,CAmhBnC;;AAED,0FAA0F;AAC1F,MAAM,UAAU,2BAA2B;IACvC,sBAAsB;AAC1B,CAAC"}

package/dist/CheckEntitlementOperation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Orders.CheckEntitlement — does this person currently have this capability?
+ *
+ * WHY THIS IS AN OPERATION AND NOT A VIEW. Access is computed: Status is not trustworthy
+ * (cancel does not touch grants; elapsed ValidTo is never swept). A view of the flag would
+ * re-teach every consumer the evaluator, and the two would drift. The LXP asks; this answers.
+ *
+ * Asked by `ProductEntitlement.Code`, not SKU — a bundle, an upgrade and a grandfathered
+ * tier can all confer the same capability. PersonID is authoritative; email is convenience
+ * and is refused when it matches more than one person. v1 evaluates person grants only.
+ *
+ * Fail closed. Unknown person and known-person-without-access share one response shape.
+ *
+ * CONNECTS TO:
+ *   PURE: ./EntitlementBehavior.ts (EvaluateGrantAccess)
+ *   LOAD: ./EntitlementRead.ts
+ *   DOC:  plans/entitlement-read-contract.md
+ */
+import { BaseRemotableOperation, type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { type CheckEntitlementInput, type CheckEntitlementOutput } from './EntitlementRead.js';
+export declare class CheckEntitlementOperation extends BaseRemotableOperation<CheckEntitlementInput, CheckEntitlementOutput> {
+    OperationKey: string;
+    protected InternalExecute(input: CheckEntitlementInput, provider: IMetadataProvider, user: UserInfo): Promise<CheckEntitlementOutput>;
+}
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export declare function LoadCheckEntitlementOperation(): void;
+//# sourceMappingURL=CheckEntitlementOperation.d.ts.map

package/dist/CheckEntitlementOperation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckEntitlementOperation.d.ts","sourceRoot":"","sources":["../src/CheckEntitlementOperation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErG,OAAO,EAEH,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC9B,MAAM,sBAAsB,CAAC;AAE9B,qBACa,yBAA0B,SAAQ,sBAAsB,CACjE,qBAAqB,EACrB,sBAAsB,CACzB;IACU,YAAY,SAA6B;cAEhC,eAAe,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC;CAGrC;AAED,8FAA8F;AAC9F,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/CheckEntitlementOperation.js

@@ -0,0 +1,45 @@
+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.CheckEntitlement — does this person currently have this capability?
+ *
+ * WHY THIS IS AN OPERATION AND NOT A VIEW. Access is computed: Status is not trustworthy
+ * (cancel does not touch grants; elapsed ValidTo is never swept). A view of the flag would
+ * re-teach every consumer the evaluator, and the two would drift. The LXP asks; this answers.
+ *
+ * Asked by `ProductEntitlement.Code`, not SKU — a bundle, an upgrade and a grandfathered
+ * tier can all confer the same capability. PersonID is authoritative; email is convenience
+ * and is refused when it matches more than one person. v1 evaluates person grants only.
+ *
+ * Fail closed. Unknown person and known-person-without-access share one response shape.
+ *
+ * CONNECTS TO:
+ *   PURE: ./EntitlementBehavior.ts (EvaluateGrantAccess)
+ *   LOAD: ./EntitlementRead.ts
+ *   DOC:  plans/entitlement-read-contract.md
+ */
+import { BaseRemotableOperation } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { CheckPersonEntitlement, } from './EntitlementRead.js';
+let CheckEntitlementOperation = class CheckEntitlementOperation extends BaseRemotableOperation {
+    constructor() {
+        super(...arguments);
+        this.OperationKey = 'Orders.CheckEntitlement';
+    }
+    async InternalExecute(input, provider, user) {
+        return CheckPersonEntitlement(input, provider, user);
+    }
+};
+CheckEntitlementOperation = __decorate([
+    RegisterClass(BaseRemotableOperation, 'Orders.CheckEntitlement')
+], CheckEntitlementOperation);
+export { CheckEntitlementOperation };
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export function LoadCheckEntitlementOperation() {
+    void CheckEntitlementOperation;
+}
+//# sourceMappingURL=CheckEntitlementOperation.js.map

package/dist/CheckEntitlementOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckEntitlementOperation.js","sourceRoot":"","sources":["../src/CheckEntitlementOperation.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,sBAAsB,EAAyC,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EACH,sBAAsB,GAGzB,MAAM,sBAAsB,CAAC;AAGvB,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,sBAG9C;IAHM;;QAII,iBAAY,GAAG,yBAAyB,CAAC;IASpD,CAAC;IAPa,KAAK,CAAC,eAAe,CAC3B,KAA4B,EAC5B,QAA2B,EAC3B,IAAc;QAEd,OAAO,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;CACJ,CAAA;AAbY,yBAAyB;IADrC,aAAa,CAAC,sBAAsB,EAAE,yBAAyB,CAAC;GACpD,yBAAyB,CAarC;;AAED,8FAA8F;AAC9F,MAAM,UAAU,6BAA6B;IACzC,KAAK,yBAAyB,CAAC;AACnC,CAAC"}