iobroker.ai-usage 0.1.0

package/admin/jsonConfig.json

@@ -0,0 +1,252 @@
+{
+  "type": "panel",
+  "i18n": true,
+  "items": {
+    "_accountsHeader": {
+      "type": "header",
+      "text": "accountsHeader",
+      "size": 5
+    },
+    "_accountsInfo": {
+      "type": "staticText",
+      "text": "accountsInfo",
+      "xs": 12,
+      "sm": 12,
+      "md": 12,
+      "lg": 12,
+      "xl": 12,
+      "style": {
+        "fontSize": 14,
+        "marginBottom": 8
+      }
+    },
+    "accounts": {
+      "type": "table",
+      "label": "label_accounts",
+      "xs": 12,
+      "sm": 12,
+      "md": 12,
+      "lg": 12,
+      "xl": 12,
+      "uniqueColumns": [
+        "name"
+      ],
+      "items": [
+        {
+          "type": "text",
+          "attr": "name",
+          "title": "col_name",
+          "width": "20%",
+          "filter": false,
+          "sort": false,
+          "default": ""
+        },
+        {
+          "type": "select",
+          "attr": "provider",
+          "title": "col_provider",
+          "width": "20%",
+          "filter": false,
+          "sort": false,
+          "noTranslation": true,
+          "default": "claude-sub",
+          "options": [
+            {
+              "label": "Claude subscription",
+              "value": "claude-sub"
+            },
+            {
+              "label": "OpenRouter",
+              "value": "openrouter"
+            },
+            {
+              "label": "DeepSeek",
+              "value": "deepseek"
+            },
+            {
+              "label": "OpenAI API",
+              "value": "openai"
+            },
+            {
+              "label": "Anthropic API",
+              "value": "anthropic-api"
+            }
+          ]
+        },
+        {
+          "type": "credential",
+          "attr": "credentialId",
+          "title": "col_credential",
+          "width": "30%",
+          "filter": false,
+          "sort": false,
+          "default": ""
+        },
+        {
+          "type": "number",
+          "attr": "warnThreshold",
+          "title": "col_warnThreshold",
+          "width": "15%",
+          "filter": false,
+          "sort": false,
+          "min": 10,
+          "max": 100,
+          "default": 80
+        },
+        {
+          "type": "checkbox",
+          "attr": "enabled",
+          "title": "col_enabled",
+          "width": "15%",
+          "filter": false,
+          "sort": false,
+          "default": true
+        }
+      ]
+    },
+    "_claudeHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "claudeHeader",
+      "size": 5
+    },
+    "_claudeInfo": {
+      "type": "staticText",
+      "text": "claudeInfo",
+      "xs": 12,
+      "sm": 12,
+      "md": 12,
+      "lg": 12,
+      "xl": 12,
+      "style": {
+        "fontSize": 14,
+        "marginBottom": 8
+      }
+    },
+    "_claudeAccount": {
+      "type": "text",
+      "label": "label_claudeAccount",
+      "help": "help_claudeAccount",
+      "doNotSave": true,
+      "xs": 12,
+      "sm": 6,
+      "md": 4,
+      "lg": 4,
+      "xl": 3
+    },
+    "_claudeUrl": {
+      "type": "textSendTo",
+      "command": "claudeAuthStart",
+      "jsonData": "{\"account\": \"${data._claudeAccount}\"}",
+      "alsoDependsOn": [
+        "_claudeAccount"
+      ],
+      "label": "label_claudeUrl",
+      "copyToClipboard": true,
+      "xs": 12,
+      "sm": 12,
+      "md": 8,
+      "lg": 8,
+      "xl": 8
+    },
+    "_claudeCode": {
+      "type": "text",
+      "label": "label_claudeCode",
+      "help": "help_claudeCode",
+      "doNotSave": true,
+      "xs": 12,
+      "sm": 6,
+      "md": 4,
+      "lg": 4,
+      "xl": 3
+    },
+    "_claudeRedeem": {
+      "type": "sendTo",
+      "command": "claudeAuthCode",
+      "jsonData": "{\"account\": \"${data._claudeAccount}\", \"code\": \"${data._claudeCode}\"}",
+      "label": "btn_claudeRedeem",
+      "variant": "contained",
+      "useNative": false,
+      "xs": 12,
+      "sm": 6,
+      "md": 4,
+      "lg": 4,
+      "xl": 3
+    },
+    "_settingsHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "settingsHeader",
+      "size": 5
+    },
+    "pollInterval": {
+      "type": "number",
+      "label": "label_pollInterval",
+      "help": "help_pollInterval",
+      "min": 60,
+      "max": 3600,
+      "default": 300,
+      "xs": 12,
+      "sm": 6,
+      "md": 3,
+      "lg": 3,
+      "xl": 3
+    },
+    "notifications": {
+      "type": "checkbox",
+      "label": "label_notifications",
+      "help": "help_notifications",
+      "default": true,
+      "xs": 12,
+      "sm": 6,
+      "md": 4,
+      "lg": 4,
+      "xl": 4
+    },
+    "_supportHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "supportHeader",
+      "size": 5
+    },
+    "_aboutInfo": {
+      "type": "staticText",
+      "text": "aboutInfo",
+      "xs": 12,
+      "sm": 12,
+      "md": 12,
+      "lg": 12,
+      "xl": 12,
+      "style": {
+        "fontSize": 14,
+        "marginBottom": 16
+      }
+    },
+    "_kofiLink": {
+      "type": "staticLink",
+      "href": "https://ko-fi.com/krobipd",
+      "label": "donateKofi",
+      "button": true,
+      "variant": "outlined",
+      "color": "primary",
+      "xs": 12,
+      "sm": 6,
+      "md": 4,
+      "lg": 4,
+      "xl": 4
+    },
+    "_paypalLink": {
+      "type": "staticLink",
+      "href": "https://paypal.me/krobipd",
+      "label": "donatePaypal",
+      "button": true,
+      "variant": "outlined",
+      "color": "primary",
+      "xs": 12,
+      "sm": 6,
+      "md": 4,
+      "lg": 4,
+      "xl": 4
+    }
+  }
+}

