@beliq/sdk 0.1.1 → 0.2.0

package/README.md

@@ -52,9 +52,16 @@ if (!result.valid) {
 Create an API key in the beliq dashboard under API Keys, then pass it to the client:
 
 ```ts
-new Beliq({ apiKey: 'blq_...' });                 // sends X-API-Key (default)
-new Beliq({ apiKey: 'blq_...', auth: 'bearer' });  // sends Authorization: Bearer
-new Beliq({ apiKey: 'blq_...', baseUrl: 'https://staging.beliq.eu' });
+new Beliq({ apiKey: 'blq_live_...' });                 // sends X-API-Key (default)
+new Beliq({ apiKey: 'blq_live_...', auth: 'bearer' });  // sends Authorization: Bearer
+new Beliq({ apiKey: 'blq_live_...', baseUrl: 'https://staging.beliq.eu' });
+```
+
+Keys are prefixed `blq_live_` (production, draws your plan quota) or `blq_test_` (sandbox, separate free allowance, watermarked output). `client.livemode` reports the mode from the key prefix before any request; generate and convert results also carry the authoritative `meta.livemode` from the response.
+
+```ts
+const beliq = new Beliq({ apiKey: process.env.BELIQ_API_KEY! });
+if (!beliq.livemode) console.warn('running against the sandbox');
 ```
 
 ## API
@@ -62,12 +69,35 @@ new Beliq({ apiKey: 'blq_...', baseUrl: 'https://staging.beliq.eu' });
 | Method | Endpoint | Input | Returns |
 |---|---|---|---|
 | `me()` | GET /v1/me | none | `AccountInfo` (no quota cost) |
-| `generate(input)` | POST /v1/generate | EN 16931 invoice object | `{ contentType, bytes, xml?, meta }` |
+| `generate(input)` | POST /v1/generate | EN 16931 invoice object | `{ contentType, bytes, xml?, sha256?, validationResult?, meta }` |
 | `validate(document, options?)` | POST /v1/validate | XML or PDF | `ValidationResult` |
 | `parse(document, options?)` | POST /v1/parse | XML or PDF | `ParseResult` |
 | `convert(document, options)` | POST /v1/convert | XML or PDF | `{ contentType, bytes, meta }` |
 
-`document` accepts a `string`, `Uint8Array`, `Buffer`, `ArrayBuffer`, or typed array. The content type is sniffed from the bytes (PDF vs XML) unless you pass `options.contentType`. `generate` and `convert` return raw document bytes plus the response-header metadata (`schematronVersion`, `pdfKind`, `sourceFormat`/`targetFormat`, `lostElements`, `conversionTools`); for an XML output, `generate` also decodes `xml`.
+`document` accepts a `string`, `Uint8Array`, `Buffer`, `ArrayBuffer`, or typed array. The content type is sniffed from the bytes (PDF vs XML) unless you pass `options.contentType`. `generate` and `convert` return raw document bytes plus the response-header metadata (`schematronVersion`, `pdfKind`, `sourceFormat`/`targetFormat`, `lostElements`, `conversionTools`, `livemode`); for an XML output, `generate` also decodes `xml`.
+
+### Verify-it-yourself seal
+
+Pass `seal: true` to `generate` to also get the document `sha256` and the full `validationResult`. Hashing the returned bytes reproduces the hash, so a recipient can check the document independently:
+
+```ts
+import { createHash } from 'node:crypto';
+
+const doc = await beliq.generate({ standard: 'xrechnung', invoice, seal: true });
+const ok = createHash('sha256').update(doc.bytes).digest('hex') === doc.sha256;
+console.log(doc.validationResult?.valid, doc.meta.rulesetSha256, ok);
+```
+
+### Curated option lists
+
+`LIVE_GENERATE_PRESETS` is the set of public generate targets beliq.eu itself offers, each mapping to the API `standard` (plus `profile`/`facturxProfile`) it needs. NLCIUS is a Peppol BIS profile and lives here rather than in `LIVE_GENERATE_STANDARDS`. Connectors build their dropdowns from these lists.
+
+```ts
+import { LIVE_GENERATE_PRESETS } from '@beliq/sdk';
+
+const nlcius = LIVE_GENERATE_PRESETS.find((p) => p.id === 'nlcius');
+await beliq.generate({ standard: nlcius!.standard, profile: nlcius!.profile, invoice });
+```
 
 Every option enum is typed from the OpenAPI spec, so wrong values fail at compile time. Errors throw `BeliqApiError` with a typed `.code`, HTTP `.status`, and any `.details`:
 

package/dist/{constants-bWOXCmJD.d.cts → constants-D3j_o7th.d.cts}

@@ -13,10 +13,28 @@ 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, LIVE_CONVERT_SOURCE_FORMATS as L, type PlainObject as P, type DocumentInput as a, LIVE_CONVERT_TARGET_FORMATS as b, LIVE_GENERATE_STANDARDS as c, LIVE_PARSE_FORMATS as d, LIVE_PROFILES as e, LIVE_VALIDATE_FORMATS as f, compactQuery as g, decodeUtf8 as h, isPlainObject as i, mergeDeep as m, sniffContentType as s, toBytes as t };
+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-bWOXCmJD.d.ts → constants-D3j_o7th.d.ts}

