@mj-biz-apps/sales-core-entities-server 6.8.2 → 6.9.1

package/dist/finance-exceptions/FinanceExceptionBridge.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The one place sales reaches into accounting's finance exception operations (golive #279).
+ *
+ * Accounting owns the exception tables and the operations that read and write them. Sales resolves
+ * those operations BY NAME through the class factory, with no build-time dependency on the accounting
+ * server package, the same way bizapps-orders reaches `Accounting.CreateJournalEntries`. The input and
+ * output shapes below are the agreed contract, declared here structurally; they are not imported.
+ *
+ * An unregistered operation throws: a detector that quietly did nothing because accounting was not
+ * loaded would look exactly like a night with no exceptions.
+ */
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+export declare const OP_GET_FINANCE_EXCEPTION_TYPES = "Accounting.GetFinanceExceptionTypes";
+export declare const OP_RAISE_FINANCE_EXCEPTIONS = "Accounting.RaiseFinanceExceptions";
+export interface FinanceExceptionError {
+    Index?: number;
+    Code: string;
+    Message: string;
+}
+export interface GetFinanceExceptionTypesInput {
+    Codes?: string[];
+}
+export interface FinanceExceptionTypeInfo {
+    Code: string;
+    IsActive: boolean;
+    Configuration: Record<string, unknown>;
+}
+export interface GetFinanceExceptionTypesOutput {
+    Success: boolean;
+    Types: FinanceExceptionTypeInfo[];
+    Errors?: FinanceExceptionError[];
+}
+export interface FinanceExceptionToRaise {
+    TypeCode: string;
+    /** MJ entity name; accounting resolves it to SourceEntityID. */
+    SourceEntityName: string;
+    SourceRecordID: string;
+    CompanyID: string;
+    Amount?: number | null;
+    /** YYYY-MM-DD. */
+    ExceptionDate: string;
+    Summary: string;
+    DedupeKey: string;
+    SourceCreatedByUserID?: string | null;
+    /** True when a creator exists but no single login is linked to it. */
+    CreatorUnresolved?: boolean;
+}
+export interface RaiseFinanceExceptionsInput {
+    Exceptions: FinanceExceptionToRaise[];
+}
+export interface RaiseFinanceExceptionResult {
+    Index: number;
+    FinanceExceptionID?: string;
+    Created: boolean;
+    Skipped?: boolean;
+}
+export interface RaiseFinanceExceptionsOutput {
+    Success: boolean;
+    Results: RaiseFinanceExceptionResult[];
+    Errors?: FinanceExceptionError[];
+}
+export declare function GetFinanceExceptionTypes(input: GetFinanceExceptionTypesInput, provider: IMetadataProvider, user: UserInfo): Promise<GetFinanceExceptionTypesOutput>;
+export declare function RaiseFinanceExceptions(input: RaiseFinanceExceptionsInput, provider: IMetadataProvider, user: UserInfo): Promise<RaiseFinanceExceptionsOutput>;
+/** One line per payload error, for a job log. */
+export declare function DescribeFinanceExceptionErrors(errors: FinanceExceptionError[] | undefined): string;
+//# sourceMappingURL=FinanceExceptionBridge.d.ts.map

package/dist/finance-exceptions/FinanceExceptionBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinanceExceptionBridge.d.ts","sourceRoot":"","sources":["../../src/finance-exceptions/FinanceExceptionBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA0B,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrG,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AACpF,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IACxC,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC;AA+CD,wBAAgB,wBAAwB,CACpC,KAAK,EAAE,6BAA6B,EACpC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,8BAA8B,CAAC,CAOzC;AAED,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,2BAA2B,EAClC,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,4BAA4B,CAAC,CAOvC;AAED,iDAAiD;AACjD,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,SAAS,GAAG,MAAM,CAIlG"}

package/dist/finance-exceptions/FinanceExceptionBridge.js

