@machinemetrics/mm-erp-sdk 0.1.3 → 0.1.4-beta.0

package/dist/services/data-sync-service/jobs/clean-up-expired-cache.js

@@ -2,10 +2,10 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
-import "../../../config-2l5vnNkA.js";
-import { H as HashedCacheManager } from "../../../hashed-cache-manager-Ci59eC75.js";
-import { S as SQLiteCoordinator } from "../../../index-CXbOvFyf.js";
-import { l as logger } from "../../../logger-QG73MndU.js";
+import "../../../config-WKwu1mMo.js";
+import { H as HashedCacheManager } from "../../../hashed-cache-manager-INiCs0JC.js";
+import { S as SQLiteCoordinator } from "../../../index-aci_wdcn.js";
+import { l as logger } from "../../../logger-hqtl8hFM.js";
 var require_clean_up_expired_cache = __commonJS({
   "services/data-sync-service/jobs/clean-up-expired-cache.js"(exports, module) {
     const main = async () => {

package/dist/services/data-sync-service/jobs/from-erp.js

@@ -1,7 +1,7 @@
-import "../../../config-2l5vnNkA.js";
-import { l as logger } from "../../../logger-QG73MndU.js";
-import { S as SQLiteCoordinator } from "../../../index-CXbOvFyf.js";
-import { c as createConnectorFromPath } from "../../../connector-factory-CQ8e7Tae.js";
+import "../../../config-WKwu1mMo.js";
+import { l as logger } from "../../../logger-hqtl8hFM.js";
+import { S as SQLiteCoordinator } from "../../../index-aci_wdcn.js";
+import { c as createConnectorFromPath } from "../../../connector-factory-DFv3ex0X.js";
 const main = async () => {
   try {
     logger.info('Worker for job "from-erp" online');

package/dist/services/data-sync-service/jobs/retry-failed-labor-tickets.js

@@ -2,9 +2,9 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
-import "../../../config-2l5vnNkA.js";
-import { l as logger } from "../../../logger-QG73MndU.js";
-import { c as createConnectorFromPath } from "../../../connector-factory-CQ8e7Tae.js";
+import "../../../config-WKwu1mMo.js";
+import { l as logger } from "../../../logger-hqtl8hFM.js";
+import { c as createConnectorFromPath } from "../../../connector-factory-DFv3ex0X.js";
 var require_retry_failed_labor_tickets = __commonJS({
   "services/data-sync-service/jobs/retry-failed-labor-tickets.js"(exports, module) {
     const main = async () => {

package/dist/services/data-sync-service/jobs/run-migrations.js

@@ -1,5 +1,5 @@
 import knex from "knex";
-import { l as logger } from "../../../logger-QG73MndU.js";
+import { l as logger } from "../../../logger-hqtl8hFM.js";
 import { c as config } from "../../../knexfile-1qKKIORB.js";
 const db = knex(config.local);
 async function runMigrations() {

package/dist/services/data-sync-service/jobs/to-erp.js

@@ -1,6 +1,6 @@
-import "../../../config-2l5vnNkA.js";
-import { l as logger } from "../../../logger-QG73MndU.js";
-import { c as createConnectorFromPath } from "../../../connector-factory-CQ8e7Tae.js";
+import "../../../config-WKwu1mMo.js";
+import { l as logger } from "../../../logger-hqtl8hFM.js";
+import { c as createConnectorFromPath } from "../../../connector-factory-DFv3ex0X.js";
 const main = async () => {
   try {
     logger.info('Worker for job "to-erp" online');

package/dist/services/erp-api-services/index.d.ts

@@ -5,5 +5,8 @@
 export { RestAPIService } from "./rest/rest-api-service";
 export type { QueryParams } from "./rest/get-query-params";
 export { GraphQLService } from "./graphql/graphql-service";
-export { OAuthClient } from "./oauth-client";
+export type { GraphQLServerError } from './graphql/types';
+export { OAuthClient } from './oauth-client';
+export type { OAuthConfig } from './oauth-client';
+export type { APIResponse } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/services/erp-api-services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/erp-api-services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/erp-api-services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/services/mm-api-service/mm-api-service.d.ts

@@ -199,6 +199,26 @@ export declare class MMApiClient {
      */
     addFailedLaborTicketRefs(system: ERPType, failedTicketRefs: string[]): Promise<MMApiBaseResponse>;
     fetchFailedLaborTickets(system: ERPType): Promise<MMReceiveLaborTicket[]>;
+    /**
+     * Send connector logs to the MM API
+     * @param logEntry Single log entry to send
+     * @returns Promise with the API response
+     */
+    sendConnectorLog(logEntry: {
+        source: string;
+        level: string;
+        message: string;
+    }): Promise<MMApiBaseResponse>;
+    /**
+     * Send bulk connector logs to the MM API
+     * @param logs Array of log entries to send
+     * @returns Promise with the API response
+     */
+    sendBulkConnectorLogs(logs: {
+        source: string;
+        level: string;
+        message: string;
+    }[]): Promise<MMApiBaseResponse>;
     deleteFailedLaborTicketIds(system: ERPType, laborTicketRefs: string[]): Promise<MMApiBaseResponse>;
     /**
      * Fetch machine groups from the MM API

package/dist/services/mm-api-service/mm-api-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mm-api-service.d.ts","sourceRoot":"","sources":["../../../src/services/mm-api-service/mm-api-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mm-api-service.d.ts","sourceRoot":"","sources":["../../../src/services/mm-api-service/mm-api-service.ts"],"names":[],"mappings":"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"}

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;IA4D5D,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,17 @@ export { getERPAPITypeFromEntity } from "./erp-type-from-entity";
  * HTTP Client utilities
  */
 export { HTTPClientFactory } from "./http-client";
+export type { HTTPClient, HTTPRequestConfig, HTTPResponse, HTTPError } from "./http-client";
 /**
  * MM Labor Ticket utilities
  */
 export * from "./mm-labor-ticket-helpers";
+export { getErrorType } from './error-utils';
+/**
+ * MM Connector Logger utilities
+ */
+export { MMConnectorLogger, type LogResponse, type LogEntry, 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,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAC,MAAM,eAAe,CAAC;AAE3F;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC9H,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.3",
+  "version": "0.1.4-beta.0",
   "license": "MIT",
   "author": "machinemetrics",
   "main": "dist/mm-erp-sdk.js",

package/src/index.ts

@@ -48,6 +48,7 @@ export {
   formatDateWithTZOffset,
   applyTimezoneOffsetsToFields,
   convertToLocalTime,
+  getErrorType,
 } from "./utils";
 
 // Local data store
@@ -55,7 +56,7 @@ 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 type { HTTPResponse, HTTPError, HTTPClient, HTTPRequestConfig } from "./utils/http-client";
 
 // Application initialization utilities
 export { ApplicationInitializer } from "./utils/application-initializer";
@@ -71,9 +72,11 @@ 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 type {
@@ -100,3 +103,6 @@ export {
   SqlServerHelper,
 } from "./services/sql-server-erp-service";
 export type { SQLInput } from "./services/sql-server-erp-service";
+
+// MM Connector Logging
+export { MMConnectorLogger, FileLogDeduper, type LogEntry, type LogLevelString, type LogResponse } from './utils'; 

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

@@ -9,6 +9,11 @@ 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';

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[]