@modernedi/sdk 0.1.0

package/dist/response.js

@@ -0,0 +1,30 @@
+function optionalHeader(response, name) {
+    return response.headers.get(name) ?? undefined;
+}
+function optionalBooleanHeader(response, name) {
+    const value = response.headers.get(name)?.trim().toLowerCase();
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    return undefined;
+}
+/**
+ * Reads ModernEDI correlation, retry, idempotency, and optimistic-concurrency headers from a
+ * generated operation's `*Raw()` response.
+ */
+export function getModernEdiResponseMetadata(response) {
+    const requestId = optionalHeader(response, "X-Request-Id");
+    const retryAfter = optionalHeader(response, "Retry-After");
+    const idempotencyReplayed = optionalBooleanHeader(response, "Idempotency-Replayed");
+    const etag = optionalHeader(response, "ETag");
+    return {
+        ...(requestId === undefined ? {} : { requestId }),
+        ...(retryAfter === undefined ? {} : { retryAfter }),
+        ...(idempotencyReplayed === undefined ? {} : { idempotencyReplayed }),
+        ...(etag === undefined ? {} : { etag }),
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAOA,SAAS,cAAc,CAAC,QAAkB,EAAE,IAAY;IACtD,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACjD,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAkB,EAAE,IAAY;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/D,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAkB;IAC7D,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE9C,OAAO;QACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACnD,GAAG,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/retry.d.ts

@@ -0,0 +1,17 @@
+import type { FetchAPI } from "./generated/runtime.js";
+export interface ModernEdiRetryOptions {
+    /**
+     * Total request attempts, including the first call. Must be between 1 and 10.
+     */
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    retryableStatuses?: readonly number[];
+}
+/**
+ * Adds conservative opt-in retries. GET/HEAD/OPTIONS and idempotent transaction
+ * watch/unwatch requests are safe to retry without an `Idempotency-Key`; other
+ * mutating requests require one.
+ */
+export declare function createRetryingFetch(fetchApi: FetchAPI, retryOptions?: ModernEdiRetryOptions): FetchAPI;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAIvD,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAyHD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,YAAY,GAAE,qBAA0B,GACvC,QAAQ,CAgCV"}

package/dist/retry.js

@@ -0,0 +1,137 @@
+const DEFAULT_RETRYABLE_STATUSES = [429, 502, 503, 504];
+function normalizeNonNegativeNumber(value, fallback, name) {
+    const normalized = value ?? fallback;
+    if (!Number.isFinite(normalized) || normalized < 0) {
+        throw new TypeError(`${name} must be a non-negative finite number`);
+    }
+    return normalized;
+}
+function normalizeRetryOptions(options) {
+    const maxAttempts = options.maxAttempts ?? 3;
+    if (!Number.isInteger(maxAttempts) || maxAttempts < 1 || maxAttempts > 10) {
+        throw new TypeError("maxAttempts must be an integer between 1 and 10");
+    }
+    return {
+        maxAttempts,
+        baseDelayMs: normalizeNonNegativeNumber(options.baseDelayMs, 250, "baseDelayMs"),
+        maxDelayMs: normalizeNonNegativeNumber(options.maxDelayMs, 10_000, "maxDelayMs"),
+        retryableStatuses: new Set(options.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES),
+    };
+}
+function requestMethod(input, init) {
+    if (init?.method) {
+        return init.method.toUpperCase();
+    }
+    if (typeof input !== "string" && !(input instanceof URL) && input.method) {
+        return input.method.toUpperCase();
+    }
+    return "GET";
+}
+function requestPath(input) {
+    const value = typeof input === "string"
+        ? input
+        : input instanceof URL
+            ? input.href
+            : input.url;
+    try {
+        return new URL(value, "https://sdk.invalid").pathname;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isTransactionWatchOperation(input, method) {
+    if (method !== "PUT" && method !== "DELETE") {
+        return false;
+    }
+    const path = requestPath(input);
+    return path !== undefined
+        && /\/v1\/integration\/transactions\/[^/]+\/[^/]+\/watch\/?$/.test(path);
+}
+function requestCanBeRetried(input, init) {
+    const method = requestMethod(input, init);
+    if (method === "GET" || method === "HEAD" || method === "OPTIONS") {
+        return true;
+    }
+    if (isTransactionWatchOperation(input, method)) {
+        return true;
+    }
+    const requestHeaders = init?.headers
+        ?? (typeof input !== "string" && !(input instanceof URL) ? input.headers : undefined);
+    return new Headers(requestHeaders).has("Idempotency-Key");
+}
+function retryAfterMilliseconds(response) {
+    const value = response.headers.get("Retry-After")?.trim();
+    if (!value) {
+        return undefined;
+    }
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return seconds * 1_000;
+    }
+    const date = Date.parse(value);
+    if (Number.isNaN(date)) {
+        return undefined;
+    }
+    return Math.max(0, date - Date.now());
+}
+function abortError() {
+    return new DOMException("The operation was aborted", "AbortError");
+}
+async function delay(milliseconds, signal) {
+    if (signal?.aborted) {
+        throw signal.reason ?? abortError();
+    }
+    if (milliseconds <= 0) {
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(resolve, milliseconds);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            reject(signal.reason ?? abortError());
+        }, { once: true });
+    });
+}
+function exponentialDelay(attempt, options) {
+    return Math.min(options.baseDelayMs * 2 ** Math.max(0, attempt - 1), options.maxDelayMs);
+}
+/**
+ * Adds conservative opt-in retries. GET/HEAD/OPTIONS and idempotent transaction
+ * watch/unwatch requests are safe to retry without an `Idempotency-Key`; other
+ * mutating requests require one.
+ */
+export function createRetryingFetch(fetchApi, retryOptions = {}) {
+    const options = normalizeRetryOptions(retryOptions);
+    return async (input, init) => {
+        const retryableRequest = requestCanBeRetried(input, init);
+        for (let attempt = 1; attempt <= options.maxAttempts; attempt += 1) {
+            try {
+                const response = await fetchApi(input, init);
+                const shouldRetry = retryableRequest &&
+                    attempt < options.maxAttempts &&
+                    options.retryableStatuses.has(response.status);
+                if (!shouldRetry) {
+                    return response;
+                }
+                const retryAfter = retryAfterMilliseconds(response);
+                if (retryAfter !== undefined && retryAfter > options.maxDelayMs) {
+                    // Never retry earlier than the server requested. Return the response so the normal
+                    // structured error exposes Retry-After and the caller can schedule a later attempt.
+                    return response;
+                }
+                const waitFor = retryAfter ?? exponentialDelay(attempt, options);
+                await response.body?.cancel();
+                await delay(waitFor, init?.signal);
+            }
+            catch (error) {
+                if (!retryableRequest || attempt >= options.maxAttempts || init?.signal?.aborted) {
+                    throw error;
+                }
+                await delay(exponentialDelay(attempt, options), init?.signal);
+            }
+        }
+        throw new Error("Retry loop exhausted without returning or throwing");
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/examples/response-metadata.ts

@@ -0,0 +1,19 @@
+import {
+  ModernEdiClient,
+  getModernEdiResponseMetadata,
+} from "@modernedi/sdk";
+
+const apiKey = process.env.MODERNEDI_API_KEY;
+if (!apiKey) {
+  throw new Error("Set MODERNEDI_API_KEY before running this example");
+}
+
+const modernEdi = new ModernEdiClient({ apiKey });
+
+export async function getPartnerWithMetadata(partnerId: number) {
+  const response = await modernEdi.partners.getIntegrationPartnerRaw({ partnerId });
+  const partner = await response.value();
+  const metadata = getModernEdiResponseMetadata(response.raw);
+
+  return { partner, metadata };
+}

package/examples/send-documents.ts

@@ -0,0 +1,35 @@
+import { ModernEdiClient } from "@modernedi/sdk";
+
+const apiKey = process.env.MODERNEDI_API_KEY;
+if (!apiKey) {
+  throw new Error("Set MODERNEDI_API_KEY before running this example");
+}
+
+const modernEdi = new ModernEdiClient({ apiKey });
+
+export async function sendMappedInvoice(): Promise<void> {
+  await modernEdi.outboundAs2.sendAs2Message({
+    partnerId: 17,
+    x12Version: "005010",
+    functionalGroupType: "IN",
+    transactionGroupType: 810,
+    idempotencyKey: crypto.randomUUID(),
+    contentType: "application/json",
+    body: {
+      invoiceNumber: "INV-1001",
+      total: 240.0,
+    },
+  });
+}
+
+export async function sendGeneratedInvoiceX12(x12: string): Promise<void> {
+  await modernEdi.outboundAs2.sendGeneratedX12Message({
+    partnerId: 17,
+    x12Version: "005010",
+    functionalGroupType: "IN",
+    transactionGroupType: 810,
+    idempotencyKey: crypto.randomUUID(),
+    contentType: "application/edi-x12",
+    body: x12,
+  });
+}

package/examples/transaction-console.ts

@@ -0,0 +1,46 @@
+import {
+  ModernEdiApiError,
+  ModernEdiClient,
+  paginateCursor,
+} from "@modernedi/sdk";
+
+const apiKey = process.env.MODERNEDI_API_KEY;
+if (!apiKey) {
+  throw new Error("Set MODERNEDI_API_KEY before running this example");
+}
+
+const modernEdi = new ModernEdiClient({
+  apiKey,
+  retry: { maxAttempts: 3 },
+});
+
+try {
+  for await (const transaction of paginateCursor(
+    (cursor) =>
+      modernEdi.transactions.listIntegrationTransactions({
+        environment: "production",
+        needsAttention: true,
+        mappingStatus: ["FAILED", "COMPLETED_WITH_ERRORS"],
+        cursor,
+        limit: 100,
+      }),
+    (page) => ({
+      items: page.transactions,
+      nextCursor: page.nextCursor,
+    }),
+  )) {
+    console.log(
+      transaction.messageId,
+      transaction.transactionKey,
+      transaction.mappingStatus.status,
+      transaction.attentionReasons,
+    );
+  }
+} catch (error) {
+  if (error instanceof ModernEdiApiError) {
+    console.error(
+      `ModernEDI request failed: ${error.code} (${error.requestId ?? "no request id"})`,
+    );
+  }
+  throw error;
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@modernedi/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the ModernEDI Integration API",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "ModernEDI",
+    "email": "contact@modernedi.com",
+    "url": "https://www.modernedi.com/"
+  },
+  "keywords": [
+    "edi",
+    "x12",
+    "as2",
+    "electronic-data-interchange",
+    "b2b",
+    "integration",
+    "sdk",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brcolow/modernedi.git",
+    "directory": "sdks/typescript"
+  },
+  "homepage": "https://www.modernedi.com/integration-api/",
+  "bugs": {
+    "url": "https://www.modernedi.com/contact",
+    "email": "contact@modernedi.com"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "generate": "npm --prefix ../codegen run generate:typescript",
+    "check:generated": "npm --prefix ../codegen run check:typescript",
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && npm run typecheck:contracts && node --test test/*.test.mjs",
+    "typecheck:contracts": "tsc -p tsconfig.contract-tests.json",
+    "typecheck:examples": "npm run build && tsc -p tsconfig.examples.json",
+    "verify": "npm run check:generated && npm test && npm run typecheck:examples && npm pack --dry-run",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.43",
+    "typescript": "~5.9.3"
+  }
+}