@@ -0,0 +1,61 @@
+/**
+ * The one place sales reaches into accounting's finance exception operations (golive #279).
+ *
+ * Accounting owns the exception tables and the operations that read and write them. Sales resolves
+ * those operations BY NAME through the class factory, with no build-time dependency on the accounting
+ * server package, the same way bizapps-orders reaches `Accounting.CreateJournalEntries`. The input and
+ * output shapes below are the agreed contract, declared here structurally; they are not imported.
+ *
+ * An unregistered operation throws: a detector that quietly did nothing because accounting was not
+ * loaded would look exactly like a night with no exceptions.
+ */
+import { BaseRemotableOperation } from '@memberjunction/core';
+import { MJGlobal } from '@memberjunction/global';
+export const OP_GET_FINANCE_EXCEPTION_TYPES = 'Accounting.GetFinanceExceptionTypes';
+export const OP_RAISE_FINANCE_EXCEPTIONS = 'Accounting.RaiseFinanceExceptions';
+/**
+ * Resolve an accounting operation by key, throwing when accounting's server package is not loaded.
+ *
+ * `TryCreateInstance`, not `CreateInstance`: `BaseRemotableOperation` is not marked as requiring a
+ * subclass, so `CreateInstance` for an unregistered key returns a hollow base instance rather than
+ * null, and a null check never fires.
+ */
+function resolveOperation(key) {
+    const res = MJGlobal.Instance.ClassFactory.TryCreateInstance(BaseRemotableOperation, key);
+    if (!res.Resolved || !res.Instance) {
+        throw new Error(`The '${key}' operation is not registered. The BizApps Accounting server package must be `
+            + 'loaded before sales can read or raise finance exceptions.');
+    }
+    return res.Instance;
+}
+/**
+ * Run an accounting operation and return its payload.
+ *
+ * The envelope reports transport and authorization failure and is thrown. The payload's own
+ * `Success` is the accounting-domain outcome and is returned for the caller to judge, because a
+ * nightly detector reports a refused raise rather than dying on it.
+ */
+async function executeOperation(key, input, provider, user) {
+    const op = resolveOperation(key);
+    const result = await op.Execute(input, { provider, user });
+    if (!result.Success) {
+        throw new Error(`${key} did not execute: ${result.ErrorMessage ?? result.ResultCode ?? 'unknown error'}`);
+    }
+    if (!result.Output) {
+        throw new Error(`${key} returned no payload.`);
+    }
+    return result.Output;
+}
+export function GetFinanceExceptionTypes(input, provider, user) {
+    return executeOperation(OP_GET_FINANCE_EXCEPTION_TYPES, input, provider, user);
+}
+export function RaiseFinanceExceptions(input, provider, user) {
+    return executeOperation(OP_RAISE_FINANCE_EXCEPTIONS, input, provider, user);
+}
+/** One line per payload error, for a job log. */
+export function DescribeFinanceExceptionErrors(errors) {
+    return (errors ?? [])
+        .map((e) => `${e.Index === undefined ? '' : `[${e.Index}] `}${e.Code}: ${e.Message}`)
+        .join('; ');
+}
+//# sourceMappingURL=FinanceExceptionBridge.js.map

package/dist/finance-exceptions/FinanceExceptionBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinanceExceptionBridge.js","sourceRoot":"","sources":["../../src/finance-exceptions/FinanceExceptionBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,sBAAsB,EAAyC,MAAM,sBAAsB,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AACpF,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAAC;AAyD/E;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAO,GAAW;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,iBAAiB,CACxD,sBAAsB,EACtB,GAAG,CACN,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACX,QAAQ,GAAG,+EAA+E;cACpF,2DAA2D,CACpE,CAAC;IACN,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,gBAAgB,CAC3B,GAAW,EACX,KAAQ,EACR,QAA2B,EAC3B,IAAc;IAEd,MAAM,EAAE,GAAG,gBAAgB,CAAO,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,qBAAqB,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,IAAI,eAAe,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,uBAAuB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACpC,KAAoC,EACpC,QAA2B,EAC3B,IAAc;IAEd,OAAO,gBAAgB,CACnB,8BAA8B,EAC9B,KAAK,EACL,QAAQ,EACR,IAAI,CACP,CAAC;AACN,CAAC;AAED,MAAM,UAAU,sBAAsB,CAClC,KAAkC,EAClC,QAA2B,EAC3B,IAAc;IAEd,OAAO,gBAAgB,CACnB,2BAA2B,EAC3B,KAAK,EACL,QAAQ,EACR,IAAI,CACP,CAAC;AACN,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,8BAA8B,CAAC,MAA2C;IACtF,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACpF,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC"}

