@machinemetrics/mm-erp-sdk 0.1.1-beta.1

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

@@ -0,0 +1,68 @@
+import { ERPObjType } from "../../types/erp-types";
+import { BatchCacheManager } from "../../services/caching-service/batch-cache-manager";
+import { IToRESTApiObject, MM207NonLaborTicketResponse, MM207LaborTicketResponse } from "../../services/mm-api-service";
+/**
+ * Handles error processing and record management utilities for MM API operations
+ */
+export declare class ErrorProcessor {
+    /**
+     * Creates a set of primary keys for all failed records from batch errors
+     * @param entityType The type of entity being processed
+     * @param batchErrors Array of batch errors containing failed entities
+     * @returns Set of primary keys for failed records
+     */
+    static createFailedRecordKeySet(entityType: ERPObjType, batchErrors: Array<{
+        message: string;
+        errorEntities: IToRESTApiObject[];
+    }>): Set<string>;
+    /**
+     * Filters out failed records, returning only successful ones
+     * @param entityType The type of entity being processed
+     * @param allRecords All records (typed objects) that were sent to the API
+     * @param failedKeySet Set of primary keys for records that failed
+     * @returns Array of records that succeeded
+     */
+    static filterSuccessfulRecords(entityType: ERPObjType, allRecords: IToRESTApiObject[], failedKeySet: Set<string>): IToRESTApiObject[];
+    /**
+     * Orchestrates the caching of successful records on partial failure
+     * @param entityType The type of entity being processed
+     * @param toProcess All records that were sent to the API (all are now guaranteed to be typed objects)
+     * @param batchErrors Array of batch errors containing failed entities
+     * @param batchCacheManager The cache manager instance
+     */
+    static cacheSuccessfulRecordsOnPartialFailure(entityType: ERPObjType, toProcess: IToRESTApiObject[], batchErrors: Array<{
+        message: string;
+        errorEntities: IToRESTApiObject[];
+    }>, batchCacheManager: BatchCacheManager): Promise<void>;
+    /**
+     * Extracts error count and batch errors from MM API response for partial failures (HTTP 207)
+     * This supports all entities, including the slightly different format for labor tickets.
+     * In case of labor tickets, the updateErrors and insertErrors arrays are combined into errorEntities.
+     * @param mmApiResponse The full MM API response object
+     * @param entityType The type of entity being processed (determines response structure)
+     * @returns Object containing errorCount and batchErrors
+     * See MM207NonLaborTicketResponse and MM207LaborTicketResponse for response structure details
+     */
+    static extractErrorDetails(mmApiResponse: MM207NonLaborTicketResponse | MM207LaborTicketResponse, entityType: ERPObjType): {
+        errorCount: number;
+        batchErrors: Array<{
+            message: string;
+            errorEntities: IToRESTApiObject[];
+        }>;
+    };
+    /**
+     * Extracts error details from a 500 HTTP exception when it contains structured error data
+     * @param exception The caught exception from MM API call
+     * @param entityType The type of entity being processed
+     * @returns Object containing errorCount and batchErrors, or null if not a structured 500 error
+     * See MM500NonLaborTicketException and MM500LaborTicketException for exception structure details
+     */
+    static extractErrorDetailsFrom500Exception(exception: unknown, entityType: ERPObjType): {
+        errorCount: number;
+        batchErrors: Array<{
+            message: string;
+            errorEntities: IToRESTApiObject[];
+        }>;
+    } | null;
+}
+//# sourceMappingURL=error-processor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-processor.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/error-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,+BAA+B,CAAC;AAIvC;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;OAKG;IACH,MAAM,CAAC,wBAAwB,CAC7B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,KAAK,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,gBAAgB,EAAE,CAAC;KACnC,CAAC,GACD,GAAG,CAAC,MAAM,CAAC;IAuBd;;;;;;OAMG;IACH,MAAM,CAAC,uBAAuB,CAC5B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,gBAAgB,EAAE;IAuBrB;;;;;;OAMG;WACU,sCAAsC,CACjD,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,gBAAgB,EAAE,EAC7B,WAAW,EAAE,KAAK,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,gBAAgB,EAAE,CAAC;KACnC,CAAC,EACF,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;;;;;;OAQG;IACH,MAAM,CAAC,mBAAmB,CACxB,aAAa,EAAE,2BAA2B,GAAG,wBAAwB,EACrE,UAAU,EAAE,UAAU,GACrB;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,KAAK,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,aAAa,EAAE,gBAAgB,EAAE,CAAC;SACnC,CAAC,CAAC;KACJ;IAqGD;;;;;;OAMG;IACH,MAAM,CAAC,mCAAmC,CACxC,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,UAAU,GACrB;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,KAAK,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC;YAChB,aAAa,EAAE,gBAAgB,EAAE,CAAC;SACnC,CAAC,CAAC;KACJ,GAAG,IAAI;CAkKT"}

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

