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

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * BizApps Orders Server Bootstrap
+ *
+ * Server-side bootstrap package for the BizApps Orders Open App. Ensures the
+ * entity subclasses, action subclasses, and GraphQL resolvers are registered
+ * with the MJ class factory.
+ */
+import '@mj-biz-apps/orders-entities';
+import '@mj-biz-apps/orders-actions';
+import '@mj-biz-apps/orders-core-entities-server';
+import './generated/generated.js';
+export { CLASS_REGISTRATIONS } from './generated/class-registrations-manifest.js';
+export { PaymentWebhookExtension, LoadPaymentWebhookExtension } from './PaymentWebhookExtension.js';
+export { CheckoutServerExtension, LoadCheckoutServerExtension } from './CheckoutServerExtension.js';
+export { MJ_SERVER_EXTENSIONS } from './server-extensions-manifest.js';
+/**
+ * Absolute paths to the resolver files (generated + custom), for use with createMJServer().
+ * NOTE the `*Resolver.{js,ts}` suffix for custom resolvers (not `*.{js,ts}`): brace-expansion
+ * of `*.{js,ts}` would also match emitted `*.d.ts` files, which ts-node then fails to require.
+ */
+export declare const RESOLVER_PATHS: string[];
+/**
+ * Bootstrap function called by DynamicPackageLoader during MJAPI startup.
+ * The static imports above handle all registration; this function is the
+ * startupExport entry point.
+ */
+export declare function LoadBizAppsOrdersServer(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,8BAA8B,CAAC;AACtC,OAAO,6BAA6B,CAAC;AAYrC,OAAO,0CAA0C,CAAC;AAyClD,OAAO,0BAA0B,CAAC;AAMlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACpG,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAOvE;;;;GAIG;AACH,eAAO,MAAM,cAAc,UAG1B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CA0D9C"}

package/dist/index.js

@@ -0,0 +1,105 @@
+/**
+ * BizApps Orders Server Bootstrap
+ *
+ * Server-side bootstrap package for the BizApps Orders Open App. Ensures the
+ * entity subclasses, action subclasses, and GraphQL resolvers are registered
+ * with the MJ class factory.
+ */
+// Import entity and action packages to trigger @RegisterClass decorators
+import '@mj-biz-apps/orders-entities';
+import '@mj-biz-apps/orders-actions';
+// Hand-authored, SERVER-ONLY actions. These live here rather than in @mj-biz-apps/orders-actions
+// because they import @mj-biz-apps/orders-core-entities-server — and orders-actions is a `shared`
+// package that also ships to MJExplorer, where a server dependency drags Node's `stream` into the
+// browser bundle and breaks the build. See packages/Actions/src/index.ts.
+import { LoadGenerateInvoiceAction } from './custom/generate-invoice.action.js';
+import { LoadOpenPaymentIntentAction } from './custom/open-payment-intent.action.js';
+import { LoadSendDocumentAction } from './custom/send-document.action.js';
+// Server-side entity subclasses — MUST come after orders-entities so @RegisterClass
+// auto-increment gives these higher priority than the generated classes.
+import '@mj-biz-apps/orders-core-entities-server';
+import { LoadCancelSubscriptionOperation, LoadEnvironmentSecretResolver, LoadManualPaymentProvider, LoadOrderEntityServer, LoadOrderLineEntityServer, LoadPaymentHeaderEntityServer, LoadPaymentLineEntityServer, LoadRefundPaymentOperation, LoadApplyAccountCreditOperation, LoadPreviewPriceOperation, LoadPriceOrderOperation, LoadGetOverdueWorklistOperation, LoadGetFulfillmentQueueOperation, LoadFulfillOrderLinesOperation, LoadCapturePaymentOperation, LoadAdvanceOrderStateOperation, LoadDefaultPriceResolver, LoadPromotionEngine, LoadTaxResolver, LoadRevenueRecognitionDrivers, LoadSpawnRenewalsOperation, LoadEmailDeliveryChannel, LoadStoredValuePaymentProvider, LoadStripeACHPaymentProvider, LoadStripePaymentProvider, LoadSubscriptionBehavior, LoadEntitlementGrantClaimDriver, LoadGuestOrderClaimDriver, LoadCheckEntitlementOperation, LoadListEntitlementsOperation, } from '@mj-biz-apps/orders-core-entities-server';
+// The unauthenticated webhook route. Registered as a server EXTENSION rather than mounted here,
+// because it must be installed before MJServer's auth middleware — see the file for why.
+import { LoadPaymentWebhookExtension } from './PaymentWebhookExtension.js';
+// The anonymous checkout edge — same pre-auth extension mechanism as the webhook.
+import { LoadCheckoutServerExtension } from './CheckoutServerExtension.js';
+// Import generated GraphQL resolvers
+import './generated/generated.js';
+// Re-export the manifest for consumers
+export { CLASS_REGISTRATIONS } from './generated/class-registrations-manifest.js';
+export { PaymentWebhookExtension, LoadPaymentWebhookExtension } from './PaymentWebhookExtension.js';
+export { CheckoutServerExtension, LoadCheckoutServerExtension } from './CheckoutServerExtension.js';
+export { MJ_SERVER_EXTENSIONS } from './server-extensions-manifest.js';
+import { fileURLToPath } from 'node:url';
+import { resolve } from 'node:path';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+/**
+ * Absolute paths to the resolver files (generated + custom), for use with createMJServer().
+ * NOTE the `*Resolver.{js,ts}` suffix for custom resolvers (not `*.{js,ts}`): brace-expansion
+ * of `*.{js,ts}` would also match emitted `*.d.ts` files, which ts-node then fails to require.
+ */
+export const RESOLVER_PATHS = [
+    resolve(__dirname, 'generated/generated.{js,ts}'),
+    resolve(__dirname, 'resolvers/*Resolver.{js,ts}'),
+];
+/**
+ * Bootstrap function called by DynamicPackageLoader during MJAPI startup.
+ * The static imports above handle all registration; this function is the
+ * startupExport entry point.
+ */
+export function LoadBizAppsOrdersServer() {
+    // Static imports above ensure all classes are registered; these anchor the server-only
+    // subclasses against tree-shaking (booking lives in OrderEntityServer.Save).
+    LoadOrderEntityServer();
+    LoadOrderLineEntityServer();
+    LoadPaymentHeaderEntityServer(); // books the cash leg on capture/refund (D18)
+    LoadPaymentLineEntityServer(); // the over-application guard
+    LoadRefundPaymentOperation(); // the 'Orders.RefundPayment' remote operation (D17)
+    LoadApplyAccountCreditOperation(); // the 'Orders.ApplyAccountCredit' remote operation (D68)
+    LoadPreviewPriceOperation(); // the 'Orders.PreviewPrice' dry run (D69)
+    LoadPriceOrderOperation(); // 'Orders.PriceOrder' — what a whole order comes to, persisting nothing
+    LoadGetOverdueWorklistOperation(); // 'Orders.GetOverdueWorklist' — overdue is computed, not stored
+    LoadGetFulfillmentQueueOperation(); // 'Orders.GetFulfillmentQueue' — so is the shipping backlog
+    LoadFulfillOrderLinesOperation(); // 'Orders.FulfillOrderLines' — flip lines AND close the order, one act
+    LoadCapturePaymentOperation(); // 'Orders.CapturePayment' — header + allocations in ONE transaction
+    LoadAdvanceOrderStateOperation(); // 'Orders.AdvanceOrderState' — climbs the ladder above Confirmed (D17)
+    LoadDefaultPriceResolver(); // the data-driven price resolver the walk falls back to (D69)
+    LoadPromotionEngine(); // the promotion qualifier plugin seam (D70)
+    LoadTaxResolver(); // the address -> jurisdiction seam (D72)
+    LoadRevenueRecognitionDrivers(); // the three shipped rev-rec drivers (D43)
+    LoadSubscriptionBehavior(); // the base subscription rules engine (D45)
+    LoadCancelSubscriptionOperation(); // the 'Orders.CancelSubscription' remote operation
+    LoadSpawnRenewalsOperation(); // the 'Orders.SpawnRenewals' remote operation (D55)
+    LoadCheckEntitlementOperation(); // 'Orders.CheckEntitlement' — LXP ask/answer (read contract)
+    LoadListEntitlementsOperation(); // 'Orders.ListEntitlements' — the person's library, same evaluator
+    // Payment drivers (D19/D37). Each is keyed by its PaymentProviderType.Code, and WITHOUT these
+    // anchors the @RegisterClass decorators are tree-shaken away — the ClassFactory then falls back to
+    // the base driver, which declines every operation. `PaymentProviderResolver` refuses that fallback
+    // explicitly rather than letting "nobody registered a driver" read as "the gateway said no".
+    LoadStripePaymentProvider(); // cards; stub when the provider row is not live
+    LoadStripeACHPaymentProvider(); // US bank debits — settles LATE, so the webhook books the cash
+    LoadManualPaymentProvider(); // cheque, wire, cash — no gateway to call
+    LoadStoredValuePaymentProvider(); // gift cards and account credit, one driver (D38/D68)
+    LoadEnvironmentSecretResolver(); // the default CredentialsRef -> env lookup; replaceable
+    // Actions. Same tree-shaking hazard as the operations above: without the anchor the action row
+    // exists in metadata and `ActionEngine` finds nothing registered under its DriverClass.
+    LoadGenerateInvoiceAction(); // 'Orders.GenerateInvoice' — an order, rendered (D-INV)
+    LoadSendDocumentAction(); // 'Orders.SendDocument' — an order, rendered AND sent (§4.4)
+    LoadOpenPaymentIntentAction(); // 'Orders.OpenPaymentIntent' — the FIRST half of a gateway capture (D80)
+    // Delivery channels (§4.4). Same tree-shaking hazard as the payment drivers, and the same
+    // deliberately unhelpful failure without the anchor: `DeliveryResolver` refuses the base-class
+    // fallback rather than letting "nobody registered a channel" read as "the channel refused to send".
+    LoadEmailDeliveryChannel(); // 'Email' — over MJ's communication framework
+    // Identity-claim drivers (guest checkout → account linking). Without these anchors the
+    // @RegisterClass decorators are tree-shaken and MJ core's IdentityClaimEngine finds no
+    // driver for the DriverClass named in the claim-type metadata — silently.
+    LoadGuestOrderClaimDriver(); // 'GuestOrderClaimDriver' — re-parents the order + activates grants on redemption
+    LoadEntitlementGrantClaimDriver(); // 'EntitlementGrantClaimDriver' — activates a single grant on redemption
+    // Server extensions. Same tree-shaking hazard again: without the anchor the class is absent from
+    // the ClassFactory and MJServer's extension loader silently finds nothing for the DriverClass named
+    // in mj.config.cjs — so the webhook route is never mounted and no bank debit ever captures.
+    LoadPaymentWebhookExtension(); // POST /webhooks/payments/:providerId, mounted before auth
+    LoadCheckoutServerExtension(); // GET /checkout/:slug + POST /checkout/{initialize,draft,payment-intent,complete}, mounted before auth
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server-extensions-manifest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Server-extension declarations for `@mj-biz-apps/orders-server`.
+ *
+ * MJ bootstrap (`createMJServer`) collects this list from installed Open App
+ * packages listed in the host `mj.config.cjs` `dynamicPackages.server[]` — either
+ * from this named export or from `package.json` `memberjunction.serverExtensions`.
+ * Host `serverExtensions[]` overlays by DriverClass (Settings, RootPath, Enabled).
+ *
+ * Keep this array in sync with `package.json` → `memberjunction.serverExtensions`
+ * and with this repo's own `mj.config.cjs` `serverExtensions` defaults.
+ */
+import type { ServerExtensionConfig } from '@memberjunction/server-extensions-core';
+export declare const MJ_SERVER_EXTENSIONS: ServerExtensionConfig[];
+//# sourceMappingURL=server-extensions-manifest.d.ts.map

package/dist/server-extensions-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-extensions-manifest.d.ts","sourceRoot":"","sources":["../src/server-extensions-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAEpF,eAAO,MAAM,oBAAoB,EAAE,qBAAqB,EAavD,CAAC"}

package/dist/server-extensions-manifest.js

@@ -0,0 +1,15 @@
+export const MJ_SERVER_EXTENSIONS = [
+    {
+        Enabled: true,
+        DriverClass: 'OrdersPaymentWebhook',
+        RootPath: '/webhooks/payments',
+        Settings: {},
+    },
+    {
+        Enabled: true,
+        DriverClass: 'OrdersCheckoutEdge',
+        RootPath: '/checkout',
+        Settings: {},
+    },
+];
+//# sourceMappingURL=server-extensions-manifest.js.map

package/dist/server-extensions-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-extensions-manifest.js","sourceRoot":"","sources":["../src/server-extensions-manifest.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,MAAM,oBAAoB,GAA4B;IACzD;QACI,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,sBAAsB;QACnC,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ,EAAE,EAAE;KACf;IACD;QACI,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,oBAAoB;QACjC,QAAQ,EAAE,WAAW;QACrB,QAAQ,EAAE,EAAE;KACf;CACJ,CAAC"}

package/dist/services/invoice-renderer.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Turning an order into rendered documents — the orchestration, extracted so two actions can share it.
+ *
+ * WHY IT MOVED OUT OF THE ACTION. `Orders.GenerateInvoice` owned this sequence, which was correct while
+ * it was the only caller. `Orders.SendDocument` needs the identical sequence — read the order, build
+ * one document per selling company, decorate it for a locale, render it through a database template —
+ * and an action calling another action is the pattern MJ's own guidance rules out: it produces a stack
+ * trace that goes through the metadata dispatcher instead of the code, and a rename that the compiler
+ * cannot follow. So the sequence became a service and both actions are thin wrappers over it, which is
+ * what the guidance asks for.
+ *
+ * IT RETURNS A RESULT, NEVER THROWS FOR A REFUSAL. A voided order, a missing template and an unknown
+ * order id are all ANSWERS — the caller has to branch on them and turn them into an action result code
+ * — while a provider that is not configured is a fault. Keeping that line in the same place the
+ * payment drivers keep it means a caller can trust it everywhere.
+ *
+ * THE TEMPLATE IS RESOLVED ONCE PER CALL, not once per document. A two-company order should not
+ * resolve the same template twice, and a month-end run producing four hundred invoices should not
+ * resolve it four hundred times.
+ *
+ * CONNECTS TO:
+ *   READER:  @mj-biz-apps/orders-core-entities-server → BuildInvoiceDocuments, DecorateInvoice
+ *   ACTIONS: ../custom/generate-invoice.action.ts · ../custom/send-document.action.ts
+ */
+import type { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { type DisplayInvoice } from '@mj-biz-apps/orders-core-entities-server';
+/** The template rendered when a caller does not name one. */
+export declare const DEFAULT_INVOICE_TEMPLATE = "Orders: Standard Invoice";
+/** One rendered document. */
+export interface RenderedInvoice {
+    DocumentNumber: string;
+    Kind: string;
+    CompanyID: string;
+    CompanyName: string;
+    Gross: number;
+    AmountDue: number;
+    /** Null when `Format` asked for data only. */
+    HTML: string | null;
+    /** The full decorated document, so a caller can reconcile without parsing markup. */
+    Data: DisplayInvoice;
+    /** Anything the builder had to decide rather than read. Empty is the expected state. */
+    Notes: string[];
+}
+export interface RenderInvoiceOptions {
+    /** Render only this selling company's document. Omit for every document the order produces. */
+    CompanyID?: string | null;
+    AsOfDate?: string | null;
+    TemplateName?: string | null;
+    Locale?: string | null;
+    /** Overrides the selling company's functional currency. Only for a caller who genuinely knows better. */
+    CurrencyCode?: string | null;
+    /** `HTML` for rendered markup, `DATA` for the figures alone. */
+    Format?: 'HTML' | 'DATA';
+    ShowDiagnostics?: boolean;
+}
+/** A refusal carries a code so the caller can map it to an action result without parsing prose. */
+export type RenderFailureCode = 'ORDER_NOT_FOUND' | 'NOT_INVOICEABLE' | 'TEMPLATE_NOT_FOUND' | 'RENDER_FAILED';
+/**
+ * A flat result rather than a discriminated union, matching `RefundPaymentOutput` and the driver
+ * results throughout this app. The repo's tsconfig does not enable `strict`, so a boolean-literal
+ * discriminant does not narrow — a union here would compile as a type that no caller can read.
+ */
+export interface RenderInvoiceResult {
+    Success: boolean;
+    /** Empty on refusal. */
+    Documents: RenderedInvoice[];
+    /** Set when `Success` is false. */
+    Code?: RenderFailureCode;
+    /** Set when `Success` is false — written for the person who has to fix it. */
+    Message?: string;
+}
+/**
+ * Build and render every document an order produces.
+ *
+ * An order sold by more than one company produces one document PER COMPANY — they are different
+ * receivables owed to different legal entities — so this always returns an array and the caller must
+ * not treat the first element as the whole bill.
+ */
+export declare function RenderInvoiceDocuments(orderID: string, provider: IMetadataProvider, user: UserInfo, options?: RenderInvoiceOptions): Promise<RenderInvoiceResult>;
+//# sourceMappingURL=invoice-renderer.d.ts.map

package/dist/services/invoice-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-renderer.d.ts","sourceRoot":"","sources":["../../src/services/invoice-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAA0C,KAAK,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAGvH,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,6BAA6B;AAC7B,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qFAAqF;IACrF,IAAI,EAAE,cAAc,CAAC;IACrB,wFAAwF;IACxF,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACjC,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,eAAe,CAAC;AAE/G;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,mCAAmC;IACnC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAmE9B"}

package/dist/services/invoice-renderer.js

@@ -0,0 +1,103 @@
+import { BuildInvoiceDocuments, DecorateInvoice } from '@mj-biz-apps/orders-core-entities-server';
+import { TemplateEngineServer } from '@memberjunction/templates';
+/** The template rendered when a caller does not name one. */
+export const DEFAULT_INVOICE_TEMPLATE = 'Orders: Standard Invoice';
+/**
+ * Build and render every document an order produces.
+ *
+ * An order sold by more than one company produces one document PER COMPANY — they are different
+ * receivables owed to different legal entities — so this always returns an array and the caller must
+ * not treat the first element as the whole bill.
+ */
+export async function RenderInvoiceDocuments(orderID, provider, user, options = {}) {
+    const asOf = options.AsOfDate ?? null;
+    const built = await BuildInvoiceDocuments(orderID, provider, user, {
+        AsOf: asOf,
+        OnlyCompanyID: options.CompanyID ?? null,
+    });
+    if (!built.Success) {
+        // A refusal is reported as a refusal, not as an empty success. Zero documents with Success=true
+        // reads to a workflow as "this order needed no invoice".
+        return {
+            Success: false,
+            Documents: [],
+            Code: built.Message?.includes('voided') ? 'NOT_INVOICEABLE' : 'ORDER_NOT_FOUND',
+            Message: built.Message ?? `Order '${orderID}' produced no documents.`,
+        };
+    }
+    const format = options.Format ?? 'HTML';
+    const locale = options.Locale ?? 'en-US';
+    const generatedOn = asOf ?? new Date().toISOString().slice(0, 10);
+    const templateName = options.TemplateName ?? DEFAULT_INVOICE_TEMPLATE;
+    let render = null;
+    if (format === 'HTML') {
+        const prepared = await prepareTemplate(templateName, user, provider, options.ShowDiagnostics === true);
+        if ('error' in prepared) {
+            return { Success: false, Documents: [], Code: 'TEMPLATE_NOT_FOUND', Message: prepared.error };
+        }
+        render = prepared.render;
+    }
+    const documents = [];
+    for (const doc of built.Documents) {
+        // Currency comes from the SELLING COMPANY's accounting profile, because it is a property of the
+        // seller and not of the sale.
+        const currency = options.CurrencyCode ?? doc.Issuer.CurrencyCode ?? 'USD';
+        const decorated = DecorateInvoice(doc, { Locale: locale, Currency: currency, GeneratedOn: generatedOn });
+        let html = null;
+        if (render) {
+            const rendered = await render(decorated);
+            if (rendered.error) {
+                return {
+                    Success: false,
+                    Documents: [],
+                    Code: 'RENDER_FAILED',
+                    Message: `Could not render ${doc.DocumentNumber}: ${rendered.error}`,
+                };
+            }
+            html = rendered.html;
+        }
+        documents.push({
+            DocumentNumber: doc.DocumentNumber,
+            Kind: doc.Kind,
+            CompanyID: doc.CompanyID,
+            CompanyName: doc.CompanyName,
+            Gross: doc.Gross,
+            AmountDue: doc.AmountDue,
+            HTML: html,
+            Data: decorated,
+            Notes: doc.Notes,
+        });
+    }
+    return { Success: true, Documents: documents };
+}
+/**
+ * Find the template and its content, and return a render function bound to them.
+ */
+async function prepareTemplate(templateName, user, provider, showDiagnostics) {
+    const engine = TemplateEngineServer.Instance;
+    await engine.Config(false, user, provider);
+    const template = engine.FindTemplate(templateName);
+    if (!template) {
+        return {
+            error: `No template named '${templateName}'. The standard one is '${DEFAULT_INVOICE_TEMPLATE}'; if it is missing, the app's metadata has not been pushed.`,
+        };
+    }
+    // Ask for HTML first, then whatever the template does have. A deployment that overrode this
+    // template with a text version should still render rather than refuse.
+    const content = template.GetHighestPriorityContent('HTML') ?? template.GetHighestPriorityContent();
+    if (!content) {
+        return { error: `Template '${templateName}' has no content rows — there is nothing to render.` };
+    }
+    return {
+        render: async (doc) => {
+            // Validation is skipped rather than declaring one template param per field: the context is
+            // a single nested document, and a param list mirroring it would be a second schema to keep
+            // in step with the first.
+            const result = await engine.RenderTemplate(template, content, { doc, options: { ShowDiagnostics: showDiagnostics } }, true, true);
+            if (!result.Success)
+                return { html: null, error: result.Message ?? 'unknown template error' };
+            return { html: result.Output ?? '' };
+        },
+    };
+}
+//# sourceMappingURL=invoice-renderer.js.map

package/dist/services/invoice-renderer.js.map

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

package/package.json

@@ -1,8 +1,68 @@
 {
   "name": "@mj-biz-apps/orders-server",
-  "version": "0.0.1",
-  "description": "Placeholder. Real releases come from https://github.com/MemberJunction/bizapps-orders",
+  "type": "module",
+  "version": "5.2.0",
+  "description": "BizApps Orders server bootstrap - GraphQL resolvers and class registrations for the unified order-management Open App",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "/dist"
+  ],
+  "memberjunction": {
+    "serverExtensions": [
+      {
+        "Enabled": true,
+        "DriverClass": "OrdersPaymentWebhook",
+        "RootPath": "/webhooks/payments",
+        "Settings": {}
+      },
+      {
+        "Enabled": true,
+        "DriverClass": "OrdersCheckoutEdge",
+        "RootPath": "/checkout",
+        "Settings": {}
+      }
+    ]
+  },
+  "author": "MemberJunction.com",
   "license": "BUSL-1.1",
-  "repository": { "type": "git", "url": "https://github.com/MemberJunction/bizapps-orders" },
-  "publishConfig": { "access": "public" }
-}
+  "devDependencies": {
+    "@mj-biz-apps/accounting-engine-base": ">=0.1.0",
+    "@mj-biz-apps/accounting-entities": ">=0.1.0",
+    "@mj-biz-apps/accounting-server": ">=0.1.0",
+    "@types/express": "^5.0.6",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@mj-biz-apps/orders-actions": "5.2.0",
+    "@mj-biz-apps/orders-core-entities-server": "5.2.0",
+    "@mj-biz-apps/orders-entities": "5.2.0",
+    "body-parser": "^2.2.0",
+    "class-validator": "^0.14.3"
+  },
+  "peerDependencies": {
+    "@memberjunction/actions": "^6.1.0-edge.4",
+    "@memberjunction/actions-base": "^6.1.0-edge.4",
+    "@memberjunction/core": "^6.1.0-edge.4",
+    "@memberjunction/global": "^6.1.0-edge.4",
+    "@memberjunction/server": "^6.1.0-edge.4",
+    "@memberjunction/server-extensions-core": "^6.1.0-edge.4",
+    "@memberjunction/generic-database-provider": "^6.1.0-edge.4",
+    "@memberjunction/templates": "^6.1.0-edge.4",
+    "@mj-biz-apps/accounting-engine-base": ">=0.1.0",
+    "@mj-biz-apps/accounting-entities": ">=0.1.0",
+    "@mj-biz-apps/accounting-server": ">=0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/bizapps-orders"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias -f",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}