ksef-client-ts 0.6.1 → 0.6.2

package/README.md

@@ -6,7 +6,7 @@ TypeScript client for the Polish National e-Invoice System (KSeF) API v2.
 
 ## Features
 
-- **Complete API coverage** — KSeF API v2.3.0, types aligned with the official OpenAPI spec
+- **Complete API coverage** — KSeF API v2.4.0, types aligned with the official OpenAPI spec
 - **Offline invoice mode** — full lifecycle for all 4 KSeF offline modes with QR KOD I + KOD II signing, deadline tracking, local storage, and technical correction
 - **Full-featured CLI** — `ksef` with 15 command groups for auth, sessions, invoices, offline, batch upload, export, and more
 - **High-level workflows** — auth, online/batch sessions, invoice export — full lifecycle in a single call

package/dist/cli.js

@@ -97,12 +97,14 @@ var init_ksef_unauthorized_error = __esm({
       detail;
       traceId;
       instance;
+      timestamp;
       constructor(problemDetails) {
         super(problemDetails.detail || "Unauthorized");
         this.name = "KSeFUnauthorizedError";
         this.detail = problemDetails.detail;
         this.traceId = problemDetails.traceId;
         this.instance = problemDetails.instance;
+        this.timestamp = problemDetails.timestamp;
       }
     };
   }
