@machinemetrics/mm-erp-sdk 0.1.5-beta.0 → 0.1.6-beta.0

package/dist/services/psql-erp-service/internal/types/psql-types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PSQL-specific type definitions
+ */
+export interface PsqlConnectionOptions {
+    connectionString: string;
+}
+export interface OdbcError {
+    state: string;
+    message: string;
+    code?: number;
+}
+export interface OdbcErrorResponse extends Error {
+    odbcErrors?: OdbcError[];
+}
+//# sourceMappingURL=psql-types.d.ts.map

package/dist/services/psql-erp-service/internal/types/psql-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psql-types.d.ts","sourceRoot":"","sources":["../../../../../src/services/psql-erp-service/internal/types/psql-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B"}

package/dist/services/psql-erp-service/psql-helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Helper functions for PSQL/Pervasive database operations
+ */
+/**
+ * Formats a date from PSQL YYMMDD format to ISO date string
+ * @param psqlDate Date in YYMMDD format (e.g., "250105" for Jan 5, 2025)
+ * @returns ISO date string (e.g., "2025-01-05") or null if invalid
+ */
+export declare function formatPsqlDate(psqlDate: string): string | null;
+/**
+ * Formats a time from PSQL HHMM format to HH:MM:SS
+ * @param psqlTime Time in HHMM format (e.g., "1430" for 2:30 PM)
+ * @returns Time string in HH:MM:SS format or null if invalid
+ */
+export declare function formatPsqlTime(psqlTime: string): string | null;
+/**
+ * Combines PSQL date and time into ISO datetime string
+ * @param psqlDate Date in YYMMDD format
+ * @param psqlTime Time in HHMM format
+ * @returns ISO datetime string or null if invalid
+ */
+export declare function combinePsqlDateTime(psqlDate: string, psqlTime: string): string | null;
+/**
+ * Helper to check if a PSQL date is "empty" (000000 or blank)
+ */
+export declare function isPsqlDateEmpty(psqlDate: string): boolean;
+/**
+ * Clean and trim PSQL CHAR field (removes trailing spaces)
+ * PSQL CHAR fields are fixed-width and padded with spaces
+ */
+export declare function cleanPsqlCharField(value: string | null | undefined): string;
+//# sourceMappingURL=psql-helpers.d.ts.map

package/dist/services/psql-erp-service/psql-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psql-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/psql-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuB9D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CASf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAK3E"}

package/dist/services/psql-erp-service/psql-service.d.ts

@@ -0,0 +1,49 @@
+import odbc from "odbc";
+import { PsqlConfiguration } from "./configuration";
+import { ERPResponse } from "../../types/erp-types";
+type PagingParams = {
+    limit?: number;
+    offset?: number;
+};
+export declare class PsqlService {
+    private connection;
+    private config;
+    constructor(config: PsqlConfiguration);
+    dispose(): Promise<void>;
+    /**
+     * Build PSQL ODBC connection string
+     * CRITICAL: ServerName must use IP.PORT format (e.g., 10.4.0.11.1583)
+     */
+    private buildConnectionString;
+    /**
+     * Execute a query and return the results
+     * Interface matches SqlServerService for consistency
+     *
+     * @param query The SQL query to execute
+     * @param params Query parameters (currently unused for PSQL read operations)
+     * @param paging Optional paging parameters
+     * @returns The entities fetched from the database, along with paging information
+     */
+    executePreparedStatement(query: string, params?: Record<string, string>, paging?: PagingParams): Promise<ERPResponse | undefined>;
+    /**
+     * Opens a connection to PSQL database
+     * Caches the connection so that it can be reused.
+     * On failure to connect, throws
+     */
+    openConnection(): Promise<odbc.Connection>;
+    /**
+     * Transform ODBC result set to array of Record<string, string> instances.
+     * IMPORTANT: PSQL CHAR fields are often padded with spaces - we trim them
+     *
+     * @param recordset Result set from ODBC query
+     * @returns array of Record<string, string> instances
+     */
+    static recordsetToRecords(recordset: any[]): Record<string, string>[];
+    /**
+     * Handle ODBC errors and provide meaningful messages
+     */
+    private handleOdbcError;
+    private closeConnection;
+}
+export {};
+//# sourceMappingURL=psql-service.d.ts.map

package/dist/services/psql-erp-service/psql-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psql-service.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/psql-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAI/B,OAAO;IAIb;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;;;;;;;OAQG;IACU,wBAAwB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAsDnC;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;IA4BhD;;;;;;OAMG;WACW,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAmB5E;;OAEG;IACH,OAAO,CAAC,eAAe;YA6BT,eAAe;CAa9B"}

