ksef-client-ts 0.9.0 → 0.10.0

package/dist/node.js

@@ -0,0 +1,260 @@
+// src/offline/file-storage.ts
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+
+// src/offline/storage.ts
+function matchesFilter(invoice, filter) {
+  if (filter.status !== void 0) {
+    const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+    if (!statuses.includes(invoice.status)) return false;
+  }
+  if (filter.mode !== void 0 && invoice.mode !== filter.mode) return false;
+  if (filter.sellerNip !== void 0 && invoice.sellerNip !== filter.sellerNip) return false;
+  if (filter.expiringBefore !== void 0) {
+    const cutoff = typeof filter.expiringBefore === "string" ? new Date(filter.expiringBefore).getTime() : filter.expiringBefore.getTime();
+    if (new Date(invoice.submitBy).getTime() >= cutoff) return false;
+  }
+  return true;
+}
+
+// src/offline/file-storage.ts
+function resolveDir(dir) {
+  if (dir === "~" || dir.startsWith("~/")) {
+    return path.join(os.homedir(), dir.slice(1));
+  }
+  return dir;
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function validateId(id) {
+  if (!UUID_RE.test(id)) {
+    throw new Error(`Invalid invoice ID: ${id}`);
+  }
+}
+var FileOfflineInvoiceStorage = class {
+  dir;
+  constructor(directory) {
+    this.dir = resolveDir(directory ?? "~/.ksef/offline");
+  }
+  async ensureDir() {
+    await fs.mkdir(this.dir, { recursive: true });
+  }
+  filePath(id) {
+    validateId(id);
+    return path.join(this.dir, `${id}.json`);
+  }
+  async save(invoice) {
+    await this.ensureDir();
+    const file = this.filePath(invoice.id);
+    const tmp = `${file}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(invoice, null, 2));
+    await fs.rename(tmp, file);
+  }
+  async get(id) {
+    const file = this.filePath(id);
+    try {
+      return JSON.parse(await fs.readFile(file, "utf-8"));
+    } catch (err) {
+      if (err instanceof Error && "code" in err && err.code === "ENOENT") {
+        return null;
+      }
+      console.warn(`Warning: Failed to read offline invoice ${id}: ${err instanceof Error ? err.message : String(err)}`);
+      return null;
+    }
+  }
+  async list(filter) {
+    let files;
+    try {
+      files = (await fs.readdir(this.dir)).filter((f) => f.endsWith(".json"));
+    } catch {
+      return [];
+    }
+    const results = [];
+    for (const file of files) {
+      try {
+        const data = JSON.parse(
+          await fs.readFile(path.join(this.dir, file), "utf-8")
+        );
+        if (!filter || matchesFilter(data, filter)) {
+          results.push(data);
+        }
+      } catch (err) {
+        console.warn(`Warning: Skipping corrupt offline invoice file ${file}: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+    return results;
+  }
+  /**
+   * Update invoice metadata (read-modify-write).
+   *
+   * Note: No file locking — concurrent updates to the same ID may cause
+   * lost writes. Acceptable for CLI (single process). Library consumers
+   * running parallel operations should use external locking.
+   */
+  async update(id, updates) {
+    const existing = await this.get(id);
+    if (!existing) throw new Error(`Offline invoice not found: ${id}`);
+    await this.save({ ...existing, ...updates });
+  }
+  async delete(id) {
+    const file = this.filePath(id);
+    try {
+      await fs.unlink(file);
+    } catch (e) {
+      if (e instanceof Error && "code" in e && e.code !== "ENOENT") throw e;
+    }
+  }
+};
+
+// src/validation/xsd-validator.ts
+import { createRequire } from "node:module";
+import * as fs2 from "node:fs";
+import * as path2 from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+var cachedPkgRoot = null;
+function locatePackageRoot() {
+  if (cachedPkgRoot !== null) return cachedPkgRoot;
+  let dir = path2.dirname(fileURLToPath(import.meta.url));
+  const root = path2.parse(dir).root;
+  while (dir !== root) {
+    const candidate = path2.join(dir, "docs", "schemas");
+    if (fs2.existsSync(candidate)) {
+      cachedPkgRoot = dir;
+      return dir;
+    }
+    dir = path2.dirname(dir);
+  }
+  throw new Error("Could not locate ksef-client-ts package root (docs/schemas not found).");
+}
+var XSD_RELATIVE = {
+  FA2: ["FA", "schemat_FA(2)_v1-0E.xsd"],
+  FA3: ["FA", "schemat_FA(3)_v1-0E.xsd"],
+  PEF: ["PEF", "Schemat_PEF(3)_v2-1.xsd"],
+  PEF_KOR: ["PEF", "Schemat_PEF_KOR(3)_v2-1.xsd"]
+};
+var FA_XSD_PATHS = {
+  get FA2() {
+    return resolveXsdFor("FA2");
+  },
+  get FA3() {
+    return resolveXsdFor("FA3");
+  }
+};
+var PEF_XSD_PATHS = {
+  get PEF() {
+    return resolveXsdFor("PEF");
+  },
+  get PEF_KOR() {
+    return resolveXsdFor("PEF_KOR");
+  }
+};
+function resolveXsdFor(schema) {
+  const rel = XSD_RELATIVE[schema];
+  if (!rel) throw new Error(`Unknown invoice schema: ${String(schema)}`);
+  return path2.join(locatePackageRoot(), "docs", "schemas", ...rel);
+}
+var requireModule = createRequire(import.meta.url);
+var libxmljs = null;
+var libxmljsLoadError = null;
+try {
+  libxmljs = requireModule("libxmljs2");
+} catch (err) {
+  const code = err?.code;
+  if (code === "MODULE_NOT_FOUND" || code === "ERR_MODULE_NOT_FOUND") {
+    libxmljs = null;
+  } else {
+    libxmljs = null;
+    libxmljsLoadError = err instanceof Error ? err : new Error(String(err));
+  }
+}
+var libxmljsAvailable = libxmljs !== null;
+var MISSING_LIBXMLJS_MESSAGE_PREFIX = "libxmljs2 is not installed";
+function isMissingLibxmljsError(err) {
+  return err instanceof Error && err.message.startsWith(MISSING_LIBXMLJS_MESSAGE_PREFIX);
+}
+var EXTERNAL_STRUKTURY_DANYCH_URL = /schemaLocation="http:\/\/crd\.gov\.pl\/xml\/schematy\/dziedzinowe\/mf\/2022\/01\/05\/eD\/DefinicjeTypy\/StrukturyDanych_v10-0E\.xsd"/;
+function rewriteSchemaLocations(xsdContent) {
+  if (!EXTERNAL_STRUKTURY_DANYCH_URL.test(xsdContent)) {
+    return xsdContent;
+  }
+  const bazoweStrukturyPath = path2.join(
+    locatePackageRoot(),
+    "docs",
+    "schemas",
+    "FA",
+    "bazowe",
+    "StrukturyDanych_v10-0E.xsd"
+  );
+  const bazoweStrukturyUrl = pathToFileURL(bazoweStrukturyPath).href;
+  const rewritten = xsdContent.replace(
+    EXTERNAL_STRUKTURY_DANYCH_URL,
+    `schemaLocation="${bazoweStrukturyUrl}"`
+  );
+  if (rewritten === xsdContent) {
+    throw new Error(
+      "FA XSD schemaLocation rewrite produced no replacement despite URL being present; regex likely out of sync with docs/schemas/FA/. Re-check after `yarn sync-schemas`."
+    );
+  }
+  return rewritten;
+}
+function validateAgainstXsd(xml, xsdPath) {
+  if (!libxmljs) {
+    const loadSuffix = libxmljsLoadError ? ` (load failed: ${libxmljsLoadError.message})` : "";
+    throw new Error(
+      `${MISSING_LIBXMLJS_MESSAGE_PREFIX}${loadSuffix}; cannot run XSD validation. Install it as an optional peer dependency (e.g. \`yarn add -O libxmljs2\` or \`npm i -O libxmljs2\`).`
+    );
+  }
+  const xsdDir = path2.dirname(xsdPath);
+  const rawXsd = fs2.readFileSync(xsdPath, "utf8");
+  const rewrittenXsd = rewriteSchemaLocations(rawXsd);
+  const baseUrl = pathToFileURL(xsdDir + path2.sep).href;
+  let schemaDoc;
+  try {
+    schemaDoc = libxmljs.parseXml(rewrittenXsd, { baseUrl });
+  } catch (err) {
+    return { valid: false, errors: [`XSD parse failed: ${err.message}`] };
+  }
+  let xmlDoc;
+  try {
+    xmlDoc = libxmljs.parseXml(xml);
+  } catch (err) {
+    return { valid: false, errors: [`XML parse failed: ${err.message}`] };
+  }
+  const valid = xmlDoc.validate(schemaDoc);
+  const errors = valid ? [] : xmlDoc.validationErrors.map((err) => err.message.trim());
+  return { valid, errors };
+}
+
+// src/workflows/hwm-storage.ts
+import * as fs3 from "node:fs/promises";
+var FileHwmStore = class {
+  constructor(filePath) {
+    this.filePath = filePath;
+  }
+  filePath;
+  async load() {
+    try {
+      const data = await fs3.readFile(this.filePath, "utf-8");
+      return JSON.parse(data);
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        return {};
+      }
+      throw err;
+    }
+  }
+  async save(points) {
+    await fs3.writeFile(this.filePath, JSON.stringify(points, null, 2), "utf-8");
+  }
+};
+export {
+  FA_XSD_PATHS,
+  FileHwmStore,
+  FileOfflineInvoiceStorage,
+  PEF_XSD_PATHS,
+  isMissingLibxmljsError,
+  libxmljsAvailable,
+  resolveXsdFor,
+  validateAgainstXsd
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/offline/file-storage.ts","../src/offline/storage.ts","../src/validation/xsd-validator.ts","../src/workflows/hwm-storage.ts"],"sourcesContent":["import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport * as os from 'node:os';\nimport type { OfflineInvoiceMetadata } from './types.js';\nimport { matchesFilter } from './storage.js';\nimport type { OfflineInvoiceFilter, OfflineInvoiceStorage, OfflineInvoiceUpdates } from './storage.js';\n\nfunction resolveDir(dir: string): string {\n  if (dir === '~' || dir.startsWith('~/')) {\n    return path.join(os.homedir(), dir.slice(1));\n  }\n  return dir;\n}\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction validateId(id: string): void {\n  if (!UUID_RE.test(id)) {\n    throw new Error(`Invalid invoice ID: ${id}`);\n  }\n}\n\nexport class FileOfflineInvoiceStorage implements OfflineInvoiceStorage {\n  private readonly dir: string;\n\n  constructor(directory?: string) {\n    this.dir = resolveDir(directory ?? '~/.ksef/offline');\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.dir, { recursive: true });\n  }\n\n  private filePath(id: string): string {\n    validateId(id);\n    return path.join(this.dir, `${id}.json`);\n  }\n\n  async save(invoice: OfflineInvoiceMetadata): Promise<void> {\n    await this.ensureDir();\n    const file = this.filePath(invoice.id);\n    const tmp = `${file}.tmp`;\n    await fs.writeFile(tmp, JSON.stringify(invoice, null, 2));\n    await fs.rename(tmp, file);\n  }\n\n  async get(id: string): Promise<OfflineInvoiceMetadata | null> {\n    const file = this.filePath(id);\n    try {\n      return JSON.parse(await fs.readFile(file, 'utf-8'));\n    } catch (err: unknown) {\n      if (err instanceof Error && 'code' in err && (err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return null;\n      }\n      console.warn(`Warning: Failed to read offline invoice ${id}: ${err instanceof Error ? err.message : String(err)}`);\n      return null;\n    }\n  }\n\n  async list(filter?: OfflineInvoiceFilter): Promise<OfflineInvoiceMetadata[]> {\n    let files: string[];\n    try {\n      files = (await fs.readdir(this.dir)).filter(f => f.endsWith('.json'));\n    } catch {\n      return [];\n    }\n    const results: OfflineInvoiceMetadata[] = [];\n    for (const file of files) {\n      try {\n        const data: OfflineInvoiceMetadata = JSON.parse(\n          await fs.readFile(path.join(this.dir, file), 'utf-8'),\n        );\n        if (!filter || matchesFilter(data, filter)) {\n          results.push(data);\n        }\n      } catch (err: unknown) {\n        console.warn(`Warning: Skipping corrupt offline invoice file ${file}: ${err instanceof Error ? err.message : String(err)}`);\n      }\n    }\n    return results;\n  }\n\n  /**\n   * Update invoice metadata (read-modify-write).\n   *\n   * Note: No file locking — concurrent updates to the same ID may cause\n   * lost writes. Acceptable for CLI (single process). Library consumers\n   * running parallel operations should use external locking.\n   */\n  async update(id: string, updates: OfflineInvoiceUpdates): Promise<void> {\n    const existing = await this.get(id);\n    if (!existing) throw new Error(`Offline invoice not found: ${id}`);\n    await this.save({ ...existing, ...updates });\n  }\n\n  async delete(id: string): Promise<void> {\n    const file = this.filePath(id);\n    try {\n      await fs.unlink(file);\n    } catch (e: unknown) {\n      if (e instanceof Error && 'code' in e && e.code !== 'ENOENT') throw e;\n    }\n  }\n}\n","import type { OfflineInvoiceMetadata, OfflineInvoiceStatus, OfflineMode } from './types.js';\n\nexport interface OfflineInvoiceFilter {\n  status?: OfflineInvoiceStatus | OfflineInvoiceStatus[];\n  mode?: OfflineMode;\n  expiringBefore?: Date | string;\n  sellerNip?: string;\n}\n\nexport type OfflineInvoiceUpdates = Omit<Partial<OfflineInvoiceMetadata>, 'id'>;\n\nexport interface OfflineInvoiceStorage {\n  save(invoice: OfflineInvoiceMetadata): Promise<void>;\n  get(id: string): Promise<OfflineInvoiceMetadata | null>;\n  list(filter?: OfflineInvoiceFilter): Promise<OfflineInvoiceMetadata[]>;\n  update(id: string, updates: OfflineInvoiceUpdates): Promise<void>;\n  delete(id: string): Promise<void>;\n}\n\nexport function matchesFilter(invoice: OfflineInvoiceMetadata, filter: OfflineInvoiceFilter): boolean {\n  if (filter.status !== undefined) {\n    const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];\n    if (!statuses.includes(invoice.status)) return false;\n  }\n  if (filter.mode !== undefined && invoice.mode !== filter.mode) return false;\n  if (filter.sellerNip !== undefined && invoice.sellerNip !== filter.sellerNip) return false;\n  if (filter.expiringBefore !== undefined) {\n    const cutoff = typeof filter.expiringBefore === 'string'\n      ? new Date(filter.expiringBefore).getTime()\n      : filter.expiringBefore.getTime();\n    if (new Date(invoice.submitBy).getTime() >= cutoff) return false;\n  }\n  return true;\n}\n\nexport class InMemoryOfflineInvoiceStorage implements OfflineInvoiceStorage {\n  private readonly store = new Map<string, OfflineInvoiceMetadata>();\n\n  async save(invoice: OfflineInvoiceMetadata): Promise<void> {\n    this.store.set(invoice.id, JSON.parse(JSON.stringify(invoice)));\n  }\n\n  async get(id: string): Promise<OfflineInvoiceMetadata | null> {\n    const entry = this.store.get(id);\n    return entry ? JSON.parse(JSON.stringify(entry)) : null;\n  }\n\n  async list(filter?: OfflineInvoiceFilter): Promise<OfflineInvoiceMetadata[]> {\n    const all = [...this.store.values()];\n    if (!filter) return all.map(i => JSON.parse(JSON.stringify(i)));\n    return all.filter(i => matchesFilter(i, filter)).map(i => JSON.parse(JSON.stringify(i)));\n  }\n\n  async update(id: string, updates: OfflineInvoiceUpdates): Promise<void> {\n    const existing = this.store.get(id);\n    if (!existing) throw new Error(`Offline invoice not found: ${id}`);\n    this.store.set(id, JSON.parse(JSON.stringify({ ...existing, ...updates })));\n  }\n\n  async delete(id: string): Promise<void> {\n    this.store.delete(id);\n  }\n}\n","import { createRequire } from 'node:module';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nlet cachedPkgRoot: string | null = null;\n\nfunction locatePackageRoot(): string {\n  if (cachedPkgRoot !== null) return cachedPkgRoot;\n  let dir = path.dirname(fileURLToPath(import.meta.url));\n  const root = path.parse(dir).root;\n  while (dir !== root) {\n    const candidate = path.join(dir, 'docs', 'schemas');\n    if (fs.existsSync(candidate)) {\n      cachedPkgRoot = dir;\n      return dir;\n    }\n    dir = path.dirname(dir);\n  }\n  throw new Error('Could not locate ksef-client-ts package root (docs/schemas not found).');\n}\n\nexport type InvoiceSchemaId = 'FA2' | 'FA3' | 'PEF' | 'PEF_KOR';\n\nconst XSD_RELATIVE: Record<InvoiceSchemaId, readonly string[]> = {\n  FA2: ['FA', 'schemat_FA(2)_v1-0E.xsd'],\n  FA3: ['FA', 'schemat_FA(3)_v1-0E.xsd'],\n  PEF: ['PEF', 'Schemat_PEF(3)_v2-1.xsd'],\n  PEF_KOR: ['PEF', 'Schemat_PEF_KOR(3)_v2-1.xsd'],\n};\n\nexport const FA_XSD_PATHS = {\n  get FA2(): string { return resolveXsdFor('FA2'); },\n  get FA3(): string { return resolveXsdFor('FA3'); },\n} as const;\n\nexport const PEF_XSD_PATHS = {\n  get PEF(): string { return resolveXsdFor('PEF'); },\n  get PEF_KOR(): string { return resolveXsdFor('PEF_KOR'); },\n} as const;\n\nexport function resolveXsdFor(schema: InvoiceSchemaId): string {\n  const rel = XSD_RELATIVE[schema];\n  if (!rel) throw new Error(`Unknown invoice schema: ${String(schema)}`);\n  return path.join(locatePackageRoot(), 'docs', 'schemas', ...rel);\n}\n\nexport interface ValidateAgainstXsdResult {\n  valid: boolean;\n  errors: string[];\n}\n\nconst requireModule = createRequire(import.meta.url);\n\ntype LibxmljsModule = {\n  parseXml: (\n    xml: string,\n    options?: { baseUrl?: string },\n  ) => {\n    validate: (schema: unknown) => boolean;\n    validationErrors: Array<{ message: string }>;\n  };\n};\n\nlet libxmljs: LibxmljsModule | null = null;\n// Non-MODULE_NOT_FOUND failures (e.g. ERR_DLOPEN_FAILED from a native\n// binding ABI mismatch after a Node upgrade) are retained so we can\n// surface them at call time instead of masking them as \"not installed\"\n// and sending users to reinstall a module that is already on disk.\nlet libxmljsLoadError: Error | null = null;\ntry {\n  libxmljs = requireModule('libxmljs2') as LibxmljsModule;\n} catch (err) {\n  const code = (err as NodeJS.ErrnoException | undefined)?.code;\n  if (code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND') {\n    libxmljs = null;\n  } else {\n    libxmljs = null;\n    libxmljsLoadError = err instanceof Error ? err : new Error(String(err));\n  }\n}\n\nexport const libxmljsAvailable: boolean = libxmljs !== null;\n\nconst MISSING_LIBXMLJS_MESSAGE_PREFIX = 'libxmljs2 is not installed';\n\nexport function isMissingLibxmljsError(err: unknown): boolean {\n  return err instanceof Error && err.message.startsWith(MISSING_LIBXMLJS_MESSAGE_PREFIX);\n}\n\n// Only FA XSDs reference the external crd.gov.pl schemaLocation that needs\n// rewriting to a local file://-URL. PEF XSDs have no such import, so this\n// regex legitimately produces no replacement on a PEF path — callers must\n// not treat a zero-replacement PEF rewrite as drift.\n//\n// Kept non-global: FA XSDs carry the import exactly once, and a non-global\n// regex avoids the stateful `lastIndex` footgun that `.test()` would\n// otherwise leave behind on repeat calls.\nconst EXTERNAL_STRUKTURY_DANYCH_URL =\n  /schemaLocation=\"http:\\/\\/crd\\.gov\\.pl\\/xml\\/schematy\\/dziedzinowe\\/mf\\/2022\\/01\\/05\\/eD\\/DefinicjeTypy\\/StrukturyDanych_v10-0E\\.xsd\"/;\n\nfunction rewriteSchemaLocations(xsdContent: string): string {\n  // No upstream URL present → nothing to rewrite (PEF XSDs reach this path\n  // unchanged). Returning early makes the drift-guard below unambiguous.\n  if (!EXTERNAL_STRUKTURY_DANYCH_URL.test(xsdContent)) {\n    return xsdContent;\n  }\n\n  const bazoweStrukturyPath = path.join(\n    locatePackageRoot(),\n    'docs',\n    'schemas',\n    'FA',\n    'bazowe',\n    'StrukturyDanych_v10-0E.xsd',\n  );\n  const bazoweStrukturyUrl = pathToFileURL(bazoweStrukturyPath).href;\n  const rewritten = xsdContent.replace(\n    EXTERNAL_STRUKTURY_DANYCH_URL,\n    `schemaLocation=\"${bazoweStrukturyUrl}\"`,\n  );\n\n  // Drift-guard: the URL was present but `.replace()` produced no change.\n  // Should be unreachable unless the regex and the URL diverge — fail loud\n  // rather than pass through an unresolved `<xsd:import>` to libxmljs.\n  if (rewritten === xsdContent) {\n    throw new Error(\n      'FA XSD schemaLocation rewrite produced no replacement despite URL being present; ' +\n        'regex likely out of sync with docs/schemas/FA/. Re-check after `yarn sync-schemas`.',\n    );\n  }\n  return rewritten;\n}\n\nexport function validateAgainstXsd(xml: string, xsdPath: string): ValidateAgainstXsdResult {\n  if (!libxmljs) {\n    const loadSuffix = libxmljsLoadError\n      ? ` (load failed: ${libxmljsLoadError.message})`\n      : '';\n    throw new Error(\n      `${MISSING_LIBXMLJS_MESSAGE_PREFIX}${loadSuffix}; cannot run XSD validation. ` +\n        'Install it as an optional peer dependency (e.g. `yarn add -O libxmljs2` or `npm i -O libxmljs2`).',\n    );\n  }\n\n  const xsdDir = path.dirname(xsdPath);\n  const rawXsd = fs.readFileSync(xsdPath, 'utf8');\n  const rewrittenXsd = rewriteSchemaLocations(rawXsd);\n  const baseUrl = pathToFileURL(xsdDir + path.sep).href;\n\n  let schemaDoc;\n  try {\n    schemaDoc = libxmljs.parseXml(rewrittenXsd, { baseUrl });\n  } catch (err) {\n    return { valid: false, errors: [`XSD parse failed: ${(err as Error).message}`] };\n  }\n  let xmlDoc;\n  try {\n    xmlDoc = libxmljs.parseXml(xml);\n  } catch (err) {\n    return { valid: false, errors: [`XML parse failed: ${(err as Error).message}`] };\n  }\n\n  const valid = xmlDoc.validate(schemaDoc);\n  const errors = valid\n    ? []\n    : xmlDoc.validationErrors.map((err) => err.message.trim());\n\n  return { valid, errors };\n}\n","import * as fs from 'node:fs/promises';\nimport type { ContinuationPoints } from './hwm-coordinator.js';\n\nexport interface HwmStore {\n  load(): Promise<ContinuationPoints>;\n  save(points: ContinuationPoints): Promise<void>;\n}\n\nexport class InMemoryHwmStore implements HwmStore {\n  private points: ContinuationPoints = {};\n\n  async load(): Promise<ContinuationPoints> {\n    return { ...this.points };\n  }\n\n  async save(points: ContinuationPoints): Promise<void> {\n    this.points = { ...points };\n  }\n}\n\nexport class FileHwmStore implements HwmStore {\n  constructor(private readonly filePath: string) {}\n\n  async load(): Promise<ContinuationPoints> {\n    try {\n      const data = await fs.readFile(this.filePath, 'utf-8');\n      return JSON.parse(data) as ContinuationPoints;\n    } catch (err: unknown) {\n      if ((err as NodeJS.ErrnoException).code === 'ENOENT') {\n        return {};\n      }\n      throw err;\n    }\n  }\n\n  async save(points: ContinuationPoints): Promise<void> {\n    await fs.writeFile(this.filePath, JSON.stringify(points, null, 2), 'utf-8');\n  }\n}\n"],"mappings":"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","names":["fs","path","fs"]}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "ksef-client-ts",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "TypeScript client for the Polish National e-Invoice System (KSeF) API",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +17,16 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./node": {
+      "import": {
+        "types": "./dist/node.d.ts",
+        "default": "./dist/node.js"
+      },
+      "require": {
+        "types": "./dist/node.d.cts",
+        "default": "./dist/node.cjs"
+      }
     }
   },
   "bin": {
@@ -33,6 +44,7 @@
     "test:e2e:watch": "vitest tests/e2e --reporter=verbose",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
+    "check:node-types": "tsc --project tsconfig.node-check.json",
     "lint:md": "markdownlint-cli2",
     "lint:md:fix": "markdownlint-cli2 --fix",
     "link": "npm link",