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

package/dist/custom/generate-invoice.action.js

@@ -0,0 +1,208 @@
+/**
+ * @fileoverview `Orders: Generate Invoice` — hand it any order, get back the document you send the
+ * customer.
+ *
+ * WHY AN ACTION AND NOT A REMOTE OPERATION. The other order verbs — confirm, capture, fulfil — are
+ * operations because they are the API a browser calls to change something. This one changes
+ * nothing, and its callers are different in kind: a workflow that emails a bill on confirmation, an
+ * agent asked to "send Contoso their invoice", a scheduled job producing a month's PDFs, a person
+ * clicking Print. Actions are the surface all four already speak, and they are discoverable in
+ * metadata rather than only from code.
+ *
+ * WHAT IT COMPOSES. This class does no arithmetic, no formatting and no markup. It resolves inputs,
+ * calls the reader, the display layer and the template engine in that order, and hands back what
+ * they produced:
+ *
+ *   `InvoiceBuilder`  → the document, per selling company, derived from the order
+ *   `InvoiceDisplay`  → the strings, so the template can print without computing
+ *   MJ Templates      → the HTML, editable in the database with no deploy
+ *
+ * IT RETURNS THE DATA ALONGSIDE THE HTML. A caller that wants a PDF renders the HTML; a caller
+ * doing a reconciliation check wants the numbers, and making it scrape them back out of markup
+ * would be a guarantee that the check and the document eventually disagree.
+ *
+ * IT NEVER WRITES. There is no invoice record — the confirmed order IS the receivable — so
+ * rendering the same order twice produces two identical documents. See the header of
+ * `InvoiceBehavior` for why storing one would be a mistake, and why statements are the opposite
+ * case.
+ *
+ * @module @mj-biz-apps/orders-actions
+ */
+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;
+};
+import { BaseAction } from '@memberjunction/actions';
+import { Metadata } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { DEFAULT_INVOICE_TEMPLATE, RenderInvoiceDocuments, } from '../services/invoice-renderer.js';
+// Re-exported for the callers that imported it from here before the render orchestration moved into
+// the shared service. The constant itself now lives with the code that uses it.
+export { DEFAULT_INVOICE_TEMPLATE } from '../services/invoice-renderer.js';
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Read a parameter case-insensitively — action callers are not consistent about casing. */
+function param(params, name) {
+    return params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase())?.Value;
+}
+function boolParam(params, name, fallback) {
+    const raw = param(params, name);
+    if (raw == null || raw === '')
+        return fallback;
+    if (typeof raw === 'boolean')
+        return raw;
+    return ['true', '1', 'yes'].includes(String(raw).trim().toLowerCase());
+}
+function strParam(params, name) {
+    const raw = param(params, name);
+    if (raw == null)
+        return null;
+    const value = String(raw).trim();
+    return value.length ? value : null;
+}
+/** Attach an output value, replacing any placeholder the engine already put there. */
+function setOutput(params, name, value) {
+    const existing = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase());
+    if (existing) {
+        existing.Value = value;
+        existing.Type = 'Output';
+        return;
+    }
+    params.Params = params.Params ?? [];
+    params.Params.push({ Name: name, Value: value, Type: 'Output' });
+}
+/**
+ * Render an order as an invoice, quote or credit memo.
+ *
+ * Inputs: `OrderID` (required), `CompanyID`, `AsOfDate`, `TemplateName`, `Locale`, `CurrencyCode`,
+ * `Format`, `ShowDiagnostics`. Outputs: `Invoices`, `HTML`, `DocumentCount`, `Notes`.
+ */
+let GenerateInvoiceAction = class GenerateInvoiceAction extends BaseAction {
+    /**
+     * AN ACTION MUST NOT THROW AT ITS CALLER. The layers below guard their inputs by throwing —
+     * `RequireUUID` is what keeps an id out of a SQL string — and a workflow, an agent or a print
+     * button calling this gets an exception rather than a result it can branch on. So the whole body
+     * runs behind this, and every failure comes back as a Success=false with a code.
+     */
+    async InternalRunAction(params) {
+        try {
+            return await this.render(params);
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'ERROR',
+                Message: `Could not produce the invoice: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    async render(params) {
+        const orderID = strParam(params, 'OrderID');
+        if (!orderID) {
+            return {
+                Success: false,
+                ResultCode: 'MISSING_ORDER_ID',
+                Message: 'OrderID is required — this action renders an existing order and has nothing to render without one.',
+            };
+        }
+        if (!UUID.test(orderID)) {
+            // Refused HERE rather than let the reader's SQL guard throw, so a caller passing a
+            // record number, a blank string or an injection attempt gets an answer it can branch on.
+            return {
+                Success: false,
+                ResultCode: 'INVALID_ORDER_ID',
+                Message: `'${orderID}' is not an order ID. This action takes the OrderHeader's ID, not its order number.`,
+            };
+        }
+        const companyID = strParam(params, 'CompanyID');
+        if (companyID && !UUID.test(companyID)) {
+            return {
+                Success: false,
+                ResultCode: 'INVALID_COMPANY_ID',
+                Message: `'${companyID}' is not a company ID.`,
+            };
+        }
+        const user = params.ContextUser;
+        if (!user) {
+            return {
+                Success: false,
+                ResultCode: 'MISSING_USER',
+                Message: 'ContextUser is required: the order is read through the metadata layer, which resolves permissions per user.',
+            };
+        }
+        // Honour a caller's provider when one is threaded through — an invoice rendered inside a
+        // transaction must read the same connection that owns it, or it reports the order as it was
+        // before the work it is meant to document.
+        //
+        // The fallback is `Metadata.Provider`, NOT `new Metadata()`. A `Metadata` instance is a
+        // facade over the provider and does not implement `IMetadataProvider`; handing one to
+        // `RunView.FromMetadataProvider` type-checks only through a cast and fails at the first
+        // read with "RunView is not a function".
+        const provider = params.Provider ?? Metadata.Provider;
+        if (!provider) {
+            return {
+                Success: false,
+                ResultCode: 'NO_PROVIDER',
+                Message: 'No metadata provider is configured — the data layer has not been set up in this process.',
+            };
+        }
+        const format = (strParam(params, 'Format') ?? 'HTML').toUpperCase();
+        if (!['HTML', 'DATA'].includes(format)) {
+            return {
+                Success: false,
+                ResultCode: 'UNSUPPORTED_FORMAT',
+                Message: `Format '${format}' is not supported. Use 'HTML' for a rendered document or 'DATA' for the figures alone. PDF is produced by rendering this HTML — see the operations notes.`,
+            };
+        }
+        const rendered = await RenderInvoiceDocuments(orderID, provider, user, {
+            CompanyID: companyID,
+            AsOfDate: strParam(params, 'AsOfDate'),
+            TemplateName: strParam(params, 'TemplateName') ?? DEFAULT_INVOICE_TEMPLATE,
+            Locale: strParam(params, 'Locale') ?? 'en-US',
+            CurrencyCode: strParam(params, 'CurrencyCode'),
+            Format: format,
+            ShowDiagnostics: boolParam(params, 'ShowDiagnostics', false),
+        });
+        if (!rendered.Success) {
+            return {
+                Success: false,
+                ResultCode: rendered.Code ?? 'RENDER_FAILED',
+                Message: rendered.Message ?? 'The order could not be rendered.',
+            };
+        }
+        const invoices = rendered.Documents;
+        setOutput(params, 'Invoices', invoices);
+        // The scalar HTML is a convenience for the overwhelmingly common single-company order. It is
+        // deliberately null when an order split, rather than silently handing back the first of two
+        // documents as though it were the whole bill.
+        setOutput(params, 'HTML', invoices.length === 1 ? invoices[0].HTML : null);
+        setOutput(params, 'DocumentCount', invoices.length);
+        const notes = invoices.flatMap((i) => i.Notes.map((n) => `${i.DocumentNumber}: ${n}`));
+        setOutput(params, 'Notes', notes);
+        const kind = invoices[0]?.Kind ?? 'Invoice';
+        return {
+            Success: true,
+            ResultCode: invoices.length > 1 ? 'SPLIT_BY_COMPANY' : 'SUCCESS',
+            Params: params.Params,
+            Message: invoices.length > 1
+                ? `This order is sold by ${invoices.length} companies, so it produces ${invoices.length} documents: ${invoices.map((i) => i.DocumentNumber).join(', ')}. Each one bills only what its company is owed.`
+                : `${kind} ${invoices[0]?.DocumentNumber ?? ''} rendered.`,
+        };
+    }
+};
+GenerateInvoiceAction = __decorate([
+    RegisterClass(BaseAction, 'Orders.GenerateInvoice')
+], GenerateInvoiceAction);
+export { GenerateInvoiceAction };
+/**
+ * Registers {@link GenerateInvoiceAction}.
+ *
+ * WITHOUT THIS ANCHOR the class is tree-shaken out of the bundle, the `@RegisterClass` decorator
+ * never runs, and `ActionEngine` falls back to no implementation — which surfaces as an action that
+ * exists in metadata and does nothing.
+ */
+export function LoadGenerateInvoiceAction() {
+    void GenerateInvoiceAction;
+}
+//# sourceMappingURL=generate-invoice.action.js.map

