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

package/dist/services/data-sync-service/configuration-manager.d.ts

@@ -17,6 +17,11 @@ export declare class CoreConfiguration {
     readonly cacheExpirationCheckInterval: string;
     private constructor();
     static inst(): CoreConfiguration;
+    /**
+     * Returns a sanitized version of the configuration for safe logging.
+     * Masks sensitive fields like authentication tokens.
+     */
+    toSafeLogObject(): Record<string, unknown>;
 }
 /**
  * Helper function to get the SQL Server Configuration for collectors that use SQL Server to interact with the ERP

package/dist/services/data-sync-service/configuration-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-manager.d.ts","sourceRoot":"","sources":["../../../src/services/data-sync-service/configuration-manager.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAG3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAGhC,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAC3C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAG3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAGjC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAG1C,SAAgB,eAAe,EAAE,MAAM,CAAC;IACxC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,yBAAyB,EAAE,MAAM,CAAC;IAClD,SAAgB,4BAA4B,EAAE,MAAM,CAAC;IAErD,OAAO;WA0DO,IAAI,IAAI,iBAAiB;CAMxC;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,sBAiB5C,CAAC;AAEF;;;GAGG;AACH,qBAAa,sBAAsB;aAEf,SAAS,EAAE,MAAM;aACjB,cAAc,EAAE,MAAM;aACtB,kBAAkB,EAAE,MAAM;aAC1B,oBAAoB,EAAE,MAAM;aAC5B,cAAc,EAAE,MAAM;aACtB,aAAa,EAAE,MAAM;gBALrB,SAAS,EAAE,MAAM,EAAE,kBAAkB;IACrC,cAAc,EAAE,MAAM,EAAE,qCAAqC;IAC7D,kBAAkB,EAAE,MAAM,EAAE,yCAAyC;IACrE,oBAAoB,EAAE,MAAM,EAAE,2BAA2B;IACzD,cAAc,EAAE,MAAM,EAAE,gBAAgB;IACxC,aAAa,GAAE,MAAU;CAE5C;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAO,sBAS5C,CAAC"}
+{"version":3,"file":"configuration-manager.d.ts","sourceRoot":"","sources":["../../../src/services/data-sync-service/configuration-manager.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAG3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAGhC,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAC3C,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAG3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAGjC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAG1C,SAAgB,eAAe,EAAE,MAAM,CAAC;IACxC,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,yBAAyB,EAAE,MAAM,CAAC;IAClD,SAAgB,4BAA4B,EAAE,MAAM,CAAC;IAErD,OAAO;WA0DO,IAAI,IAAI,iBAAiB;IAOvC;;;OAGG;IACI,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA4BlD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,sBAiB5C,CAAC;AAEF;;;GAGG;AACH,qBAAa,sBAAsB;aAEf,SAAS,EAAE,MAAM;aACjB,cAAc,EAAE,MAAM;aACtB,kBAAkB,EAAE,MAAM;aAC1B,oBAAoB,EAAE,MAAM;aAC5B,cAAc,EAAE,MAAM;aACtB,aAAa,EAAE,MAAM;gBALrB,SAAS,EAAE,MAAM,EAAE,kBAAkB;IACrC,cAAc,EAAE,MAAM,EAAE,qCAAqC;IAC7D,kBAAkB,EAAE,MAAM,EAAE,yCAAyC;IACrE,oBAAoB,EAAE,MAAM,EAAE,2BAA2B;IACzD,cAAc,EAAE,MAAM,EAAE,gBAAgB;IACxC,aAAa,GAAE,MAAU;CAE5C;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,QAAO,sBAS5C,CAAC"}

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

@@ -1,7 +1,7 @@
-import "../../../config-qat9zgOl.js";
-import { H as HashedCacheManager } from "../../../hashed-cache-manager-CzyFSt2B.js";
-import { S as SQLiteCoordinator } from "../../../index-B9wo8pld.js";
-import { l as logger } from "../../../logger-Db8CkwR6.js";
+import "../../../config-cB7h4yvc.js";
+import { H as HashedCacheManager } from "../../../hashed-cache-manager-Ds-HksA0.js";
+import { S as SQLiteCoordinator } from "../../../index-DTtmv8Iq.js";
+import { l as logger } from "../../../logger-CBDNtsMq.js";
 logger.level = process.env.LOG_LEVEL || "info";
 const main = async () => {
   const cacheManager = new HashedCacheManager();

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

@@ -1,7 +1,7 @@
-import "../../../config-qat9zgOl.js";
-import { l as logger } from "../../../logger-Db8CkwR6.js";
-import { S as SQLiteCoordinator } from "../../../index-B9wo8pld.js";
-import { c as createConnectorFromPath } from "../../../connector-factory-C2czCs9v.js";
+import "../../../config-cB7h4yvc.js";
+import { l as logger } from "../../../logger-CBDNtsMq.js";
+import { S as SQLiteCoordinator } from "../../../index-DTtmv8Iq.js";
+import { c as createConnectorFromPath } from "../../../connector-factory-CKm74_WZ.js";
 logger.level = process.env.LOG_LEVEL || "info";
 const main = async () => {
   try {

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

@@ -1,6 +1,6 @@
-import "../../../config-qat9zgOl.js";
-import { l as logger } from "../../../logger-Db8CkwR6.js";
-import { c as createConnectorFromPath } from "../../../connector-factory-C2czCs9v.js";
+import "../../../config-cB7h4yvc.js";
+import { l as logger } from "../../../logger-CBDNtsMq.js";
+import { c as createConnectorFromPath } from "../../../connector-factory-CKm74_WZ.js";
 logger.level = process.env.LOG_LEVEL || "info";
 const main = async () => {
   try {

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

@@ -1,5 +1,5 @@
 import knex from "knex";
-import { l as logger } from "../../../logger-Db8CkwR6.js";
+import { l as logger } from "../../../logger-CBDNtsMq.js";
 import { c as config } from "../../../knexfile-1qKKIORB.js";
 logger.level = process.env.LOG_LEVEL || "info";
 const db = knex(config.local);

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

@@ -1,6 +1,6 @@
-import "../../../config-qat9zgOl.js";
-import { l as logger } from "../../../logger-Db8CkwR6.js";
-import { c as createConnectorFromPath } from "../../../connector-factory-C2czCs9v.js";
+import "../../../config-cB7h4yvc.js";
+import { l as logger } from "../../../logger-CBDNtsMq.js";
+import { c as createConnectorFromPath } from "../../../connector-factory-CKm74_WZ.js";
 logger.level = process.env.LOG_LEVEL || "info";
 const main = async () => {
   try {

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

@@ -0,0 +1,8 @@
+export interface PsqlConfiguration {
+    host: string;
+    port: string;
+    database: string;
+    username: string;
+    password: string;
+}
+//# sourceMappingURL=configuration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/configuration.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

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

@@ -0,0 +1,14 @@
+import { PsqlService } from "./psql-service";
+/**
+ * A class to manage interactions with PSQL (Pervasive) databases via ODBC
+ */
+export { PsqlService };
+/**
+ * Configuration interface for PSQL connections
+ */
+export type { PsqlConfiguration } from "./configuration";
+/**
+ * Helper functions for PSQL data formatting
+ */
+export { formatPsqlDate, formatPsqlTime, combinePsqlDateTime, isPsqlDateEmpty, cleanPsqlCharField, } from "./psql-helpers";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;GAEG;AACH,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * PSQL-specific type definitions
+ */
+export interface OdbcError {
+    state: string;
+    message: string;
+    code?: number;
+}
+export interface OdbcErrorResponse extends Error {
+    odbcErrors?: OdbcError[];
+}
+//# sourceMappingURL=psql-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"psql-types.d.ts","sourceRoot":"","sources":["../../../../../src/services/psql-erp-service/internal/types/psql-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B"}

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

