iobroker.parcelapp 0.2.2 → 0.2.4

package/build/lib/types.js

@@ -1,27 +1,52 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATUS_LABELS_EN = exports.STATUS_LABELS_DE = void 0;
-/** Delivery status codes (0-8) in German */
-exports.STATUS_LABELS_DE = {
-    0: "Zugestellt",
-    1: "Eingefroren",
-    2: "Unterwegs",
-    3: "Abholung erwartet",
-    4: "In Zustellung",
-    5: "Nicht gefunden",
-    6: "Zustellversuch gescheitert",
-    7: "Ausnahme",
-    8: "Registriert",
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
 };
-/** Delivery status codes (0-8) in English */
-exports.STATUS_LABELS_EN = {
-    0: "Delivered",
-    1: "Frozen",
-    2: "In Transit",
-    3: "Awaiting Pickup",
-    4: "Out for Delivery",
-    5: "Not Found",
-    6: "Delivery Attempt Failed",
-    7: "Exception",
-    8: "Info Received",
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+__export(types_exports, {
+  STATUS_LABELS_DE: () => STATUS_LABELS_DE,
+  STATUS_LABELS_EN: () => STATUS_LABELS_EN
+});
+module.exports = __toCommonJS(types_exports);
+const STATUS_LABELS_DE = {
+  0: "Zugestellt",
+  1: "Eingefroren",
+  2: "Unterwegs",
+  3: "Abholung erwartet",
+  4: "In Zustellung",
+  5: "Nicht gefunden",
+  6: "Zustellversuch gescheitert",
+  7: "Ausnahme",
+  8: "Registriert"
+};
+const STATUS_LABELS_EN = {
+  0: "Delivered",
+  1: "Frozen",
+  2: "In Transit",
+  3: "Awaiting Pickup",
+  4: "Out for Delivery",
+  5: "Not Found",
+  6: "Delivery Attempt Failed",
+  7: "Exception",
+  8: "Info Received"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  STATUS_LABELS_DE,
+  STATUS_LABELS_EN
+});
+//# sourceMappingURL=types.js.map

package/build/lib/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/types.ts"],
+  "sourcesContent": ["/** API response from parcel.app deliveries endpoint */\nexport interface ParcelApiResponse {\n  /** Whether the request was successful */\n  success: boolean;\n  /** Error message if request failed */\n  error_message?: string;\n  /** Error code if request failed */\n  error_code?: string;\n  /** List of deliveries */\n  deliveries?: ParcelDelivery[];\n}\n\n/** Single delivery from the parcel.app API */\nexport interface ParcelDelivery {\n  /** Carrier identifier */\n  carrier_code: string;\n  /** User-defined description */\n  description: string;\n  /** Status code (0-8 as string) */\n  status_code: string;\n  /** Tracking number */\n  tracking_number: string;\n  /** Extra info (postal code, email) */\n  extra_information?: string;\n  /** Expected delivery date */\n  date_expected?: string;\n  /** Expected delivery date end */\n  date_expected_end?: string;\n  /** Expected delivery Unix timestamp */\n  timestamp_expected?: number;\n  /** Expected delivery end Unix timestamp */\n  timestamp_expected_end?: number;\n  /** Tracking events (newest first) */\n  events?: ParcelEvent[];\n}\n\n/** Single tracking event */\nexport interface ParcelEvent {\n  /** Event description */\n  event: string;\n  /** Event date string */\n  date: string;\n  /** Event location */\n  location?: string;\n  /** Additional details */\n  additional?: string;\n}\n\n/** Request body for adding a delivery */\nexport interface AddDeliveryRequest {\n  /** Tracking number to add */\n  tracking_number: string;\n  /** Carrier code */\n  carrier_code: string;\n  /** User description */\n  description: string;\n  /** Tracking language */\n  language?: string;\n  /** Send push confirmation */\n  send_push_confirmation?: boolean;\n}\n\n/** Add delivery API response */\nexport interface AddDeliveryResponse {\n  /** Whether the delivery was added */\n  success: boolean;\n  /** Error message if failed */\n  error_message?: string;\n}\n\n/** Carrier names mapping (carrier_code \u2192 display name) */\nexport type CarrierMap = Record<string, string>;\n\n/** Delivery status codes (0-8) in German */\nexport const STATUS_LABELS_DE: Record<number, string> = {\n  0: \"Zugestellt\",\n  1: \"Eingefroren\",\n  2: \"Unterwegs\",\n  3: \"Abholung erwartet\",\n  4: \"In Zustellung\",\n  5: \"Nicht gefunden\",\n  6: \"Zustellversuch gescheitert\",\n  7: \"Ausnahme\",\n  8: \"Registriert\",\n};\n\n/** Delivery status codes (0-8) in English */\nexport const STATUS_LABELS_EN: Record<number, string> = {\n  0: \"Delivered\",\n  1: \"Frozen\",\n  2: \"In Transit\",\n  3: \"Awaiting Pickup\",\n  4: \"Out for Delivery\",\n  5: \"Not Found\",\n  6: \"Delivery Attempt Failed\",\n  7: \"Exception\",\n  8: \"Info Received\",\n};\n\n// Augment the ioBroker global namespace\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace ioBroker {\n    interface AdapterConfig {\n      /** parcel.app API key */\n      apiKey: string;\n      /** Polling interval in minutes */\n      pollInterval: number;\n      /** Language for status labels */\n      language: \"de\" | \"en\";\n      /** Automatically remove delivered packages from states */\n      autoRemoveDelivered: boolean;\n    }\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0EO,MAAM,mBAA2C;AAAA,EACtD,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAGO,MAAM,mBAA2C;AAAA,EACtD,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;",
+  "names": []
+}

