@machinemetrics/mm-erp-sdk 0.1.8-beta.0 → 0.1.8-beta.1

package/dist/index.d.ts

@@ -18,7 +18,7 @@ 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";
@@ -26,7 +26,7 @@ export type { IERPLaborTicketHandler } from "./types/erp-connector";
 export { StandardProcessDrivers, getCachedTimezoneOffset } 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, PsqlLaborTicketOperations, 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":"AAAA;;;GAGG;AAGH,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAC5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oDAAoD,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,YAAY,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,0BAA0B,EAC1B,sCAAsC,EACtC,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,4BAA4B,EAC5B,kBAAkB,EAClB,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EACV,YAAY,EACZ,UAAU,EACV,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGpE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAC1E,YAAY,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAGjD,YAAY,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EACV,WAAW,EACX,oBAAoB,GACrB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AACrF,YAAY,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAGpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAGnF,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,oDAAoD,CAAC;AAG5D,OAAO,EACL,gBAAgB,EAChB,eAAe,GAChB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAGlE,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,YAAY,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAG/F,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,SAAS,CAAC"}

package/dist/mm-erp-sdk.js

@@ -14,6 +14,7 @@ import Graceful from "@ladjs/graceful";
 import { fileURLToPath } from "url";
 import sql from "mssql";
 import { z } from "zod";
+import odbc from "odbc";
 var ERPType = /* @__PURE__ */ ((ERPType2) => {
   ERPType2["INVALID"] = "INVALID";
   ERPType2["D365"] = "D365";
@@ -22,6 +23,7 @@ var ERPType = /* @__PURE__ */ ((ERPType2) => {
   ERPType2["PROSHOP"] = "PROSHOP";
   ERPType2["SYTELINE"] = "SYTELINE";
   ERPType2["TEMPLATE"] = "TEMPLATE";
+  ERPType2["GLOBALSHOP"] = "GLOBALSHOP";
   return ERPType2;
 })(ERPType || {});
 var ERPObjType = /* @__PURE__ */ ((ERPObjType2) => {
@@ -3965,6 +3967,224 @@ class SqlServerHelper {
     logger.info("----------------------------------------");
   }
 }
+class PsqlService {
+  config;
+  constructor(config2) {
+    this.config = config2;
+  }
+  // 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
+   *
+   * @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) {
+    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. This is acceptable for Phase 1 read operations."
+        );
+      }
+      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) {
+      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}`);
+    }
+  }
+}
+class PsqlLaborTicketOperations {
+  constructor(service) {
+    this.service = service;
+  }
+  /**
+   * Create labor ticket in START_LABOR table
+   *
+   * Phase 2 Implementation Notes:
+   * - Will use prepared statements with parameter binding
+   * - Insert into START_LABOR table
+   * - Return GUID as erpUid
+   *
+   * @param laborTicket Labor ticket from MachineMetrics
+   * @returns Labor ticket and ERP unique ID
+   */
+  async createLaborTicket(laborTicket) {
+    logger.warn(
+      "PsqlLaborTicketOperations.createLaborTicket not yet implemented (Phase 2)"
+    );
+    throw new Error(
+      "Labor ticket creation not implemented for PSQL. This is a Phase 2 feature."
+    );
+  }
+  /**
+   * Update labor ticket (move from START_LABOR to COMPLETED_LABOR)
+   *
+   * Phase 2 Implementation Notes:
+   * - Insert into COMPLETED_LABOR
+   * - Delete from START_LABOR
+   * - Should be done in a transaction
+   *
+   * @param laborTicket Labor ticket to update
+   * @returns Updated labor ticket
+   */
+  async updateLaborTicket(laborTicket) {
+    logger.warn(
+      "PsqlLaborTicketOperations.updateLaborTicket not yet implemented (Phase 2)"
+    );
+    throw new Error(
+      "Labor ticket update not implemented for PSQL. This is a Phase 2 feature."
+    );
+  }
+}
+function formatPsqlDate(psqlDate) {
+  if (!psqlDate || psqlDate === "000000" || psqlDate.trim() === "") {
+    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);
+    return date.toISOString().split("T")[0];
+  } catch (error) {
+    return null;
+  }
+}
+function formatPsqlTime(psqlTime) {
+  if (!psqlTime || psqlTime.trim() === "") {
+    return null;
+  }
+  try {
+    const hours = psqlTime.substring(0, 2);
+    const minutes = psqlTime.substring(2, 4);
+    return `${hours}:${minutes}: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,
@@ -3992,6 +4212,8 @@ export {
   MMSendWorkOrder,
   MMSendWorkOrderOperation,
   OAuthClient,
+  PsqlLaborTicketOperations,
+  PsqlService,
   RecordTrackingManager,
   RestAPIService,
   SqlServerHelper,
@@ -4001,9 +4223,13 @@ export {
   addNewFieldFromLookupField,
   applyTimezoneOffsetsToFields,
   buildLogicalCondition,
+  cleanPsqlCharField,
   cleanupNumbers,
+  combinePsqlDateTime,
   convertToLocalTime,
   formatDateWithTZOffset,
+  formatPsqlDate,
+  formatPsqlTime,
   getCachedTimezoneOffset,
   g as getErpApiConnectionParams,
   getErrorType,
@@ -4011,6 +4237,7 @@ export {
   getPayloadWithoutIDField,
   a as getSQLServerConfiguration,
   getUniqueRows,
+  isPsqlDateEmpty,
   config as knexDatabaseConfig,
   logger,
   removeExtraneousFields,