@beliq/sdk 0.2.0 → 0.3.0

package/README.md

@@ -64,6 +64,36 @@ const beliq = new Beliq({ apiKey: process.env.BELIQ_API_KEY! });
 if (!beliq.livemode) console.warn('running against the sandbox');
 ```
 
+## Timeouts and retries
+
+The client retries transient failures for you, so you do not have to reimplement
+backoff around it.
+
+```ts
+new Beliq({
+  apiKey: 'blq_live_...',
+  timeoutMs: 90_000,  // per-attempt deadline (default)
+  maxRetries: 3,      // extra attempts after the first (default)
+});
+```
+
+Both defaults are exported as `DEFAULT_TIMEOUT_MS` and `DEFAULT_MAX_RETRIES`, so
+you can derive from them instead of repeating the numbers.
+
+Only `429`, `502` and `503` are retried, honouring the server's `Retry-After`
+with jitter. beliq refunds the document's quota unit on a `503`, so a retry never
+costs you a second document.
+
+`504` and this client's own timeout are deliberately **not** retried: both mean
+the work may still be running on beliq's side, so retrying risks producing a
+second document rather than recovering the first.
+
+The default deadline is generous because beliq runs the full Schematron rule set
+over each document, and a generate or validate can legitimately take tens of
+seconds. If you lower it, keep it above the latency you actually see: a deadline
+shorter than the server's own turns completed work into an unknown outcome. Set
+`timeoutMs: 0` to disable it, and `maxRetries: 0` to handle retrying yourself.
+
 ## API
 
 | Method | Endpoint | Input | Returns |

package/dist/constants-BZuNzqbV.d.cts

@@ -0,0 +1,85 @@
+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";
+/**
+ * Per-attempt deadline. Sits above the API's own worst case so the server is
+ * always the one to answer: a client that gives up first abandons work that is
+ * still running, and cannot tell whether the document was produced.
+ */
+declare const DEFAULT_TIMEOUT_MS = 90000;
+/** Extra attempts after the first, for 429 / 502 / 503 only. */
+declare const DEFAULT_MAX_RETRIES = 3;
+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[];
+/**
+ * The Factur-X granularity values offered publicly. Kept as the flat list the
+ * hybrid-PDF family shares; anything choosing a profile for a specific standard
+ * wants LIVE_PROFILES_BY_STANDARD instead, which is what the API enforces.
+ */
+declare const LIVE_PROFILES: readonly ["basicwl", "en16931", "extended", "extended-ctc-fr"];
+/**
+ * Which profiles each standard accepts, publicly-offered values only.
+ *
+ * `profile` is not a free enum: the engine pins it per standard and answers a
+ * pair outside the table with `422 PROFILE_STANDARD_MISMATCH`
+ * (beliq-engine `app/routes/generate.py`, ALLOWED_PROFILES_FOR_STANDARD). A
+ * surface that offers one flat profile list therefore offers values that cannot
+ * succeed: none of the Factur-X granularity values is legal for `xrechnung` or
+ * `peppol-bis`, and `extended-ctc-fr` is the AFNOR XP Z12-012 France CTC overlay
+ * with no ZUGFeRD-branded counterpart.
+ *
+ * Narrower than the engine's own table in two places, both deliberate: the
+ * `minimum` and `basic` Factur-X profiles are engine-supported but withheld
+ * (FNFE-MPE source gating, mirroring beliq-types SUPPORTED_FACTURX_PROFILE_IDS),
+ * and the standards outside LIVE_GENERATE_STANDARDS are absent entirely.
+ *
+ * `scripts/check-profile-drift.mjs` compares this against the engine's table.
+ */
+declare const LIVE_PROFILES_BY_STANDARD: {
+    readonly xrechnung: readonly ["xrechnung"];
+    readonly 'peppol-bis': readonly ["peppol", "romania-ro-cius", "netherlands-nlcius"];
+    readonly zugferd: readonly ["basicwl", "en16931", "extended"];
+    readonly facturx: readonly ["basicwl", "en16931", "extended", "extended-ctc-fr"];
+};
+/** The profiles a caller may choose for `standard`; empty for an unknown standard. */
+declare function profilesForStandard(standard: string): readonly string[];
+/**
+ * Whether `profile` is legal for `standard`. An unknown standard passes: the API
+ * is the authority on values this list does not carry, and a client-side guess
+ * would refuse a request the server would have accepted.
+ */
+declare function isProfileAllowedForStandard(standard: string, profile: string): boolean;
+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_PROFILES_BY_STANDARD as g, LIVE_VALIDATE_FORMATS as h, compactQuery as i, decodeUtf8 as j, isPlainObject as k, isProfileAllowedForStandard as l, mergeDeep as m, DEFAULT_MAX_RETRIES as n, DEFAULT_TIMEOUT_MS as o, profilesForStandard as p, sniffContentType as s, toBytes as t };

package/dist/constants-BZuNzqbV.d.ts

@@ -0,0 +1,85 @@
+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";
+/**
+ * Per-attempt deadline. Sits above the API's own worst case so the server is
+ * always the one to answer: a client that gives up first abandons work that is
+ * still running, and cannot tell whether the document was produced.
+ */
+declare const DEFAULT_TIMEOUT_MS = 90000;
+/** Extra attempts after the first, for 429 / 502 / 503 only. */
+declare const DEFAULT_MAX_RETRIES = 3;
+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[];
+/**
+ * The Factur-X granularity values offered publicly. Kept as the flat list the
+ * hybrid-PDF family shares; anything choosing a profile for a specific standard
+ * wants LIVE_PROFILES_BY_STANDARD instead, which is what the API enforces.
+ */
+declare const LIVE_PROFILES: readonly ["basicwl", "en16931", "extended", "extended-ctc-fr"];
+/**
+ * Which profiles each standard accepts, publicly-offered values only.
+ *
+ * `profile` is not a free enum: the engine pins it per standard and answers a
+ * pair outside the table with `422 PROFILE_STANDARD_MISMATCH`
+ * (beliq-engine `app/routes/generate.py`, ALLOWED_PROFILES_FOR_STANDARD). A
+ * surface that offers one flat profile list therefore offers values that cannot
+ * succeed: none of the Factur-X granularity values is legal for `xrechnung` or
+ * `peppol-bis`, and `extended-ctc-fr` is the AFNOR XP Z12-012 France CTC overlay
+ * with no ZUGFeRD-branded counterpart.
+ *
+ * Narrower than the engine's own table in two places, both deliberate: the
+ * `minimum` and `basic` Factur-X profiles are engine-supported but withheld
+ * (FNFE-MPE source gating, mirroring beliq-types SUPPORTED_FACTURX_PROFILE_IDS),
+ * and the standards outside LIVE_GENERATE_STANDARDS are absent entirely.
+ *
+ * `scripts/check-profile-drift.mjs` compares this against the engine's table.
+ */
+declare const LIVE_PROFILES_BY_STANDARD: {
+    readonly xrechnung: readonly ["xrechnung"];
+    readonly 'peppol-bis': readonly ["peppol", "romania-ro-cius", "netherlands-nlcius"];
+    readonly zugferd: readonly ["basicwl", "en16931", "extended"];
+    readonly facturx: readonly ["basicwl", "en16931", "extended", "extended-ctc-fr"];
+};
+/** The profiles a caller may choose for `standard`; empty for an unknown standard. */
+declare function profilesForStandard(standard: string): readonly string[];
+/**
+ * Whether `profile` is legal for `standard`. An unknown standard passes: the API
+ * is the authority on values this list does not carry, and a client-side guess
+ * would refuse a request the server would have accepted.
+ */
+declare function isProfileAllowedForStandard(standard: string, profile: string): boolean;
+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_PROFILES_BY_STANDARD as g, LIVE_VALIDATE_FORMATS as h, compactQuery as i, decodeUtf8 as j, isPlainObject as k, isProfileAllowedForStandard as l, mergeDeep as m, DEFAULT_MAX_RETRIES as n, DEFAULT_TIMEOUT_MS as o, profilesForStandard as p, sniffContentType as s, toBytes as t };

package/dist/helpers.cjs

@@ -27,12 +27,15 @@ __export(helpers_exports, {
   LIVE_GENERATE_STANDARDS: () => LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS: () => LIVE_PARSE_FORMATS,
   LIVE_PROFILES: () => LIVE_PROFILES,
+  LIVE_PROFILES_BY_STANDARD: () => LIVE_PROFILES_BY_STANDARD,
   LIVE_VALIDATE_FORMATS: () => LIVE_VALIDATE_FORMATS,
   buildRequest: () => buildRequest,
   compactQuery: () => compactQuery,
   decodeUtf8: () => decodeUtf8,
   isPlainObject: () => isPlainObject,
+  isProfileAllowedForStandard: () => isProfileAllowedForStandard,
   mergeDeep: () => mergeDeep,
+  profilesForStandard: () => profilesForStandard,
   sniffContentType: () => sniffContentType,
   toBytes: () => toBytes
 });
@@ -171,6 +174,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,12 +215,15 @@ var LIVE_CONVERT_TARGET_FORMATS = [
   LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS,
   LIVE_PROFILES,
+  LIVE_PROFILES_BY_STANDARD,
   LIVE_VALIDATE_FORMATS,
   buildRequest,
   compactQuery,
   decodeUtf8,
   isPlainObject,
+  isProfileAllowedForStandard,
   mergeDeep,
+  profilesForStandard,
   sniffContentType,
   toBytes
 });

package/dist/helpers.d.cts

@@ -1,5 +1,5 @@
-import { P as PlainObject } from './constants-D3j_o7th.cjs';
-export { D as DEFAULT_BASE_URL, a as DocumentInput, G as GeneratePreset, L as LIVE_CONVERT_SOURCE_FORMATS, b as LIVE_CONVERT_TARGET_FORMATS, c as LIVE_GENERATE_PRESETS, d as LIVE_GENERATE_STANDARDS, e as LIVE_PARSE_FORMATS, f as LIVE_PROFILES, g as LIVE_VALIDATE_FORMATS, h as compactQuery, i as decodeUtf8, j as isPlainObject, m as mergeDeep, s as sniffContentType, t as toBytes } from './constants-D3j_o7th.cjs';
+import { P as PlainObject } from './constants-BZuNzqbV.cjs';
+export { D as DEFAULT_BASE_URL, a as DocumentInput, G as GeneratePreset, L as LIVE_CONVERT_SOURCE_FORMATS, b as LIVE_CONVERT_TARGET_FORMATS, c as LIVE_GENERATE_PRESETS, d as LIVE_GENERATE_STANDARDS, e as LIVE_PARSE_FORMATS, f as LIVE_PROFILES, g as LIVE_PROFILES_BY_STANDARD, h as LIVE_VALIDATE_FORMATS, i as compactQuery, j as decodeUtf8, k as isPlainObject, l as isProfileAllowedForStandard, m as mergeDeep, p as profilesForStandard, s as sniffContentType, t as toBytes } from './constants-BZuNzqbV.cjs';
 
 type Operation = 'me' | 'generate' | 'validate' | 'parse' | 'convert';
 /** 'json' => parse the `{ success, data }` envelope; 'binary' => return raw bytes. */

package/dist/helpers.d.ts

@@ -1,5 +1,5 @@
-import { P as PlainObject } from './constants-D3j_o7th.js';
-export { D as DEFAULT_BASE_URL, a as DocumentInput, G as GeneratePreset, L as LIVE_CONVERT_SOURCE_FORMATS, b as LIVE_CONVERT_TARGET_FORMATS, c as LIVE_GENERATE_PRESETS, d as LIVE_GENERATE_STANDARDS, e as LIVE_PARSE_FORMATS, f as LIVE_PROFILES, g as LIVE_VALIDATE_FORMATS, h as compactQuery, i as decodeUtf8, j as isPlainObject, m as mergeDeep, s as sniffContentType, t as toBytes } from './constants-D3j_o7th.js';
+import { P as PlainObject } from './constants-BZuNzqbV.js';
+export { D as DEFAULT_BASE_URL, a as DocumentInput, G as GeneratePreset, L as LIVE_CONVERT_SOURCE_FORMATS, b as LIVE_CONVERT_TARGET_FORMATS, c as LIVE_GENERATE_PRESETS, d as LIVE_GENERATE_STANDARDS, e as LIVE_PARSE_FORMATS, f as LIVE_PROFILES, g as LIVE_PROFILES_BY_STANDARD, h as LIVE_VALIDATE_FORMATS, i as compactQuery, j as decodeUtf8, k as isPlainObject, l as isProfileAllowedForStandard, m as mergeDeep, p as profilesForStandard, s as sniffContentType, t as toBytes } from './constants-BZuNzqbV.js';
 
 type Operation = 'me' | 'generate' | 'validate' | 'parse' | 'convert';
 /** 'json' => parse the `{ success, data }` envelope; 'binary' => return raw bytes. */

package/dist/helpers.js

@@ -131,6 +131,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 = [
@@ -158,12 +171,15 @@ export {
   LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS,
   LIVE_PROFILES,
+  LIVE_PROFILES_BY_STANDARD,
   LIVE_VALIDATE_FORMATS,
   buildRequest,
   compactQuery,
   decodeUtf8,
   isPlainObject,
+  isProfileAllowedForStandard,
   mergeDeep,
+  profilesForStandard,
   sniffContentType,
   toBytes
 };

package/dist/index.cjs

@@ -23,13 +23,18 @@ __export(index_exports, {
   Beliq: () => Beliq,
   BeliqApiError: () => BeliqApiError,
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  DEFAULT_MAX_RETRIES: () => DEFAULT_MAX_RETRIES,
+  DEFAULT_TIMEOUT_MS: () => DEFAULT_TIMEOUT_MS,
   LIVE_CONVERT_SOURCE_FORMATS: () => LIVE_CONVERT_SOURCE_FORMATS,
   LIVE_CONVERT_TARGET_FORMATS: () => LIVE_CONVERT_TARGET_FORMATS,
   LIVE_GENERATE_PRESETS: () => LIVE_GENERATE_PRESETS,
   LIVE_GENERATE_STANDARDS: () => LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS: () => LIVE_PARSE_FORMATS,
   LIVE_PROFILES: () => LIVE_PROFILES,
-  LIVE_VALIDATE_FORMATS: () => LIVE_VALIDATE_FORMATS
+  LIVE_PROFILES_BY_STANDARD: () => LIVE_PROFILES_BY_STANDARD,
+  LIVE_VALIDATE_FORMATS: () => LIVE_VALIDATE_FORMATS,
+  isProfileAllowedForStandard: () => isProfileAllowedForStandard,
+  profilesForStandard: () => profilesForStandard
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -204,6 +209,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" },
@@ -213,6 +220,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 = [
@@ -234,6 +254,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 };
 }
@@ -247,19 +270,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
@@ -330,7 +392,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. */
@@ -431,11 +495,16 @@ var Beliq = class {
   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
 });