package/dist/custom/generate-invoice.action.js.map

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

package/dist/custom/open-payment-intent.action.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview `Orders: Open Payment Intent` — ask a gateway to stand ready to take money.
+ *
+ * WHY AN ACTION. Three callers want this and they are different in kind: the customer portal opening
+ * a checkout, a renewal job charging a saved mandate on schedule, and a person in the back office
+ * sending a pay link. Actions are the surface all three already speak, and they are discoverable in
+ * metadata rather than only from code.
+ *
+ * IT MOVES NO MONEY AND WRITES NO PAYMENT. Opening an intent is the gateway agreeing to stand ready;
+ * nothing is owed differently because of it, and an intent nobody completes simply expires. The
+ * payment is written later by `Orders.CapturePayment`, which takes the `PaymentIntentID` this returns.
+ *
+ * THE ORDER OF THE TWO CALLS IS THE WHOLE POINT. Until now `CreateIntent` existed on every driver and
+ * was called by nothing but unit tests, so a provider-backed capture always failed with "there is
+ * nothing for the gateway to capture". This action is the missing first step.
+ *
+ * THE CLIENT SECRET IS AN OUTPUT AND IS NEVER PERSISTED. It authorises a browser to confirm this one
+ * intent. Callers should hand it straight to Stripe.js and not log it.
+ *
+ * @module @mj-biz-apps/orders-actions
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/**
+ * Open a gateway payment intent.
+ *
+ * Inputs: `PaymentProviderID` (required), `Amount` (required), `CurrencyCode`, `OrderHeaderID`,
+ * `BillToPersonID`, `BillToOrganizationID`, `ProviderCustomerRef`, `ProviderInstrumentRef`,
+ * `IdempotencyKey`.
+ * Outputs: `PaymentIntentID`, `ProviderIntentID`, `Status`, `ClientSecret`, `HostedUrl`, `WasExisting`.
+ */
+export declare class OpenPaymentIntentAction extends BaseAction {
+    /** An action must not throw at its caller — same reasoning as the other hand-authored actions. */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private open;
+}
+/** Tree-shaking anchor — without it the decorator never runs and the action has nothing behind it. */
+export declare function LoadOpenPaymentIntentAction(): void;
+//# sourceMappingURL=open-payment-intent.action.d.ts.map

