@machinemetrics/mm-erp-sdk 0.1.9-beta.2 → 0.1.9-beta.4

package/dist/utils/standard-process-drivers/mm-entity-processor.js

@@ -0,0 +1,168 @@
+import { ERPObjType } from "../../types/erp-types.js";
+import { MMApiClient } from "../../services/mm-api-service/mm-api-service.js";
+import { MMBatchValidationError, } from "./standard-process-drivers.js";
+import { ErrorProcessor } from "./error-processor.js";
+/**
+ * Handles processing of entities to the MachineMetrics API
+ */
+export class MMEntityProcessor {
+    /**
+     * Writes entities to MM API with deduplication and caching
+     */
+    static async writeEntities(entityType, mmRecords, batchCacheManager) {
+        const { toProcess, result } = await this._prepareAndDedupe(entityType, mmRecords, batchCacheManager);
+        if (toProcess.length === 0) {
+            result.message =
+                "All records were deduplicated locally - no records sent to MM API";
+            return result;
+        }
+        let mmApiResponse;
+        try {
+            mmApiResponse = await this._sendToAPI(entityType, toProcess);
+        }
+        catch (exception) {
+            this._handleException(exception, entityType, result);
+        }
+        return await this._handleResponse(mmApiResponse, entityType, toProcess, result, batchCacheManager);
+    }
+    // ============================================================================
+    // PRIVATE HELPER METHODS
+    // ============================================================================
+    /**
+     * Deduplicates records against cache
+     * Returns the records to process and the result object
+     * If the batchCacheManager is provided, the records are deduplicated against the cache
+     * If the batchCacheManager is not provided, the records are not deduplicated
+     */
+    static async _prepareAndDedupe(entityType, mmRecords, batchCacheManager) {
+        let toProcess = [];
+        const result = {
+            message: "",
+            upsertedEntities: 0,
+            localDedupeCount: 0,
+            apiDedupeCount: 0,
+        };
+        if (batchCacheManager) {
+            const { nonDuplicates, duplicates } = (await batchCacheManager.dedupeBatch(entityType, mmRecords));
+            toProcess = nonDuplicates;
+            result.localDedupeCount = duplicates.length;
+        }
+        else {
+            toProcess = mmRecords;
+        }
+        return { toProcess, result };
+    }
+    /**
+     * Sends records to MM API
+     */
+    static async _sendToAPI(entityType, toProcess) {
+        const mmApiClient = new MMApiClient();
+        switch (entityType) {
+            case ERPObjType.PERSONS:
+                return await mmApiClient.sendPersonsToMM(toProcess);
+            case ERPObjType.RESOURCES:
+                return await mmApiClient.sendResourcesToMM(toProcess);
+            case ERPObjType.PARTS:
+                return await mmApiClient.sendPartsToMM(toProcess);
+            case ERPObjType.PART_OPERATION:
+                return await mmApiClient.sendPartOperationsToMM(toProcess);
+            case ERPObjType.WORK_ORDERS:
+                return await mmApiClient.sendWorkOrdersToMM(toProcess);
+            case ERPObjType.WORK_ORDER_OPERATIONS:
+                return await mmApiClient.sendWorkOrderOperationsToMM(toProcess);
+            case ERPObjType.LABOR_TICKETS:
+                return await mmApiClient.sendLaborTicketsToMM(toProcess);
+            case ERPObjType.REASONS:
+                return await mmApiClient.sendReasonsToMM(toProcess);
+            default:
+                throw new Error(`Unknown entity type: ${entityType}`);
+        }
+    }
+    /**
+     * Handles exceptions from API calls, converting structured 500 errors to MMBatchValidationError
+     * @throws MMBatchValidationError for structured 500 errors
+     * @throws The original exception for all other errors
+     */
+    static _handleException(exception, entityType, result) {
+        // Handle structured 500 errors that may be appropriate for partial failure
+        const structuredCompleteErrorSet = ErrorProcessor.extractErrorDetailsFrom500Exception(exception, entityType);
+        if (structuredCompleteErrorSet) {
+            const ex = exception;
+            const data = ex?.data;
+            const errorMessage = typeof data?.error === "string"
+                ? data.error
+                : "All entities failed to import";
+            throw new MMBatchValidationError({
+                message: errorMessage,
+                upsertedEntities: 0,
+                localDedupeCount: result.localDedupeCount,
+                apiDedupeCount: 0,
+                errorCount: structuredCompleteErrorSet.errorCount,
+                httpStatus: exception.status,
+                batchErrors: structuredCompleteErrorSet.batchErrors,
+            });
+        }
+        // For all other exceptions, re-throw as-is
+        throw exception;
+    }
+    /**
+     * Handles the MM API response based on HTTP status code, caching successful records
+     * and throwing exceptions for partial failures
+     *
+     * @returns The final result for success cases
+     * @throws MMBatchValidationError for partial success cases
+     * @throws Error for unknown status codes
+     */
+    static async _handleResponse(mmApiResponse, entityType, toProcess, result, batchCacheManager) {
+        if (mmApiResponse.httpStatus === 200) {
+            // Complete success - cache all records
+            if (batchCacheManager) {
+                await batchCacheManager.storeBatch(entityType, toProcess);
+            }
+            if (entityType === ERPObjType.LABOR_TICKETS) {
+                const success = mmApiResponse;
+                result.message = success.message || "Entities processed successfully";
+                result.upsertedEntities =
+                    (success.updated || 0) + (success.inserted || 0);
+            }
+            else {
+                const success = mmApiResponse;
+                result.message = success.message || "Entities processed successfully";
+                result.upsertedEntities = success.affectedRows || 0;
+            }
+            result.apiDedupeCount = toProcess.length - result.upsertedEntities;
+            return result;
+        }
+        else if (mmApiResponse.httpStatus === 207) {
+            // Partial success - cache only successful records before throwing exception
+            const partialResponse = mmApiResponse;
+            const { errorCount, batchErrors } = ErrorProcessor.extractErrorDetails(partialResponse, entityType);
+            if (batchCacheManager) {
+                await ErrorProcessor.cacheSuccessfulRecordsOnPartialFailure(entityType, toProcess, batchErrors, batchCacheManager);
+            }
+            let upsertedEntities = 0;
+            if (entityType === ERPObjType.LABOR_TICKETS) {
+                const partial = partialResponse;
+                upsertedEntities =
+                    (partial.data.updated || 0) + (partial.data.inserted || 0);
+            }
+            else {
+                const partial = partialResponse;
+                upsertedEntities = partial.data.affectedRows || 0;
+            }
+            throw new MMBatchValidationError({
+                message: partialResponse.message || "Entities processed with partial failures",
+                upsertedEntities: upsertedEntities,
+                localDedupeCount: result.localDedupeCount,
+                apiDedupeCount: toProcess.length - upsertedEntities - errorCount,
+                errorCount: errorCount,
+                httpStatus: mmApiResponse.httpStatus,
+                batchErrors: batchErrors,
+            });
+        }
+        else {
+            throw new Error(`writeEntitiesToMM: Unknown HTTP status code: ${mmApiResponse.httpStatus}. An exception was expected.`);
+        }
+    }
+}
+//# sourceMappingURL=mm-entity-processor.js.map