@@ -0,0 +1,3 @@
+export { StandardProcessDrivers } from "./standard-process-drivers";
+export type { WriteEntitiesToMMResult, MMBatchValidationError, } from "./standard-process-drivers";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC"}

package/dist/utils/standard-process-drivers/labor-ticket-erp-synchronizer.d.ts

@@ -0,0 +1,18 @@
+import { ERPType } from "../../types/erp-types";
+import { IERPLaborTicketHandler } from "../../types/erp-connector";
+/**
+ * Handles synchronization of labor tickets between MachineMetrics and ERP systems
+ */
+export declare class LaborTicketERPSynchronizer {
+    /**
+     * Synchronizes updated labor tickets from MachineMetrics to an ERP system
+     */
+    static syncToERP(connectorType: ERPType, connector: IERPLaborTicketHandler): Promise<void>;
+    /**
+     * Retries labor tickets that have failed to be created or updated in the ERP during the sync
+     */
+    static retryFailed(connectorType: ERPType, connector: IERPLaborTicketHandler): Promise<void>;
+    private static writeLaborTicketIdToMM;
+    private static processLaborTicket;
+}
+//# sourceMappingURL=labor-ticket-erp-synchronizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labor-ticket-erp-synchronizer.d.ts","sourceRoot":"","sources":["../../../src/utils/standard-process-drivers/labor-ticket-erp-synchronizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAOnE;;GAEG;AACH,qBAAa,0BAA0B;IACrC;;OAEG;WACU,SAAS,CACpB,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IA4GhB;;OAEG;WACU,WAAW,CACtB,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;mBA+DK,sBAAsB;mBAetB,kBAAkB;CAkDxC"}

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

