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

package/dist/utils/standard-process-drivers/labor-ticket-erp-synchronizer.js.map

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

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

@@ -1,13 +1,19 @@
-import { ERPObjType } from "../../types/erp-types";
-import { BatchCacheManager } from "../../services/caching-service/batch-cache-manager";
-import { IToRESTApiObject } from "../../services/mm-api-service";
-import { WriteEntitiesToMMResult } from "./standard-process-drivers";
+import { ERPObjType } from "../../types/erp-types.js";
+import { BatchCacheManager } from "../../services/caching-service/batch-cache-manager.js";
+import { IToRESTApiObject } from "../../services/mm-api-service/index.js";
+import { WriteEntitiesToMMResult } from "./standard-process-drivers.js";
 /**
  * Handles processing of entities to the MachineMetrics API
  */
 export declare class MMEntityProcessor {
     /**
-     * Writes entities to MM API with deduplication and caching
+     * Writes entities to MM API with deduplication and caching.
+     *
+     * IMPORTANT: All datetime fields on `mmRecords` MUST already be expressed as
+     * ISO-8601 UTC strings (either trailing `Z` or an explicit offset). The SDK
+     * does not apply timezone conversion on this path. It forwards values directly
+     * to MachineMetrics and only reserializes them for validation. Connector code
+     * is responsible for converting local ERP times to UTC before invoking this API.
      */
     static writeEntities(entityType: ERPObjType, mmRecords: IToRESTApiObject[], batchCacheManager: BatchCacheManager | null): Promise<WriteEntitiesToMMResult>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"mm-entity-processor.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/mm-entity-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AACvF,OAAO,EACL,gBAAgB,EAcjB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,uBAAuB,EAExB,MAAM,4BAA4B,CAAC;AAGpC;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;WACU,aAAa,CACxB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,gBAAgB,EAAE,EAC7B,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC,uBAAuB,CAAC;IAiCnC;;;;;OAKG;mBACkB,iBAAiB;IA+BtC;;OAEG;mBACkB,UAAU;IAsC/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgC/B;;;;;;;OAOG;mBACkB,eAAe;CAuErC"}
+{"version":3,"file":"mm-entity-processor.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/mm-entity-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EACL,gBAAgB,EAcjB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EACL,uBAAuB,EAExB,MAAM,+BAA+B,CAAC;AAGvC;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;OAQG;WACU,aAAa,CACxB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,gBAAgB,EAAE,EAC7B,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC,uBAAuB,CAAC;IAiCnC;;;;;OAKG;mBACkB,iBAAiB;IA+BtC;;OAEG;mBACkB,UAAU;IAsC/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgC/B;;;;;;;OAOG;mBACkB,eAAe;CAuErC"}

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

@@ -0,0 +1,174 @@
+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.
+     *
+     * IMPORTANT: All datetime fields on `mmRecords` MUST already be expressed as
+     * ISO-8601 UTC strings (either trailing `Z` or an explicit offset). The SDK
+     * does not apply timezone conversion on this path. It forwards values directly
+     * to MachineMetrics and only reserializes them for validation. Connector code
+     * is responsible for converting local ERP times to UTC before invoking this API.
+     */
+    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,8 @@
-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 type { FlattenedWorkOrderRow } from "../../types/flattened-work-order.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.
  */
@@ -162,14 +163,19 @@ export declare class StandardProcessDrivers {
      * 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)
+     * Timezone expectation: all datetime fields provided in `flattenedData` MUST already be expressed
+     * as ISO-8601 UTC strings (trailing `Z` or explicit offset). The SDK does not attempt to infer or
+     * convert local ERP timestamps on this path; it simply validates and forwards the values to MM.
+     * Connector implementations should convert ERP-local times to UTC before invoking this method.
+     *
+     * @param flattenedData Array of flattened rows containing both work order and operation data (see `FlattenedWorkOrderRow`)
      * @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 syncWorkOrderBatchFromFlattened(flattenedData: any[], batchCacheManager: BatchCacheManager | null): Promise<{
+    static syncWorkOrderBatchFromFlattened(flattenedData: ReadonlyArray<FlattenedWorkOrderRow>, batchCacheManager: BatchCacheManager | null): Promise<{
         parts: WriteEntitiesToMMResult;
         partOperations: WriteEntitiesToMMResult;
         workOrders: WriteEntitiesToMMResult;

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,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,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;;;;;;;;;;;;;;;;;;;OAmBG;WACU,+BAA+B,CAC1C,aAAa,EAAE,aAAa,CAAC,qBAAqB,CAAC,EACnD,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;CA0MH"}

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

@@ -0,0 +1,333 @@
+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.
+     *
+     * Timezone expectation: all datetime fields provided in `flattenedData` MUST already be expressed
+     * as ISO-8601 UTC strings (trailing `Z` or explicit offset). The SDK does not attempt to infer or
+     * convert local ERP timestamps on this path; it simply validates and forwards the values to MM.
+     * Connector implementations should convert ERP-local times to UTC before invoking this method.
+     *
+     * @param flattenedData Array of flattened rows containing both work order and operation data (see `FlattenedWorkOrderRow`)
+     * @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");
+        }
+        const toStringOrFallback = (value, fallback = "") => (value === undefined || value === null ? fallback : String(value));
+        // 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
+                    operationDescription: 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(toStringOrFallback(item.partNumber), // partNumber
+        toStringOrFallback(item.partRevision), // partRevision
+        item.method || "Standard" // method
+        ));
+        const partOperations = Array.from(uniquePartOperations.values()).map((item) => new MMSendPartOperation(toStringOrFallback(item.partNumber), // partNumber
+        toStringOrFallback(item.partRevision), // partRevision
+        item.method || "Standard", // method
+        item.sequenceNumber?.toString() || "", // sequenceNumber
+        item.resourceId?.toString() || "", // resourceId
+        item.cycleTimeMs || 0, // cycleTimeMs
+        item.setupTimeMs || 0, // setupTimeMs
+        item.operationDescription || "", // description
+        item.quantityPerPart || 1 // quantityPerPart
+        ));
+        const transformedWorkOrders = Array.from(uniqueWorkOrders.values()).map((item) => new MMSendWorkOrder(item.workOrderId?.toString() || "", // workOrderId
+        toStringOrFallback(item.lot), // lot
+        toStringOrFallback(item.split), // split
+        toStringOrFallback(item.sub), // sub
+        item.status || "Open", // status
+        // Datetimes are assumed to already be UTC (or include an explicit offset).
+        // We reserialize via Date solely to validate the ISO format before sending to MM.
+        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
+        toStringOrFallback(item.partNumber), // partNumber
+        toStringOrFallback(item.partRevision), // partRevision
+        item.method || "Standard" // method
+        ));
+        const transformedWorkOrderOperations = workOrderOperations.map((item) => new MMSendWorkOrderOperation(item.workOrderId?.toString() || "", // workOrderId
+        toStringOrFallback(item.lot), // lot
+        toStringOrFallback(item.split), // split
+        toStringOrFallback(item.sub), // sub
+        item.sequenceNumber?.toString() || "", // sequenceNumber
+        item.resourceId?.toString() || "", // resourceId
+        item.startQuantity || 0, // startQuantity
+        item.finishQuantity || 0, // finishQuantity
+        item.expectedRejectRate || 0, // expectedRejectRate
+        // Same UTC expectation as above; reserialize to ensure valid ISO.
+        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(toStringOrFallback(item.productionburdenRateHourly, "0")), // productionburdenRateHourly
+        parseFloat(toStringOrFallback(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