@@ -13,10 +13,28 @@ 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, LIVE_CONVERT_SOURCE_FORMATS as L, type PlainObject as P, type DocumentInput as a, LIVE_CONVERT_TARGET_FORMATS as b, LIVE_GENERATE_STANDARDS as c, LIVE_PARSE_FORMATS as d, LIVE_PROFILES as e, LIVE_VALIDATE_FORMATS as f, compactQuery as g, decodeUtf8 as h, isPlainObject as i, mergeDeep as m, sniffContentType as s, toBytes as t };
+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/helpers.cjs

@@ -23,6 +23,7 @@ __export(helpers_exports, {
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
   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,
@@ -111,7 +112,8 @@ function buildRequest(params) {
         path: "/v1/generate",
         jsonBody: merged,
         contentType: "application/json",
-        outputKind: "binary"
+        // JSON mode returns the seal envelope; binary mode returns the raw document body.
+        ...params.sealed ? { accept: "application/json", outputKind: "json" } : { outputKind: "binary" }
       };
     }
     case "validate": {
@@ -161,6 +163,13 @@ function buildRequest(params) {
 // src/constants.ts
 var DEFAULT_BASE_URL = "https://api.beliq.eu";
 var LIVE_GENERATE_STANDARDS = ["xrechnung", "zugferd", "facturx", "peppol-bis"];
+var LIVE_GENERATE_PRESETS = [
+  { id: "xrechnung", label: "XRechnung", standard: "xrechnung", output: "xml" },
+  { id: "factur-x", label: "Factur-X", standard: "facturx", output: "pdf", facturxProfile: "en16931" },
+  { id: "zugferd", label: "ZUGFeRD", standard: "zugferd", output: "pdf" },
+  { id: "peppol-bis", label: "Peppol BIS 3.0", standard: "peppol-bis", output: "xml" },
+  { id: "nlcius", label: "NLCIUS", standard: "peppol-bis", output: "xml", profile: "netherlands-nlcius" }
+];
 var LIVE_PROFILES = ["basicwl", "en16931", "extended", "extended-ctc-fr"];
 var LIVE_VALIDATE_FORMATS = ["auto", "cii", "ubl"];
 var LIVE_PARSE_FORMATS = ["auto", "cii", "ubl"];
@@ -186,6 +195,7 @@ var LIVE_CONVERT_TARGET_FORMATS = [
   DEFAULT_BASE_URL,
   LIVE_CONVERT_SOURCE_FORMATS,
   LIVE_CONVERT_TARGET_FORMATS,
+  LIVE_GENERATE_PRESETS,
   LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS,
   LIVE_PROFILES,

package/dist/helpers.d.cts

@@ -1,5 +1,5 @@
-import { P as PlainObject } from './constants-bWOXCmJD.cjs';
-export { D as DEFAULT_BASE_URL, a as DocumentInput, L as LIVE_CONVERT_SOURCE_FORMATS, b as LIVE_CONVERT_TARGET_FORMATS, c as LIVE_GENERATE_STANDARDS, d as LIVE_PARSE_FORMATS, e as LIVE_PROFILES, f as LIVE_VALIDATE_FORMATS, g as compactQuery, h as decodeUtf8, i as isPlainObject, m as mergeDeep, s as sniffContentType, t as toBytes } from './constants-bWOXCmJD.cjs';
+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';
 
 type Operation = 'me' | 'generate' | 'validate' | 'parse' | 'convert';
 /** 'json' => parse the `{ success, data }` envelope; 'binary' => return raw bytes. */
@@ -15,6 +15,8 @@ interface BuildParams {
     verify?: boolean;
     template?: string;
     pdfTemplateId?: string;
+    /** Request the JSON-mode seal (Accept: application/json) instead of the binary body. */
+    sealed?: boolean;
     rawBody?: Uint8Array;
     rawContentType?: string;
     validateFormat?: string;
@@ -37,6 +39,8 @@ interface BuiltRequest {
     rawBody?: Uint8Array;
     /** Request content type; absent for GET. */
     contentType?: string;
+    /** Accept header; set when the caller wants a JSON envelope from an otherwise-binary op. */
+    accept?: string;
     outputKind: OutputKind;
 }
 declare function buildRequest(params: BuildParams): BuiltRequest;

package/dist/helpers.d.ts

@@ -1,5 +1,5 @@
-import { P as PlainObject } from './constants-bWOXCmJD.js';
-export { D as DEFAULT_BASE_URL, a as DocumentInput, L as LIVE_CONVERT_SOURCE_FORMATS, b as LIVE_CONVERT_TARGET_FORMATS, c as LIVE_GENERATE_STANDARDS, d as LIVE_PARSE_FORMATS, e as LIVE_PROFILES, f as LIVE_VALIDATE_FORMATS, g as compactQuery, h as decodeUtf8, i as isPlainObject, m as mergeDeep, s as sniffContentType, t as toBytes } from './constants-bWOXCmJD.js';
+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';
 
 type Operation = 'me' | 'generate' | 'validate' | 'parse' | 'convert';
 /** 'json' => parse the `{ success, data }` envelope; 'binary' => return raw bytes. */
@@ -15,6 +15,8 @@ interface BuildParams {
     verify?: boolean;
     template?: string;
     pdfTemplateId?: string;
+    /** Request the JSON-mode seal (Accept: application/json) instead of the binary body. */
+    sealed?: boolean;
     rawBody?: Uint8Array;
     rawContentType?: string;
     validateFormat?: string;
@@ -37,6 +39,8 @@ interface BuiltRequest {
     rawBody?: Uint8Array;
     /** Request content type; absent for GET. */
     contentType?: string;
+    /** Accept header; set when the caller wants a JSON envelope from an otherwise-binary op. */
+    accept?: string;
     outputKind: OutputKind;
 }
 declare function buildRequest(params: BuildParams): BuiltRequest;

package/dist/helpers.js

@@ -72,7 +72,8 @@ function buildRequest(params) {
         path: "/v1/generate",
         jsonBody: merged,
         contentType: "application/json",
-        outputKind: "binary"
+        // JSON mode returns the seal envelope; binary mode returns the raw document body.
+        ...params.sealed ? { accept: "application/json", outputKind: "json" } : { outputKind: "binary" }
       };
     }
     case "validate": {
@@ -122,6 +123,13 @@ function buildRequest(params) {
 // src/constants.ts
 var DEFAULT_BASE_URL = "https://api.beliq.eu";
 var LIVE_GENERATE_STANDARDS = ["xrechnung", "zugferd", "facturx", "peppol-bis"];
+var LIVE_GENERATE_PRESETS = [
+  { id: "xrechnung", label: "XRechnung", standard: "xrechnung", output: "xml" },
+  { id: "factur-x", label: "Factur-X", standard: "facturx", output: "pdf", facturxProfile: "en16931" },
+  { id: "zugferd", label: "ZUGFeRD", standard: "zugferd", output: "pdf" },
+  { id: "peppol-bis", label: "Peppol BIS 3.0", standard: "peppol-bis", output: "xml" },
+  { id: "nlcius", label: "NLCIUS", standard: "peppol-bis", output: "xml", profile: "netherlands-nlcius" }
+];
 var LIVE_PROFILES = ["basicwl", "en16931", "extended", "extended-ctc-fr"];
 var LIVE_VALIDATE_FORMATS = ["auto", "cii", "ubl"];
 var LIVE_PARSE_FORMATS = ["auto", "cii", "ubl"];
@@ -146,6 +154,7 @@ export {
   DEFAULT_BASE_URL,
   LIVE_CONVERT_SOURCE_FORMATS,
   LIVE_CONVERT_TARGET_FORMATS,
+  LIVE_GENERATE_PRESETS,
   LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS,
   LIVE_PROFILES,

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
   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,
@@ -68,6 +69,18 @@ function toBytes(input) {
 function decodeUtf8(bytes) {
   return new TextDecoder("utf-8").decode(bytes);
 }
+function decodeBase64(input) {
+  const b64 = input.replace(/-/g, "+").replace(/_/g, "/");
+  if (typeof atob === "function") {
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+    return out;
+  }
+  const maybeBuffer = globalThis.Buffer;
+  if (maybeBuffer) return new Uint8Array(maybeBuffer.from(b64, "base64"));
+  throw new Error("beliq: no base64 decoder available in this runtime");
+}
 var PDF_MAGIC = [37, 80, 68, 70, 45];
 function sniffContentType(bytes) {
   const isPdf = bytes.length >= PDF_MAGIC.length && PDF_MAGIC.every((b, i) => bytes[i] === b);
@@ -106,7 +119,8 @@ function buildRequest(params) {
         path: "/v1/generate",
         jsonBody: merged,
         contentType: "application/json",
-        outputKind: "binary"
+        // JSON mode returns the seal envelope; binary mode returns the raw document body.
+        ...params.sealed ? { accept: "application/json", outputKind: "json" } : { outputKind: "binary" }
       };
     }
     case "validate": {
@@ -191,6 +205,13 @@ function errorFromResponse(status, bytes) {
 // src/constants.ts
 var DEFAULT_BASE_URL = "https://api.beliq.eu";
 var LIVE_GENERATE_STANDARDS = ["xrechnung", "zugferd", "facturx", "peppol-bis"];
+var LIVE_GENERATE_PRESETS = [
+  { id: "xrechnung", label: "XRechnung", standard: "xrechnung", output: "xml" },
+  { id: "factur-x", label: "Factur-X", standard: "facturx", output: "pdf", facturxProfile: "en16931" },
+  { id: "zugferd", label: "ZUGFeRD", standard: "zugferd", output: "pdf" },
+  { id: "peppol-bis", label: "Peppol BIS 3.0", standard: "peppol-bis", output: "xml" },
+  { id: "nlcius", label: "NLCIUS", standard: "peppol-bis", output: "xml", profile: "netherlands-nlcius" }
+];
 var LIVE_PROFILES = ["basicwl", "en16931", "extended", "extended-ctc-fr"];
 var LIVE_VALIDATE_FORMATS = ["auto", "cii", "ubl"];
 var LIVE_PARSE_FORMATS = ["auto", "cii", "ubl"];
@@ -229,6 +250,7 @@ function buildUrl(baseUrl, path, query) {
 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,
@@ -241,11 +263,31 @@ async function send(config, req) {
 }
 
 // src/client.ts
+var TEST_KEY_PREFIX = "blq_test_";
+function livemodeHeader(headers) {
+  const raw = headers.get("x-beliq-livemode");
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  return void 0;
+}
+function parseRulesetArtifacts(headers) {
+  const raw = headers.get("x-ruleset-artifacts");
+  if (!raw) return void 0;
+  try {
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function generateMeta(headers) {
   return {
     schematronVersion: headers.get("x-schematron-version") ?? void 0,
     pdfKind: headers.get("x-pdf-kind") ?? void 0,
-    outputEnvelope: headers.get("x-output-envelope") ?? void 0
+    outputEnvelope: headers.get("x-output-envelope") ?? void 0,
+    rulesetSha256: headers.get("x-ruleset-sha256") ?? void 0,
+    rulesetArtifacts: parseRulesetArtifacts(headers),
+    livemode: livemodeHeader(headers)
   };
 }
 function convertMeta(headers) {
@@ -265,17 +307,25 @@ function convertMeta(headers) {
     profileDetected: headers.get("x-profile-detected") ?? void 0,
     lostElementsCount: countRaw != null ? Number(countRaw) : void 0,
     lostElements,
-    conversionTools: headers.get("x-conversion-tools") ?? void 0
+    conversionTools: headers.get("x-conversion-tools") ?? void 0,
+    livemode: livemodeHeader(headers)
   };
 }
 var Beliq = class {
   #config;
+  /**
+   * True for a live key, false for a blq_test_ sandbox key, derived from the key
+   * prefix (the same rule the server applies). Available before any request; the
+   * per-response x-beliq-livemode header is surfaced on generate/convert meta.
+   */
+  livemode;
   constructor(options) {
     if (!options?.apiKey) throw new Error("beliq: apiKey is required");
     const fetchImpl = options.fetch ?? globalThis.fetch;
     if (typeof fetchImpl !== "function") {
       throw new Error("beliq: no global fetch available; pass options.fetch");
     }
+    this.livemode = !options.apiKey.startsWith(TEST_KEY_PREFIX);
     this.#config = {
       apiKey: options.apiKey,
       baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ""),
@@ -289,14 +339,37 @@ var Beliq = class {
   }
   /** Generate a compliant e-invoice from an EN 16931 object. */
   async generate(input) {
-    const res = await send(this.#config, buildRequest({ operation: "generate", ...input }));
+    const res = await send(
+      this.#config,
+      buildRequest({ operation: "generate", ...input, sealed: input.seal })
+    );
+    const meta = generateMeta(res.headers);
+    if (input.seal) {
+      const envelope = parseEnvelope(res.bytes);
+      if (envelope?.success === false) throw errorFromResponse(res.status, res.bytes);
+      const data = envelope?.data;
+      if (!data || data.output === void 0) {
+        throw new BeliqApiError("beliq: seal response was not a JSON envelope", {
+          status: res.status
+        });
+      }
+      const bytes = decodeBase64(data.output);
+      const contentType2 = data.contentType ?? "application/octet-stream";
+      return {
+        contentType: contentType2,
+        bytes,
+        xml: contentType2.includes("xml") ? decodeUtf8(bytes) : void 0,
+        sha256: data.sha256,
+        validationResult: data.validationResult,
+        meta
+      };
+    }
     const contentType = res.headers.get("content-type") ?? "application/octet-stream";
-    const isXml = contentType.includes("xml");
     return {
       contentType,
       bytes: res.bytes,
-      xml: isXml ? decodeUtf8(res.bytes) : void 0,
-      meta: generateMeta(res.headers)
+      xml: contentType.includes("xml") ? decodeUtf8(res.bytes) : void 0,
+      meta
     };
   }
   /** Validate a document against authority-pinned rules. */
@@ -360,6 +433,7 @@ var Beliq = class {
   DEFAULT_BASE_URL,
   LIVE_CONVERT_SOURCE_FORMATS,
   LIVE_CONVERT_TARGET_FORMATS,
+  LIVE_GENERATE_PRESETS,
   LIVE_GENERATE_STANDARDS,
   LIVE_PARSE_FORMATS,
   LIVE_PROFILES,