@machinemetrics/mm-erp-sdk 0.2.0-beta.2 → 0.3.0-beta.0

package/dist/utils/application-initializer.js

@@ -0,0 +1,55 @@
+import logger from "../services/reporting-service/logger.js";
+import { CoreConfiguration } from "../services/data-sync-service/configuration-manager.js";
+import { SQLiteCoordinator } from "../services/sqlite-service/index.js";
+import { getTimezoneOffsetAndPersist } from "./time-utils.js";
+import knex from "knex";
+import config from "../knexfile.js";
+/**
+ * Utility class to handle application initialization tasks
+ */
+export class ApplicationInitializer {
+    /**
+     * Performs all necessary application initialization tasks
+     * This should be called before starting any services or jobs
+     */
+    static async initialize() {
+        try {
+            logger.info("\n================================INITIALIZING APPLICATION================================\n");
+            // Load and validate core configuration
+            const coreConfig = CoreConfiguration.inst();
+            logger.info("Core Configuration loaded:", coreConfig.toSafeLogObject());
+            // Perform database startup checks
+            logger.info("Performing database startup checks...");
+            await SQLiteCoordinator.performStartupCheck();
+            logger.info("Database startup checks completed successfully");
+            // Run database migrations to ensure all tables exist
+            logger.info("Running database migrations...");
+            await ApplicationInitializer.runMigrations();
+            logger.info("Database migrations completed successfully");
+            // Required for most connectors
+            await getTimezoneOffsetAndPersist();
+            logger.info("\n================================APPLICATION INITIALIZATION COMPLETED================================\n");
+        }
+        catch (error) {
+            logger.error("Critical initialization failure. Exiting.", error);
+            process.exitCode = 1;
+        }
+    }
+    /**
+     * Runs database migrations to ensure all required tables exist
+     */
+    static async runMigrations() {
+        const db = knex(config.local);
+        try {
+            await db.migrate.latest();
+        }
+        catch (error) {
+            logger.error("Error running migrations:", error);
+            throw error;
+        }
+        finally {
+            await db.destroy();
+        }
+    }
+}
+//# sourceMappingURL=application-initializer.js.map

package/dist/utils/application-initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-initializer.js","sourceRoot":"","sources":["../../src/utils/application-initializer.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,yCAAyC,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,gBAAgB,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACjC;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU;QAC5B,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CACT,8FAA8F,CAC/F,CAAC;YAEF,uCAAuC;YACvC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;YAExE,kCAAkC;YAClC,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YACrD,MAAM,iBAAiB,CAAC,mBAAmB,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;YAE9D,qDAAqD;YACrD,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAC9C,MAAM,sBAAsB,CAAC,aAAa,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAE1D,+BAA+B;YAC/B,MAAM,2BAA2B,EAAE,CAAC;YAEpC,MAAM,CAAC,IAAI,CACT,0GAA0G,CAC3G,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;YACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,aAAa;QAChC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACjD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/utils/cleanup-numbers.js

@@ -0,0 +1,6 @@
+export const cleanupNumbers = (data) => {
+    // eslint-disable-next-line no-useless-escape
+    data = data.toString().replace(/[^0-9\.]+/g, "");
+    return data;
+};
+//# sourceMappingURL=cleanup-numbers.js.map

package/dist/utils/cleanup-numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-numbers.js","sourceRoot":"","sources":["../../src/utils/cleanup-numbers.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,EAAE;IAC7C,6CAA6C;IAC7C,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

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

@@ -1,4 +1,4 @@
-import { IERPConnector } from "../types/erp-connector";
+import { IERPConnector } from "../types/erp-connector.js";
 /**
  * Helper function to dynamically import and create connector instance from a file path
  * @param connectorPath - The file path to the connector module

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;AAIvD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,eAAe,MAAM,KACpB,OAAO,CAAC,aAAa,CAiCvB,CAAC"}
+{"version":3,"file":"connector-factory.d.ts","sourceRoot":"","sources":["../../src/utils/connector-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,eAAe,MAAM,KACpB,OAAO,CAAC,aAAa,CAiCvB,CAAC"}

package/dist/utils/connector-factory.js

@@ -0,0 +1,34 @@
+import logger from "../services/reporting-service/logger.js";
+import { pathToFileURL } from "url";
+/**
+ * Helper function to dynamically import and create connector instance from a file path
+ * @param connectorPath - The file path to the connector module
+ * @returns A new instance of the IERPConnector
+ */
+export const createConnectorFromPath = async (connectorPath) => {
+    try {
+        // 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 = connectorModule.default ||
+            connectorModule[Object.keys(connectorModule)[0]];
+        if (!ConnectorClass) {
+            throw new Error(`No connector class found in module: ${connectorPath}`);
+        }
+        // Create new instance of the connector
+        return new ConnectorClass();
+    }
+    catch (error) {
+        logger.error(`Failed to create connector instance from path: ${connectorPath}`, { error });
+        throw error;
+    }
+};
+//# sourceMappingURL=connector-factory.js.map