package/dist/utils/standard-process-drivers/mm-entity-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mm-entity-processor.js","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/mm-entity-processor.ts"],"names":[],"mappings":"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"}

package/dist/utils/standard-process-drivers/standard-process-drivers.d.ts

@@ -1,7 +1,7 @@
-import { ERPObjType } from "../../types/erp-types";
-import { IERPLaborTicketHandler } from "../../types/erp-connector";
-import { BatchCacheManager } from "../../services/caching-service/batch-cache-manager";
-import { IToRESTApiObject, MMSendWorkOrderBatch } from "../../services/mm-api-service";
+import { ERPObjType } from "../../types/erp-types.js";
+import { IERPLaborTicketHandler } from "../../types/erp-connector.js";
+import { BatchCacheManager } from "../../services/caching-service/batch-cache-manager.js";
+import { IToRESTApiObject, MMSendWorkOrderBatch } from "../../services/mm-api-service/index.js";
 /**
  * The result of writing entities to the MachineMetrics API on complete success.
  */

package/dist/utils/standard-process-drivers/standard-process-drivers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-process-drivers.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/standard-process-drivers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EAKrB,MAAM,+BAA+B,CAAC;AAIvC;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,WAAW,EAAE,KAAK,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACtC,CAAC,CAAC;gBAES,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,KAAK,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;SACtC,CAAC,CAAC;KACJ;CAUF;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;OAQG;WACU,qBAAqB,CAChC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;OAMG;WACU,uBAAuB,CAClC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwEG;WACU,iBAAiB,CAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,gBAAgB,EAAE,EAC7B,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC,uBAAuB,CAAC;IAQnC;;;;;;;;;;;;;;;OAeG;WACU,uBAAuB,CAClC,cAAc,EAAE,oBAAoB,EACpC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC;QACT,KAAK,EAAE,uBAAuB,CAAC;QAC/B,cAAc,EAAE,uBAAuB,CAAC;QACxC,UAAU,EAAE,uBAAuB,CAAC;QACpC,mBAAmB,EAAE,uBAAuB,CAAC;KAC9C,CAAC;IAuCF;;;;;;;;;;;;;;OAcG;WACU,+BAA+B,CAC1C,aAAa,EAAE,GAAG,EAAE,EACpB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC;QACT,KAAK,EAAE,uBAAuB,CAAC;QAC/B,cAAc,EAAE,uBAAuB,CAAC;QACxC,UAAU,EAAE,uBAAuB,CAAC;QACpC,mBAAmB,EAAE,uBAAuB,CAAC;KAC9C,CAAC;CAkMH"}
+{"version":3,"file":"standard-process-drivers.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/standard-process-drivers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EAKrB,MAAM,wCAAwC,CAAC;AAIhD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,WAAW,EAAE,KAAK,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACtC,CAAC,CAAC;gBAES,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,KAAK,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;SACtC,CAAC,CAAC;KACJ;CAUF;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;OAQG;WACU,qBAAqB,CAChC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;OAMG;WACU,uBAAuB,CAClC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwEG;WACU,iBAAiB,CAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,gBAAgB,EAAE,EAC7B,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC,uBAAuB,CAAC;IAQnC;;;;;;;;;;;;;;;OAeG;WACU,uBAAuB,CAClC,cAAc,EAAE,oBAAoB,EACpC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC;QACT,KAAK,EAAE,uBAAuB,CAAC;QAC/B,cAAc,EAAE,uBAAuB,CAAC;QACxC,UAAU,EAAE,uBAAuB,CAAC;QACpC,mBAAmB,EAAE,uBAAuB,CAAC;KAC9C,CAAC;IAuCF;;;;;;;;;;;;;;OAcG;WACU,+BAA+B,CAC1C,aAAa,EAAE,GAAG,EAAE,EACpB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC;QACT,KAAK,EAAE,uBAAuB,CAAC;QAC/B,cAAc,EAAE,uBAAuB,CAAC;QACxC,UAAU,EAAE,uBAAuB,CAAC;QACpC,mBAAmB,EAAE,uBAAuB,CAAC;KAC9C,CAAC;CAkMH"}