package/build/lib/http.js

@@ -0,0 +1,81 @@
+"use strict";
+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 });
+};
+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 http_exports = {};
+__export(http_exports, {
+  getJson: () => getJson,
+  postJson: () => postJson
+});
+module.exports = __toCommonJS(http_exports);
+var import_provider = require("./provider");
+const REQUEST_TIMEOUT_MS = 15e3;
+async function getJson(url, headers) {
+  let response;
+  try {
+    response = await fetch(url, { headers, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });
+  } catch (e) {
+    throw new import_provider.FetchError("network", e instanceof Error ? e.message : String(e));
+  }
+  if (response.status === 401 || response.status === 403) {
+    throw new import_provider.FetchError("auth", `HTTP ${response.status}`);
+  }
+  if (response.status === 429) {
+    throw new import_provider.FetchError("rate-limit", "HTTP 429");
+  }
+  if (!response.ok) {
+    throw new import_provider.FetchError("network", `HTTP ${response.status}`);
+  }
+  try {
+    return await response.json();
+  } catch {
+    throw new import_provider.FetchError("network", "invalid JSON response");
+  }
+}
+async function postJson(url, body) {
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (e) {
+    throw new import_provider.FetchError("network", e instanceof Error ? e.message : String(e));
+  }
+  if (response.status === 401 || response.status === 403 || response.status === 400) {
+    throw new import_provider.FetchError("auth", `HTTP ${response.status}`);
+  }
+  if (response.status === 429) {
+    throw new import_provider.FetchError("rate-limit", "HTTP 429");
+  }
+  if (!response.ok) {
+    throw new import_provider.FetchError("network", `HTTP ${response.status}`);
+  }
+  try {
+    return await response.json();
+  } catch {
+    throw new import_provider.FetchError("network", "invalid JSON response");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getJson,
+  postJson
+});
+//# sourceMappingURL=http.js.map