package/dist/finance-exceptions/WonDealOrderDetector.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Nightly detector for finance exception type 3, WON_DEAL_ORDER_NOT_CONFIRMED (golive #279).
+ *
+ * A deal closed Won whose order is missing or never confirmed is never billed. The saved query
+ * `Sales: Won Deals With Unconfirmed Orders` finds them; this raises one finance exception per deal
+ * through accounting, keyed on the deal so a deal found again tomorrow is not raised twice.
+ *
+ * The threshold (`MinDaysSinceClose`) is read from the exception type's Configuration in accounting.
+ * A missing or inactive type means the check is switched off, and the run skips. It never falls back
+ * to a default of its own.
+ */
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+import { type FinanceExceptionTypeInfo } from './FinanceExceptionBridge.js';
+export declare const WON_DEAL_ORDER_NOT_CONFIRMED = "WON_DEAL_ORDER_NOT_CONFIRMED";
+export declare const WON_DEALS_QUERY_NAME = "Sales: Won Deals With Unconfirmed Orders";
+export declare const WON_DEALS_QUERY_CATEGORY = "Sales";
+export declare const DEAL_ENTITY_NAME = "MJ_BizApps_Sales: Deals";
+export type WonDealDetectionOutcome = 'RAISED' | 'NONE_FOUND' | 'SKIPPED' | 'TYPES_UNREADABLE' | 'CONFIG_INVALID' | 'QUERY_FAILED' | 'USER_LOOKUP_FAILED' | 'RAISE_FAILED';
+export interface WonDealDetectionResult {
+    Success: boolean;
+    Outcome: WonDealDetectionOutcome;
+    /** Deals the query returned. */
+    Found: number;
+    /** Exceptions accounting created on this run. */
+    Created: number;
+    /** Deals that already had an exception of this type, in any status. */
+    AlreadyRaised: number;
+    /** Exceptions accounting skipped, which it does when the type is inactive. */
+    SkippedByAccounting: number;
+    /** Deals whose owner has no single linked login. */
+    CreatorUnresolved: number;
+    Issues: string[];
+}
+/** One query row, read defensively: a provider can hand back a number as a string. */
+interface WonDealRow {
+    DealID: string;
+    DealNumber: string | null;
+    CompanyID: string;
+    OwnerEmployeeID: string | null;
+    OwnerName: string | null;
+    CloseDate: string | null;
+    DaysSinceClose: number | null;
+    DealAmount: number | null;
+    OrderID: string | null;
+    OrderStatus: string | null;
+}
+/** The owner's login, or why there is not exactly one. */
+interface CreatorResolution {
+    UserID: string | null;
+    Unresolved: boolean;
+    LinkedLogins: number;
+}
+/** The threshold from the type's Configuration, or null when it is absent or not a whole non-negative number. */
+export declare function ReadMinDaysSinceClose(type: FinanceExceptionTypeInfo): number | null;
+export declare function ReadWonDealRow(raw: Record<string, unknown>): WonDealRow | null;
+/**
+ * Plain description of the defect in the data: the deal number, never the deal or account name.
+ * When the owner's login cannot be resolved the owner is named, because accounting shows this
+ * summary when it refuses to clear the row, and whoever sees it needs to know whose login to link.
+ */
+export declare function BuildWonDealSummary(row: WonDealRow, creator: CreatorResolution): string;
+/**
+ * Every login linked to each owner, in one batched lookup (chunked only to bound the IN list).
+ * Returns a map from employee key to the linked user IDs, or an error message.
+ */
+export declare function LoadLoginsByEmployee(employeeIDs: string[], user: UserInfo): Promise<Map<string, string[]> | string>;
+export declare function ResolveCreator(ownerEmployeeID: string | null, logins: Map<string, string[]>): CreatorResolution;
+/**
+ * Detect won deals with unconfirmed orders and raise one finance exception per deal.
+ * Throws only when accounting's operations are not registered or do not execute.
+ */
+export declare function DetectWonDealsWithUnconfirmedOrders(provider: IMetadataProvider, user: UserInfo): Promise<WonDealDetectionResult>;
+export {};
+//# sourceMappingURL=WonDealOrderDetector.d.ts.map

package/dist/finance-exceptions/WonDealOrderDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WonDealOrderDetector.d.ts","sourceRoot":"","sources":["../../src/finance-exceptions/WonDealOrderDetector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAgC,KAAK,iBAAiB,EAAsB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE/H,OAAO,EAKH,KAAK,wBAAwB,EAEhC,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAC3E,eAAO,MAAM,oBAAoB,6CAA6C,CAAC;AAC/E,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAM1D,MAAM,MAAM,uBAAuB,GAC7B,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,cAAc,CAAC;AAErB,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,uBAAuB,CAAC;IACjC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,sFAAsF;AACtF,UAAU,UAAU;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,0DAA0D;AAC1D,UAAU,iBAAiB;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB;AA4CD,iHAAiH;AACjH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI,CAInF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAkB9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAmBvF;AAkED;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,CAiCzC;AAED,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAS/G;AAiDD;;;GAGG;AACH,wBAAsB,mCAAmC,CACrD,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,QAAQ,GACf,OAAO,CAAC,sBAAsB,CAAC,CA+BjC"}

package/dist/finance-exceptions/WonDealOrderDetector.js

@@ -0,0 +1,277 @@
+/**
+ * Nightly detector for finance exception type 3, WON_DEAL_ORDER_NOT_CONFIRMED (golive #279).
+ *
+ * A deal closed Won whose order is missing or never confirmed is never billed. The saved query
+ * `Sales: Won Deals With Unconfirmed Orders` finds them; this raises one finance exception per deal
+ * through accounting, keyed on the deal so a deal found again tomorrow is not raised twice.
+ *
+ * The threshold (`MinDaysSinceClose`) is read from the exception type's Configuration in accounting.
+ * A missing or inactive type means the check is switched off, and the run skips. It never falls back
+ * to a default of its own.
+ */
+import { LogStatus, RunQuery, RunView } from '@memberjunction/core';
+import { BusinessTimeZoneEngine } from '@mj-biz-apps/common-entities';
+import { DescribeFinanceExceptionErrors, GetFinanceExceptionTypes, RaiseFinanceExceptions, } from './FinanceExceptionBridge.js';
+export const WON_DEAL_ORDER_NOT_CONFIRMED = 'WON_DEAL_ORDER_NOT_CONFIRMED';
+export const WON_DEALS_QUERY_NAME = 'Sales: Won Deals With Unconfirmed Orders';
+export const WON_DEALS_QUERY_CATEGORY = 'Sales';
+export const DEAL_ENTITY_NAME = 'MJ_BizApps_Sales: Deals';
+const USER_ENTITY_NAME = 'MJ: Users';
+/** Keeps each user lookup's IN list well inside SQL Server's parameter and statement limits. */
+const USER_LOOKUP_CHUNK = 500;
+const SUMMARY_MAX = 1000;
+function emptyResult(outcome, success, issue) {
+    return {
+        Success: success,
+        Outcome: outcome,
+        Found: 0,
+        Created: 0,
+        AlreadyRaised: 0,
+        SkippedByAccounting: 0,
+        CreatorUnresolved: 0,
+        Issues: issue ? [issue] : [],
+    };
+}
+function text(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    const s = String(value).trim();
+    return s === '' ? null : s;
+}
+function numberOrNull(value) {
+    if (value === null || value === undefined || value === '') {
+        return null;
+    }
+    const n = Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+function dayText(value) {
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? null : value.toISOString().slice(0, 10);
+    }
+    const s = text(value);
+    return s ? s.slice(0, 10) : null;
+}
+/** GUIDs compare case-insensitively; SQL Server returns upper case, JavaScript callers often lower. */
+function idKey(id) {
+    return id.trim().toLowerCase();
+}
+/** The threshold from the type's Configuration, or null when it is absent or not a whole non-negative number. */
+export function ReadMinDaysSinceClose(type) {
+    const raw = type.Configuration?.MinDaysSinceClose;
+    const n = typeof raw === 'number' ? raw : typeof raw === 'string' && raw.trim() !== '' ? Number(raw) : NaN;
+    return Number.isInteger(n) && n >= 0 ? n : null;
+}
+export function ReadWonDealRow(raw) {
+    const dealID = text(raw.DealID);
+    const companyID = text(raw.CompanyID);
+    if (!dealID || !companyID) {
+        return null;
+    }
+    return {
+        DealID: dealID,
+        DealNumber: text(raw.DealNumber),
+        CompanyID: companyID,
+        OwnerEmployeeID: text(raw.OwnerEmployeeID),
+        OwnerName: text(raw.OwnerName),
+        CloseDate: dayText(raw.CloseDate),
+        DaysSinceClose: numberOrNull(raw.DaysSinceClose),
+        DealAmount: numberOrNull(raw.DealAmount),
+        OrderID: text(raw.OrderID),
+        OrderStatus: text(raw.OrderStatus),
+    };
+}
+/**
+ * Plain description of the defect in the data: the deal number, never the deal or account name.
+ * When the owner's login cannot be resolved the owner is named, because accounting shows this
+ * summary when it refuses to clear the row, and whoever sees it needs to know whose login to link.
+ */
+export function BuildWonDealSummary(row, creator) {
+    const deal = row.DealNumber ? `Deal ${row.DealNumber}` : `Deal ${row.DealID}`;
+    const closed = row.CloseDate
+        ? ` closed Won on ${row.CloseDate}${row.DaysSinceClose === null ? '' : ` (${row.DaysSinceClose} days ago)`}`
+        : ' closed Won';
+    const order = !row.OrderID
+        ? 'has no order'
+        : row.OrderStatus
+            ? `has an order that is ${row.OrderStatus}, not Confirmed`
+            : 'has an order that could not be read';
+    let summary = `${deal}${closed} and ${order}, so it will not be billed.`;
+    const owner = row.OwnerName ? `The deal owner, ${row.OwnerName},` : 'The deal owner';
+    if (creator.LinkedLogins > 1) {
+        summary += ` ${owner} is linked to ${creator.LinkedLogins} logins, so the creator could not be resolved to one; `
+            + 'leave exactly one login linked to their employee record.';
+    }
+    else if (creator.Unresolved) {
+        summary += ` ${owner} has no linked login; link their employee record to their login.`;
+    }
+    return summary.length > SUMMARY_MAX ? `${summary.slice(0, SUMMARY_MAX - 1)}…` : summary;
+}
+/** Read the type; a null result with an outcome means the run stops there. */
+async function readType(provider, user) {
+    const types = await GetFinanceExceptionTypes({ Codes: [WON_DEAL_ORDER_NOT_CONFIRMED] }, provider, user);
+    if (!types.Success) {
+        return emptyResult('TYPES_UNREADABLE', false, `Accounting could not read the finance exception types. ${DescribeFinanceExceptionErrors(types.Errors)}`);
+    }
+    const type = (types.Types ?? []).find((t) => t.Code === WON_DEAL_ORDER_NOT_CONFIRMED);
+    if (!type || !type.IsActive) {
+        const why = !type ? 'does not exist' : 'is inactive';
+        const message = `Finance exception type ${WON_DEAL_ORDER_NOT_CONFIRMED} ${why}; the won-deal check was skipped.`;
+        LogStatus(message);
+        return emptyResult('SKIPPED', true, message);
+    }
+    const threshold = ReadMinDaysSinceClose(type);
+    if (threshold === null) {
+        return emptyResult('CONFIG_INVALID', false, `Finance exception type ${WON_DEAL_ORDER_NOT_CONFIRMED} has no usable MinDaysSinceClose in its `
+            + 'Configuration (a whole number of days, 0 or more). Nothing was checked.');
+    }
+    return { Threshold: threshold };
+}
+async function runQuery(threshold, user) {
+    const result = await new RunQuery().RunQuery({
+        QueryName: WON_DEALS_QUERY_NAME,
+        CategoryPath: WON_DEALS_QUERY_CATEGORY,
+        Parameters: { MinDaysSinceClose: threshold },
+    }, user);
+    if (!result?.Success) {
+        return emptyResult('QUERY_FAILED', false, `The query '${WON_DEALS_QUERY_NAME}' did not run: ${result?.ErrorMessage ?? 'unknown error'}`);
+    }
+    const rows = [];
+    const issues = [];
+    for (const raw of result.Results ?? []) {
+        const row = ReadWonDealRow(raw);
+        if (row) {
+            rows.push(row);
+        }
+        else {
+            issues.push('A query row carried no DealID or CompanyID and was not raised.');
+        }
+    }
+    return { Rows: rows, Issues: issues };
+}
+/**
+ * Every login linked to each owner, in one batched lookup (chunked only to bound the IN list).
+ * Returns a map from employee key to the linked user IDs, or an error message.
+ */
+export async function LoadLoginsByEmployee(employeeIDs, user) {
+    const unique = [...new Map(employeeIDs.map((id) => [idKey(id), id])).values()];
+    const byEmployee = new Map();
+    if (unique.length === 0) {
+        return byEmployee;
+    }
+    const params = [];
+    for (let i = 0; i < unique.length; i += USER_LOOKUP_CHUNK) {
+        const list = unique
+            .slice(i, i + USER_LOOKUP_CHUNK)
+            .map((id) => `'${id.replace(/'/g, "''")}'`)
+            .join(',');
+        params.push({
+            EntityName: USER_ENTITY_NAME,
+            ExtraFilter: `EmployeeID IN (${list})`,
+            Fields: ['ID', 'EmployeeID'],
+            ResultType: 'simple',
+        });
+    }
+    const results = await new RunView().RunViews(params, user);
+    for (const r of results) {
+        if (!r.Success) {
+            return `The owner login lookup failed: ${r.ErrorMessage ?? 'unknown error'}`;
+        }
+        for (const u of (r.Results ?? [])) {
+            if (!u.EmployeeID) {
+                continue;
+            }
+            const key = idKey(u.EmployeeID);
+            byEmployee.set(key, [...(byEmployee.get(key) ?? []), u.ID]);
+        }
+    }
+    return byEmployee;
+}
+export function ResolveCreator(ownerEmployeeID, logins) {
+    if (!ownerEmployeeID) {
+        return { UserID: null, Unresolved: false, LinkedLogins: 0 };
+    }
+    const linked = logins.get(idKey(ownerEmployeeID)) ?? [];
+    if (linked.length === 1) {
+        return { UserID: linked[0], Unresolved: false, LinkedLogins: 1 };
+    }
+    return { UserID: null, Unresolved: true, LinkedLogins: linked.length };
+}
+function buildException(row, creator, today) {
+    return {
+        TypeCode: WON_DEAL_ORDER_NOT_CONFIRMED,
+        SourceEntityName: DEAL_ENTITY_NAME,
+        SourceRecordID: row.DealID,
+        CompanyID: row.CompanyID,
+        Amount: row.DealAmount,
+        ExceptionDate: today,
+        Summary: BuildWonDealSummary(row, creator),
+        DedupeKey: row.DealID,
+        SourceCreatedByUserID: creator.UserID,
+        CreatorUnresolved: creator.Unresolved,
+    };
+}
+/** Fold accounting's answer into the run's tallies. Errors are named by deal, not by array index. */
+function applyRaiseOutput(result, output, rows) {
+    if (!output.Success) {
+        const detail = (output.Errors ?? [])
+            .map((e) => {
+            const row = e.Index === undefined ? undefined : rows[e.Index];
+            return `${row ? `deal ${row.DealNumber ?? row.DealID}: ` : ''}${e.Code}: ${e.Message}`;
+        })
+            .join('; ');
+        return {
+            ...result,
+            Success: false,
+            Outcome: 'RAISE_FAILED',
+            Issues: [...result.Issues, `Accounting refused the batch and wrote nothing. ${detail || 'No detail given.'}`],
+        };
+    }
+    for (const r of output.Results ?? []) {
+        if (r.Skipped) {
+            result.SkippedByAccounting++;
+        }
+        else if (r.Created) {
+            result.Created++;
+        }
+        else {
+            result.AlreadyRaised++;
+        }
+    }
+    return { ...result, Success: true, Outcome: 'RAISED' };
+}
+/**
+ * Detect won deals with unconfirmed orders and raise one finance exception per deal.
+ * Throws only when accounting's operations are not registered or do not execute.
+ */
+export async function DetectWonDealsWithUnconfirmedOrders(provider, user) {
+    const type = await readType(provider, user);
+    if ('Outcome' in type) {
+        return type;
+    }
+    const query = await runQuery(type.Threshold, user);
+    if ('Outcome' in query) {
+        return query;
+    }
+    const result = { ...emptyResult('NONE_FOUND', true), Found: query.Rows.length, Issues: query.Issues };
+    if (query.Rows.length === 0) {
+        return result;
+    }
+    const owners = query.Rows.map((r) => r.OwnerEmployeeID).filter((id) => id !== null);
+    const logins = await LoadLoginsByEmployee(owners, user);
+    if (typeof logins === 'string') {
+        return { ...result, Success: false, Outcome: 'USER_LOOKUP_FAILED', Issues: [...result.Issues, logins] };
+    }
+    await BusinessTimeZoneEngine.Instance.Config(false, user, provider);
+    const exceptions = query.Rows.map((row) => {
+        const creator = ResolveCreator(row.OwnerEmployeeID, logins);
+        if (creator.Unresolved) {
+            result.CreatorUnresolved++;
+        }
+        return buildException(row, creator, BusinessTimeZoneEngine.Instance.Today(row.CompanyID));
+    });
+    const output = await RaiseFinanceExceptions({ Exceptions: exceptions }, provider, user);
+    return applyRaiseOutput(result, output, query.Rows);
+}
+//# sourceMappingURL=WonDealOrderDetector.js.map

package/dist/finance-exceptions/WonDealOrderDetector.js.map

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

package/dist/index.d.ts

@@ -96,6 +96,12 @@ export * from './forecast/ForecastSource.js';
 export * from './forecast/FixtureForecastSource.js';
 export * from './forecast/QueryForecastSource.js';
 export * from './forecast/ForecastSnapshotJob.js';
+/**
+ * FINANCE EXCEPTIONS (golive #279). Accounting's operations reached by name, and the nightly
+ * won-deal detector (type 3) the `Sales.DetectWonDealsWithUnconfirmedOrders` Action calls.
+ */
+export * from './finance-exceptions/FinanceExceptionBridge.js';
+export * from './finance-exceptions/WonDealOrderDetector.js';
 /**
  * Anchor for the server-side entity subclasses, called from the sales-server bootstrap.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC;;;GAGG;AACH,cAAc,0BAA0B,CAAC;AAEzC,mGAAmG;AACnG,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;GAOG;AACH,cAAc,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH;;;;;;;;;;;GAWG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,OAAO,EACH,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACR,kBAAkB,EAClB,eAAe,EACf,cAAc,GACjB,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAOlD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAOlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC;;;GAGG;AACH,cAAc,0BAA0B,CAAC;AAEzC,mGAAmG;AACnG,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;GAOG;AACH,cAAc,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH;;;;;;;;;;;GAWG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,OAAO,EACH,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACR,kBAAkB,EAClB,eAAe,EACf,cAAc,GACjB,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAElD;;;GAGG;AACH,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAO7D;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAOlD"}

package/dist/index.js

@@ -95,6 +95,12 @@ export * from './forecast/ForecastSource.js';
 export * from './forecast/FixtureForecastSource.js';
 export * from './forecast/QueryForecastSource.js';
 export * from './forecast/ForecastSnapshotJob.js';
+/**
+ * FINANCE EXCEPTIONS (golive #279). Accounting's operations reached by name, and the nightly
+ * won-deal detector (type 3) the `Sales.DetectWonDealsWithUnconfirmedOrders` Action calls.
+ */
+export * from './finance-exceptions/FinanceExceptionBridge.js';
+export * from './finance-exceptions/WonDealOrderDetector.js';
 import { LoadActivitySyncEngine } from '@mj-biz-apps/common-activity-sync';
 import { DealEntityServer } from './DealEntityServer.js';
 import { CloseDealOperation, ReopenDealOperation } from './CloseDealOperation.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC;;;GAGG;AACH,cAAc,0BAA0B,CAAC;AAEzC,mGAAmG;AACnG,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;GAOG;AACH,cAAc,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH;;;;;;;;;;;GAWG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,OAAO,EACH,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC9B,MAAM,mCAAmC,CAAC;AAO3C;;;GAGG;AACH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B;IACvC,sBAAsB,EAAE,CAAC;IACzB,mEAAmE;IACnE,MAAM,OAAO,GAAc,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;IAC5G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAChG,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC;;;GAGG;AACH,cAAc,0BAA0B,CAAC;AAEzC,mGAAmG;AACnG,cAAc,wBAAwB,CAAC;AAEvC;;;;;;;GAOG;AACH,cAAc,0BAA0B,CAAC;AAEzC;;;;;GAKG;AACH;;;;;;;;;;;GAWG;AACH,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,OAAO,EACH,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC9B,MAAM,mCAAmC,CAAC;AAO3C;;;GAGG;AACH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAElD;;;GAGG;AACH,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAE7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B;IACvC,sBAAsB,EAAE,CAAC;IACzB,mEAAmE;IACnE,MAAM,OAAO,GAAc,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;IAC5G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAChG,CAAC;AACL,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mj-biz-apps/sales-core-entities-server",
   "type": "module",
-  "version": "6.8.2",
+  "version": "6.9.1",
   "description": "Server-side entity subclasses for BizApps Sales — the close lock (L-17), the OwnerEmployeeID denormalized stamp, and deal lifecycle hooks.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,8 +21,8 @@
   "dependencies": {
     "@mj-biz-apps/common-activity-sync": "^5.44.0",
     "@mj-biz-apps/common-entities": "^5.44.0",
-    "@mj-biz-apps/orders-entities": "^5.14.0",
-    "@mj-biz-apps/sales-entities": "6.8.2",
+    "@mj-biz-apps/orders-entities": "^5.18.0",
+    "@mj-biz-apps/sales-entities": "6.9.1",
     "@mj-biz-apps/tasks-core": "^1.4.1",
     "@mj-biz-apps/tasks-entities": "^1.4.1"
   },