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

package/dist/InvoiceBuilder.js

@@ -0,0 +1,352 @@
+/**
+ * @fileoverview Reading an order and everything that hangs off it, so {@link BuildDocuments} can
+ * turn it into something you send a customer.
+ *
+ * THE SPLIT IS DELIBERATE. Every decision lives in `InvoiceBehavior` where it can be exercised with
+ * a literal; this file only fetches. That is why the module has no arithmetic beyond the joins it
+ * needs to shape the rows, and why the discount is derived over there rather than read here.
+ *
+ * IT READS AND NOTHING ELSE. There is no invoice record to write, and there must not be one — see
+ * the header of `InvoiceBehavior`. A caller can render the same order a hundred times and the
+ * hundred documents will be identical, because the order is the only state involved.
+ *
+ * THE FETCH IS FLAT, NOT PER-LINE. Charges, allocations, adjustments and payments each come back in
+ * ONE view call for the whole order and are indexed in memory. A twenty-line order should not cost
+ * eighty round trips, and the shape that produces eighty round trips is the shape that looks
+ * perfectly readable.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import { RunView } from '@memberjunction/core';
+import { BuildDocuments, CanRender, } from './InvoiceBehavior.js';
+import { ORDER_HEADER_ENTITY } from './entity-names.js';
+import { RequireUUID } from './sql-guards.js';
+import { LoadOrdersEngine, OrdersEngine, ToISODate } from '@mj-biz-apps/orders-entities';
+const ORDER_LINE_ENTITY = 'MJ_BizApps_Orders: Order Lines';
+const ORDER_CHARGE_ENTITY = 'MJ_BizApps_Orders: Order Charges';
+const ORDER_CHARGE_ALLOCATION_ENTITY = 'MJ_BizApps_Orders: Order Charge Allocations';
+const ORDER_ADJUSTMENT_ENTITY = 'MJ_BizApps_Orders: Order Adjustments';
+const ORDER_ADJUSTMENT_ALLOCATION_ENTITY = 'MJ_BizApps_Orders: Order Adjustment Allocations';
+const PAYMENT_LINE_ENTITY = 'MJ_BizApps_Orders: Payment Lines';
+const PAYMENT_HEADER_ENTITY = 'MJ_BizApps_Orders: Payment Headers';
+const CHARGE_TYPE_ENTITY = 'MJ_BizApps_Orders: Charge Types';
+const PRODUCT_ENTITY = 'MJ_BizApps_Orders: Products';
+const PAYMENT_TERMS_TYPE_ENTITY = 'MJ_BizApps_Orders: Payment Terms Types';
+const ADDRESS_ENTITY = 'MJ_BizApps_Common: Addresses';
+const ADDRESS_LINK_ENTITY = 'MJ_BizApps_Common: Address Links';
+const COMPANY_ENTITY = 'MJ: Companies';
+/**
+ * The selling company's accounting identity. It IS-A Company, so the row shares the company's ID —
+ * which is why the issuer block can be fetched by company ID with no join.
+ */
+const ACCOUNTING_COMPANY_PROFILE_ENTITY = 'MJ_BizApps_Accounting: Accounting Company Profiles';
+/** One view call, returning rows or an empty list — never a partial result presented as complete. */
+async function view(provider, user, entityName, extraFilter, orderBy) {
+    const result = await RunView.FromMetadataProvider(provider).RunView({ EntityName: entityName, ExtraFilter: extraFilter, OrderBy: orderBy, ResultType: 'simple' }, user);
+    if (!result.Success)
+        return { rows: [], error: `${entityName}: ${result.ErrorMessage ?? 'unknown error'}` };
+    return { rows: result.Results ?? [] };
+}
+const str = (v) => {
+    if (v == null)
+        return null;
+    const s = String(v).trim();
+    return s.length ? s : null;
+};
+const num = (v) => Number(v ?? 0);
+/**
+ * Re-exported so this file's existing importers keep resolving it here.
+ *
+ * The implementation moved to `@mj-biz-apps/orders-entities` — it was correct in this file and
+ * unreachable from Angular, which is why fifteen other sites went on hand-rolling
+ * `String(cell).slice(0, 10)` and getting `'Thu Jul 30'`.
+ */
+export { ToISODate };
+/** An SQL `IN` list of quoted UUIDs, or null when there is nothing to look up. */
+function uuidList(ids, context) {
+    const unique = [...new Set([...ids].filter(Boolean))];
+    if (!unique.length)
+        return null;
+    return unique.map((id) => `'${RequireUUID(id, context)}'`).join(',');
+}
+/** Postal lines for an address, skipping the parts that are not filled in. */
+function addressLines(row) {
+    if (!row)
+        return [];
+    const cityLine = [str(row.City), [str(row.StateProvince), str(row.PostalCode)].filter(Boolean).join(' ')]
+        .filter(Boolean)
+        .join(', ');
+    return [str(row.Line1), str(row.Line2), str(row.Line3), cityLine || null, str(row.Country)].filter(Boolean);
+}
+/**
+ * Read one order and produce its documents — one per selling company.
+ *
+ * @param orderHeaderID The order to render.
+ * @param options `AsOf` drives only the days-until-due countdown; `OnlyCompanyID` narrows a split
+ *   order to a single document without changing how the others are numbered.
+ */
+export async function BuildInvoiceDocuments(orderHeaderID, provider, user, options) {
+    const id = RequireUUID(orderHeaderID, 'OrderHeaderID');
+    const asOf = options?.AsOf ? String(options.AsOf).slice(0, 10) : new Date().toISOString().slice(0, 10);
+    const header = await view(provider, user, ORDER_HEADER_ENTITY, `ID = '${id}'`);
+    if (header.error)
+        return { Success: false, Message: `Could not read the order — ${header.error}`, Documents: [] };
+    if (!header.rows.length)
+        return { Success: false, Message: `No order with ID ${id}.`, Documents: [] };
+    const order = header.rows[0];
+    const renderable = CanRender(String(order.Status));
+    if (!renderable.OK)
+        return { Success: false, Message: renderable.Reason, Documents: [] };
+    const lineResult = await view(provider, user, ORDER_LINE_ENTITY, `OrderHeaderID = '${id}'`, 'LineNumber');
+    if (lineResult.error)
+        return { Success: false, Message: `Could not read the order lines — ${lineResult.error}`, Documents: [] };
+    const lineRows = lineResult.rows;
+    const lineIDs = uuidList(lineRows.map((l) => String(l.ID)), 'OrderLineID');
+    // Everything below is fetched in parallel: none of it depends on any of the rest, and the
+    // sequential version of this function was four times the latency for no benefit.
+    const [chargeResult, adjustmentResult, paymentLineResult, productResult, termsResult, addressResult] = await Promise.all([
+        view(provider, user, ORDER_CHARGE_ENTITY, `OrderHeaderID = '${id}'`, 'Sequence'),
+        view(provider, user, ORDER_ADJUSTMENT_ENTITY, `OrderHeaderID = '${id}'`, 'Sequence'),
+        view(provider, user, PAYMENT_LINE_ENTITY, `OrderHeaderID = '${id}'`),
+        (async () => {
+            const ids = uuidList(lineRows.map((l) => l.ProductID), 'ProductID');
+            return ids ? view(provider, user, PRODUCT_ENTITY, `ID IN (${ids})`) : { rows: [] };
+        })(),
+        // Terms and charge types come from the lookup cache instead of two of the round trips this
+        // batch used to make — they are seeded reference data, and an invoice render read both.
+        LoadOrdersEngine(provider, user).then(() => ({ rows: [] })),
+        (async () => {
+            const ids = uuidList([order.BillToAddressID, order.ShipToAddressID], 'AddressID');
+            return ids ? view(provider, user, ADDRESS_ENTITY, `ID IN (${ids})`) : { rows: [] };
+        })(),
+    ]);
+    const readError = [chargeResult, adjustmentResult, paymentLineResult, productResult, termsResult, addressResult]
+        .map((r) => ('error' in r ? r.error : undefined))
+        .find(Boolean);
+    if (readError)
+        return { Success: false, Message: `Could not assemble the invoice — ${readError}`, Documents: [] };
+    const chargeIDs = uuidList(chargeResult.rows.map((c) => String(c.ID)), 'OrderChargeID');
+    const adjustmentIDs = uuidList(adjustmentResult.rows.map((a) => String(a.ID)), 'OrderAdjustmentID');
+    const paymentHeaderIDs = uuidList(paymentLineResult.rows.map((p) => p.PaymentHeaderID), 'PaymentHeaderID');
+    const companyIDs = uuidList([...lineRows.map((l) => l.CompanyID), order.CompanyID], 'CompanyID');
+    const [chargeAllocResult, adjustmentAllocResult, chargeTypeResult, paymentHeaderResult, companyResult, profileResult, companyAddressResult] = await Promise.all([
+        chargeIDs && lineIDs
+            ? view(provider, user, ORDER_CHARGE_ALLOCATION_ENTITY, `OrderChargeID IN (${chargeIDs})`)
+            : Promise.resolve({ rows: [] }),
+        adjustmentIDs
+            ? view(provider, user, ORDER_ADJUSTMENT_ALLOCATION_ENTITY, `OrderAdjustmentID IN (${adjustmentIDs})`)
+            : Promise.resolve({ rows: [] }),
+        Promise.resolve({ rows: [] }), // charge types come from the lookup cache
+        paymentHeaderIDs
+            ? view(provider, user, PAYMENT_HEADER_ENTITY, `ID IN (${paymentHeaderIDs})`)
+            : Promise.resolve({ rows: [] }),
+        companyIDs ? view(provider, user, COMPANY_ENTITY, `ID IN (${companyIDs})`) : Promise.resolve({ rows: [] }),
+        // IS-A: the profile shares the company's ID, so this is a lookup and not a join. A company
+        // with no accounting profile still issues an invoice — it just has no tax line to print.
+        companyIDs
+            ? view(provider, user, ACCOUNTING_COMPANY_PROFILE_ENTITY, `ID IN (${companyIDs})`)
+            : Promise.resolve({ rows: [] }),
+        (async () => {
+            const companyEntityID = provider.Entities?.find((e) => e.Name === COMPANY_ENTITY)?.ID;
+            if (!companyEntityID || !companyIDs)
+                return { rows: [] };
+            return view(provider, user, ADDRESS_LINK_ENTITY, `EntityID = '${RequireUUID(companyEntityID, 'Company entity ID')}' AND RecordID IN (${companyIDs})`, 'IsPrimary DESC, Rank');
+        })(),
+    ]);
+    const secondError = [chargeAllocResult, adjustmentAllocResult, chargeTypeResult, paymentHeaderResult, companyResult, profileResult, companyAddressResult]
+        .map((r) => ('error' in r ? r.error : undefined))
+        .find(Boolean);
+    if (secondError)
+        return { Success: false, Message: `Could not assemble the invoice — ${secondError}`, Documents: [] };
+    // The issuer addresses need a third trip because they are only knowable once the links are read.
+    // It is skipped entirely when no company has an address on file, which is the common case until
+    // somebody sets one up — an invoice with no remit-to address is worse-looking than one with, and
+    // is still a correct invoice.
+    const issuerAddressIDs = uuidList(companyAddressResult.rows.map((l) => l.AddressID), 'AddressID');
+    const issuerAddressResult = issuerAddressIDs
+        ? await view(provider, user, ADDRESS_ENTITY, `ID IN (${issuerAddressIDs})`)
+        : { rows: [] };
+    // ── Index everything once ────────────────────────────────────────────────────────────────────
+    const productByID = new Map(productResult.rows.map((p) => [String(p.ID), p]));
+    const engine = OrdersEngine.Instance;
+    const paymentHeaderByID = new Map(paymentHeaderResult.rows.map((p) => [String(p.ID), p]));
+    const addressByID = new Map(addressResult.rows.map((a) => [String(a.ID), a]));
+    const companyNames = new Map(companyResult.rows.map((c) => [String(c.ID), String(c.Name ?? '')]));
+    const issuerAddressByID = new Map(issuerAddressResult.rows.map((a) => [String(a.ID), a]));
+    // First link wins — the query is ordered primary-first, so a company with several addresses
+    // prints the one somebody marked as the main office rather than whichever came back first.
+    const issuerAddressByCompany = new Map();
+    for (const link of companyAddressResult.rows) {
+        const companyID = String(link.RecordID ?? '');
+        if (issuerAddressByCompany.has(companyID))
+            continue;
+        const address = issuerAddressByID.get(String(link.AddressID));
+        if (address)
+            issuerAddressByCompany.set(companyID, address);
+    }
+    const profileByID = new Map(profileResult.rows.map((p) => [String(p.ID), p]));
+    const issuers = new Map(companyResult.rows.map((c) => {
+        const companyID = String(c.ID);
+        const profile = profileByID.get(companyID);
+        return [
+            companyID,
+            {
+                CompanyID: companyID,
+                Name: String(c.Name ?? ''),
+                AddressLines: addressLines(issuerAddressByCompany.get(companyID)),
+                Email: null,
+                Phone: null,
+                Website: str(c.Website),
+                TaxID: str(profile?.FederalTaxID),
+                CurrencyCode: str(profile?.FunctionalCurrencyCode),
+            },
+        ];
+    }));
+    const allocationsByCharge = new Map();
+    for (const alloc of chargeAllocResult.rows) {
+        const key = String(alloc.OrderChargeID);
+        const bucket = allocationsByCharge.get(key) ?? [];
+        bucket.push({ OrderLineID: String(alloc.OrderLineID), Amount: num(alloc.Amount) });
+        allocationsByCharge.set(key, bucket);
+    }
+    const allocationsByAdjustment = new Map();
+    for (const alloc of adjustmentAllocResult.rows) {
+        const key = String(alloc.OrderAdjustmentID);
+        const bucket = allocationsByAdjustment.get(key) ?? [];
+        bucket.push({ OrderLineID: String(alloc.OrderLineID), Amount: num(alloc.Amount) });
+        allocationsByAdjustment.set(key, bucket);
+    }
+    // ── Shape the facts ──────────────────────────────────────────────────────────────────────────
+    const terms = engine.PaymentTermsTypeByID(order.PaymentTermsTypeID);
+    const orderFacts = {
+        ID: String(order.ID),
+        OrderNumber: String(order.OrderNumber ?? ''),
+        OrderType: str(order.OrderType),
+        OrderDate: ToISODate(order.OrderDate) ?? asOf,
+        Status: String(order.Status ?? ''),
+        CompanyID: String(order.CompanyID ?? ''),
+        CompanyName: str(order.Company) ?? '',
+        TotalGross: num(order.TotalGross),
+        AmountPaid: num(order.AmountPaid),
+        Balance: num(order.Balance),
+        DueDate: ToISODate(order.DueDate),
+        PaymentStatus: str(order.PaymentStatus),
+        ExternalDocumentNumber: str(order.ExternalDocumentNumber),
+        ReversesOrderHeaderID: str(order.ReversesOrderHeaderID),
+        ReversesOrderNumber: str(order.ReversesOrderHeader),
+        ReversalReason: str(order.ReversalReason),
+        Description: str(order.Description),
+        PaymentTermsName: str(order.PaymentTermsType),
+        PaymentTermsNetDays: terms?.NetDays != null ? Number(terms.NetDays) : null,
+    };
+    const lines = lineRows.map((l) => {
+        const product = l.ProductID ? productByID.get(String(l.ProductID)) : undefined;
+        return {
+            ID: String(l.ID),
+            LineNumber: Number(l.LineNumber ?? 0),
+            ProductID: str(l.ProductID),
+            // The line's own description wins over the product name: it is what somebody typed for
+            // THIS sale, and on a bill the customer's words beat the catalogue's.
+            ProductName: str(l.Product) ?? str(product?.Name) ?? 'Item',
+            ProductSKU: str(product?.SKU),
+            Description: str(l.Description),
+            CompanyID: String(l.CompanyID ?? orderFacts.CompanyID),
+            CompanyName: str(l.Company) ?? '',
+            Quantity: num(l.Quantity),
+            UnitPrice: num(l.UnitPrice),
+            DiscountAmount: num(l.DiscountAmount),
+            LineTotalNet: num(l.LineTotalNet),
+            ChargeAmount: num(l.ChargeAmount),
+            LineTax: num(l.LineTax),
+            LineTotalGross: num(l.LineTotalGross),
+            ServicePeriodStart: ToISODate(l.ServicePeriodStart),
+            ServicePeriodEnd: ToISODate(l.ServicePeriodEnd),
+            ParentOrderLineID: str(l.ParentOrderLineID),
+            IsRollupParent: l.IsRollupParent === true || l.IsRollupParent === 1,
+            ReversesOrderLineID: str(l.ReversesOrderLineID),
+        };
+    });
+    const charges = chargeResult.rows.map((c) => {
+        const type = engine.ChargeTypeByID(c.ChargeTypeID);
+        return {
+            ID: String(c.ID),
+            Name: str(c.ChargeType) ?? str(type?.Name) ?? 'Charge',
+            Category: str(type?.Category) ?? 'Surcharge',
+            Amount: num(c.Amount),
+            Rate: c.Rate == null ? null : Number(c.Rate),
+            Sequence: Number(c.Sequence ?? 0),
+            Allocations: allocationsByCharge.get(String(c.ID)) ?? [],
+        };
+    });
+    const adjustments = adjustmentResult.rows.map((a) => ({
+        ID: String(a.ID),
+        OrderLineID: str(a.OrderLineID),
+        PromotionName: str(a.Promotion),
+        PromotionCode: str(a.PromotionCode),
+        Reason: str(a.Reason),
+        Amount: num(a.Amount),
+        Allocations: allocationsByAdjustment.get(String(a.ID)) ?? [],
+    }));
+    // Payment lines are grouped into one entry per payment: a cheque split across six order lines is
+    // ONE payment on the document, not six.
+    const paymentsByHeader = new Map();
+    for (const pl of paymentLineResult.rows) {
+        const headerID = String(pl.PaymentHeaderID);
+        const paymentHeader = paymentHeaderByID.get(headerID);
+        const existing = paymentsByHeader.get(headerID) ?? {
+            PaymentHeaderID: headerID,
+            PaymentNumber: str(paymentHeader?.PaymentNumber) ?? str(pl.PaymentHeader) ?? '—',
+            PaymentDate: ToISODate(paymentHeader?.PaymentDate) ?? asOf,
+            PaymentTypeName: str(paymentHeader?.PaymentType),
+            Amount: 0,
+            Allocations: [],
+        };
+        existing.Amount = Math.round((existing.Amount + num(pl.Amount) + Number.EPSILON) * 100) / 100;
+        existing.Allocations.push({ OrderLineID: str(pl.OrderLineID), Amount: num(pl.Amount) });
+        paymentsByHeader.set(headerID, existing);
+    }
+    // A reversed payment is not money the customer still has credit for. It is excluded here rather
+    // than netted, so a refunded order shows the original balance again instead of a phantom credit.
+    const payments = [...paymentsByHeader.values()].filter((p) => {
+        const status = str(paymentHeaderByID.get(p.PaymentHeaderID)?.Status);
+        return status !== 'Reversed' && status !== 'Failed' && status !== 'Voided';
+    });
+    const billToAddress = order.BillToAddressID ? addressByID.get(String(order.BillToAddressID)) : undefined;
+    const shipToAddress = order.ShipToAddressID ? addressByID.get(String(order.ShipToAddressID)) : undefined;
+    const billTo = {
+        Name: str(order.BillToOrganization) ?? str(order.BillToPerson),
+        AttentionOf: str(order.BillToOrganization) ? str(order.BillToPerson) : null,
+        AddressLines: addressLines(billToAddress),
+        Email: null,
+    };
+    const shipTo = order.ShipToAddressID && String(order.ShipToAddressID) !== String(order.BillToAddressID ?? '')
+        ? {
+            Name: str(order.ShipToOrganization) ?? str(order.ShipToPerson) ?? billTo.Name,
+            AttentionOf: null,
+            AddressLines: addressLines(shipToAddress),
+            Email: null,
+        }
+        : null;
+    const documents = BuildDocuments({
+        Order: orderFacts,
+        Lines: lines,
+        Charges: charges,
+        Adjustments: adjustments,
+        Payments: payments,
+        BillTo: billTo,
+        ShipTo: shipTo,
+        CompanyNames: companyNames,
+        Issuers: issuers,
+        AsOf: asOf,
+        OnlyCompanyID: options?.OnlyCompanyID ?? null,
+    });
+    if (options?.OnlyCompanyID && !documents.length) {
+        return {
+            Success: false,
+            Message: `Order ${orderFacts.OrderNumber} has no lines sold by company ${options.OnlyCompanyID}.`,
+            Documents: [],
+        };
+    }
+    return { Success: true, Documents: documents };
+}
+//# sourceMappingURL=InvoiceBuilder.js.map