package/dist/custom/open-payment-intent.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-payment-intent.action.d.ts","sourceRoot":"","sources":["../../src/custom/open-payment-intent.action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAe,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAoCrG;;;;;;;GAOG;AACH,qBACa,uBAAwB,SAAQ,UAAU;IACnD,kGAAkG;cAClF,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAYzE,IAAI;CA0FrB;AAED,sGAAsG;AACtG,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

package/dist/custom/open-payment-intent.action.js

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview `Orders: Open Payment Intent` — ask a gateway to stand ready to take money.
+ *
+ * WHY AN ACTION. Three callers want this and they are different in kind: the customer portal opening
+ * a checkout, a renewal job charging a saved mandate on schedule, and a person in the back office
+ * sending a pay link. Actions are the surface all three already speak, and they are discoverable in
+ * metadata rather than only from code.
+ *
+ * IT MOVES NO MONEY AND WRITES NO PAYMENT. Opening an intent is the gateway agreeing to stand ready;
+ * nothing is owed differently because of it, and an intent nobody completes simply expires. The
+ * payment is written later by `Orders.CapturePayment`, which takes the `PaymentIntentID` this returns.
+ *
+ * THE ORDER OF THE TWO CALLS IS THE WHOLE POINT. Until now `CreateIntent` existed on every driver and
+ * was called by nothing but unit tests, so a provider-backed capture always failed with "there is
+ * nothing for the gateway to capture". This action is the missing first step.
+ *
+ * THE CLIENT SECRET IS AN OUTPUT AND IS NEVER PERSISTED. It authorises a browser to confirm this one
+ * intent. Callers should hand it straight to Stripe.js and not log it.
+ *
+ * @module @mj-biz-apps/orders-actions
+ */
+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;
+};
+import { BaseAction } from '@memberjunction/actions';
+import { Metadata } from '@memberjunction/core';
+import { RegisterClass } from '@memberjunction/global';
+import { OpenPaymentIntent } from '@mj-biz-apps/orders-core-entities-server';
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function param(params, name) {
+    return params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase())?.Value;
+}
+function strParam(params, name) {
+    const raw = param(params, name);
+    if (raw == null)
+        return null;
+    const value = String(raw).trim();
+    return value.length ? value : null;
+}
+function numParam(params, name) {
+    const raw = param(params, name);
+    if (raw == null || raw === '')
+        return null;
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : null;
+}
+function setOutput(params, name, value) {
+    const existing = params.Params?.find((p) => p.Name?.toLowerCase() === name.toLowerCase());
+    if (existing) {
+        existing.Value = value;
+        existing.Type = 'Output';
+        return;
+    }
+    params.Params = params.Params ?? [];
+    params.Params.push({ Name: name, Value: value, Type: 'Output' });
+}
+/**
+ * Open a gateway payment intent.
+ *
+ * Inputs: `PaymentProviderID` (required), `Amount` (required), `CurrencyCode`, `OrderHeaderID`,
+ * `BillToPersonID`, `BillToOrganizationID`, `ProviderCustomerRef`, `ProviderInstrumentRef`,
+ * `IdempotencyKey`.
+ * Outputs: `PaymentIntentID`, `ProviderIntentID`, `Status`, `ClientSecret`, `HostedUrl`, `WasExisting`.
+ */
+let OpenPaymentIntentAction = class OpenPaymentIntentAction extends BaseAction {
+    /** An action must not throw at its caller — same reasoning as the other hand-authored actions. */
+    async InternalRunAction(params) {
+        try {
+            return await this.open(params);
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'ERROR',
+                Message: `Could not open a payment intent: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    async open(params) {
+        const providerID = strParam(params, 'PaymentProviderID');
+        if (!providerID) {
+            return {
+                Success: false,
+                ResultCode: 'MISSING_PROVIDER_ID',
+                Message: 'PaymentProviderID is required — it decides which gateway account to ask and which credentials to use.',
+            };
+        }
+        if (!UUID.test(providerID)) {
+            return {
+                Success: false,
+                ResultCode: 'INVALID_PROVIDER_ID',
+                Message: `'${providerID}' is not a payment provider ID. This takes the PaymentProvider row's ID, not the type code.`,
+            };
+        }
+        for (const optional of ['OrderHeaderID', 'BillToPersonID', 'BillToOrganizationID']) {
+            const value = strParam(params, optional);
+            if (value && !UUID.test(value)) {
+                return { Success: false, ResultCode: 'INVALID_ID', Message: `'${value}' is not a valid ${optional}.` };
+            }
+        }
+        const amount = numParam(params, 'Amount');
+        if (amount == null || amount <= 0) {
+            return {
+                Success: false,
+                ResultCode: 'INVALID_AMOUNT',
+                Message: `Amount must be a positive number; received '${param(params, 'Amount')}'.`,
+            };
+        }
+        const user = params.ContextUser;
+        if (!user) {
+            return {
+                Success: false,
+                ResultCode: 'MISSING_USER',
+                Message: 'ContextUser is required: the provider and its credentials are resolved through the metadata layer.',
+            };
+        }
+        const provider = params.Provider ?? Metadata.Provider;
+        if (!provider) {
+            return { Success: false, ResultCode: 'NO_PROVIDER', Message: 'No metadata provider is configured.' };
+        }
+        const result = await OpenPaymentIntent({
+            PaymentProviderID: providerID,
+            Amount: amount,
+            CurrencyCode: strParam(params, 'CurrencyCode') ?? 'USD',
+            OrderHeaderID: strParam(params, 'OrderHeaderID'),
+            BillToPersonID: strParam(params, 'BillToPersonID'),
+            BillToOrganizationID: strParam(params, 'BillToOrganizationID'),
+            ProviderCustomerRef: strParam(params, 'ProviderCustomerRef'),
+            ProviderInstrumentRef: strParam(params, 'ProviderInstrumentRef'),
+            IdempotencyKey: strParam(params, 'IdempotencyKey'),
+        }, provider, user);
+        if (!result.Success) {
+            // A gateway refusal, not a fault. Reported with the gateway's own words so the person
+            // retrying knows whether to change something or just try again.
+            return {
+                Success: false,
+                ResultCode: 'GATEWAY_REFUSED',
+                Params: params.Params,
+                Message: result.Reason ?? 'The gateway did not open a payment intent.',
+            };
+        }
+        setOutput(params, 'PaymentIntentID', result.PaymentIntentID);
+        setOutput(params, 'ProviderIntentID', result.ProviderIntentID);
+        setOutput(params, 'Status', result.Status);
+        setOutput(params, 'ClientSecret', result.ClientSecret);
+        setOutput(params, 'HostedUrl', result.HostedUrl);
+        setOutput(params, 'WasExisting', result.WasExisting === true);
+        return {
+            Success: true,
+            ResultCode: result.WasExisting ? 'ALREADY_OPEN' : 'OPENED',
+            Params: params.Params,
+            Message: result.WasExisting
+                ? `Payment intent ${result.ProviderIntentID} was already open; reusing it.`
+                : `Opened payment intent ${result.ProviderIntentID} (${result.Status}). Pass PaymentIntentID to Orders.CapturePayment when the money is confirmed.`,
+        };
+    }
+};
+OpenPaymentIntentAction = __decorate([
+    RegisterClass(BaseAction, 'Orders.OpenPaymentIntent')
+], OpenPaymentIntentAction);
+export { OpenPaymentIntentAction };
+/** Tree-shaking anchor — without it the decorator never runs and the action has nothing behind it. */
+export function LoadOpenPaymentIntentAction() {
+    void OpenPaymentIntentAction;
+}
+//# sourceMappingURL=open-payment-intent.action.js.map

