@beliq/sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -34,6 +34,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);
@@ -72,7 +84,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": {
@@ -157,6 +170,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"];
@@ -195,6 +215,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,
@@ -207,11 +228,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) {
@@ -231,17 +272,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(/\/+$/, ""),
@@ -255,14 +304,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. */
@@ -325,6 +397,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beliq/sdk",
-  "version": "0.1.0",
+  "version": "0.2.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",
@@ -72,6 +72,7 @@
     "sync:spec": "node scripts/sync-spec.mjs",
     "gen:types": "node scripts/gen-types.mjs",
     "openapi:check": "node scripts/gen-types.mjs --check",
+    "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"