ksef-client-ts 0.1.1 → 0.2.0

package/README.md

@@ -6,14 +6,14 @@ TypeScript client for the Polish National e-Invoice System (KSeF) API v2.
 
 ## Features
 
-- **Complete API coverage** — (KSeF) API v2.3.0 auth, sessions, invoices, permissions, tokens, certificates, QR codes, and more
+- **Complete API coverage** — KSeF API v2.3.0, types aligned with the official OpenAPI spec
 - **Full-featured CLI** — `ksef` with many command groups and subcommands for day-to-day KSeF workflows
 - **Full documentation** — VitePress site: Quick Start, API reference, OpenAPI spec
-- **OpenAPI aligned** — types checked against the official KSeF spec; full spec and domain chunks in `docs/`
 - **Comprehensive test coverage** — Vitest across HTTP, crypto, services, builders; CI on every change
 - **Zero HTTP dependencies** — native `fetch` (Node 18+); dual ESM/CJS via tsup
 - **Built-in cryptography** — AES-256-CBC, RSA-OAEP, ECDH, XAdES-B, self-signed certs (Node crypto)
 - **Automatic token management** — AuthManager: token injection, 401 refresh with dedup, `loginWithToken` / `loginWithCertificate`
+- **High-level workflows** — orchestration functions for auth, online/batch sessions, invoice export with polling and decryption
 - **Typed errors & fluent builders** — `KSeFError` hierarchy (401, 403, 429, validation) and request builders
 
 Requires **Node.js 18+**.

package/dist/cli.js

@@ -5590,6 +5590,10 @@ var DefaultAuthManager = class {
   }
 };
 
+// src/http/ksef-feature.ts
+var KSEF_FEATURE_HEADER = "X-KSeF-Feature";
+var ENFORCE_XADES_COMPLIANCE = "enforce-xades-compliance";
+
 // src/http/rest-request.ts
 var RestRequest = class _RestRequest {
   method;
@@ -5794,8 +5798,11 @@ var AuthService = class {
     const response = await this.restClient.execute(request);
     return response.body;
   }
-  async submitXadesAuthRequest(signedXml, verifyCertificateChain = false) {
+  async submitXadesAuthRequest(signedXml, verifyCertificateChain = false, enforceXadesCompliance = false) {
     const request = RestRequest.post(Routes.Authorization.xadesSignature).body(signedXml).header("Content-Type", "application/xml").query("verifyCertificateChain", String(verifyCertificateChain));
+    if (enforceXadesCompliance) {
+      request.header(KSEF_FEATURE_HEADER, ENFORCE_XADES_COMPLIANCE);
+    }
     const response = await this.restClient.execute(request);
     return response.body;
   }
@@ -5853,7 +5860,7 @@ var OnlineSessionService = class {
   async openSession(request, upoVersion) {
     const req = RestRequest.post(Routes.Sessions.Online.open).body(request);
     if (upoVersion) {
-      req.header("X-KSeF-Feature", upoVersion);
+      req.header(KSEF_FEATURE_HEADER, upoVersion);
     }
     const response = await this.restClient.execute(req);
     return response.body;
@@ -5878,7 +5885,7 @@ var BatchSessionService = class {
   async openSession(request, upoVersion) {
     const req = RestRequest.post(Routes.Sessions.Batch.open).body(request);
     if (upoVersion) {
-      req.header("X-KSeF-Feature", upoVersion);
+      req.header(KSEF_FEATURE_HEADER, upoVersion);
     }
     const response = await this.restClient.execute(req);
     return response.body;