package/dist/custom/open-payment-intent.action.js.map

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

package/dist/custom/send-document.action.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview `Orders: Send Document` — render a customer-facing document and actually send it.
+ *
+ * WHY THIS IS SEPARATE FROM `Orders: Generate Invoice`. Generating writes nothing and can be called a
+ * hundred times safely — a print button, a reconciliation check, a PDF job. Sending is IRREVERSIBLE and
+ * reaches a person outside the company. Folding a `Send: true` flag into the render action would put
+ * the single most consequential side effect in this app behind a boolean that is easy to set by
+ * accident, in an action whose whole documented contract is that it never writes.
+ *
+ * WHAT IT COMPOSES, and the order is the design:
+ *
+ *   1. RENDER   `RenderInvoiceDocuments` — the same service `Orders.GenerateInvoice` calls
+ *   2. RESOLVE  who the order says it is billed to, and their recorded addresses
+ *   3. DECIDE   `DecideDelivery` — is this a bill at all, and is there anybody to send it to
+ *   4. DELIVER  the registered channel for the requested code
+ *
+ * Every step is somebody else's code. This action extracts parameters, sequences four calls, and maps
+ * the answers onto result codes — which is what an action is supposed to be.
+ *
+ * ONE DOCUMENT PER SELLING COMPANY, ONE SEND EACH. An order sold by two companies is two receivables
+ * owed to two legal entities, and each has its own remit-to details. They are sent as two messages,
+ * and if the second fails the first is still reported as sent — the alternative, reporting the whole
+ * thing as failed, invites a retry that sends the first one twice.
+ *
+ * IT IS NOT IDEMPOTENT, AND SAYS SO. Calling it twice sends the document twice. `DeliveryIdempotencyKey`
+ * exists so a caller that needs at-most-once can build it, but this action cannot make that judgement:
+ * re-sending because the customer asked again is ordinary, and re-sending because a workflow retried is
+ * not, and only the caller knows which happened.
+ *
+ * @module @mj-biz-apps/orders-actions
+ */
+import { BaseAction } from '@memberjunction/actions';
+import type { ActionResultSimple, RunActionParams } from '@memberjunction/actions-base';
+/** What happened to one document. */
+export interface DocumentDeliveryOutcome {
+    DocumentNumber: string;
+    Kind: string;
+    CompanyID: string;
+    Sent: boolean;
+    /** Addresses the channel accepted. */
+    Recipients: string[];
+    /** Why not, when not. */
+    Reason?: string;
+    /** A stable key for "this document, this channel, this address" — for a caller doing its own dedup. */
+    IdempotencyKeys: string[];
+}
+/**
+ * Send an order's document to the customer.
+ *
+ * Inputs: `OrderID` (required), `CompanyID`, `Channel`, `TemplateName`, `Locale`, `CurrencyCode`,
+ * `ToAddress`, `CC`, `BCC`, `From`, `FromName`, `PreviewOnly`.
+ * Outputs: `Deliveries`, `SentCount`, `FailedCount`.
+ */
+export declare class SendDocumentAction extends BaseAction {
+    /**
+     * AN ACTION MUST NOT THROW AT ITS CALLER — same reasoning as `Orders.GenerateInvoice`. The layers
+     * below guard by throwing, and a workflow or agent needs a result it can branch on.
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    private send;
+    /**
+     * The rendered document, reduced to what the delivery decision needs.
+     *
+     * The ORDER's status is carried through rather than the document's kind alone, because "may this
+     * be sent" is a question about the order — a draft renders perfectly well and must not be mailed.
+     */
+    private toFacts;
+    /** A comma- or semicolon-separated list, or an array, from one parameter. */
+    private addressList;
+}
+/**
+ * Registers {@link SendDocumentAction}.
+ *
+ * WITHOUT THIS ANCHOR the class is tree-shaken out, the `@RegisterClass` decorator never runs, and
+ * `ActionEngine` finds an action row with no implementation behind it.
+ */
+export declare function LoadSendDocumentAction(): void;
+//# sourceMappingURL=send-document.action.d.ts.map

package/dist/custom/send-document.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-document.action.d.ts","sourceRoot":"","sources":["../../src/custom/send-document.action.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAe,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAsBrG,qCAAqC;AACrC,MAAM,WAAW,uBAAuB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AA+BD;;;;;;GAMG;AACH,qBACa,kBAAmB,SAAQ,UAAU;IAC9C;;;OAGG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAYzE,IAAI;IAoKlB;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAcf,6EAA6E;IAC7E,OAAO,CAAC,WAAW;CAMtB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}