package/build/lib/http.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/http.ts"],
+  "sourcesContent": ["import { FetchError } from \"./provider\";\n\n/** Per-request timeout (ms). */\nconst REQUEST_TIMEOUT_MS = 15000;\n\n/** The JSON-GET seam the provider modules use \u2014 injectable for tests. */\nexport type JsonFetch = (url: string, headers: Record<string, string>) => Promise<unknown>;\n\n/**\n * GET a JSON document with the shared failure classification: 401/403 become an\n * auth error, 429 a rate-limit error, everything else (bad status, network throw,\n * timeout, invalid JSON) a network error \u2014 the classes the poll engine acts on.\n *\n * @param url the request URL\n * @param headers request headers (Authorization etc.)\n * @returns the parsed JSON body\n */\nexport async function getJson(url: string, headers: Record<string, string>): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, { headers, signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS) });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 401 || response.status === 403) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    throw new FetchError(\"network\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch {\n    throw new FetchError(\"network\", \"invalid JSON response\");\n  }\n}\n\n/**\n * POST a JSON document with the same failure classification as {@link getJson}.\n *\n * @param url the request URL\n * @param body the JSON body\n * @returns the parsed JSON response\n */\nexport async function postJson(url: string, body: Record<string, unknown>): Promise<unknown> {\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    });\n  } catch (e) {\n    throw new FetchError(\"network\", e instanceof Error ? e.message : String(e));\n  }\n  if (response.status === 401 || response.status === 403 || response.status === 400) {\n    throw new FetchError(\"auth\", `HTTP ${response.status}`);\n  }\n  if (response.status === 429) {\n    throw new FetchError(\"rate-limit\", \"HTTP 429\");\n  }\n  if (!response.ok) {\n    throw new FetchError(\"network\", `HTTP ${response.status}`);\n  }\n  try {\n    return await response.json();\n  } catch {\n    throw new FetchError(\"network\", \"invalid JSON response\");\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAA2B;AAG3B,MAAM,qBAAqB;AAc3B,eAAsB,QAAQ,KAAa,SAAmD;AAC5F,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,MAAM,KAAK,EAAE,SAAS,QAAQ,YAAY,QAAQ,kBAAkB,EAAE,CAAC;AAAA,EAC1F,SAAS,GAAG;AACV,UAAM,IAAI,2BAAW,WAAW,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC;AAAA,EAC5E;AACA,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KAAK;AACtD,UAAM,IAAI,2BAAW,QAAQ,QAAQ,SAAS,MAAM,EAAE;AAAA,EACxD;AACA,MAAI,SAAS,WAAW,KAAK;AAC3B,UAAM,IAAI,2BAAW,cAAc,UAAU;AAAA,EAC/C;AACA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,2BAAW,WAAW,QAAQ,SAAS,MAAM,EAAE;AAAA,EAC3D;AACA,MAAI;AACF,WAAO,MAAM,SAAS,KAAK;AAAA,EAC7B,QAAQ;AACN,UAAM,IAAI,2BAAW,WAAW,uBAAuB;AAAA,EACzD;AACF;AASA,eAAsB,SAAS,KAAa,MAAiD;AAC3F,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,MAAM,KAAK;AAAA,MAC1B,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB,QAAQ,YAAY,QAAQ,kBAAkB;AAAA,IAChD,CAAC;AAAA,EACH,SAAS,GAAG;AACV,UAAM,IAAI,2BAAW,WAAW,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,CAAC;AAAA,EAC5E;AACA,MAAI,SAAS,WAAW,OAAO,SAAS,WAAW,OAAO,SAAS,WAAW,KAAK;AACjF,UAAM,IAAI,2BAAW,QAAQ,QAAQ,SAAS,MAAM,EAAE;AAAA,EACxD;AACA,MAAI,SAAS,WAAW,KAAK;AAC3B,UAAM,IAAI,2BAAW,cAAc,UAAU;AAAA,EAC/C;AACA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,2BAAW,WAAW,QAAQ,SAAS,MAAM,EAAE;AAAA,EAC3D;AACA,MAAI;AACF,WAAO,MAAM,SAAS,KAAK;AAAA,EAC7B,QAAQ;AACN,UAAM,IAAI,2BAAW,WAAW,uBAAuB;AAAA,EACzD;AACF;",
+  "names": []
+}