package/dist/utils/standard-process-drivers/standard-process-drivers.js

@@ -0,0 +1,324 @@
+import { ERPObjType } from "../../types/erp-types.js";
+import { MMSendPart, MMSendPartOperation, MMSendWorkOrder, MMSendWorkOrderOperation, } from "../../services/mm-api-service/index.js";
+import { LaborTicketERPSynchronizer } from "./labor-ticket-erp-synchronizer.js";
+import { MMEntityProcessor } from "./mm-entity-processor.js";
+export class MMBatchValidationError extends Error {
+    upsertedEntities;
+    localDedupeCount;
+    apiDedupeCount;
+    errorCount;
+    httpStatus;
+    batchErrors;
+    constructor(options) {
+        super(options.message);
+        this.name = "MMBatchValidationError";
+        this.upsertedEntities = options.upsertedEntities;
+        this.localDedupeCount = options.localDedupeCount;
+        this.apiDedupeCount = options.apiDedupeCount;
+        this.errorCount = options.errorCount;
+        this.httpStatus = options.httpStatus;
+        this.batchErrors = options.batchErrors;
+    }
+}
+/**
+ * A collection of standardized process drivers that orchestrate various synchronization
+ * and integration processes between systems. Use of these drivers is optional,
+ * and useful as a reference implementation for how to implement the various processes.
+ */
+export class StandardProcessDrivers {
+    /**
+     * Synchronizes updated labor tickets from MachineMetrics to an ERP system:
+     *
+     * Initializes a checkpoint that tracks the last time labor tickets were synced,
+     * fetches labor tickets from MM and converts them to the company timezone,
+     * creates or updates the labor ticket in the ERP via connector-specific implementations,
+     * updates the labor ticket id in MM on newly created labor tickets,
+     * and saves the checkpoint
+     */
+    static async syncLaborTicketsToERP(connectorType, connector) {
+        return LaborTicketERPSynchronizer.syncToERP(connectorType, connector);
+    }
+    /**
+     * Retries labor tickets that have failed to be created or updated in the ERP during the sync:
+     *
+     * Fetches failed labor tickets from MM, processes them, and updates the labor ticket id in MM.
+     * If the labor ticket is successfully created or updated, it is added to the list of successful labor ticket ids,
+     * which are then deleted from the list of failed labor ticket ids.
+     */
+    static async retryFailedLaborTickets(connectorType, connector) {
+        return LaborTicketERPSynchronizer.retryFailed(connectorType, connector);
+    }
+    /**
+     * Writes a batch of records to MM for a specific entity type by:
+     * 1. Deduplicating against cached records (localDedupeCount)
+     * 2. Sending non-duplicate records to the MM API (apiDedupeCount)
+     * 3. Storing successful records in cache
+     *
+     * An example usage pattern including comprehensive error handling:
+     * ```
+     * try {
+     *   const result = await StandardProcessDrivers.writeEntitiesToMM(
+     *     'WorkOrders',
+     *     workOrderRecords,
+     *     batchCacheManager
+     *   );
+     *
+     *   // HTTP 200 - Complete success
+     *   console.log(`✅ Success: ${result.message}`);
+     *   console.log(`📊 Metrics: ${result.upsertedEntities} upserted, ${result.localDedupeCount} locally deduplicated, ${result.apiDedupeCount} API deduplicated`);
+     *
+     * } catch (error) {
+     *   if (error instanceof MMBatchValidationError) {
+     *     // HTTP 207 - Partial success with some batches failing due to validation errors
+     *     // HTTP 500 - A specific type representing complete failure due to validation issues;
+     *     //            other 500 types represent failure due to other issues and are not converted to MMBatchValidationError
+     *     // Note: Each batch error contains ALL entities from the failing batch, not necessarily just the failed ones
+     *
+     *     console.log(`⚠️  Batch processing completed with errors (HTTP ${error.httpStatus})`);
+     *     console.log(`📊 Metrics: ${error.upsertedEntities} upserted, ${error.localDedupeCount} locally deduplicated, ${error.apiDedupeCount} API deduplicated`);
+     *     console.log(`❌ Error count: ${error.errorCount}`);
+     *
+     *     // Process specific batch errors for retry or logging
+     *     error.batchErrors.forEach((batchError, index) => {
+     *       console.log(`Batch ${index + 1} error: ${batchError.message}`);
+     *       console.log(`All entities in failing batch:`, batchError.affectedEntities);
+     *
+     *       // Example: Queue entire failing batch for retry (contains both successful and failed entities)
+     *       await queueForRetry(batchError.affectedEntities);
+     *     });
+     *
+     *     // Decide whether to continue or halt based on httpStatus
+     *     if (error.httpStatus === 207) {
+     *       // Partial success - some batches processed successfully, others failed
+     *       console.log('⚠️  Continuing with partial success');
+     *     } else if (error.httpStatus === 500) {
+     *       // Complete failure - all batches failed due to validation issues
+     *       console.log('🛑 Complete failure - no records processed');
+     *       throw error; // Re-throw if complete failure should halt the process
+     *     }
+     *
+     *   } else {
+     *     // Other underlying errors (network issues, authentication, etc.)
+     *     console.error('🚨 Unexpected error during MM API call:', error);
+     *
+     *     // Example: Check for specific error types
+     *     if (error.message?.includes('authentication')) {
+     *       console.error('🔐 Authentication issue - check MM API credentials');
+     *     } else if (error.message?.includes('network') || error.code === 'ECONNREFUSED') {
+     *       console.error('🌐 Network connectivity issue - check MM API endpoint');
+     *     }
+     *
+     *     throw error; // Re-throw for upstream handling
+     *   }
+     * }
+     * ```
+     *
+     * @param entityType The type of entity being processed
+     * @param mmRecords The records to process
+     * @param batchCacheManager The batch cache manager instance; pass in null if caching is not desired
+     *
+     * @returns WriteEntitiesToMMResult on complete success (HTTP 200)
+     * @throws MMBatchValidationError on partial success (HTTP 207) or complete failure (HTTP 500) with structured error details
+     * @throws Error on other underlying issues (network, authentication, etc.)
+     */
+    static async writeEntitiesToMM(entityType, mmRecords, batchCacheManager) {
+        return MMEntityProcessor.writeEntities(entityType, mmRecords, batchCacheManager);
+    }
+    /**
+     * Writes a batch of Work Order related entities to MM maintaining referential integrity by:
+     * 1. Processing parts first (base entities)
+     * 2. Processing part operations (depends on parts)
+     * 3. Processing work orders (depends on parts)
+     * 4. Processing work order operations (depends on work orders and part operations)
+     *
+     * This ensures all foreign key constraints are satisfied and prevents referential integrity errors.
+     *
+     * @param workOrderBatch The batch containing all related entities
+     * @param batchCacheManager The batch cache manager instance; pass in null if caching is not desired
+     *
+     * @returns Combined results from all entity processing
+     * @throws MMBatchValidationError on partial success or complete failure with structured error details
+     * @throws Error on other underlying issues (network, authentication, etc.)
+     */
+    static async writeWorkOrderBatchToMM(workOrderBatch, batchCacheManager) {
+        // Process entities in order to maintain referential integrity
+        // 1. Parts first (no dependencies)
+        const partsResult = await MMEntityProcessor.writeEntities(ERPObjType.PARTS, workOrderBatch.parts, batchCacheManager);
+        // 2. Part Operations (depends on parts)
+        const partOperationsResult = await MMEntityProcessor.writeEntities(ERPObjType.PART_OPERATION, workOrderBatch.partOperations, batchCacheManager);
+        // 3. Work Orders (depends on parts)
+        const workOrdersResult = await MMEntityProcessor.writeEntities(ERPObjType.WORK_ORDERS, workOrderBatch.workOrders, batchCacheManager);
+        // 4. Work Order Operations (depends on work orders and part operations)
+        const workOrderOperationsResult = await MMEntityProcessor.writeEntities(ERPObjType.WORK_ORDER_OPERATIONS, workOrderBatch.workOrderOperations, batchCacheManager);
+        return {
+            parts: partsResult,
+            partOperations: partOperationsResult,
+            workOrders: workOrdersResult,
+            workOrderOperations: workOrderOperationsResult,
+        };
+    }
+    /**
+     * Processes flattened work order data and syncs it to MM maintaining referential integrity.
+     *
+     * This method expects flattened data where each row contains both work order and operation information
+     * with camelCase field names matching the GraphQL schema. It will automatically extract and deduplicate
+     * parts, part operations, work orders, and work order operations, then process them in the correct order
+     * to maintain referential integrity.
+     *
+     * @param flattenedData Array of flattened rows containing both work order and operation data (camelCase fields)
+     * @param batchCacheManager The batch cache manager instance; pass in null if caching is not desired
+     *
+     * @returns Combined results from all entity processing with detailed logging information
+     * @throws MMBatchValidationError on partial success or complete failure with structured error details
+     * @throws Error on other underlying issues (network, authentication, etc.)
+     */
+    static async syncWorkOrderBatchFromFlattened(flattenedData, batchCacheManager) {
+        if (!flattenedData || flattenedData.length === 0) {
+            throw new Error("No flattened work order data provided");
+        }
+        // Process the flattened data - each row contains both work order and operation info
+        const uniqueParts = new Map();
+        const uniquePartOperations = new Map();
+        const uniqueWorkOrders = new Map();
+        const workOrderOperations = [];
+        // Process each flattened row to extract entities
+        for (const row of flattenedData) {
+            // Extract unique parts
+            const partKey = `${row.partNumber}|${row.partRevision}|${row.method}`;
+            if (!uniqueParts.has(partKey)) {
+                uniqueParts.set(partKey, {
+                    partNumber: row.partNumber, // → partNumber
+                    partRevision: row.partRevision, // → partRevision
+                    method: row.method, // → method
+                });
+            }
+            // Extract unique part operations
+            const partOpKey = `${row.partNumber}|${row.partRevision}|${row.method}|${row.sequenceNumber}`;
+            if (!uniquePartOperations.has(partOpKey)) {
+                uniquePartOperations.set(partOpKey, {
+                    partNumber: row.partNumber, // → partNumber
+                    partRevision: row.partRevision, // → partRevision
+                    method: row.method, // → method
+                    sequenceNumber: row.sequenceNumber, // → sequenceNumber
+                    resourceId: row.resourceId, // → resourceId
+                    cycleTimeMs: row.cycleTimeMs, // → cycleTimeMs
+                    setupTimeMs: row.setupTimeMs, // → setupTimeMs
+                    description: row.operationDescription || "", // → description
+                    quantityPerPart: row.quantityPerPart || 1, // → quantityPerPart
+                });
+            }
+            // Extract unique work orders
+            const workOrderKey = row.workOrderId;
+            if (!uniqueWorkOrders.has(workOrderKey)) {
+                uniqueWorkOrders.set(workOrderKey, {
+                    workOrderId: row.workOrderId, // → workOrderId
+                    lot: row.lot, // → lot
+                    split: row.split, // → split
+                    sub: row.sub, // → sub
+                    status: row.status, // → status
+                    dueDate: row.dueDate, // → dueDate
+                    description: row.description, // → description
+                    scheduledStartDate: row.scheduledStartDate, // → scheduledStartDate
+                    scheduledEndDate: row.scheduledEndDate, // → scheduledEndDate
+                    closedDate: row.closedDate, // → closedDate
+                    quantityRequired: row.quantityRequired, // → quantityRequired
+                    partNumber: row.partNumber, // → partNumber
+                    partRevision: row.partRevision, // → partRevision
+                    method: row.method, // → method
+                });
+            }
+            // Add each work order operation (these are not deduplicated since each operation is unique)
+            workOrderOperations.push({
+                workOrderId: row.workOrderId, // → workOrderId
+                lot: row.lot, // → lot
+                split: row.split, // → split
+                sub: row.sub, // → sub
+                sequenceNumber: row.sequenceNumber, // → sequenceNumber
+                resourceId: row.resourceId, // → resourceId
+                startQuantity: row.startQuantity, // → startQuantity
+                finishQuantity: row.finishQuantity, // → finishQuantity
+                expectedRejectRate: row.expectedRejectRate, // → expectedRejectRate
+                scheduledStartDate: row.opScheduledStartDate, // → scheduledStartDate
+                scheduledFinishDate: row.opScheduledFinishDate, // → scheduledFinishDate
+                closedDate: row.opClosedDate, // → closedDate
+                cycleTimeMs: row.cycleTimeMs, // → cycleTimeMs
+                setupTimeMs: row.setupTimeMs, // → setupTimeMs
+                productionburdenRateHourly: row.productionburdenRateHourly, // → productionburdenRateHourly
+                setupburdenRatehourly: row.setupburdenRatehourly, // → setupburdenRatehourly
+                operationType: row.operationType, // → operationType
+                quantityPerPart: row.quantityPerPart, // → quantityPerPart
+                status: row.opStatus || row.status, // → status
+            });
+        }
+        // Transform all the data directly to MM entities
+        const parts = Array.from(uniqueParts.values()).map((item) => new MMSendPart(item.partNumber || "", // partNumber
+        item.partRevision || "", // partRevision
+        item.method || "Standard" // method
+        ));
+        const partOperations = Array.from(uniquePartOperations.values()).map((item) => new MMSendPartOperation(item.partNumber || "", // partNumber
+        item.partRevision || "", // partRevision
+        item.method || "Standard", // method
+        item.sequenceNumber?.toString() || "", // sequenceNumber
+        item.resourceId?.toString() || "", // resourceId
+        item.cycleTimeMs || 0, // cycleTimeMs
+        item.setupTimeMs || 0, // setupTimeMs
+        item.description || "", // description
+        item.quantityPerPart || 1 // quantityPerPart
+        ));
+        const transformedWorkOrders = Array.from(uniqueWorkOrders.values()).map((item) => new MMSendWorkOrder(item.workOrderId?.toString() || "", // workOrderId
+        item.lot || "", // lot
+        item.split || "", // split
+        item.sub || "", // sub
+        item.status || "Open", // status
+        item.dueDate ? new Date(item.dueDate).toISOString() : null, // dueDate
+        item.description || "", // description
+        item.scheduledStartDate
+            ? new Date(item.scheduledStartDate).toISOString()
+            : null, // scheduledStartDate
+        item.scheduledEndDate
+            ? new Date(item.scheduledEndDate).toISOString()
+            : null, // scheduledEndDate
+        item.closedDate ? new Date(item.closedDate).toISOString() : null, // closedDate
+        item.quantityRequired || 0, // quantityRequired
+        item.partNumber || "", // partNumber
+        item.partRevision || "", // partRevision
+        item.method || "Standard" // method
+        ));
+        const transformedWorkOrderOperations = workOrderOperations.map((item) => new MMSendWorkOrderOperation(item.workOrderId?.toString() || "", // workOrderId
+        item.lot || "", // lot
+        item.split || "", // split
+        item.sub || "", // sub
+        item.sequenceNumber?.toString() || "", // sequenceNumber
+        item.resourceId?.toString() || "", // resourceId
+        item.startQuantity || 0, // startQuantity
+        item.finishQuantity || 0, // finishQuantity
+        item.expectedRejectRate || 0, // expectedRejectRate
+        item.scheduledStartDate
+            ? new Date(item.scheduledStartDate).toISOString()
+            : null, // scheduledStartDate
+        item.scheduledFinishDate
+            ? new Date(item.scheduledFinishDate).toISOString()
+            : null, // scheduledFinishDate
+        item.closedDate ? new Date(item.closedDate).toISOString() : null, // closedDate
+        item.cycleTimeMs || 0, // cycleTimeMs
+        item.setupTimeMs || 0, // setupTimeMs
+        parseFloat(item.productionburdenRateHourly || "0"), // productionburdenRateHourly
+        parseFloat(item.setupburdenRatehourly || "0"), // setupburdenRatehourly
+        item.operationType || "Production", // operationType
+        item.quantityPerPart || 1, // quantityPerPart
+        item.status || "Open" // status
+        ));
+        // Send each entity type individually in the correct order for referential integrity
+        const partsResult = await MMEntityProcessor.writeEntities(ERPObjType.PARTS, parts, batchCacheManager);
+        const partOperationsResult = await MMEntityProcessor.writeEntities(ERPObjType.PART_OPERATION, partOperations, batchCacheManager);
+        const workOrdersResult = await MMEntityProcessor.writeEntities(ERPObjType.WORK_ORDERS, transformedWorkOrders, batchCacheManager);
+        const workOrderOperationsResult = await MMEntityProcessor.writeEntities(ERPObjType.WORK_ORDER_OPERATIONS, transformedWorkOrderOperations, batchCacheManager);
+        return {
+            parts: partsResult,
+            partOperations: partOperationsResult,
+            workOrders: workOrdersResult,
+            workOrderOperations: workOrderOperationsResult,
+        };
+    }
+}
+//# sourceMappingURL=standard-process-drivers.js.map