package/dist/InvoiceBuilder.js.map

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

package/dist/InvoiceDisplay.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Turning the numbers on an invoice into the strings that print on it.
+ *
+ * WHY THIS IS NOT IN THE TEMPLATE. The template language has no money formatting — Nunjucks gives
+ * you `round(2)`, which renders eleven hundred dollars as `1100` and, worse, renders a hundred and
+ * ten dollars exactly as `110` where the missing `.00` reads as a rounding error to anyone checking
+ * the column. Grouping separators, the currency symbol's position and the negative convention are
+ * locale decisions, not styling decisions, so they are made here where they can be tested and the
+ * template just prints `{{ row.AmountText }}`.
+ *
+ * WHY IT IS NOT IN THE BUILDER EITHER. Everything here is a pure function of a document plus a
+ * locale. Keeping it separate is what lets the same document render as US dollars for the customer
+ * and as raw numbers for a reconciliation check, without a second trip to the database.
+ *
+ * NEGATIVES ARE PARENTHESISED, NOT PREFIXED. `-1,200.00` and `1,200.00` differ by one character at
+ * the far left of a right-aligned column, which is exactly where the eye is not. `(1,200.00)` is the
+ * convention every accounts-payable clerk already reads, and it is unmistakable at a glance.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+import type { InvoiceDocument, InvoiceRow, LadderRow } from './InvoiceBehavior.js';
+/** How to render the numbers. The app is single-currency today; this is the seam for when it is not. */
+export interface DisplayOptions {
+    /** BCP 47 tag. Drives grouping separators and date order. */
+    Locale?: string;
+    /** ISO 4217 code. */
+    Currency?: string;
+}
+/** A row as it prints: every number carries the string beside it. */
+export interface DisplayRow extends InvoiceRow {
+    QuantityText: string;
+    UnitPriceText: string;
+    DiscountText: string;
+    AmountText: string;
+    ServicePeriodText: string | null;
+    Children: DisplayRow[];
+}
+/** A ladder row as it prints. */
+export interface DisplayLadderRow extends LadderRow {
+    AmountText: string;
+}
+/** The whole document, ready for a template that does no arithmetic of its own. */
+export interface DisplayInvoice extends Omit<InvoiceDocument, 'Rows' | 'Ladder' | 'Payments'> {
+    Rows: DisplayRow[];
+    Ladder: DisplayLadderRow[];
+    Payments: Array<InvoiceDocument['Payments'][number] & {
+        AmountText: string;
+        PaymentDateText: string;
+    }>;
+    OrderDateText: string;
+    DueDateText: string | null;
+    /** `Due in 22 days`, `Due today`, `21 days overdue` — or null when nothing is owed. */
+    DuePhrase: string | null;
+    ListSubtotalText: string;
+    DiscountTotalText: string;
+    NetTotalText: string;
+    ChargeTotalText: string;
+    TaxTotalText: string;
+    GrossText: string;
+    AmountPaidText: string;
+    AmountDueText: string;
+    /** `Amount due` / `Credit due you` — the label the ladder ends on, repeated for the big figure. */
+    DueLabel: string;
+    /** True when the document is settled, so the renderer can stamp it. */
+    IsSettled: boolean;
+    /** True when there is a real overdue balance — never true for a quote or a credit. */
+    IsOverdue: boolean;
+    CurrencyCode: string;
+    /** The date the document was produced, for the footer. */
+    GeneratedOnText: string;
+}
+/**
+ * Format an amount, parenthesising negatives.
+ *
+ * THE NUMBER OF DECIMALS IS THE CURRENCY'S, not a constant. Dollars and euros carry two; yen and
+ * won carry none, and a bill for `¥12,000.00` tells a Japanese customer they are being charged in
+ * some unit that is not yen. Forcing two digits is the kind of hardcoding that is invisible until
+ * the first order in a currency nobody tested with.
+ */
+export declare function FormatMoney(amount: number, options?: DisplayOptions): string;
+/**
+ * Format a quantity, dropping a trailing `.00` but keeping real fractions.
+ *
+ * `3` for three of something and `2.5` for two and a half hours — printing `3.00` on a line of
+ * widgets invites the reader to look for a decimal that is not there.
+ */
+export declare function FormatQuantity(quantity: number, options?: DisplayOptions): string;
+/** Format an ISO date without letting the local timezone move it a day. */
+export declare function FormatDate(isoDate: string | null, options?: DisplayOptions): string | null;
+/** `Due in 22 days` / `Due today` / `21 days overdue`. Null when nothing is owed. */
+export declare function DuePhrase(daysUntilDue: number | null): string | null;
+/** Decorate a document for printing. Pure: same document and locale in, same strings out. */
+export declare function DecorateInvoice(doc: InvoiceDocument, options?: DisplayOptions & {
+    GeneratedOn?: string;
+}): DisplayInvoice;
+//# sourceMappingURL=InvoiceDisplay.d.ts.map

