@ontemper/edi 1.2.0-beta.1 → 1.2.0-beta.3

package/README.md

@@ -1,11 +1,10 @@
 # Temper EDI Client
 
-A TypeScript EDI client with structured logging and distributed tracing capabilities, built for processing X12 (including HIPAA) and EDIFACT documents with comprehensive error handling and automatic span tracking.
+A TypeScript EDI client with structured logging and distributed tracing capabilities, built for processing X12 EDI documents with comprehensive error handling and automatic span tracking.
 
 ## Features
 
-- **X12 EDI Processing**: Complete X12 document parsing, validation, and generation — HIPAA guide models resolve automatically from the ST03 implementation reference
-- **EDIFACT Processing**: `fromEdifact` / `toEdifact` / `validateEdifact` / `acknowledgeEdifact` with the same error handling, tracing, and automatic control-reference stamping (UNB-0020 from the central counter service, UNH-0062 local sequence)
+- **X12 EDI Processing**: Complete X12 document parsing, validation, and generation
 - **Structured Logging**: Built-in integration with Temper Logger for comprehensive operation tracking
 - **Distributed Tracing**: Automatic span creation for all EDI operations with detailed payload information
 - **Type Safety**: Full TypeScript support with comprehensive type definitions
@@ -351,43 +350,54 @@ IEA*1*000001000`;
 run().catch(console.error);
 ```
 
-## Control Numbers
+## Control numbers
 
-The SDK provides functions for managing EDI control numbers (ISA13, GS06) via the centralized counter service:
+The SDK manages ISA13 and GS06 control numbers for each sender and receiver pair. `toX12()` automatically stamps
+empty or all-zero ISA13, GS06, and ST02 fields. It preserves valid non-zero values. ISA13 and GS06 use the
+centralized counters. ST02 is assigned `"0001"`.
 
-```typescript
-import { getNextControlNumber, getCurrentControlNumber, setControlNumber } from '@ontemper/edi';
+Each Temper environment now has its own ISA13 and GS06 counter ledger.
 
-// Get next control number (atomic increment)
-const next = await getNextControlNumber('ISA13', 'ZZ:SENDER', 'ZZ:RECEIVER');
+### Automatic environment routing
 
-// Peek at current value without incrementing
-const current = await getCurrentControlNumber('ISA13', 'ZZ:SENDER', 'ZZ:RECEIVER');
+Automatic allocation reads `UNNBOUND_ENVIRONMENT`. Its value must be exactly `sandbox`, `staging`, or
+`production`. If the variable is missing or invalid, the SDK throws a `ControlNumberError` with the
+`control_number_environment_missing` code before making an HTTP request. This fail-closed behavior prevents an
+automatic allocation from using the wrong environment.
 
-// Set a starting value before the counter has incremented (for migrations)
-await setControlNumber('ISA13', 'ZZ:SENDER', 'ZZ:RECEIVER', 1000);
-```
+`getNextControlNumber()` and `toX12()` always use this ambient environment. ISA15 (`UsageIndicator_15`) does not
+select a counter, and `toX12()` does not change it.
 
-In most cases you don't need these directly — `toX12()` automatically stamps any empty or all-zero
-ISA13/GS06/ST02 fields. ISA13 and GS06 use `getNextControlNumber`; ST02 is assigned `"0001"`. This includes the
-zero placeholders returned by acknowledgment generation.
-Once a counter has incremented, the API rejects later `setControlNumber` calls to avoid resetting active sequences.
-Retried `setControlNumber` calls with the same already-stored seed are treated as idempotent no-ops.
-The SDK surfaces that as a `ControlNumberError` with `code: "counter_already_started"`:
+### Manage counters directly
 
 ```typescript
-import { isControlNumberError, setControlNumber } from '@ontemper/edi';
+import { getCurrentControlNumber, getNextControlNumber, setControlNumber } from '@ontemper/edi';
 
-try {
-  await setControlNumber('ISA13', 'ZZ:SENDER', 'ZZ:RECEIVER', 1000);
-} catch (error) {
-  if (isControlNumberError(error) && error.code === 'counter_already_started') {
-    // Counter is already active; do not reset it.
-  }
-}
+const senderId = 'ZZ:SENDER';
+const receiverId = 'ZZ:RECEIVER';
+
+const next = await getNextControlNumber('ISA13', senderId, receiverId);
+const current = await getCurrentControlNumber('ISA13', senderId, receiverId);
+
+// A sandbox onboarding workflow can inspect and seed the production ledger explicitly.
+const productionCurrent = await getCurrentControlNumber('ISA13', senderId, receiverId, 9, {
+  environment: 'production',
+});
+await setControlNumber('ISA13', senderId, receiverId, 4600, 9, {
+  environment: 'production',
+});
 ```
 
