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

package/src/utils/standard-process-drivers/standard-process-drivers.ts

@@ -1,6 +1,5 @@
 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,
@@ -249,12 +248,7 @@ export class StandardProcessDrivers {
    * 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 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
@@ -262,7 +256,7 @@ export class StandardProcessDrivers {
    * @throws Error on other underlying issues (network, authentication, etc.)
    */
   static async syncWorkOrderBatchFromFlattened(
-    flattenedData: ReadonlyArray<FlattenedWorkOrderRow>,
+    flattenedData: any[],
     batchCacheManager: BatchCacheManager | null
   ): Promise<{
     parts: WriteEntitiesToMMResult;
@@ -274,11 +268,6 @@ export class StandardProcessDrivers {
       throw new Error("No flattened work order data provided");
     }
 
-    const toStringOrFallback = (
-      value: string | number | null | undefined,
-      fallback = ""
-    ): string => (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();
@@ -308,8 +297,8 @@ export class StandardProcessDrivers {
           resourceId: row.resourceId, // → resourceId
           cycleTimeMs: row.cycleTimeMs, // → cycleTimeMs
           setupTimeMs: row.setupTimeMs, // → setupTimeMs
-          operationDescription: row.operationDescription, // → description
-          quantityPerPart: row.quantityPerPart ?? 1, // → quantityPerPart
+          description: row.operationDescription || "", // → description
+          quantityPerPart: row.quantityPerPart || 1, // → quantityPerPart
         });
       }
 
@@ -362,8 +351,8 @@ export class StandardProcessDrivers {
     const parts = Array.from(uniqueParts.values()).map(
       (item) =>
         new MMSendPart(
-          toStringOrFallback(item.partNumber), // partNumber
-          toStringOrFallback(item.partRevision), // partRevision
+          item.partNumber || "", // partNumber
+          item.partRevision || "", // partRevision
           item.method || "Standard" // method
         )
     );
@@ -371,14 +360,14 @@ export class StandardProcessDrivers {
     const partOperations = Array.from(uniquePartOperations.values()).map(
       (item) =>
         new MMSendPartOperation(
-          toStringOrFallback(item.partNumber), // partNumber
-          toStringOrFallback(item.partRevision), // partRevision
+          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.operationDescription || "", // description
+          item.description || "", // description
           item.quantityPerPart || 1 // quantityPerPart
         )
     );
@@ -387,12 +376,10 @@ export class StandardProcessDrivers {
       (item) =>
         new MMSendWorkOrder(
           item.workOrderId?.toString() || "", // workOrderId
-          toStringOrFallback(item.lot), // lot
-          toStringOrFallback(item.split), // split
-          toStringOrFallback(item.sub), // sub
+          item.lot || "", // lot
+          item.split || "", // split
+          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
@@ -403,8 +390,8 @@ export class StandardProcessDrivers {
             : null, // scheduledEndDate
           item.closedDate ? new Date(item.closedDate).toISOString() : null, // closedDate
           item.quantityRequired || 0, // quantityRequired
-          toStringOrFallback(item.partNumber), // partNumber
-          toStringOrFallback(item.partRevision), // partRevision
+          item.partNumber || "", // partNumber
+          item.partRevision || "", // partRevision
           item.method || "Standard" // method
         )
     );
@@ -413,15 +400,14 @@ export class StandardProcessDrivers {
       (item) =>
         new MMSendWorkOrderOperation(
           item.workOrderId?.toString() || "", // workOrderId
-          toStringOrFallback(item.lot), // lot
-          toStringOrFallback(item.split), // split
-          toStringOrFallback(item.sub), // sub
+          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
-          // Same UTC expectation as above; reserialize to ensure valid ISO.
           item.scheduledStartDate
             ? new Date(item.scheduledStartDate).toISOString()
             : null, // scheduledStartDate
@@ -431,8 +417,8 @@ export class StandardProcessDrivers {
           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
+          parseFloat(item.productionburdenRateHourly || "0"), // productionburdenRateHourly
+          parseFloat(item.setupburdenRatehourly || "0"), // setupburdenRatehourly
           item.operationType || "Production", // operationType
           item.quantityPerPart || 1, // quantityPerPart
           item.status || "Open" // status

package/src/utils/time-utils.ts

@@ -1,4 +1,3 @@
-import { DateTime } from 'luxon';
 import logger from "../services/reporting-service/logger.js";
 import {
   setTimezoneOffsetInCache,
@@ -118,16 +117,6 @@ export const getTimezoneOffsetAndPersist = async (
       const { offset, timezone } = await getTimezoneOffset();
       logger.info(`Timezone offset: ${offset} hours, timezone: ${timezone}`);
       setTimezoneOffsetInCache(offset);
-
-      const now = DateTime.now().setZone(timezone);
-      if (!now.isValid) {
-          throw new Error(
-              `Invalid timezone name from Company properties: "${timezone}". ` +
-              `Must be a valid IANA timezone name (e.g., "America/Chicago"). ` +
-              `See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones`
-          );
-      }
-      
       setTimezoneNameInCache(timezone);
       success = true;
     } catch (error) {

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

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

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

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

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

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

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

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

package/dist/utils/env.d.ts

@@ -1,8 +0,0 @@
-/**
- * This module contains utility functions to get environment variables with default values and validation.
- */
-export declare const getEnvString: (key: string, defaultValue?: string) => string;
-export declare const getEnvNumber: (key: string, defaultValue: number) => number;
-export declare const getEnvBoolean: (key: string, defaultValue?: boolean) => boolean;
-export declare const getOptionalEnv: (key: string) => string | undefined;
-//# sourceMappingURL=env.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,qBAAiB,KAAG,MAG7D,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,EACX,cAAc,MAAM,KACnB,MAaF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,sBAAoB,KAAG,OAmBjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAErD,CAAC"}

package/dist/utils/env.js

@@ -1,58 +0,0 @@
-/**
- * This module contains utility functions to get environment variables with default values and validation.
- */
-const normalizeValue = (value) => {
-    if (value === undefined || value === null) {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return undefined;
-    }
-    const lowered = trimmed.toLowerCase();
-    if (lowered === "undefined" || lowered === "null") {
-        return undefined;
-    }
-    return trimmed;
-};
-const warnInvalid = (key, rawValue, reason) => {
-    const received = rawValue !== undefined ? `; received "${rawValue}"` : "";
-    console.warn(`[config] ${key} ${reason}${received}`); // eslint-disable-line no-console
-};
-export const getEnvString = (key, defaultValue = "") => {
-    const normalized = normalizeValue(process.env[key]);
-    return normalized ?? defaultValue;
-};
-export const getEnvNumber = (key, defaultValue) => {
-    const normalized = normalizeValue(process.env[key]);
-    if (normalized === undefined) {
-        return defaultValue;
-    }
-    const parsed = Number.parseInt(normalized, 10);
-    if (Number.isNaN(parsed)) {
-        warnInvalid(key, normalized, `is not a valid number for key ${key}; falling back to default ${defaultValue}`);
-        return defaultValue;
-    }
-    return parsed;
-};
-export const getEnvBoolean = (key, defaultValue = false) => {
-    const normalized = normalizeValue(process.env[key]);
-    if (normalized === undefined) {
-        return defaultValue;
-    }
-    const truthyValues = new Set(["true", "1", "yes", "y", "on"]);
-    const falsyValues = new Set(["false", "0", "no", "n", "off"]);
-    const lowered = normalized.toLowerCase();
-    if (truthyValues.has(lowered)) {
-        return true;
-    }
-    if (falsyValues.has(lowered)) {
-        return false;
-    }
-    warnInvalid(key, normalized, "is not a recognized boolean; falling back to default");
-    return defaultValue;
-};
-export const getOptionalEnv = (key) => {
-    return normalizeValue(process.env[key]);
-};
-//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

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

package/dist/utils/erp-timezone-utils.d.ts

@@ -1,20 +0,0 @@
-/**
- * Retrieves the ERP timezone name that should have been cached during initialization.
- * @throws Error when the timezone cache has not been populated.
- */
-export declare function getERPTimezone(): string;
-/**
- * Converts a UTC ISO-8601 datetime string to the ERP's local timezone (also ISO-8601).
- * @param utcDateTime ISO-8601 datetime string representing UTC time.
- * @param timezone Optional timezone override; defaults to the cached ERP timezone.
- * @returns ISO-8601 string in the ERP timezone.
- */
-export declare function convertUtcDateTimeToErpLocal(utcDateTime: string, timezone?: string): string;
-/**
- * Converts an ERP-local ISO-8601 datetime string to UTC (still ISO-8601).
- * @param localDateTime ISO-8601 datetime string representing ERP local time.
- * @param timezone Optional timezone override; defaults to the cached ERP timezone.
- * @returns ISO-8601 string in UTC.
- */
-export declare function convertErpLocalDateTimeToUtc(localDateTime: string, timezone?: string): string;
-//# sourceMappingURL=erp-timezone-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"erp-timezone-utils.d.ts","sourceRoot":"","sources":["../../src/utils/erp-timezone-utils.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAQvC;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CA8BR;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CA8BR"}

package/dist/utils/erp-timezone-utils.js

@@ -1,75 +0,0 @@
-import { DateTime } from "luxon";
-import logger from "../services/reporting-service/logger.js";
-import { getCachedTimezoneName } from "./local-data-store/jobs-shared-data.js";
-/**
- * Retrieves the ERP timezone name that should have been cached during initialization.
- * @throws Error when the timezone cache has not been populated.
- */
-export function getERPTimezone() {
-    const timezone = getCachedTimezoneName();
-    if (!timezone) {
-        throw new Error("ERP timezone is not cached. Run getTimezoneOffsetAndPersist() to populate it.");
-    }
-    return timezone;
-}
-/**
- * Converts a UTC ISO-8601 datetime string to the ERP's local timezone (also ISO-8601).
- * @param utcDateTime ISO-8601 datetime string representing UTC time.
- * @param timezone Optional timezone override; defaults to the cached ERP timezone.
- * @returns ISO-8601 string in the ERP timezone.
- */
-export function convertUtcDateTimeToErpLocal(utcDateTime, timezone) {
-    if (!utcDateTime) {
-        throw new Error("convertUtcDateTimeToErpLocal requires a non-empty UTC datetime string");
-    }
-    try {
-        const targetZone = timezone ?? getERPTimezone();
-        const parsedUtc = DateTime.fromISO(utcDateTime, { zone: "utc" });
-        if (!parsedUtc.isValid) {
-            throw new Error(`Invalid UTC datetime "${utcDateTime}": ${parsedUtc.invalidReason}`);
-        }
-        const localized = parsedUtc.setZone(targetZone);
-        if (!localized.isValid) {
-            throw new Error(`Unable to convert UTC datetime "${utcDateTime}" to target zone "${targetZone}": ${localized.invalidReason}`);
-        }
-        return localized.toISO();
-    }
-    catch (error) {
-        logger.error("convertUtcDateTimeToErpLocal: Failed to convert datetime", {
-            utcDateTime,
-            error,
-        });
-        throw new Error("Failed to convert UTC datetime to ERP local timezone. See logs for details.");
-    }
-}
-/**
- * Converts an ERP-local ISO-8601 datetime string to UTC (still ISO-8601).
- * @param localDateTime ISO-8601 datetime string representing ERP local time.
- * @param timezone Optional timezone override; defaults to the cached ERP timezone.
- * @returns ISO-8601 string in UTC.
- */
-export function convertErpLocalDateTimeToUtc(localDateTime, timezone) {
-    if (!localDateTime) {
-        throw new Error("convertErpLocalDateTimeToUtc requires a non-empty local datetime string");
-    }
-    try {
-        const sourceZone = timezone ?? getERPTimezone();
-        const parsedLocal = DateTime.fromISO(localDateTime, { zone: sourceZone });
-        if (!parsedLocal.isValid) {
-            throw new Error(`Invalid ERP local datetime "${localDateTime}" for zone "${sourceZone}": ${parsedLocal.invalidReason}`);
-        }
-        const utcDateTime = parsedLocal.setZone("utc");
-        if (!utcDateTime.isValid) {
-            throw new Error(`Unable to convert ERP local datetime "${localDateTime}" to UTC: ${utcDateTime.invalidReason}`);
-        }
-        return utcDateTime.toISO();
-    }
-    catch (error) {
-        logger.error("convertErpLocalDateTimeToUtc: Failed to convert datetime", {
-            localDateTime,
-            error,
-        });
-        throw new Error("Failed to convert ERP local datetime to UTC. See logs for details.");
-    }
-}
-//# sourceMappingURL=erp-timezone-utils.js.map

package/dist/utils/erp-timezone-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"erp-timezone-utils.js","sourceRoot":"","sources":["../../src/utils/erp-timezone-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,MAAM,MAAM,yCAAyC,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,WAAmB,EACnB,QAAiB;IAEjB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,QAAQ,IAAI,cAAc,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,yBAAyB,WAAW,MAAM,SAAS,CAAC,aAAa,EAAE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,mCAAmC,WAAW,qBAAqB,UAAU,MAAM,SAAS,CAAC,aAAa,EAAE,CAC7G,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0DAA0D,EAAE;YACvE,WAAW;YACX,KAAK;SACN,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,aAAqB,EACrB,QAAiB;IAEjB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,QAAQ,IAAI,cAAc,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,+BAA+B,aAAa,eAAe,UAAU,MAAM,WAAW,CAAC,aAAa,EAAE,CACvG,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,yCAAyC,aAAa,aAAa,WAAW,CAAC,aAAa,EAAE,CAC/F,CAAC;QACJ,CAAC;QAED,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0DAA0D,EAAE;YACvE,aAAa;YACb,KAAK;SACN,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/src/types/flattened-work-order.ts

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

package/src/utils/env.ts

@@ -1,75 +0,0 @@
-/**
- * This module contains utility functions to get environment variables with default values and validation.
- */
-
-const normalizeValue = (value?: string | null): string | undefined => {
-  if (value === undefined || value === null) {
-    return undefined;
-  }
-
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return undefined;
-  }
-
-  const lowered = trimmed.toLowerCase();
-  if (lowered === "undefined" || lowered === "null") {
-    return undefined;
-  }
-
-  return trimmed;
-};
-
-const warnInvalid = (key: string, rawValue: string | undefined, reason: string) => {
-  const received = rawValue !== undefined ? `; received "${rawValue}"` : "";
-  console.warn(`[config] ${key} ${reason}${received}`); // eslint-disable-line no-console
-};
-
-export const getEnvString = (key: string, defaultValue = ""): string => {
-  const normalized = normalizeValue(process.env[key]);
-  return normalized ?? defaultValue;
-};
-
-export const getEnvNumber = (
-  key: string,
-  defaultValue: number
-): number => {
-  const normalized = normalizeValue(process.env[key]);
-  if (normalized === undefined) {
-    return defaultValue;
-  }
-
-  const parsed = Number.parseInt(normalized, 10);
-  if (Number.isNaN(parsed)) {
-    warnInvalid(key, normalized, `is not a valid number for key ${key}; falling back to default ${defaultValue}`);
-    return defaultValue;
-  }
-
-  return parsed;
-};
-
-export const getEnvBoolean = (key: string, defaultValue = false): boolean => {
-  const normalized = normalizeValue(process.env[key]);
-  if (normalized === undefined) {
-    return defaultValue;
-  }
-
-  const truthyValues = new Set(["true", "1", "yes", "y", "on"]);
-  const falsyValues = new Set(["false", "0", "no", "n", "off"]);
-  const lowered = normalized.toLowerCase();
-
-  if (truthyValues.has(lowered)) {
-    return true;
-  }
-  if (falsyValues.has(lowered)) {
-    return false;
-  }
-
-  warnInvalid(key, normalized, "is not a recognized boolean; falling back to default");
-  return defaultValue;
-};
-
-export const getOptionalEnv = (key: string): string | undefined => {
-  return normalizeValue(process.env[key]);
-};
-