@beliq/sdk 0.2.0 → 0.3.0

package/dist/index.js

@@ -169,6 +169,8 @@ function errorFromResponse(status, bytes) {
 
 // src/constants.ts
 var DEFAULT_BASE_URL = "https://api.beliq.eu";
+var DEFAULT_TIMEOUT_MS = 9e4;
+var DEFAULT_MAX_RETRIES = 3;
 var LIVE_GENERATE_STANDARDS = ["xrechnung", "zugferd", "facturx", "peppol-bis"];
 var LIVE_GENERATE_PRESETS = [
   { id: "xrechnung", label: "XRechnung", standard: "xrechnung", output: "xml" },
@@ -178,6 +180,19 @@ var LIVE_GENERATE_PRESETS = [
   { id: "nlcius", label: "NLCIUS", standard: "peppol-bis", output: "xml", profile: "netherlands-nlcius" }
 ];
 var LIVE_PROFILES = ["basicwl", "en16931", "extended", "extended-ctc-fr"];
+var LIVE_PROFILES_BY_STANDARD = {
+  xrechnung: ["xrechnung"],
+  "peppol-bis": ["peppol", "romania-ro-cius", "netherlands-nlcius"],
+  zugferd: ["basicwl", "en16931", "extended"],
+  facturx: ["basicwl", "en16931", "extended", "extended-ctc-fr"]
+};
+function profilesForStandard(standard) {
+  return LIVE_PROFILES_BY_STANDARD[standard] ?? [];
+}
+function isProfileAllowedForStandard(standard, profile) {
+  const allowed = profilesForStandard(standard);
+  return allowed.length === 0 || allowed.includes(profile);
+}
 var LIVE_VALIDATE_FORMATS = ["auto", "cii", "ubl"];
 var LIVE_PARSE_FORMATS = ["auto", "cii", "ubl"];
 var LIVE_CONVERT_SOURCE_FORMATS = [
@@ -199,6 +214,9 @@ var LIVE_CONVERT_TARGET_FORMATS = [
 ];
 
 // src/transport.ts
+var RETRYABLE_STATUSES = /* @__PURE__ */ new Set([429, 502, 503]);
+var MAX_RETRY_AFTER_MS = 3e4;
+var BACKOFF_BASE_MS = 500;
 function authHeaders(config) {
   return config.auth === "bearer" ? { Authorization: `Bearer ${config.apiKey}` } : { "X-API-Key": config.apiKey };
 }
@@ -212,19 +230,58 @@ function buildUrl(baseUrl, path, query) {
   const qs = params.toString();
   return qs ? `${baseUrl}${path}?${qs}` : `${baseUrl}${path}`;
 }
+function retryDelayMs(res, attempt) {
+  const header = res?.headers.get("retry-after");
+  if (header) {
+    const seconds = Number(header);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+      return Math.min(seconds * 1e3, MAX_RETRY_AFTER_MS) + Math.random() * 250;
+    }
+  }
+  const backoff = BACKOFF_BASE_MS * 2 ** attempt;
+  return backoff + Math.random() * backoff;
+}
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function send(config, req) {
   const headers = { ...authHeaders(config) };
   if (req.contentType) headers["Content-Type"] = req.contentType;
   if (req.accept) headers["Accept"] = req.accept;
   const body = req.jsonBody !== void 0 ? JSON.stringify(req.jsonBody) : req.rawBody;
-  const res = await config.fetchImpl(buildUrl(config.baseUrl, req.path, req.query), {
-    method: req.method,
-    headers,
-    body
-  });
-  const bytes = new Uint8Array(await res.arrayBuffer());
-  if (!res.ok) throw errorFromResponse(res.status, bytes);
-  return { status: res.status, headers: res.headers, bytes };
+  const url = buildUrl(config.baseUrl, req.path, req.query);
+  let lastError;
+  for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+    const controller = new AbortController();
+    const timer = config.timeoutMs > 0 ? setTimeout(() => controller.abort(), config.timeoutMs) : void 0;
+    let res;
+    try {
+      res = await config.fetchImpl(url, {
+        method: req.method,
+        headers,
+        body,
+        signal: controller.signal
+      });
+      const bytes = new Uint8Array(await res.arrayBuffer());
+      if (res.ok) return { status: res.status, headers: res.headers, bytes };
+      lastError = errorFromResponse(res.status, bytes);
+      if (!RETRYABLE_STATUSES.has(res.status) || attempt === config.maxRetries) {
+        throw lastError;
+      }
+    } catch (err) {
+      if (err instanceof BeliqApiError && !RETRYABLE_STATUSES.has(err.status)) throw err;
+      if (controller.signal.aborted) {
+        throw new BeliqApiError(
+          `beliq: request to ${req.path} exceeded ${config.timeoutMs}ms`,
+          { status: 0, code: "TIMEOUT" }
+        );
+      }
+      lastError = err;
+      if (attempt === config.maxRetries) throw err;
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+    await sleep(retryDelayMs(res, attempt));
+  }
+  throw lastError;
 }
 
 // src/client.ts
@@ -295,7 +352,9 @@ var Beliq = class {
       apiKey: options.apiKey,
       baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
       auth: options.auth ?? "header",
-      fetchImpl
+      fetchImpl,
+      timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+      maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES
     };
   }
   /** Account, plan, and quota context for the key. Does not consume quota. */
@@ -395,11 +454,16 @@ export {
   Beliq,
   BeliqApiError,
   DEFAULT_BASE_URL,
+  DEFAULT_MAX_RETRIES,
+  DEFAULT_TIMEOUT_MS,
   LIVE_CONVERT_SOURCE_FORMATS,
   LIVE_CONVERT_TARGET_FORMATS,
   LIVE_GENERATE_PRESETS,
   LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS,
   LIVE_PROFILES,
-  LIVE_VALIDATE_FORMATS
+  LIVE_PROFILES_BY_STANDARD,
+  LIVE_VALIDATE_FORMATS,
+  isProfileAllowedForStandard,
+  profilesForStandard
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beliq/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official beliq SDK: generate, validate, parse, and convert EU-compliant e-invoices (XRechnung, ZUGFeRD, Factur-X, Peppol BIS) against authority-pinned, drift-checked rules.",
   "keywords": [
     "beliq",
@@ -75,17 +75,22 @@
     "spec:drift": "node scripts/check-live-drift.mjs",
     "test": "vitest run --exclude test/integration.test.ts",
     "test:integration": "vitest run test/integration.test.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "check:profiles": "node --experimental-strip-types scripts/check-profile-drift.mjs"
   },
   "dependencies": {},
+  "overrides": {
+    "esbuild": "^0.28.1",
+    "js-yaml": "^4.3.1"
+  },
   "devDependencies": {
+    "@eslint/js": "^10.0.0",
     "@types/node": "^20.14.0",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "eslint": "^8.57.0",
+    "eslint": "^10.0.0",
     "openapi-typescript": "^7.4.0",
     "tsup": "^8.3.0",
     "typescript": "^5.5.4",
-    "vitest": "^2.1.8"
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^4.0.0"
   }
 }

package/dist/constants-D3j_o7th.d.cts

@@ -1,40 +0,0 @@
-type PlainObject = Record<string, unknown>;
-declare function isPlainObject(value: unknown): value is PlainObject;
-/** Deep-merge `source` into `target` (source wins). Arrays and scalars overwrite. */
-declare function mergeDeep(target: PlainObject, source: PlainObject): PlainObject;
-/** Drop undefined/empty entries so optional query params are omitted, not sent blank. */
-declare function compactQuery(query: PlainObject): PlainObject;
-/** Document bytes a caller may pass to validate/parse/convert. */
-type DocumentInput = string | Uint8Array | ArrayBuffer | ArrayBufferView;
-declare function toBytes(input: DocumentInput): Uint8Array;
-declare function decodeUtf8(bytes: Uint8Array): string;
-/** Sniff `application/pdf` vs `application/xml` from the leading bytes. */
-declare function sniffContentType(bytes: Uint8Array): string;
-
-declare const DEFAULT_BASE_URL = "https://api.beliq.eu";
-declare const LIVE_GENERATE_STANDARDS: readonly ["xrechnung", "zugferd", "facturx", "peppol-bis"];
-/** A named generate target: the API `standard` plus the `profile`/`facturxProfile`/`output` it needs. */
-interface GeneratePreset {
-    id: string;
-    label: string;
-    standard: (typeof LIVE_GENERATE_STANDARDS)[number];
-    output: 'xml' | 'pdf';
-    /** API `profile`; omitted lets the engine pick the standard's default. */
-    profile?: string;
-    /** API `facturxProfile`; Factur-X / ZUGFeRD only. */
-    facturxProfile?: string;
-}
-/**
- * Named generate targets surfaced to end users (connector dropdowns), mirroring
- * the public set on beliq.eu's own generator. NLCIUS is a Peppol BIS profile,
- * not a standalone standard, so it is reachable here rather than through
- * LIVE_GENERATE_STANDARDS or the Factur-X-only LIVE_PROFILES.
- */
-declare const LIVE_GENERATE_PRESETS: readonly GeneratePreset[];
-declare const LIVE_PROFILES: readonly ["basicwl", "en16931", "extended", "extended-ctc-fr"];
-declare const LIVE_VALIDATE_FORMATS: readonly ["auto", "cii", "ubl"];
-declare const LIVE_PARSE_FORMATS: readonly ["auto", "cii", "ubl"];
-declare const LIVE_CONVERT_SOURCE_FORMATS: readonly ["auto", "cii", "ubl", "zugferd", "facturx", "xrechnung", "peppol-bis"];
-declare const LIVE_CONVERT_TARGET_FORMATS: readonly ["cii", "ubl", "zugferd", "facturx", "xrechnung", "peppol-bis"];
-
-export { DEFAULT_BASE_URL as D, type GeneratePreset as G, LIVE_CONVERT_SOURCE_FORMATS as L, type PlainObject as P, type DocumentInput as a, LIVE_CONVERT_TARGET_FORMATS as b, LIVE_GENERATE_PRESETS as c, LIVE_GENERATE_STANDARDS as d, LIVE_PARSE_FORMATS as e, LIVE_PROFILES as f, LIVE_VALIDATE_FORMATS as g, compactQuery as h, decodeUtf8 as i, isPlainObject as j, mergeDeep as m, sniffContentType as s, toBytes as t };

package/dist/constants-D3j_o7th.d.ts

@@ -1,40 +0,0 @@
-type PlainObject = Record<string, unknown>;
-declare function isPlainObject(value: unknown): value is PlainObject;
-/** Deep-merge `source` into `target` (source wins). Arrays and scalars overwrite. */
-declare function mergeDeep(target: PlainObject, source: PlainObject): PlainObject;
-/** Drop undefined/empty entries so optional query params are omitted, not sent blank. */
-declare function compactQuery(query: PlainObject): PlainObject;
-/** Document bytes a caller may pass to validate/parse/convert. */
-type DocumentInput = string | Uint8Array | ArrayBuffer | ArrayBufferView;
-declare function toBytes(input: DocumentInput): Uint8Array;
-declare function decodeUtf8(bytes: Uint8Array): string;
-/** Sniff `application/pdf` vs `application/xml` from the leading bytes. */
-declare function sniffContentType(bytes: Uint8Array): string;
-
-declare const DEFAULT_BASE_URL = "https://api.beliq.eu";
-declare const LIVE_GENERATE_STANDARDS: readonly ["xrechnung", "zugferd", "facturx", "peppol-bis"];
-/** A named generate target: the API `standard` plus the `profile`/`facturxProfile`/`output` it needs. */
-interface GeneratePreset {
-    id: string;
-    label: string;
-    standard: (typeof LIVE_GENERATE_STANDARDS)[number];
-    output: 'xml' | 'pdf';
-    /** API `profile`; omitted lets the engine pick the standard's default. */
-    profile?: string;
-    /** API `facturxProfile`; Factur-X / ZUGFeRD only. */
-    facturxProfile?: string;
-}
-/**
- * Named generate targets surfaced to end users (connector dropdowns), mirroring
- * the public set on beliq.eu's own generator. NLCIUS is a Peppol BIS profile,
- * not a standalone standard, so it is reachable here rather than through
- * LIVE_GENERATE_STANDARDS or the Factur-X-only LIVE_PROFILES.
- */
-declare const LIVE_GENERATE_PRESETS: readonly GeneratePreset[];
-declare const LIVE_PROFILES: readonly ["basicwl", "en16931", "extended", "extended-ctc-fr"];
-declare const LIVE_VALIDATE_FORMATS: readonly ["auto", "cii", "ubl"];
-declare const LIVE_PARSE_FORMATS: readonly ["auto", "cii", "ubl"];
-declare const LIVE_CONVERT_SOURCE_FORMATS: readonly ["auto", "cii", "ubl", "zugferd", "facturx", "xrechnung", "peppol-bis"];
-declare const LIVE_CONVERT_TARGET_FORMATS: readonly ["cii", "ubl", "zugferd", "facturx", "xrechnung", "peppol-bis"];
-
-export { DEFAULT_BASE_URL as D, type GeneratePreset as G, LIVE_CONVERT_SOURCE_FORMATS as L, type PlainObject as P, type DocumentInput as a, LIVE_CONVERT_TARGET_FORMATS as b, LIVE_GENERATE_PRESETS as c, LIVE_GENERATE_STANDARDS as d, LIVE_PARSE_FORMATS as e, LIVE_PROFILES as f, LIVE_VALIDATE_FORMATS as g, compactQuery as h, decodeUtf8 as i, isPlainObject as j, mergeDeep as m, sniffContentType as s, toBytes as t };