@@ -121,6 +123,7 @@ var init_ksef_forbidden_error = __esm({
       instance;
       security;
       traceId;
+      timestamp;
       constructor(problemDetails) {
         super(problemDetails.detail || "Forbidden");
         this.name = "KSeFForbiddenError";
@@ -129,6 +132,7 @@ var init_ksef_forbidden_error = __esm({
         this.instance = problemDetails.instance;
         this.security = problemDetails.security;
         this.traceId = problemDetails.traceId;
+        this.timestamp = problemDetails.timestamp;
       }
     };
   }
@@ -219,6 +223,69 @@ var init_config = __esm({
   }
 });
 
+// src/errors/ksef-gone-error.ts
+var KSeFGoneError;
+var init_ksef_gone_error = __esm({
+  "src/errors/ksef-gone-error.ts"() {
+    "use strict";
+    init_ksef_error();
+    KSeFGoneError = class extends KSeFError {
+      statusCode = 410;
+      detail;
+      instance;
+      traceId;
+      timestamp;
+      constructor(problemDetails) {
+        super(problemDetails.detail || "Operation status no longer available (retention expired)");
+        this.name = "KSeFGoneError";
+        this.detail = problemDetails.detail;
+        this.instance = problemDetails.instance;
+        this.traceId = problemDetails.traceId;
+        this.timestamp = problemDetails.timestamp;
+      }
+    };
+  }
+});
+
+// src/errors/error-codes.ts
+function hasErrorCode(body, code) {
+  return !!body?.exception?.exceptionDetailList?.some((d) => d.exceptionCode === code);
+}
+var KSeFErrorCode;
+var init_error_codes = __esm({
+  "src/errors/error-codes.ts"() {
+    "use strict";
+    KSeFErrorCode = {
+      BatchTimeout: 21208,
+      DuplicateInvoice: 440
+    };
+  }
+});
+
+// src/errors/ksef-batch-timeout-error.ts
+var KSeFBatchTimeoutError;
+var init_ksef_batch_timeout_error = __esm({
+  "src/errors/ksef-batch-timeout-error.ts"() {
+    "use strict";
+    init_ksef_api_error();
+    init_error_codes();
+    KSeFBatchTimeoutError = class _KSeFBatchTimeoutError extends KSeFApiError {
+      errorCode = KSeFErrorCode.BatchTimeout;
+      constructor(message, statusCode, errorResponse) {
+        super(message, statusCode, errorResponse);
+        this.name = "KSeFBatchTimeoutError";
+      }
+      static fromResponse(statusCode, body) {
+        const detail = body?.exception?.exceptionDetailList?.find(
+          (d) => d.exceptionCode === KSeFErrorCode.BatchTimeout
+        );
+        const message = detail?.exceptionDescription?.trim() || "Batch session timed out before the server completed processing (KSeF 21208).";
+        return new _KSeFBatchTimeoutError(message, statusCode, body);
+      }
+    };
+  }
+});
+
 // src/http/route-builder.ts
 var RouteBuilder;
 var init_route_builder = __esm({
@@ -396,6 +463,9 @@ var init_rest_client = __esm({
     init_ksef_rate_limit_error();
     init_ksef_unauthorized_error();
     init_ksef_forbidden_error();
+    init_ksef_gone_error();
+    init_ksef_batch_timeout_error();
+    init_error_codes();
     init_route_builder();
     init_transport();
     init_retry_policy();
@@ -536,18 +606,33 @@ var init_rest_client = __esm({
           );
         }
         if (response.status === 401) {
-          const body = parseJson();
-          if (body?.detail) {
-            throw new KSeFUnauthorizedError(body);
+          const body2 = parseJson();
+          if (body2?.detail) {
+            throw new KSeFUnauthorizedError(body2);
           }
         }
         if (response.status === 403) {
-          const body = parseJson();
-          if (body?.reasonCode) {
-            throw new KSeFForbiddenError(body);
+          const body2 = parseJson();
+          if (body2?.reasonCode) {
+            throw new KSeFForbiddenError(body2);
           }
         }
-        throw KSeFApiError.fromResponse(response.status, parseJson());
+        if (response.status === 410) {
+          const body2 = parseJson();
+          throw new KSeFGoneError({
+            title: body2?.title || "Gone",
+            status: body2?.status || 410,
+            detail: body2?.detail || "Operation status no longer available (retention expired)",
+            instance: body2?.instance,
+            traceId: body2?.traceId,
+            timestamp: body2?.timestamp
+          });
+        }
+        const body = parseJson();
+        if (hasErrorCode(body, KSeFErrorCode.BatchTimeout)) {
+          throw KSeFBatchTimeoutError.fromResponse(response.status, body);
+        }
+        throw KSeFApiError.fromResponse(response.status, body);
       }
     };
   }
@@ -1503,9 +1588,12 @@ var init_errors = __esm({
     init_ksef_rate_limit_error();
     init_ksef_unauthorized_error();
     init_ksef_forbidden_error();
+    init_ksef_gone_error();
     init_ksef_auth_status_error();
     init_ksef_session_expired_error();
     init_ksef_validation_error();
+    init_ksef_batch_timeout_error();
+    init_error_codes();
   }
 });
 
@@ -3060,6 +3148,7 @@ var init_client = __esm({
         const tokens = await this.auth.getAccessToken(authToken);
         this.authManager.setAccessToken(tokens.accessToken.token);
         this.authManager.setRefreshToken(tokens.refreshToken.token);
+        return { clientIp: challenge2.clientIp };
       }
       async loginWithCertificate(certPem, keyPem, nip, keyPassword) {
         const challenge2 = await this.auth.getChallenge();
@@ -3072,11 +3161,12 @@ var init_client = __esm({
         const tokens = await this.auth.getAccessToken(authToken);
         this.authManager.setAccessToken(tokens.accessToken.token);
         this.authManager.setRefreshToken(tokens.refreshToken.token);
+        return { clientIp: challenge2.clientIp };
       }
       async loginWithPkcs12(p12, password, nip) {
         const { Pkcs12Loader: Pkcs12Loader2 } = await Promise.resolve().then(() => (init_pkcs12_loader(), pkcs12_loader_exports));
         const { certificatePem, privateKeyPem } = Pkcs12Loader2.load(p12, password);
-        await this.loginWithCertificate(certificatePem, privateKeyPem, nip);
+        return this.loginWithCertificate(certificatePem, privateKeyPem, nip);
       }
       async awaitAuthReady(referenceNumber, authToken) {
         for (let i = 0; i < 30; i++) {
@@ -6056,17 +6146,18 @@ var login = defineCommand2({
         throw new Error("NIP is required. Provide --nip or set it via `ksef config set --nip <nip>`.");
       }
       const token = args.token ?? loadCredentials()?.token;
+      let loginResult;
       if (token) {
-        await client.loginWithToken(token, nip);
+        loginResult = await client.loginWithToken(token, nip);
       } else if (args.p12) {
         const fs15 = await import("fs");
         const p12Buffer = fs15.readFileSync(args.p12);
-        await client.loginWithPkcs12(p12Buffer, args["p12-password"] ?? "", nip);
+        loginResult = await client.loginWithPkcs12(p12Buffer, args["p12-password"] ?? "", nip);
       } else if (args.cert && args.key) {
         const fs15 = await import("fs");
         const certPem = fs15.readFileSync(args.cert, "utf-8");
         const keyPem = fs15.readFileSync(args.key, "utf-8");
-        await client.loginWithCertificate(certPem, keyPem, nip, args["key-password"]);
+        loginResult = await client.loginWithCertificate(certPem, keyPem, nip, args["key-password"]);
       } else {
         throw new Error("Provide --token, --p12, or both --cert and --key for authentication.");
       }
@@ -6081,7 +6172,12 @@ var login = defineCommand2({
       if (args.env && args.env !== config.environment) {
         saveConfig({ ...config, environment: session.environment });
       }
-      outputSuccess("Logged in successfully.");
+      if (args.json) {
+        console.log(JSON.stringify({ status: "ok", clientIp: loginResult.clientIp }, null, 2));
+      } else {
+        consola6.info(`Seen client IP: ${loginResult.clientIp}`);
+        outputSuccess("Logged in successfully.");
+      }
     });
   }
 });
@@ -6244,6 +6340,8 @@ var loginExternal = defineCommand2({
         process.stderr.write(`Challenge: ${challengeResult.challenge}
 `);
         process.stderr.write(`Timestamp: ${challengeResult.timestamp}
+`);
+        process.stderr.write(`Seen client IP: ${challengeResult.clientIp}
 `);
         process.stderr.write(`Note: Sign this XML and submit with --submit before the challenge expires.
 `);
@@ -6444,6 +6542,7 @@ var list = defineCommand3({
           reference: s.referenceNumber,
           status: `${s.status.code} \u2014 ${s.status.description}`,
           created: s.dateCreated,
+          updated: s.dateUpdated,
           total: s.totalInvoiceCount,
           success: s.successfulInvoiceCount,
           failed: s.failedInvoiceCount
@@ -6452,6 +6551,7 @@ var list = defineCommand3({
           { key: "reference", label: "Reference" },
           { key: "status", label: "Status" },
           { key: "created", label: "Created" },
+          { key: "updated", label: "Updated" },
           { key: "total", label: "Total" },
           { key: "success", label: "Success" },
           { key: "failed", label: "Failed" }
@@ -7078,8 +7178,8 @@ var QUERY_FILTER_ARGS = {
   dateType: { type: "string", description: "Date type: Issue|Invoicing|PermanentStorage (default: Invoicing)" },
   sellerNip: { type: "string", description: "Filter by seller NIP" },
   buyerNip: { type: "string", description: "Filter by buyer NIP" },
-  amountFrom: { type: "string", description: "Minimum amount" },
-  amountTo: { type: "string", description: "Maximum amount" },
+  amountFrom: { type: "string", description: "Minimum amount (negative values allowed)" },
+  amountTo: { type: "string", description: "Maximum amount (negative values allowed)" },
   amountType: { type: "string", description: "Amount type: Brutto|Netto|Vat (default: Brutto)" },
   currency: { type: "string", description: "Currency code (e.g. PLN, EUR)" }
 };