package/build/lib/poll-engine.js

@@ -0,0 +1,341 @@
+"use strict";
+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 });
+};
+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 poll_engine_exports = {};
+__export(poll_engine_exports, {
+  PollEngine: () => PollEngine
+});
+module.exports = __toCommonJS(poll_engine_exports);
+var import_provider = require("./provider");
+var import_snapshot_tree = require("./snapshot-tree");
+var import_totals = require("./totals");
+const MAX_NETWORK_FAILURES = 3;
+const BACKOFF_START_MS = 10 * 60 * 1e3;
+const BACKOFF_MAX_MS = 60 * 60 * 1e3;
+const STAGGER_MS = 3e3;
+class PollEngine {
+  /**
+   * @param accounts the validated account configs
+   * @param providers each account id's provider (accounts without one are skipped)
+   * @param intervalSec the poll interval in seconds
+   * @param deps the injected adapter callbacks
+   */
+  constructor(accounts, providers, intervalSec, deps) {
+    this.intervalSec = intervalSec;
+    this.deps = deps;
+    for (const config of accounts) {
+      const provider = providers.get(config.id);
+      if (!provider) {
+        deps.log.warn(`${config.name}: provider "${config.provider}" is not available \u2014 account skipped`);
+        continue;
+      }
+      this.runtimes.push({
+        config,
+        provider,
+        status: { reachable: false, warning: false },
+        failCount: 0,
+        skipUntil: 0,
+        backoffMs: BACKOFF_START_MS,
+        authNotified: false,
+        createdObjects: /* @__PURE__ */ new Set()
+      });
+    }
+  }
+  intervalSec;
+  deps;
+  runtimes = [];
+  handles = [];
+  stopped = false;
+  /** Create the static per-account and totals objects, then arm the poll cycles. */
+  async start() {
+    for (const runtime of this.runtimes) {
+      await this.createAccountSkeleton(runtime);
+    }
+    await this.createTotalsSkeleton();
+    await this.writeTotals();
+    this.runtimes.forEach((runtime, index) => {
+      this.handles.push(
+        this.deps.scheduleOnce(() => void this.pollAccount(runtime), index * STAGGER_MS),
+        this.deps.schedule(() => void this.pollAccount(runtime), this.intervalSec * 1e3)
+      );
+    });
+  }
+  /** Cancel every timer. Synchronous — safe from onUnload. */
+  stop() {
+    this.stopped = true;
+    for (const handle of this.handles) {
+      this.deps.cancel(handle);
+    }
+    this.handles.length = 0;
+  }
+  /** The account ids the engine drives (for the stale-object cleanup). */
+  get accountIds() {
+    return this.runtimes.map((runtime) => runtime.config.id);
+  }
+  /**
+   * Poll one account now (also used by the staggered first run).
+   *
+   * @param runtime the account's runtime
+   */
+  async pollAccount(runtime) {
+    if (this.stopped) {
+      return;
+    }
+    const { config } = runtime;
+    if (this.deps.now() < runtime.skipUntil) {
+      this.deps.log.debug(`${config.name}: in rate-limit backoff \u2014 poll skipped`);
+      return;
+    }
+    try {
+      const snapshot = await runtime.provider.fetch();
+      runtime.failCount = 0;
+      runtime.backoffMs = BACKOFF_START_MS;
+      runtime.authNotified = false;
+      runtime.status.snapshot = snapshot;
+      runtime.status.reachable = true;
+      await this.applySnapshot(runtime, snapshot);
+    } catch (e) {
+      this.handleFailure(runtime, e);
+    }
+    this.writeAccountInfo(runtime);
+    await this.writeTotals();
+  }
+  /**
+   * Write a successful snapshot: upsert new objects (create-once cache), write the
+   * values, and run the warn-threshold transition.
+   *
+   * @param runtime the account's runtime
+   * @param snapshot the fetched snapshot
+   */
+  async applySnapshot(runtime, snapshot) {
+    var _a, _b, _c;
+    const { config } = runtime;
+    const { objects, writes } = (0, import_snapshot_tree.mapSnapshot)(config.id, config.name, config.provider, snapshot);
+    for (const object of objects) {
+      if (!runtime.createdObjects.has(object.id)) {
+        await this.deps.upsertObject(object);
+        runtime.createdObjects.add(object.id);
+      }
+    }
+    for (const write of writes) {
+      this.deps.setState(write.id, write.value);
+    }
+    const percent = (_a = (0, import_snapshot_tree.maxLimitPercent)(snapshot)) != null ? _a : 0;
+    const wasWarning = runtime.status.warning;
+    runtime.status.warning = percent >= config.warnThreshold;
+    this.deps.setState(`${config.id}.warning`, runtime.status.warning);
+    this.deps.setState(`${config.id}.limitReached`, percent >= 100);
+    if (runtime.status.warning && !wasWarning) {
+      const message = `${config.name}: usage at ${Math.round(percent)} % (threshold ${config.warnThreshold} %)`;
+      this.deps.log.warn(message);
+      (_c = (_b = this.deps).notify) == null ? void 0 : _c.call(_b, config.name, message);
+    }
+  }
+  /**
+   * Classify a fetch failure: auth = unreachable + ONE notification until it recovers;
+   * rate-limit = backoff, last values stay; network = tolerated MAX_NETWORK_FAILURES times.
+   *
+   * @param runtime the account's runtime
+   * @param error the thrown error
+   */
+  handleFailure(runtime, error) {
+    var _a, _b;
+    const { config } = runtime;
+    const message = error instanceof Error ? error.message : String(error);
+    if (error instanceof import_provider.FetchError && error.kind === "auth") {
+      runtime.status.reachable = false;
+      if (!runtime.authNotified) {
+        runtime.authNotified = true;
+        const text = `${config.name}: credentials rejected \u2014 ${message}`;
+        this.deps.log.warn(text);
+        (_b = (_a = this.deps).notify) == null ? void 0 : _b.call(_a, config.name, text);
+      }
+      return;
+    }
+    if (error instanceof import_provider.FetchError && error.kind === "rate-limit") {
+      runtime.skipUntil = this.deps.now() + runtime.backoffMs;
+      this.deps.log.warn(
+        `${config.name}: rate-limited \u2014 backing off for ${Math.round(runtime.backoffMs / 6e4)} min, keeping last values`
+      );
+      runtime.backoffMs = Math.min(BACKOFF_MAX_MS, runtime.backoffMs * 2);
+      return;
+    }
+    runtime.failCount++;
+    this.deps.log.debug(`${config.name}: fetch failed (${message}), attempt ${runtime.failCount}`);
+    if (runtime.failCount >= MAX_NETWORK_FAILURES) {
+      runtime.status.reachable = false;
+    }
+  }
+  /**
+   * Write one account's info states (reachable, last update).
+   *
+   * @param runtime the account's runtime
+   */
+  writeAccountInfo(runtime) {
+    const { config } = runtime;
+    this.deps.setState(`${config.id}.info.reachable`, runtime.status.reachable);
+    if (runtime.status.reachable) {
+      this.deps.setState(`${config.id}.info.lastUpdate`, new Date(this.deps.now()).toISOString());
+    }
+  }
+  /** Recompute and write the totals + info.connection. */
+  async writeTotals() {
+    const totals = (0, import_totals.computeTotals)(this.runtimes.map((runtime) => runtime.status));
+    this.deps.setState("total.costs.today", totals.costsToday);
+    this.deps.setState("total.costs.month", totals.costsMonth);
+    this.deps.setState("total.costs.projectedMonth", totals.costsProjectedMonth);
+    this.deps.setState("total.maxLimitPercent", totals.maxLimitPercent);
+    this.deps.setState("total.warningsActive", totals.warningsActive);
+    this.deps.setState("total.limitReached", totals.limitReached);
+    this.deps.setState("total.accountsReachable", totals.accountsReachable);
+    this.deps.setState("total.accounts", totals.accounts);
+    this.deps.setState("info.connection", totals.accountsReachable > 0);
+    return Promise.resolve();
+  }
+  /**
+   * The static per-account objects that exist regardless of what the source delivers.
+   *
+   * @param runtime the account's runtime
+   */
+  async createAccountSkeleton(runtime) {
+    const { config } = runtime;
+    const defs = [
+      { id: config.id, type: "device", common: { name: `${config.name} (${config.provider})` } },
+      { id: `${config.id}.info`, type: "channel", common: { name: "Info" } },
+      {
+        id: `${config.id}.info.provider`,
+        type: "state",
+        common: { name: "Provider", type: "string", role: "text", read: true, write: false }
+      },
+      {
+        id: `${config.id}.info.reachable`,
+        type: "state",
+        common: { name: "Reachable", type: "boolean", role: "indicator.reachable", read: true, write: false }
+      },
+      {
+        id: `${config.id}.info.lastUpdate`,
+        type: "state",
+        common: { name: "Last successful update", type: "string", role: "date", read: true, write: false }
+      },
+      {
+        id: `${config.id}.warning`,
+        type: "state",
+        common: { name: "Above warn threshold", type: "boolean", role: "indicator", read: true, write: false }
+      },
+      {
+        id: `${config.id}.limitReached`,
+        type: "state",
+        common: { name: "A limit window is full", type: "boolean", role: "indicator", read: true, write: false }
+      }
+    ];
+    for (const def of defs) {
+      await this.deps.upsertObject(def);
+      runtime.createdObjects.add(def.id);
+    }
+    this.deps.setState(`${config.id}.info.provider`, config.provider);
+    this.deps.setState(`${config.id}.info.reachable`, false);
+  }
+  /** The totals skeleton (channel + states). */
+  async createTotalsSkeleton() {
+    const defs = [
+      { id: "total.costs", type: "channel", common: { name: "Costs (USD accounts)" } },
+      {
+        id: "total.costs.today",
+        type: "state",
+        common: {
+          name: "Costs today (all accounts)",
+          type: "number",
+          role: "value",
+          read: true,
+          write: false,
+          unit: "USD"
+        }
+      },
+      {
+        id: "total.costs.month",
+        type: "state",
+        common: {
+          name: "Costs this month (all accounts)",
+          type: "number",
+          role: "value",
+          read: true,
+          write: false,
+          unit: "USD"
+        }
+      },
+      {
+        id: "total.costs.projectedMonth",
+        type: "state",
+        common: {
+          name: "Costs projected month-end (computed)",
+          type: "number",
+          role: "value",
+          read: true,
+          write: false,
+          unit: "USD"
+        }
+      },
+      {
+        id: "total.maxLimitPercent",
+        type: "state",
+        common: {
+          name: "Highest limit utilisation of any account",
+          type: "number",
+          role: "value",
+          read: true,
+          write: false,
+          unit: "%"
+        }
+      },
+      {
+        id: "total.warningsActive",
+        type: "state",
+        common: {
+          name: "Accounts above their warn threshold",
+          type: "number",
+          role: "value",
+          read: true,
+          write: false
+        }
+      },
+      {
+        id: "total.limitReached",
+        type: "state",
+        common: { name: "Any limit window full", type: "boolean", role: "indicator", read: true, write: false }
+      },
+      {
+        id: "total.accountsReachable",
+        type: "state",
+        common: { name: "Reachable accounts", type: "number", role: "value", read: true, write: false }
+      },
+      {
+        id: "total.accounts",
+        type: "state",
+        common: { name: "Configured accounts", type: "number", role: "value", read: true, write: false }
+      }
+    ];
+    for (const def of defs) {
+      await this.deps.upsertObject(def);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PollEngine
+});
+//# sourceMappingURL=poll-engine.js.map