iobroker.parcelapp 0.4.1 → 0.4.3

package/README.md

@@ -122,6 +122,16 @@ The delivery is added to your parcel.app account and immediately appears in ioBr
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 0.4.3 (2026-05-13)
+- Debug log now traces previously silent paths: HTTPS request lifecycle, carrier-list fetch outcome, per-delivery updates, admin-message handling and lifecycle anchors. Default log unchanged.
+
+### 0.4.2 (2026-05-10)
+
+- Adapter shuts down cleanly even if parcel.app is slow — pending requests are aborted instead of hanging until kill.
+- "Forbidden" responses (e.g. when the Premium subscription is no longer active) now log a clear hint pointing to your parcel.app account, instead of looping reauth as if the API key were just wrong.
+- Two parcels whose tracking numbers differ only in special characters no longer overwrite each other in the state tree — the second one gets a hash suffix.
+- Defensive: bogus poll-interval values can no longer turn into a tight loop hammering the API; rate-limit cooldowns can no longer get stuck near zero.
+
 ### 0.4.1 (2026-05-09)
 
 - Adapter log messages are now English only, in line with the ioBroker community standard. Localized state names (11 languages) are unchanged.
@@ -134,12 +144,6 @@ The delivery is added to your parcel.app account and immediately appears in ioBr
 ### 0.3.2 (2026-05-01)
 - Documentation: rewrote release notes for v0.2.14–v0.3.1 in user-friendly style across all languages.
 
-### 0.3.1 (2026-05-01)
-- Documentation cleanup. No code changes.
-
-### 0.3.0 (2026-04-30)
-- Internal cleanup. No user-facing changes.
-
 Older entries are in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
 
 ## Support