package/dist/utils/connector-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-factory.js","sourceRoot":"","sources":["../../src/utils/connector-factory.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,yCAAyC,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,aAAqB,EACG,EAAE;IAC1B,IAAI,CAAC;QACH,0FAA0F;QAC1F,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEjD,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;YACvC,aAAa;YACb,SAAS;YACT,QAAQ;YACR,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI;SAC/C,CAAC,CAAC;QAEH,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC;QAExE,yCAAyC;QACzC,MAAM,cAAc,GAClB,eAAe,CAAC,OAAO;YACvB,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,uCAAuC;QACvC,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CACV,kDAAkD,aAAa,EAAE,EACjE,EAAE,KAAK,EAAE,CACV,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { LogEntry } from './mm-connector-logger';
+import type { LogEntry } from './mm-connector-logger.js';
 /**
  * Implement a custom LogDeduper or use the provided FileLogDeduper
  */

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

@@ -1 +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"}
+{"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,0BAA0B,CAAC;AAEzE;;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/log-deduper.js

@@ -0,0 +1,240 @@
+import fs from 'fs';
+import path from 'path';
+import logger from '../../services/reporting-service/logger.js';
+/**
+ * FileLogDeduper implements the LogDeduper interface to deduplicate
+ * logs by storing them in a file; this allows deduping across jobs.
+ */
+export class FileLogDeduper {
+    storeFilePath;
+    windowMs;
+    ttlMs;
+    sweepIntervalMs;
+    lastSweepTsMs;
+    DEFAULT_WINDOW_TEN_MINS = 600;
+    DEFAULT_TTL_ONE_HOUR = 3600;
+    DEFAULT_SWEEP_INTERVAL_FIVE_MINS = 300;
+    DEFAULT_STORE_FILE_PATH = path.join('/tmp', 'log-deduplication.json');
+    /**
+     * 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 = this.DEFAULT_STORE_FILE_PATH, windowSeconds = this.DEFAULT_WINDOW_TEN_MINS, ttlSeconds = this.DEFAULT_TTL_ONE_HOUR, sweepIntervalSeconds = this.DEFAULT_SWEEP_INTERVAL_FIVE_MINS } = {}) {
+        this.storeFilePath = storeFilePath;
+        this.windowMs = Math.max(1, windowSeconds) * 1000;
+        this.ttlMs = Math.max(this.windowMs, Math.max(1, ttlSeconds) * 1000);
+        this.sweepIntervalMs = Math.max(1, sweepIntervalSeconds) * 1000;
+        this.lastSweepTsMs = 0;
+        this.ensureStoreFileExists();
+    }
+    /**
+     * 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
+    */
+    async decide(entry, now) {
+        if (!entry.dedupeKey || typeof entry.dedupeKey !== 'string' || entry.dedupeKey.trim().length === 0) {
+            throw new Error('dedupeKey is required and must be a non-empty string');
+        }
+        const key = entry.dedupeKey;
+        return this.withLock(async () => {
+            const store = this.readStore();
+            // Opportunistic eviction gated by sweep interval
+            if (now - this.lastSweepTsMs >= this.sweepIntervalMs) {
+                this.evictExpiredInStore(store, now);
+                this.lastSweepTsMs = now;
+                this.writeStore(store);
+            }
+            const existing = store[key];
+            if (existing) {
+                const withinWindow = existing.lastTransmitted > 0 && (existing.lastTransmitted + this.windowMs) > now;
+                if (withinWindow) {
+                    // Suppress and increment count
+                    store[key] = {
+                        ...existing,
+                        suppressedCount: existing.suppressedCount + 1,
+                        firstUnsentEventTs: existing.suppressedCount === 0 ? (entry.eventTime ?? now) : existing.firstUnsentEventTs,
+                        lastEventTs: entry.eventTime ?? now,
+                        level: entry.level,
+                        message: entry.message
+                    };
+                    this.writeStore(store);
+                    return null;
+                }
+                // Outside window: allow, include timestamp and prior suppression count
+                const messageToSend = this.formatMessage(entry.message, entry.eventTime ?? now, existing.suppressedCount, existing.firstUnsentEventTs);
+                store[key] = {
+                    ...existing,
+                    suppressedCount: 0,
+                    firstUnsentEventTs: 0,
+                    lastEventTs: entry.eventTime ?? now,
+                    level: entry.level,
+                    message: entry.message
+                };
+                this.writeStore(store);
+                return messageToSend;
+            }
+            // New entry: allow, timestamp, no suppression count
+            const messageToSend = this.formatMessage(entry.message, entry.eventTime ?? now, 0);
+            store[key] = {
+                lastTransmitted: 0,
+                suppressedCount: 0,
+                firstUnsentEventTs: entry.eventTime ?? now,
+                lastEventTs: entry.eventTime ?? now,
+                level: entry.level,
+                message: entry.message
+            };
+            this.writeStore(store);
+            return messageToSend;
+        });
+    }
+    async onSuccess(entry, now) {
+        if (!entry.dedupeKey || typeof entry.dedupeKey !== 'string' || entry.dedupeKey.trim().length === 0) {
+            throw new Error('dedupeKey is required and must be a non-empty string');
+        }
+        const key = entry.dedupeKey;
+        await this.withLock(async () => {
+            const store = this.readStore();
+            const existing = store[key];
+            if (existing) {
+                store[key] = {
+                    ...existing,
+                    lastTransmitted: now,
+                    firstUnsentEventTs: 0,
+                    suppressedCount: 0
+                };
+                this.writeStore(store);
+            }
+        });
+    }
+    async retryFailedTransmissions(send) {
+        // Best-effort retry: first sweep expired entries, then iterate over entries with lastTransmitted === 0
+        const now = Date.now();
+        const entries = await this.withLock(async () => {
+            const store = this.readStore();
+            // Always sweep on retry
+            this.evictExpiredInStore(store, now);
+            this.lastSweepTsMs = now;
+            this.writeStore(store);
+            return Object.entries(store)
+                .filter(([, rec]) => rec.lastTransmitted === 0)
+                .map(([key, rec]) => ({ key, rec }));
+        });
+        for (const { key, rec } of entries) {
+            try {
+                const message = this.formatMessage(rec.message, rec.lastEventTs, rec.suppressedCount, rec.firstUnsentEventTs);
+                await send({ level: rec.level, message: rec.message, dedupeKey: key, eventTime: rec.lastEventTs }, message);
+                // Mark success
+                await this.withLock(async () => {
+                    const store = this.readStore();
+                    const current = store[key];
+                    if (current) {
+                        store[key] = {
+                            ...current,
+                            lastTransmitted: Date.now(),
+                            suppressedCount: 0
+                        };
+                        this.writeStore(store);
+                    }
+                });
+            }
+            catch (err) {
+                // Leave entry for future retries; do not throw
+                logger.error('Failed to retry failed transmission', { key, rec, error: err });
+                return;
+            }
+        }
+    }
+    // --- Internals ---
+    ensureStoreFileExists() {
+        try {
+            if (!fs.existsSync(this.storeFilePath)) {
+                fs.writeFileSync(this.storeFilePath, JSON.stringify({}), 'utf-8');
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    readStore() {
+        try {
+            if (!fs.existsSync(this.storeFilePath))
+                return {};
+            const content = fs.readFileSync(this.storeFilePath, 'utf-8');
+            return content ? JSON.parse(content) : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    writeStore(store) {
+        try {
+            fs.writeFileSync(this.storeFilePath, JSON.stringify(store, null, 2), 'utf-8');
+        }
+        catch {
+            // ignore
+        }
+    }
+    formatMessage(message, eventTs, suppressedCount, firstUnsentEventTs) {
+        const timestamp = new Date(eventTs).toISOString();
+        const base = `${timestamp} | ${message}`;
+        if (suppressedCount > 0) {
+            const since = firstUnsentEventTs && firstUnsentEventTs > 0 ? ` since ${new Date(firstUnsentEventTs).toISOString()}` : '';
+            return `${base} (${suppressedCount} suppressed${since})`;
+        }
+        return base;
+    }
+    async withLock(fn) {
+        const lockPath = `${this.storeFilePath}.lock`;
+        const start = Date.now();
+        // Try to acquire the lock with retries (best effort)
+        // Avoid infinite waits; cap at ~3 seconds
+        while (true) {
+            try {
+                const fd = fs.openSync(lockPath, 'wx');
+                try {
+                    const result = await fn();
+                    return result;
+                }
+                finally {
+                    try {
+                        fs.closeSync(fd);
+                    }
+                    catch { /* ignore */ }
+                    try {
+                        fs.unlinkSync(lockPath);
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            catch {
+                // Lock exists
+                if (Date.now() - start > 3000) {
+                    // Timed out; proceed without lock to avoid deadlock
+                    return await fn();
+                }
+                await new Promise(resolve => setTimeout(resolve, 50));
+            }
+        }
+    }
+    /**
+     * Evict expired entries from the store based on the TTL and the key's last transmitted time
+     */
+    evictExpiredInStore(store, now) {
+        const keys = Object.keys(store);
+        if (keys.length === 0)
+            return;
+        for (const key of keys) {
+            const rec = store[key];
+            const referenceTs = rec.lastTransmitted > 0 ? rec.lastTransmitted : rec.lastEventTs;
+            if (now - referenceTs > this.ttlMs) {
+                delete store[key];
+            }
+        }
+    }
+}
+//# sourceMappingURL=log-deduper.js.map

package/dist/utils/connector-log/log-deduper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-deduper.js","sourceRoot":"","sources":["../../../src/utils/connector-log/log-deduper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,4CAA4C,CAAC;AA4BhE;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,aAAa,CAAS;IACtB,QAAQ,CAAS;IACjB,KAAK,CAAS;IACd,eAAe,CAAS;IACjC,aAAa,CAAS;IAEb,uBAAuB,GAAG,GAAG,CAAC;IAC9B,oBAAoB,GAAG,IAAI,CAAC;IAC5B,gCAAgC,GAAG,GAAG,CAAC;IACvC,uBAAuB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAEvF;;;;;;;OAOG;IACH,YAAY,EACV,aAAa,GAAG,IAAI,CAAC,uBAAuB,EAC5C,aAAa,GAAG,IAAI,CAAC,uBAAuB,EAC5C,UAAU,GAAG,IAAI,CAAC,oBAAoB,EACtC,oBAAoB,GAAG,IAAI,CAAC,gCAAgC,KAM1D,EAAE;QAEJ,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,GAAG,IAAI,CAAC;QAChE,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QAEvB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAED;;;;MAIE;IACF,KAAK,CAAC,MAAM,CAAC,KAAe,EAAE,GAAW;QACvC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnG,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;QAE5B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAE/B,iDAAiD;YACjD,IAAI,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrD,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACrC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;gBACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YAE5B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;gBACtG,IAAI,YAAY,EAAE,CAAC;oBACjB,+BAA+B;oBAC/B,KAAK,CAAC,GAAG,CAAC,GAAG;wBACX,GAAG,QAAQ;wBACX,eAAe,EAAE,QAAQ,CAAC,eAAe,GAAG,CAAC;wBAC7C,kBAAkB,EAAE,QAAQ,CAAC,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB;wBAC3G,WAAW,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;wBACnC,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;qBACvB,CAAC;oBACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBACvB,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,uEAAuE;gBACvE,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBACvI,KAAK,CAAC,GAAG,CAAC,GAAG;oBACX,GAAG,QAAQ;oBACX,eAAe,EAAE,CAAC;oBAClB,kBAAkB,EAAE,CAAC;oBACrB,WAAW,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;oBACnC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC;gBACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACvB,OAAO,aAAa,CAAC;YACvB,CAAC;YAED,oDAAoD;YACpD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YACnF,KAAK,CAAC,GAAG,CAAC,GAAG;gBACX,eAAe,EAAE,CAAC;gBAClB,eAAe,EAAE,CAAC;gBAClB,kBAAkB,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;gBAC1C,WAAW,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;gBACnC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,aAAa,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAe,EAAE,GAAW;QAC1C,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnG,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;QAE5B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,GAAG,CAAC,GAAG;oBACX,GAAG,QAAQ;oBACX,eAAe,EAAE,GAAG;oBACpB,kBAAkB,EAAE,CAAC;oBACrB,eAAe,EAAE,CAAC;iBACnB,CAAC;gBACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,IAAyD;QACtF,uGAAuG;QACvG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,wBAAwB;YACxB,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;iBACzB,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,CAAC;iBAC9C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,eAAe,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAC9G,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC5G,eAAe;gBACf,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;oBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC3B,IAAI,OAAO,EAAE,CAAC;wBACZ,KAAK,CAAC,GAAG,CAAC,GAAG;4BACX,GAAG,OAAO;4BACV,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE;4BAC3B,eAAe,EAAE,CAAC;yBACnB,CAAC;wBACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+CAA+C;gBAC/C,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC9E,OAAO;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IAEZ,qBAAqB;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC7D,OAAO,OAAO,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAqB;QACtC,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAe,EAAE,OAAe,EAAE,eAAuB,EAAE,kBAA2B;QAC1G,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,GAAG,SAAS,MAAM,OAAO,EAAE,CAAC;QACzC,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,kBAAkB,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzH,OAAO,GAAG,IAAI,KAAK,eAAe,cAAc,KAAK,GAAG,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAI,EAAoB;QAC5C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,aAAa,OAAO,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,qDAAqD;QACrD,0CAA0C;QAC1C,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;oBAC1B,OAAO,MAAM,CAAC;gBAChB,CAAC;wBAAS,CAAC;oBACT,IAAI,CAAC;wBAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAA,YAAY,CAAA,CAAC;oBAC9C,IAAI,CAAC;wBAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAA,YAAY,CAAA,CAAC;gBACvD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;gBACd,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,EAAE,CAAC;oBAC9B,oDAAoD;oBACpD,OAAO,MAAM,EAAE,EAAE,CAAC;gBACpB,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,KAAqB,EAAE,GAAW;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACvB,MAAM,WAAW,GAAG,GAAG,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;YACpF,IAAI,GAAG,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBACnC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=mm-connector-logger-example.d.ts.map

package/dist/utils/connector-log/mm-connector-logger-example.js

@@ -0,0 +1,88 @@
+// import { FileLogDeduper } from './log-deduper';
+// import { MMConnectorLogger, LogEntry } from './mm-connector-logger';
+// import { HTTPError } from '../http-client';
+// import { getErrorType } from '../error-utils';
+// /**
+//  * Example usage of the MM Connector Logger with deduplication
+//  * 
+//  * This example demonstrates how to use the MMConnectorLogger class to send
+//  * progress updates and error logs to the MM cloud. Deduplication is configured
+//  * via environment variables and applied consistently to all log messages.
+//  */
+export {};
+// async function exampleUsage() {
+//   // Initialize logger with source identifier and deduplication settings
+//   const logger = new MMConnectorLogger('proshop', new FileLogDeduper({ 
+//     windowSeconds: 300,    // 5 minute deduplication window
+//     ttlSeconds: 3600,      // 1 hour TTL for store cleanup
+//     sweepIntervalSeconds: 600  // 10 minute sweep interval
+//   }));
+//   try {
+//     // Sends initial sync start message
+//     await logger.sendLog(new LogEntry({
+//       level: 'info',
+//       dedupeKey: 'SyncStart',
+//       message: 'Starting sync process'
+//     }));
+//     // Simulates some work with progress updates
+//     for (let i = 1; i <= 3; i++) {
+//       await logger.sendLog(new LogEntry({
+//         level: 'info',
+//         dedupeKey: 'SyncProgress',
+//         message: `Processing batch ${i}/3`
+//       }));
+//       await new Promise(resolve => setTimeout(resolve, 100)); // Simulate work
+//     }
+//     // Sends completion message
+//     await logger.sendLog(new LogEntry({
+//       level: 'info',
+//       dedupeKey: 'SyncComplete',
+//       message: 'Sync process completed successfully'
+//     }));
+//     // Demonstrates error logging with error type extraction
+//     try {
+//       throw new Error('Simulated database connection failure');
+//     } catch (error) {
+//       const errorType = getErrorType(error);
+//       await logger.sendLog(new LogEntry({
+//         level: 'error',
+//         dedupeKey: `DatabaseError_${errorType}`,
+//         message: `Database operation failed: ${error instanceof Error ? error.message : 'Unknown error'}`
+//       }));
+//     }
+//     // Demonstrates getErrorType with different error types
+//     const httpError = new HTTPError('Bad Request', 400, 'INVALID_REQUEST');
+//     const errorTypeFromCode = getErrorType(httpError); // Returns 'INVALID_REQUEST'
+//     const typeError = new TypeError('Cannot read property of undefined');
+//     const errorTypeFromName = getErrorType(typeError); // Returns 'TypeError'
+//     await logger.sendLog(new LogEntry({
+//       level: 'error',
+//       dedupeKey: `HTTPError_${errorTypeFromCode}`,
+//       message: `HTTP request failed with code: ${errorTypeFromCode}`
+//     }));
+//     await logger.sendLog(new LogEntry({
+//       level: 'error',
+//       dedupeKey: `TypeError_${errorTypeFromName}`,
+//       message: `Type error occurred: ${errorTypeFromName}`
+//     }));
+//     // Demonstrate deduplication - this message will be suppressed if sent within 5 minutes
+//     await logger.sendLog(new LogEntry({
+//       level: 'warn',
+//       dedupeKey: 'RateLimit',
+//       message: 'API rate limit approaching'
+//     }));
+//     await logger.sendLog(new LogEntry({
+//       level: 'warn',
+//       dedupeKey: 'RateLimit',
+//       message: 'API rate limit approaching'
+//     })); // This will be deduplicated
+//     // Retry any failed transmissions
+//     await logger.retryFailedTransmissions();
+//   } catch (error) {
+//     console.error('Failed to send logs:', error);
+//   } finally {
+//     // Clean up resources
+//     await logger.destroy();
+//   }
+// }
+//# sourceMappingURL=mm-connector-logger-example.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mm-connector-logger-example.js","sourceRoot":"","sources":["../../../src/utils/connector-log/mm-connector-logger-example.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uEAAuE;AACvE,8CAA8C;AAC9C,iDAAiD;AACjD,MAAM;AACN,iEAAiE;AACjE,MAAM;AACN,8EAA8E;AAC9E,kFAAkF;AAClF,6EAA6E;AAC7E,MAAM;;AAEN,kCAAkC;AAClC,2EAA2E;AAC3E,0EAA0E;AAC1E,8DAA8D;AAC9D,6DAA6D;AAC7D,6DAA6D;AAC7D,SAAS;AAET,UAAU;AACV,0CAA0C;AAC1C,0CAA0C;AAC1C,uBAAuB;AACvB,gCAAgC;AAChC,yCAAyC;AACzC,WAAW;AAEX,mDAAmD;AACnD,qCAAqC;AACrC,4CAA4C;AAC5C,yBAAyB;AACzB,qCAAqC;AACrC,6CAA6C;AAC7C,aAAa;AACb,iFAAiF;AACjF,QAAQ;AAER,kCAAkC;AAClC,0CAA0C;AAC1C,uBAAuB;AACvB,mCAAmC;AACnC,uDAAuD;AACvD,WAAW;AAEX,+DAA+D;AAC/D,YAAY;AACZ,kEAAkE;AAClE,wBAAwB;AACxB,+CAA+C;AAC/C,4CAA4C;AAC5C,0BAA0B;AAC1B,mDAAmD;AACnD,4GAA4G;AAC5G,aAAa;AACb,QAAQ;AAER,8DAA8D;AAC9D,8EAA8E;AAC9E,sFAAsF;AAEtF,4EAA4E;AAC5E,gFAAgF;AAEhF,0CAA0C;AAC1C,wBAAwB;AACxB,qDAAqD;AACrD,uEAAuE;AACvE,WAAW;AACX,0CAA0C;AAC1C,wBAAwB;AACxB,qDAAqD;AACrD,6DAA6D;AAC7D,WAAW;AAEX,8FAA8F;AAC9F,0CAA0C;AAC1C,uBAAuB;AACvB,gCAAgC;AAChC,8CAA8C;AAC9C,WAAW;AACX,0CAA0C;AAC1C,uBAAuB;AACvB,gCAAgC;AAChC,8CAA8C;AAC9C,wCAAwC;AAExC,wCAAwC;AACxC,+CAA+C;AAE/C,sBAAsB;AACtB,oDAAoD;AACpD,gBAAgB;AAChB,4BAA4B;AAC5B,8BAA8B;AAC9B,MAAM;AACN,IAAI"}

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

@@ -1,4 +1,4 @@
-import type { LogDeduper } from './log-deduper';
+import type { LogDeduper } from './log-deduper.js';
 export type LogLevelString = 'info' | 'warn' | 'error';
 /**
  * dedupeKey - key used to deduplicate log entries when a LogDeduper is injected into the MMConnectorLogger

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

@@ -1 +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"}
+{"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,kBAAkB,CAAC;AAEnD,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"}