package/dist/utils/connector-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-factory.d.ts","sourceRoot":"","sources":["../../src/utils/connector-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,eAAe,MAAM,KACpB,OAAO,CAAC,aAAa,CAuBvB,CAAC"}
+{"version":3,"file":"connector-factory.d.ts","sourceRoot":"","sources":["../../src/utils/connector-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIvD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,eAAe,MAAM,KACpB,OAAO,CAAC,aAAa,CAiCvB,CAAC"}

package/dist/utils/connector-log/log-deduper.d.ts

@@ -0,0 +1,56 @@
+import type { LogEntry } from './mm-connector-logger';
+/**
+ * Implement a custom LogDeduper or use the provided FileLogDeduper
+ */
+export interface LogDeduper {
+    decide(entry: LogEntry, now: number): Promise<string | null>;
+    onSuccess(entry: LogEntry, now: number): Promise<void>;
+    retryFailedTransmissions?(send: (entry: LogEntry, message: string) => Promise<void>): Promise<void>;
+}
+/**
+ * FileLogDeduper implements the LogDeduper interface to deduplicate
+ * logs by storing them in a file; this allows deduping across jobs.
+ */
+export declare class FileLogDeduper implements LogDeduper {
+    private readonly storeFilePath;
+    private readonly windowMs;
+    private readonly ttlMs;
+    private readonly sweepIntervalMs;
+    private lastSweepTsMs;
+    private readonly DEFAULT_WINDOW_TEN_MINS;
+    private readonly DEFAULT_TTL_ONE_HOUR;
+    private readonly DEFAULT_SWEEP_INTERVAL_FIVE_MINS;
+    private readonly DEFAULT_STORE_FILE_PATH;
+    /**
+     * Ctor.
+     * @param storeFilePath:         The path to the file where the deduplication store is stored; recommended is to use the default
+     * @param windowSeconds:         Suppression window. Duplicates within this period are suppressed.
+     * @param ttlSeconds:            Eviction TTL. Store entries for keys inactive beyond this are removed. Enforced to be ≥ windowSeconds.
+     * @param sweepIntervalSeconds:  Efficiency parameter. How often (min interval) to run opportunistic eviction; retry always sweeps
+     *                               The sweep is lazy, used only when the store is accessed
+     */
+    constructor({ storeFilePath, windowSeconds, ttlSeconds, sweepIntervalSeconds }?: {
+        storeFilePath?: string;
+        windowSeconds?: number;
+        ttlSeconds?: number;
+        sweepIntervalSeconds?: number;
+    });
+    /**
+     * Deduplication gating function
+     * Returns the formatted message to send, or null to suppress
+     * Decision is based on the dedupeKey and the time of the entry
+    */
+    decide(entry: LogEntry, now: number): Promise<string | null>;
+    onSuccess(entry: LogEntry, now: number): Promise<void>;
+    retryFailedTransmissions(send: (entry: LogEntry, message: string) => Promise<void>): Promise<void>;
+    private ensureStoreFileExists;
+    private readStore;
+    private writeStore;
+    private formatMessage;
+    private withLock;
+    /**
+     * Evict expired entries from the store based on the TTL and the key's last transmitted time
+     */
+    private evictExpiredInStore;
+}
+//# sourceMappingURL=log-deduper.d.ts.map

package/dist/utils/connector-log/log-deduper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-deduper.d.ts","sourceRoot":"","sources":["../../../src/utils/connector-log/log-deduper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,wBAAwB,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrG;AAkBD;;;GAGG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAO;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAAO;IACxD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA+C;IAEvF;;;;;;;OAOG;gBACS,EACV,aAA4C,EAC5C,aAA4C,EAC5C,UAAsC,EACtC,oBAA4D,EAC7D,GAAG;QACF,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC1B;IAWN;;;;MAIE;IACI,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8D5D,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtD,wBAAwB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCxG,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,aAAa;YAUP,QAAQ;IA2BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAW5B"}

package/dist/utils/connector-log/mm-connector-logger-example.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=mm-connector-logger-example.d.ts.map

package/dist/utils/connector-log/mm-connector-logger-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm-connector-logger-example.d.ts","sourceRoot":"","sources":["../../../src/utils/connector-log/mm-connector-logger-example.ts"],"names":[],"mappings":""}

package/dist/utils/connector-log/mm-connector-logger.d.ts

@@ -0,0 +1,74 @@
+import type { LogDeduper } from './log-deduper';
+export type LogLevelString = 'info' | 'warn' | 'error';
+/**
+ * dedupeKey - key used to deduplicate log entries when a LogDeduper is injected into the MMConnectorLogger
+ *
+ * A recommended practice is to use a meaningful unique identifier for this log entry type.
+ * Examples: SyncFromERPCompleted
+ *           SyncFromERPError:HTTPError
+ */
+export declare class LogEntry {
+    level: LogLevelString;
+    message: string;
+    dedupeKey: string;
+    eventTime: number;
+    constructor(params: {
+        level: LogLevelString;
+        message: string;
+        dedupeKey: string;
+    });
+}
+/**
+ * The response from the MM connector logging API
+ */
+export interface LogResponse {
+    message: string;
+    processed?: number;
+}
+/**
+ * MM Connector Logger for sending progress and error updates to the MM cloud
+ *
+ * This class provides helper methods to send individual logs to the
+ * MM connector logging API, providing support for validation, retries, and error handling
+ * according to the API specification.
+ *
+ * By injecting a LogDeduper, the log entries are deduplicated across jobs over a specified time window
+ */
+export declare class MMConnectorLogger {
+    private readonly MAX_MSG_LEN;
+    private mmApiClient;
+    private readonly deduper?;
+    private readonly source;
+    constructor(source: string, deduper?: LogDeduper);
+    /**
+     * Send a single log entry to the MM cloud with deduplication.
+     *
+     * The deduplication is handled by the injected LogDeduper.
+     * If no deduper is injected, the log entry is sent without deduplication.
+     *
+     * The standard deduper, FileLogDeduper, stores the deduplication state in a file,
+     * allowing deduplication across jobs,
+     *
+     * @param logEntry - The log entry to send
+     * @returns Promise resolving to the API response or null if suppressed
+     * @throws HTTPError if the request fails or Error if the log entry is invalid
+     */
+    sendLog(logEntry: LogEntry): Promise<LogResponse | null>;
+    /**
+     * @throws Error if validation fails
+     */
+    private validateLogEntry;
+    /**
+     * Retry all failed transmissions silently
+     * This method attempts to retry all messages that failed to transmit
+     * and removes them from the failed list if successful, else leaves them for the client to retry
+     *
+     * Expected usage is by a client to call this as part of its own retry mechanism
+     */
+    retryFailedTransmissions(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=mm-connector-logger.d.ts.map

package/dist/utils/connector-log/mm-connector-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm-connector-logger.d.ts","sourceRoot":"","sources":["../../../src/utils/connector-log/mm-connector-logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,QAAQ;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;gBAEN,MAAM,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC;CAMjF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU;IAYhD;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAsC9D;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;;;;OAMG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/utils/error-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function getErrorType(error: unknown): string;
+//# sourceMappingURL=error-utils.d.ts.map

package/dist/utils/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../src/utils/error-utils.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASnD"}

package/dist/utils/index.d.ts

@@ -25,7 +25,8 @@ export { BatchCacheManager } from "../services/caching-service/batch-cache-manag
  * Process and data transformation utilities
  */
 export { StandardProcessDrivers } from "./standard-process-drivers/";
-export type { WriteEntitiesToMMResult, MMBatchValidationError, } from "./standard-process-drivers/";
+export type { WriteEntitiesToMMResult } from "./standard-process-drivers/";
+export { MMBatchValidationError } from "./standard-process-drivers/";
 export { getCachedTimezoneOffset } from "./local-data-store/jobs-shared-data";
 export { getInitialLoadComplete, setInitialLoadComplete, } from "./local-data-store/jobs-shared-data";
 /**
@@ -38,10 +39,18 @@ export { getERPAPITypeFromEntity } from "./erp-type-from-entity";
  * HTTP Client utilities
  */
 export { HTTPClientFactory } from "./http-client";
+export { HTTPError } from "./http-client";
+export type { HTTPClient, HTTPRequestConfig, HTTPResponse } from "./http-client";
 /**
  * MM Labor Ticket utilities
  */
 export * from "./mm-labor-ticket-helpers";
+export { getErrorType } from './error-utils';
+/**
+ * MM Connector Logger utilities
+ */
+export { MMConnectorLogger, LogEntry, type LogResponse, type LogLevelString } from './connector-log/mm-connector-logger';
+export { FileLogDeduper } from './connector-log/log-deduper';
 /**
  * Application initializer
  */

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,cAAc,cAAc,CAAC;AAE7B;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEpF;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAE1C;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAE1C;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,cAAc,cAAc,CAAC;AAE7B;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEpF;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjF;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAE1C;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils/standard-process-drivers/index.d.ts

@@ -1,3 +1,4 @@
 export { StandardProcessDrivers } from "./standard-process-drivers";
-export type { WriteEntitiesToMMResult, MMBatchValidationError, } from "./standard-process-drivers";
+export type { WriteEntitiesToMMResult } from "./standard-process-drivers";
+export { MMBatchValidationError } from "./standard-process-drivers";
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/standard-process-drivers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@machinemetrics/mm-erp-sdk",
   "description": "A library for syncing data between MachineMetrics and ERP systems",
-  "version": "0.1.5-beta.0",
+  "version": "0.1.6-beta.0",
   "license": "MIT",
   "author": "machinemetrics",
   "main": "dist/mm-erp-sdk.js",
@@ -28,6 +28,7 @@
     "knex": "^3.1.0",
     "lodash": "^4.17.21",
     "mssql": "^11.0.1",
+    "odbc": "^2.4.8",
     "winston": "^3.14.0",
     "winston-daily-rotate-file": "^5.0.0",
     "xxhashjs": "^0.2.2",

package/src/index.ts

@@ -9,21 +9,21 @@ export { ERPType, ERPObjType } from "./types/erp-types";
 export type { ERPPagination, ERPResponse, ERPObject } from "./types/erp-types";
 
 // Configuration interfaces
-export type { ErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
+export { ErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
 export { getErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
 export { buildLogicalCondition } from "./services/erp-api-services/rest/get-query-params";
 export type { ERPApiConfig } from "./services/erp-api-services/types";
 
 // MM API client and types
 export { MMApiClient } from "./services/mm-api-service";
-export type {  
-  MMReceiveLaborTicket,
+export { MMReceiveLaborTicket } from "./services/mm-api-service";
+export type {
   MMReceiveLaborTicketReason,
   MMReceiveLaborTicketWorkOrderOperation,
   IToRESTApiObject,
 } from "./services/mm-api-service";
 
-export {  
+export {
   MMSendPerson,
   MMSendResource,
   MMSendPart,
@@ -48,6 +48,7 @@ export {
   formatDateWithTZOffset,
   applyTimezoneOffsetsToFields,
   convertToLocalTime,
+  getErrorType,
 } from "./utils";
 
 // Local data store
@@ -55,7 +56,12 @@ export { getInitialLoadComplete, setInitialLoadComplete } from "./utils";
 
 // HTTP client factory and types for custom API integrations
 export { HTTPClientFactory } from "./utils/http-client";
-export type { HTTPResponse } from "./utils/http-client";
+export { HTTPError } from "./utils/http-client";
+export type {
+  HTTPResponse,
+  HTTPClient,
+  HTTPRequestConfig,
+} from "./utils/http-client";
 
 // Application initialization utilities
 export { ApplicationInitializer } from "./utils/application-initializer";
@@ -71,11 +77,13 @@ export type { IERPLaborTicketHandler } from "./types/erp-connector";
 
 // Process drivers and utilities
 export { StandardProcessDrivers, getCachedTimezoneOffset } from "./utils";
-export type {  WriteEntitiesToMMResult, MMBatchValidationError } from "./utils";
+export type { WriteEntitiesToMMResult } from "./utils";
+export { MMBatchValidationError } from "./utils";
 
 // API services
+export type { APIResponse } from "./services/erp-api-services/types";
 export { RestAPIService } from "./services/erp-api-services/rest/rest-api-service";
-export { ErrorHandler } from "./services/erp-api-services/errors";
+export { ErrorHandler, GraphQLError } from "./services/erp-api-services/errors";
 export type {
   QueryParams,
   PaginatedAPIResponse,
@@ -100,3 +108,31 @@ export {
   SqlServerHelper,
 } from "./services/sql-server-erp-service";
 export type { SQLInput } from "./services/sql-server-erp-service";
+
+// PSQL (Pervasive) services
+export {
+  PsqlService,
+  PsqlLaborTicketOperations,
+  formatPsqlDate,
+  formatPsqlTime,
+  combinePsqlDateTime,
+  isPsqlDateEmpty,
+  cleanPsqlCharField,
+} from "./services/psql-erp-service";
+export type { PsqlConfiguration } from "./services/psql-erp-service";
+
+// Record tracking services
+export { RecordTrackingManager } from "./services/caching-service/record-tracking-manager";
+export type { RecordTrackingObject } from "./services/caching-service/record-tracking-manager";
+
+// Knex services
+export { default as knexDatabaseConfig } from "./knexfile";
+
+// MM Connector Logging
+export {
+  MMConnectorLogger,
+  FileLogDeduper,
+  LogEntry,
+  type LogLevelString,
+  type LogResponse,
+} from "./utils";

package/src/services/data-sync-service/index.ts

@@ -8,7 +8,4 @@ export { runDataSyncService } from "./data-sync-service";
  */
 export { getSQLServerConfiguration } from "./configuration-manager";
 
-export {
-  ErpApiConnectionParams,
-  getErpApiConnectionParams,
-} from "./configuration-manager";
+export { ErpApiConnectionParams, getErpApiConnectionParams } from "./configuration-manager";

package/src/services/data-sync-service/jobs/clean-up-expired-cache.ts

@@ -3,6 +3,9 @@ import { HashedCacheManager } from "../../caching-service/hashed-cache-manager";
 import { SQLiteCoordinator } from "../../sqlite-service";
 import logger from "../../../services/reporting-service/logger";
 
+// Configure the logger with the correct log level
+logger.level = process.env.LOG_LEVEL || "info";
+
 const main = async () => {
   const cacheManager = new HashedCacheManager();
   try {
@@ -29,13 +32,22 @@ const main = async () => {
   }
 };
 
-// For Bree compatibility - check if this is running as a worker
-if (require.main === module) {
+// Cross-platform module detection fix for Bree compatibility
+// Windows: process.argv[1] uses backslashes, import.meta.url uses forward slashes
+// Linux/Mac: both use forward slashes, so this normalization is safe
+const normalizedArgv1 = process.argv[1].replace(/\\/g, '/');
+const fileUrl = normalizedArgv1.startsWith('/') ? 
+  `file://${normalizedArgv1}` :  // Unix: file:// + /path = file:///path
+  `file:///${normalizedArgv1}`;  // Windows: file:/// + C:/path = file:///C:/path
+const isMainModule = import.meta.url === fileUrl;
+
+if (isMainModule) {
   // This is called when Bree runs this file as a worker
-  (async () => {
+  try {
     await main();
-  })();
-} else {
-  // Export for potential testing or direct usage
-  module.exports = main;
+  } catch {
+    process.exitCode = 1; // prefer exitCode so stdout/stderr can flush
+  }
 }
+
+export default main;

package/src/services/data-sync-service/jobs/from-erp.ts

@@ -4,6 +4,9 @@ import logger from "../../../services/reporting-service/logger";
 import { SQLiteCoordinator } from "../../sqlite-service";
 import { createConnectorFromPath } from "../../../utils/connector-factory";
 
+// Configure the logger with the correct log level
+logger.level = process.env.LOG_LEVEL || "info";
+
 const main = async () => {
   try {
     logger.info('Worker for job "from-erp" online');
@@ -11,8 +14,7 @@ const main = async () => {
 
     // Get the connector path from the environment variable
     const connectorPath = process.env.CONNECTOR_PATH;
-
-
+ 
     if (!connectorPath) {
       throw new Error("Connector path not provided in environment variables");
     }
@@ -41,9 +43,14 @@ const main = async () => {
   }
 };
 
-// For Bree compatibility - check if this is running as a worker
-// In ES modules, we need to check import.meta.url instead of require.main
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+// Cross-platform module detection fix for Bree compatibility
+// Windows: process.argv[1] uses backslashes, import.meta.url uses forward slashes
+// Linux/Mac: both use forward slashes, so this normalization is safe
+const normalizedArgv1 = process.argv[1].replace(/\\/g, '/');
+const fileUrl = normalizedArgv1.startsWith('/') ? 
+  `file://${normalizedArgv1}` :  // Unix: file:// + /path = file:///path
+  `file:///${normalizedArgv1}`;  // Windows: file:/// + C:/path = file:///C:/path
+const isMainModule = import.meta.url === fileUrl;
 
 if (isMainModule) {
   // This is called when Bree runs this file as a worker

package/src/services/data-sync-service/jobs/retry-failed-labor-tickets.ts

@@ -3,6 +3,9 @@ import "dotenv/config";
 import logger from "../../../services/reporting-service/logger";
 import { createConnectorFromPath } from "../../../utils/connector-factory";
 
+// Configure the logger with the correct log level
+logger.level = process.env.LOG_LEVEL || "info";
+
 const main = async () => {
   try {
     logger.info('Worker for job "retry-failed-labor-tickets" online');
@@ -34,13 +37,20 @@ const main = async () => {
   }
 };
 
-// For Bree compatibility - check if this is running as a worker
-if (require.main === module) {
+// Cross-platform module detection fix for Bree compatibility
+// Windows: process.argv[1] uses backslashes, import.meta.url uses forward slashes
+// Linux/Mac: both use forward slashes, so this normalization is safe
+const normalizedArgv1 = process.argv[1].replace(/\\/g, '/');
+const fileUrl = normalizedArgv1.startsWith('/') ? 
+  `file://${normalizedArgv1}` :  // Unix: file:// + /path = file:///path
+  `file:///${normalizedArgv1}`;  // Windows: file:/// + C:/path = file:///C:/path
+const isMainModule = import.meta.url === fileUrl;
+
+if (isMainModule) {
   // This is called when Bree runs this file as a worker
   main().catch(() => {
     process.exitCode = 1;
   });
-} else {
-  // Export for potential testing or direct usage
-  module.exports = main;
 }
+
+export default main;

package/src/services/data-sync-service/jobs/run-migrations.ts

@@ -2,6 +2,9 @@ import knex, { Knex } from "knex";
 import logger from "../../reporting-service/logger";
 import config from "../../../knexfile";
 
+// Configure the logger with the correct log level
+logger.level = process.env.LOG_LEVEL || "info";
+
 // MLW TODO Consider the location of knexfile
 const db: Knex = knex(config.local);
 
@@ -12,7 +15,7 @@ export default async function runMigrations() {
     logger.info("Migrations complete!");
   } catch (error) {
     logger.error("Error running migrations:", error);
-    process.exit(1);
+    process.exitCode = 1;
   } finally {
     await db.destroy();
   }
@@ -22,6 +25,6 @@ const isMainModule = import.meta.url === `file://${process.argv[1]}`;
 if (isMainModule) {
   runMigrations().catch(err => {
     logger.error("Top-level error running migrations:", err);
-    process.exit(1);
+    process.exitCode = 1;
   });
 }

package/src/services/data-sync-service/jobs/to-erp.ts

@@ -3,6 +3,9 @@ import "dotenv/config";
 import logger from "../../reporting-service/logger";
 import { createConnectorFromPath } from "../../../utils/connector-factory";
 
+// Configure the logger with the correct log level
+logger.level = process.env.LOG_LEVEL || "info";
+
 const main = async () => {
   try {
     logger.info('Worker for job "to-erp" online');
@@ -41,13 +44,22 @@ const main = async () => {
   }
 };
 
-// For Bree compatibility - check if this is running as a worker
-// In ES modules, we need to check import.meta.url instead of require.main
-const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+// Cross-platform module detection fix for Bree compatibility
+// Windows: process.argv[1] uses backslashes, import.meta.url uses forward slashes
+// Linux/Mac: both use forward slashes, so this normalization is safe
+const normalizedArgv1 = process.argv[1].replace(/\\/g, '/');
+const fileUrl = normalizedArgv1.startsWith('/') ? 
+  `file://${normalizedArgv1}` :  // Unix: file:// + /path = file:///path
+  `file:///${normalizedArgv1}`;  // Windows: file:/// + C:/path = file:///C:/path
+const isMainModule = import.meta.url === fileUrl;
+
 if (isMainModule) {
   // This is called when Bree runs this file as a worker
-  main();
+  try {
+    await main();
+  } catch {
+    process.exitCode = 1; // prefer exitCode so stdout/stderr can flush
+  }
 }
 
-// Export for potential testing or direct usage (ES module default export)
 export default main;

package/src/services/erp-api-services/index.ts

@@ -9,6 +9,14 @@ export type { QueryParams } from "./rest/get-query-params";
 
 // GraphQL Service
 export { GraphQLService } from "./graphql/graphql-service";
+export type { GraphQLServerError } from './graphql/types';
 
 // OAuth Client
-export { OAuthClient } from "./oauth-client";
+export { OAuthClient } from './oauth-client'; 
+export type { OAuthConfig } from './oauth-client';
+
+// API Response
+export type { APIResponse } from './types';
+
+// Error classes
+export { ErrorHandler, GraphQLError } from './errors';