package/build/main.js

@@ -1,259 +1,253 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-const utils = __importStar(require("@iobroker/adapter-core"));
-const parcel_client_1 = require("./lib/parcel-client");
-const state_manager_1 = require("./lib/state-manager");
-require("./lib/types");
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var utils = __toESM(require("@iobroker/adapter-core"));
+var import_parcel_client = require("./lib/parcel-client");
+var import_state_manager = require("./lib/state-manager");
+var import_types = require("./lib/types");
 const MIN_POLL_INTERVAL = 5;
 const MAX_POLL_INTERVAL = 60;
 const DEFAULT_POLL_INTERVAL = 10;
-const MIN_POLL_GAP_MS = 60_000; // Minimum 60s between polls
-/** ioBroker adapter for parcel.app package tracking */
+const MIN_POLL_GAP_MS = 6e4;
 class ParcelappAdapter extends utils.Adapter {
-    client = null;
-    stateManager = null;
-    pollTimer = undefined;
-    isPolling = false;
-    lastPollTime = 0;
-    rateLimitedUntil = 0;
-    lastErrorCode = "";
-    /** @param options Adapter options */
-    constructor(options = {}) {
-        super({
-            ...options,
-            name: "parcelapp",
-        });
-        this.on("ready", this.onReady.bind(this));
-        this.on("unload", this.onUnload.bind(this));
-        this.on("message", this.onMessage.bind(this));
+  client = null;
+  stateManager = null;
+  pollTimer = void 0;
+  isPolling = false;
+  lastPollTime = 0;
+  rateLimitedUntil = 0;
+  lastErrorCode = "";
+  /** @param options Adapter options */
+  constructor(options = {}) {
+    super({
+      ...options,
+      name: "parcelapp"
+    });
+    this.on("ready", this.onReady.bind(this));
+    this.on("unload", this.onUnload.bind(this));
+    this.on("message", this.onMessage.bind(this));
+  }
+  async onReady() {
+    var _a;
+    await this.setStateAsync("info.connection", { val: false, ack: true });
+    const { apiKey } = this.config;
+    if (!apiKey || apiKey.trim().length < 10) {
+      this.log.error(
+        "No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings"
+      );
+      return;
     }
-    async onReady() {
-        await this.setStateAsync("info.connection", { val: false, ack: true });
-        // Validate config
-        const { apiKey } = this.config;
-        if (!apiKey || apiKey.trim().length < 10) {
-            this.log.error("No valid API key configured — please enter your parcel.app API key in the adapter settings");
-            return;
-        }
-        // Initialize
-        this.client = new parcel_client_1.ParcelClient(apiKey.trim());
-        this.stateManager = new state_manager_1.StateManager(this);
-        // Cleanup obsolete states
-        await this.cleanupObsoleteStates();
-        // Initial poll
-        await this.poll();
-        // Set up recurring poll
-        const interval = Math.max(MIN_POLL_INTERVAL, Math.min(MAX_POLL_INTERVAL, this.config.pollInterval ?? DEFAULT_POLL_INTERVAL));
-        const intervalMs = interval * 60 * 1000;
-        this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);
-        this.log.info(`Parcel tracking started — polling every ${interval} minutes`);
+    this.client = new import_parcel_client.ParcelClient(apiKey.trim());
+    this.stateManager = new import_state_manager.StateManager(this);
+    await this.cleanupObsoleteStates();
+    await this.poll();
+    const interval = Math.max(
+      MIN_POLL_INTERVAL,
+      Math.min(
+        MAX_POLL_INTERVAL,
+        (_a = this.config.pollInterval) != null ? _a : DEFAULT_POLL_INTERVAL
+      )
+    );
+    const intervalMs = interval * 60 * 1e3;
+    this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);
+    this.log.info(
+      `Parcel tracking started \u2014 polling every ${interval} minutes`
+    );
+  }
+  onUnload(callback) {
+    if (this.pollTimer) {
+      this.clearInterval(this.pollTimer);
+      this.pollTimer = void 0;
     }
-    onUnload(callback) {
-        if (this.pollTimer) {
-            this.clearInterval(this.pollTimer);
-            this.pollTimer = undefined;
-        }
-        void this.setState("info.connection", { val: false, ack: true });
-        callback();
+    void this.setState("info.connection", { val: false, ack: true });
+    callback();
+  }
+  async onMessage(obj) {
+    var _a;
+    if (!(obj == null ? void 0 : obj.command)) {
+      return;
     }
-    async onMessage(obj) {
-        if (!obj?.command) {
-            return;
+    switch (obj.command) {
+      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) {
+          this.sendTo(
+            obj.from,
+            obj.command,
+            {
+              success: false,
+              message: "API key is too short"
+            },
+            obj.callback
+          );
+          return;
         }
-        switch (obj.command) {
-            case "checkConnection": {
-                const msg = obj.message;
-                const key = msg?.apiKey?.trim() || "";
-                if (!key || key.length < 10) {
-                    this.sendTo(obj.from, obj.command, {
-                        success: false,
-                        message: "API key is too short",
-                    }, obj.callback);
-                    return;
-                }
-                const testClient = new parcel_client_1.ParcelClient(key);
-                const result = await testClient.testConnection();
-                this.sendTo(obj.from, obj.command, result, obj.callback);
-                break;
-            }
-            case "addDelivery": {
-                if (!this.client) {
-                    this.sendTo(obj.from, obj.command, {
-                        success: false,
-                        error_message: "Adapter not initialized",
-                    }, obj.callback);
-                    return;
-                }
-                const request = obj.message;
-                const addResult = await this.client.addDelivery(request);
-                this.sendTo(obj.from, obj.command, addResult, obj.callback);
-                if (addResult.success) {
-                    // Trigger immediate poll to pick up the new delivery
-                    void this.poll();
-                }
-                break;
-            }
-            default:
-                this.sendTo(obj.from, obj.command, { error: "Unknown command" }, obj.callback);
+        const testClient = new import_parcel_client.ParcelClient(key);
+        const result = await testClient.testConnection();
+        this.sendTo(obj.from, obj.command, result, obj.callback);
+        break;
+      }
+      case "addDelivery": {
+        if (!this.client) {
+          this.sendTo(
+            obj.from,
+            obj.command,
+            {
+              success: false,
+              error_message: "Adapter not initialized"
+            },
+            obj.callback
+          );
+          return;
         }
-    }
-    async cleanupObsoleteStates() {
-        const obsoleteStates = [
-            "summary.json", // removed in 0.2.0
-        ];
-        for (const stateId of obsoleteStates) {
-            const obj = await this.getObjectAsync(stateId);
-            if (obj) {
-                await this.delObjectAsync(stateId);
-                this.log.debug(`Removed obsolete state: ${stateId}`);
-            }
+        const request = obj.message;
+        const addResult = await this.client.addDelivery(request);
+        this.sendTo(obj.from, obj.command, addResult, obj.callback);
+        if (addResult.success) {
+          void this.poll();
         }
+        break;
+      }
+      default:
+        this.sendTo(
+          obj.from,
+          obj.command,
+          { error: "Unknown command" },
+          obj.callback
+        );
     }
-    /**
-     * Classify an error for deduplication and log-level decisions.
-     *
-     * @param error The error to classify
-     */
-    classifyError(error) {
-        if (error.code === "RATE_LIMITED") {
-            return "RATE_LIMITED";
-        }
-        if (error.code === "INVALID_API_KEY") {
-            return "INVALID_API_KEY";
-        }
-        // Network errors: DNS, connection refused, no internet
-        if (error.code === "ENOTFOUND" ||
-            error.code === "ECONNREFUSED" ||
-            error.code === "ECONNRESET" ||
-            error.code === "ENETUNREACH" ||
-            error.code === "EAI_AGAIN") {
-            return "NETWORK";
-        }
-        if (error.message.includes("timeout") || error.code === "ETIMEDOUT") {
-            return "TIMEOUT";
-        }
-        return error.code || "UNKNOWN";
+  }
+  async cleanupObsoleteStates() {
+    const obsoleteStates = [
+      "summary.json"
+      // removed in 0.2.0
+    ];
+    for (const stateId of obsoleteStates) {
+      const obj = await this.getObjectAsync(stateId);
+      if (obj) {
+        await this.delObjectAsync(stateId);
+        this.log.debug(`Removed obsolete state: ${stateId}`);
+      }
     }
-    async poll() {
-        if (this.isPolling || !this.client || !this.stateManager) {
-            return;
-        }
-        const now = Date.now();
-        // Skip if rate limited
-        if (now < this.rateLimitedUntil) {
-            const waitMin = Math.ceil((this.rateLimitedUntil - now) / 60_000);
-            this.log.debug(`Skipping poll — rate limited for ${waitMin} more minute(s)`);
-            return;
-        }
-        // Throttle: minimum gap between polls
-        if (now - this.lastPollTime < MIN_POLL_GAP_MS) {
-            this.log.debug("Skipping poll — too soon after last poll");
-            return;
-        }
-        this.isPolling = true;
-        this.lastPollTime = now;
-        try {
-            // When keeping delivered packages, use "recent" to get them from API
-            const autoRemove = this.config.autoRemoveDelivered !== false;
-            const deliveries = await this.client.getDeliveries(autoRemove ? "active" : "recent");
-            // Reset error state on success
-            this.rateLimitedUntil = 0;
-            if (this.lastErrorCode) {
-                this.log.info("Connection restored");
-                this.lastErrorCode = "";
-            }
-            await this.setStateAsync("info.connection", { val: true, ack: true });
-            // Filter deliveries based on auto-remove setting
-            const visibleDeliveries = autoRemove
-                ? deliveries.filter((d) => parseInt(d.status_code, 10) !== 0)
-                : deliveries;
-            // Update each delivery
-            const activeIds = [];
-            for (const delivery of visibleDeliveries) {
-                const carrierName = await this.client.getCarrierName(delivery.carrier_code);
-                await this.stateManager.updateDelivery(delivery, carrierName);
-                activeIds.push(this.stateManager.packageId(delivery));
-            }
-            // Cleanup stale deliveries
-            await this.stateManager.cleanupDeliveries(activeIds);
-            // Update summary
-            const summaryDeliveries = autoRemove
-                ? visibleDeliveries
-                : deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);
-            await this.stateManager.updateSummary(summaryDeliveries);
-            this.log.debug(`Polled ${visibleDeliveries.length} deliveries (${summaryDeliveries.length} active)`);
-        }
-        catch (err) {
-            const error = err;
-            // Classify the error
-            const errorCode = this.classifyError(error);
-            const isRepeat = errorCode === this.lastErrorCode;
-            this.lastErrorCode = errorCode;
-            if (error.code === "RATE_LIMITED") {
-                const cooldownSec = error.retryAfterSeconds || 5 * 60;
-                this.rateLimitedUntil = Date.now() + cooldownSec * 1000;
-                this.log.warn(`Rate limit hit — pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`);
-            }
-            else if (error.code === "INVALID_API_KEY") {
-                // Always log — user must fix config
-                this.log.error("Invalid API key — please check your parcel.app API key");
-            }
-            else if (isRepeat) {
-                // Same error as last time — don't spam the log
-                this.log.debug(`Poll failed (ongoing): ${error.message}`);
-            }
-            else if (errorCode === "NETWORK") {
-                this.log.warn(`Cannot reach parcel.app API — will keep retrying`);
-            }
-            else if (errorCode === "TIMEOUT") {
-                this.log.warn(`API request timeout — will retry next cycle`);
-            }
-            else {
-                this.log.error(`Poll failed: ${error.message}`);
-            }
-            await this.setStateAsync("info.connection", { val: false, ack: true });
-        }
-        finally {
-            this.isPolling = false;
-        }
+  }
+  /**
+   * Classify an error for deduplication and log-level decisions.
+   *
+   * @param error The error to classify
+   */
+  classifyError(error) {
+    if (error.code === "RATE_LIMITED") {
+      return "RATE_LIMITED";
+    }
+    if (error.code === "INVALID_API_KEY") {
+      return "INVALID_API_KEY";
+    }
+    if (error.code === "ENOTFOUND" || error.code === "ECONNREFUSED" || error.code === "ECONNRESET" || error.code === "ENETUNREACH" || error.code === "EAI_AGAIN") {
+      return "NETWORK";
+    }
+    if (error.message.includes("timeout") || error.code === "ETIMEDOUT") {
+      return "TIMEOUT";
     }
+    return error.code || "UNKNOWN";
+  }
+  async poll() {
+    if (this.isPolling || !this.client || !this.stateManager) {
+      return;
+    }
+    const now = Date.now();
+    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)`
+      );
+      return;
+    }
+    if (now - this.lastPollTime < MIN_POLL_GAP_MS) {
+      this.log.debug("Skipping poll \u2014 too soon after last poll");
+      return;
+    }
+    this.isPolling = true;
+    this.lastPollTime = now;
+    try {
+      const autoRemove = this.config.autoRemoveDelivered !== false;
+      const deliveries = await this.client.getDeliveries(
+        autoRemove ? "active" : "recent"
+      );
+      this.rateLimitedUntil = 0;
+      if (this.lastErrorCode) {
+        this.log.info("Connection restored");
+        this.lastErrorCode = "";
+      }
+      await this.setStateAsync("info.connection", { val: true, ack: true });
+      const visibleDeliveries = autoRemove ? deliveries.filter((d) => parseInt(d.status_code, 10) !== 0) : deliveries;
+      const activeIds = [];
+      for (const delivery of visibleDeliveries) {
+        const carrierName = await this.client.getCarrierName(
+          delivery.carrier_code
+        );
+        await this.stateManager.updateDelivery(delivery, carrierName);
+        activeIds.push(this.stateManager.packageId(delivery));
+      }
+      await this.stateManager.cleanupDeliveries(activeIds);
+      const summaryDeliveries = autoRemove ? visibleDeliveries : deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);
+      await this.stateManager.updateSummary(summaryDeliveries);
+      this.log.debug(
+        `Polled ${visibleDeliveries.length} deliveries (${summaryDeliveries.length} active)`
+      );
+    } catch (err) {
+      const error = err;
+      const errorCode = this.classifyError(error);
+      const isRepeat = errorCode === this.lastErrorCode;
+      this.lastErrorCode = errorCode;
+      if (error.code === "RATE_LIMITED") {
+        const cooldownSec = error.retryAfterSeconds || 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 === "INVALID_API_KEY") {
+        this.log.error(
+          "Invalid API key \u2014 please check your parcel.app API key"
+        );
+      } else if (isRepeat) {
+        this.log.debug(`Poll failed (ongoing): ${error.message}`);
+      } else if (errorCode === "NETWORK") {
+        this.log.warn(`Cannot reach parcel.app API \u2014 will keep retrying`);
+      } else if (errorCode === "TIMEOUT") {
+        this.log.warn(`API request timeout \u2014 will retry next cycle`);
+      } else {
+        this.log.error(`Poll failed: ${error.message}`);
+      }
+      await this.setStateAsync("info.connection", { val: false, ack: true });
+    } finally {
+      this.isPolling = false;
+    }
+  }
 }
 if (require.main !== module) {
-    module.exports = (options) => new ParcelappAdapter(options);
-}
-else {
-    (() => new ParcelappAdapter())();
+  module.exports = (options) => new ParcelappAdapter(options);
+} else {
+  (() => new ParcelappAdapter())();
 }
+//# sourceMappingURL=main.js.map

package/build/main.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/main.ts"],
+  "sourcesContent": ["import * as utils from \"@iobroker/adapter-core\";\nimport { ParcelClient } from \"./lib/parcel-client\";\nimport { StateManager } from \"./lib/state-manager\";\nimport \"./lib/types\";\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\n  /** @param options Adapter options */\n  public constructor(options: Partial<utils.AdapterOptions> = {}) {\n    super({\n      ...options,\n      name: \"parcelapp\",\n    });\n    this.on(\"ready\", this.onReady.bind(this));\n    this.on(\"unload\", this.onUnload.bind(this));\n    this.on(\"message\", this.onMessage.bind(this));\n  }\n\n  private async onReady(): Promise<void> {\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(\n        \"No valid API key configured \u2014 please enter your parcel.app API key in the adapter settings\",\n      );\n      return;\n    }\n\n    // Initialize\n    this.client = new ParcelClient(apiKey.trim());\n    this.stateManager = new StateManager(this);\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(\n        MAX_POLL_INTERVAL,\n        this.config.pollInterval ?? DEFAULT_POLL_INTERVAL,\n      ),\n    );\n    const intervalMs = interval * 60 * 1000;\n    this.pollTimer = this.setInterval(() => void this.poll(), intervalMs);\n\n    this.log.info(\n      `Parcel tracking started \u2014 polling every ${interval} minutes`,\n    );\n  }\n\n  private onUnload(callback: () => void): void {\n    if (this.pollTimer) {\n      this.clearInterval(this.pollTimer);\n      this.pollTimer = undefined;\n    }\n    void this.setState(\"info.connection\", { val: false, ack: true });\n    callback();\n  }\n\n  private async onMessage(obj: ioBroker.Message): Promise<void> {\n    if (!obj?.command) {\n      return;\n    }\n\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(\n            obj.from,\n            obj.command,\n            {\n              success: false,\n              message: \"API key is too short\",\n            },\n            obj.callback,\n          );\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            {\n              success: false,\n              error_message: \"Adapter not initialized\",\n            },\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          // Trigger immediate poll to pick up the new delivery\n          void this.poll();\n        }\n        break;\n      }\n      default:\n        this.sendTo(\n          obj.from,\n          obj.command,\n          { error: \"Unknown command\" },\n          obj.callback,\n        );\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 === \"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(\n        `Skipping poll \u2014 rate limited for ${waitMin} more minute(s)`,\n      );\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(\n        autoRemove ? \"active\" : \"recent\",\n      );\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      // Filter deliveries based on auto-remove setting\n      const visibleDeliveries = autoRemove\n        ? deliveries.filter((d) => parseInt(d.status_code, 10) !== 0)\n        : deliveries;\n\n      // Update each delivery\n      const activeIds: string[] = [];\n      for (const delivery of visibleDeliveries) {\n        const carrierName = await this.client.getCarrierName(\n          delivery.carrier_code,\n        );\n        await this.stateManager.updateDelivery(delivery, carrierName);\n        activeIds.push(this.stateManager.packageId(delivery));\n      }\n\n      // Cleanup stale deliveries\n      await this.stateManager.cleanupDeliveries(activeIds);\n\n      // Update summary\n      const summaryDeliveries = autoRemove\n        ? visibleDeliveries\n        : deliveries.filter((d) => parseInt(d.status_code, 10) !== 0);\n      await this.stateManager.updateSummary(summaryDeliveries);\n\n      this.log.debug(\n        `Polled ${visibleDeliveries.length} deliveries (${summaryDeliveries.length} active)`,\n      );\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(\n          `Rate limit hit \u2014 pausing API requests for ${Math.ceil(cooldownSec / 60)} minute(s)`,\n        );\n      } else if (error.code === \"INVALID_API_KEY\") {\n        // Always log \u2014 user must fix config\n        this.log.error(\n          \"Invalid API key \u2014 please check your parcel.app API key\",\n        );\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) =>\n    new ParcelappAdapter(options);\n} else {\n  (() => new ParcelappAdapter())();\n}\n"],
+  "mappings": "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",
+  "names": []
+}