@@ -0,0 +1,40 @@
+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";
+/**
+ * Handles processing of entities to the MachineMetrics API
+ */
+export declare class MMEntityProcessor {
+    /**
+     * Writes entities to MM API with deduplication and caching
+     */
+    static writeEntities(entityType: ERPObjType, mmRecords: IToRESTApiObject[], batchCacheManager: BatchCacheManager | null): Promise<WriteEntitiesToMMResult>;
+    /**
+     * 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
+     */
+    private static _prepareAndDedupe;
+    /**
+     * Sends records to MM API
+     */
+    private static _sendToAPI;
+    /**
+     * 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
+     */
+    private static _handleException;
+    /**
+     * 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
+     */
+    private static _handleResponse;
+}
+//# sourceMappingURL=mm-entity-processor.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,178 @@
+import { ERPType, 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";
+/**
+ * The result of writing entities to the MachineMetrics API on complete success.
+ */
+export interface WriteEntitiesToMMResult {
+    message: string;
+    upsertedEntities: number;
+    localDedupeCount: number;
+    apiDedupeCount: number;
+}
+export declare class MMBatchValidationError extends Error {
+    readonly upsertedEntities: number;
+    readonly localDedupeCount: number;
+    readonly apiDedupeCount: number;
+    readonly errorCount: number;
+    readonly httpStatus: number;
+    readonly batchErrors: Array<{
+        message: string;
+        errorEntities: IToRESTApiObject[];
+    }>;
+    constructor(options: {
+        message: string;
+        upsertedEntities: number;
+        localDedupeCount: number;
+        apiDedupeCount: number;
+        errorCount: number;
+        httpStatus: number;
+        batchErrors: Array<{
+            message: string;
+            errorEntities: IToRESTApiObject[];
+        }>;
+    });
+}
+/**
+ * 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 declare 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 syncLaborTicketsToERP(connectorType: ERPType, connector: IERPLaborTicketHandler): Promise<void>;
+    /**
+     * 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 retryFailedLaborTickets(connectorType: ERPType, connector: IERPLaborTicketHandler): Promise<void>;
+    /**
+     * 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 validation errors
+     *     // HTTP 500 - A specific type of which represent complete failure due to validation issues;
+     *     //            other 500 types represent failure due to other issues and are not converted to MMBatchValidationError
+     *
+     *     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(`Affected entities:`, batchError.errorEntities);
+     *
+     *       // Example: Queue failed entities for retry
+     *       await queueForRetry(batchError.errorEntities);
+     *     });
+     *
+     *     // Decide whether to continue or halt based on httpStatus
+     *     if (error.httpStatus === 207) {
+     *       // Partial success - some records processed successfully
+     *       console.log('⚠️  Continuing with partial success');
+     *     } else if (error.httpStatus === 500) {
+     *       // Complete failure - no records processed
+     *       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 writeEntitiesToMM(entityType: ERPObjType, mmRecords: IToRESTApiObject[], batchCacheManager: BatchCacheManager | null): Promise<WriteEntitiesToMMResult>;
+    /**
+     * 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 writeWorkOrderBatchToMM(workOrderBatch: MMSendWorkOrderBatch, batchCacheManager: BatchCacheManager | null): Promise<{
+        parts: WriteEntitiesToMMResult;
+        partOperations: WriteEntitiesToMMResult;
+        workOrders: WriteEntitiesToMMResult;
+        workOrderOperations: WriteEntitiesToMMResult;
+    }>;
+    /**
+     * 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 syncWorkOrderBatchFromFlattened(flattenedData: any[], batchCacheManager: BatchCacheManager | null): Promise<{
+        parts: WriteEntitiesToMMResult;
+        partOperations: WriteEntitiesToMMResult;
+        workOrders: WriteEntitiesToMMResult;
+        workOrderOperations: WriteEntitiesToMMResult;
+    }>;
+}
+//# sourceMappingURL=standard-process-drivers.d.ts.map

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

@@ -0,0 +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,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC5D,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,aAAa,EAAE,gBAAgB,EAAE,CAAC;KACnC,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,aAAa,EAAE,gBAAgB,EAAE,CAAC;SACnC,CAAC,CAAC;KACJ;CAUF;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;OAQG;WACU,qBAAqB,CAChC,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;OAMG;WACU,uBAAuB,CAClC,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuEG;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/time-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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 declare function calculateTimeDifferenceInHours(startTime: string | null | undefined, endTime: string | null | undefined, timezoneOffset: number): number;
+export declare const getSecondsOfDay: (timestamp: string | null) => string | null;
+/**
+ * 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 declare const applyTimezoneOffsetsToFields: (item: Record<string, string>, fields: string[], timezoneOffset: number) => Record<string, string>;
+interface TimezoneOffsetParams {
+    maxRetries: number;
+    retryIntervalMs: number;
+}
+/**
+ * Gets the timezone offset for the company and sets it in the cache
+ * The cached offset can be acquired from getCachedTimezoneOffset() 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 declare const getTimezoneOffsetAndPersist: (params?: TimezoneOffsetParams) => Promise<void>;
+export {};
+//# sourceMappingURL=time-utils.d.ts.map

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

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

package/dist/utils/timezone.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Gets the timezone offset in hours for the company's timezone
+ * @returns Promise<number> The timezone offset in hours
+ * @throws Error if unable to fetch timezone information
+ */
+export declare const getTimezoneOffset: () => Promise<number>;
+/**
+ * Converts a UTC/Zulu time to local time based on the provided timezone offset
+ * @param zuluTime The UTC/Zulu time to convert
+ * @param timezoneOffset The timezone offset in hours
+ * @returns The converted local time, or undefined if input is null/undefined
+ */
+export declare const convertToLocalTime: (zuluTime: string | Date | null | undefined, timezoneOffset: number) => Date | undefined;
+/**
+ * Formats a date with the timezone offset in ISO format with offset
+ * @param date The date string in format YYYY-MM-DD HH:mm:ss or YYYY-MM-DDTHH:mm:ss
+ * @param timezoneOffset The timezone offset in hours
+ * @returns The formatted date string in format: YYYY-MM-DDTHH:mm:ss+/-HH:MM
+ */
+export declare const formatDateWithTZOffset: (date: string | null | undefined, timezoneOffset: number) => string | undefined;
+//# sourceMappingURL=timezone.d.ts.map

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

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

package/dist/utils/trimObjectValues.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Trims all string values in an object while preserving the object's structure
+ */
+export declare const trimObjectValues: <T extends object>(obj: T) => T;
+//# sourceMappingURL=trimObjectValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trimObjectValues.d.ts","sourceRoot":"","sources":["../../src/utils/trimObjectValues.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,KAAG,CAQ3D,CAAC"}

package/dist/utils/uniqueRows.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extracts unique rows from data based on specified fields and sorts by up to two fields
+ * @param data Array of data objects
+ * @param fields Array of field names to use as a unique keys
+ * @param sortFields Optional array of field names to sort by (up to two fields)
+ * @returns Array of unique objects based on the specified fields, or an empty array if data is empty
+ */
+export declare function getUniqueRows<T extends Record<string, unknown>>(data: T[], fields: (keyof T)[], sortFields?: (keyof T)[]): T[];
+//# sourceMappingURL=uniqueRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueRows.d.ts","sourceRoot":"","sources":["../../src/utils/uniqueRows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EACnB,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GACvB,CAAC,EAAE,CA4BL"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@machinemetrics/mm-erp-sdk",
+  "description": "A library for syncing data between MachineMetrics and ERP systems",
+  "version": "0.1.1-beta.1",
+  "license": "MIT",
+  "author": "machinemetrics",
+  "main": "dist/mm-erp-sdk.js",
+  "types": "dist/index.d.ts",
+  "source": "src/index.ts",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "vite build && tsc --project tsconfig.declarations.json",
+    "start": "vite build --watch",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@azure/msal-node": "^2.12.0",
+    "@ladjs/graceful": "^4.2.0",
+    "axios": "^1.7.3",
+    "axios-retry": "^4.5.0",
+    "better-sqlite3": "^11.3.0",
+    "bree": "^9.2.4",
+    "dotenv": "^16.4.5",
+    "json-stable-stringify": "^1.3.0",
+    "knex": "^3.1.0",
+    "lodash": "^4.17.21",
+    "mssql": "^11.0.1",
+    "winston": "^3.14.0",
+    "winston-daily-rotate-file": "^5.0.0",
+    "xxhashjs": "^0.2.2",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/json-stable-stringify": "^1.1.0",
+    "@types/lodash": "^4.17.10",
+    "@types/mssql": "^9.1.6",
+    "@types/node": "^20.0.0",
+    "@types/xxhashjs": "^0.2.4",
+    "prettier": "^3.3.3",
+    "typescript": "^5.8.3",
+    "vite": "^5.3.4"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,98 @@
+/**
+ * Main entry point for the MM ERP Connector SDK.
+ * This file exports the public API that client code should use.
+ */
+
+// Core interfaces and types
+export type { IERPConnector } from "./types/erp-connector";
+export { ERPType, ERPObjType } from "./types/erp-types";
+export type { ERPPagination, ERPResponse, ERPObject } from "./types/erp-types";
+
+// Configuration interfaces
+export type { ErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
+export { getErpApiConnectionParams } from "./services/data-sync-service/configuration-manager";
+export { buildLogicalCondition } from "./services/erp-api-services/rest/get-query-params";
+export type { ERPApiConfig } from "./services/erp-api-services/types";
+
+// MM API client and types
+export { MMApiClient } from "./services/mm-api-service";
+export type {
+  MMReceiveLaborTicket,
+  MMReceiveLaborTicketReason,
+  MMReceiveLaborTicketWorkOrderOperation,
+  IToRESTApiObject,
+} from "./services/mm-api-service";
+
+export {
+  MMSendPerson,
+  MMSendResource,
+  MMSendPart,
+  MMSendPartOperation,
+  MMSendWorkOrder,
+  MMSendWorkOrderOperation,
+  MMSendReason,
+  MMSendLaborTicket,
+} from "./services/mm-api-service";
+
+export type { MMSendWorkOrderBatch } from "./services/mm-api-service";
+
+// Utility functions that are safe for client use
+export {
+  getUniqueRows,
+  removeExtraneousFields,
+  getPayloadWithoutIDField,
+  trimObjectValues,
+  cleanupNumbers,
+  addNewFieldFromExternalSource,
+  addNewFieldFromLookupField,
+  formatDateWithTZOffset,
+  applyTimezoneOffsetsToFields,
+  convertToLocalTime,
+} from "./utils";
+
+// HTTP client factory and types for custom API integrations
+export { HTTPClientFactory } from "./utils/http-client";
+export type { HTTPResponse } from "./utils/http-client";
+
+// Application initialization utilities
+export { ApplicationInitializer } from "./utils/application-initializer";
+
+// Data sync service
+export { runDataSyncService } from "./services/data-sync-service";
+
+// Logging service
+export { logger } from "./services/reporting-service";
+
+// Labor ticket handler interface
+export type { IERPLaborTicketHandler } from "./types/erp-connector";
+
+// Process drivers and utilities
+export { StandardProcessDrivers, getCachedTimezoneOffset } from "./utils";
+
+// API services
+export { RestAPIService } from "./services/erp-api-services/rest/rest-api-service";
+export { ErrorHandler } from "./services/erp-api-services/errors";
+export type {
+  QueryParams,
+  PaginatedAPIResponse,
+} from "./services/erp-api-services/rest/get-query-params";
+export { OAuthClient } from "./services/erp-api-services/oauth-client";
+export type { OAuthConfig } from "./services/erp-api-services/oauth-client";
+export { GraphQLService } from "./services/erp-api-services/graphql/graphql-service";
+export type { GraphQLServerError } from "./services/erp-api-services/graphql/types";
+
+// Caching services
+export { BatchCacheManager } from "./services/caching-service/batch-cache-manager";
+
+// Configuration services
+export {
+  CoreConfiguration,
+  getSQLServerConfiguration,
+} from "./services/data-sync-service/configuration-manager";
+
+// SQL Server services
+export {
+  SqlServerService,
+  SqlServerHelper,
+} from "./services/sql-server-erp-service";
+export type { SQLInput } from "./services/sql-server-erp-service";

package/src/knexfile.ts

@@ -0,0 +1,21 @@
+import type { Knex } from "knex";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const config: { [key: string]: Knex.Config } = {
+  local: {
+    client: "better-sqlite3",
+    connection: {
+      filename: "./local.sqlite3",
+    },
+    useNullAsDefault: true,
+    migrations: {
+      directory: path.join(__dirname, "migrations"),
+      extension: "js",
+    },
+  },
+};
+
+export default config;

package/src/migrations/20241015162631_create_cache_table.ts

@@ -0,0 +1,15 @@
+import { Knex } from "knex";
+
+export async function up(knex: Knex): Promise<void> {
+  await knex.schema.createTable("cache", (table) => {
+    table.increments("id");
+    table.jsonb("value").notNullable();
+    table.jsonb("type").notNullable().index();
+    table.string("key").unique().notNullable();
+    table.timestamps(true, true);
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  await knex.schema.dropTable("cache");
+}

package/src/migrations/20241015162632_create_sdk_cache_table.ts

@@ -0,0 +1,15 @@
+import { Knex } from "knex";
+
+export async function up(knex: Knex): Promise<void> {
+  await knex.schema.createTable("sdk_cache", (table) => {
+    table.increments("id");
+    table.string("type").notNullable().index();
+    table.string("key").notNullable();
+    table.timestamp("created_at").defaultTo(knex.fn.now());
+    table.unique(["type", "key"]); // Composite unique constraint
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  await knex.schema.dropTable("sdk_cache");
+}

package/src/migrations/20250103162631_create_record_tracking_table.ts

@@ -0,0 +1,18 @@
+import { Knex } from "knex";
+
+export async function up(knex: Knex): Promise<void> {
+  await knex.schema.createTable("record_tracking", (table) => {
+    table.increments("id");
+    table.integer("entityType").notNullable().index();
+    table
+      .datetime("lastValue", { useTz: true, precision: 3 })
+      .notNullable()
+      .index();
+    table.string("recordId").notNullable().index();
+    table.timestamps(true, true);
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  await knex.schema.dropTable("record_tracking");
+}