@@ -0,0 +1,32 @@
+/**
+ * Helper functions for PSQL/Pervasive database operations
+ */
+/**
+ * Formats a date from PSQL YYMMDD format to ISO date string
+ * @param psqlDate Date in YYMMDD format (e.g., "250105" for Jan 5, 2025)
+ * @returns ISO date string (e.g., "2025-01-05") or null if invalid
+ */
+export declare function formatPsqlDate(psqlDate: string): string | null;
+/**
+ * Formats a time from PSQL HHMM format to HH:MM:SS
+ * @param psqlTime Time in HHMM format (e.g., "1430" for 2:30 PM)
+ * @returns Time string in HH:MM:SS format or null if invalid
+ */
+export declare function formatPsqlTime(psqlTime: string): string | null;
+/**
+ * Combines PSQL date and time into ISO datetime string
+ * @param psqlDate Date in YYMMDD format
+ * @param psqlTime Time in HHMM format
+ * @returns ISO datetime string or null if invalid
+ */
+export declare function combinePsqlDateTime(psqlDate: string, psqlTime: string): string | null;
+/**
+ * Helper to check if a PSQL date is "empty" (000000 or blank)
+ */
+export declare function isPsqlDateEmpty(psqlDate: string): boolean;
+/**
+ * Clean and trim PSQL CHAR field (removes trailing spaces)
+ * PSQL CHAR fields are fixed-width and padded with spaces
+ */
+export declare function cleanPsqlCharField(value: string | null | undefined): string;
+//# sourceMappingURL=psql-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"psql-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/psql-erp-service/psql-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+B9D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4B9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CASf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAK3E"}

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

