@fin.cx/einvoice 6.0.0 → 6.1.1

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@fin.cx/einvoice',
-    version: '6.0.0',
+    version: '6.1.1',
     description: 'A TypeScript module for creating, manipulating, and embedding XML data within PDF files specifically tailored for electronic invoice (einvoice) packages.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDJKQUEySjtDQUN6SyxDQUFBIn0=

package/dist_ts/plugins.browser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Browser-safe plugin exports.
+ *
+ * The public EInvoice API supports in-memory XML creation/export in browser
+ * bundles. File-path based helpers remain Node-only and throw when called in a
+ * browser environment.
+ */
+import { DOMParser, XMLSerializer, xmldom } from './vendor/xmldom.js';
+import * as xpath from 'xpath';
+import { pako } from './vendor/pako.js';
+import { business, finance, general } from '@tsclass/tsclass';
+declare const fs: typeof import("fs/promises");
+declare const path: typeof import("path");
+declare const crypto: typeof import("crypto");
+export { fs, path, crypto, DOMParser, XMLSerializer, xmldom, xpath, pako, business, finance, general, };

package/dist_ts/plugins.browser.js

@@ -0,0 +1,33 @@
+/**
+ * Browser-safe plugin exports.
+ *
+ * The public EInvoice API supports in-memory XML creation/export in browser
+ * bundles. File-path based helpers remain Node-only and throw when called in a
+ * browser environment.
+ */
+import { DOMParser, XMLSerializer, xmldom } from './vendor/xmldom.js';
+import * as xpath from 'xpath';
+import { pako } from './vendor/pako.js';
+import { business, finance, general } from '@tsclass/tsclass';
+const nodeOnly = (apiName) => {
+    throw new Error(`${apiName} is only available in Node.js. Use the in-memory XML APIs in browser bundles.`);
+};
+const fs = {
+    readFile: async () => nodeOnly('fs.readFile'),
+    writeFile: async () => nodeOnly('fs.writeFile'),
+};
+const path = {
+    basename: (filePath) => filePath.split(/[\\/]/).pop() || filePath,
+};
+const crypto = {
+    createHash: () => ({
+        update() {
+            return this;
+        },
+        digest() {
+            return nodeOnly('crypto.createHash');
+        },
+    }),
+};
+export { fs, path, crypto, DOMParser, XMLSerializer, xmldom, xpath, pako, business, finance, general, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5icm93c2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvcGx1Z2lucy5icm93c2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7R0FNRztBQUVILE9BQU8sRUFBRSxTQUFTLEVBQUUsYUFBYSxFQUFFLE1BQU0sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ3RFLE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBQy9CLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN4QyxPQUFPLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUU5RCxNQUFNLFFBQVEsR0FBRyxDQUFDLE9BQWUsRUFBUyxFQUFFO0lBQzFDLE1BQU0sSUFBSSxLQUFLLENBQUMsR0FBRyxPQUFPLCtFQUErRSxDQUFDLENBQUM7QUFDN0csQ0FBQyxDQUFDO0FBRUYsTUFBTSxFQUFFLEdBQUc7SUFDVCxRQUFRLEVBQUUsS0FBSyxJQUFJLEVBQUUsQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDO0lBQzdDLFNBQVMsRUFBRSxLQUFLLElBQUksRUFBRSxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQUM7Q0FDTCxDQUFDO0FBRTdDLE1BQU0sSUFBSSxHQUFHO0lBQ1gsUUFBUSxFQUFFLENBQUMsUUFBZ0IsRUFBRSxFQUFFLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxHQUFHLEVBQUUsSUFBSSxRQUFRO0NBQ3RDLENBQUM7QUFFdEMsTUFBTSxNQUFNLEdBQUc7SUFDYixVQUFVLEVBQUUsR0FBRyxFQUFFLENBQUMsQ0FBQztRQUNqQixNQUFNO1lBQ0osT0FBTyxJQUFJLENBQUM7UUFDZCxDQUFDO1FBQ0QsTUFBTTtZQUNKLE9BQU8sUUFBUSxDQUFDLG1CQUFtQixDQUFDLENBQUM7UUFDdkMsQ0FBQztLQUNGLENBQUM7Q0FDbUMsQ0FBQztBQUV4QyxPQUFPLEVBQ0wsRUFBRSxFQUNGLElBQUksRUFDSixNQUFNLEVBQ04sU0FBUyxFQUNULGFBQWEsRUFDYixNQUFNLEVBQ04sS0FBSyxFQUNMLElBQUksRUFDSixRQUFRLEVBQ1IsT0FBTyxFQUNQLE9BQU8sR0FDUixDQUFDIn0=

package/dist_ts/vendor/pdflib.browser.d.ts

@@ -0,0 +1,2 @@
+export type TPdfLibModule = typeof import('pdf-lib');
+export declare const loadPdfLib: () => Promise<TPdfLibModule>;

package/dist_ts/vendor/pdflib.browser.js

@@ -0,0 +1,6 @@
+let cachedPdfLib;
+export const loadPdfLib = async () => {
+    cachedPdfLib ||= import('pdf-lib');
+    return cachedPdfLib;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGRmbGliLmJyb3dzZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy92ZW5kb3IvcGRmbGliLmJyb3dzZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsSUFBSSxZQUFnRCxDQUFDO0FBRXJELE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRyxLQUFLLElBQTRCLEVBQUU7SUFDM0QsWUFBWSxLQUFLLE1BQU0sQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUNuQyxPQUFPLFlBQVksQ0FBQztBQUN0QixDQUFDLENBQUMifQ==

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@fin.cx/einvoice",
-  "version": "6.0.0",
+  "version": "6.1.1",
   "private": false,
   "description": "A TypeScript module for creating, manipulating, and embedding XML data within PDF files specifically tailored for electronic invoice (einvoice) packages.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
+  "browser": {
+    "./dist_ts/plugins.js": "./dist_ts/plugins.browser.js",
+    "./dist_ts/vendor/pdflib.js": "./dist_ts/vendor/pdflib.browser.js"
+  },
   "type": "module",
   "author": "Task Venture Capital GmbH",
   "license": "MIT",

package/readme.md

@@ -58,6 +58,12 @@ if (!validation.valid) {
 const xrechnungXml = await invoice.exportXml('xrechnung');
 ```
 
+## Browser Bundles
+
+`@fin.cx/einvoice` provides a browser replacement for its internal Node plugin module. Browser bundlers can use the published package entry for in-memory XML workflows such as `createEInvoice()`, `EInvoice.fromXml()`, `invoice.exportXml(...)`, and `validateXml(xml)` without resolving Node built-ins like `fs`, `path`, or `crypto`.
+
+File-path and PDF file helpers remain Node-only. In browser bundles, use XML strings, `ArrayBuffer` or `Uint8Array` data you already loaded through browser APIs, and browser storage APIs for persistence instead of helpers such as `EInvoice.fromFile(...)` or `invoice.saveToFile(...)`.
+
 ## What it can do
 
 ### Load and inspect invoices

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@fin.cx/einvoice',
-  version: '6.0.0',
+  version: '6.1.1',
   description: 'A TypeScript module for creating, manipulating, and embedding XML data within PDF files specifically tailored for electronic invoice (einvoice) packages.'
 }

package/ts/plugins.browser.ts

@@ -0,0 +1,50 @@
+/**
+ * Browser-safe plugin exports.
+ *
+ * The public EInvoice API supports in-memory XML creation/export in browser
+ * bundles. File-path based helpers remain Node-only and throw when called in a
+ * browser environment.
+ */
+
+import { DOMParser, XMLSerializer, xmldom } from './vendor/xmldom.js';
+import * as xpath from 'xpath';
+import { pako } from './vendor/pako.js';
+import { business, finance, general } from '@tsclass/tsclass';
+
+const nodeOnly = (apiName: string): never => {
+  throw new Error(`${apiName} is only available in Node.js. Use the in-memory XML APIs in browser bundles.`);
+};
+
+const fs = {
+  readFile: async () => nodeOnly('fs.readFile'),
+  writeFile: async () => nodeOnly('fs.writeFile'),
+} as unknown as typeof import('fs/promises');
+
+const path = {
+  basename: (filePath: string) => filePath.split(/[\\/]/).pop() || filePath,
+} as unknown as typeof import('path');
+
+const crypto = {
+  createHash: () => ({
+    update() {
+      return this;
+    },
+    digest() {
+      return nodeOnly('crypto.createHash');
+    },
+  }),
+} as unknown as typeof import('crypto');
+
+export {
+  fs,
+  path,
+  crypto,
+  DOMParser,
+  XMLSerializer,
+  xmldom,
+  xpath,
+  pako,
+  business,
+  finance,
+  general,
+};

package/ts/vendor/pdflib.browser.ts

@@ -0,0 +1,8 @@
+export type TPdfLibModule = typeof import('pdf-lib');
+
+let cachedPdfLib: Promise<TPdfLibModule> | undefined;
+
+export const loadPdfLib = async (): Promise<TPdfLibModule> => {
+  cachedPdfLib ||= import('pdf-lib');
+  return cachedPdfLib;
+};