package/dist/utils/standard-process-drivers/standard-process-drivers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-process-drivers.js","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/standard-process-drivers.ts"],"names":[],"mappings":"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"}

package/dist/utils/time-utils.js

@@ -0,0 +1,96 @@
+import logger from "../services/reporting-service/logger.js";
+import { setTimezoneOffsetInCache, setTimezoneNameInCache, } from "./local-data-store/jobs-shared-data.js";
+import { convertToLocalTime, formatDateWithTZOffset, getTimezoneOffset, } from "./timezone.js";
+/**
+ * Calculates the difference in hours between two timestamps
+ * @param startTime ISO timestamp string
+ * @param endTime ISO timestamp string
+ * @param timezoneOffset timezone offset in hours
+ * @returns number representing hours difference, rounded to 3 decimal places
+ */
+export function calculateTimeDifferenceInHours(startTime, endTime, timezoneOffset) {
+    if (!startTime || !endTime)
+        return 0;
+    const localStartTime = convertToLocalTime(startTime, timezoneOffset);
+    const localEndTime = convertToLocalTime(endTime, timezoneOffset);
+    if (!localStartTime || !localEndTime)
+        return 0;
+    // Get hours, minutes, seconds from the Date objects
+    const startHours = localStartTime.getHours();
+    const startMinutes = localStartTime.getMinutes();
+    const startSeconds = localStartTime.getSeconds();
+    const endHours = localEndTime.getHours();
+    const endMinutes = localEndTime.getMinutes();
+    const endSeconds = localEndTime.getSeconds();
+    // Calculate total seconds for each time
+    const startTotalSeconds = startHours * 3600 + startMinutes * 60 + startSeconds;
+    const endTotalSeconds = endHours * 3600 + endMinutes * 60 + endSeconds;
+    if (endTotalSeconds > startTotalSeconds) {
+        return Number(((endTotalSeconds - startTotalSeconds) / 3600).toFixed(3));
+    }
+    return 0;
+}
+export const getSecondsOfDay = (timestamp) => {
+    if (!timestamp)
+        return null;
+    const time = new Date(timestamp);
+    const utcHours = time.getUTCHours();
+    const utcMinutes = time.getUTCMinutes();
+    const utcSeconds = time.getUTCSeconds();
+    return (utcHours * 3600 + utcMinutes * 60 + utcSeconds).toString();
+};
+/**
+ * Apply timezone offsets to specified datetime fields in an object
+ * @param item The object to transform
+ * @param fields The fields to apply timezone offset to
+ * @param timezoneOffset The timezone offset to apply
+ * @returns The transformed object
+ */
+export const applyTimezoneOffsetsToFields = (item, fields, timezoneOffset) => {
+    const transformed = { ...item };
+    fields.forEach((field) => {
+        if (transformed[field] && transformed[field].trim()) {
+            const formattedDate = formatDateWithTZOffset(transformed[field], timezoneOffset);
+            transformed[field] = formattedDate || "";
+        }
+        else {
+            transformed[field] = "";
+        }
+    });
+    return transformed;
+};
+/**
+ * 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
+ */
+export const getTimezoneOffsetAndPersist = async (params = {
+    maxRetries: 36000, // Retry for 10 hours before giving up.
+    retryIntervalMs: 10_000,
+}) => {
+    let success = false;
+    let retries = 0;
+    logger.info("Acquiring the timezone offset and timezone name from MachineMetrics and storing in cache");
+    while (!success && retries < params.maxRetries) {
+        try {
+            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);
+            logger.info(`Retrying in ${params.retryIntervalMs / 1000} seconds...`);
+            await new Promise((resolve) => setTimeout(resolve, params.retryIntervalMs));
+            retries++;
+        }
+    }
+    if (!success) {
+        throw new Error(`Failed to get the timezone offset after ${params.maxRetries} retries`);
+    }
+};
+//# sourceMappingURL=time-utils.js.map