@@ -0,0 +1,50 @@
+import { PsqlConfiguration } from "./configuration";
+import { ERPResponse } from "../../types/erp-types";
+type PagingParams = {
+    limit?: number;
+    offset?: number;
+};
+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)
+     */
+    private buildConnectionString;
+    /**
+     * 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
+     */
+    executePreparedStatement(query: string, params?: Record<string, string>, paging?: PagingParams): Promise<ERPResponse | undefined>;
+    /**
+     * 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: any[]): Record<string, string>[];
+    /**
+     * Handle ODBC errors and provide meaningful messages
+     */
+    private handleOdbcError;
+}
+export {};
+//# sourceMappingURL=psql-service.d.ts.map

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

@@ -0,0 +1 @@
+{"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;;;;;;;;;;;;;;;OAeG;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/dist/services/reporting-service/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/services/reporting-service/logger.ts"],"names":[],"mappings":"AA+DA,QAAA,MAAM,MAAM,0BAaV,CAAC;AAGH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,SAgChE,CAAC;AAKF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/services/reporting-service/logger.ts"],"names":[],"mappings":"AA+DA,QAAA,MAAM,MAAM,0BAaV,CAAC;AA0DH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,SAuChE,CAAC;AAKF,eAAe,MAAM,CAAC"}

package/dist/utils/index.d.ts

@@ -27,7 +27,7 @@ export { BatchCacheManager } from "../services/caching-service/batch-cache-manag
 export { StandardProcessDrivers } from "./standard-process-drivers/";
 export type { WriteEntitiesToMMResult } from "./standard-process-drivers/";
 export { MMBatchValidationError } from "./standard-process-drivers/";
-export { getCachedTimezoneOffset } from "./local-data-store/jobs-shared-data";
+export { getCachedTimezoneOffset, getCachedTimezoneName, } from "./local-data-store/jobs-shared-data";
 export { getInitialLoadComplete, setInitialLoadComplete, } from "./local-data-store/jobs-shared-data";
 /**
  * ERP API utilities

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,cAAc,cAAc,CAAC;AAE7B;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEpF;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjF;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAE1C;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,cAAc,cAAc,CAAC;AAE7B;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,kDAAkD,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEpF;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAE7C;;GAEG;AACH,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjF;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAE1C;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAExE;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils/local-data-store/jobs-shared-data.d.ts

@@ -10,12 +10,26 @@ export declare const readDatabaseLockState: () => Record<string, unknown>;
 export declare const writeDatabaseLockState: (data: Record<string, unknown>) => void;
 export declare const getInitialLoadComplete: () => boolean;
 export declare const setInitialLoadComplete: (complete: boolean) => void;
+/**
+ * Gets the company's cached current timezone offset (e.g., -5)
+ * @returns The cached timezone offset or 0 if not found
+ */
 export declare const getCachedTimezoneOffset: () => number;
 /**
- * Sets the timezone offset in the cache
+ * Sets the company's current timezone offset in the cache
  * @param offset The timezone offset in hours
  */
 export declare const setTimezoneOffsetInCache: (offset: number) => void;
