@machinemetrics/mm-erp-sdk 0.1.8-beta.6 → 0.1.8-beta.7

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

@@ -6,7 +6,14 @@ type PagingParams = {
 };
 export declare class PsqlService {
     private config;
+    private static odbcModule;
+    private static odbcLoadError;
     constructor(config: PsqlConfiguration);
+    /**
+     * Dynamically load the ODBC module with lazy initialization and caching
+     * @throws Error with helpful message if ODBC package is not installed
+     */
+    private static getOdbc;
     /**
      * Build PSQL ODBC connection string
      * CRITICAL: ServerName must use IP.PORT format (e.g., 10.4.0.11.1583)

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

@@ -1 +1 @@
-{"version":3,"file":"psql-service.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/psql-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IASrC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;;;;;;OAQG;IACU,wBAAwB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAqEnC;;;OAGG;WACW,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAkB5E;;OAEG;IACH,OAAO,CAAC,eAAe;CA4BxB"}
+{"version":3,"file":"psql-service.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/psql-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAiBF,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAC,UAAU,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAsB;gBAEtC,MAAM,EAAE,iBAAiB;IAIrC;;;OAGG;mBACkB,OAAO;IAsC5B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;;;;;;OAQG;IACU,wBAAwB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IA8EnC;;;OAGG;WACW,kBAAkB,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAkB5E;;OAEG;IACH,OAAO,CAAC,eAAe;CA4BxB"}

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.8-beta.6",
+  "version": "0.1.8-beta.7",
   "license": "MIT",
   "author": "machinemetrics",
   "main": "dist/mm-erp-sdk.js",
@@ -28,12 +28,14 @@
     "knex": "^3.1.0",
     "lodash": "^4.17.21",
     "mssql": "^11.0.1",
-    "odbc": "^2.4.8",
     "winston": "^3.14.0",
     "winston-daily-rotate-file": "^5.0.0",
     "xxhashjs": "^0.2.2",
     "zod": "^3.24.1"
   },
+  "optionalDependencies": {
+    "odbc": "^2.4.8"
+  },
   "devDependencies": {
     "@types/json-stable-stringify": "^1.1.0",
     "@types/lodash": "^4.17.10",

package/src/services/psql-erp-service/psql-service.ts

@@ -1,4 +1,3 @@
-import odbc from "odbc";
 import { PsqlConfiguration } from "./configuration";
 import { ERPResponse } from "../../types/erp-types";
 import { OdbcErrorResponse } from "./internal/types/psql-types";
@@ -9,13 +8,67 @@ type PagingParams = {
   offset?: number;
 };
 
+/**
+ * ODBC connection interface for type safety
+ */
+interface OdbcConnection {
+  query(sql: string): Promise<any[]>;
+  close(): Promise<void>;
+}
+
+/**
+ * ODBC module interface
+ */
+interface OdbcModule {
+  connect(connectionString: string): Promise<OdbcConnection>;
+}
+
 export class PsqlService {
   private config: PsqlConfiguration;
+  private static odbcModule: OdbcModule | null = null;
+  private static odbcLoadError: Error | null = null;
 
   constructor(config: PsqlConfiguration) {
     this.config = config;
   }
 
+  /**
+   * Dynamically load the ODBC module with lazy initialization and caching
+   * @throws Error with helpful message if ODBC package is not installed
+   */
+  private static async getOdbc(): Promise<OdbcModule> {
+    // If we've already tried and failed, throw the cached error
+    if (this.odbcLoadError) {
+      throw this.odbcLoadError;
+    }
+
+    // If already loaded, return cached module
+    if (this.odbcModule) {
+      return this.odbcModule;
+    }
+
+    try {
+      // Dynamic import - only loads when actually needed
+      // @ts-ignore - odbc is an optional dependency, may not be installed at build time
+      const odbcImport = await import("odbc");
+      // Handle both default export and named export patterns
+      const odbc = odbcImport.default || odbcImport;
+      this.odbcModule = odbc as OdbcModule;
+      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.\n` +
+        `Install it with: npm install odbc\n` +
+        `Also install OS-level dependencies, e.g. on Alpine Linux:\n` +
+        `  apk add --no-cache unixodbc unixodbc-dev python3 make g++\n` +
+        `For other Linux distributions, install unixodbc and unixodbc-dev packages.\n` +
+        `Original error: ${errorMessage}`
+      );
+      throw this.odbcLoadError;
+    }
+  }
+
   // REMOVED: dispose() method - not needed anymore
   // REMOVED: connection property - not needed anymore
   // REMOVED: openConnection() method - not needed anymore
@@ -54,7 +107,9 @@ export class PsqlService {
     params: Record<string, string> = {},
     paging?: PagingParams
   ): Promise<ERPResponse | undefined> {
-    let connection: odbc.Connection | null = null;
+    // Dynamically load ODBC module (will throw helpful error if not installed)
+    const odbc = await PsqlService.getOdbc();
+    let connection: OdbcConnection | null = null;
 
     try {
       // Create fresh connection for THIS query only
@@ -98,6 +153,13 @@ export class PsqlService {
         },
       };
     } catch (error) {
+      // If this is an ODBC load error (from getOdbc), re-throw it as-is
+      // since it already has a helpful error message
+      if (error instanceof Error && error.message.includes("ODBC package is required")) {
+        throw error;
+      }
+
+      // Otherwise, handle as ODBC runtime error
       const errorInfo = error as OdbcErrorResponse;
       logger.error("Error fetching data from PSQL", {
         error: errorInfo.message,