package/dist/InvoiceDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceDisplay.d.ts","sourceRoot":"","sources":["../src/InvoiceDisplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEnF,wGAAwG;AACxG,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qEAAqE;AACrE,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IAC/C,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzF,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEvG,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uFAAuF;IACvF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAKjF;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAQ1F;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAMpE;AAoBD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAoCzH"}

package/dist/InvoiceDisplay.js

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview Turning the numbers on an invoice into the strings that print on it.
+ *
+ * WHY THIS IS NOT IN THE TEMPLATE. The template language has no money formatting — Nunjucks gives
+ * you `round(2)`, which renders eleven hundred dollars as `1100` and, worse, renders a hundred and
+ * ten dollars exactly as `110` where the missing `.00` reads as a rounding error to anyone checking
+ * the column. Grouping separators, the currency symbol's position and the negative convention are
+ * locale decisions, not styling decisions, so they are made here where they can be tested and the
+ * template just prints `{{ row.AmountText }}`.
+ *
+ * WHY IT IS NOT IN THE BUILDER EITHER. Everything here is a pure function of a document plus a
+ * locale. Keeping it separate is what lets the same document render as US dollars for the customer
+ * and as raw numbers for a reconciliation check, without a second trip to the database.
+ *
+ * NEGATIVES ARE PARENTHESISED, NOT PREFIXED. `-1,200.00` and `1,200.00` differ by one character at
+ * the far left of a right-aligned column, which is exactly where the eye is not. `(1,200.00)` is the
+ * convention every accounts-payable clerk already reads, and it is unmistakable at a glance.
+ *
+ * @module @mj-biz-apps/orders-core-entities-server
+ */
+const DEFAULTS = { Locale: 'en-US', Currency: 'USD' };
+/**
+ * Format an amount, parenthesising negatives.
+ *
+ * THE NUMBER OF DECIMALS IS THE CURRENCY'S, not a constant. Dollars and euros carry two; yen and
+ * won carry none, and a bill for `¥12,000.00` tells a Japanese customer they are being charged in
+ * some unit that is not yen. Forcing two digits is the kind of hardcoding that is invisible until
+ * the first order in a currency nobody tested with.
+ */
+export function FormatMoney(amount, options) {
+    const { Locale, Currency } = { ...DEFAULTS, ...options };
+    const value = Math.abs(Number(amount) || 0);
+    const text = new Intl.NumberFormat(Locale, { style: 'currency', currency: Currency }).format(value);
+    return Number(amount) < 0 ? `(${text})` : text;
+}
+/**
+ * Format a quantity, dropping a trailing `.00` but keeping real fractions.
+ *
+ * `3` for three of something and `2.5` for two and a half hours — printing `3.00` on a line of
+ * widgets invites the reader to look for a decimal that is not there.
+ */
+export function FormatQuantity(quantity, options) {
+    const { Locale } = { ...DEFAULTS, ...options };
+    const value = Number(quantity) || 0;
+    const decimals = Number.isInteger(value) ? 0 : Math.min(4, (String(value).split('.')[1] ?? '').length);
+    return new Intl.NumberFormat(Locale, { minimumFractionDigits: decimals, maximumFractionDigits: decimals }).format(value);
+}
+/** Format an ISO date without letting the local timezone move it a day. */
+export function FormatDate(isoDate, options) {
+    if (!isoDate)
+        return null;
+    const [y, m, d] = String(isoDate).slice(0, 10).split('-').map(Number);
+    if (!y || !m || !d)
+        return null;
+    const { Locale } = { ...DEFAULTS, ...options };
+    return new Intl.DateTimeFormat(Locale, { year: 'numeric', month: 'short', day: 'numeric', timeZone: 'UTC' }).format(new Date(Date.UTC(y, m - 1, d)));
+}
+/** `Due in 22 days` / `Due today` / `21 days overdue`. Null when nothing is owed. */
+export function DuePhrase(daysUntilDue) {
+    if (daysUntilDue == null)
+        return null;
+    if (daysUntilDue === 0)
+        return 'Due today';
+    if (daysUntilDue > 0)
+        return `Due in ${daysUntilDue} day${daysUntilDue === 1 ? '' : 's'}`;
+    const overdue = Math.abs(daysUntilDue);
+    return `${overdue} day${overdue === 1 ? '' : 's'} overdue`;
+}
+function decorateRow(row, options) {
+    const period = row.ServicePeriodStart || row.ServicePeriodEnd
+        ? `${FormatDate(row.ServicePeriodStart, options) ?? '—'} – ${FormatDate(row.ServicePeriodEnd, options) ?? '—'}`
+        : null;
+    return {
+        ...row,
+        QuantityText: FormatQuantity(row.Quantity, options),
+        UnitPriceText: FormatMoney(row.UnitPrice, options),
+        // A line with no discount prints an em dash, not a zero: a column of `$0.00` down the page
+        // reads as money and pulls the eye away from the ones that are real.
+        DiscountText: row.DiscountAmount === 0 ? '—' : `−${FormatMoney(Math.abs(row.DiscountAmount), options)}`,
+        AmountText: row.IncludedInParent ? 'included' : FormatMoney(row.Amount, options),
+        ServicePeriodText: period,
+        Children: row.Children.map((c) => decorateRow(c, options)),
+    };
+}
+/** Decorate a document for printing. Pure: same document and locale in, same strings out. */
+export function DecorateInvoice(doc, options) {
+    const opts = { ...DEFAULTS, ...options };
+    const generatedOn = options?.GeneratedOn ?? new Date().toISOString().slice(0, 10);
+    const dueLabel = doc.Kind === 'Credit Memo' ? 'Credit due you' : doc.Kind === 'Quote' ? 'Quote total' : 'Amount due';
+    return {
+        ...doc,
+        Rows: doc.Rows.map((r) => decorateRow(r, opts)),
+        Ladder: doc.Ladder.map((r) => ({ ...r, AmountText: FormatMoney(r.Amount, opts) })),
+        Payments: doc.Payments.map((p) => ({
+            ...p,
+            AmountText: FormatMoney(p.Amount, opts),
+            PaymentDateText: FormatDate(p.PaymentDate, opts) ?? p.PaymentDate,
+        })),
+        OrderDateText: FormatDate(doc.OrderDate, opts) ?? doc.OrderDate,
+        DueDateText: FormatDate(doc.DueDate, opts),
+        DuePhrase: DuePhrase(doc.DaysUntilDue),
+        ListSubtotalText: FormatMoney(doc.ListSubtotal, opts),
+        DiscountTotalText: FormatMoney(doc.DiscountTotal, opts),
+        NetTotalText: FormatMoney(doc.NetTotal, opts),
+        ChargeTotalText: FormatMoney(doc.ChargeTotal, opts),
+        TaxTotalText: FormatMoney(doc.TaxTotal, opts),
+        GrossText: FormatMoney(doc.Gross, opts),
+        AmountPaidText: FormatMoney(doc.AmountPaid, opts),
+        // The headline figure is a magnitude — a credit memo says "Credit due you $310.72", not
+        // "$-310.72", because the label already carries the direction.
+        AmountDueText: FormatMoney(Math.abs(doc.AmountDue), opts),
+        DueLabel: dueLabel,
+        // A quote is never settled and never overdue, however its arithmetic comes out: nobody has
+        // been asked for the money yet.
+        IsSettled: doc.Kind === 'Invoice' && doc.Gross > 0 && doc.AmountDue <= 0,
+        IsOverdue: doc.Kind === 'Invoice' && doc.AmountDue > 0 && doc.DaysUntilDue != null && doc.DaysUntilDue < 0,
+        CurrencyCode: opts.Currency,
+        GeneratedOnText: FormatDate(generatedOn, opts) ?? generatedOn,
+    };
+}
+//# sourceMappingURL=InvoiceDisplay.js.map