+/**
+ * Gets the cached timezone name (e.g., "America/New_York")
+ * @returns The cached timezone name or null if not found
+ */
+export declare const getCachedTimezoneName: () => string | null;
+/**
+ * Sets the timezone name in the cache
+ * @param timezone The timezone name (e.g., "America/New_York")
+ */
+export declare const setTimezoneNameInCache: (timezone: string) => void;
 interface CachedToken {
     token: string;
     expiration: number | null;

package/dist/utils/local-data-store/jobs-shared-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs-shared-data.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/jobs-shared-data.ts"],"names":[],"mappings":"AA6CA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAE9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAEtE,CAAC;AAGF,eAAO,MAAM,sBAAsB,QAAO,OAGzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,KAAG,IAI1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,MAG1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,KAAG,IAIzD,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAAW,GAAG,IAGjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,WAAW,KAAG,IAIzD,CAAC"}
+{"version":3,"file":"jobs-shared-data.d.ts","sourceRoot":"","sources":["../../../src/utils/local-data-store/jobs-shared-data.ts"],"names":[],"mappings":"AA6CA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAE9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAEtE,CAAC;AAGF,eAAO,MAAM,sBAAsB,QAAO,OAGzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,KAAG,IAI1D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAO,MAG1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,KAAG,IAIzD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,MAAM,GAAG,IAGjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,KAAG,IAIzD,CAAC;AAEF,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,WAAW,GAAG,IAGjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,WAAW,KAAG,IAIzD,CAAC"}

package/dist/utils/time-utils.d.ts

@@ -20,8 +20,9 @@ interface TimezoneOffsetParams {
     retryIntervalMs: number;
 }
 /**
- * Gets the timezone offset for the company and sets it in the cache
+ * Gets the timezone offset and timezone name for the company and sets them in the cache
  * The cached offset can be acquired from getCachedTimezoneOffset() in "./local-data-store/jobs-shared-data"
+ * The cached timezone name can be acquired from getCachedTimezoneName() in "./local-data-store/jobs-shared-data"
  *
  * @param params.maxRetries Maximum number of retry attempts
  * @param params.retryIntervalMs Time to wait between retries in milliseconds

package/dist/utils/time-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-utils.d.ts","sourceRoot":"","sources":["../../src/utils/time-utils.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,cAAc,EAAE,MAAM,GACrB,MAAM,CA2BR;AAED,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,GAAG,IAAI,kBASvD,CAAC;AAEF;;;;;;GAMG;AAEH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,QAAQ,MAAM,EAAE,EAChB,gBAAgB,MAAM,KACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAcvB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAQ,oBAGP,KACA,OAAO,CAAC,IAAI,CA0Bd,CAAC"}
+{"version":3,"file":"time-utils.d.ts","sourceRoot":"","sources":["../../src/utils/time-utils.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,cAAc,EAAE,MAAM,GACrB,MAAM,CA2BR;AAED,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,GAAG,IAAI,kBASvD,CAAC;AAEF;;;;;;GAMG;AAEH,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,QAAQ,MAAM,EAAE,EAChB,gBAAgB,MAAM,KACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAcvB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAQ,oBAGP,KACA,OAAO,CAAC,IAAI,CA2Bd,CAAC"}

package/dist/utils/timezone.d.ts

@@ -1,9 +1,12 @@
 /**
- * Gets the timezone offset in hours for the company's timezone
- * @returns Promise<number> The timezone offset in hours
+ * Gets the timezone offset in hours and timezone name for the company's timezone
+ * @returns Promise<{ offset: number; timezone: string }> The timezone offset in hours and timezone name
  * @throws Error if unable to fetch timezone information
  */
-export declare const getTimezoneOffset: () => Promise<number>;
+export declare const getTimezoneOffset: () => Promise<{
+    offset: number;
+    timezone: string;
+}>;
 /**
  * Converts a UTC/Zulu time to local time based on the provided timezone offset
  * @param zuluTime The UTC/Zulu time to convert

package/dist/utils/timezone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/utils/timezone.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,MAAM,CA6CxD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC1C,gBAAgB,MAAM,KACrB,IAAI,GAAG,SAIT,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAgBX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,EAAE,gBAAgB,MAAM,KAAG,MAoBpE,CAAC"}
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/utils/timezone.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgDtF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAC1C,gBAAgB,MAAM,KACrB,IAAI,GAAG,SAIT,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAgBX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,IAAI,EAAE,gBAAgB,MAAM,KAAG,MAoBpE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@machinemetrics/mm-erp-sdk",
   "description": "A library for syncing data between MachineMetrics and ERP systems",
-  "version": "0.1.8-beta.8",
+  "version": "0.1.8",
   "license": "MIT",
   "author": "machinemetrics",
   "main": "dist/mm-erp-sdk.js",
@@ -33,6 +33,9 @@
     "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/index.ts

@@ -17,13 +17,13 @@ export type { ERPApiConfig } from "./services/erp-api-services/types";
 // MM API client and types
 export { MMApiClient } from "./services/mm-api-service";
 export { MMReceiveLaborTicket } from "./services/mm-api-service";
-export type {  
+export type {
   MMReceiveLaborTicketReason,
   MMReceiveLaborTicketWorkOrderOperation,
   IToRESTApiObject,
 } from "./services/mm-api-service";
 
-export {  
+export {
   MMSendPerson,
   MMSendResource,
   MMSendPart,
@@ -57,7 +57,11 @@ export { getInitialLoadComplete, setInitialLoadComplete } from "./utils";
 // HTTP client factory and types for custom API integrations
 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";
 
 // Application initialization utilities
 export { ApplicationInitializer } from "./utils/application-initializer";
@@ -72,12 +76,16 @@ export { logger } from "./services/reporting-service";
 export type { IERPLaborTicketHandler } from "./types/erp-connector";
 
 // Process drivers and utilities
-export { StandardProcessDrivers, getCachedTimezoneOffset } from "./utils";
+export {
+  StandardProcessDrivers,
+  getCachedTimezoneOffset,
+  getCachedTimezoneName,
+} from "./utils";
 export type { WriteEntitiesToMMResult } from "./utils";
 export { MMBatchValidationError } from "./utils";
 
 // API services
-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 {
@@ -105,6 +113,17 @@ export {
 } from "./services/sql-server-erp-service";
 export type { SQLInput } from "./services/sql-server-erp-service";
 
+// PSQL (Pervasive) services
+export {
+  PsqlService,
+  formatPsqlDate,
+  formatPsqlTime,
+  combinePsqlDateTime,
+  isPsqlDateEmpty,
+  cleanPsqlCharField,
+} from "./services/psql-erp-service";
+export type { PsqlConfiguration } from "./services/psql-erp-service";
+
 // Record tracking services
 export { RecordTrackingManager } from "./services/caching-service/record-tracking-manager";
 export type { RecordTrackingObject } from "./services/caching-service/record-tracking-manager";
@@ -113,4 +132,10 @@ export type { RecordTrackingObject } from "./services/caching-service/record-tra
 export { default as knexDatabaseConfig } from "./knexfile";
 
 // MM Connector Logging
-export { MMConnectorLogger, FileLogDeduper, LogEntry, type LogLevelString, type LogResponse } from './utils'; 
+export {
+  MMConnectorLogger,
+  FileLogDeduper,
+  LogEntry,
+  type LogLevelString,
+  type LogResponse,
+} from "./utils";

package/src/services/data-sync-service/configuration-manager.ts

@@ -92,6 +92,39 @@ export class CoreConfiguration {
     }
     return CoreConfiguration.instance;
   }
+
+  /**
+   * Returns a sanitized version of the configuration for safe logging.
+   * Masks sensitive fields like authentication tokens.
+   */
+  public toSafeLogObject(): Record<string, unknown> {
+    const maskSensitiveValue = (value: string): string => {
+      if (!value || value.length === 0) {
+        return "";
+      }
+      if (value.length < 6) {
+        return "********";
+      }
+      // Show first 3 and last 3 characters, mask the middle
+      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,
+    };
+  }
 }
 
 /**

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

@@ -0,0 +1,7 @@
+export interface PsqlConfiguration {
+  host: string;
+  port: string;
+  database: string;
+  username: string;
+  password: string;
+}

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

@@ -0,0 +1,22 @@
+import { PsqlService } from "./psql-service";
+
+/**
+ * A class to manage interactions with PSQL (Pervasive) databases via ODBC
+ */
+export { PsqlService };
+
+/**
+ * Configuration interface for PSQL connections
+ */
+export type { PsqlConfiguration } from "./configuration";
+
+/**
+ * Helper functions for PSQL data formatting
+ */
+export {
+  formatPsqlDate,
+  formatPsqlTime,
+  combinePsqlDateTime,
+  isPsqlDateEmpty,
+  cleanPsqlCharField,
+} from "./psql-helpers";

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

