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

package/dist/services/sql-server-erp-service/internal/sql-transaction-manager.js

@@ -0,0 +1,36 @@
+import sql from "mssql";
+import logger from "../../reporting-service/logger.js";
+export class SQLTransactionManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Executes a transaction with the given operation and data, manages rollbacks
+     * @param operation The SQLTransactionOperation to execute
+     * @param data The sql input parameters to pass to the operation
+     * @param config The configuration for the transaction
+     * @returns The result of the operation; throws exceptions on failures
+     */
+    async executeTransaction(operation, data, config = {}) {
+        const transaction = new sql.Transaction(this.connection);
+        const isolationLevel = config.isolationLevel || sql.ISOLATION_LEVEL.READ_COMMITTED;
+        try {
+            await transaction.begin(isolationLevel);
+            const result = await operation.execute(transaction, data);
+            await transaction.commit();
+            return result;
+        }
+        catch (error) {
+            logger.error("Transaction error:", error);
+            try {
+                await transaction.rollback();
+            }
+            catch (rollbackError) {
+                logger.error("Rollback error:", rollbackError);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=sql-transaction-manager.js.map

package/dist/services/sql-server-erp-service/internal/sql-transaction-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-transaction-manager.js","sourceRoot":"","sources":["../../../../src/services/sql-server-erp-service/internal/sql-transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,OAAO,CAAC;AACxB,OAAO,MAAM,MAAM,mCAAmC,CAAC;AAUvD,MAAM,OAAO,qBAAqB;IACZ;IAApB,YAAoB,UAA8B;QAA9B,eAAU,GAAV,UAAU,CAAoB;IAAG,CAAC;IACtD;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CACtB,SAAwC,EACxC,IAAO,EACP,SAA+B,EAAE;QAEjC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzD,MAAM,cAAc,GAClB,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC,eAAe,CAAC,cAAc,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC1D,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC/B,CAAC;YAAC,OAAO,aAAa,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,aAAa,CAAC,CAAC;YACjD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/services/sql-server-erp-service/internal/types/sql-server-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sql-server-types.js.map

package/dist/services/sql-server-erp-service/internal/types/sql-server-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-server-types.js","sourceRoot":"","sources":["../../../../../src/services/sql-server-erp-service/internal/types/sql-server-types.ts"],"names":[],"mappings":""}

package/dist/services/sql-server-erp-service/sql-server-helpers.d.ts

@@ -1,6 +1,6 @@
-import { MMReceiveLaborTicket } from "../mm-api-service/types/receive-types";
-import { SqlServerService } from "./sql-server-service";
-import { SQLInput } from "./types/sql-input-param";
+import { MMReceiveLaborTicket } from "../mm-api-service/types/receive-types.js";
+import { SqlServerService } from "./sql-server-service.js";
+import { SQLInput } from "./types/sql-input-param.js";
 export declare class SqlServerHelper {
     /**
      * Creates a new labor ticket in the SQL Server database

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

@@ -1 +1 @@
-{"version":3,"file":"sql-server-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/sql-server-erp-service/sql-server-helpers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,qBAAa,eAAe;IAC1B;;;;;;;;;;;OAWG;WACU,iBAAiB,CAC5B,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,oBAAoB,EACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC;IAwBhC;;;;;;;;;;OAUG;WACU,iBAAiB,CAC5B,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,oBAAoB,EACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI;CAUhD"}
+{"version":3,"file":"sql-server-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/sql-server-erp-service/sql-server-helpers.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,qBAAa,eAAe;IAC1B;;;;;;;;;;;OAWG;WACU,iBAAiB,CAC5B,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,oBAAoB,EACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC;IAwBhC;;;;;;;;;;OAUG;WACU,iBAAiB,CAC5B,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,oBAAoB,EACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI;CAUhD"}

package/dist/services/sql-server-erp-service/sql-server-helpers.js

@@ -0,0 +1,66 @@
+import { SQLTransactionManager } from "./internal/sql-transaction-manager.js";
+import { SQLLaborTicketInsertOperation, SQLLaborTicketUpdateOperation, } from "./internal/sql-labor-ticket-operations.js";
+import logger from "../reporting-service/logger.js";
+export class SqlServerHelper {
+    /**
+     * Creates a new labor ticket in the SQL Server database
+     * Opens but does not close the connection
+     *
+     * @param sqlServerService  The SQL Server service to use for connections
+     * @param laborTicket       The labor ticket to create
+     * @param sqlInputs         The SQL query parameters
+     * @param insertQuery       The SQL query to execute for insertion
+     *
+     * @returns The processed labor ticket, with the ERP's laborTicketId set
+     * Throws exceptions on failures, including if the query does not return a laborTicketId
+     */
+    static async createLaborTicket(sqlServerService, laborTicket, sqlInputs, insertQuery) {
+        const connection = await sqlServerService.openConnection();
+        if (!connection) {
+            throw new Error("Unable to establish database connection to create labor ticket.");
+        }
+        const transactionManager = new SQLTransactionManager(connection);
+        const laborTicketId = await transactionManager.executeTransaction(new SQLLaborTicketInsertOperation(insertQuery), sqlInputs);
+        if (laborTicketId) {
+            laborTicket.laborTicketId = laborTicketId.toString();
+            return laborTicket;
+        }
+        else {
+            throw new Error(`The query did not return the labor ticket id for labor ticket ref: ${laborTicket.laborTicketRef}`);
+        }
+    }
+    /**
+     * Updates an existing labor ticket in the SQL Server database
+     * Opens but does not close the connection
+     * @param sqlServerService  The SQL Server service to use for connections
+     * @param laborTicket       The labor ticket to update
+     * @param sqlInputs         The SQL query parameters
+     * @param updateQuery       The SQL query to execute for update
+     *
+     * @returns The processed labor ticket
+     * Throws exceptions on failures
+     */
+    static async updateLaborTicket(sqlServerService, laborTicket, sqlInputs, updateQuery) {
+        const connection = await sqlServerService.openConnection();
+        if (!connection) {
+            throw new Error("Unable to establish database connection to update labor ticket.");
+        }
+        const transactionManager = new SQLTransactionManager(connection);
+        await transactionManager.executeTransaction(new SQLLaborTicketUpdateOperation(updateQuery), sqlInputs);
+        return laborTicket;
+    }
+    /**
+     * Logs the SQL input parameters for debugging
+     */
+    static logQueryInputs(inputs) {
+        logger.info("SQL Input Variables:");
+        logger.info("----------------------------------------");
+        logger.info("Variable Name         | Value");
+        logger.info("----------------------------------------");
+        inputs.forEach((input) => {
+            logger.info(`${input.name.padEnd(20)} | ${input.value}`);
+        });
+        logger.info("----------------------------------------");
+    }
+}
+//# sourceMappingURL=sql-server-helpers.js.map

package/dist/services/sql-server-erp-service/sql-server-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-server-helpers.js","sourceRoot":"","sources":["../../../src/services/sql-server-erp-service/sql-server-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,2CAA2C,CAAC;AAGnD,OAAO,MAAM,MAAM,gCAAgC,CAAC;AAGpD,MAAM,OAAO,eAAe;IAC1B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,gBAAkC,EAClC,WAAiC,EACjC,SAAqB,EACrB,WAAmB;QAEnB,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,cAAc,EAAE,CAAC;QAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,kBAAkB,CAC/D,IAAI,6BAA6B,CAAC,WAAW,CAAC,EAC9C,SAAS,CACV,CAAC;QAEF,IAAI,aAAa,EAAE,CAAC;YAClB,WAAW,CAAC,aAAa,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC;YACrD,OAAO,WAAW,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,sEAAsE,WAAW,CAAC,cAAc,EAAE,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,gBAAkC,EAClC,WAAiC,EACjC,SAAqB,EACrB,WAAmB;QAEnB,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,cAAc,EAAE,CAAC;QAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;QACJ,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,kBAAkB,CAAC,kBAAkB,CACzC,IAAI,6BAA6B,CAAC,WAAW,CAAC,EAC9C,SAAS,CACV,CAAC;QAEF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAkB;QACtC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACxD,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/services/sql-server-erp-service/sql-server-service.d.ts

@@ -1,6 +1,6 @@
 import { ConnectionPool, IRecordSet } from "mssql";
-import { ERPResponse } from "../../types/erp-types";
-import { SQLServerConfiguration } from "./configuration";
+import { ERPResponse } from "../../types/erp-types.js";
+import { SQLServerConfiguration } from "./configuration.js";
 type PagingParams = {
     limit?: number;
     offset?: number;

package/dist/services/sql-server-erp-service/sql-server-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-server-service.d.ts","sourceRoot":"","sources":["../../../src/services/sql-server-erp-service/sql-server-service.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,EAAE,sBAAsB;IAIpC,OAAO;IAIb;;;;;;;OAOG;IACU,wBAAwB,CACnC,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAsEnC;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;IA4C/C;;;;OAIG;WACW,kBAAkB,CAC9B,SAAS,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAab,eAAe;CAgB9B"}
+{"version":3,"file":"sql-server-service.d.ts","sourceRoot":"","sources":["../../../src/services/sql-server-erp-service/sql-server-service.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,EAAE,sBAAsB;IAIpC,OAAO;IAIb;;;;;;;OAOG;IACU,wBAAwB,CACnC,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAsEnC;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;IA4C/C;;;;OAIG;WACW,kBAAkB,CAC9B,SAAS,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAab,eAAe;CAgB9B"}

package/dist/services/sql-server-erp-service/sql-server-service.js

@@ -0,0 +1,154 @@
+import sql from "mssql";
+import { SQLServerConfigSchema } from "./internal/sql-server-config.js";
+import logger from "../reporting-service/logger.js";
+export class SqlServerService {
+    connection = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async dispose() {
+        await this.closeConnection();
+    }
+    /**
+     * Execute a prepared statement and return the results
+     *
+     * @param statementToPrepare The SQL query to prepare
+     * @param params The parameters to bind to the prepared statement
+     * @param paging Optional paging parameters
+     * @returns The entities fetched from the database, along with paging information
+     */
+    async executePreparedStatement(statementToPrepare, params, paging) {
+        const connection = await this.openConnection();
+        const preparedStatement = new sql.PreparedStatement(connection);
+        // Add all parameters as inputs
+        Object.keys(params).forEach((key) => {
+            preparedStatement.input(key, sql.VarChar);
+        });
+        // If limit is specified, try SQL paging
+        const finalQuery = paging?.limit !== undefined
+            ? `${statementToPrepare} OFFSET ${paging.offset || 0} ROWS FETCH NEXT ${paging.limit} ROWS ONLY`
+            : statementToPrepare;
+        await preparedStatement.prepare(finalQuery);
+        let records;
+        try {
+            records = await preparedStatement.execute(params);
+        }
+        catch (error) {
+            const errorInfo = error;
+            const errorMessage = "Error fetching data from ERP -> " +
+                (errorInfo.cause ? `Cause: ${errorInfo.cause}. ` : "") +
+                `Name: ${errorInfo.name}. ` +
+                `Message: ${errorInfo.message}. ` +
+                `Stack: ${errorInfo.stack}`;
+            throw new Error(errorMessage);
+        }
+        finally {
+            try {
+                await preparedStatement.unprepare();
+            }
+            catch (unprepareError) {
+                logger.error("Error during unprepare:", unprepareError);
+            }
+        }
+        const allRecords = SqlServerService.recordsetToRecords(records?.recordset);
+        const rowsFetched = records?.rowsAffected[0] || 0;
+        // If SQL paging failed or we need to handle offset, apply in-memory paging
+        const pagedData = paging?.offset !== undefined
+            ? allRecords.slice(paging.offset, (paging.offset || 0) + (paging.limit || allRecords.length))
+            : allRecords;
+        return {
+            data: pagedData,
+            paging: {
+                count: rowsFetched,
+                limit: paging?.limit || 0,
+                offset: paging?.offset || 0,
+                nextPage: (() => {
+                    const currentPageEnd = (paging?.offset || 0) + (paging?.limit || 0);
+                    return paging?.limit && currentPageEnd < rowsFetched
+                        ? String(currentPageEnd)
+                        : undefined;
+                })(),
+                previousPage: paging?.offset
+                    ? String(Math.max(0, (paging.offset || 0) - (paging.limit || 10)))
+                    : undefined,
+            },
+        };
+    }
+    /**
+     * Opens a connection to SQL Server
+     * Caches the connection so that it can be reused.
+     * On failure to connect, throws
+     */
+    async openConnection() {
+        // If we have a connection and it's still connected, reuse it
+        if (this.connection?.connected) {
+            logger.debug("Reusing existing SQL Server connection");
+            return this.connection;
+        }
+        // If we have a connection but it's not connected, just null it out
+        if (this.connection) {
+            logger.debug("Clearing disconnected SQL Server connection");
+            this.connection = null;
+        }
+        try {
+            logger.info("Opening new SQL Server connection");
+            const sqlConfig = SQLServerConfigSchema.parse({
+                user: this.config.username,
+                password: this.config.password,
+                database: this.config.database,
+                server: this.config.host,
+                port: parseInt(this.config.port),
+                connectionTimeout: parseInt(this.config.connectionTimeout),
+                requestTimeout: parseInt(this.config.requestTimeout),
+                pool: {
+                    max: parseInt(this.config.poolMax),
+                    min: parseInt(this.config.poolMin),
+                    idleTimeoutMillis: parseInt(this.config.idleTimeoutMillis),
+                },
+                options: {
+                    encrypt: this.config.encrypt,
+                    trustServerCertificate: this.config.trustServer,
+                },
+            });
+            this.connection = await sql.connect(sqlConfig);
+            return this.connection;
+        }
+        catch (error) {
+            logger.error("SqlServerService>>openConnection>> Connection failed", {
+                error,
+            });
+            throw new Error("SQL Server connection failed");
+        }
+    }
+    /**
+     * Transform a IRecordSet from a SQL query into an array of Record<string, string> instances.
+     * @param recordset IRecordSet from a SQL query
+     * @returns array of Record<string, string> instances
+     */
+    static recordsetToRecords(recordset) {
+        const data = recordset?.map((row) => {
+            const transformedRow = {};
+            Object.keys(row).forEach((key) => {
+                transformedRow[key] = row[key]?.toString() || "";
+            });
+            return transformedRow;
+        }) || [];
+        return data;
+    }
+    async closeConnection() {
+        if (this.connection?.connected) {
+            logger.info("Closing SQL Server connection");
+            try {
+                await this.connection.close();
+            }
+            catch (error) {
+                logger.error("SqlServerService::closeConnection: Error closing connection", {
+                    error,
+                });
+            }
+            this.connection = null;
+        }
+    }
+}
+//# sourceMappingURL=sql-server-service.js.map

package/dist/services/sql-server-erp-service/sql-server-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-server-service.js","sourceRoot":"","sources":["../../../src/services/sql-server-erp-service/sql-server-service.ts"],"names":[],"mappings":"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"}

package/dist/services/sql-server-erp-service/types/sql-input-param.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sql-input-param.js.map

package/dist/services/sql-server-erp-service/types/sql-input-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-input-param.js","sourceRoot":"","sources":["../../../../src/services/sql-server-erp-service/types/sql-input-param.ts"],"names":[],"mappings":""}

package/dist/services/sqlite-service/index.d.ts

@@ -1,2 +1,2 @@
-export { SQLiteCoordinator } from "./sqlite-coordinator";
+export { SQLiteCoordinator } from "./sqlite-coordinator.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/services/sqlite-service/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/sqlite-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/sqlite-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/services/sqlite-service/index.js

@@ -0,0 +1,2 @@
+export { SQLiteCoordinator } from "./sqlite-coordinator.js";
+//# sourceMappingURL=index.js.map

package/dist/services/sqlite-service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/sqlite-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/services/sqlite-service/sqlite-coordinator.js

@@ -0,0 +1,60 @@
+import { acquireDatabaseLock, releaseDatabaseLock, getDatabaseLock, } from "../../utils/local-data-store/database-lock.js";
+import { logger } from "../reporting-service/index.js";
+export class SQLiteCoordinator {
+    static LOCK_TIMEOUT_MS = 30_000; // 30 seconds
+    static LOCK_RETRY_INTERVAL_MS = 1_000; // 1 second
+    /**
+     * Performs startup checks to ensure no stale locks exist
+     * Should be called when the application starts
+     */
+    static async performStartupCheck() {
+        const currentLock = getDatabaseLock();
+        if (currentLock.isLocked) {
+            logger.warn(`Found existing lock held by ${currentLock.lockedBy}, releasing for clean startup`);
+            releaseDatabaseLock(currentLock.lockedBy);
+        }
+    }
+    /**
+     * Attempts to acquire the database lock
+     * @param processName Name of the process requesting the lock
+     * @returns true if lock was acquired, false if database is already locked
+     */
+    static async tryAcquireLock(processName) {
+        return acquireDatabaseLock(processName);
+    }
+    /**
+     * Executes a database operation with proper locking
+     * @param processName Name of the process executing the operation
+     * @param operation The operation to execute
+     * @returns The result of the operation
+     */
+    static async executeWithLock(processName, operation) {
+        const startTime = Date.now();
+        // Try to acquire the lock with timeout
+        while (Date.now() - startTime < this.LOCK_TIMEOUT_MS) {
+            if (await this.tryAcquireLock(processName)) {
+                try {
+                    // Execute the operation
+                    const result = await operation();
+                    return result;
+                }
+                finally {
+                    // Always release the lock
+                    releaseDatabaseLock(processName);
+                }
+            }
+            // Wait before retrying
+            await new Promise((resolve) => setTimeout(resolve, this.LOCK_RETRY_INTERVAL_MS));
+        }
+        throw new Error(`Failed to acquire database lock after ${this.LOCK_TIMEOUT_MS}ms`);
+    }
+    /**
+     * Checks if the database is currently available for operations
+     * @returns true if the database is available, false if locked
+     */
+    static isAvailable() {
+        const lock = getDatabaseLock();
+        return !lock.isLocked;
+    }
+}
+//# sourceMappingURL=sqlite-coordinator.js.map

package/dist/services/sqlite-service/sqlite-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-coordinator.js","sourceRoot":"","sources":["../../../src/services/sqlite-service/sqlite-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,GAChB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD,MAAM,OAAO,iBAAiB;IACpB,MAAM,CAAU,eAAe,GAAG,MAAM,CAAC,CAAC,aAAa;IACvD,MAAM,CAAU,sBAAsB,GAAG,KAAK,CAAC,CAAC,WAAW;IAEnE;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,mBAAmB;QAC9B,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;QAEtC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,+BAA+B,WAAW,CAAC,QAAQ,+BAA+B,CACnF,CAAC;YACF,mBAAmB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,WAAmB;QACrD,OAAO,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,eAAe,CAC1B,WAAmB,EACnB,SAA2B;QAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,uCAAuC;QACvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACrD,IAAI,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC;oBACH,wBAAwB;oBACxB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;oBACjC,OAAO,MAAM,CAAC;gBAChB,CAAC;wBAAS,CAAC;oBACT,0BAA0B;oBAC1B,mBAAmB,CAAC,WAAW,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YAED,uBAAuB;YACvB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,sBAAsB,CAAC,CACjD,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,eAAe,IAAI,CAClE,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW;QAChB,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;IACxB,CAAC"}

package/dist/types/erp-connector.d.ts

@@ -1,4 +1,4 @@
-import { MMReceiveLaborTicket } from "../services/mm-api-service/types/receive-types";
+import { MMReceiveLaborTicket } from "../services/mm-api-service/types/receive-types.js";
 /**
  * Interface for ERP connectors.
  *
@@ -11,6 +11,10 @@ export interface IERPConnector {
     readonly type: string;
     /**
      * Sync data from the ERP system to MM.
+     * Timezone expectations:
+     * - When sending ERP data to MachineMetrics (e.g., via StandardProcessDrivers or MMEntityProcessor),
+     *   connectors MUST convert all datetime fields to ISO-8601 UTC strings (trailing `Z` or explicit offset)
+     *   before invoking SDK helpers. The SDK validates/forwards these values but does not apply timezone shifts.
      */
     syncFromERP(): Promise<void>;
     syncFromERPCompleted(): Promise<void>;
@@ -25,12 +29,15 @@ export interface IERPConnector {
     retryFailedLaborTickets(): Promise<void>;
     retryFailedLaborTicketsCompleted(): Promise<void>;
     /**
-     * Start the connector. Typically a connector should delegate control to the data-sync-service.
+     * Start the connector. Typically a connector should delegate control to the data-sync-service via runDataSyncService().
      */
     startUp(): Promise<void>;
 }
 /**
  * Interface for standard process methods that call ERP connectors back to create or update labor tickets.
+ *
+ * Timestamp fields on `MMReceiveLaborTicket` objects have already been converted by the SDKfrom MM's
+ * UTC API responses into the ERP's local timezone, based on the company's timezone setting.
  */
 export interface IERPLaborTicketHandler {
     createLaborTicketInERP(laborTicket: MMReceiveLaborTicket): Promise<{

package/dist/types/erp-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"erp-connector.d.ts","sourceRoot":"","sources":["../../src/types/erp-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAEtF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAE5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sBAAsB,CACpB,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC;QAAE,WAAW,EAAE,oBAAoB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,sBAAsB,CACpB,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC"}
+{"version":3,"file":"erp-connector.d.ts","sourceRoot":"","sources":["../../src/types/erp-connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AAEzF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAE5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,sBAAsB,CACpB,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC;QAAE,WAAW,EAAE,oBAAoB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,sBAAsB,CACpB,WAAW,EAAE,oBAAoB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC"}

package/dist/types/erp-connector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=erp-connector.js.map

package/dist/types/erp-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-connector.js","sourceRoot":"","sources":["../../src/types/erp-connector.ts"],"names":[],"mappings":""}

package/dist/types/erp-types.js

@@ -0,0 +1,13 @@
+export var ERPObjType;
+(function (ERPObjType) {
+    ERPObjType[ERPObjType["RESOURCES"] = 0] = "RESOURCES";
+    ERPObjType[ERPObjType["PARTS"] = 1] = "PARTS";
+    ERPObjType[ERPObjType["PART_OPERATION"] = 2] = "PART_OPERATION";
+    ERPObjType[ERPObjType["WORK_ORDERS"] = 3] = "WORK_ORDERS";
+    ERPObjType[ERPObjType["WORK_ORDER_OPERATIONS"] = 4] = "WORK_ORDER_OPERATIONS";
+    ERPObjType[ERPObjType["PERSONS"] = 5] = "PERSONS";
+    ERPObjType[ERPObjType["REASONS"] = 6] = "REASONS";
+    ERPObjType[ERPObjType["LABOR_TICKETS"] = 7] = "LABOR_TICKETS";
+    // TO DO: TIMESHEETS support
+})(ERPObjType || (ERPObjType = {}));
+//# sourceMappingURL=erp-types.js.map

package/dist/types/erp-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-types.js","sourceRoot":"","sources":["../../src/types/erp-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAUX;AAVD,WAAY,UAAU;IACpB,qDAAS,CAAA;IACT,6CAAK,CAAA;IACL,+DAAc,CAAA;IACd,yDAAW,CAAA;IACX,6EAAqB,CAAA;IACrB,iDAAO,CAAA;IACP,iDAAO,CAAA;IACP,6DAAa,CAAA;IACb,4BAA4B;AAC9B,CAAC,EAVW,UAAU,KAAV,UAAU,QAUrB"}

package/dist/types/flattened-work-order.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Canonical representation of a flattened work order row that contains the
+ * information needed to build MM work order entities plus their operations.
+ *
+ * All properties are optional to maintain backwards compatibility with
+ * existing connectors.
+ */
+export interface FlattenedWorkOrderPartFields {
+    /** ERP part number (required for Parts when present). */
+    partNumber?: string | number;
+    /** ERP part revision or version string. */
+    partRevision?: string | number;
+    /** Routing/method identifier (defaults to "Standard" when omitted). */
+    method?: string;
+}
+export interface FlattenedWorkOrderPartOperationFields {
+    /** Sequence number of the operation on the routing. */
+    sequenceNumber?: string | number;
+    /** Resource or machine identifier responsible for the operation. */
+    resourceId?: string | number;
+    /** Operation cycle time expressed in milliseconds. */
+    cycleTimeMs?: number;
+    /** Operation setup time expressed in milliseconds. */
+    setupTimeMs?: number;
+    /** Human-readable description of the operation. */
+    operationDescription?: string;
+    /** Quantity of parts operated on per cycle. */
+    quantityPerPart?: number;
+}
+export interface FlattenedWorkOrderFields extends FlattenedWorkOrderPartFields {
+    /** Unique identifier for the work order in the ERP. */
+    workOrderId?: string | number;
+    /** Lot number (if the ERP distinguishes lots). */
+    lot?: string | number;
+    /** Split identifier (if the ERP splits orders). */
+    split?: string | number;
+    /** Sub identifier (for multi-level orders). */
+    sub?: string | number;
+    /** Work order status (e.g., Open, Closed, Released). */
+    status?: string;
+    /**
+     * Due date expressed as an ISO-8601 UTC string (trailing `Z` or explicit offset).
+     * The SDK validates but does not shift timezones.
+     */
+    dueDate?: string;
+    /** Free-form description of the work order. */
+    description?: string;
+    /** Scheduled start datetime in ISO-8601 UTC form. */
+    scheduledStartDate?: string;
+    /** Scheduled end datetime in ISO-8601 UTC form. */
+    scheduledEndDate?: string;
+    /** Closed datetime in ISO-8601 UTC form. */
+    closedDate?: string;
+    /** Quantity required by the work order. */
+    quantityRequired?: number;
+}
+export interface FlattenedWorkOrderOperationFields {
+    /** Work order identifier (repeated for each operation). */
+    workOrderId?: string | number;
+    /** Lot identifier for the operation row. */
+    lot?: string | number;
+    /** Split identifier for the operation row. */
+    split?: string | number;
+    /** Sub identifier for the operation row. */
+    sub?: string | number;
+    /** Sequence number for the specific operation. */
+    sequenceNumber?: string | number;
+    /** Resource or machine identifier for the operation. */
+    resourceId?: string | number;
+    /** Quantity started on the operation. */
+    startQuantity?: number;
+    /** Quantity finished on the operation. */
+    finishQuantity?: number;
+    /** Expected reject percentage (0-1). */
+    expectedRejectRate?: number;
+    /** Scheduled start datetime (ISO-8601 UTC). */
+    opScheduledStartDate?: string;
+    /** Scheduled finish datetime (ISO-8601 UTC). */
+    opScheduledFinishDate?: string;
+    /** Closed datetime for the operation (ISO-8601 UTC). */
+    opClosedDate?: string;
+    /** Production burden rate per hour. */
+    productionburdenRateHourly?: number | string;
+    /** Setup burden rate per hour. */
+    setupburdenRatehourly?: number | string;
+    /** Operation type (Production, Setup, etc.). */
+    operationType?: string;
+    /** Quantity per part for the operation. */
+    quantityPerPart?: number;
+    /** Operation status (defaults to work-order status when omitted). */
+    opStatus?: string;
+}
+export type FlattenedWorkOrderRowBase = FlattenedWorkOrderPartFields & FlattenedWorkOrderPartOperationFields & FlattenedWorkOrderFields & FlattenedWorkOrderOperationFields;
+/**
+ * Canonical flattened row that callers pass into
+ * `StandardProcessDrivers.syncWorkOrderBatchFromFlattened`.
+ */
+export type FlattenedWorkOrderRow = FlattenedWorkOrderRowBase;
+//# sourceMappingURL=flattened-work-order.d.ts.map

package/dist/types/flattened-work-order.d.ts.map

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

package/dist/types/flattened-work-order.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flattened-work-order.js.map

package/dist/types/flattened-work-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattened-work-order.js","sourceRoot":"","sources":["../../src/types/flattened-work-order.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@
  * Type definitions for the MachineMetrics ERP Connector SDK.
  * This file re-exports all type definitions that are part of the public API.
  */
-export type { IERPConnector } from "./erp-connector";
-export type { ERPObjType, ERPPagination, ERPResponse, ERPObject, } from "./erp-types";
+export type { IERPConnector } from "./erp-connector.js";
+export type { ERPObjType, ERPPagination, ERPResponse, ERPObject, } from "./erp-types.js";
+export type { FlattenedWorkOrderRow, FlattenedWorkOrderRowBase, FlattenedWorkOrderPartFields, FlattenedWorkOrderPartOperationFields, FlattenedWorkOrderFields, FlattenedWorkOrderOperationFields, } from "./flattened-work-order.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,SAAS,GACV,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,EAC5B,qCAAqC,EACrC,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,2BAA2B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for the MachineMetrics ERP Connector SDK.
+ * This file re-exports all type definitions that are part of the public API.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}