package/dist/InvoiceDisplay.js.map

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

package/dist/ListEntitlementsOperation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Orders.ListEntitlements — this person's entitlement library, without N point checks.
+ *
+ * An optimisation for UI and sync, not a second source of truth. Each row is evaluated
+ * the same way `Orders.CheckEntitlement` evaluates one Code. Heavier scope than the
+ * point check (`orders:entitlement-read`) so a library key cannot become an authorization
+ * oracle for arbitrary people × codes.
+ *
+ * CONNECTS TO:
+ *   LOAD: ./EntitlementRead.ts
+ *   DOC:  plans/entitlement-read-contract.md
+ */
+import { BaseRemotableOperation, type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { type ListEntitlementsInput, type ListEntitlementsOutput } from './EntitlementRead.js';
+export declare class ListEntitlementsOperation extends BaseRemotableOperation<ListEntitlementsInput, ListEntitlementsOutput> {
+    OperationKey: string;
+    protected InternalExecute(input: ListEntitlementsInput, provider: IMetadataProvider, user: UserInfo): Promise<ListEntitlementsOutput>;
+}
+/** Tree-shaking anchor — called from the server bootstrap so the registration is retained. */
+export declare function LoadListEntitlementsOperation(): void;
+//# sourceMappingURL=ListEntitlementsOperation.d.ts.map