package/build/lib/coerce.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var coerce_exports = {};
 __export(coerce_exports, {
   coerceBoolean: () => coerceBoolean,
+  coerceClampedInt: () => coerceClampedInt,
   coerceFiniteNumber: () => coerceFiniteNumber,
   coerceString: () => coerceString,
   errText: () => errText,
@@ -87,9 +88,17 @@ function errText(err) {
     return Object.prototype.toString.call(err);
   }
 }
+function coerceClampedInt(raw, min, max, defaultValue) {
+  const n = typeof raw === "number" ? raw : typeof raw === "string" ? parseFloat(raw) : NaN;
+  if (!Number.isFinite(n)) {
+    return defaultValue;
+  }
+  return Math.max(min, Math.min(max, Math.floor(n)));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   coerceBoolean,
+  coerceClampedInt,
   coerceFiniteNumber,
   coerceString,
   errText,

package/build/lib/coerce.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/coerce.ts"],
-  "sourcesContent": ["/**\n * Boundary coercion helpers for external API data.\n *\n * The parcel.app API is documented but field types still drift in practice\n * (rare success-flag returned as `\"true\"` string, occasional null where a\n * number is expected). These helpers guard against NaN/Infinity/non-string\n * values reaching ioBroker states.\n */\n\n// Strict decimal regex \u2014 only optional minus sign + digits + optional fractional part.\n// Rejects HEX (`0x...`), exponential (`1e3`), Infinity, NaN, leading/trailing whitespace.\n// Hassemu (E8 in v1.9.0) hardened the same coerce-helper this way; homewizard\n// adopted it in v0.7.2 (D8). Consistent with both adapters.\nconst DECIMAL_NUMBER_RE = /^-?\\d+(\\.\\d+)?$/;\n\n/**\n * Coerce to a finite number or null.\n * Accepts numbers directly; parses strict decimal strings; rejects NaN, Infinity,\n * HEX (`0x...`) and exponential notation (`1e3`).\n *\n * @param value Unknown external value\n */\nexport function coerceFiniteNumber(value: unknown): number | null {\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : null;\n  }\n  if (typeof value === \"string\" && DECIMAL_NUMBER_RE.test(value)) {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\n/**\n * Coerce to a non-empty string, or null.\n *\n * @param value Unknown external value\n */\nexport function coerceString(value: unknown): string | null {\n  if (typeof value === \"string\" && value.length > 0) {\n    return value;\n  }\n  return null;\n}\n\n/**\n * Coerce to a boolean (only `true`/`false` accepted \u2014 no truthy/falsy JS rules).\n *\n * @param value Unknown external value\n */\nexport function coerceBoolean(value: unknown): boolean | null {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  return null;\n}\n\n/**\n * Guard for plain objects (not arrays, not null).\n *\n * @param value Unknown external value\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Coerce a parcel.app `success` flag. The API returns a real boolean in normal\n * operation, but the guard accepts common string/number encodings (`1`, `\"true\"`,\n * `\"1\"`) so a one-off drift doesn't break the entire poll cycle.\n *\n * @param v Value to interpret as a success flag\n */\nexport function isTrueish(v: unknown): boolean {\n  if (typeof v === \"boolean\") {\n    return v;\n  }\n  if (typeof v === \"number\") {\n    return v === 1;\n  }\n  if (typeof v === \"string\") {\n    const s = v.toLowerCase();\n    return s === \"true\" || s === \"1\";\n  }\n  return false;\n}\n\n/**\n * Extract a log-friendly message from a thrown / rejected value. Centralizes the\n * `err instanceof Error ? err.message : String(err)` pattern that otherwise\n * gets repeated at every catch-site. Plain objects are JSON-stringified so a\n * `[object Object]` log is avoided when callers throw bag-of-fields.\n *\n * @param err Caught value of unknown shape (Error, string, undefined, ...).\n */\nexport function errText(err: unknown): string {\n  if (err instanceof Error) {\n    return err.message;\n  }\n  if (err === null) {\n    return \"null\";\n  }\n  if (err === undefined) {\n    return \"undefined\";\n  }\n  if (typeof err === \"string\") {\n    return err;\n  }\n  if (typeof err === \"number\" || typeof err === \"boolean\" || typeof err === \"bigint\") {\n    return String(err);\n  }\n  // Plain objects + symbols would otherwise stringify to \"[object Object]\" / fail.\n  // Prefer JSON for the common case so the log is at least diagnosable.\n  try {\n    return JSON.stringify(err);\n  } catch {\n    return Object.prototype.toString.call(err);\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,MAAM,oBAAoB;AASnB,SAAS,mBAAmB,OAA+B;AAChE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,YAAY,kBAAkB,KAAK,KAAK,GAAG;AAC9D,UAAM,IAAI,OAAO,KAAK;AACtB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AAOO,SAAS,aAAa,OAA+B;AAC1D,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,GAAG;AACjD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,cAAc,OAAgC;AAC5D,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,cAAc,OAAkD;AAC9E,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AASO,SAAS,UAAU,GAAqB;AAC7C,MAAI,OAAO,MAAM,WAAW;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO,MAAM;AAAA,EACf;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,EAAE,YAAY;AACxB,WAAO,MAAM,UAAU,MAAM;AAAA,EAC/B;AACA,SAAO;AACT;AAUO,SAAS,QAAQ,KAAsB;AAC5C,MAAI,eAAe,OAAO;AACxB,WAAO,IAAI;AAAA,EACb;AACA,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,QAAW;AACrB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,aAAa,OAAO,QAAQ,UAAU;AAClF,WAAO,OAAO,GAAG;AAAA,EACnB;AAGA,MAAI;AACF,WAAO,KAAK,UAAU,GAAG;AAAA,EAC3B,QAAQ;AACN,WAAO,OAAO,UAAU,SAAS,KAAK,GAAG;AAAA,EAC3C;AACF;",
+  "sourcesContent": ["/**\n * Boundary coercion helpers for external API data.\n *\n * The parcel.app API is documented but field types still drift in practice\n * (rare success-flag returned as `\"true\"` string, occasional null where a\n * number is expected). These helpers guard against NaN/Infinity/non-string\n * values reaching ioBroker states.\n */\n\n// Strict decimal regex \u2014 only optional minus sign + digits + optional fractional part.\n// Rejects HEX (`0x...`), exponential (`1e3`), Infinity, NaN, leading/trailing whitespace.\n// Hassemu (E8 in v1.9.0) hardened the same coerce-helper this way; homewizard\n// adopted it in v0.7.2 (D8). Consistent with both adapters.\nconst DECIMAL_NUMBER_RE = /^-?\\d+(\\.\\d+)?$/;\n\n/**\n * Coerce to a finite number or null.\n * Accepts numbers directly; parses strict decimal strings; rejects NaN, Infinity,\n * HEX (`0x...`) and exponential notation (`1e3`).\n *\n * @param value Unknown external value\n */\nexport function coerceFiniteNumber(value: unknown): number | null {\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : null;\n  }\n  if (typeof value === \"string\" && DECIMAL_NUMBER_RE.test(value)) {\n    const n = Number(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\n/**\n * Coerce to a non-empty string, or null.\n *\n * @param value Unknown external value\n */\nexport function coerceString(value: unknown): string | null {\n  if (typeof value === \"string\" && value.length > 0) {\n    return value;\n  }\n  return null;\n}\n\n/**\n * Coerce to a boolean (only `true`/`false` accepted \u2014 no truthy/falsy JS rules).\n *\n * @param value Unknown external value\n */\nexport function coerceBoolean(value: unknown): boolean | null {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  return null;\n}\n\n/**\n * Guard for plain objects (not arrays, not null).\n *\n * @param value Unknown external value\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Coerce a parcel.app `success` flag. The API returns a real boolean in normal\n * operation, but the guard accepts common string/number encodings (`1`, `\"true\"`,\n * `\"1\"`) so a one-off drift doesn't break the entire poll cycle.\n *\n * @param v Value to interpret as a success flag\n */\nexport function isTrueish(v: unknown): boolean {\n  if (typeof v === \"boolean\") {\n    return v;\n  }\n  if (typeof v === \"number\") {\n    return v === 1;\n  }\n  if (typeof v === \"string\") {\n    const s = v.toLowerCase();\n    return s === \"true\" || s === \"1\";\n  }\n  return false;\n}\n\n/**\n * Extract a log-friendly message from a thrown / rejected value. Centralizes the\n * `err instanceof Error ? err.message : String(err)` pattern that otherwise\n * gets repeated at every catch-site. Plain objects are JSON-stringified so a\n * `[object Object]` log is avoided when callers throw bag-of-fields.\n *\n * @param err Caught value of unknown shape (Error, string, undefined, ...).\n */\nexport function errText(err: unknown): string {\n  if (err instanceof Error) {\n    return err.message;\n  }\n  if (err === null) {\n    return \"null\";\n  }\n  if (err === undefined) {\n    return \"undefined\";\n  }\n  if (typeof err === \"string\") {\n    return err;\n  }\n  if (typeof err === \"number\" || typeof err === \"boolean\" || typeof err === \"bigint\") {\n    return String(err);\n  }\n  // Plain objects + symbols would otherwise stringify to \"[object Object]\" / fail.\n  // Prefer JSON for the common case so the log is at least diagnosable.\n  try {\n    return JSON.stringify(err);\n  } catch {\n    return Object.prototype.toString.call(err);\n  }\n}\n\n/**\n * v0.4.2 (X5): coerce an admin-config integer setting (number-or-string)\n * to a finite, clamped integer. Returns `defaultValue` for non-finite\n * input \u2014 guards against `setInterval(fn, NaN)` tight-loops when the\n * config field happens to come back as a string from the admin UI.\n *\n * @param raw Raw value from `this.config.<field>`.\n * @param min Inclusive lower bound.\n * @param max Inclusive upper bound.\n * @param defaultValue Fallback when raw is missing or unparseable.\n */\nexport function coerceClampedInt(raw: unknown, min: number, max: number, defaultValue: number): number {\n  const n = typeof raw === \"number\" ? raw : typeof raw === \"string\" ? parseFloat(raw) : NaN;\n  if (!Number.isFinite(n)) {\n    return defaultValue;\n  }\n  return Math.max(min, Math.min(max, Math.floor(n)));\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,MAAM,oBAAoB;AASnB,SAAS,mBAAmB,OAA+B;AAChE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,YAAY,kBAAkB,KAAK,KAAK,GAAG;AAC9D,UAAM,IAAI,OAAO,KAAK;AACtB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AAOO,SAAS,aAAa,OAA+B;AAC1D,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,GAAG;AACjD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,cAAc,OAAgC;AAC5D,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,cAAc,OAAkD;AAC9E,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AASO,SAAS,UAAU,GAAqB;AAC7C,MAAI,OAAO,MAAM,WAAW;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO,MAAM;AAAA,EACf;AACA,MAAI,OAAO,MAAM,UAAU;AACzB,UAAM,IAAI,EAAE,YAAY;AACxB,WAAO,MAAM,UAAU,MAAM;AAAA,EAC/B;AACA,SAAO;AACT;AAUO,SAAS,QAAQ,KAAsB;AAC5C,MAAI,eAAe,OAAO;AACxB,WAAO,IAAI;AAAA,EACb;AACA,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,QAAW;AACrB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ,YAAY,OAAO,QAAQ,aAAa,OAAO,QAAQ,UAAU;AAClF,WAAO,OAAO,GAAG;AAAA,EACnB;AAGA,MAAI;AACF,WAAO,KAAK,UAAU,GAAG;AAAA,EAC3B,QAAQ;AACN,WAAO,OAAO,UAAU,SAAS,KAAK,GAAG;AAAA,EAC3C;AACF;AAaO,SAAS,iBAAiB,KAAc,KAAa,KAAa,cAA8B;AACrG,QAAM,IAAI,OAAO,QAAQ,WAAW,MAAM,OAAO,QAAQ,WAAW,WAAW,GAAG,IAAI;AACtF,MAAI,CAAC,OAAO,SAAS,CAAC,GAAG;AACvB,WAAO;AAAA,EACT;AACA,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;AACnD;",
   "names": []
 }

package/build/lib/parcel-client.js

@@ -35,12 +35,36 @@ var https = __toESM(require("node:https"));
 var import_coerce = require("./coerce");
 const API_BASE = "https://api.parcel.app/external";
 const REQUEST_TIMEOUT = 15e3;
+const MAX_BODY_BYTES = 1 << 20;
 class ParcelClient {
   apiKey;
   carrierCache = null;
-  /** @param apiKey The parcel.app API key */
-  constructor(apiKey) {
+  /**
+   * v0.4.2 (P1): per-request AbortController. `cancelAll()` aborts every
+   * pending HTTPS request — called from the adapter's `onUnload` so a slow
+   * parcel.app endpoint can't keep the adapter alive past js-controller's
+   * 4-second kill deadline.
+   */
+  inflight = /* @__PURE__ */ new Set();
+  /** v0.4.3: optional logger for the HTTPS-layer trace. See {@link ParcelClientLogger}. */
+  log;
+  /**
+   * @param apiKey The parcel.app API key
+   * @param log Optional adapter logger for HTTPS-layer trace (v0.4.3)
+   */
+  constructor(apiKey, log) {
     this.apiKey = apiKey;
+    this.log = log;
+  }
+  /**
+   * v0.4.2 (P1): abort every in-flight HTTPS request. Idempotent.
+   */
+  cancelAll() {
+    var _a;
+    (_a = this.log) == null ? void 0 : _a.debug(`cancelAll: aborting ${this.inflight.size} inflight requests`);
+    for (const ctrl of this.inflight) {
+      ctrl.abort();
+    }
   }
   /**
    * Fetch deliveries from parcel.app.
@@ -48,8 +72,10 @@ class ParcelClient {
    * @param filterMode Filter active or recent deliveries
    */
   async getDeliveries(filterMode = "active") {
+    var _a, _b;
     const response = await this.request("GET", `/deliveries/?filter_mode=${filterMode}`, true);
     if (!response || typeof response !== "object") {
+      (_a = this.log) == null ? void 0 : _a.debug(`API drift: malformed response (got ${typeof response})`);
       const err = new Error("API error: malformed response");
       err.code = "API_ERROR";
       throw err;
@@ -58,6 +84,7 @@ class ParcelClient {
       const rawCode = typeof response.error_code === "string" ? response.error_code : "";
       const rawMsg = typeof response.error_message === "string" ? response.error_message : "";
       const code = rawCode || rawMsg || "UNKNOWN";
+      (_b = this.log) == null ? void 0 : _b.debug(`API drift: success=false, code='${code}', msg='${rawMsg}'`);
       const err = new Error(`API error: ${rawMsg || code}`);
       err.code = rawCode === "INVALID_API_KEY" ? "INVALID_API_KEY" : "API_ERROR";
       throw err;
@@ -74,6 +101,7 @@ class ParcelClient {
   }
   /** Get carrier names (cached after first call) */
   async getCarrierNames() {
+    var _a, _b, _c;
     if (this.carrierCache) {
       return this.carrierCache;
     }
@@ -81,10 +109,16 @@ class ParcelClient {
       const raw = await this.request("GET", "/supported_carriers.json", false);
       if (raw && typeof raw === "object" && !Array.isArray(raw)) {
         this.carrierCache = raw;
+        (_a = this.log) == null ? void 0 : _a.debug(`carriers: fetched ${Object.keys(this.carrierCache).length} entries`);
       } else {
+        (_b = this.log) == null ? void 0 : _b.debug(
+          `carriers: drift (got ${Array.isArray(raw) ? "array" : typeof raw}, expected object), kept empty`
+        );
         return {};
       }
-    } catch {
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      (_c = this.log) == null ? void 0 : _c.debug(`carriers: fetch failed (kept empty, will retry): ${msg}`);
       return {};
     }
     return this.carrierCache;
@@ -95,7 +129,9 @@ class ParcelClient {
    * @param carrierCode The carrier code from API
    */
   async getCarrierName(carrierCode) {
+    var _a;
     if (typeof carrierCode !== "string" || carrierCode.length === 0) {
+      (_a = this.log) == null ? void 0 : _a.debug(`getCarrierName: non-string code (got ${typeof carrierCode}), returning UNKNOWN`);
       return "UNKNOWN";
     }
     const carriers = await this.getCarrierNames();
@@ -124,8 +160,21 @@ class ParcelClient {
    * @param body Optional request body
    */
   request(method, path, authenticated, body) {
+    var _a;
+    const startedAt = Date.now();
+    (_a = this.log) == null ? void 0 : _a.debug(`HTTP ${method} ${path}`);
     return new Promise((resolve, reject) => {
-      const url = new URL(`${API_BASE}${path}`);
+      var _a2;
+      let url;
+      try {
+        url = new URL(`${API_BASE}${path}`);
+      } catch {
+        (_a2 = this.log) == null ? void 0 : _a2.debug(`HTTP invalid URL: ${API_BASE}${path}`);
+        const err = new Error(`Invalid URL: ${API_BASE}${path}`);
+        err.code = "INVALID_URL";
+        reject(err);
+        return;
+      }
       const headers = {};
       if (authenticated) {
         headers["api-key"] = this.apiKey;
@@ -141,38 +190,91 @@ class ParcelClient {
         headers,
         timeout: REQUEST_TIMEOUT
       };
+      const ctrl = new AbortController();
+      this.inflight.add(ctrl);
+      const cleanup = () => {
+        this.inflight.delete(ctrl);
+      };
       const req = https.request(options, (res) => {
         const chunks = [];
-        res.on("error", (err) => reject(err));
-        res.on("data", (chunk) => chunks.push(chunk));
+        let bodyBytes = 0;
+        let oversized = false;
+        res.on("error", (err) => {
+          cleanup();
+          reject(err);
+        });
+        res.on("data", (chunk) => {
+          var _a3;
+          if (oversized) {
+            return;
+          }
+          bodyBytes += chunk.length;
+          if (bodyBytes > MAX_BODY_BYTES) {
+            oversized = true;
+            (_a3 = this.log) == null ? void 0 : _a3.debug(`HTTP body oversized ${path}: dropping at ${bodyBytes}B`);
+            req.destroy(new Error(`Response body exceeds ${MAX_BODY_BYTES} bytes`));
+            return;
+          }
+          chunks.push(chunk);
+        });
         res.on("end", () => {
+          var _a3, _b, _c, _d;
+          cleanup();
+          if (oversized) {
+            const err = new Error("Response body too large");
+            err.code = "BODY_TOO_LARGE";
+            reject(err);
+            return;
+          }
           const raw = Buffer.concat(chunks).toString("utf-8");
           if (res.statusCode && (res.statusCode < 200 || res.statusCode >= 300)) {
             if (res.statusCode === 429) {
               const retryAfter = parseInt(res.headers["retry-after"] || "", 10);
               const err2 = new Error("Rate limit exceeded");
               err2.code = "RATE_LIMITED";
-              err2.retryAfterSeconds = retryAfter > 0 ? retryAfter : 5 * 60;
+              err2.retryAfterSeconds = Number.isFinite(retryAfter) && retryAfter > 0 ? Math.min(24 * 3600, retryAfter) : 5 * 60;
+              (_a3 = this.log) == null ? void 0 : _a3.debug(`HTTP 429 ${path} \u2192 retry-after=${err2.retryAfterSeconds}s`);
               reject(err2);
               return;
             }
             const err = new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`);
-            err.code = res.statusCode === 401 || res.statusCode === 403 ? "INVALID_API_KEY" : "HTTP_ERROR";
+            if (res.statusCode === 401) {
+              err.code = "INVALID_API_KEY";
+            } else if (res.statusCode === 403) {
+              err.code = "FORBIDDEN";
+            } else {
+              err.code = "HTTP_ERROR";
+            }
+            (_b = this.log) == null ? void 0 : _b.debug(`HTTP ${method} ${path} \u2192 ${res.statusCode} ${err.code} (body=${raw.substring(0, 200)})`);
             reject(err);
             return;
           }
           try {
-            resolve(JSON.parse(raw));
+            const parsed = JSON.parse(raw);
+            (_c = this.log) == null ? void 0 : _c.debug(`HTTP ${method} ${path} \u2192 ${res.statusCode} (${Date.now() - startedAt}ms, ${bodyBytes}B)`);
+            resolve(parsed);
           } catch {
+            (_d = this.log) == null ? void 0 : _d.debug(`HTTP JSON parse fail ${path}: ${raw.substring(0, 200)}`);
             reject(new Error(`JSON parse error: ${raw.substring(0, 200)}`));
           }
         });
       });
+      ctrl.signal.addEventListener("abort", () => {
+        req.destroy(new Error("Request aborted"));
+      });
       req.on("timeout", () => {
+        var _a3;
         req.destroy();
+        cleanup();
+        (_a3 = this.log) == null ? void 0 : _a3.debug(`HTTP timeout ${method} ${path} (${Date.now() - startedAt}ms)`);
         reject(new Error("Request timeout"));
       });
-      req.on("error", (err) => reject(err));
+      req.on("error", (err) => {
+        var _a3;
+        cleanup();
+        (_a3 = this.log) == null ? void 0 : _a3.debug(`HTTP error ${method} ${path} (${Date.now() - startedAt}ms): ${err.message}`);
+        reject(err);
+      });
       if (body) {
         req.write(JSON.stringify(body));
       }

package/build/lib/parcel-client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/parcel-client.ts"],
-  "sourcesContent": ["import * as https from \"node:https\";\nimport { isTrueish } from \"./coerce\";\nimport type { ParcelApiResponse, ParcelDelivery, AddDeliveryRequest, AddDeliveryResponse, CarrierMap } from \"./types\";\n\nconst API_BASE = \"https://api.parcel.app/external\";\nconst REQUEST_TIMEOUT = 15_000;\n\n/** HTTP client for the parcel.app API */\nexport class ParcelClient {\n  private apiKey: string;\n  private carrierCache: CarrierMap | null = null;\n\n  /** @param apiKey The parcel.app API key */\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  /**\n   * Fetch deliveries from parcel.app.\n   *\n   * @param filterMode Filter active or recent deliveries\n   */\n  async getDeliveries(filterMode: \"active\" | \"recent\" = \"active\"): Promise<ParcelDelivery[]> {\n    const response = await this.request<ParcelApiResponse>(\"GET\", `/deliveries/?filter_mode=${filterMode}`, true);\n\n    // API-drift guard: response may be null or a non-object\n    if (!response || typeof response !== \"object\") {\n      const err = new Error(\"API error: malformed response\") as Error & {\n        code: string;\n      };\n      err.code = \"API_ERROR\";\n      throw err;\n    }\n\n    if (!isTrueish(response.success)) {\n      const rawCode = typeof response.error_code === \"string\" ? response.error_code : \"\";\n      const rawMsg = typeof response.error_message === \"string\" ? response.error_message : \"\";\n      const code = rawCode || rawMsg || \"UNKNOWN\";\n      const err = new Error(`API error: ${rawMsg || code}`) as Error & {\n        code: string;\n      };\n      err.code = rawCode === \"INVALID_API_KEY\" ? \"INVALID_API_KEY\" : \"API_ERROR\";\n      throw err;\n    }\n\n    // API-drift guard: deliveries must be an array\n    return Array.isArray(response.deliveries) ? response.deliveries : [];\n  }\n\n  /**\n   * Add a new delivery to parcel.app.\n   *\n   * @param delivery The delivery to add\n   */\n  async addDelivery(delivery: AddDeliveryRequest): Promise<AddDeliveryResponse> {\n    return this.request<AddDeliveryResponse>(\"POST\", \"/add-delivery/\", true, delivery);\n  }\n\n  /** Get carrier names (cached after first call) */\n  async getCarrierNames(): Promise<CarrierMap> {\n    if (this.carrierCache) {\n      return this.carrierCache;\n    }\n\n    try {\n      const raw = await this.request<unknown>(\"GET\", \"/supported_carriers.json\", false);\n      // API-drift guard: must be a plain object (not null, array, or primitive)\n      if (raw && typeof raw === \"object\" && !Array.isArray(raw)) {\n        this.carrierCache = raw as CarrierMap;\n      } else {\n        return {};\n      }\n    } catch {\n      // Return empty map but don't cache it \u2014 allow retry next time\n      return {};\n    }\n\n    return this.carrierCache;\n  }\n\n  /**\n   * Resolve a carrier code to a display name.\n   *\n   * @param carrierCode The carrier code from API\n   */\n  async getCarrierName(carrierCode: unknown): Promise<string> {\n    // API-drift guard: non-string codes fall back to \"UNKNOWN\"\n    if (typeof carrierCode !== \"string\" || carrierCode.length === 0) {\n      return \"UNKNOWN\";\n    }\n    const carriers = await this.getCarrierNames();\n    const mapped = carriers[carrierCode];\n    return typeof mapped === \"string\" && mapped.length > 0 ? mapped : carrierCode.toUpperCase();\n  }\n\n  /** Test if the API key is valid */\n  async testConnection(): Promise<{ success: boolean; message: string }> {\n    try {\n      await this.getDeliveries(\"active\");\n      return { success: true, message: \"Connection successful\" };\n    } catch (err) {\n      const error = err as Error & { code?: string };\n      if (error.code === \"INVALID_API_KEY\") {\n        return { success: false, message: \"Invalid API key\" };\n      }\n      return { success: false, message: error.message };\n    }\n  }\n\n  /**\n   * Execute an HTTP request against the parcel.app API.\n   *\n   * @param method HTTP method\n   * @param path API path\n   * @param authenticated Whether to send the API key\n   * @param body Optional request body\n   */\n  private request<T>(method: string, path: string, authenticated: boolean, body?: unknown): Promise<T> {\n    return new Promise((resolve, reject) => {\n      const url = new URL(`${API_BASE}${path}`);\n\n      const headers: Record<string, string> = {};\n      if (authenticated) {\n        headers[\"api-key\"] = this.apiKey;\n      }\n      if (body) {\n        headers[\"Content-Type\"] = \"application/json\";\n      }\n\n      const options: https.RequestOptions = {\n        hostname: url.hostname,\n        port: url.port || 443,\n        path: url.pathname + url.search,\n        method,\n        headers,\n        timeout: REQUEST_TIMEOUT,\n      };\n\n      const req = https.request(options, res => {\n        const chunks: Buffer[] = [];\n\n        res.on(\"error\", err => reject(err));\n        res.on(\"data\", (chunk: Buffer) => chunks.push(chunk));\n        res.on(\"end\", () => {\n          const raw = Buffer.concat(chunks).toString(\"utf-8\");\n\n          if (res.statusCode && (res.statusCode < 200 || res.statusCode >= 300)) {\n            if (res.statusCode === 429) {\n              const retryAfter = parseInt(res.headers[\"retry-after\"] || \"\", 10);\n              const err = new Error(\"Rate limit exceeded\") as Error & {\n                code: string;\n                retryAfterSeconds: number;\n              };\n              err.code = \"RATE_LIMITED\";\n              // Use Retry-After header or default to 5 minutes\n              err.retryAfterSeconds = retryAfter > 0 ? retryAfter : 5 * 60;\n              reject(err);\n              return;\n            }\n            const err = new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`) as Error & { code: string };\n            err.code = res.statusCode === 401 || res.statusCode === 403 ? \"INVALID_API_KEY\" : \"HTTP_ERROR\";\n            reject(err);\n            return;\n          }\n\n          try {\n            resolve(JSON.parse(raw) as T);\n          } catch {\n            reject(new Error(`JSON parse error: ${raw.substring(0, 200)}`));\n          }\n        });\n      });\n\n      req.on(\"timeout\", () => {\n        req.destroy();\n        reject(new Error(\"Request timeout\"));\n      });\n\n      req.on(\"error\", err => reject(err));\n\n      if (body) {\n        req.write(JSON.stringify(body));\n      }\n      req.end();\n    });\n  }\n}\n"],
-  "mappings": "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",
-  "names": ["err"]
+  "sourcesContent": ["import * as https from \"node:https\";\nimport { isTrueish } from \"./coerce\";\nimport type { ParcelApiResponse, ParcelDelivery, AddDeliveryRequest, AddDeliveryResponse, CarrierMap } from \"./types\";\n\nconst API_BASE = \"https://api.parcel.app/external\";\nconst REQUEST_TIMEOUT = 15_000;\n\n/**\n * v0.4.3: optional logger injected by the adapter so the HTTPS client can\n * trace its own request/response lifecycle. When omitted (e.g. in tests),\n * every `this.log?.debug(...)` call is a no-op \u2014 keeps the bare-`apiKey`\n * constructor signature backward-compatible.\n */\nexport interface ParcelClientLogger {\n  /** Adapter debug log. Called at most once per request/response decision. */\n  debug(message: string): void;\n}\n/**\n * v0.4.2 (P9): hard cap on response body size. parcel.app deliveries lists\n * are tiny (~1 kB per package, max ~50 packages = 50 kB), so a 1 MiB cap is\n * 20\u00D7 the realistic max while still defending against a runaway response.\n */\nconst MAX_BODY_BYTES = 1 << 20; // 1 MiB\n\n/** HTTP client for the parcel.app API */\nexport class ParcelClient {\n  private apiKey: string;\n  private carrierCache: CarrierMap | null = null;\n  /**\n   * v0.4.2 (P1): per-request AbortController. `cancelAll()` aborts every\n   * pending HTTPS request \u2014 called from the adapter's `onUnload` so a slow\n   * parcel.app endpoint can't keep the adapter alive past js-controller's\n   * 4-second kill deadline.\n   */\n  private readonly inflight = new Set<AbortController>();\n  /** v0.4.3: optional logger for the HTTPS-layer trace. See {@link ParcelClientLogger}. */\n  private readonly log?: ParcelClientLogger;\n\n  /**\n   * @param apiKey The parcel.app API key\n   * @param log Optional adapter logger for HTTPS-layer trace (v0.4.3)\n   */\n  constructor(apiKey: string, log?: ParcelClientLogger) {\n    this.apiKey = apiKey;\n    this.log = log;\n  }\n\n  /**\n   * v0.4.2 (P1): abort every in-flight HTTPS request. Idempotent.\n   */\n  cancelAll(): void {\n    // v0.4.3 (A12): trace the shutdown anchor so the adapter log shows\n    // exactly how many HTTPS calls were aborted at unload.\n    this.log?.debug(`cancelAll: aborting ${this.inflight.size} inflight requests`);\n    for (const ctrl of this.inflight) {\n      ctrl.abort();\n    }\n  }\n\n  /**\n   * Fetch deliveries from parcel.app.\n   *\n   * @param filterMode Filter active or recent deliveries\n   */\n  async getDeliveries(filterMode: \"active\" | \"recent\" = \"active\"): Promise<ParcelDelivery[]> {\n    const response = await this.request<ParcelApiResponse>(\"GET\", `/deliveries/?filter_mode=${filterMode}`, true);\n\n    // API-drift guard: response may be null or a non-object\n    if (!response || typeof response !== \"object\") {\n      // v0.4.3 (A11a): trace malformed-response drift before throwing.\n      this.log?.debug(`API drift: malformed response (got ${typeof response})`);\n      const err = new Error(\"API error: malformed response\") as Error & {\n        code: string;\n      };\n      err.code = \"API_ERROR\";\n      throw err;\n    }\n\n    if (!isTrueish(response.success)) {\n      const rawCode = typeof response.error_code === \"string\" ? response.error_code : \"\";\n      const rawMsg = typeof response.error_message === \"string\" ? response.error_message : \"\";\n      const code = rawCode || rawMsg || \"UNKNOWN\";\n      // v0.4.3 (A11b): trace API-side error before throwing.\n      this.log?.debug(`API drift: success=false, code='${code}', msg='${rawMsg}'`);\n      const err = new Error(`API error: ${rawMsg || code}`) as Error & {\n        code: string;\n      };\n      err.code = rawCode === \"INVALID_API_KEY\" ? \"INVALID_API_KEY\" : \"API_ERROR\";\n      throw err;\n    }\n\n    // API-drift guard: deliveries must be an array\n    return Array.isArray(response.deliveries) ? response.deliveries : [];\n  }\n\n  /**\n   * Add a new delivery to parcel.app.\n   *\n   * @param delivery The delivery to add\n   */\n  async addDelivery(delivery: AddDeliveryRequest): Promise<AddDeliveryResponse> {\n    return this.request<AddDeliveryResponse>(\"POST\", \"/add-delivery/\", true, delivery);\n  }\n\n  /** Get carrier names (cached after first call) */\n  async getCarrierNames(): Promise<CarrierMap> {\n    if (this.carrierCache) {\n      return this.carrierCache;\n    }\n\n    try {\n      const raw = await this.request<unknown>(\"GET\", \"/supported_carriers.json\", false);\n      // API-drift guard: must be a plain object (not null, array, or primitive)\n      if (raw && typeof raw === \"object\" && !Array.isArray(raw)) {\n        this.carrierCache = raw as CarrierMap;\n        // v0.4.3 (D1): trace the one-time cache fill so a successful warm-up\n        // is visible in the debug log (happens once per adapter restart).\n        this.log?.debug(`carriers: fetched ${Object.keys(this.carrierCache).length} entries`);\n      } else {\n        // v0.4.3 (D3): non-object drift \u2014 supported_carriers.json returned\n        // something that isn't an object. Empty map is returned, NOT cached.\n        this.log?.debug(\n          `carriers: drift (got ${Array.isArray(raw) ? \"array\" : typeof raw}, expected object), kept empty`,\n        );\n        return {};\n      }\n    } catch (err) {\n      // v0.4.3 (D2): trace the fetch-fail so the empty-map fallback isn't\n      // silent. NOT cached \u2014 next poll retries; the trace then shows the\n      // retry, too. Without this the user sees carrier codes instead of\n      // names with no log entry explaining why.\n      const msg = err instanceof Error ? err.message : String(err);\n      this.log?.debug(`carriers: fetch failed (kept empty, will retry): ${msg}`);\n      // Return empty map but don't cache it \u2014 allow retry next time\n      return {};\n    }\n\n    return this.carrierCache;\n  }\n\n  /**\n   * Resolve a carrier code to a display name.\n   *\n   * @param carrierCode The carrier code from API\n   */\n  async getCarrierName(carrierCode: unknown): Promise<string> {\n    // API-drift guard: non-string codes fall back to \"UNKNOWN\"\n    if (typeof carrierCode !== \"string\" || carrierCode.length === 0) {\n      // v0.4.3 (D4): trace non-string code drift. Helps diagnose \"all my\n      // packages show UNKNOWN carrier\" reports.\n      this.log?.debug(`getCarrierName: non-string code (got ${typeof carrierCode}), returning UNKNOWN`);\n      return \"UNKNOWN\";\n    }\n    const carriers = await this.getCarrierNames();\n    const mapped = carriers[carrierCode];\n    return typeof mapped === \"string\" && mapped.length > 0 ? mapped : carrierCode.toUpperCase();\n  }\n\n  /** Test if the API key is valid */\n  async testConnection(): Promise<{ success: boolean; message: string }> {\n    try {\n      await this.getDeliveries(\"active\");\n      return { success: true, message: \"Connection successful\" };\n    } catch (err) {\n      const error = err as Error & { code?: string };\n      if (error.code === \"INVALID_API_KEY\") {\n        return { success: false, message: \"Invalid API key\" };\n      }\n      return { success: false, message: error.message };\n    }\n  }\n\n  /**\n   * Execute an HTTP request against the parcel.app API.\n   *\n   * @param method HTTP method\n   * @param path API path\n   * @param authenticated Whether to send the API key\n   * @param body Optional request body\n   */\n  private request<T>(method: string, path: string, authenticated: boolean, body?: unknown): Promise<T> {\n    // v0.4.3 (A0): start timestamp for elapsed-ms in the success/timeout/error\n    // log lines. One LOC, no behavior change.\n    const startedAt = Date.now();\n    // v0.4.3 (A1): trace request entry. ~144 calls/day at the default 10-min\n    // poll interval \u2014 acceptable at debug.\n    this.log?.debug(`HTTP ${method} ${path}`);\n    return new Promise((resolve, reject) => {\n      // v0.4.2 (E3): URL-shape validation defensive \u2014 paths are hardcoded\n      // upstream but a future caller could pass garbage; surface a clear\n      // error class instead of a TypeError thrown sync from the executor.\n      let url: URL;\n      try {\n        url = new URL(`${API_BASE}${path}`);\n      } catch {\n        // v0.4.3 (A10): trace invalid-URL drift before throwing.\n        this.log?.debug(`HTTP invalid URL: ${API_BASE}${path}`);\n        const err = new Error(`Invalid URL: ${API_BASE}${path}`) as Error & { code: string };\n        err.code = \"INVALID_URL\";\n        reject(err);\n        return;\n      }\n\n      const headers: Record<string, string> = {};\n      if (authenticated) {\n        headers[\"api-key\"] = this.apiKey;\n      }\n      if (body) {\n        headers[\"Content-Type\"] = \"application/json\";\n      }\n\n      const options: https.RequestOptions = {\n        hostname: url.hostname,\n        port: url.port || 443,\n        path: url.pathname + url.search,\n        method,\n        headers,\n        timeout: REQUEST_TIMEOUT,\n      };\n\n      // v0.4.2 (P1): per-request AbortController. `cancelAll()` (called\n      // from `onUnload`) aborts everything pending without waiting for\n      // the configured timeout.\n      const ctrl = new AbortController();\n      this.inflight.add(ctrl);\n      const cleanup = (): void => {\n        this.inflight.delete(ctrl);\n      };\n\n      const req = https.request(options, res => {\n        const chunks: Buffer[] = [];\n        let bodyBytes = 0;\n        let oversized = false;\n\n        res.on(\"error\", err => {\n          cleanup();\n          reject(err);\n        });\n        res.on(\"data\", (chunk: Buffer) => {\n          if (oversized) {\n            return;\n          }\n          bodyBytes += chunk.length;\n          // v0.4.2 (P9): drop the connection on oversized responses so a\n          // compromised or misconfigured endpoint can't OOM the adapter.\n          if (bodyBytes > MAX_BODY_BYTES) {\n            oversized = true;\n            // v0.4.3 (A9): trace the oversize-drop before destroying.\n            this.log?.debug(`HTTP body oversized ${path}: dropping at ${bodyBytes}B`);\n            req.destroy(new Error(`Response body exceeds ${MAX_BODY_BYTES} bytes`));\n            return;\n          }\n          chunks.push(chunk);\n        });\n        res.on(\"end\", () => {\n          cleanup();\n          if (oversized) {\n            const err = new Error(\"Response body too large\") as Error & { code: string };\n            err.code = \"BODY_TOO_LARGE\";\n            reject(err);\n            return;\n          }\n          const raw = Buffer.concat(chunks).toString(\"utf-8\");\n\n          if (res.statusCode && (res.statusCode < 200 || res.statusCode >= 300)) {\n            if (res.statusCode === 429) {\n              // v0.4.2 (P6): clamp Retry-After parser. Bogus values (0,\n              // negative, NaN) used to fall through `>0` and default to\n              // 5 min \u2014 keep that, but also reject infinity/extreme.\n              const retryAfter = parseInt(res.headers[\"retry-after\"] || \"\", 10);\n              const err = new Error(\"Rate limit exceeded\") as Error & {\n                code: string;\n                retryAfterSeconds: number;\n              };\n              err.code = \"RATE_LIMITED\";\n              err.retryAfterSeconds =\n                Number.isFinite(retryAfter) && retryAfter > 0 ? Math.min(24 * 3600, retryAfter) : 5 * 60;\n              // v0.4.3 (A4): trace 429 with the parsed retry-after.\n              this.log?.debug(`HTTP 429 ${path} \u2192 retry-after=${err.retryAfterSeconds}s`);\n              reject(err);\n              return;\n            }\n            // v0.4.2 (P3): split 401 (invalid key) from 403 (permission /\n            // no premium). Adapter treats them differently \u2014 INVALID_API_KEY\n            // says \"fix the key\", FORBIDDEN says \"fix the account\".\n            const err = new Error(`HTTP ${res.statusCode}: ${res.statusMessage}`) as Error & { code: string };\n            if (res.statusCode === 401) {\n              err.code = \"INVALID_API_KEY\";\n            } else if (res.statusCode === 403) {\n              err.code = \"FORBIDDEN\";\n            } else {\n              err.code = \"HTTP_ERROR\";\n            }\n            // v0.4.3 (A3): trace 4xx/5xx with body-snippet for diagnosis.\n            this.log?.debug(`HTTP ${method} ${path} \u2192 ${res.statusCode} ${err.code} (body=${raw.substring(0, 200)})`);\n            reject(err);\n            return;\n          }\n\n          try {\n            const parsed = JSON.parse(raw) as T;\n            // v0.4.3 (A2): trace successful response with elapsed-ms + bytes.\n            this.log?.debug(`HTTP ${method} ${path} \u2192 ${res.statusCode} (${Date.now() - startedAt}ms, ${bodyBytes}B)`);\n            resolve(parsed);\n          } catch {\n            // v0.4.3 (A8): trace JSON parse-fail with snippet.\n            this.log?.debug(`HTTP JSON parse fail ${path}: ${raw.substring(0, 200)}`);\n            reject(new Error(`JSON parse error: ${raw.substring(0, 200)}`));\n          }\n        });\n      });\n\n      ctrl.signal.addEventListener(\"abort\", () => {\n        // v0.4.3: A6 deliberately omitted \u2014 `req.destroy(Error)` propagates\n        // through `req.on(\"error\")` below where A7 already logs it.\n        req.destroy(new Error(\"Request aborted\"));\n      });\n\n      req.on(\"timeout\", () => {\n        req.destroy();\n        cleanup();\n        // v0.4.3 (A5): trace timeout with elapsed-ms.\n        this.log?.debug(`HTTP timeout ${method} ${path} (${Date.now() - startedAt}ms)`);\n        reject(new Error(\"Request timeout\"));\n      });\n\n      req.on(\"error\", err => {\n        cleanup();\n        // v0.4.3 (A7): trace network / abort / TLS / DNS errors with elapsed.\n        // Also catches the abort case (req.destroy(Error(\"Request aborted\")))\n        // \u2014 A6 deliberately not emitted to avoid double-log.\n        this.log?.debug(`HTTP error ${method} ${path} (${Date.now() - startedAt}ms): ${err.message}`);\n        reject(err);\n      });\n\n      if (body) {\n        req.write(JSON.stringify(body));\n      }\n      req.end();\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["_a", "err"]
 }

package/build/lib/state-manager.js

@@ -149,11 +149,17 @@ class StateManager {
       const n = parseInt(raw, 10);
       return Number.isFinite(n) ? n : 0;
     }
+    this.adapter.log.debug(`parseStatus drift: ${JSON.stringify(raw)} (type ${typeof raw}) \u2192 0 (delivered fallback)`);
     return 0;
   }
   /**
    * Build a unique package ID from a delivery.
    *
+   * v0.4.2 (S3): when the bare `sanitize(tracking_number)` collides with
+   * another active package (e.g. two trackings differ only in special
+   * chars that strip down to the same id), append a stable hash of the
+   * full tracking number so both end up at distinct state IDs.
+   *
    * @param delivery The delivery to build an ID for
    */
   packageId(delivery) {
@@ -161,8 +167,56 @@ class StateManager {
     if (typeof delivery.extra_information === "string" && delivery.extra_information.length > 0) {
       id += `_${this.sanitize(delivery.extra_information)}`;
     }
+    const owner = this.idOwner.get(id);
+    const rawKey = StateManager.rawIdKey(delivery);
+    if (owner !== void 0 && owner !== rawKey) {
+      const suffixed = `${id}__${StateManager.shortHash(rawKey)}`;
+      this.adapter.log.debug(
+        `packageId collision: bare='${id}' owner='${owner}' new='${rawKey}' \u2192 suffixed='${suffixed}'`
+      );
+      this.idOwner.set(suffixed, rawKey);
+      return suffixed;
+    }
+    this.idOwner.set(id, rawKey);
     return id;
   }
+  /**
+   * v0.4.2 (S3): build a stable raw-key for collision tracking.
+   *
+   * @param delivery The delivery whose raw tracking identifies it.
+   */
+  static rawIdKey(delivery) {
+    const t = typeof delivery.tracking_number === "string" ? delivery.tracking_number : "";
+    const e = typeof delivery.extra_information === "string" ? delivery.extra_information : "";
+    return `${t}\0${e}`;
+  }
+  /**
+   * v0.4.2 (S3): FNV-1a 32-bit short hash → 6 hex chars.
+   *
+   * @param s Input string to hash.
+   */
+  static shortHash(s) {
+    let h = 2166136261;
+    for (let i = 0; i < s.length; i++) {
+      h ^= s.charCodeAt(i);
+      h = Math.imul(h, 16777619);
+    }
+    return (h >>> 0).toString(16).padStart(8, "0").slice(0, 6);
+  }
+  /**
+   * v0.4.2 (S3): which raw-tracking-key currently "owns" each sanitized id
+   * within the running poll. Cleared via `resetIdOwners()` between polls so
+   * the same delivery keeps its bare id as long as it's unique.
+   */
+  idOwner = /* @__PURE__ */ new Map();
+  /**
+   * v0.4.2 (S3): reset the per-poll collision tracker. Call from main.ts
+   * before iterating deliveries so the bare id always wins for the first
+   * occurrence in each poll.
+   */
+  resetPollState() {
+    this.idOwner.clear();
+  }
   /**
    * Update or create all states for a delivery.
    *
@@ -184,7 +238,11 @@ class StateManager {
     });
     const statusCode = this.parseStatus(delivery);
     const labels = import_types.STATUS_LABELS[this.language];
-    const statusText = labels[statusCode] || `Unknown (${statusCode})`;
+    let statusText = labels[statusCode];
+    if (!statusText) {
+      this.adapter.log.debug(`status code ${statusCode} not in STATUS_LABELS[${this.language}], using fallback`);
+      statusText = `Unknown (${statusCode})`;
+    }
     await Promise.all([
       this.createAndSet(`${devicePath}.carrier`, asName((0, import_i18n_states.tName)("carrier")), "string", "text", carrierName),
       this.createAndSet(`${devicePath}.status`, asName((0, import_i18n_states.tName)("status")), "string", "text", statusText),
@@ -243,6 +301,9 @@ class StateManager {
    */
   async updateSummary(activeDeliveries) {
     const todayDeliveries = activeDeliveries.filter((d) => this.isToday(d, this.parseStatus(d)));
+    this.adapter.log.debug(
+      `updateSummary: ${activeDeliveries.length} active, ${todayDeliveries.length} expected today`
+    );
     await Promise.all([
       this.createAndSet(
         "summary.activeCount",
@@ -272,18 +333,28 @@ class StateManager {
       startkey: `${this.adapter.namespace}.deliveries.`,
       endkey: `${this.adapter.namespace}.deliveries.\u9999`
     });
+    if (!(objects == null ? void 0 : objects.rows)) {
+      this.adapter.log.debug("cleanupDeliveries: no objects view available, skipping");
+      return;
+    }
+    const toDelete = [];
     for (const row of objects.rows) {
       const relativeId = row.id.replace(`${this.adapter.namespace}.`, "");
       if (relativeId.startsWith("deliveries.") && !activeSet.has(relativeId)) {
+        toDelete.push(relativeId);
+      }
+    }
+    await Promise.all(
+      toDelete.map(async (relativeId) => {
         await this.adapter.delObjectAsync(relativeId, { recursive: true });
         this.adapter.log.debug(`Removed stale delivery: ${relativeId}`);
-        for (const id of this.createdIds) {
+        for (const id of [...this.createdIds]) {
           if (id === relativeId || id.startsWith(`${relativeId}.`)) {
             this.createdIds.delete(id);
           }
         }
-      }
-    }
+      })
+    );
   }
   /**
    * Calculate delivery time window — only from Unix timestamps.

package/build/lib/state-manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/state-manager.ts"],
-  "sourcesContent": ["import type { AdapterInstance } from \"@iobroker/adapter-core\";\nimport { coerceFiniteNumber } from \"./coerce\";\nimport type { StateName } from \"./i18n-states\";\nimport { tName } from \"./i18n-states\";\nimport type { ParcelDelivery } from \"./types\";\nimport { STATUS_LABELS, SUPPORTED_LANGUAGES, FALLBACK_LANGUAGE } from \"./types\";\n\n/** Status codes that have expected delivery date/time */\nconst TRACKABLE_STATUSES = new Set([2, 4, 8]);\n\n/**\n * Translation-object cast helper \u2014 ioBroker's `common.name` accepts `StringOrTranslated`.\n *\n * @param name Translation object from {@link STATE_NAMES}.\n */\nfunction asName(name: StateName): ioBroker.StringOrTranslated {\n  return name;\n}\n\n/** Delivery-estimate labels keyed by language code. Keys must match STATUS_LABELS. */\nconst ESTIMATE_LABELS: Record<string, Record<string, string>> = {\n  de: {\n    overdue: \"\u00FCberf\u00E4llig\",\n    today: \"heute\",\n    tomorrow: \"morgen\",\n    days: \"in %d Tagen\",\n  },\n  en: {\n    overdue: \"overdue\",\n    today: \"today\",\n    tomorrow: \"tomorrow\",\n    days: \"in %d days\",\n  },\n  ru: {\n    overdue: \"\u043F\u0440\u043E\u0441\u0440\u043E\u0447\u0435\u043D\u043E\",\n    today: \"\u0441\u0435\u0433\u043E\u0434\u043D\u044F\",\n    tomorrow: \"\u0437\u0430\u0432\u0442\u0440\u0430\",\n    days: \"\u0447\u0435\u0440\u0435\u0437 %d \u0434\u043D.\",\n  },\n  pt: {\n    overdue: \"atrasado\",\n    today: \"hoje\",\n    tomorrow: \"amanh\u00E3\",\n    days: \"em %d dias\",\n  },\n  nl: {\n    overdue: \"te laat\",\n    today: \"vandaag\",\n    tomorrow: \"morgen\",\n    days: \"over %d dagen\",\n  },\n  fr: {\n    overdue: \"en retard\",\n    today: \"aujourd'hui\",\n    tomorrow: \"demain\",\n    days: \"dans %d jours\",\n  },\n  it: {\n    overdue: \"in ritardo\",\n    today: \"oggi\",\n    tomorrow: \"domani\",\n    days: \"tra %d giorni\",\n  },\n  es: {\n    overdue: \"atrasado\",\n    today: \"hoy\",\n    tomorrow: \"ma\u00F1ana\",\n    days: \"en %d d\u00EDas\",\n  },\n  pl: {\n    overdue: \"zaleg\u0142e\",\n    today: \"dzisiaj\",\n    tomorrow: \"jutro\",\n    days: \"za %d dni\",\n  },\n  uk: {\n    overdue: \"\u043F\u0440\u043E\u0441\u0442\u0440\u043E\u0447\u0435\u043D\u043E\",\n    today: \"\u0441\u044C\u043E\u0433\u043E\u0434\u043D\u0456\",\n    tomorrow: \"\u0437\u0430\u0432\u0442\u0440\u0430\",\n    days: \"\u0447\u0435\u0440\u0435\u0437 %d \u0434\u043D.\",\n  },\n  \"zh-cn\": {\n    overdue: \"\u5DF2\u903E\u671F\",\n    today: \"\u4ECA\u5929\",\n    tomorrow: \"\u660E\u5929\",\n    days: \"%d \u5929\u540E\",\n  },\n};\n\n/**\n * Resolve a language code to one that has labels. Falls back to English\n * when the system language is not one of the supported ioBroker languages.\n *\n * @param language Raw language code (e.g. from system.config.language)\n */\nexport function resolveLanguage(language: unknown): string {\n  if (typeof language === \"string\" && SUPPORTED_LANGUAGES.includes(language)) {\n    return language;\n  }\n  return FALLBACK_LANGUAGE;\n}\n\n/** Manages ioBroker states for parcel deliveries */\nexport class StateManager {\n  private adapter: AdapterInstance;\n  private language: string;\n  /**\n   * Cache of state IDs that have already passed `setObjectNotExistsAsync`.\n   * Skips repeat DB lookups on the hot path \u2014 each poll touches ~11 states\n   * per delivery, and most deliveries see no schema change between polls.\n   * On `cleanupDeliveries`, IDs of removed packages are dropped so a re-add\n   * triggers a fresh creation.\n   */\n  private readonly createdIds = new Set<string>();\n\n  /**\n   * @param adapter The ioBroker adapter instance\n   * @param language Language code from system.config.language (falls back to English)\n   */\n  constructor(adapter: AdapterInstance, language: string) {\n    this.adapter = adapter;\n    this.language = resolveLanguage(language);\n  }\n\n  /**\n   * Sanitize a string for use as ioBroker object ID (see adapter.FORBIDDEN_CHARS).\n   * API-drift guard: returns \"unknown\" for non-string input.\n   *\n   * @param name Raw value to sanitize (any type)\n   */\n  sanitize(name: unknown): string {\n    if (typeof name !== \"string\") {\n      return \"unknown\";\n    }\n    return (\n      name\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"_\")\n        .replace(/^_+|_+$/g, \"\")\n        .slice(0, 50) || \"unknown\"\n    );\n  }\n\n  /**\n   * Parse the status code from a delivery. API documents `status_code` as\n   * a numeric string, but we accept numbers too and fall back to 0 for drift.\n   *\n   * @param delivery The delivery to parse\n   */\n  parseStatus(delivery: ParcelDelivery): number {\n    const raw = delivery.status_code as unknown;\n    if (typeof raw === \"number\" && Number.isFinite(raw)) {\n      return Math.trunc(raw);\n    }\n    if (typeof raw === \"string\") {\n      const n = parseInt(raw, 10);\n      return Number.isFinite(n) ? n : 0;\n    }\n    return 0;\n  }\n\n  /**\n   * Build a unique package ID from a delivery.\n   *\n   * @param delivery The delivery to build an ID for\n   */\n  packageId(delivery: ParcelDelivery): string {\n    let id = this.sanitize(delivery.tracking_number);\n    // API-drift guard: only string values extend the id\n    if (typeof delivery.extra_information === \"string\" && delivery.extra_information.length > 0) {\n      id += `_${this.sanitize(delivery.extra_information)}`;\n    }\n    return id;\n  }\n\n  /**\n   * Update or create all states for a delivery.\n   *\n   * @param delivery The delivery data from API\n   * @param carrierName Resolved carrier display name\n   */\n  async updateDelivery(delivery: ParcelDelivery, carrierName: string): Promise<void> {\n    const pkgId = this.packageId(delivery);\n    const devicePath = `deliveries.${pkgId}`;\n\n    const description = typeof delivery.description === \"string\" ? delivery.description : \"\";\n    const trackingNumber = typeof delivery.tracking_number === \"string\" ? delivery.tracking_number : \"\";\n    const extraInfo = typeof delivery.extra_information === \"string\" ? delivery.extra_information : \"\";\n\n    await this.adapter.extendObjectAsync(devicePath, {\n      type: \"device\",\n      common: {\n        name: description || `Package ${trackingNumber || pkgId}`,\n      },\n      native: {},\n    });\n\n    const statusCode = this.parseStatus(delivery);\n    const labels = STATUS_LABELS[this.language];\n    const statusText = labels[statusCode] || `Unknown (${statusCode})`;\n\n    await Promise.all([\n      this.createAndSet(`${devicePath}.carrier`, asName(tName(\"carrier\")), \"string\", \"text\", carrierName),\n      this.createAndSet(`${devicePath}.status`, asName(tName(\"status\")), \"string\", \"text\", statusText),\n      this.createAndSet(`${devicePath}.statusCode`, asName(tName(\"statusCode\")), \"number\", \"value\", statusCode),\n      this.createAndSet(`${devicePath}.description`, asName(tName(\"description\")), \"string\", \"text\", description),\n      this.createAndSet(\n        `${devicePath}.trackingNumber`,\n        asName(tName(\"trackingNumber\")),\n        \"string\",\n        \"text\",\n        trackingNumber,\n      ),\n      this.createAndSet(`${devicePath}.extraInfo`, asName(tName(\"extraInfo\")), \"string\", \"text\", extraInfo),\n      this.createAndSet(\n        `${devicePath}.deliveryWindow`,\n        asName(tName(\"deliveryWindow\")),\n        \"string\",\n        \"text\",\n        this.calculateDeliveryWindow(delivery, statusCode),\n      ),\n      this.createAndSet(\n        `${devicePath}.deliveryEstimate`,\n        asName(tName(\"deliveryEstimate\")),\n        \"string\",\n        \"text\",\n        this.calculateDeliveryEstimate(delivery, statusCode),\n      ),\n      this.createAndSet(\n        `${devicePath}.lastEvent`,\n        asName(tName(\"lastEvent\")),\n        \"string\",\n        \"text\",\n        this.formatLastEvent(delivery),\n      ),\n      this.createAndSet(\n        `${devicePath}.lastLocation`,\n        asName(tName(\"lastLocation\")),\n        \"string\",\n        \"text\",\n        this.extractLastLocation(delivery),\n      ),\n      this.createAndSet(\n        `${devicePath}.lastUpdated`,\n        asName(tName(\"lastUpdated\")),\n        \"string\",\n        \"date\",\n        new Date().toISOString(),\n      ),\n    ]);\n  }\n\n  /**\n   * Update summary states. Expects already-filtered active deliveries.\n   * The `summary` channel itself is declared via io-package.json instanceObjects.\n   *\n   * @param activeDeliveries Only active (non-delivered) deliveries\n   */\n  async updateSummary(activeDeliveries: ParcelDelivery[]): Promise<void> {\n    const todayDeliveries = activeDeliveries.filter(d => this.isToday(d, this.parseStatus(d)));\n\n    await Promise.all([\n      this.createAndSet(\n        \"summary.activeCount\",\n        asName(tName(\"activeCount\")),\n        \"number\",\n        \"value\",\n        activeDeliveries.length,\n      ),\n      this.createAndSet(\"summary.todayCount\", asName(tName(\"todayCount\")), \"number\", \"value\", todayDeliveries.length),\n      this.createAndSet(\n        \"summary.deliveryWindow\",\n        asName(tName(\"summaryDeliveryWindow\")),\n        \"string\",\n        \"text\",\n        this.calculateCombinedWindow(todayDeliveries),\n      ),\n    ]);\n  }\n\n  /**\n   * Remove deliveries that are no longer active.\n   *\n   * @param activeIds List of currently active package IDs\n   */\n  async cleanupDeliveries(activeIds: string[]): Promise<void> {\n    const activeSet = new Set(activeIds.map(id => `deliveries.${id}`));\n\n    const objects = await this.adapter.getObjectViewAsync(\"system\", \"device\", {\n      startkey: `${this.adapter.namespace}.deliveries.`,\n      endkey: `${this.adapter.namespace}.deliveries.\u9999`,\n    });\n\n    for (const row of objects.rows) {\n      const relativeId = row.id.replace(`${this.adapter.namespace}.`, \"\");\n      if (relativeId.startsWith(\"deliveries.\") && !activeSet.has(relativeId)) {\n        await this.adapter.delObjectAsync(relativeId, { recursive: true });\n        this.adapter.log.debug(`Removed stale delivery: ${relativeId}`);\n        // Drop cached child IDs \u2014 re-pairing the same delivery must re-create\n        // its states from scratch.\n        for (const id of this.createdIds) {\n          if (id === relativeId || id.startsWith(`${relativeId}.`)) {\n            this.createdIds.delete(id);\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Calculate delivery time window \u2014 only from Unix timestamps.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private calculateDeliveryWindow(delivery: ParcelDelivery, statusCode: number): string {\n    if (!TRACKABLE_STATUSES.has(statusCode)) {\n      return \"\";\n    }\n\n    const formatTime = (timestamp: unknown): string | null => {\n      const ts = coerceFiniteNumber(timestamp);\n      if (ts === null || ts <= 0) {\n        return null;\n      }\n      const d = new Date(ts * 1000);\n      if (Number.isNaN(d.getTime())) {\n        return null;\n      }\n      return `${d.getHours().toString().padStart(2, \"0\")}:${d.getMinutes().toString().padStart(2, \"0\")}`;\n    };\n\n    const start = formatTime(delivery.timestamp_expected);\n    const end = formatTime(delivery.timestamp_expected_end);\n\n    if (!start) {\n      return \"\";\n    }\n    return end ? `${start} - ${end}` : start;\n  }\n\n  /**\n   * Days from today to the expected delivery date. Returns null when the\n   * delivery has no usable expected date or is in a non-trackable status.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private computeDiffDays(delivery: ParcelDelivery, statusCode: number): number | null {\n    if (!TRACKABLE_STATUSES.has(statusCode)) {\n      return null;\n    }\n\n    let expectedDate: Date | null = null;\n    const ts = coerceFiniteNumber(delivery.timestamp_expected);\n    if (ts !== null && ts > 0) {\n      expectedDate = new Date(ts * 1000);\n    } else if (typeof delivery.date_expected === \"string\" && delivery.date_expected.length > 0) {\n      expectedDate = new Date(delivery.date_expected);\n    }\n\n    if (!expectedDate || isNaN(expectedDate.getTime())) {\n      return null;\n    }\n\n    const now = new Date();\n    const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate());\n    const expectedStart = new Date(expectedDate.getFullYear(), expectedDate.getMonth(), expectedDate.getDate());\n    return Math.round((expectedStart.getTime() - todayStart.getTime()) / (1000 * 60 * 60 * 24));\n  }\n\n  /**\n   * Calculate human-readable delivery estimate.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private calculateDeliveryEstimate(delivery: ParcelDelivery, statusCode: number): string {\n    const diffDays = this.computeDiffDays(delivery, statusCode);\n    if (diffDays === null) {\n      return \"\";\n    }\n    const l = ESTIMATE_LABELS[this.language];\n    if (diffDays < 0) {\n      return l.overdue;\n    }\n    if (diffDays === 0) {\n      return l.today;\n    }\n    if (diffDays === 1) {\n      return l.tomorrow;\n    }\n    return l.days.replace(\"%d\", String(diffDays));\n  }\n\n  /**\n   * Whether the delivery is expected today. Language-agnostic, used by the\n   * summary filter so `todayCount` works across all languages.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private isToday(delivery: ParcelDelivery, statusCode: number): boolean {\n    return this.computeDiffDays(delivery, statusCode) === 0;\n  }\n\n  /**\n   * Format the latest tracking event.\n   *\n   * @param delivery The delivery data\n   */\n  private formatLastEvent(delivery: ParcelDelivery): string {\n    if (!Array.isArray(delivery.events) || delivery.events.length === 0) {\n      return \"\";\n    }\n    const latest = delivery.events[0];\n    if (!latest || typeof latest !== \"object\") {\n      return \"\";\n    }\n    const parts: string[] = [];\n    if (typeof latest.event === \"string\" && latest.event.length > 0) {\n      parts.push(latest.event);\n    }\n    if (typeof latest.date === \"string\" && latest.date.length > 0) {\n      parts.push(latest.date);\n    }\n    return parts.join(\" - \");\n  }\n\n  /**\n   * Extract location from latest event.\n   *\n   * @param delivery The delivery data\n   */\n  private extractLastLocation(delivery: ParcelDelivery): string {\n    if (!Array.isArray(delivery.events) || delivery.events.length === 0) {\n      return \"\";\n    }\n    const latest = delivery.events[0];\n    if (!latest || typeof latest !== \"object\") {\n      return \"\";\n    }\n    return typeof latest.location === \"string\" ? latest.location : \"\";\n  }\n\n  /**\n   * Calculate combined delivery window for today's packages.\n   *\n   * @param todayDeliveries Deliveries expected today\n   */\n  private calculateCombinedWindow(todayDeliveries: ParcelDelivery[]): string {\n    const windows = todayDeliveries\n      .map(d => this.calculateDeliveryWindow(d, this.parseStatus(d)))\n      .filter(w => w.length > 0);\n\n    if (windows.length === 0) {\n      return \"\";\n    }\n    if (windows.length === 1) {\n      return windows[0];\n    }\n\n    const times: {\n      /** Window start */ start: string;\n      /** Window end */ end: string;\n    }[] = [];\n    for (const w of windows) {\n      const match = w.match(/(\\d{2}:\\d{2})(?:\\s*-\\s*(\\d{2}:\\d{2}))?/);\n      if (match) {\n        times.push({ start: match[1], end: match[2] || match[1] });\n      }\n    }\n\n    if (times.length === 0) {\n      return \"\";\n    }\n\n    times.sort((a, b) => a.start.localeCompare(b.start));\n    return `${times[0].start} - ${times[times.length - 1].end}`;\n  }\n\n  /**\n   * Create/extend a read-only state and set its value. Skips the\n   * `setObjectNotExistsAsync` round-trip once the ID is in the cache \u2014\n   * states are static after first creation; only the value changes per poll.\n   *\n   * @param id State ID relative to adapter namespace\n   * @param name Display name (translation object or plain string)\n   * @param type Value type\n   * @param role ioBroker role\n   * @param val Value to set\n   */\n  private async createAndSet(\n    id: string,\n    name: ioBroker.StringOrTranslated,\n    type: ioBroker.CommonType,\n    role: string,\n    val: ioBroker.StateValue,\n  ): Promise<void> {\n    if (!this.createdIds.has(id)) {\n      await this.adapter.setObjectNotExistsAsync(id, {\n        type: \"state\",\n        common: { name, type, role, read: true, write: false },\n        native: {},\n      });\n      this.createdIds.add(id);\n    }\n    await this.adapter.setStateAsync(id, { val, ack: true });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { AdapterInstance } from \"@iobroker/adapter-core\";\nimport { coerceFiniteNumber } from \"./coerce\";\nimport type { StateName } from \"./i18n-states\";\nimport { tName } from \"./i18n-states\";\nimport type { ParcelDelivery } from \"./types\";\nimport { STATUS_LABELS, SUPPORTED_LANGUAGES, FALLBACK_LANGUAGE } from \"./types\";\n\n/** Status codes that have expected delivery date/time */\nconst TRACKABLE_STATUSES = new Set([2, 4, 8]);\n\n/**\n * Translation-object cast helper \u2014 ioBroker's `common.name` accepts `StringOrTranslated`.\n *\n * @param name Translation object from {@link STATE_NAMES}.\n */\nfunction asName(name: StateName): ioBroker.StringOrTranslated {\n  return name;\n}\n\n/** Delivery-estimate labels keyed by language code. Keys must match STATUS_LABELS. */\nconst ESTIMATE_LABELS: Record<string, Record<string, string>> = {\n  de: {\n    overdue: \"\u00FCberf\u00E4llig\",\n    today: \"heute\",\n    tomorrow: \"morgen\",\n    days: \"in %d Tagen\",\n  },\n  en: {\n    overdue: \"overdue\",\n    today: \"today\",\n    tomorrow: \"tomorrow\",\n    days: \"in %d days\",\n  },\n  ru: {\n    overdue: \"\u043F\u0440\u043E\u0441\u0440\u043E\u0447\u0435\u043D\u043E\",\n    today: \"\u0441\u0435\u0433\u043E\u0434\u043D\u044F\",\n    tomorrow: \"\u0437\u0430\u0432\u0442\u0440\u0430\",\n    days: \"\u0447\u0435\u0440\u0435\u0437 %d \u0434\u043D.\",\n  },\n  pt: {\n    overdue: \"atrasado\",\n    today: \"hoje\",\n    tomorrow: \"amanh\u00E3\",\n    days: \"em %d dias\",\n  },\n  nl: {\n    overdue: \"te laat\",\n    today: \"vandaag\",\n    tomorrow: \"morgen\",\n    days: \"over %d dagen\",\n  },\n  fr: {\n    overdue: \"en retard\",\n    today: \"aujourd'hui\",\n    tomorrow: \"demain\",\n    days: \"dans %d jours\",\n  },\n  it: {\n    overdue: \"in ritardo\",\n    today: \"oggi\",\n    tomorrow: \"domani\",\n    days: \"tra %d giorni\",\n  },\n  es: {\n    overdue: \"atrasado\",\n    today: \"hoy\",\n    tomorrow: \"ma\u00F1ana\",\n    days: \"en %d d\u00EDas\",\n  },\n  pl: {\n    overdue: \"zaleg\u0142e\",\n    today: \"dzisiaj\",\n    tomorrow: \"jutro\",\n    days: \"za %d dni\",\n  },\n  uk: {\n    overdue: \"\u043F\u0440\u043E\u0441\u0442\u0440\u043E\u0447\u0435\u043D\u043E\",\n    today: \"\u0441\u044C\u043E\u0433\u043E\u0434\u043D\u0456\",\n    tomorrow: \"\u0437\u0430\u0432\u0442\u0440\u0430\",\n    days: \"\u0447\u0435\u0440\u0435\u0437 %d \u0434\u043D.\",\n  },\n  \"zh-cn\": {\n    overdue: \"\u5DF2\u903E\u671F\",\n    today: \"\u4ECA\u5929\",\n    tomorrow: \"\u660E\u5929\",\n    days: \"%d \u5929\u540E\",\n  },\n};\n\n/**\n * Resolve a language code to one that has labels. Falls back to English\n * when the system language is not one of the supported ioBroker languages.\n *\n * @param language Raw language code (e.g. from system.config.language)\n */\nexport function resolveLanguage(language: unknown): string {\n  if (typeof language === \"string\" && SUPPORTED_LANGUAGES.includes(language)) {\n    return language;\n  }\n  return FALLBACK_LANGUAGE;\n}\n\n/** Manages ioBroker states for parcel deliveries */\nexport class StateManager {\n  private adapter: AdapterInstance;\n  private language: string;\n  /**\n   * Cache of state IDs that have already passed `setObjectNotExistsAsync`.\n   * Skips repeat DB lookups on the hot path \u2014 each poll touches ~11 states\n   * per delivery, and most deliveries see no schema change between polls.\n   * On `cleanupDeliveries`, IDs of removed packages are dropped so a re-add\n   * triggers a fresh creation.\n   */\n  private readonly createdIds = new Set<string>();\n\n  /**\n   * @param adapter The ioBroker adapter instance\n   * @param language Language code from system.config.language (falls back to English)\n   */\n  constructor(adapter: AdapterInstance, language: string) {\n    this.adapter = adapter;\n    this.language = resolveLanguage(language);\n  }\n\n  /**\n   * Sanitize a string for use as ioBroker object ID (see adapter.FORBIDDEN_CHARS).\n   * API-drift guard: returns \"unknown\" for non-string input.\n   *\n   * @param name Raw value to sanitize (any type)\n   */\n  sanitize(name: unknown): string {\n    if (typeof name !== \"string\") {\n      return \"unknown\";\n    }\n    return (\n      name\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"_\")\n        .replace(/^_+|_+$/g, \"\")\n        .slice(0, 50) || \"unknown\"\n    );\n  }\n\n  /**\n   * Parse the status code from a delivery. API documents `status_code` as\n   * a numeric string, but we accept numbers too and fall back to 0 for drift.\n   *\n   * @param delivery The delivery to parse\n   */\n  parseStatus(delivery: ParcelDelivery): number {\n    const raw = delivery.status_code as unknown;\n    if (typeof raw === \"number\" && Number.isFinite(raw)) {\n      return Math.trunc(raw);\n    }\n    if (typeof raw === \"string\") {\n      const n = parseInt(raw, 10);\n      return Number.isFinite(n) ? n : 0;\n    }\n    // v0.4.3 (C2): trace status_code drift (non-string/non-number). Without\n    // this, the fallback to 0 (\"delivered\") silently makes packages disappear\n    // from active states with no log entry explaining why.\n    this.adapter.log.debug(`parseStatus drift: ${JSON.stringify(raw)} (type ${typeof raw}) \u2192 0 (delivered fallback)`);\n    return 0;\n  }\n\n  /**\n   * Build a unique package ID from a delivery.\n   *\n   * v0.4.2 (S3): when the bare `sanitize(tracking_number)` collides with\n   * another active package (e.g. two trackings differ only in special\n   * chars that strip down to the same id), append a stable hash of the\n   * full tracking number so both end up at distinct state IDs.\n   *\n   * @param delivery The delivery to build an ID for\n   */\n  packageId(delivery: ParcelDelivery): string {\n    let id = this.sanitize(delivery.tracking_number);\n    // API-drift guard: only string values extend the id\n    if (typeof delivery.extra_information === \"string\" && delivery.extra_information.length > 0) {\n      id += `_${this.sanitize(delivery.extra_information)}`;\n    }\n    // v0.4.2 (S3): collision suffix when two distinct (raw) trackings would\n    // collapse to the same id. Bare id is kept as long as it's unique\n    // within this poll (back-compat with existing installs).\n    const owner = this.idOwner.get(id);\n    const rawKey = StateManager.rawIdKey(delivery);\n    if (owner !== undefined && owner !== rawKey) {\n      const suffixed = `${id}__${StateManager.shortHash(rawKey)}`;\n      // v0.4.3 (C3): trace the collision-suffix path. Rare event but the\n      // resulting state-id divergence is hard to diagnose without a log.\n      this.adapter.log.debug(\n        `packageId collision: bare='${id}' owner='${owner}' new='${rawKey}' \u2192 suffixed='${suffixed}'`,\n      );\n      this.idOwner.set(suffixed, rawKey);\n      return suffixed;\n    }\n    this.idOwner.set(id, rawKey);\n    return id;\n  }\n\n  /**\n   * v0.4.2 (S3): build a stable raw-key for collision tracking.\n   *\n   * @param delivery The delivery whose raw tracking identifies it.\n   */\n  private static rawIdKey(delivery: ParcelDelivery): string {\n    const t = typeof delivery.tracking_number === \"string\" ? delivery.tracking_number : \"\";\n    const e = typeof delivery.extra_information === \"string\" ? delivery.extra_information : \"\";\n    return `${t}\u0000${e}`;\n  }\n\n  /**\n   * v0.4.2 (S3): FNV-1a 32-bit short hash \u2192 6 hex chars.\n   *\n   * @param s Input string to hash.\n   */\n  private static shortHash(s: string): string {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < s.length; i++) {\n      h ^= s.charCodeAt(i);\n      h = Math.imul(h, 0x01000193);\n    }\n    return (h >>> 0).toString(16).padStart(8, \"0\").slice(0, 6);\n  }\n\n  /**\n   * v0.4.2 (S3): which raw-tracking-key currently \"owns\" each sanitized id\n   * within the running poll. Cleared via `resetIdOwners()` between polls so\n   * the same delivery keeps its bare id as long as it's unique.\n   */\n  private readonly idOwner = new Map<string, string>();\n\n  /**\n   * v0.4.2 (S3): reset the per-poll collision tracker. Call from main.ts\n   * before iterating deliveries so the bare id always wins for the first\n   * occurrence in each poll.\n   */\n  resetPollState(): void {\n    this.idOwner.clear();\n  }\n\n  /**\n   * Update or create all states for a delivery.\n   *\n   * @param delivery The delivery data from API\n   * @param carrierName Resolved carrier display name\n   */\n  async updateDelivery(delivery: ParcelDelivery, carrierName: string): Promise<void> {\n    const pkgId = this.packageId(delivery);\n    const devicePath = `deliveries.${pkgId}`;\n\n    const description = typeof delivery.description === \"string\" ? delivery.description : \"\";\n    const trackingNumber = typeof delivery.tracking_number === \"string\" ? delivery.tracking_number : \"\";\n    const extraInfo = typeof delivery.extra_information === \"string\" ? delivery.extra_information : \"\";\n\n    await this.adapter.extendObjectAsync(devicePath, {\n      type: \"device\",\n      common: {\n        name: description || `Package ${trackingNumber || pkgId}`,\n      },\n      native: {},\n    });\n\n    const statusCode = this.parseStatus(delivery);\n    const labels = STATUS_LABELS[this.language];\n    let statusText = labels[statusCode];\n    if (!statusText) {\n      // v0.4.3 (E3): trace unknown status-code (API drift). A future\n      // parcel.app status (e.g. 9, 10) would render as \"Unknown (N)\"\n      // without any log clue that the codes table is out of date.\n      this.adapter.log.debug(`status code ${statusCode} not in STATUS_LABELS[${this.language}], using fallback`);\n      statusText = `Unknown (${statusCode})`;\n    }\n\n    await Promise.all([\n      this.createAndSet(`${devicePath}.carrier`, asName(tName(\"carrier\")), \"string\", \"text\", carrierName),\n      this.createAndSet(`${devicePath}.status`, asName(tName(\"status\")), \"string\", \"text\", statusText),\n      this.createAndSet(`${devicePath}.statusCode`, asName(tName(\"statusCode\")), \"number\", \"value\", statusCode),\n      this.createAndSet(`${devicePath}.description`, asName(tName(\"description\")), \"string\", \"text\", description),\n      this.createAndSet(\n        `${devicePath}.trackingNumber`,\n        asName(tName(\"trackingNumber\")),\n        \"string\",\n        \"text\",\n        trackingNumber,\n      ),\n      this.createAndSet(`${devicePath}.extraInfo`, asName(tName(\"extraInfo\")), \"string\", \"text\", extraInfo),\n      this.createAndSet(\n        `${devicePath}.deliveryWindow`,\n        asName(tName(\"deliveryWindow\")),\n        \"string\",\n        \"text\",\n        this.calculateDeliveryWindow(delivery, statusCode),\n      ),\n      this.createAndSet(\n        `${devicePath}.deliveryEstimate`,\n        asName(tName(\"deliveryEstimate\")),\n        \"string\",\n        \"text\",\n        this.calculateDeliveryEstimate(delivery, statusCode),\n      ),\n      this.createAndSet(\n        `${devicePath}.lastEvent`,\n        asName(tName(\"lastEvent\")),\n        \"string\",\n        \"text\",\n        this.formatLastEvent(delivery),\n      ),\n      this.createAndSet(\n        `${devicePath}.lastLocation`,\n        asName(tName(\"lastLocation\")),\n        \"string\",\n        \"text\",\n        this.extractLastLocation(delivery),\n      ),\n      this.createAndSet(\n        `${devicePath}.lastUpdated`,\n        asName(tName(\"lastUpdated\")),\n        \"string\",\n        \"date\",\n        new Date().toISOString(),\n      ),\n    ]);\n  }\n\n  /**\n   * Update summary states. Expects already-filtered active deliveries.\n   * The `summary` channel itself is declared via io-package.json instanceObjects.\n   *\n   * @param activeDeliveries Only active (non-delivered) deliveries\n   */\n  async updateSummary(activeDeliveries: ParcelDelivery[]): Promise<void> {\n    const todayDeliveries = activeDeliveries.filter(d => this.isToday(d, this.parseStatus(d)));\n    // v0.4.3 (E1): trace summary refresh \u2014 ~144/day at the default poll\n    // interval, kept short (counts only).\n    this.adapter.log.debug(\n      `updateSummary: ${activeDeliveries.length} active, ${todayDeliveries.length} expected today`,\n    );\n\n    await Promise.all([\n      this.createAndSet(\n        \"summary.activeCount\",\n        asName(tName(\"activeCount\")),\n        \"number\",\n        \"value\",\n        activeDeliveries.length,\n      ),\n      this.createAndSet(\"summary.todayCount\", asName(tName(\"todayCount\")), \"number\", \"value\", todayDeliveries.length),\n      this.createAndSet(\n        \"summary.deliveryWindow\",\n        asName(tName(\"summaryDeliveryWindow\")),\n        \"string\",\n        \"text\",\n        this.calculateCombinedWindow(todayDeliveries),\n      ),\n    ]);\n  }\n\n  /**\n   * Remove deliveries that are no longer active.\n   *\n   * @param activeIds List of currently active package IDs\n   */\n  async cleanupDeliveries(activeIds: string[]): Promise<void> {\n    const activeSet = new Set(activeIds.map(id => `deliveries.${id}`));\n\n    const objects = await this.adapter.getObjectViewAsync(\"system\", \"device\", {\n      startkey: `${this.adapter.namespace}.deliveries.`,\n      endkey: `${this.adapter.namespace}.deliveries.\u9999`,\n    });\n    if (!objects?.rows) {\n      // v0.4.3 (E2): trace the no-op path \u2014 happens on fresh installs or\n      // when getObjectViewAsync returns falsy. Without this the early-return\n      // is invisible.\n      this.adapter.log.debug(\"cleanupDeliveries: no objects view available, skipping\");\n      return;\n    }\n\n    // v0.4.2 (S1): collect first, then delete in parallel. Earlier each\n    // stale package took a sequential broker round-trip.\n    const toDelete: string[] = [];\n    for (const row of objects.rows) {\n      const relativeId = row.id.replace(`${this.adapter.namespace}.`, \"\");\n      if (relativeId.startsWith(\"deliveries.\") && !activeSet.has(relativeId)) {\n        toDelete.push(relativeId);\n      }\n    }\n\n    await Promise.all(\n      toDelete.map(async relativeId => {\n        await this.adapter.delObjectAsync(relativeId, { recursive: true });\n        this.adapter.log.debug(`Removed stale delivery: ${relativeId}`);\n        // v0.4.2 (S2): snapshot to array first \u2014 defensive against any future\n        // engine that diverges from spec on Set.delete during for-of iteration.\n        for (const id of [...this.createdIds]) {\n          if (id === relativeId || id.startsWith(`${relativeId}.`)) {\n            this.createdIds.delete(id);\n          }\n        }\n      }),\n    );\n  }\n\n  /**\n   * Calculate delivery time window \u2014 only from Unix timestamps.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private calculateDeliveryWindow(delivery: ParcelDelivery, statusCode: number): string {\n    if (!TRACKABLE_STATUSES.has(statusCode)) {\n      return \"\";\n    }\n\n    const formatTime = (timestamp: unknown): string | null => {\n      const ts = coerceFiniteNumber(timestamp);\n      if (ts === null || ts <= 0) {\n        return null;\n      }\n      const d = new Date(ts * 1000);\n      if (Number.isNaN(d.getTime())) {\n        return null;\n      }\n      return `${d.getHours().toString().padStart(2, \"0\")}:${d.getMinutes().toString().padStart(2, \"0\")}`;\n    };\n\n    const start = formatTime(delivery.timestamp_expected);\n    const end = formatTime(delivery.timestamp_expected_end);\n\n    if (!start) {\n      return \"\";\n    }\n    return end ? `${start} - ${end}` : start;\n  }\n\n  /**\n   * Days from today to the expected delivery date. Returns null when the\n   * delivery has no usable expected date or is in a non-trackable status.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private computeDiffDays(delivery: ParcelDelivery, statusCode: number): number | null {\n    if (!TRACKABLE_STATUSES.has(statusCode)) {\n      return null;\n    }\n\n    let expectedDate: Date | null = null;\n    const ts = coerceFiniteNumber(delivery.timestamp_expected);\n    if (ts !== null && ts > 0) {\n      expectedDate = new Date(ts * 1000);\n    } else if (typeof delivery.date_expected === \"string\" && delivery.date_expected.length > 0) {\n      expectedDate = new Date(delivery.date_expected);\n    }\n\n    if (!expectedDate || isNaN(expectedDate.getTime())) {\n      return null;\n    }\n\n    const now = new Date();\n    const todayStart = new Date(now.getFullYear(), now.getMonth(), now.getDate());\n    const expectedStart = new Date(expectedDate.getFullYear(), expectedDate.getMonth(), expectedDate.getDate());\n    return Math.round((expectedStart.getTime() - todayStart.getTime()) / (1000 * 60 * 60 * 24));\n  }\n\n  /**\n   * Calculate human-readable delivery estimate.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private calculateDeliveryEstimate(delivery: ParcelDelivery, statusCode: number): string {\n    const diffDays = this.computeDiffDays(delivery, statusCode);\n    if (diffDays === null) {\n      return \"\";\n    }\n    const l = ESTIMATE_LABELS[this.language];\n    if (diffDays < 0) {\n      return l.overdue;\n    }\n    if (diffDays === 0) {\n      return l.today;\n    }\n    if (diffDays === 1) {\n      return l.tomorrow;\n    }\n    return l.days.replace(\"%d\", String(diffDays));\n  }\n\n  /**\n   * Whether the delivery is expected today. Language-agnostic, used by the\n   * summary filter so `todayCount` works across all languages.\n   *\n   * @param delivery The delivery data\n   * @param statusCode Pre-parsed status code\n   */\n  private isToday(delivery: ParcelDelivery, statusCode: number): boolean {\n    return this.computeDiffDays(delivery, statusCode) === 0;\n  }\n\n  /**\n   * Format the latest tracking event.\n   *\n   * @param delivery The delivery data\n   */\n  private formatLastEvent(delivery: ParcelDelivery): string {\n    if (!Array.isArray(delivery.events) || delivery.events.length === 0) {\n      return \"\";\n    }\n    const latest = delivery.events[0];\n    if (!latest || typeof latest !== \"object\") {\n      return \"\";\n    }\n    const parts: string[] = [];\n    if (typeof latest.event === \"string\" && latest.event.length > 0) {\n      parts.push(latest.event);\n    }\n    if (typeof latest.date === \"string\" && latest.date.length > 0) {\n      parts.push(latest.date);\n    }\n    return parts.join(\" - \");\n  }\n\n  /**\n   * Extract location from latest event.\n   *\n   * @param delivery The delivery data\n   */\n  private extractLastLocation(delivery: ParcelDelivery): string {\n    if (!Array.isArray(delivery.events) || delivery.events.length === 0) {\n      return \"\";\n    }\n    const latest = delivery.events[0];\n    if (!latest || typeof latest !== \"object\") {\n      return \"\";\n    }\n    return typeof latest.location === \"string\" ? latest.location : \"\";\n  }\n\n  /**\n   * Calculate combined delivery window for today's packages.\n   *\n   * @param todayDeliveries Deliveries expected today\n   */\n  private calculateCombinedWindow(todayDeliveries: ParcelDelivery[]): string {\n    const windows = todayDeliveries\n      .map(d => this.calculateDeliveryWindow(d, this.parseStatus(d)))\n      .filter(w => w.length > 0);\n\n    if (windows.length === 0) {\n      return \"\";\n    }\n    if (windows.length === 1) {\n      return windows[0];\n    }\n\n    const times: {\n      /** Window start */ start: string;\n      /** Window end */ end: string;\n    }[] = [];\n    for (const w of windows) {\n      const match = w.match(/(\\d{2}:\\d{2})(?:\\s*-\\s*(\\d{2}:\\d{2}))?/);\n      if (match) {\n        times.push({ start: match[1], end: match[2] || match[1] });\n      }\n    }\n\n    if (times.length === 0) {\n      return \"\";\n    }\n\n    times.sort((a, b) => a.start.localeCompare(b.start));\n    return `${times[0].start} - ${times[times.length - 1].end}`;\n  }\n\n  /**\n   * Create/extend a read-only state and set its value. Skips the\n   * `setObjectNotExistsAsync` round-trip once the ID is in the cache \u2014\n   * states are static after first creation; only the value changes per poll.\n   *\n   * @param id State ID relative to adapter namespace\n   * @param name Display name (translation object or plain string)\n   * @param type Value type\n   * @param role ioBroker role\n   * @param val Value to set\n   */\n  private async createAndSet(\n    id: string,\n    name: ioBroker.StringOrTranslated,\n    type: ioBroker.CommonType,\n    role: string,\n    val: ioBroker.StateValue,\n  ): Promise<void> {\n    if (!this.createdIds.has(id)) {\n      await this.adapter.setObjectNotExistsAsync(id, {\n        type: \"state\",\n        common: { name, type, role, read: true, write: false },\n        native: {},\n      });\n      this.createdIds.add(id);\n    }\n    await this.adapter.setStateAsync(id, { val, ack: true });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/main.js

@@ -29,6 +29,7 @@ const MIN_POLL_INTERVAL = 5;
 const MAX_POLL_INTERVAL = 60;
 const DEFAULT_POLL_INTERVAL = 10;
 const MIN_POLL_GAP_MS = 6e4;
+const MIN_API_KEY_LENGTH = 10;
 class ParcelappAdapter extends utils.Adapter {
   client = null;
   stateManager = null;
@@ -56,45 +57,61 @@ class ParcelappAdapter extends utils.Adapter {
       this.onMessage(obj).catch((err) => this.log.error(`onMessage failed: ${(0, import_coerce.errText)(err)}`));
     });
     this.unhandledRejectionHandler = (reason) => {
+      var _a;
       this.log.error(`Unhandled rejection: ${(0, import_coerce.errText)(reason)}`);
+      (_a = this.terminate) == null ? void 0 : _a.call(this, 11);
     };
     this.uncaughtExceptionHandler = (err) => {
+      var _a;
       this.log.error(`Uncaught exception: ${(0, import_coerce.errText)(err)}`);
+      (_a = this.terminate) == null ? void 0 : _a.call(this, 11);
     };
     process.on("unhandledRejection", this.unhandledRejectionHandler);
     process.on("uncaughtException", this.uncaughtExceptionHandler);
   }
   async onReady() {
-    var _a, _b, _c;
+    var _a, _b;
+    this.log.debug(
+      `onReady: starting (pollInterval=${JSON.stringify(this.config.pollInterval)}, autoRemoveDelivered=${this.config.autoRemoveDelivered})`
+    );
     const sysConfig = await this.getForeignObjectAsync("system.config");
     const language = (_b = (_a = sysConfig == null ? void 0 : sysConfig.common) == null ? void 0 : _a.language) != null ? _b : "";
     if (typeof language === "string" && language.length > 0) {
       this.systemLang = language;
     }
+    this.log.debug(`system language: '${language}' \u2192 using '${this.systemLang}'`);
     await this.setStateAsync("info.connection", { val: false, ack: true });
     const { apiKey } = this.config;
-    if (!apiKey || apiKey.trim().length < 10) {
+    if (!apiKey || apiKey.trim().length < MIN_API_KEY_LENGTH) {
       this.log.error("No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings");
       return;
     }
-    this.client = new import_parcel_client.ParcelClient(apiKey.trim());
+    this.client = new import_parcel_client.ParcelClient(apiKey.trim(), { debug: (m) => this.log.debug(m) });
     this.stateManager = new import_state_manager.StateManager(this, language);
     await this.cleanupObsoleteStates();
     await this.poll();
-    const interval = Math.max(
-      MIN_POLL_INTERVAL,
-      Math.min(MAX_POLL_INTERVAL, (_c = this.config.pollInterval) != null ? _c : DEFAULT_POLL_INTERVAL)
-    );
+    const interval = ParcelappAdapter.coercePollInterval(this.config.pollInterval);
+    this.log.debug(`pollInterval: raw=${JSON.stringify(this.config.pollInterval)} resolved=${interval}min`);
     const intervalMs = interval * 60 * 1e3;
     this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);
     this.log.info(`Parcel tracking started \u2014 polling every ${interval} minutes`);
   }
+  /**
+   * v0.4.2 (M5+X5): delegate to the shared `coerceClampedInt` helper.
+   *
+   * @param raw Raw `pollInterval` from admin config (number or numeric string).
+   */
+  static coercePollInterval(raw) {
+    return (0, import_coerce.coerceClampedInt)(raw, MIN_POLL_INTERVAL, MAX_POLL_INTERVAL, DEFAULT_POLL_INTERVAL);
+  }
   onUnload(callback) {
+    var _a;
     try {
       if (this.pollTimer) {
         this.clearInterval(this.pollTimer);
         this.pollTimer = void 0;
       }
+      (_a = this.client) == null ? void 0 : _a.cancelAll();
       if (this.unhandledRejectionHandler) {
         process.off("unhandledRejection", this.unhandledRejectionHandler);
         this.unhandledRejectionHandler = null;
@@ -103,13 +120,16 @@ class ParcelappAdapter extends utils.Adapter {
         process.off("uncaughtException", this.uncaughtExceptionHandler);
         this.uncaughtExceptionHandler = null;
       }
-      void this.setState("info.connection", { val: false, ack: true });
-    } catch {
+      void this.setState("info.connection", { val: false, ack: true }).catch(() => {
+      });
+    } catch (err) {
+      this.log.debug(`onUnload error (ignored): ${(0, import_coerce.errText)(err)}`);
     }
     callback();
   }
   async onMessage(obj) {
     var _a;
+    this.log.debug(`onMessage: command='${obj == null ? void 0 : obj.command}' from='${obj == null ? void 0 : obj.from}' has-callback=${!!(obj == null ? void 0 : obj.callback)}`);
     if (!(obj == null ? void 0 : obj.command) || !obj.callback) {
       return;
     }
@@ -118,17 +138,20 @@ class ParcelappAdapter extends utils.Adapter {
         case "checkConnection": {
           const msg = obj.message;
           const key = ((_a = msg == null ? void 0 : msg.apiKey) == null ? void 0 : _a.trim()) || "";
-          if (!key || key.length < 10) {
+          if (!key || key.length < MIN_API_KEY_LENGTH) {
+            this.log.debug("checkConnection: apiKey too short");
             this.sendTo(obj.from, obj.command, { success: false, message: "API key is too short" }, obj.callback);
             return;
           }
-          const testClient = new import_parcel_client.ParcelClient(key);
+          const testClient = new import_parcel_client.ParcelClient(key, { debug: (m) => this.log.debug(m) });
           const result = await testClient.testConnection();
+          this.log.debug(`checkConnection: result=${result.success ? "ok" : "fail"} (${result.message})`);
           this.sendTo(obj.from, obj.command, result, obj.callback);
           break;
         }
         case "addDelivery": {
           if (!this.client) {
+            this.log.debug("addDelivery: adapter not initialized");
             this.sendTo(
               obj.from,
               obj.command,
@@ -139,6 +162,7 @@ class ParcelappAdapter extends utils.Adapter {
           }
           const request = obj.message;
           const addResult = await this.client.addDelivery(request);
+          this.log.debug(`addDelivery: '${request == null ? void 0 : request.tracking_number}' result=${addResult.success ? "ok" : "fail"}`);
           this.sendTo(obj.from, obj.command, addResult, obj.callback);
           if (addResult.success) {
             void this.poll();
@@ -146,9 +170,11 @@ class ParcelappAdapter extends utils.Adapter {
           break;
         }
         default:
+          this.log.debug(`onMessage: unknown command '${obj.command}'`);
           this.sendTo(obj.from, obj.command, { error: "Unknown command" }, obj.callback);
       }
     } catch (err) {
+      this.log.debug(`onMessage: '${obj.command}' failed: ${(0, import_coerce.errText)(err)}`);
       this.sendTo(obj.from, obj.command, { success: false, error_message: (0, import_coerce.errText)(err) }, obj.callback);
     }
   }
@@ -177,6 +203,9 @@ class ParcelappAdapter extends utils.Adapter {
     if (error.code === "INVALID_API_KEY") {
       return "INVALID_API_KEY";
     }
+    if (error.code === "FORBIDDEN") {
+      return "FORBIDDEN";
+    }
     if (error.code === "ENOTFOUND" || error.code === "ECONNREFUSED" || error.code === "ECONNRESET" || error.code === "ENETUNREACH" || error.code === "EHOSTUNREACH" || error.code === "EAI_AGAIN") {
       return "NETWORK";
     }
@@ -186,10 +215,13 @@ class ParcelappAdapter extends utils.Adapter {
     return error.code || "UNKNOWN";
   }
   async poll() {
+    var _a;
     if (this.isPolling || !this.client || !this.stateManager) {
       return;
     }
     const now = Date.now();
+    const autoRemoveMode = this.config.autoRemoveDelivered !== false;
+    this.log.debug(`poll: starting (autoRemove=${autoRemoveMode}, lastErrorCode='${this.lastErrorCode}')`);
     if (now < this.rateLimitedUntil) {
       const waitMin = Math.ceil((this.rateLimitedUntil - now) / 6e4);
       this.log.debug(`Skipping poll \u2014 rate limited for ${waitMin} more minute(s)`);
@@ -202,8 +234,7 @@ class ParcelappAdapter extends utils.Adapter {
     this.isPolling = true;
     this.lastPollTime = now;
     try {
-      const autoRemove = this.config.autoRemoveDelivered !== false;
-      const deliveries = await this.client.getDeliveries(autoRemove ? "active" : "recent");
+      const deliveries = await this.client.getDeliveries(autoRemoveMode ? "active" : "recent");
       this.rateLimitedUntil = 0;
       if (this.lastErrorCode) {
         this.log.info("Connection restored");
@@ -211,24 +242,31 @@ class ParcelappAdapter extends utils.Adapter {
       }
       await this.setStateAsync("info.connection", { val: true, ack: true });
       const activeDeliveries = deliveries.filter((d) => this.stateManager.parseStatus(d) !== 0);
-      const visibleDeliveries = autoRemove ? activeDeliveries : deliveries;
-      const activeIds = [];
-      for (const delivery of visibleDeliveries) {
-        try {
-          const carrierName = await this.client.getCarrierName(delivery.carrier_code);
-          await this.stateManager.updateDelivery(delivery, carrierName);
-          activeIds.push(this.stateManager.packageId(delivery));
-          this.failedDeliveries.delete(delivery.tracking_number);
-        } catch (err) {
-          const msg = (0, import_coerce.errText)(err);
-          if (this.failedDeliveries.has(delivery.tracking_number)) {
-            this.log.debug(`Failed to update "${delivery.tracking_number}": ${msg}`);
-          } else {
-            this.log.warn(`Failed to update '${delivery.tracking_number}': ${msg}`);
-            this.failedDeliveries.add(delivery.tracking_number);
+      const visibleDeliveries = autoRemoveMode ? activeDeliveries : deliveries;
+      this.stateManager.resetPollState();
+      const idResults = await Promise.all(
+        visibleDeliveries.map(async (delivery) => {
+          try {
+            this.log.debug(
+              `updateDelivery: '${delivery.tracking_number}' carrier=${delivery.carrier_code} status=${delivery.status_code}`
+            );
+            const carrierName = await this.client.getCarrierName(delivery.carrier_code);
+            await this.stateManager.updateDelivery(delivery, carrierName);
+            this.failedDeliveries.delete(delivery.tracking_number);
+            return this.stateManager.packageId(delivery);
+          } catch (err) {
+            const msg = (0, import_coerce.errText)(err);
+            if (this.failedDeliveries.has(delivery.tracking_number)) {
+              this.log.debug(`Failed to update "${delivery.tracking_number}": ${msg}`);
+            } else {
+              this.log.warn(`Failed to update '${delivery.tracking_number}': ${msg}`);
+              this.failedDeliveries.add(delivery.tracking_number);
+            }
+            return null;
           }
-        }
-      }
+        })
+      );
+      const activeIds = idResults.filter((id) => id !== null);
       await this.stateManager.cleanupDeliveries(activeIds);
       await this.stateManager.updateSummary(activeDeliveries);
       this.log.debug(`Polled ${visibleDeliveries.length} deliveries (${activeDeliveries.length} active)`);
@@ -238,9 +276,14 @@ class ParcelappAdapter extends utils.Adapter {
       const isRepeat = errorCode === this.lastErrorCode;
       this.lastErrorCode = errorCode;
       if (error.code === "RATE_LIMITED") {
-        const cooldownSec = error.retryAfterSeconds || 5 * 60;
+        const rawCooldown = (_a = error.retryAfterSeconds) != null ? _a : 0;
+        const cooldownSec = Number.isFinite(rawCooldown) && rawCooldown > 0 ? Math.min(24 * 3600, Math.max(60, Math.floor(rawCooldown))) : 5 * 60;
         this.rateLimitedUntil = Date.now() + cooldownSec * 1e3;
         this.log.warn(`Rate limit hit \u2014 pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`);
+      } else if (error.code === "FORBIDDEN") {
+        this.log.error(
+          "parcel.app returned 403 Forbidden \u2014 your account may not have an active Premium subscription, or the API key was revoked. Check your account on parcelapp.net."
+        );
       } else if (error.code === "INVALID_API_KEY") {
         this.log.error("Invalid API key \u2014 please check your parcel.app API key");
       } else if (isRepeat) {

package/build/main.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts"],
-  "sourcesContent": ["import * as utils from \"@iobroker/adapter-core\";\nimport { errText } from \"./lib/coerce\";\nimport { ParcelClient } from \"./lib/parcel-client\";\nimport { StateManager } from \"./lib/state-manager\";\n\nconst MIN_POLL_INTERVAL = 5;\nconst MAX_POLL_INTERVAL = 60;\nconst DEFAULT_POLL_INTERVAL = 10;\nconst MIN_POLL_GAP_MS = 60_000; // Minimum 60s between polls\n\n/** ioBroker adapter for parcel.app package tracking */\nclass ParcelappAdapter extends utils.Adapter {\n  private client: ParcelClient | null = null;\n  private stateManager: StateManager | null = null;\n  private pollTimer: ioBroker.Interval | undefined = undefined;\n  private isPolling = false;\n  private lastPollTime = 0;\n  private rateLimitedUntil = 0;\n  private lastErrorCode = \"\";\n  private failedDeliveries = new Set<string>();\n  private unhandledRejectionHandler: ((reason: unknown) => void) | null = null;\n  private uncaughtExceptionHandler: ((err: Error) => void) | null = null;\n  /** ioBroker system language \u2014 read once in `onReady` from `system.config`. EN fallback. */\n  private systemLang: string = \"en\";\n\n  /** @param options Adapter options */\n  public constructor(options: Partial<utils.AdapterOptions> = {}) {\n    super({\n      ...options,\n      name: \"parcelapp\",\n    });\n    // Wrap async handlers with .catch() so a rejection can never become an\n    // unhandled promise rejection (which would SIGKILL the adapter and trap\n    // js-controller in a restart loop without any stack trace).\n    this.on(\"ready\", () => {\n      this.onReady().catch(err => this.log.error(`onReady failed: ${errText(err)}`));\n    });\n    this.on(\"unload\", this.onUnload.bind(this));\n    this.on(\"message\", obj => {\n      this.onMessage(obj).catch(err => this.log.error(`onMessage failed: ${errText(err)}`));\n    });\n    // Last-line-of-defence against unhandled rejections / sync throws from\n    // fire-and-forget paths (e.g. `void this.poll()`). The per-handler\n    // .catch() wrappers cover the documented async paths; this catches\n    // anything that slips past during refactors.\n    this.unhandledRejectionHandler = (reason: unknown) => {\n      this.log.error(`Unhandled rejection: ${errText(reason)}`);\n    };\n    this.uncaughtExceptionHandler = (err: Error) => {\n      this.log.error(`Uncaught exception: ${errText(err)}`);\n    };\n    process.on(\"unhandledRejection\", this.unhandledRejectionHandler);\n    process.on(\"uncaughtException\", this.uncaughtExceptionHandler);\n  }\n\n  private async onReady(): Promise<void> {\n    // Pick the system language up-front so all user-facing logs go out in the\n    // user's language. StateManager also gets it for state-name localization.\n    const sysConfig = await this.getForeignObjectAsync(\"system.config\");\n    const language = (sysConfig?.common as { language?: string } | undefined)?.language ?? \"\";\n    if (typeof language === \"string\" && language.length > 0) {\n      this.systemLang = language;\n    }\n\n    await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n\n    // Validate config\n    const { apiKey } = this.config;\n    if (!apiKey || apiKey.trim().length < 10) {\n      this.log.error(\"No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings\");\n      return;\n    }\n\n    // Initialize\n    this.client = new ParcelClient(apiKey.trim());\n    this.stateManager = new StateManager(this, language);\n\n    // Cleanup obsolete states\n    await this.cleanupObsoleteStates();\n\n    // Initial poll\n    await this.poll();\n\n    // Set up recurring poll\n    const interval = Math.max(\n      MIN_POLL_INTERVAL,\n      Math.min(MAX_POLL_INTERVAL, this.config.pollInterval ?? DEFAULT_POLL_INTERVAL),\n    );\n    const intervalMs = interval * 60 * 1000;\n    this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);\n\n    this.log.info(`Parcel tracking started \u2014 polling every ${interval} minutes`);\n  }\n\n  private onUnload(callback: () => void): void {\n    try {\n      if (this.pollTimer) {\n        this.clearInterval(this.pollTimer);\n        this.pollTimer = undefined;\n      }\n      if (this.unhandledRejectionHandler) {\n        process.off(\"unhandledRejection\", this.unhandledRejectionHandler);\n        this.unhandledRejectionHandler = null;\n      }\n      if (this.uncaughtExceptionHandler) {\n        process.off(\"uncaughtException\", this.uncaughtExceptionHandler);\n        this.uncaughtExceptionHandler = null;\n      }\n      void this.setState(\"info.connection\", { val: false, ack: true });\n    } catch {\n      // ignore\n    }\n    callback();\n  }\n\n  private async onMessage(obj: ioBroker.Message): Promise<void> {\n    if (!obj?.command || !obj.callback) {\n      return;\n    }\n\n    try {\n      switch (obj.command) {\n        case \"checkConnection\": {\n          const msg = obj.message as { apiKey?: string };\n          const key = msg?.apiKey?.trim() || \"\";\n          if (!key || key.length < 10) {\n            this.sendTo(obj.from, obj.command, { success: false, message: \"API key is too short\" }, obj.callback);\n            return;\n          }\n          const testClient = new ParcelClient(key);\n          const result = await testClient.testConnection();\n          this.sendTo(obj.from, obj.command, result, obj.callback);\n          break;\n        }\n        case \"addDelivery\": {\n          if (!this.client) {\n            this.sendTo(\n              obj.from,\n              obj.command,\n              { success: false, error_message: \"Adapter not initialized\" },\n              obj.callback,\n            );\n            return;\n          }\n          const request = obj.message as {\n            tracking_number: string;\n            carrier_code: string;\n            description: string;\n          };\n          const addResult = await this.client.addDelivery(request);\n          this.sendTo(obj.from, obj.command, addResult, obj.callback);\n          if (addResult.success) {\n            void this.poll();\n          }\n          break;\n        }\n        default:\n          this.sendTo(obj.from, obj.command, { error: \"Unknown command\" }, obj.callback);\n      }\n    } catch (err) {\n      this.sendTo(obj.from, obj.command, { success: false, error_message: errText(err) }, obj.callback);\n    }\n  }\n\n  private async cleanupObsoleteStates(): Promise<void> {\n    const obsoleteStates = [\n      \"summary.json\", // removed in 0.2.0\n    ];\n    for (const stateId of obsoleteStates) {\n      const obj = await this.getObjectAsync(stateId);\n      if (obj) {\n        await this.delObjectAsync(stateId);\n        this.log.debug(`Removed obsolete state: ${stateId}`);\n      }\n    }\n  }\n\n  /**\n   * Classify an error for deduplication and log-level decisions.\n   *\n   * @param error The error to classify\n   */\n  private classifyError(error: Error & { code?: string }): string {\n    if (error.code === \"RATE_LIMITED\") {\n      return \"RATE_LIMITED\";\n    }\n    if (error.code === \"INVALID_API_KEY\") {\n      return \"INVALID_API_KEY\";\n    }\n    // Network errors: DNS, connection refused, no internet\n    if (\n      error.code === \"ENOTFOUND\" ||\n      error.code === \"ECONNREFUSED\" ||\n      error.code === \"ECONNRESET\" ||\n      error.code === \"ENETUNREACH\" ||\n      error.code === \"EHOSTUNREACH\" ||\n      error.code === \"EAI_AGAIN\"\n    ) {\n      return \"NETWORK\";\n    }\n    if (error.message.includes(\"timeout\") || error.code === \"ETIMEDOUT\") {\n      return \"TIMEOUT\";\n    }\n    return error.code || \"UNKNOWN\";\n  }\n\n  private async poll(): Promise<void> {\n    if (this.isPolling || !this.client || !this.stateManager) {\n      return;\n    }\n\n    const now = Date.now();\n\n    // Skip if rate limited\n    if (now < this.rateLimitedUntil) {\n      const waitMin = Math.ceil((this.rateLimitedUntil - now) / 60_000);\n      this.log.debug(`Skipping poll \u2014 rate limited for ${waitMin} more minute(s)`);\n      return;\n    }\n\n    // Throttle: minimum gap between polls\n    if (now - this.lastPollTime < MIN_POLL_GAP_MS) {\n      this.log.debug(\"Skipping poll \u2014 too soon after last poll\");\n      return;\n    }\n\n    this.isPolling = true;\n    this.lastPollTime = now;\n    try {\n      // When keeping delivered packages, use \"recent\" to get them from API\n      const autoRemove = this.config.autoRemoveDelivered !== false;\n      const deliveries = await this.client.getDeliveries(autoRemove ? \"active\" : \"recent\");\n\n      // Reset error state on success\n      this.rateLimitedUntil = 0;\n      if (this.lastErrorCode) {\n        this.log.info(\"Connection restored\");\n        this.lastErrorCode = \"\";\n      }\n      await this.setStateAsync(\"info.connection\", { val: true, ack: true });\n\n      // Split into active (non-delivered) and visible (what gets states)\n      const activeDeliveries = deliveries.filter(d => this.stateManager!.parseStatus(d) !== 0);\n      const visibleDeliveries = autoRemove ? activeDeliveries : deliveries;\n\n      // Update each delivery (isolated: one failure must not block others)\n      const activeIds: string[] = [];\n      for (const delivery of visibleDeliveries) {\n        try {\n          const carrierName = await this.client.getCarrierName(delivery.carrier_code);\n          await this.stateManager.updateDelivery(delivery, carrierName);\n          activeIds.push(this.stateManager.packageId(delivery));\n          this.failedDeliveries.delete(delivery.tracking_number);\n        } catch (err) {\n          const msg = errText(err);\n          if (this.failedDeliveries.has(delivery.tracking_number)) {\n            this.log.debug(`Failed to update \"${delivery.tracking_number}\": ${msg}`);\n          } else {\n            this.log.warn(`Failed to update '${delivery.tracking_number}': ${msg}`);\n            this.failedDeliveries.add(delivery.tracking_number);\n          }\n        }\n      }\n\n      // Cleanup stale deliveries\n      await this.stateManager.cleanupDeliveries(activeIds);\n\n      // Update summary (always uses active/non-delivered)\n      await this.stateManager.updateSummary(activeDeliveries);\n\n      this.log.debug(`Polled ${visibleDeliveries.length} deliveries (${activeDeliveries.length} active)`);\n    } catch (err) {\n      const error = err as Error & {\n        code?: string;\n        retryAfterSeconds?: number;\n      };\n\n      // Classify the error\n      const errorCode = this.classifyError(error);\n      const isRepeat = errorCode === this.lastErrorCode;\n      this.lastErrorCode = errorCode;\n\n      if (error.code === \"RATE_LIMITED\") {\n        const cooldownSec = error.retryAfterSeconds || 5 * 60;\n        this.rateLimitedUntil = Date.now() + cooldownSec * 1000;\n        this.log.warn(`Rate limit hit \u2014 pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`);\n      } else if (error.code === \"INVALID_API_KEY\") {\n        // Always log \u2014 user must fix config\n        this.log.error(\"Invalid API key \u2014 please check your parcel.app API key\");\n      } else if (isRepeat) {\n        // Same error as last time \u2014 don't spam the log\n        this.log.debug(`Poll failed (ongoing): ${error.message}`);\n      } else if (errorCode === \"NETWORK\") {\n        this.log.warn(\"Cannot reach parcel.app API \u2014 will keep retrying\");\n      } else if (errorCode === \"TIMEOUT\") {\n        this.log.warn(\"API request timeout \u2014 will retry next cycle\");\n      } else {\n        this.log.error(`Poll failed: ${error.message}`);\n      }\n\n      await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n    } finally {\n      this.isPolling = false;\n    }\n  }\n}\n\nif (require.main !== module) {\n  module.exports = (options: Partial<utils.AdapterOptions> | undefined) => new ParcelappAdapter(options);\n} else {\n  (() => new ParcelappAdapter())();\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as utils from \"@iobroker/adapter-core\";\nimport { coerceClampedInt, errText } from \"./lib/coerce\";\nimport { ParcelClient } from \"./lib/parcel-client\";\nimport { StateManager } from \"./lib/state-manager\";\n\nconst MIN_POLL_INTERVAL = 5;\nconst MAX_POLL_INTERVAL = 60;\nconst DEFAULT_POLL_INTERVAL = 10;\nconst MIN_POLL_GAP_MS = 60_000; // Minimum 60s between polls\n/** v0.4.2 (M6): minimum length for an apiKey value to even be considered valid. */\nconst MIN_API_KEY_LENGTH = 10;\n\n/** ioBroker adapter for parcel.app package tracking */\nclass ParcelappAdapter extends utils.Adapter {\n  private client: ParcelClient | null = null;\n  private stateManager: StateManager | null = null;\n  private pollTimer: ioBroker.Interval | undefined = undefined;\n  private isPolling = false;\n  private lastPollTime = 0;\n  private rateLimitedUntil = 0;\n  private lastErrorCode = \"\";\n  private failedDeliveries = new Set<string>();\n  private unhandledRejectionHandler: ((reason: unknown) => void) | null = null;\n  private uncaughtExceptionHandler: ((err: Error) => void) | null = null;\n  /** ioBroker system language \u2014 read once in `onReady` from `system.config`. EN fallback. */\n  private systemLang: string = \"en\";\n\n  /** @param options Adapter options */\n  public constructor(options: Partial<utils.AdapterOptions> = {}) {\n    super({\n      ...options,\n      name: \"parcelapp\",\n    });\n    // Wrap async handlers with .catch() so a rejection can never become an\n    // unhandled promise rejection (which would SIGKILL the adapter and trap\n    // js-controller in a restart loop without any stack trace).\n    this.on(\"ready\", () => {\n      this.onReady().catch(err => this.log.error(`onReady failed: ${errText(err)}`));\n    });\n    this.on(\"unload\", this.onUnload.bind(this));\n    this.on(\"message\", obj => {\n      this.onMessage(obj).catch(err => this.log.error(`onMessage failed: ${errText(err)}`));\n    });\n    // Last-line-of-defence against unhandled rejections / sync throws from\n    // fire-and-forget paths (e.g. `void this.poll()`). The per-handler\n    // .catch() wrappers cover the documented async paths; this catches\n    // anything that slips past during refactors.\n    // v0.4.2 (M1): log + terminate(11) instead of leaving the process alive\n    // in an undefined state. The per-handler wrappers cover expected paths;\n    // anything reaching here is by definition unexpected.\n    this.unhandledRejectionHandler = (reason: unknown) => {\n      this.log.error(`Unhandled rejection: ${errText(reason)}`);\n      this.terminate?.(11);\n    };\n    this.uncaughtExceptionHandler = (err: Error) => {\n      this.log.error(`Uncaught exception: ${errText(err)}`);\n      this.terminate?.(11);\n    };\n    process.on(\"unhandledRejection\", this.unhandledRejectionHandler);\n    process.on(\"uncaughtException\", this.uncaughtExceptionHandler);\n  }\n\n  private async onReady(): Promise<void> {\n    // v0.4.3 (G1): trace start of onReady so the debug log shows when the\n    // adapter starts wiring up, what the config inputs look like.\n    this.log.debug(\n      `onReady: starting (pollInterval=${JSON.stringify(this.config.pollInterval)}, autoRemoveDelivered=${this.config.autoRemoveDelivered})`,\n    );\n\n    // Pick the system language up-front so all user-facing logs go out in the\n    // user's language. StateManager also gets it for state-name localization.\n    const sysConfig = await this.getForeignObjectAsync(\"system.config\");\n    const language = (sysConfig?.common as { language?: string } | undefined)?.language ?? \"\";\n    if (typeof language === \"string\" && language.length > 0) {\n      this.systemLang = language;\n    }\n    // v0.4.3 (G2): trace the resolved system language. Empty/unknown values\n    // fall back to \"en\" silently in older versions \u2014 now visible.\n    this.log.debug(`system language: '${language}' \u2192 using '${this.systemLang}'`);\n\n    await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n\n    // Validate config\n    const { apiKey } = this.config;\n    if (!apiKey || apiKey.trim().length < MIN_API_KEY_LENGTH) {\n      this.log.error(\"No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings\");\n      return;\n    }\n\n    // Initialize. v0.4.3: pass a debug-logger so the HTTPS layer can trace\n    // request/response lifecycle. `loglevel=info` users see nothing changed.\n    this.client = new ParcelClient(apiKey.trim(), { debug: (m: string) => this.log.debug(m) });\n    this.stateManager = new StateManager(this, language);\n\n    // Cleanup obsolete states\n    await this.cleanupObsoleteStates();\n\n    // Initial poll\n    await this.poll();\n\n    // v0.4.2 (M5): coerce explicitly. Admin can store `pollInterval` as a\n    // string; `Math.min(60, \"10\")` happens to coerce, but `Math.max(5,\n    // undefined)` returns NaN, and `setInterval(fn, NaN)` becomes\n    // `setInterval(fn, 0)` \u2014 a tight loop that hammers the API.\n    const interval = ParcelappAdapter.coercePollInterval(this.config.pollInterval);\n    // v0.4.3 (G3): always-log the resolved interval. Detecting \"drift\" from\n    // the raw value is fragile (`\"10\"` \u2192 `10` is not drift, just coercion);\n    // an always-on log line keeps the resolution visible without false-flag\n    // logic. See `Ressourcen/parcelapp/v0.4.3-debug-audit.md` advisor pt 3.\n    this.log.debug(`pollInterval: raw=${JSON.stringify(this.config.pollInterval)} resolved=${interval}min`);\n    const intervalMs = interval * 60 * 1000;\n    this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);\n\n    this.log.info(`Parcel tracking started \u2014 polling every ${interval} minutes`);\n  }\n\n  /**\n   * v0.4.2 (M5+X5): delegate to the shared `coerceClampedInt` helper.\n   *\n   * @param raw Raw `pollInterval` from admin config (number or numeric string).\n   */\n  private static coercePollInterval(raw: unknown): number {\n    return coerceClampedInt(raw, MIN_POLL_INTERVAL, MAX_POLL_INTERVAL, DEFAULT_POLL_INTERVAL);\n  }\n\n  private onUnload(callback: () => void): void {\n    try {\n      if (this.pollTimer) {\n        this.clearInterval(this.pollTimer);\n        this.pollTimer = undefined;\n      }\n      // v0.4.2 (M11+P1): cancel every in-flight HTTPS request so a slow\n      // parcel.app endpoint doesn't keep the adapter alive past\n      // js-controller's 4-second kill deadline.\n      this.client?.cancelAll();\n      if (this.unhandledRejectionHandler) {\n        process.off(\"unhandledRejection\", this.unhandledRejectionHandler);\n        this.unhandledRejectionHandler = null;\n      }\n      if (this.uncaughtExceptionHandler) {\n        process.off(\"uncaughtException\", this.uncaughtExceptionHandler);\n        this.uncaughtExceptionHandler = null;\n      }\n      // v0.4.2 (M10): explicit `.catch(() => {})` on the fire-and-forget so\n      // a broker-already-down doesn't leak as an unhandled rejection.\n      void this.setState(\"info.connection\", { val: false, ack: true }).catch(() => {\n        /* broker is shutting down \u2014 ignore */\n      });\n    } catch (err) {\n      // v0.4.3 (G4): replace silent `// ignore` with a trace so shutdown\n      // errors leave a debug breadcrumb. Broker-already-down errors here\n      // are expected \u2014 debug-level keeps them out of the user log.\n      this.log.debug(`onUnload error (ignored): ${errText(err)}`);\n    }\n    callback();\n  }\n\n  private async onMessage(obj: ioBroker.Message): Promise<void> {\n    // v0.4.3 (F1): entry log BEFORE the early-return \u2014 broadcast messages\n    // without callback wouldn't be visible otherwise.\n    this.log.debug(`onMessage: command='${obj?.command}' from='${obj?.from}' has-callback=${!!obj?.callback}`);\n    if (!obj?.command || !obj.callback) {\n      return;\n    }\n\n    try {\n      switch (obj.command) {\n        case \"checkConnection\": {\n          const msg = obj.message as { apiKey?: string };\n          const key = msg?.apiKey?.trim() || \"\";\n          if (!key || key.length < MIN_API_KEY_LENGTH) {\n            // v0.4.3 (F2): trace the reject before sendTo.\n            this.log.debug(\"checkConnection: apiKey too short\");\n            this.sendTo(obj.from, obj.command, { success: false, message: \"API key is too short\" }, obj.callback);\n            return;\n          }\n          // v0.4.3: same debug-logger as the prod client so checkConnection\n          // failures get the same HTTPS-layer trace.\n          const testClient = new ParcelClient(key, { debug: (m: string) => this.log.debug(m) });\n          const result = await testClient.testConnection();\n          // v0.4.3 (F3): trace checkConnection result.\n          this.log.debug(`checkConnection: result=${result.success ? \"ok\" : \"fail\"} (${result.message})`);\n          this.sendTo(obj.from, obj.command, result, obj.callback);\n          break;\n        }\n        case \"addDelivery\": {\n          if (!this.client) {\n            // v0.4.3 (F4): trace addDelivery-before-init.\n            this.log.debug(\"addDelivery: adapter not initialized\");\n            this.sendTo(\n              obj.from,\n              obj.command,\n              { success: false, error_message: \"Adapter not initialized\" },\n              obj.callback,\n            );\n            return;\n          }\n          const request = obj.message as {\n            tracking_number: string;\n            carrier_code: string;\n            description: string;\n          };\n          const addResult = await this.client.addDelivery(request);\n          // v0.4.3 (F5): trace addDelivery result with the tracking number.\n          this.log.debug(`addDelivery: '${request?.tracking_number}' result=${addResult.success ? \"ok\" : \"fail\"}`);\n          this.sendTo(obj.from, obj.command, addResult, obj.callback);\n          if (addResult.success) {\n            void this.poll();\n          }\n          break;\n        }\n        default:\n          // v0.4.3 (F6): trace unknown command before sendTo.\n          this.log.debug(`onMessage: unknown command '${obj.command}'`);\n          this.sendTo(obj.from, obj.command, { error: \"Unknown command\" }, obj.callback);\n      }\n    } catch (err) {\n      // v0.4.3 (F7): trace catch so the debug log shows what failed.\n      // The sendTo back to the caller is preserved unchanged.\n      this.log.debug(`onMessage: '${obj.command}' failed: ${errText(err)}`);\n      this.sendTo(obj.from, obj.command, { success: false, error_message: errText(err) }, obj.callback);\n    }\n  }\n\n  private async cleanupObsoleteStates(): Promise<void> {\n    const obsoleteStates = [\n      \"summary.json\", // removed in 0.2.0\n    ];\n    for (const stateId of obsoleteStates) {\n      const obj = await this.getObjectAsync(stateId);\n      if (obj) {\n        await this.delObjectAsync(stateId);\n        this.log.debug(`Removed obsolete state: ${stateId}`);\n      }\n    }\n  }\n\n  /**\n   * Classify an error for deduplication and log-level decisions.\n   *\n   * @param error The error to classify\n   */\n  private classifyError(error: Error & { code?: string }): string {\n    if (error.code === \"RATE_LIMITED\") {\n      return \"RATE_LIMITED\";\n    }\n    if (error.code === \"INVALID_API_KEY\") {\n      return \"INVALID_API_KEY\";\n    }\n    // v0.4.2 (P3): 403 is a permission issue, distinct from invalid api-key.\n    if (error.code === \"FORBIDDEN\") {\n      return \"FORBIDDEN\";\n    }\n    // Network errors: DNS, connection refused, no internet\n    if (\n      error.code === \"ENOTFOUND\" ||\n      error.code === \"ECONNREFUSED\" ||\n      error.code === \"ECONNRESET\" ||\n      error.code === \"ENETUNREACH\" ||\n      error.code === \"EHOSTUNREACH\" ||\n      error.code === \"EAI_AGAIN\"\n    ) {\n      return \"NETWORK\";\n    }\n    if (error.message.includes(\"timeout\") || error.code === \"ETIMEDOUT\") {\n      return \"TIMEOUT\";\n    }\n    return error.code || \"UNKNOWN\";\n  }\n\n  private async poll(): Promise<void> {\n    if (this.isPolling || !this.client || !this.stateManager) {\n      return;\n    }\n\n    const now = Date.now();\n    // v0.4.3 (B1): poll-entry anchor \u2014 visible after the re-entry guard but\n    // before the rate-limit/throttle skips. Shows mode + current error state\n    // so the debug log gives context for whatever follows.\n    const autoRemoveMode = this.config.autoRemoveDelivered !== false;\n    this.log.debug(`poll: starting (autoRemove=${autoRemoveMode}, lastErrorCode='${this.lastErrorCode}')`);\n\n    // Skip if rate limited\n    if (now < this.rateLimitedUntil) {\n      const waitMin = Math.ceil((this.rateLimitedUntil - now) / 60_000);\n      this.log.debug(`Skipping poll \u2014 rate limited for ${waitMin} more minute(s)`);\n      return;\n    }\n\n    // Throttle: minimum gap between polls\n    if (now - this.lastPollTime < MIN_POLL_GAP_MS) {\n      this.log.debug(\"Skipping poll \u2014 too soon after last poll\");\n      return;\n    }\n\n    this.isPolling = true;\n    this.lastPollTime = now;\n    try {\n      // When keeping delivered packages, use \"recent\" to get them from API\n      const deliveries = await this.client.getDeliveries(autoRemoveMode ? \"active\" : \"recent\");\n\n      // Reset error state on success\n      this.rateLimitedUntil = 0;\n      if (this.lastErrorCode) {\n        this.log.info(\"Connection restored\");\n        this.lastErrorCode = \"\";\n      }\n      await this.setStateAsync(\"info.connection\", { val: true, ack: true });\n\n      // Split into active (non-delivered) and visible (what gets states)\n      const activeDeliveries = deliveries.filter(d => this.stateManager!.parseStatus(d) !== 0);\n      const visibleDeliveries = autoRemoveMode ? activeDeliveries : deliveries;\n\n      // v0.4.2 (S3): reset per-poll collision tracker so the bare-id wins\n      // for the first occurrence in this poll (deterministic, back-compat).\n      this.stateManager.resetPollState();\n\n      // v0.4.2 (M4): per-delivery updates run in parallel, each wrapped in\n      // try/catch so one bad delivery doesn't poison the others.\n      const idResults = await Promise.all(\n        visibleDeliveries.map(async delivery => {\n          try {\n            // v0.4.3 (C1): per-delivery entry. ~10 packages \u00D7 144 polls/day\n            // = ~1440 debug lines/day \u2014 acceptable at debug-level. Line stays\n            // short (tracking + carrier + status only, no full delivery JSON).\n            this.log.debug(\n              `updateDelivery: '${delivery.tracking_number}' carrier=${delivery.carrier_code} status=${delivery.status_code}`,\n            );\n            const carrierName = await this.client!.getCarrierName(delivery.carrier_code);\n            await this.stateManager!.updateDelivery(delivery, carrierName);\n            this.failedDeliveries.delete(delivery.tracking_number);\n            return this.stateManager!.packageId(delivery);\n          } catch (err) {\n            const msg = errText(err);\n            if (this.failedDeliveries.has(delivery.tracking_number)) {\n              this.log.debug(`Failed to update \"${delivery.tracking_number}\": ${msg}`);\n            } else {\n              this.log.warn(`Failed to update '${delivery.tracking_number}': ${msg}`);\n              this.failedDeliveries.add(delivery.tracking_number);\n            }\n            return null;\n          }\n        }),\n      );\n      const activeIds = idResults.filter((id): id is string => id !== null);\n\n      // Cleanup stale deliveries\n      await this.stateManager.cleanupDeliveries(activeIds);\n\n      // Update summary (always uses active/non-delivered)\n      await this.stateManager.updateSummary(activeDeliveries);\n\n      this.log.debug(`Polled ${visibleDeliveries.length} deliveries (${activeDeliveries.length} active)`);\n    } catch (err) {\n      const error = err as Error & {\n        code?: string;\n        retryAfterSeconds?: number;\n      };\n\n      // Classify the error\n      const errorCode = this.classifyError(error);\n      const isRepeat = errorCode === this.lastErrorCode;\n      this.lastErrorCode = errorCode;\n\n      if (error.code === \"RATE_LIMITED\") {\n        // v0.4.2 (M9): clamp Retry-After value into [60s, 24h]. A bogus 0,\n        // negative, or fractional value used to either wipe the cooldown\n        // (set rateLimitedUntil to past) or set it for fractions of a\n        // second \u2014 neither is the intended behavior.\n        const rawCooldown = error.retryAfterSeconds ?? 0;\n        const cooldownSec =\n          Number.isFinite(rawCooldown) && rawCooldown > 0\n            ? Math.min(24 * 3600, Math.max(60, Math.floor(rawCooldown)))\n            : 5 * 60;\n        this.rateLimitedUntil = Date.now() + cooldownSec * 1000;\n        this.log.warn(`Rate limit hit \u2014 pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`);\n      } else if (error.code === \"FORBIDDEN\") {\n        // v0.4.2 (P3): 403 is a permission issue (e.g. Premium subscription\n        // expired). Reauth wouldn't help \u2014 surface a clear hint.\n        this.log.error(\n          \"parcel.app returned 403 Forbidden \u2014 your account may not have an active Premium subscription, or the API key was revoked. Check your account on parcelapp.net.\",\n        );\n      } else if (error.code === \"INVALID_API_KEY\") {\n        // Always log \u2014 user must fix config\n        this.log.error(\"Invalid API key \u2014 please check your parcel.app API key\");\n      } else if (isRepeat) {\n        // Same error as last time \u2014 don't spam the log\n        this.log.debug(`Poll failed (ongoing): ${error.message}`);\n      } else if (errorCode === \"NETWORK\") {\n        this.log.warn(\"Cannot reach parcel.app API \u2014 will keep retrying\");\n      } else if (errorCode === \"TIMEOUT\") {\n        this.log.warn(\"API request timeout \u2014 will retry next cycle\");\n      } else {\n        this.log.error(`Poll failed: ${error.message}`);\n      }\n\n      await this.setStateAsync(\"info.connection\", { val: false, ack: true });\n    } finally {\n      this.isPolling = false;\n    }\n  }\n}\n\nif (require.main !== module) {\n  module.exports = (options: Partial<utils.AdapterOptions> | undefined) => new ParcelappAdapter(options);\n} else {\n  (() => new ParcelappAdapter())();\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "parcelapp",
-    "version": "0.4.1",
+    "version": "0.4.3",
     "news": {
+      "0.4.3": {
+        "en": "Debug log traces previously silent paths: HTTPS request lifecycle, carrier-list fetch outcome, per-delivery updates, admin-message handling. Default log unchanged.",
+        "de": "Debug-Log dokumentiert stille Pfade: HTTPS-Request-Lifecycle, Carrier-Liste, Per-Paket-Updates und Admin-Message-Handling. Default-Log unverändert.",
+        "ru": "Журнал отладки прослеживает тихие пути: цикл HTTPS-запроса, получение списка перевозчиков, обновления посылок и обработка сообщений. Стандартный лог не изменился.",
+        "pt": "Log de depuração rastreia caminhos silenciosos: ciclo HTTPS, lista de transportadoras, atualizações por encomenda e mensagens admin. Log padrão inalterado.",
+        "nl": "Debug-log volgt stille paden: HTTPS-cyclus, vervoerderslijst, pakketupdates en admin-berichten. Standaard log ongewijzigd.",
+        "fr": "Le journal de débogage trace les chemins silencieux : cycle HTTPS, liste des transporteurs, mises à jour de colis et messages admin. Journal par défaut inchangé.",
+        "it": "Log di debug traccia percorsi silenziosi: ciclo HTTPS, elenco corrieri, aggiornamenti pacchi e messaggi admin. Log predefinito invariato.",
+        "es": "Log de depuración rastrea rutas silenciosas: ciclo HTTPS, lista de transportistas, actualizaciones de paquetes y mensajes de admin. Log por defecto sin cambios.",
+        "pl": "Log debugowania śledzi ciche ścieżki: cykl HTTPS, lista przewoźników, aktualizacje paczek i wiadomości admin. Domyślny log bez zmian.",
+        "uk": "Журнал зневадження відстежує тихі шляхи: цикл HTTPS, список перевізників, оновлення посилок та повідомлення адміна. Стандартний лог без змін.",
+        "zh-cn": "调试日志跟踪以前静默的路径：HTTPS 请求生命周期、承运商列表、每个包裹更新以及管理消息处理。默认日志保持不变。"
+      },
+      "0.4.2": {
+        "en": "Adapter shuts down cleanly when parcel.app is slow, 403 Forbidden gives a 'check Premium' hint instead of reauth-loop, two trackings with the same sanitized id no longer overwrite.",
+        "de": "Adapter beendet sauber wenn parcel.app langsam ist, 403-Fehler liefert 'Premium prüfen'-Hinweis statt Reauth-Loop, und zwei Trackings mit identischer Sanitize-ID überschreiben sich nicht mehr.",
+        "ru": "Адаптер корректно завершается при медленной parcel.app, 403 даёт подсказку 'проверьте Premium' вместо цикла переавторизации, два трекинга с одинаковым ID больше не перезаписываются.",
+        "pt": "O adaptador encerra de forma limpa quando o parcel.app está lento, 403 mostra dica 'verificar Premium' em vez de re-autenticar em loop, dois rastreios com o mesmo ID já não se sobrescrevem.",
+        "nl": "Adapter sluit netjes af als parcel.app traag is, 403 geeft 'Premium controleren'-hint in plaats van reauth-loop, en twee trackings met dezelfde id overschrijven elkaar niet meer.",
+        "fr": "L'adaptateur s'arrête proprement quand parcel.app est lent, un 403 donne 'vérifier Premium' au lieu de boucler la réauth, et deux suivis avec le même id ne s'écrasent plus.",
+        "it": "L'adapter si arresta correttamente quando parcel.app è lento, un 403 mostra 'controlla Premium' invece di un loop di reauth, due tracciamenti con lo stesso id non si sovrascrivono più.",
+        "es": "El adaptador se cierra limpiamente cuando parcel.app va lento, 403 muestra 'verificar Premium' en vez de bucle de reauth, y dos seguimientos con el mismo id ya no se sobrescriben.",
+        "pl": "Adapter zamyka się czysto, gdy parcel.app jest powolny, 403 daje wskazówkę 'sprawdź Premium' zamiast pętli reauth, dwa śledzenia z tym samym id już się nie nadpisują.",
+        "uk": "Адаптер коректно вимикається при повільному parcel.app, 403 дає підказку 'перевірте Premium' замість циклу входу, два трекінги з однаковим id більше не перезаписуються.",
+        "zh-cn": "当 parcel.app 响应缓慢时，适配器现在能干净退出（终止进行中的请求）。403 错误会提示检查 Premium 订阅，而不是反复重新认证。两个清洗后 ID 相同的快递不再互相覆盖。"
+      },
       "0.4.1": {
         "en": "Adapter log messages are now English only, in line with the ioBroker community standard. Localized state names (11 languages) remain unchanged.",
         "de": "Adapter-Logs sind jetzt nur noch auf Englisch, gemäß ioBroker-Community-Standard. Lokalisierte Datenpunkt-Namen (11 Sprachen) bleiben erhalten.",
@@ -67,32 +93,6 @@
         "pl": "Wewnętrzne porządki. Brak zmian widocznych dla użytkownika.",
         "uk": "Внутрішнє прибирання. Без помітних для користувача змін.",
         "zh-cn": "内部清理。对用户无可见变化。"
-      },
-      "0.2.18": {
-        "en": "Internal cleanup. No user-facing changes.",
-        "de": "Interne Bereinigung. Keine User-sichtbaren Änderungen.",
-        "ru": "Внутренняя очистка. Без видимых изменений для пользователя.",
-        "pt": "Limpeza interna. Sem alterações visíveis para o usuário.",
-        "nl": "Interne opschoning. Geen wijzigingen voor de gebruiker.",
-        "fr": "Nettoyage interne. Aucune modification visible pour l'utilisateur.",
-        "it": "Pulizia interna. Nessuna modifica visibile all'utente.",
-        "es": "Limpieza interna. Sin cambios visibles para el usuario.",
-        "pl": "Wewnętrzne porządki. Brak zmian widocznych dla użytkownika.",
-        "uk": "Внутрішнє прибирання. Без помітних для користувача змін.",
-        "zh-cn": "内部清理。对用户无可见变化。"
-      },
-      "0.2.17": {
-        "en": "Internal cleanup. No user-facing changes.",
-        "de": "Interne Bereinigung. Keine User-sichtbaren Änderungen.",
-        "ru": "Внутренняя очистка. Без видимых изменений для пользователя.",
-        "pt": "Limpeza interna. Sem alterações visíveis para o usuário.",
-        "nl": "Interne opschoning. Geen wijzigingen voor de gebruiker.",
-        "fr": "Nettoyage interne. Aucune modification visible pour l'utilisateur.",
-        "it": "Pulizia interna. Nessuna modifica visibile all'utente.",
-        "es": "Limpieza interna. Sin cambios visibles para el usuario.",
-        "pl": "Wewnętrzne porządki. Brak zmian widocznych dla użytkownika.",
-        "uk": "Внутрішнє прибирання. Без помітних для користувача змін.",
-        "zh-cn": "内部清理。对用户无可见变化。"
       }
     },
     "titleLang": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.parcelapp",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "ioBroker adapter for the parcel.app API",
   "author": {
     "name": "krobi",