-Requires `UNNBOUND_API_URL` environment variable (pre-configured in all workflow environments).
+`getCurrentControlNumber()` and `setControlNumber()` accept an optional
+`{ environment: 'sandbox' | 'staging' | 'production' }` argument for cross-environment inspection and seeding.
+An explicit environment takes precedence over `UNNBOUND_ENVIRONMENT`. Without this option, both methods require
+the ambient environment. `getNextControlNumber()` accepts no environment override.
+
+A seed is the last-used value: seeding 4600 makes the next allocation 4601. Seed a counter only before its first
+increment. A repeated seed with the same stored value is idempotent; a different seed after the counter starts
+throws a `ControlNumberError` with the `counter_already_started` code.
+
+These helpers require `UNNBOUND_API_URL`, which is preconfigured in workflow environments.
 
 ## Requirements
 

package/dist/control-numbers.d.ts

@@ -1,5 +1,13 @@
 /** @public */
-export type ControlNumberErrorCode = 'counter_already_started' | 'control_number_bad_request' | 'control_number_unauthorized' | 'control_number_unknown_error';
+export type TemperEnvironment = 'sandbox' | 'staging' | 'production';
+/** @public */
+export type ControlNumberCounterName = 'ISA13' | 'GS06';
+/** @public */
+export interface ControlNumberEnvironmentOptions {
+    readonly environment?: TemperEnvironment;
+}
+/** @public */
+export type ControlNumberErrorCode = 'control_number_environment_missing' | 'counter_already_started' | 'control_number_bad_request' | 'control_number_unauthorized' | 'control_number_unknown_error';
 interface ControlNumberErrorOptions extends ErrorOptions {
     code: ControlNumberErrorCode;
     message: string;
@@ -23,15 +31,15 @@ export declare const isControlNumberError: (error: unknown) => error is ControlN
  * @param maxDigits - Zero-pad to this width (default: 9 for ISA13)
  */
 /** @public */
-export declare function getNextControlNumber(counterName: string, senderId: string, receiverId: string, maxDigits?: number): Promise<string>;
+export declare function getNextControlNumber(counterName: ControlNumberCounterName, senderId: string, receiverId: string, maxDigits?: number): Promise<string>;
 /**
  * Get the current control number value without incrementing.
  */
 /** @public */
-export declare function getCurrentControlNumber(counterName: string, senderId: string, receiverId: string, maxDigits?: number): Promise<string>;
+export declare function getCurrentControlNumber(counterName: ControlNumberCounterName, senderId: string, receiverId: string, maxDigits?: number, options?: ControlNumberEnvironmentOptions): Promise<string>;
 /**
  * Set a control number to a specific value before the counter starts (for migration/seeding).
  */
 /** @public */
-export declare function setControlNumber(counterName: string, senderId: string, receiverId: string, value: number, maxDigits?: number): Promise<string>;
+export declare function setControlNumber(counterName: ControlNumberCounterName, senderId: string, receiverId: string, value: number, maxDigits?: number, options?: ControlNumberEnvironmentOptions): Promise<string>;
 export {};

package/dist/control-numbers.js

@@ -78,6 +78,16 @@ exports.ControlNumberError = ControlNumberError;
 /** @public */
 const isControlNumberError = (error) => error instanceof ControlNumberError;
 exports.isControlNumberError = isControlNumberError;
+const requireEnvironment = () => {
+    const environment = process.env.UNNBOUND_ENVIRONMENT;
+    if (environment === 'sandbox' || environment === 'staging' || environment === 'production') {
+        return environment;
+    }
+    throw new ControlNumberError({
+        code: 'control_number_environment_missing',
+        message: "UNNBOUND_ENVIRONMENT must be set to 'sandbox', 'staging', or 'production' because automatic control-number routing needs it.",
+    });
+};
 function unwrapControlNumberError(error) {
     if (error instanceof ControlNumberError)
         throw error;
@@ -92,7 +102,7 @@ function unwrapControlNumberError(error) {
         if (error.response?.status === 400) {
             throw new ControlNumberError({
                 code: 'control_number_bad_request',
-                message: 'Invalid EDI control number request. Counter name, trading partner IDs, and value are required.',
+                message: "Invalid EDI control number request. Use counter name 'ISA13' or 'GS06' with trading partner IDs and, for set, a value.",
                 cause: error,
             });
         }
@@ -110,6 +120,20 @@ function unwrapControlNumberError(error) {
         cause: error,
     });
 }
+async function requestControlNumber(operation, input, environment) {
+    const request = { ...input, environment: environment ?? requireEnvironment() };
+    try {
+        const response = operation === 'count'
+            ? await getApiClient().get(`/api/v2/internal/edi/control-numbers/${operation}`, {
+                params: request,
+            })
+            : await getApiClient().post(`/api/v2/internal/edi/control-numbers/${operation}`, request);
+        return response.data;
+    }
+    catch (error) {
+        return unwrapControlNumberError(error);
+    }
+}
 /**
  * Get the next control number for an EDI counter.
  *
@@ -123,7 +147,7 @@ function unwrapControlNumberError(error) {
  */
 /** @public */
 async function getNextControlNumber(counterName, senderId, receiverId, maxDigits = 9) {
-    const { data } = await getApiClient().post('/api/v2/internal/edi/control-numbers/increment', {
+    const data = await requestControlNumber('increment', {
         tradingPartnerKey: `${senderId}:${receiverId}`,
         counterName,
     });
@@ -133,26 +157,22 @@ async function getNextControlNumber(counterName, senderId, receiverId, maxDigits
  * Get the current control number value without incrementing.
  */
 /** @public */
-async function getCurrentControlNumber(counterName, senderId, receiverId, maxDigits = 9) {
-    const { data } = await getApiClient().get('/api/v2/internal/edi/control-numbers/count', {
-        params: {
-            tradingPartnerKey: `${senderId}:${receiverId}`,
-            counterName,
-        },
-    });
+async function getCurrentControlNumber(counterName, senderId, receiverId, maxDigits = 9, options) {
+    const data = await requestControlNumber('count', {
+        tradingPartnerKey: `${senderId}:${receiverId}`,
+        counterName,
+    }, options?.environment);
     return String(data.value).padStart(maxDigits, '0');
 }
 /**
  * Set a control number to a specific value before the counter starts (for migration/seeding).
  */
 /** @public */
-async function setControlNumber(counterName, senderId, receiverId, value, maxDigits = 9) {
-    const { data } = await getApiClient()
-        .post('/api/v2/internal/edi/control-numbers/set', {
+async function setControlNumber(counterName, senderId, receiverId, value, maxDigits = 9, options) {
+    const data = await requestControlNumber('set', {
         tradingPartnerKey: `${senderId}:${receiverId}`,
         counterName,
         value,
-    })
-        .catch(unwrapControlNumberError);
+    }, options?.environment);
     return String(data.value).padStart(maxDigits, '0');
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { type EdifactInterchange, type X12Interchange } from './edination-client';
-export type { ControlNumberErrorCode } from './control-numbers';
+import type { X12Interchange } from './edination-client';
+export type { ControlNumberCounterName, ControlNumberEnvironmentOptions, ControlNumberErrorCode, } from './control-numbers';
 export { ControlNumberError, getCurrentControlNumber, getNextControlNumber, isControlNumberError, setControlNumber, } from './control-numbers';
 export * from './edination-client/model';
 interface UnnboundErrorOptions<C extends string = string> extends ErrorOptions {
@@ -35,21 +35,8 @@ export interface ValidateX12Options {
 export interface AcknolwedgeX12Options {
     input: X12Interchange;
 }
-export interface FromEdifactOptions {
-    input: unknown;
-}
-export interface ToEdifactOptions {
-    input: EdifactInterchange;
-}
-export interface ValidateEdifactOptions {
-    input: EdifactInterchange;
-}
-export interface AcknowledgeEdifactOptions {
-    input: EdifactInterchange;
-}
 export declare class TemperEdiClient {
     private X12;
-    private Edifact;
     constructor();
     private unwrap;
     private unwrapError;
@@ -64,19 +51,4 @@ export declare class TemperEdiClient {
     toX12({ input }: ToX12Options): Promise<unknown>;
     validateX12({ input }: ValidateX12Options): Promise<import("./edination-client").OperationResult>;
     acknowledgeX12({ input }: AcknolwedgeX12Options): Promise<X12Interchange[]>;
-    fromEdifact({ input }: FromEdifactOptions): Promise<EdifactInterchange[]>;
-    /**
-     * Stamp UNB-0020/UNH-0062 control references on the interchange if not already set.
-     *
-     * UNB-0020 (interchange control reference) comes from the same Restate-backed
-     * per-trading-partner counter service X12 uses, under the platform counter name
-     * `UNB0020` — unpadded, since EDIFACT 0020 is an..14 with no fixed width. The
-     * UNZ trailer echo is set to match. UNH-0062 (message reference number) only
-     * needs uniqueness within the interchange, so it is a local 1..n sequence with
-     * no service call, echoed into each UNT — the EDIFACT sibling of ST02="0001".
-     */
-    private stampEdifactControlNumbers;
-    toEdifact({ input }: ToEdifactOptions): Promise<unknown>;
-    validateEdifact({ input }: ValidateEdifactOptions): Promise<import("./edination-client").OperationResult>;
-    acknowledgeEdifact({ input }: AcknowledgeEdifactOptions): Promise<EdifactInterchange[]>;
 }

package/dist/index.js

@@ -40,13 +40,14 @@ exports.TemperEdiClient = exports.isEdiInfrastructureError = exports.EdiInfrastr
 const axios_1 = __importStar(require("axios"));
 const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
 const internal_1 = require("unnbound-logger-sdk/dist/internal");
+const control_numbers_1 = require("./control-numbers");
 const edination_client_1 = require("./edination-client");
-var control_numbers_1 = require("./control-numbers");
-Object.defineProperty(exports, "ControlNumberError", { enumerable: true, get: function () { return control_numbers_1.ControlNumberError; } });
-Object.defineProperty(exports, "getCurrentControlNumber", { enumerable: true, get: function () { return control_numbers_1.getCurrentControlNumber; } });
-Object.defineProperty(exports, "getNextControlNumber", { enumerable: true, get: function () { return control_numbers_1.getNextControlNumber; } });
-Object.defineProperty(exports, "isControlNumberError", { enumerable: true, get: function () { return control_numbers_1.isControlNumberError; } });
-Object.defineProperty(exports, "setControlNumber", { enumerable: true, get: function () { return control_numbers_1.setControlNumber; } });
+var control_numbers_2 = require("./control-numbers");
+Object.defineProperty(exports, "ControlNumberError", { enumerable: true, get: function () { return control_numbers_2.ControlNumberError; } });
+Object.defineProperty(exports, "getCurrentControlNumber", { enumerable: true, get: function () { return control_numbers_2.getCurrentControlNumber; } });
+Object.defineProperty(exports, "getNextControlNumber", { enumerable: true, get: function () { return control_numbers_2.getNextControlNumber; } });
+Object.defineProperty(exports, "isControlNumberError", { enumerable: true, get: function () { return control_numbers_2.isControlNumberError; } });
+Object.defineProperty(exports, "setControlNumber", { enumerable: true, get: function () { return control_numbers_2.setControlNumber; } });
 __exportStar(require("./edination-client/model"), exports);
 class UnnboundError extends Error {
     code;
@@ -79,7 +80,7 @@ exports.EdiInfrastructureError = EdiInfrastructureError;
 const isEdiInfrastructureError = (error) => error instanceof EdiInfrastructureError;
 exports.isEdiInfrastructureError = isEdiInfrastructureError;
 const buildEdiPayload = (edi) => ({ type: 'edi', edi });
-const buildEdiTransactionPayload = (operation, format, transaction) => buildEdiPayload({ operation, type: format, transaction });
+const buildEdiX12Payload = (operation, x12) => buildEdiPayload({ operation, type: 'x12', x12 });
 const needsControlNumber = (value) => {
     const normalized = value?.trim();
     return !normalized || /^0+$/.test(normalized);
@@ -87,7 +88,6 @@ const needsControlNumber = (value) => {
 const ediAxios = (0, unnbound_logger_sdk_1.traceAxios)(axios_1.default.create(), { getPayload: internal_1.internal });
 class TemperEdiClient {
     X12;
-    Edifact;
     constructor() {
         const apiKey = process.env.UNNBOUND_EDI_API_KEY;
         // When UNNBOUND_EDI_BASE_URL is set, use self-hosted EdiFabric InHouse API
@@ -100,7 +100,6 @@ class TemperEdiClient {
         // but the OpenAPI client requires a non-empty value — use a placeholder.
         const config = new edination_client_1.Configuration({ apiKey: apiKey ?? 'self-hosted', basePath });
         this.X12 = new edination_client_1.X12Api(config, undefined, ediAxios);
-        this.Edifact = new edination_client_1.EdifactApi(config, undefined, ediAxios);
     }
     unwrap(response) {
         return response.data;
@@ -147,7 +146,7 @@ class TemperEdiClient {
             return this.X12.x12ReadPost({ body: input })
                 .then(this.unwrap.bind(this))
                 .catch((error) => this.unwrapError(error, 'edi_read_error'));
-        }, (o) => buildEdiTransactionPayload('fromX12', 'x12', { input, output: o?.result }));
+        }, (o) => buildEdiX12Payload('fromX12', { input, output: o?.result }));
     }
     /**
      * Stamp ISA13/GS06/ST02 control numbers on the interchange if not already set.
@@ -156,7 +155,6 @@ class TemperEdiClient {
      * Zero-filled values from acknowledgment generation are placeholders, not manual overrides.
      */
     async stampControlNumbers(input) {
-        const { getNextControlNumber } = await import('./control-numbers.js');
         const isa = input.ISA;
         const senderQual = (isa.SenderIDQualifier_5 || '').trim();
         const senderId = (isa.InterchangeSenderID_6 || '').trim();
@@ -164,20 +162,18 @@ class TemperEdiClient {
         const receiverId = (isa.InterchangeReceiverID_8 || '').trim();
         const senderKey = `${senderQual}:${senderId}`;
         const receiverKey = `${receiverQual}:${receiverId}`;
-        // Phase 1: Fetch all needed control numbers (no mutations yet).
-        // If any fetch fails, no fields are mutated — avoids partial stamping.
+        // Allocate before mutating so a failed request cannot leave partial stamps.
         const isa13 = needsControlNumber(isa.InterchangeControlNumber_13)
-            ? await getNextControlNumber('ISA13', senderKey, receiverKey, 9)
+            ? await (0, control_numbers_1.getNextControlNumber)('ISA13', senderKey, receiverKey, 9)
             : null;
         const gs06Values = [];
         const groups = input.Groups ?? [];
         for (let i = 0; i < groups.length; i++) {
             if (needsControlNumber(groups[i].GS.GroupControlNumber_6)) {
-                const value = await getNextControlNumber('GS06', senderKey, receiverKey, 9);
+                const value = await (0, control_numbers_1.getNextControlNumber)('GS06', senderKey, receiverKey, 9);
                 gs06Values.push({ index: i, value });
             }
         }
-        // Phase 2: Apply all mutations (only reached if all fetches succeeded).
         if (isa13) {
             isa.InterchangeControlNumber_13 = isa13;
             if (input.IEATrailers?.length) {
@@ -191,7 +187,6 @@ class TemperEdiClient {
                 group.GETrailers[0].GroupControlNumber_2 = value;
             }
         }
-        // ST02 — always "0001" (pure assignment, no external calls)
         for (const group of groups) {
             for (const tx of group.Transactions) {
                 if (needsControlNumber(tx?.ST?.TransactionSetControlNumber_02)) {
@@ -204,20 +199,20 @@ class TemperEdiClient {
         }
     }
     async toX12({ input }) {
-        // Auto-stamp control numbers before writing X12
         try {
             await this.stampControlNumbers(input);
         }
         catch (error) {
-            // Log but don't fail — workflows can still set control numbers manually
-            const { logger } = await import('unnbound-logger-sdk');
-            logger.warn({ err: error }, '[EDI SDK] Failed to auto-stamp control numbers, proceeding without');
+            if (error instanceof control_numbers_1.ControlNumberError)
+                throw error;
+            // Workflows can still serialize documents whose control numbers were set manually.
+            unnbound_logger_sdk_1.logger.warn({ err: error }, '[EDI SDK] Failed to auto-stamp control numbers, proceeding without');
         }
         return (0, unnbound_logger_sdk_1.startSpan)('JSON to X12', () => {
             return this.X12.x12WritePost({ x12Interchange: input })
                 .then(this.unwrap.bind(this))
                 .catch((error) => this.unwrapError(error, 'edi_write_error'));
-        }, (o) => buildEdiTransactionPayload('toX12', 'x12', { input, output: o?.result }));
+        }, (o) => buildEdiX12Payload('toX12', { input, output: o?.result }));
     }
     validateX12({ input }) {
         return (0, unnbound_logger_sdk_1.startSpan)('Validate X12', () => {
@@ -225,7 +220,7 @@ class TemperEdiClient {
                 .then(this.unwrap.bind(this))
                 .catch((error) => this.unwrapError(error, 'edi_validate_error'));
         }, (o) => ({
-            ...buildEdiTransactionPayload('validateX12', 'x12', { input, output: o?.result }),
+            ...buildEdiX12Payload('validateX12', { input, output: o?.result }),
             ...(o?.result?.Status === 'error' && { level: 'warn' }),
         }));
     }
@@ -234,87 +229,7 @@ class TemperEdiClient {
             return this.X12.x12AckPost({ x12Interchange: input })
                 .then(this.unwrap.bind(this))
                 .catch((error) => this.unwrapError(error, 'edi_acknowledge_error'));
-        }, (o) => buildEdiTransactionPayload('acknowledgeX12', 'x12', { input, output: o?.result }));
-    }
-    fromEdifact({ input }) {
-        return (0, unnbound_logger_sdk_1.startSpan)('EDIFACT to JSON', () => {
-            return this.Edifact.edifactReadPost({ body: input })
-                .then(this.unwrap.bind(this))
-                .catch((error) => this.unwrapError(error, 'edi_read_error'));
-        }, (o) => buildEdiTransactionPayload('fromEdifact', 'edifact', { input, output: o?.result }));
-    }
-    /**
-     * Stamp UNB-0020/UNH-0062 control references on the interchange if not already set.
-     *
-     * UNB-0020 (interchange control reference) comes from the same Restate-backed
-     * per-trading-partner counter service X12 uses, under the platform counter name
-     * `UNB0020` — unpadded, since EDIFACT 0020 is an..14 with no fixed width. The
-     * UNZ trailer echo is set to match. UNH-0062 (message reference number) only
-     * needs uniqueness within the interchange, so it is a local 1..n sequence with
-     * no service call, echoed into each UNT — the EDIFACT sibling of ST02="0001".
-     */
-    async stampEdifactControlNumbers(input) {
-        const { getNextControlNumber } = await import('./control-numbers.js');
-        const sender = input.UNB?.INTERCHANGESENDER_2;
-        const recipient = input.UNB?.INTERCHANGERECIPIENT_3;
-        const senderKey = `${(sender?.IdentificationCodeQualifier_2 || '').trim()}:${(sender?.InterchangeSenderIdentification_1 || '').trim()}`;
-        const receiverKey = `${(recipient?.IdentificationCodeQualifier_2 || '').trim()}:${(recipient?.InterchangeRecipientIdentification_1 || '').trim()}`;
-        // Fetch before mutating — if the fetch fails, no fields change.
-        const unb0020 = needsControlNumber(input.UNB?.InterchangeControlReference_5)
-            ? await getNextControlNumber('UNB0020', senderKey, receiverKey, 0)
-            : null;
-        if (unb0020) {
-            input.UNB.InterchangeControlReference_5 = unb0020;
-            if (input.UNZTrailers?.length) {
-                input.UNZTrailers[0].InterchangeControlReference_2 = unb0020;
-            }
-        }
-        // UNH-0062 — local sequence across the interchange's messages (no external calls)
-        let messageReference = 0;
-        for (const group of input.Groups ?? []) {
-            for (const message of group.Transactions ?? []) {
-                messageReference += 1;
-                if (needsControlNumber(message?.UNH?.MessageReferenceNumber_01)) {
-                    if (message?.UNH)
-                        message.UNH.MessageReferenceNumber_01 = String(messageReference);
-                    if (message?.UNT)
-                        message.UNT.MessageReferenceNumber_02 = String(messageReference);
-                }
-            }
-        }
-    }
-    async toEdifact({ input }) {
-        // Auto-stamp control references before writing EDIFACT
-        try {
-            await this.stampEdifactControlNumbers(input);
-        }
-        catch (error) {
-            // Log but don't fail — workflows can still set control references manually
-            const { logger } = await import('unnbound-logger-sdk');
-            logger.warn({ err: error }, '[EDI SDK] Failed to auto-stamp control references, proceeding without');
-        }
-        return (0, unnbound_logger_sdk_1.startSpan)('JSON to EDIFACT', () => {
-            return this.Edifact.edifactWritePost({ edifactInterchange: input })
-                .then(this.unwrap.bind(this))
-                .catch((error) => this.unwrapError(error, 'edi_write_error'));
-        }, (o) => buildEdiTransactionPayload('toEdifact', 'edifact', { input, output: o?.result }));
-    }
-    validateEdifact({ input }) {
-        return (0, unnbound_logger_sdk_1.startSpan)('Validate EDIFACT', () => {
-            return this.Edifact.edifactValidatePost({ edifactInterchange: input })
-                .then(this.unwrap.bind(this))
-                .catch((error) => this.unwrapError(error, 'edi_validate_error'));
-        }, (o) => ({
-            ...buildEdiTransactionPayload('validateEdifact', 'edifact', { input, output: o?.result }),
-            ...(o?.result?.Status === 'error' && { level: 'warn' }),
-        }));
-    }
-    acknowledgeEdifact({ input }) {
-        return (0, unnbound_logger_sdk_1.startSpan)('Acknowledge EDIFACT', () => {
-            return this.Edifact.edifactAckPost({ edifactInterchange: input })
-                .then(this.unwrap.bind(this))
-                .catch((error) => this.unwrapError(error, 'edi_acknowledge_error'));
-        }, (o) => buildEdiTransactionPayload('acknowledgeEdifact', 'edifact', { input, output: o?.result }));
+        }, (o) => buildEdiX12Payload('acknowledgeX12', { input, output: o?.result }));
     }
 }
 exports.TemperEdiClient = TemperEdiClient;

package/examples/node-edi.ts

@@ -1,5 +1,4 @@
 import { logger } from 'unnbound-logger-sdk';
-
 import { TemperEdiClient } from '../src';
 
 const run = async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ontemper/edi",
   "description": "An EDI client with structured logging.",
-  "version": "1.2.0-beta.1",
+  "version": "1.2.0-beta.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "Unnbound Team",
@@ -15,8 +15,8 @@
     "url": "https://github.com/unnbounddev/unnbound-sdks/issues"
   },
   "dependencies": {
-    "axios": "1.16.0",
-    "unnbound-logger-sdk": "3.2.0-beta.1"
+    "axios": "1.18.0",
+    "unnbound-logger-sdk": "3.0.37"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",
@@ -37,8 +37,8 @@
     "build": "tsc",
     "test": "vitest run src",
     "typecheck": "tsc --noEmit",
-    "format": "biome format --write .",
-    "format:check": "biome format .",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
     "start:example": "tsx watch examples/node-edi.ts",
     "version:bump": "npm version patch",
     "release": "pnpm run build && pnpm publish --access public",