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

package/dist/ApplyAccountCreditOperation.js.map

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

package/dist/BaseDeliveryChannel.d.ts

@@ -0,0 +1,106 @@
+/**
+ * BaseDeliveryChannel — the seam a document leaves the building through.
+ *
+ * WHY A SEAM AT ALL, WHEN EMAIL IS THE ONLY CHANNEL TODAY. Because the callers are already plural and
+ * the second channel is already named. §4.4 of the plan settles delivery as "thin send-via-email of
+ * the rendered order first, with an Action-plugin seam", and lists a bill-presentment service as the
+ * adapter that arrives when a channel needs it. A hard-coded `sendEmail()` would have to be unpicked
+ * from every caller on the day that happens; a class keyed by channel code is a metadata row and a
+ * subclass, which is the same shape `BasePaymentProvider` uses for gateways and for the same reason.
+ *
+ * IT IS DOCUMENT-AGNOSTIC ON PURPOSE. Nothing below knows what an invoice is. A channel takes a
+ * rendered document — a subject, a body, a recipient — and gets it to that recipient. That is what
+ * makes this reusable for statements, dunning notices, order confirmations and receipts without any
+ * of them teaching the channel a new noun. The KIND of document is carried as free text purely so a
+ * channel can log it or route on it, never so it can branch on it.
+ *
+ * IT DOES NOT RENDER, AND IT DOES NOT DECIDE. Rendering belongs to whoever owns the document's shape;
+ * deciding whether to send belongs to `DeliveryBehavior`. A channel that rendered would need one
+ * template per document type and would become the place every future document type is edited. A
+ * channel that decided would put "is this order confirmed?" in the mail layer.
+ *
+ * REFUSAL IS NOT AN EXCEPTION — the same contract the payment drivers follow. A rejected address is a
+ * normal outcome of asking; a mail server being unreachable is not. Only the second throws, because a
+ * caller that has to read exception messages to tell "bad address" from "provider down" will
+ * eventually treat one as the other, and the two want completely different responses.
+ *
+ * CONNECTS TO:
+ *   PURE:    ./DeliveryBehavior.ts — who it goes to, and whether it should
+ *   SHIPPED: ./EmailDeliveryChannel.ts
+ *   LOOKUP:  ./DeliveryResolver.ts
+ *   DOC:     plans/archive/bizapps-orders-master.md §4.4
+ */
+import type { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import type { DeliveryChannelCode, DeliveryContact } from './DeliveryBehavior.js';
+/** A document that has already been rendered and is ready to leave. */
+export interface DeliverableDocument {
+    /** `Invoice`, `Statement`, `OrderConfirmation`, … — for logging and routing, never for branching. */
+    Kind: string;
+    /** The document's own number. Appears in the subject and in every log line about this send. */
+    DocumentNumber: string;
+    /** Already built by `BuildSubject` or supplied by the caller. */
+    Subject: string;
+    /** The rendered document. HTML today; a channel that cannot render HTML uses `BodyPlain`. */
+    BodyHtml: string;
+    /**
+     * A plain-text alternative. OPTIONAL, and its absence is not fatal — but a channel sending only
+     * HTML gives spam filters one of their strongest signals, so callers are encouraged to supply one.
+     */
+    BodyPlain?: string;
+}
+/** Where a document is going, and who it is from. */
+export interface DeliveryAddressing {
+    To: DeliveryContact[];
+    CC?: string[];
+    BCC?: string[];
+    /** The sending address. Null lets the channel fall back to its provider's configured default. */
+    From?: string | null;
+    FromName?: string | null;
+}
+export interface DeliveryResult {
+    Success: boolean;
+    /** Why not, when not — in the provider's words where it has any. */
+    Reason?: string;
+    /** The provider's own message id, for correlating with its logs. */
+    ProviderMessageID?: string;
+    /** Addresses the channel actually accepted, which may be fewer than were offered. */
+    Delivered: string[];
+}
+/** Everything a channel needs that is not the document itself. */
+export interface DeliveryContext {
+    Provider: IMetadataProvider;
+    User: UserInfo;
+    /**
+     * Render without sending, for a preview screen. A channel MUST honour this — a preview that sends
+     * is the worst possible bug in a mail path, because it is invisible on the sending side.
+     */
+    PreviewOnly?: boolean;
+}
+/**
+ * The channel contract.
+ *
+ * Registered against this base by channel code:
+ *
+ * ```ts
+ * @RegisterClass(BaseDeliveryChannel, 'Email')
+ * export class EmailDeliveryChannel extends BaseDeliveryChannel { … }
+ * ```
+ *
+ * NOT DECORATED ITSELF, matching `BasePaymentProvider`. MJ's ClassFactory instantiates the base when
+ * no key matches, so a self-registration would make "nobody registered a channel" indistinguishable
+ * from "the channel refused" — `DeliveryResolver` checks for exactly that.
+ */
+export declare class BaseDeliveryChannel {
+    /** Which channel this is. Set by the resolver; the ClassFactory constructs with no arguments. */
+    Code: DeliveryChannelCode;
+    /**
+     * Send it. The default REFUSES rather than reporting a success nobody can verify.
+     *
+     * A channel author who forgets to override should find out from a clear message, not from a
+     * customer who never received their invoice and a log full of successes.
+     */
+    Deliver(_document: DeliverableDocument, _addressing: DeliveryAddressing, _context: DeliveryContext): Promise<DeliveryResult>;
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export declare function LoadBaseDeliveryChannel(): void;
+//# sourceMappingURL=BaseDeliveryChannel.d.ts.map

package/dist/BaseDeliveryChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDeliveryChannel.d.ts","sourceRoot":"","sources":["../src/BaseDeliveryChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAElF,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAChC,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,eAAe,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAC5B,iGAAiG;IAC1F,IAAI,EAAG,mBAAmB,CAAC;IAElC;;;;;OAKG;IACU,OAAO,CAChB,SAAS,EAAE,mBAAmB,EAC9B,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,EAAE,eAAe,GAC1B,OAAO,CAAC,cAAc,CAAC;CAU7B;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/BaseDeliveryChannel.js

@@ -0,0 +1,36 @@
+/**
+ * The channel contract.
+ *
+ * Registered against this base by channel code:
+ *
+ * ```ts
+ * @RegisterClass(BaseDeliveryChannel, 'Email')
+ * export class EmailDeliveryChannel extends BaseDeliveryChannel { … }
+ * ```
+ *
+ * NOT DECORATED ITSELF, matching `BasePaymentProvider`. MJ's ClassFactory instantiates the base when
+ * no key matches, so a self-registration would make "nobody registered a channel" indistinguishable
+ * from "the channel refused" — `DeliveryResolver` checks for exactly that.
+ */
+export class BaseDeliveryChannel {
+    /**
+     * Send it. The default REFUSES rather than reporting a success nobody can verify.
+     *
+     * A channel author who forgets to override should find out from a clear message, not from a
+     * customer who never received their invoice and a log full of successes.
+     */
+    async Deliver(_document, _addressing, _context) {
+        return {
+            Success: false,
+            Delivered: [],
+            Reason: `The '${this.Code ?? 'unknown'}' delivery channel has no implementation. This is a channel ` +
+                `that was never registered, not a message that was rejected — check the @RegisterClass key ` +
+                `against the channel code.`,
+        };
+    }
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadBaseDeliveryChannel() {
+    // intentionally empty
+}
+//# sourceMappingURL=BaseDeliveryChannel.js.map

package/dist/BaseDeliveryChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDeliveryChannel.js","sourceRoot":"","sources":["../src/BaseDeliveryChannel.ts"],"names":[],"mappings":"AAmFA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAAmB;IAI5B;;;;;OAKG;IACI,KAAK,CAAC,OAAO,CAChB,SAA8B,EAC9B,WAA+B,EAC/B,QAAyB;QAEzB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,EAAE;YACb,MAAM,EACF,QAAQ,IAAI,CAAC,IAAI,IAAI,SAAS,8DAA8D;gBAC5F,4FAA4F;gBAC5F,2BAA2B;SAClC,CAAC;IACN,CAAC;CACJ;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB;IACnC,sBAAsB;AAC1B,CAAC"}

package/dist/BasePaymentProvider.d.ts

@@ -0,0 +1,239 @@
+/**
+ * BasePaymentProvider — the seam every gateway plugs into (D19/D37).
+ *
+ * A `PaymentProviderType` row's `Code` IS the `@RegisterClass` key, so adding a gateway is a metadata
+ * row plus a subclass, never a schema change. `DriverClass` on the same row names the class for a
+ * human reading the configuration; the ClassFactory resolves by `Code`.
+ *
+ * WHAT A DRIVER IS RESPONSIBLE FOR, and what it is emphatically not:
+ *
+ *   IT DOES        talk to the gateway, and translate between that gateway's vocabulary and ours.
+ *   IT DOES NOT    write journal entries, move `PaymentHeader.Status`, or touch allocations.
+ *
+ * That division is why `PaymentHeaderEntityServer` can stay the single place cash is booked. A driver
+ * that posted its own entries would give every gateway its own accounting, and the first one to get it
+ * wrong would balance anyway.
+ *
+ * LOGICAL REFUSAL IS NOT AN EXCEPTION. Every operation returns a result carrying `Success` and, when
+ * false, a `Reason` a person can act on. A declined card is a normal outcome of asking; a gateway
+ * being unreachable is not. Only the second throws. This is the same rule the remotable operations
+ * follow, and it exists because a caller that has to read exception messages to tell "declined" from
+ * "broken" will eventually treat one as the other.
+ *
+ * MONEY CROSSES THIS BOUNDARY IN MAJOR UNITS — decimals, as we store them. Each driver converts at
+ * its own edge using `ToMinorUnits`/`FromMinorUnits`, because the conversion is the GATEWAY'S
+ * convention rather than ours, and hoisting it here would impose Stripe's on everyone.
+ *
+ * CONNECTS TO:
+ *   PURE:    ./PaymentProviderBehavior.ts
+ *   DRIVERS: ./StripePaymentProvider.ts · ./ManualPaymentProvider.ts · ./StoredValuePaymentProvider.ts
+ *   LOOKUP:  ./PaymentProviderResolver.ts
+ *   DOC:     plans/archive/bizapps-orders-master.md D19, D37
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import type { IntentStatus } from './PaymentProviderBehavior.js';
+/** The configured account a driver is acting for — one `PaymentProvider` row. */
+export interface PaymentProviderConfig {
+    ID: string;
+    /** The `PaymentProviderType.Code`, which is also the ClassFactory key. */
+    TypeCode: string;
+    CompanyID: string;
+    Name: string;
+    /**
+     * How to FIND the credentials, never the credentials themselves. Resolved through
+     * `PaymentProviderResolver`'s secret seam so a deployment can point it at a vault.
+     */
+    CredentialsRef: string | null;
+    IsLiveMode: boolean;
+    Capabilities: {
+        SupportsTokenization: boolean;
+        SupportsRefund: boolean;
+        SupportsWebhooks: boolean;
+    };
+}
+/** Resolved secrets. Held only for the duration of a call and never persisted. */
+export interface PaymentCredentials {
+    /** The gateway API key. */
+    ApiKey?: string;
+    /** The webhook endpoint signing secret — a DIFFERENT secret from the API key, deliberately. */
+    WebhookSecret?: string;
+    /** Anything a specific gateway needs beyond those two. */
+    Extra?: Record<string, string>;
+}
+export interface CreateIntentRequest {
+    /** Major units, as we store money. */
+    Amount: number;
+    CurrencyCode: string;
+    OrderHeaderID?: string | null;
+    /** Who we are collecting from (D65) — carried so the gateway's record matches ours. */
+    BillToPersonID?: string | null;
+    BillToOrganizationID?: string | null;
+    /** A saved instrument to charge, when the customer has one on file. */
+    ProviderCustomerRef?: string | null;
+    ProviderInstrumentRef?: string | null;
+    /** Free-form, echoed back on webhooks. Useful for reconciliation, never load-bearing. */
+    Metadata?: Record<string, string>;
+    /**
+     * 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.
+     */
+    IdempotencyKey?: string;
+}
+export interface CreateIntentResult {
+    Success: boolean;
+    Reason?: string;
+    ProviderIntentID?: string;
+    Status?: IntentStatus;
+    /** For a client-side confirmation flow. Never logged. */
+    ClientSecret?: string;
+    /** For a hosted-checkout flow — where to send the customer. */
+    HostedUrl?: string;
+}
+export interface CaptureRequest {
+    ProviderIntentID: string;
+    /** Omit for the full authorised amount. Major units. */
+    Amount?: number;
+    CurrencyCode: string;
+}
+export interface RetrieveIntentRequest {
+    ProviderIntentID: string;
+}
+export interface RetrieveIntentResult {
+    Success: boolean;
+    Reason?: string;
+    Status?: IntentStatus;
+    /** Major units as the gateway currently reports them. */
+    Amount?: number;
+}
+export interface CaptureResult {
+    Success: boolean;
+    Reason?: string;
+    /** Major units, as reported by the gateway rather than as we asked. */
+    Amount?: number;
+    /**
+     * The gateway's cut, major units. Feeds `PaymentHeader.ProcessingFeeAmount` and the fee leg of the
+     * capture entry (D18). Zero is a legitimate answer; UNKNOWN is not the same thing, so a driver
+     * that cannot determine a fee leaves this undefined rather than reporting 0.
+     */
+    FeeAmount?: number;
+    ProviderChargeID?: string;
+    Status?: IntentStatus;
+}
+export interface RefundRequest {
+    /** One of these. A gateway may key refunds off either. */
+    ProviderIntentID?: string;
+    ProviderChargeID?: string;
+    /** Major units. Omit for a full refund. */
+    Amount?: number;
+    CurrencyCode: string;
+    Reason?: string;
+    IdempotencyKey?: string;
+}
+export interface RefundResult {
+    Success: boolean;
+    Reason?: string;
+    Amount?: number;
+    ProviderRefundID?: string;
+}
+/** A gateway event, reduced to the facts this application acts on. */
+export interface WebhookEvent {
+    /** The gateway's own event id. Our idempotency key — `PaymentIntent.ProviderEventID` is UNIQUE. */
+    EventID: string;
+    /** The gateway's event name, unmapped. Matched against a driver's `HandledEventKinds`. */
+    Kind: string;
+    ProviderIntentID?: string;
+    ProviderChargeID?: string;
+    /** Major units. */
+    Amount?: number;
+    FeeAmount?: number;
+    CurrencyCode?: string;
+    Status?: IntentStatus;
+    /** Present on a failure event, in the gateway's words. */
+    FailureReason?: string;
+    /**
+     * When the gateway says the event happened. Stripe `created` (unix seconds).
+     * Used to bound checkout-capture webhook 500s; absent means the bound cannot
+     * be applied and retries follow Retryable only.
+     */
+    OccurredAt?: Date;
+}
+/**
+ * The driver contract.
+ *
+ * Registered against this base by `PaymentProviderType.Code`:
+ *
+ * ```ts
+ * @RegisterClass(BasePaymentProvider, 'Stripe')
+ * export class StripePaymentProvider extends BasePaymentProvider { … }
+ * ```
+ *
+ * Default implementations REFUSE rather than pretend. A gateway that cannot refund should not silently
+ * report a successful refund, and a driver author who forgets to override should find out from a clear
+ * message rather than from a reconciliation weeks later.
+ *
+ * NOT DECORATED ITSELF, matching `BasePriceResolver`. MJ's ClassFactory instantiates the base when no
+ * key matches, so a self-registration would make "nobody registered a driver" indistinguishable from
+ * "the driver declined" — `PaymentProviderResolver` checks for exactly that and refuses.
+ */
+export declare class BasePaymentProvider {
+    /**
+     * Set by the resolver immediately after construction — the ClassFactory constructs with no
+     * arguments, so configuration cannot arrive through a constructor.
+     */
+    Config: PaymentProviderConfig;
+    Credentials: PaymentCredentials;
+    /** For drivers that need to read or write our own tables (the internal ones do). */
+    Provider?: IMetadataProvider;
+    User?: UserInfo;
+    /** Gateway event names this driver acts on. Everything else is ignored rather than rejected. */
+    get HandledEventKinds(): readonly string[];
+    /**
+     * Whether money moves on a DELAY this driver cannot observe synchronously.
+     *
+     * FALSE for a card: `Capture` returns and the money has moved, so the caller books cash in the
+     * same breath and a later event only confirms what we already recorded. TRUE for a bank debit:
+     * `Capture` returns "submitted", the bank answers days later, and the only honest thing to record
+     * in the meantime is that we are waiting.
+     *
+     * The flag exists because it changes WHO BOOKS THE CASH. When false, `PaymentHeaderEntityServer`
+     * books at the moment the caller asks — the existing path, untouched. When true, the caller leaves
+     * the payment `Pending` and the WEBHOOK promotes it, which means `PaymentWebhookHandler` has to do
+     * something it deliberately never did before (see its `applyEvent` note). Gating that on a driver's
+     * own declaration is what keeps the card path exactly as it was: a driver that does not opt in
+     * cannot have its payments promoted behind its back.
+     *
+     * It is a capability of the DRIVER rather than a column on `PaymentProviderType` because it is not
+     * configuration — an operator cannot make ACH settle instantly by editing a row, and offering the
+     * switch would invite exactly that.
+     */
+    get SettlesAsynchronously(): boolean;
+    CreateIntent(_request: CreateIntentRequest): Promise<CreateIntentResult>;
+    Capture(_request: CaptureRequest): Promise<CaptureResult>;
+    /**
+     * Ask the gateway what it currently believes about an intent we already opened.
+     *
+     * Used by checkout completion when the browser has confirmed the card (Stripe.js)
+     * but the signature-verified webhook has not yet landed — localhost never receives
+     * Stripe's POST. This is a SERVER retrieve with our key, not a client claim.
+     */
+    RetrieveIntent(_request: RetrieveIntentRequest): Promise<RetrieveIntentResult>;
+    Refund(_request: RefundRequest): Promise<RefundResult>;
+    /**
+     * Verify that a webhook really came from the gateway.
+     *
+     * DEFAULTS TO FALSE, and that default is load-bearing. The route is unauthenticated (D19), so a
+     * driver that inherits this and forgets to override gets a closed door rather than an open one.
+     * A provider genuinely without webhooks never reaches here — `SupportsWebhooks` is false and the
+     * route refuses earlier.
+     */
+    VerifyWebhook(_rawBody: string, _headers: Record<string, string | undefined>): Promise<{
+        Valid: boolean;
+        Reason?: string;
+    }>;
+    /** Reduce a verified payload to the facts we act on. Null when it is not an event we can read. */
+    ParseWebhookEvent(_rawBody: string): WebhookEvent | null;
+    protected notImplemented(what: string): string;
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export declare function LoadBasePaymentProvider(): void;
+//# sourceMappingURL=BasePaymentProvider.d.ts.map

package/dist/BasePaymentProvider.d.ts.map

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

package/dist/BasePaymentProvider.js

@@ -0,0 +1,91 @@
+/**
+ * The driver contract.
+ *
+ * Registered against this base by `PaymentProviderType.Code`:
+ *
+ * ```ts
+ * @RegisterClass(BasePaymentProvider, 'Stripe')
+ * export class StripePaymentProvider extends BasePaymentProvider { … }
+ * ```
+ *
+ * Default implementations REFUSE rather than pretend. A gateway that cannot refund should not silently
+ * report a successful refund, and a driver author who forgets to override should find out from a clear
+ * message rather than from a reconciliation weeks later.
+ *
+ * NOT DECORATED ITSELF, matching `BasePriceResolver`. MJ's ClassFactory instantiates the base when no
+ * key matches, so a self-registration would make "nobody registered a driver" indistinguishable from
+ * "the driver declined" — `PaymentProviderResolver` checks for exactly that and refuses.
+ */
+export class BasePaymentProvider {
+    /** Gateway event names this driver acts on. Everything else is ignored rather than rejected. */
+    get HandledEventKinds() {
+        return [];
+    }
+    /**
+     * Whether money moves on a DELAY this driver cannot observe synchronously.
+     *
+     * FALSE for a card: `Capture` returns and the money has moved, so the caller books cash in the
+     * same breath and a later event only confirms what we already recorded. TRUE for a bank debit:
+     * `Capture` returns "submitted", the bank answers days later, and the only honest thing to record
+     * in the meantime is that we are waiting.
+     *
+     * The flag exists because it changes WHO BOOKS THE CASH. When false, `PaymentHeaderEntityServer`
+     * books at the moment the caller asks — the existing path, untouched. When true, the caller leaves
+     * the payment `Pending` and the WEBHOOK promotes it, which means `PaymentWebhookHandler` has to do
+     * something it deliberately never did before (see its `applyEvent` note). Gating that on a driver's
+     * own declaration is what keeps the card path exactly as it was: a driver that does not opt in
+     * cannot have its payments promoted behind its back.
+     *
+     * It is a capability of the DRIVER rather than a column on `PaymentProviderType` because it is not
+     * configuration — an operator cannot make ACH settle instantly by editing a row, and offering the
+     * switch would invite exactly that.
+     */
+    get SettlesAsynchronously() {
+        return false;
+    }
+    async CreateIntent(_request) {
+        return { Success: false, Reason: this.notImplemented('creating a payment intent') };
+    }
+    async Capture(_request) {
+        return { Success: false, Reason: this.notImplemented('capturing a payment') };
+    }
+    /**
+     * Ask the gateway what it currently believes about an intent we already opened.
+     *
+     * Used by checkout completion when the browser has confirmed the card (Stripe.js)
+     * but the signature-verified webhook has not yet landed — localhost never receives
+     * Stripe's POST. This is a SERVER retrieve with our key, not a client claim.
+     */
+    async RetrieveIntent(_request) {
+        return { Success: false, Reason: this.notImplemented('retrieving a payment intent') };
+    }
+    async Refund(_request) {
+        return { Success: false, Reason: this.notImplemented('refunding a payment') };
+    }
+    /**
+     * Verify that a webhook really came from the gateway.
+     *
+     * DEFAULTS TO FALSE, and that default is load-bearing. The route is unauthenticated (D19), so a
+     * driver that inherits this and forgets to override gets a closed door rather than an open one.
+     * A provider genuinely without webhooks never reaches here — `SupportsWebhooks` is false and the
+     * route refuses earlier.
+     */
+    async VerifyWebhook(_rawBody, _headers) {
+        return { Valid: false, Reason: `${this.Config?.TypeCode ?? 'this provider'} does not verify webhooks` };
+    }
+    /** Reduce a verified payload to the facts we act on. Null when it is not an event we can read. */
+    ParseWebhookEvent(_rawBody) {
+        return null;
+    }
+    notImplemented(what) {
+        const code = this.Config?.TypeCode ?? 'unknown';
+        return (`The '${code}' payment provider does not support ${what}. This is a driver that has not ` +
+            `implemented the operation, not a gateway that declined it — check ` +
+            `PaymentProviderType.Code against the registered driver classes.`);
+    }
+}
+/** Tree-shaking anchor — call from the server bootstrap so @RegisterClass is retained. */
+export function LoadBasePaymentProvider() {
+    // intentionally empty
+}
+//# sourceMappingURL=BasePaymentProvider.js.map

package/dist/BasePaymentProvider.js.map

@@ -0,0 +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"}

package/dist/BundleBehavior.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Bundle expansion arithmetic, with no database in sight.
+ *
+ * WHY EXPAND AT ALL. A bundle sold as one line forces ONE of everything: one tax treatment, one
+ * revenue schedule, one GL account, one entitlement, one returnable unit. A bundle of a publication
+ * (often exempt) and a conference registration (not) taxed at the header is simply wrong, and a
+ * bundle spanning a subscription and an event cannot be scheduled from a single line at all. So the
+ * components become real order lines and everything downstream keeps working per line.
+ *
+ * WHAT THE PARENT IS FOR. The customer bought "the Gold Package", not four things, and reporting
+ * needs to know a component came from a bundle — and from WHICH bundle line, since two Gold Packages
+ * on one order produce two indistinguishable sets otherwise. So the parent line survives as the
+ * customer-facing row, carrying `IsRollupParent`, and contributes ZERO to every total. The children
+ * carry the money.
+ *
+ * THE ARITHMETIC THAT BITES. Allocating one bundle price across components by relative standalone
+ * selling price does not divide evenly. Allocate $100 across three equal components and naive
+ * rounding gives 33.33 × 3 = 99.99 — a penny that vanishes, on an order that still balances because
+ * every line agrees with itself. `AllocateBundlePrice` uses largest-remainder so the parts sum to
+ * the whole EXACTLY, and its tests assert that on deliberately awkward numbers.
+ *
+ * CONNECTS TO:
+ *   CODE: BundleEngine (the rows) · OrderEntityServer (the lifecycle point)
+ *   DOC:  plans/archive/bizapps-orders-master.md D32/D41 (bundles), D45 (ParentOrderLineID)
+ */
+/** How a bundle prices its components. */
+export type BundlePricingMode = 'Bundled' | 'SumOfParts';
+/** One component of a bundle, as the catalog defines it. */
+export interface BundleComponent {
+    ComponentProductID: string;
+    /** Units of this component per ONE bundle. */
+    Quantity: number;
+    PricingMode: BundlePricingMode;
+    SortOrder: number;
+    /**
+     * The component's own list price — its standalone selling price. Null when the catalog has no
+     * price rule for it, which is survivable: see `AllocateBundlePrice`.
+     */
+    StandaloneSellingPrice: number | null;
+}
+/** One child line to be created. */
+export interface PlannedBundleChild {
+    ComponentProductID: string;
+    /** parent quantity × component quantity. */
+    Quantity: number;
+    /** The child's share of the bundle price, per unit. */
+    UnitPrice: number;
+    SortOrder: number;
+}
+export type BundleRefusal = 'NotABundle' | 'ReversalLine' | 'NonPositiveQuantity' | 'NestedBundle' | 'NoComponents';
+export interface BundlePlan {
+    Children: PlannedBundleChild[];
+    Refusal: BundleRefusal | null;
+    /** True when allocation fell back to splitting evenly because no component had a price. */
+    AllocatedEvenly: boolean;
+}
+/**
+ * Split `total` across `weights` so the parts sum to `total` EXACTLY.
+ *
+ * Largest-remainder: floor every share to cents, then hand the leftover pennies one at a time to
+ * whichever shares were cut by the most. The naive alternative — round each share independently —
+ * loses or invents money on most inputs, and does it invisibly: each line is individually plausible
+ * and the order still balances against itself.
+ *
+ * Ties break toward the earlier index, so the result is deterministic for a given input rather than
+ * dependent on sort stability.
+ */
+export declare function SplitExactly(total: number, weights: number[]): number[];
+/**
+ * Allocate a bundle's price across its components by relative standalone selling price.
+ *
+ * `Bundled` components share the bundle price. `SumOfParts` components are priced on their own and
+ * take no share of it — a bundle may mix the two, which is how "everything in the package plus a
+ * discounted add-on priced separately" is expressed.
+ *
+ * WHEN NO COMPONENT HAS A PRICE the weights are all zero and there is nothing to allocate BY. Rather
+ * than refuse the sale or silently dump the whole amount on the first component, it splits evenly
+ * and says so through `AllocatedEvenly`, so a caller can record that the allocation was arbitrary.
+ * An even split is defensible; a silent lopsided one is not.
+ */
+export declare function AllocateBundlePrice(bundleTotal: number, components: BundleComponent[]): {
+    PerComponent: number[];
+    AllocatedEvenly: boolean;
+};
+/** What a bundle line needs to say for itself. */
+export interface BundleLineFacts {
+    ID: string;
+    ProductID: string;
+    Quantity: number;
+    /** The price of ONE bundle. Multiplied by quantity to get what is allocated. */
+    UnitPrice: number;
+    ReversesOrderLineID: string | null;
+    /** True when this line is ITSELF a component of another bundle — one level only (D45). */
+    HasParent: boolean;
+}
+/**
+ * Plan the child lines a bundle line expands into.
+ *
+ * ONE LEVEL ONLY. A component that is itself a bundle is refused rather than expanded recursively:
+ * the quantity ripple and the allocation both get considerably harder, and nothing in the catalog
+ * needs it yet. Easy to relax; very hard to un-ship once orders exist that depend on it.
+ */
+export declare function PlanBundleExpansion(line: BundleLineFacts, components: BundleComponent[]): BundlePlan;
+/** A child's quantity: how many bundles times how many of the component each contains. */
+export declare function ChildQuantity(parentQuantity: number, componentQuantity: number): number;
+/** One child's current state, for deciding whether the ripple may touch it. */
+export interface RippleChild {
+    ID: string;
+    ComponentQuantity: number;
+    IsQuantityOverridden: boolean;
+    CurrentQuantity: number;
+}
+export interface RippleChange {
+    OrderLineID: string;
+    FromQuantity: number;
+    ToQuantity: number;
+}
+/**
+ * What a change to the parent's quantity should do to its children.
+ *
+ * A child whose quantity was hand-edited DETACHES from the ripple. Without that, bumping the bundle
+ * quantity silently overwrites a deliberate correction — data loss that looks exactly like
+ * arithmetic, because the number it lands on is the number the formula says it should be.
+ *
+ * Returns only the children that actually change, so a no-op ripple writes nothing.
+ */
+export declare function PlanQuantityRipple(parentQuantity: number, children: RippleChild[]): RippleChange[];
+/**
+ * Does this set of lines total correctly once parents are excluded?
+ *
+ * The invariant every rollup depends on: a rollup parent contributes nothing, so the sum over
+ * non-parent lines is the order's real value. Exported because it is worth asserting from the
+ * outside rather than trusting each rollup to remember.
+ */
+export declare function RollupTotal(lines: Array<{
+    IsRollupParent: boolean;
+    Amount: number;
+}>): number;
+//# sourceMappingURL=BundleBehavior.d.ts.map