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

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

@@ -11,7 +11,7 @@ export { addNewFieldFromExternalSource, addNewFieldFromLookupField, } from "./da
  * Timezone and time-related utilities
  */
 export { getTimezoneOffsetAndPersist } from "./time-utils";
-export { formatDateWithTZOffset, convertToLocalTime } from "./timezone";
+export { formatDateWithTZOffset, convertToLocalTime, toISOWithOffset } from "./timezone";
 export { applyTimezoneOffsetsToFields } from "./time-utils";
 export * from "./time-utils";
 /**
@@ -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,eAAe,EAAE,MAAM,YAAY,CAAC;AACzF,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/dist/utils/timezone.d.ts

@@ -18,4 +18,11 @@ export declare const convertToLocalTime: (zuluTime: string | Date | null | undef
  * @returns The formatted date string in format: YYYY-MM-DDTHH:mm:ss+/-HH:MM
  */
 export declare const formatDateWithTZOffset: (date: string | null | undefined, timezoneOffset: number) => string | undefined;
+/**
+ * Formats a Date object as an ISO string with the specified timezone offset
+ * @param date The Date object to format (should be a Date that has been shifted by convertToLocalTime)
+ * @param timezoneOffset The timezone offset in hours
+ * @returns ISO string with offset in format: YYYY-MM-DDTHH:mm:ss.SSS±HH:MM
+ */
+export declare const toISOWithOffset: (date: Date, timezoneOffset: number) => string;
 //# sourceMappingURL=timezone.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/utils/timezone.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,MAAM,CA6CxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC1C,gBAAgB,MAAM,KACrB,IAAI,GAAG,SAIT,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAgBX,CAAC"}
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/utils/timezone.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,MAAM,CA6CxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC1C,gBAAgB,MAAM,KACrB,IAAI,GAAG,SAIT,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAgBX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,EAAE,gBAAgB,MAAM,KAAG,MAoBpE,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.5",
   "license": "MIT",
   "author": "machinemetrics",
   "main": "dist/mm-erp-sdk.js",

package/src/index.ts

@@ -9,15 +9,15 @@ 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 { MMReceiveLaborTicket } from "./services/mm-api-service";
 export type {  
-  MMReceiveLaborTicket,
   MMReceiveLaborTicketReason,
   MMReceiveLaborTicketWorkOrderOperation,
   IToRESTApiObject,
@@ -48,6 +48,7 @@ export {
   formatDateWithTZOffset,
   applyTimezoneOffsetsToFields,
   convertToLocalTime,
+  getErrorType,
 } from "./utils";
 
 // Local data store
@@ -55,7 +56,8 @@ 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 +73,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 +104,13 @@ export {
   SqlServerHelper,
 } from "./services/sql-server-erp-service";
 export type { SQLInput } from "./services/sql-server-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';

package/src/services/mm-api-service/index.ts

@@ -52,8 +52,8 @@ export type {
 /**
  * Types related of labor tickets received from the MM API
  */
+export { MMReceiveLaborTicket } from "./types/receive-types";
 export type {
-  MMReceiveLaborTicket,
   MMReceiveLaborTicketReason,
   MMReceiveLaborTicketWorkOrderOperation,
 };

package/src/services/mm-api-service/mm-api-service.ts

@@ -646,6 +646,34 @@ export class MMApiClient {
     );
   }
 
+  /**
+   * Send connector logs to the MM API
+   * @param logEntry Single log entry to send
+   * @returns Promise with the API response
+   */
+  async sendConnectorLog(logEntry: { source: string; level: string; message: string }): Promise<MMApiBaseResponse> {
+    return await this.postData(
+      '/connector/logs',
+      logEntry,
+      {},
+      { baseUrl: UrlBase.ApiBase }
+    );
+  }
+
+  /**
+   * Send bulk connector logs to the MM API
+   * @param logs Array of log entries to send
+   * @returns Promise with the API response
+   */
+  async sendBulkConnectorLogs(logs: { source: string; level: string; message: string }[]): Promise<MMApiBaseResponse> {
+    return await this.postData(
+      '/connector/logs',
+      { logs },
+      {},
+      { baseUrl: UrlBase.ApiBase }
+    );
+  }
+
   async deleteFailedLaborTicketIds(
     system: ERPType,
     laborTicketRefs: string[]

package/src/types/erp-types.ts

@@ -7,7 +7,6 @@ export enum ERPType {
   PROSHOP = "PROSHOP",
   SYTELINE = "SYTELINE",
   TEMPLATE = "TEMPLATE",
-  GLOBALSHOP = "GLOBALSHOP",
 }
 
 export enum ERPObjType {

package/src/utils/application-initializer.ts

@@ -41,7 +41,7 @@ export class ApplicationInitializer {
       );
     } catch (error) {
       logger.error("Critical initialization failure. Exiting.", error);
-      process.exit(1);
+      process.exitCode = 1;
     }
   }
 

package/src/utils/connector-factory.ts

@@ -1,5 +1,6 @@
 import { IERPConnector } from "../types/erp-connector";
 import logger from "../services/reporting-service/logger";
+import { pathToFileURL } from "url";
 
 /**
  * Helper function to dynamically import and create connector instance from a file path
@@ -10,8 +11,18 @@ export const createConnectorFromPath = async (
   connectorPath: string
 ): Promise<IERPConnector> => {
   try {
-    // Dynamic import the connector module
-    const connectorModule = await import(connectorPath);
+    // Some detailed debug logging to help with troubleshooting multi-platform connector paths
+    const pathParts = connectorPath.split('/');
+    const filename = pathParts[pathParts.length - 1];
+
+    logger.debug("createConnectorFromPath:", {
+      connectorPath,
+      pathParts,
+      filename,
+      finalImport: pathToFileURL(connectorPath).href,
+    });
+
+    const connectorModule = await import(pathToFileURL(connectorPath).href);
 
     // Get the default export or named export
     const ConnectorClass =
@@ -31,4 +42,4 @@ export const createConnectorFromPath = async (
     );
     throw error;
   }
-};
+};