@machinemetrics/mm-erp-sdk 0.1.8-beta.9 → 0.1.8

package/README.md

@@ -25,19 +25,17 @@ npm install mm-erp-sdk
 import {
   IERPConnector,
   IERPLaborTicketHandler,
-  ERPType,
   ERPObjType,
   MMReceiveLaborTicket,
   ApplicationInitializer,
   runDataSyncService,
-  registerERPConnector,
 } from "mm-erp-sdk";
 
 export default class MyERPConnector
   implements IERPConnector, IERPLaborTicketHandler
 {
-  get type(): ERPType {
-    return ERPType.JOB_BOSS; // or your ERP type
+  get type(): string {
+    return "JOB_BOSS"; // replace with your ERP type
   }
 
   async startUp(): Promise<void> {
@@ -72,9 +70,6 @@ export default class MyERPConnector
 
   // Implement other required methods...
 }
-
-// Register your connector
-registerERPConnector(ERPType.JOB_BOSS, () => new MyERPConnector());
 ```
 
 ### 3. Start the Data Sync Service
@@ -144,4 +139,4 @@ LOG_LEVEL="info"
 - `RestAPIService`: HTTP API client
 - `MMApiClient`: MachineMetrics API client
 
-For detailed API documentation, see the TypeScript definitions. # mm-erp-sdk
+For detailed API documentation, see the TypeScript definitions.

package/dist/{hashed-cache-manager-B1hPBNnF.js → hashed-cache-manager-Ds-HksA0.js}

@@ -4,7 +4,7 @@ import stringify from "json-stable-stringify";
 import XXH from "xxhashjs";
 import "./config-cB7h4yvc.js";
 import { c as configureLogger, l as logger } from "./logger-CBDNtsMq.js";
-import "./index-DCgheVjV.js";
+import "./index-DTtmv8Iq.js";
 class CoreConfiguration {
   static instance;
   // General Configuration
@@ -53,6 +53,36 @@ class CoreConfiguration {
     }
     return CoreConfiguration.instance;
   }
+  /**
+   * Returns a sanitized version of the configuration for safe logging.
+   * Masks sensitive fields like authentication tokens.
+   */
+  toSafeLogObject() {
+    const maskSensitiveValue = (value) => {
+      if (!value || value.length === 0) {
+        return "";
+      }
+      if (value.length < 6) {
+        return "********";
+      }
+      return value.substring(0, 3) + "********" + value.substring(value.length - 3);
+    };
+    return {
+      logLevel: this.logLevel,
+      erpSystem: this.erpSystem,
+      nodeEnv: this.nodeEnv,
+      mmERPSvcApiBaseUrl: this.mmERPSvcApiBaseUrl,
+      mmApiBaseUrl: this.mmApiBaseUrl,
+      mmApiAuthToken: maskSensitiveValue(this.mmApiAuthToken),
+      mmApiRetryAttempts: this.mmApiRetryAttempts,
+      cacheTTL: this.cacheTTL,
+      erpApiPagingLimit: this.erpApiPagingLimit,
+      fromErpInterval: this.fromErpInterval,
+      toErpInterval: this.toErpInterval,
+      retryLaborTicketsInterval: this.retryLaborTicketsInterval,
+      cacheExpirationCheckInterval: this.cacheExpirationCheckInterval
+    };
+  }
 }
 const getSQLServerConfiguration = () => {
   return {
@@ -289,4 +319,4 @@ export {
   getSQLServerConfiguration as a,
   getErpApiConnectionParams as g
 };
-//# sourceMappingURL=hashed-cache-manager-B1hPBNnF.js.map
+//# sourceMappingURL=hashed-cache-manager-Ds-HksA0.js.map

package/dist/hashed-cache-manager-Ds-HksA0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashed-cache-manager-Ds-HksA0.js","sources":["../src/services/data-sync-service/configuration-manager.ts","../src/services/caching-service/hashed-cache-manager.ts"],"sourcesContent":["import \"dotenv/config\";\nimport { configureLogger } from \"../reporting-service/logger\";\nimport { SQLServerConfiguration } from \"../sql-server-erp-service/configuration\";\n\nexport class CoreConfiguration {\n  private static instance: CoreConfiguration;\n\n  // General Configuration\n  public readonly logLevel: string;\n  public readonly erpSystem: string;\n  public readonly nodeEnv: string;\n\n  // MM API (aka \"Mapping\") Service\n  public readonly mmERPSvcApiBaseUrl: string;\n  public readonly mmApiBaseUrl: string;\n  public readonly mmApiAuthToken: string;\n  public readonly mmApiRetryAttempts: number;\n\n  // Caching (optionally used for interacting with the MM API)\n  public readonly cacheTTL: number;\n\n  // ERP API Service\n  public readonly erpApiPagingLimit: number; //Pagination limit for ERP API\n\n  // Job timing Intervals\n  public readonly fromErpInterval: string;\n  public readonly toErpInterval: string;\n  public readonly retryLaborTicketsInterval: string;\n  public readonly cacheExpirationCheckInterval: string;\n\n  private constructor() {\n    this.logLevel = process.env.LOG_LEVEL || \"info\";\n    this.erpSystem = process.env.ERP_SYSTEM || \"template\";\n    this.nodeEnv = process.env.NODE_ENV || \"development\";\n\n    //#region MM API (aka \"Mapping\") Service\n    /**\n     * MM ERP Service REST API URL (typically https://erp-api.svc.machinemetrics.com)\n     */\n    this.mmERPSvcApiBaseUrl = process.env.MM_MAPPING_SERVICE_URL || \"\";\n\n    /**\n     * MM REST API URL  (typically https://api.machinemetrics.com)\n     */\n    console.log(\"=== CONFIG DEBUG ===\");\n    console.log(\"MM_MAPPING_AUTH_SERVICE_URL env var:\", process.env.MM_MAPPING_AUTH_SERVICE_URL);\n    this.mmApiBaseUrl = process.env.MM_MAPPING_AUTH_SERVICE_URL || \"\";\n    console.log(\"mmApiBaseUrl set to:\", this.mmApiBaseUrl);\n    console.log(\"=== END CONFIG DEBUG ===\");\n\n    /**\n     * Company Auth Token\n     */\n    this.mmApiAuthToken = process.env.MM_MAPPING_SERVICE_TOKEN || \"\";\n\n    /**\n     * Number of retry attempts for MM API calls\n     */\n    this.mmApiRetryAttempts = parseInt(process.env.RETRY_ATTEMPTS || \"0\");\n    //#endregion MM API (aka \"Mapping\") Service\n\n    /**\n     * Default pagination limit for ERP API\n     */\n    this.erpApiPagingLimit = parseInt(process.env.ERP_PAGINATION_LIMIT || \"0\");\n    //#endregion ERP API Service\n\n    /**\n     * For how to define the intervals, see Bree's documentation: https://github.com/breejs/bree\n     */\n    this.fromErpInterval =\n      process.env.FROM_ERP_INTERVAL || process.env.POLL_INTERVAL || \"5 min\";\n    this.toErpInterval = process.env.TO_ERP_INTERVAL || \"5 min\";\n    this.retryLaborTicketsInterval =\n      process.env.RETRY_LABOR_TICKETS_INTERVAL || \"30 min\";\n    this.cacheExpirationCheckInterval =\n      process.env.CACHE_EXPIRATION_CHECK_INTERVAL || \"5 min\";\n\n    /**\n     * Cache TTL (in seconds)\n     */\n    const cacheTTLDef = 7 * 24 * 60 * 60; // 7 days\n    this.cacheTTL = parseInt(process.env.CACHE_TTL || cacheTTLDef.toString());\n\n    // Configure the logger with our settings\n    configureLogger(this.logLevel, this.nodeEnv);\n  }\n\n  public static inst(): CoreConfiguration {\n    if (!CoreConfiguration.instance) {\n      CoreConfiguration.instance = new CoreConfiguration();\n    }\n    return CoreConfiguration.instance;\n  }\n\n  /**\n   * Returns a sanitized version of the configuration for safe logging.\n   * Masks sensitive fields like authentication tokens.\n   */\n  public toSafeLogObject(): Record<string, unknown> {\n    const maskSensitiveValue = (value: string): string => {\n      if (!value || value.length === 0) {\n        return \"\";\n      }\n      if (value.length < 6) {\n        return \"********\";\n      }\n      // Show first 3 and last 3 characters, mask the middle\n      return value.substring(0, 3) + \"********\" + value.substring(value.length - 3);\n    };\n\n    return {\n      logLevel: this.logLevel,\n      erpSystem: this.erpSystem,\n      nodeEnv: this.nodeEnv,\n      mmERPSvcApiBaseUrl: this.mmERPSvcApiBaseUrl,\n      mmApiBaseUrl: this.mmApiBaseUrl,\n      mmApiAuthToken: maskSensitiveValue(this.mmApiAuthToken),\n      mmApiRetryAttempts: this.mmApiRetryAttempts,\n      cacheTTL: this.cacheTTL,\n      erpApiPagingLimit: this.erpApiPagingLimit,\n      fromErpInterval: this.fromErpInterval,\n      toErpInterval: this.toErpInterval,\n      retryLaborTicketsInterval: this.retryLaborTicketsInterval,\n      cacheExpirationCheckInterval: this.cacheExpirationCheckInterval,\n    };\n  }\n}\n\n/**\n * Helper function to get the SQL Server Configuration for collectors that use SQL Server to interact with the ERP\n */\nexport const getSQLServerConfiguration = (): SQLServerConfiguration => {\n  return {\n    username: process.env.ERP_SQLSERVER_USERNAME || \"\",\n    password: process.env.ERP_SQLSERVER_PASSWORD || \"\",\n    database: process.env.ERP_SQLSERVER_DATABASE || \"\",\n    host:\n      process.env.ERP_SQLSERVER_HOST || process.env.ERP_SQLSERVER_SERVER || \"\",\n    port: process.env.ERP_SQLSERVER_PORT || \"1433\",\n    connectionTimeout: process.env.ERP_SQLSERVER_CONNECTION_TIMEOUT || \"30000\",\n    requestTimeout: process.env.ERP_SQLSERVER_REQUEST_TIMEOUT || \"60000\",\n    poolMax: process.env.ERP_SQLSERVER_MAX || \"10\",\n    poolMin: process.env.ERP_SQLSERVER_MIN || \"0\",\n    idleTimeoutMillis:\n      process.env.ERP_SQLSERVER_IDLE_TIMEOUT_MMILLIS || \"30000\",\n    encrypt: process.env.ERP_SQLSERVER_ENCRYPT === \"true\",\n    trustServer: process.env.ERP_SQLSERVER_TRUST_SERVER === \"true\",\n  };\n};\n\n/**\n * Parameters required to connect to an ERP system via its API.\n * Contains all the necessary settings to establish a connection and authenticate with an ERP system's API.\n */\nexport class ErpApiConnectionParams {\n  constructor(\n    public readonly erpApiUrl: string, // Base url of ERP\n    public readonly erpApiClientId: string, // Client ID to authenticate with ERP\n    public readonly erpApiClientSecret: string, // Client Secret to authenticate with ERP\n    public readonly erpApiOrganizationId: string, // Organization / tenant Id\n    public readonly erpAuthBaseUrl: string, // Auth base url\n    public readonly retryAttempts: number = 3 // Number of retry attempts for API calls\n  ) {}\n}\n\n/**\n * Helper function to get the ERP API Connection Parameters\n * Not all connectors use these, but keeping these commonly values in one place may\n * make it easier to set and understand env var names set in App.\n */\nexport const getErpApiConnectionParams = (): ErpApiConnectionParams => {\n  return new ErpApiConnectionParams(\n    process.env.ERP_API_URL || \"\",\n    process.env.ERP_API_CLIENT_ID || \"\",\n    process.env.ERP_API_CLIENT_SECRET || \"\",\n    process.env.ERP_API_ORGANIZATION_ID || \"\",\n    process.env.ERP_AUTH_BASE_URL || \"\",\n    parseInt(process.env.ERP_API_RETRY_ATTEMPTS || \"3\")\n  );\n};\n","import knex, { Knex } from \"knex\";\nimport config from \"../../knexfile\";\nimport stringify from \"json-stable-stringify\";\nimport XXH from \"xxhashjs\";\nimport { ERPObjType } from \"../../types/erp-types\";\nimport { CacheMetrics } from \"./index\";\nimport { CoreConfiguration } from \"../data-sync-service/configuration-manager\";\nimport { logger } from \"../reporting-service\";\n\ntype HashedCacheManagerOptions = {\n  ttl?: number;\n  tableName?: string;\n};\n\nexport class HashedCacheManager {\n  private static TABLE_NAME = \"sdk_cache\";\n  private db: Knex;\n  private options: HashedCacheManagerOptions;\n  private static readonly SEED = 0xabcd; // Arbitrary seed for hashing\n  private isDestroyed: boolean = false;\n  private metrics: CacheMetrics = {\n    recordCounts: {},\n  };\n\n  constructor(options?: HashedCacheManagerOptions) {\n    this.options = {\n      ttl: options?.ttl || CoreConfiguration.inst().cacheTTL,\n      tableName: options?.tableName || HashedCacheManager.TABLE_NAME,\n    };\n    this.db = knex({\n      ...config.local,\n      pool: {\n        min: 0,\n        max: 10,\n      },\n    });\n  }\n\n  /**\n   * Checks if the cache manager is still valid\n   * @throws Error if the cache manager has been destroyed\n   */\n  private checkValid(): void {\n    if (this.isDestroyed) {\n      throw new Error(\"Cache manager has been destroyed\");\n    }\n  }\n\n  /**\n   * Generates a stable hash of a record using JSON stringify + xxhash\n   */\n  public static hashRecord(record: object): string {\n    try {\n      const serialized = stringify(record);\n      if (!serialized) {\n        throw new Error(\"Failed to serialize record for hashing\");\n      }\n      const hash = XXH.h64(serialized, HashedCacheManager.SEED).toString(16);\n      return hash;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"circular\")) {\n        throw new Error(\"Failed to serialize record for hashing\");\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Gets a record from the cache\n   * @param type The type of record\n   * @param hash The hash of the record\n   * @returns The record if it exists, null otherwise\n   */\n  private async getRecord(\n    type: ERPObjType,\n    hash: string\n  ): Promise<{ key: string } | null> {\n    this.checkValid();\n    return this.db(this.options.tableName)\n      .select(\"key\")\n      .where({ type, key: hash })\n      .first();\n  }\n\n  /**\n   * Stores a record in the cache\n   * @param type The type of record\n   * @param record The record to store\n   * @returns true if a new record was created, false if an existing record was updated\n   */\n  public async store(type: ERPObjType, record: object): Promise<boolean> {\n    if (!this.isDestroyed && record) {\n      try {\n        const hash = HashedCacheManager.hashRecord(record);\n        const now = new Date();\n\n        // First check if record exists with same type and hash\n        const existing = await this.db(this.options.tableName)\n          .where({\n            type,\n            key: hash,\n          })\n          .first();\n\n        if (existing) {\n          return false; // No need to update, hash hasn't changed\n        } else {\n          // Insert new record with minimal data\n          const result = await this.db(this.options.tableName)\n            .insert({\n              type,\n              key: hash,\n              created_at: now,\n            })\n            .returning(\"id\");\n          return result.length > 0;\n        }\n      } catch (error) {\n        logger.error(\"Error storing record:\", error);\n        throw error;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Checks if a record has changed since last seen\n   * @param type The type of record\n   * @param record The record to check\n   * @returns true if the record has changed or is new\n   */\n  async hasChanged(type: ERPObjType, record: object): Promise<boolean> {\n    this.checkValid();\n    const newHash = HashedCacheManager.hashRecord(record);\n    const existing = await this.getRecord(type, newHash);\n    return !existing;\n  }\n\n  /**\n   * Checks if a record has changed and stores it if it has\n   * @param type The type of record\n   * @param record The record to check and store\n   * @returns true if the record was changed or is new\n   */\n  async upsert(type: ERPObjType, record: object): Promise<boolean> {\n    this.checkValid();\n    const hasChanged = await this.hasChanged(type, record);\n    if (hasChanged) {\n      await this.store(type, record as Record<string, unknown>);\n    }\n    return hasChanged;\n  }\n\n  /**\n   * Removes expired records based on TTL\n   */\n  async removeExpiredObjects(): Promise<void> {\n    this.checkValid();\n    const ttl = this.options.ttl;\n    if (!ttl) return;\n\n    const ttlMilliseconds = ttl * 1000;\n    const expirationLimitDate = new Date(Date.now() - ttlMilliseconds);\n    const expirationLimit = expirationLimitDate\n      .toISOString()\n      .slice(0, 19)\n      .replace(\"T\", \" \");\n\n    await this.db(this.options.tableName)\n      .where(\"created_at\", \"<\", expirationLimit)\n      .del();\n  }\n\n  /**\n   * Gets all records of a specific type\n   */\n  async getRecordsByType(type: ERPObjType): Promise<string[]> {\n    this.checkValid();\n    const records = await this.db(this.options.tableName)\n      .select(\"key\")\n      .where({ type });\n\n    return records.map((record) => record.key);\n  }\n\n  /**\n   * Removes all records of a specific type\n   */\n  async removeRecordsByType(type: ERPObjType): Promise<void> {\n    this.checkValid();\n    await this.db(this.options.tableName).where({ type }).del();\n  }\n\n  /**\n   * Removes a specific record\n   */\n  public async removeRecord(type: ERPObjType, record: object): Promise<void> {\n    if (!this.isDestroyed) {\n      try {\n        const hash = HashedCacheManager.hashRecord(record);\n        await this.db(this.options.tableName)\n          .where({ type, key: hash }) // Use key for deletion\n          .del();\n      } catch (error) {\n        logger.error(\"Error removing record:\", error);\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Clears all records from the cache\n   */\n  async clear(): Promise<void> {\n    this.checkValid();\n    await this.db(this.options.tableName).del();\n  }\n\n  /**\n   * Cleans up database connection and marks the cache manager as destroyed\n   */\n  async destroy(): Promise<void> {\n    if (!this.isDestroyed) {\n      await this.db.destroy();\n      this.isDestroyed = true;\n    }\n  }\n\n  /**\n   * Gets the current cache metrics\n   * @returns The current cache metrics\n   */\n  async getMetrics(): Promise<CacheMetrics> {\n    this.checkValid();\n\n    // Get counts for each type\n    const counts = (await this.db(this.options.tableName)\n      .select(\"type\")\n      .count(\"* as count\")\n      .groupBy(\"type\")) as Array<{ type: string; count: string }>;\n\n    // Update metrics\n    this.metrics.recordCounts = counts.reduce(\n      (acc, row) => {\n        acc[row.type] = parseInt(row.count, 10);\n        return acc;\n      },\n      {} as Record<string, number>\n    );\n\n    return this.metrics;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/{index-DCgheVjV.js → index-DTtmv8Iq.js}

@@ -52,6 +52,15 @@ const setTimezoneOffsetInCache = (offset) => {
   data.timezoneOffset = offset;
   writeStorage(data);
 };
+const getCachedTimezoneName = () => {
+  const data = readStorage();
+  return data.timezoneName ?? null;
+};
+const setTimezoneNameInCache = (timezone) => {
+  const data = readStorage();
+  data.timezoneName = timezone;
+  writeStorage(data);
+};
 const getCachedMMToken = () => {
   const data = readStorage();
   return data.mmApiToken ?? null;
@@ -172,10 +181,12 @@ class SQLiteCoordinator {
 export {
   SQLiteCoordinator as S,
   setTimezoneOffsetInCache as a,
-  getCachedTimezoneOffset as b,
-  getInitialLoadComplete as c,
-  setInitialLoadComplete as d,
+  setTimezoneNameInCache as b,
+  getCachedTimezoneOffset as c,
+  getInitialLoadComplete as d,
+  setInitialLoadComplete as e,
+  getCachedTimezoneName as f,
   getCachedMMToken as g,
   setCachedMMToken as s
 };
-//# sourceMappingURL=index-DCgheVjV.js.map
+//# sourceMappingURL=index-DTtmv8Iq.js.map

package/dist/index-DTtmv8Iq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DTtmv8Iq.js","sources":["../src/utils/local-data-store/jobs-shared-data.ts","../src/utils/local-data-store/database-lock.ts","../src/services/sqlite-service/sqlite-coordinator.ts"],"sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport { mkdirSync } from \"fs\";\n\n/**\n * This file contains the logic for storing and retrieving data from the job state file.\n * It is used to store data that is shared between jobs, and (more importantly) across job instances.\n */\n\nconst STORAGE_FILE = path.join(\"/tmp\", \"job-state.json\");\n\n// Ensure parent directory exists\nconst parentDir = path.dirname(STORAGE_FILE);\ntry {\n  mkdirSync(parentDir, { recursive: true });\n} catch (error) {\n  if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n    throw error;\n  }\n}\n\n//#region Non-exported functions\nconst ensureStorageFile = () => {\n  if (!fs.existsSync(STORAGE_FILE)) {\n    fs.writeFileSync(STORAGE_FILE, JSON.stringify({}), \"utf-8\");\n  }\n};\n\nconst readStorage = (): Record<string, unknown> => {\n  ensureStorageFile();\n  try {\n    return JSON.parse(fs.readFileSync(STORAGE_FILE, \"utf-8\"));\n  } catch (error) {\n    console.error(`Failed to read storage from ${STORAGE_FILE}:`, error);\n    return {};\n  }\n};\n\nconst writeStorage = (data: Record<string, unknown>): void => {\n  ensureStorageFile();\n  fs.writeFileSync(STORAGE_FILE, JSON.stringify(data, null, 2), \"utf-8\");\n};\n//#endregion\n\n//#region Database lock storage functions\n/**\n * Reads the database lock state from the shared storage file\n * @returns The data stored in the file\n */\nexport const readDatabaseLockState = (): Record<string, unknown> => {\n  return readStorage();\n};\n\n/**\n * Writes the database lock state to the shared storage file\n * @param data The lock state data to write\n */\nexport const writeDatabaseLockState = (data: Record<string, unknown>): void => {\n  writeStorage(data);\n};\n//#endregion\n\nexport const getInitialLoadComplete = (): boolean => {\n  const data = readStorage();\n  return (data.initialLoadComplete as boolean) ?? false;\n};\n\nexport const setInitialLoadComplete = (complete: boolean): void => {\n  const data = readStorage();\n  data.initialLoadComplete = complete;\n  writeStorage(data);\n};\n\n/**\n * Gets the company's cached current timezone offset (e.g., -5)\n * @returns The cached timezone offset or 0 if not found\n */\nexport const getCachedTimezoneOffset = (): number => {\n  const data = readStorage();\n  return (data.timezoneOffset as number) ?? 0;\n};\n\n/**\n * Sets the company's current timezone offset in the cache\n * @param offset The timezone offset in hours\n */\nexport const setTimezoneOffsetInCache = (offset: number): void => {\n  const data = readStorage();\n  data.timezoneOffset = offset;\n  writeStorage(data);\n};\n\n/**\n * Gets the cached timezone name (e.g., \"America/New_York\")\n * @returns The cached timezone name or null if not found\n */\nexport const getCachedTimezoneName = (): string | null => {\n  const data = readStorage();\n  return (data.timezoneName as string) ?? null;\n};\n\n/**\n * Sets the timezone name in the cache\n * @param timezone The timezone name (e.g., \"America/New_York\")\n */\nexport const setTimezoneNameInCache = (timezone: string): void => {\n  const data = readStorage();\n  data.timezoneName = timezone;\n  writeStorage(data);\n};\n\ninterface CachedToken {\n  token: string;\n  expiration: number | null;\n}\n\n/**\n * Gets the cached MM API token and its expiration\n * @returns The cached token and expiration or null if not found\n */\nexport const getCachedMMToken = (): CachedToken | null => {\n  const data = readStorage();\n  return (data.mmApiToken as CachedToken) ?? null;\n};\n\n/**\n * Sets the MM API token and its expiration in the cache\n * @param tokenData The token and expiration to cache\n */\nexport const setCachedMMToken = (tokenData: CachedToken): void => {\n  const data = readStorage();\n  data.mmApiToken = tokenData;\n  writeStorage(data);\n};\n","import {\n  readDatabaseLockState,\n  writeDatabaseLockState,\n} from \"./jobs-shared-data\";\n\ninterface DatabaseLock {\n  isLocked: boolean;\n  lockedBy: string;\n  lockedAt: string | null;\n}\n\n/**\n * Gets the current database lock state\n * @returns The current database lock state\n */\nexport const getDatabaseLock = (): DatabaseLock => {\n  const data = readDatabaseLockState();\n  return (\n    (data.databaseLock as DatabaseLock) ?? {\n      isLocked: false,\n      lockedBy: \"\",\n      lockedAt: null,\n    }\n  );\n};\n\n/**\n * Attempts to acquire the database lock\n * @param processName Name of the process requesting the lock\n * @returns true if lock was acquired, false if database is already locked\n */\nexport const acquireDatabaseLock = (processName: string): boolean => {\n  const data = readDatabaseLockState();\n  const currentLock = (data.databaseLock as DatabaseLock) ?? {\n    isLocked: false,\n    lockedBy: \"\",\n    lockedAt: null,\n  };\n\n  if (currentLock.isLocked) {\n    return false;\n  }\n\n  data.databaseLock = {\n    isLocked: true,\n    lockedBy: processName,\n    lockedAt: new Date().toISOString(),\n  };\n  writeDatabaseLockState(data);\n  return true;\n};\n\n/**\n * Releases the database lock\n * @param processName Name of the process releasing the lock\n * @returns true if lock was released, false if process doesn't own the lock\n */\nexport const releaseDatabaseLock = (processName: string): boolean => {\n  const data = readDatabaseLockState();\n  const currentLock = (data.databaseLock as DatabaseLock) ?? {\n    isLocked: false,\n    lockedBy: \"\",\n    lockedAt: null,\n  };\n\n  if (!currentLock.isLocked || currentLock.lockedBy !== processName) {\n    return false;\n  }\n\n  data.databaseLock = {\n    isLocked: false,\n    lockedBy: \"\",\n    lockedAt: null,\n  };\n  writeDatabaseLockState(data);\n  return true;\n};\n\n/**\n * Checks if the database is available for use\n * @returns true if database is available, false if locked\n */\nexport const isDatabaseAvailable = (): boolean => {\n  const lock = getDatabaseLock();\n  return !lock.isLocked;\n};\n","import {\n  acquireDatabaseLock,\n  releaseDatabaseLock,\n  getDatabaseLock,\n} from \"../../utils/local-data-store/database-lock\";\nimport { logger } from \"../reporting-service\";\n\nexport class SQLiteCoordinator {\n  private static readonly LOCK_TIMEOUT_MS = 30_000; // 30 seconds\n  private static readonly LOCK_RETRY_INTERVAL_MS = 1_000; // 1 second\n\n  /**\n   * Performs startup checks to ensure no stale locks exist\n   * Should be called when the application starts\n   */\n  static async performStartupCheck(): Promise<void> {\n    const currentLock = getDatabaseLock();\n\n    if (currentLock.isLocked) {\n      logger.warn(\n        `Found existing lock held by ${currentLock.lockedBy}, releasing for clean startup`\n      );\n      releaseDatabaseLock(currentLock.lockedBy);\n    }\n  }\n\n  /**\n   * Attempts to acquire the database lock\n   * @param processName Name of the process requesting the lock\n   * @returns true if lock was acquired, false if database is already locked\n   */\n  private static async tryAcquireLock(processName: string): Promise<boolean> {\n    return acquireDatabaseLock(processName);\n  }\n\n  /**\n   * Executes a database operation with proper locking\n   * @param processName Name of the process executing the operation\n   * @param operation The operation to execute\n   * @returns The result of the operation\n   */\n  static async executeWithLock<T>(\n    processName: string,\n    operation: () => Promise<T>\n  ): Promise<T> {\n    const startTime = Date.now();\n\n    // Try to acquire the lock with timeout\n    while (Date.now() - startTime < this.LOCK_TIMEOUT_MS) {\n      if (await this.tryAcquireLock(processName)) {\n        try {\n          // Execute the operation\n          const result = await operation();\n          return result;\n        } finally {\n          // Always release the lock\n          releaseDatabaseLock(processName);\n        }\n      }\n\n      // Wait before retrying\n      await new Promise((resolve) =>\n        setTimeout(resolve, this.LOCK_RETRY_INTERVAL_MS)\n      );\n    }\n\n    throw new Error(\n      `Failed to acquire database lock after ${this.LOCK_TIMEOUT_MS}ms`\n    );\n  }\n\n  /**\n   * Checks if the database is currently available for operations\n   * @returns true if the database is available, false if locked\n   */\n  static isAvailable(): boolean {\n    const lock = getDatabaseLock();\n    return !lock.isLocked;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * This file exports the public API that client code should use.
  */
 export type { IERPConnector } from "./types/erp-connector";
-export { ERPType, ERPObjType } from "./types/erp-types";
+export { ERPObjType } from "./types/erp-types";
 export type { ERPPagination, ERPResponse, ERPObject } from "./types/erp-types";
 export { ErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
 export { getErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
@@ -18,15 +18,15 @@ export { getUniqueRows, removeExtraneousFields, getPayloadWithoutIDField, trimOb
 export { getInitialLoadComplete, setInitialLoadComplete } from "./utils";
 export { HTTPClientFactory } from "./utils/http-client";
 export { HTTPError } from "./utils/http-client";
-export type { HTTPResponse, HTTPClient, HTTPRequestConfig } from "./utils/http-client";
+export type { HTTPResponse, HTTPClient, HTTPRequestConfig, } from "./utils/http-client";
 export { ApplicationInitializer } from "./utils/application-initializer";
 export { runDataSyncService } from "./services/data-sync-service";
 export { logger } from "./services/reporting-service";
 export type { IERPLaborTicketHandler } from "./types/erp-connector";
-export { StandardProcessDrivers, getCachedTimezoneOffset } from "./utils";
+export { StandardProcessDrivers, getCachedTimezoneOffset, getCachedTimezoneName, } from "./utils";
 export type { WriteEntitiesToMMResult } from "./utils";
 export { MMBatchValidationError } from "./utils";
-export type { APIResponse } from './services/erp-api-services/types';
+export type { APIResponse } from "./services/erp-api-services/types";
 export { RestAPIService } from "./services/erp-api-services/rest/rest-api-service";
 export { ErrorHandler, GraphQLError } from "./services/erp-api-services/errors";
 export type { QueryParams, PaginatedAPIResponse, } from "./services/erp-api-services/rest/get-query-params";
@@ -38,8 +38,10 @@ export { BatchCacheManager } from "./services/caching-service/batch-cache-manage
 export { CoreConfiguration, getSQLServerConfiguration, } from "./services/data-sync-service/configuration-manager";
 export { SqlServerService, SqlServerHelper, } from "./services/sql-server-erp-service";
 export type { SQLInput } from "./services/sql-server-erp-service";
+export { PsqlService, formatPsqlDate, formatPsqlTime, combinePsqlDateTime, isPsqlDateEmpty, cleanPsqlCharField, } from "./services/psql-erp-service";
+export type { PsqlConfiguration } from "./services/psql-erp-service";
 export { RecordTrackingManager } from "./services/caching-service/record-tracking-manager";
 export type { RecordTrackingObject } from "./services/caching-service/record-tracking-manager";
 export { default as knexDatabaseConfig } from "./knexfile";
-export { MMConnectorLogger, FileLogDeduper, LogEntry, type LogLevelString, type LogResponse } from './utils';
+export { MMConnectorLogger, FileLogDeduper, LogEntry, type LogLevelString, type LogResponse, } from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/mm-erp-sdk.js

@@ -1,8 +1,8 @@
-import { C as CoreConfiguration, H as HashedCacheManager } from "./hashed-cache-manager-B1hPBNnF.js";
-import { E, g, a } from "./hashed-cache-manager-B1hPBNnF.js";
+import { C as CoreConfiguration, H as HashedCacheManager } from "./hashed-cache-manager-Ds-HksA0.js";
+import { E, g, a } from "./hashed-cache-manager-Ds-HksA0.js";
 import { l as logger } from "./logger-CBDNtsMq.js";
-import { g as getCachedMMToken, s as setCachedMMToken, a as setTimezoneOffsetInCache, b as getCachedTimezoneOffset, S as SQLiteCoordinator } from "./index-DCgheVjV.js";
-import { c, d } from "./index-DCgheVjV.js";
+import { g as getCachedMMToken, s as setCachedMMToken, a as setTimezoneOffsetInCache, b as setTimezoneNameInCache, c as getCachedTimezoneOffset, S as SQLiteCoordinator } from "./index-DTtmv8Iq.js";
+import { f, d, e } from "./index-DTtmv8Iq.js";
 import axios, { AxiosError } from "axios";
 import knex from "knex";
 import { c as config } from "./knexfile-1qKKIORB.js";
@@ -14,16 +14,6 @@ import Graceful from "@ladjs/graceful";
 import { fileURLToPath } from "url";
 import sql from "mssql";
 import { z } from "zod";
-var ERPType = /* @__PURE__ */ ((ERPType2) => {
-  ERPType2["INVALID"] = "INVALID";
-  ERPType2["D365"] = "D365";
-  ERPType2["JOB_BOSS"] = "JOB_BOSS";
-  ERPType2["PROFITKEY"] = "PROFITKEY";
-  ERPType2["PROSHOP"] = "PROSHOP";
-  ERPType2["SYTELINE"] = "SYTELINE";
-  ERPType2["TEMPLATE"] = "TEMPLATE";
-  return ERPType2;
-})(ERPType || {});
 var ERPObjType = /* @__PURE__ */ ((ERPObjType2) => {
   ERPObjType2[ERPObjType2["RESOURCES"] = 0] = "RESOURCES";
   ERPObjType2[ERPObjType2["PARTS"] = 1] = "PARTS";
@@ -252,9 +242,9 @@ class AxiosClient {
   async destroy() {
     if (this.isDestroyed) return;
     this.isDestroyed = true;
-    for (const c2 of this.inFlightControllers) {
+    for (const c of this.inFlightControllers) {
       try {
-        c2.abort();
+        c.abort();
       } catch {
       }
     }
@@ -1435,12 +1425,14 @@ const getTimezoneOffset = async () => {
     if (!userInfo?.company?.timezone) {
       throw new Error("Unable to retrieve company timezone from API");
     }
+    const timezone = userInfo.company.timezone;
     const date = /* @__PURE__ */ new Date();
     const utcDate = new Date(date.toLocaleString("en-US", { timeZone: "UTC" }));
     const tzDate = new Date(
-      date.toLocaleString("en-US", { timeZone: userInfo.company.timezone })
+      date.toLocaleString("en-US", { timeZone: timezone })
     );
-    return (tzDate.getTime() - utcDate.getTime()) / 36e5;
+    const offset = (tzDate.getTime() - utcDate.getTime()) / 36e5;
+    return { offset, timezone };
   } catch (error) {
     throw new Error(
       `Failed to get timezone offset: ${error instanceof Error ? error.message : "Unknown error"}`
@@ -1527,13 +1519,14 @@ const getTimezoneOffsetAndPersist = async (params = {
   let success = false;
   let retries = 0;
   logger.info(
-    "Acquiring the timezone offset from MachineMetrics and storing in cache"
+    "Acquiring the timezone offset and timezone name from MachineMetrics and storing in cache"
   );
   while (!success && retries < params.maxRetries) {
     try {
-      const offsetHours = await getTimezoneOffset();
-      logger.info(`Timezone offset: ${offsetHours} hours`);
-      setTimezoneOffsetInCache(offsetHours);
+      const { offset, timezone } = await getTimezoneOffset();
+      logger.info(`Timezone offset: ${offset} hours, timezone: ${timezone}`);
+      setTimezoneOffsetInCache(offset);
+      setTimezoneNameInCache(timezone);
       success = true;
     } catch (error) {
       logger.error("Error getting timezone offset:", error);
@@ -3449,7 +3442,7 @@ class ApplicationInitializer {
         "\n================================INITIALIZING APPLICATION================================\n"
       );
       const coreConfig = CoreConfiguration.inst();
-      logger.info("Core Configuration loaded:", coreConfig);
+      logger.info("Core Configuration loaded:", coreConfig.toSafeLogObject());
       logger.info("Performing database startup checks...");
       await SQLiteCoordinator.performStartupCheck();
       logger.info("Database startup checks completed successfully");
@@ -3982,12 +3975,240 @@ class SqlServerHelper {
     logger.info("----------------------------------------");
   }
 }
+class PsqlService {
+  config;
+  static odbcModule = null;
+  static odbcLoadError = null;
+  constructor(config2) {
+    this.config = config2;
+  }
+  /**
+   * Dynamically load the ODBC module with lazy initialization and caching
+   * @throws Error with helpful message if ODBC package is not installed
+   */
+  static async getOdbc() {
+    if (this.odbcLoadError) {
+      throw this.odbcLoadError;
+    }
+    if (this.odbcModule) {
+      return this.odbcModule;
+    }
+    try {
+      const odbcImport = await import("odbc");
+      const odbc = odbcImport.default || odbcImport;
+      this.odbcModule = odbc;
+      return this.odbcModule;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.odbcLoadError = new Error(
+        `ODBC package is required for PSQL service but is not installed or failed to load.
+Install it with: npm install odbc
+Also install OS-level dependencies, e.g. on Alpine Linux:
+  apk add --no-cache unixodbc unixodbc-dev python3 make g++
+For other Linux distributions, install unixodbc and unixodbc-dev packages.
+Original error: ${errorMessage}`
+      );
+      throw this.odbcLoadError;
+    }
+  }
+  // REMOVED: dispose() method - not needed anymore
+  // REMOVED: connection property - not needed anymore
+  // REMOVED: openConnection() method - not needed anymore
+  // REMOVED: closeConnection() method - not needed anymore
+  /**
+   * Build PSQL ODBC connection string
+   * CRITICAL: ServerName must use IP.PORT format (e.g., 10.4.0.11.1583)
+   */
+  buildConnectionString() {
+    const serverName = `${this.config.host}.${this.config.port}`;
+    return [
+      "Driver={Pervasive ODBC Interface}",
+      `ServerName=${serverName}`,
+      `DBQ=${this.config.database}`,
+      `UID=${this.config.username}`,
+      `PWD=${this.config.password}`,
+      "AutoDoubleQuote=0"
+    ].join(";") + ";";
+  }
+  /**
+   * Execute a query and return the results
+   * Creates a fresh connection for each query to avoid handle corruption
+   *
+   * SECURITY WARNING: This method executes the provided SQL string as-is.
+   * - Parameter binding is NOT implemented; the `params` argument is currently ignored.
+   * - Never concatenate untrusted/user-supplied input into `query`.
+   * - Doing so can result in SQL injection vulnerabilities and data exposure.
+   * If dynamic values are required, ensure they are strictly validated/escaped
+   * or implement proper parameterized execution before accepting untrusted input.
+   *
+   * @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
+   */
+  async executePreparedStatement(query, params = {}, paging) {
+    const odbc = await PsqlService.getOdbc();
+    let connection = null;
+    try {
+      const connStr = this.buildConnectionString();
+      logger.debug("Creating fresh PSQL connection for query");
+      connection = await odbc.connect(connStr);
+      if (Object.keys(params).length > 0) {
+        logger.warn(
+          "PsqlService: Query parameters provided but parameter binding not yet implemented. Using direct query execution."
+        );
+      }
+      const records = await connection.query(query);
+      const allRecords = PsqlService.recordsetToRecords(records);
+      const rowsFetched = allRecords.length;
+      const pagedData = paging?.offset !== void 0 || paging?.limit !== void 0 ? allRecords.slice(
+        paging.offset || 0,
+        (paging.offset || 0) + (paging.limit || allRecords.length)
+      ) : allRecords;
+      return {
+        data: pagedData,
+        paging: {
+          count: rowsFetched,
+          limit: paging?.limit || 0,
+          offset: paging?.offset || 0,
+          nextPage: paging?.limit && (paging.offset || 0) + paging.limit < rowsFetched ? String((paging.offset || 0) + paging.limit) : void 0,
+          previousPage: paging?.offset ? String(Math.max(0, (paging.offset || 0) - (paging.limit || 10))) : void 0
+        }
+      };
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("ODBC package is required")) {
+        throw error;
+      }
+      const errorInfo = error;
+      logger.error("Error fetching data from PSQL", {
+        error: errorInfo.message,
+        odbcErrors: errorInfo.odbcErrors,
+        query: query.substring(0, 200)
+        // Log first 200 chars of query
+      });
+      throw this.handleOdbcError(errorInfo);
+    } finally {
+      if (connection) {
+        try {
+          await connection.close();
+          logger.debug("PSQL connection closed successfully");
+        } catch (err) {
+          logger.warn("Error closing PSQL connection (non-fatal)", {
+            error: err
+          });
+        }
+      }
+    }
+  }
+  /**
+   * Transform ODBC result set to array of Record<string, string> instances.
+   * IMPORTANT: PSQL CHAR fields are often padded with spaces - we trim them
+   */
+  static recordsetToRecords(recordset) {
+    if (!Array.isArray(recordset)) {
+      return [];
+    }
+    const data = recordset.map((row) => {
+      const transformedRow = {};
+      Object.keys(row).forEach((key) => {
+        const value = row[key];
+        transformedRow[key] = value !== null && value !== void 0 ? String(value).trim() : "";
+      });
+      return transformedRow;
+    });
+    return data;
+  }
+  /**
+   * Handle ODBC errors and provide meaningful messages
+   */
+  handleOdbcError(error) {
+    const odbcError = error.odbcErrors?.[0];
+    const errorCode = odbcError?.state;
+    const message = odbcError?.message || error.message;
+    switch (errorCode) {
+      case "08S01":
+        return new Error(
+          `PSQL connection failed. Check: 1) PVSW environment variable set to /usr/local/psql/etc/pvsw.ini, 2) Network connectivity to ports 1583/3351, 3) ODBC configuration files in /usr/local/psql/etc/ and /etc/. Original error: ${message}`
+        );
+      case "28000":
+        return new Error(
+          `PSQL authentication failed. Check username/password. Original error: ${message}`
+        );
+      case "42000":
+        return new Error(`PSQL SQL syntax error. Original error: ${message}`);
+      case "42S02":
+        return new Error(
+          `PSQL table or view not found. Check table names in query. Original error: ${message}`
+        );
+      default:
+        return new Error(`PSQL error (${errorCode || "unknown"}): ${message}`);
+    }
+  }
+}
+function formatPsqlDate(psqlDate) {
+  if (!psqlDate || psqlDate.trim().length !== 6 || psqlDate === "000000") {
+    return null;
+  }
+  try {
+    const year = parseInt(psqlDate.substring(0, 2), 10);
+    const month = parseInt(psqlDate.substring(2, 4), 10);
+    const day = parseInt(psqlDate.substring(4, 6), 10);
+    const fullYear = year + 2e3;
+    if (month < 1 || month > 12 || day < 1 || day > 31) {
+      return null;
+    }
+    const date = new Date(fullYear, month - 1, day);
+    if (date.getFullYear() !== fullYear || date.getMonth() !== month - 1 || date.getDate() !== day) {
+      return null;
+    }
+    return date.toISOString().split("T")[0];
+  } catch (error) {
+    return null;
+  }
+}
+function formatPsqlTime(psqlTime) {
+  if (!psqlTime) {
+    return null;
+  }
+  const trimmed = psqlTime.trim();
+  if (trimmed.length !== 4) {
+    return null;
+  }
+  try {
+    const hours = parseInt(trimmed.substring(0, 2), 10);
+    const minutes = parseInt(trimmed.substring(2, 4), 10);
+    if (isNaN(hours) || isNaN(minutes) || hours < 0 || hours > 23 || minutes < 0 || minutes > 59) {
+      return null;
+    }
+    const hoursStr = hours.toString().padStart(2, "0");
+    const minutesStr = minutes.toString().padStart(2, "0");
+    return `${hoursStr}:${minutesStr}:00`;
+  } catch (error) {
+    return null;
+  }
+}
+function combinePsqlDateTime(psqlDate, psqlTime) {
+  const date = formatPsqlDate(psqlDate);
+  const time = formatPsqlTime(psqlTime);
+  if (!date || !time) {
+    return null;
+  }
+  return `${date}T${time}`;
+}
+function isPsqlDateEmpty(psqlDate) {
+  return !psqlDate || psqlDate === "000000" || psqlDate.trim() === "";
+}
+function cleanPsqlCharField(value) {
+  if (value === null || value === void 0) {
+    return "";
+  }
+  return String(value).trim();
+}
 export {
   ApplicationInitializer,
   BatchCacheManager,
   CoreConfiguration,
   ERPObjType,
-  ERPType,
   E as ErpApiConnectionParams,
   ErrorHandler,
   FileLogDeduper,
@@ -4009,6 +4230,7 @@ export {
   MMSendWorkOrder,
   MMSendWorkOrderOperation,
   OAuthClient,
+  PsqlService,
   RecordTrackingManager,
   RestAPIService,
   SqlServerHelper,
@@ -4018,21 +4240,27 @@ export {
   addNewFieldFromLookupField,
   applyTimezoneOffsetsToFields,
   buildLogicalCondition,
+  cleanPsqlCharField,
   cleanupNumbers,
+  combinePsqlDateTime,
   convertToLocalTime,
   formatDateWithTZOffset,
+  formatPsqlDate,
+  formatPsqlTime,
+  f as getCachedTimezoneName,
   getCachedTimezoneOffset,
   g as getErpApiConnectionParams,
   getErrorType,
-  c as getInitialLoadComplete,
+  d as getInitialLoadComplete,
   getPayloadWithoutIDField,
   a as getSQLServerConfiguration,
   getUniqueRows,
+  isPsqlDateEmpty,
   config as knexDatabaseConfig,
   logger,
   removeExtraneousFields,
   runDataSyncService,
-  d as setInitialLoadComplete,
+  e as setInitialLoadComplete,
   trimObjectValues
 };
 //# sourceMappingURL=mm-erp-sdk.js.map