@@ -0,0 +1,13 @@
+/**
+ * PSQL-specific type definitions
+ */
+
+export interface OdbcError {
+  state: string;
+  message: string;
+  code?: number;
+}
+
+export interface OdbcErrorResponse extends Error {
+  odbcErrors?: OdbcError[];
+}

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

@@ -0,0 +1,114 @@
+/**
+ * Helper functions for PSQL/Pervasive database operations
+ */
+
+/**
+ * Formats a date from PSQL YYMMDD format to ISO date string
+ * @param psqlDate Date in YYMMDD format (e.g., "250105" for Jan 5, 2025)
+ * @returns ISO date string (e.g., "2025-01-05") or null if invalid
+ */
+export function formatPsqlDate(psqlDate: string): string | null {
+  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);
+
+    // Convert 2-digit year to 4-digit (assuming 2000s)
+    const fullYear = year + 2000;
+
+    // Basic validation
+    if (month < 1 || month > 12 || day < 1 || day > 31) {
+      return null;
+    }
+
+    const date = new Date(fullYear, month - 1, day);
+    // Validate that the constructed date matches the input values
+    if (
+      date.getFullYear() !== fullYear ||
+      date.getMonth() !== (month - 1) ||
+      date.getDate() !== day
+    ) {
+      return null;
+    }
+    return date.toISOString().split("T")[0];
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Formats a time from PSQL HHMM format to HH:MM:SS
+ * @param psqlTime Time in HHMM format (e.g., "1430" for 2:30 PM)
+ * @returns Time string in HH:MM:SS format or null if invalid
+ */
+export function formatPsqlTime(psqlTime: string): string | null {
+  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;
+    }
+    // Pad hours and minutes to 2 digits
+    const hoursStr = hours.toString().padStart(2, "0");
+    const minutesStr = minutes.toString().padStart(2, "0");
+    return `${hoursStr}:${minutesStr}:00`;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Combines PSQL date and time into ISO datetime string
+ * @param psqlDate Date in YYMMDD format
+ * @param psqlTime Time in HHMM format
+ * @returns ISO datetime string or null if invalid
+ */
+export function combinePsqlDateTime(
+  psqlDate: string,
+  psqlTime: string
+): string | null {
+  const date = formatPsqlDate(psqlDate);
+  const time = formatPsqlTime(psqlTime);
+
+  if (!date || !time) {
+    return null;
+  }
+
+  return `${date}T${time}`;
+}
+
+/**
+ * Helper to check if a PSQL date is "empty" (000000 or blank)
+ */
+export function isPsqlDateEmpty(psqlDate: string): boolean {
+  return !psqlDate || psqlDate === "000000" || psqlDate.trim() === "";
+}
+
+/**
+ * Clean and trim PSQL CHAR field (removes trailing spaces)
+ * PSQL CHAR fields are fixed-width and padded with spaces
+ */
+export function cleanPsqlCharField(value: string | null | undefined): string {
+  if (value === null || value === undefined) {
+    return "";
+  }
+  return String(value).trim();
+}