@wovin/daemon-utils 0.0.18 → 0.0.20

package/dist/chunk-GB53WLYA.min.js

@@ -0,0 +1,174 @@
+import {
+  g
+} from "./chunk-MZUPFLFH.min.js";
+
+// src/watcher.ts
+var { WARN, LOG, DEBUG, ERROR } = g.setup(g.INFO);
+var NAME_WS_URL = "wss://name.web3.storage/name";
+var NAME_HTTP_URL = "https://name.web3.storage/name";
+function watchNameRaw(name, options) {
+  const url = `${NAME_WS_URL}/${name}/watch`;
+  DEBUG("[w3name-watch] connecting to", url);
+  const ws = new WebSocket(url);
+  ws.onopen = () => {
+    LOG("[w3name-watch] connected to", name);
+    options.onOpen?.();
+  };
+  ws.onmessage = (event) => {
+    try {
+      const record = JSON.parse(event.data);
+      DEBUG("[w3name-watch] received update for", name, record);
+      options.onUpdate(record);
+    } catch (err) {
+      WARN("[w3name-watch] failed to parse message:", event.data, err);
+      options.onError?.(err instanceof Error ? err : new Error(String(err)));
+    }
+  };
+  ws.onerror = (event) => {
+    WARN("[w3name-watch] error for", name, event);
+    options.onError?.(event);
+  };
+  ws.onclose = (event) => {
+    DEBUG("[w3name-watch] closed for", name, "code:", event.code, "reason:", event.reason);
+    options.onClose?.(event);
+  };
+  return {
+    close: () => {
+      DEBUG("[w3name-watch] closing connection for", name);
+      ws.close();
+    },
+    ws
+  };
+}
+var IpnsWatcher = class {
+  name;
+  options;
+  subscription = null;
+  backoffDelay;
+  lastKnownValue = null;
+  stopped = false;
+  reconnectTimeout = null;
+  constructor(name, options) {
+    this.name = name;
+    this.options = {
+      onUpdate: options.onUpdate,
+      onError: options.onError ?? (() => {
+      }),
+      onConnected: options.onConnected ?? (() => {
+      }),
+      onDisconnected: options.onDisconnected ?? (() => {
+      }),
+      initialBackoff: options.initialBackoff ?? 5e3,
+      maxBackoff: options.maxBackoff ?? 9e5
+    };
+    this.backoffDelay = this.options.initialBackoff;
+  }
+  start() {
+    if (this.stopped) {
+      WARN(`[IpnsWatcher] Cannot restart stopped watcher for ${this.name}`);
+      return;
+    }
+    this.connect();
+  }
+  stop() {
+    this.stopped = true;
+    if (this.reconnectTimeout) {
+      clearTimeout(this.reconnectTimeout);
+      this.reconnectTimeout = null;
+    }
+    if (this.subscription) {
+      this.subscription.close();
+      this.subscription = null;
+    }
+    LOG(`[IpnsWatcher] Stopped watching ${this.name}`);
+  }
+  connect() {
+    if (this.stopped) return;
+    this.subscription = watchNameRaw(this.name, {
+      onUpdate: async (record) => {
+        this.lastKnownValue = record.value;
+        this.backoffDelay = this.options.initialBackoff;
+        await this.options.onUpdate(record);
+      },
+      onError: (error) => {
+        this.options.onError(error);
+      },
+      onOpen: () => {
+        this.options.onConnected();
+      },
+      onClose: () => {
+        this.options.onDisconnected();
+        this.scheduleReconnect();
+      }
+    });
+  }
+  scheduleReconnect() {
+    if (this.stopped) return;
+    WARN(
+      `[IpnsWatcher] Scheduling reconnect for ${this.name} in ${this.backoffDelay}ms`
+    );
+    this.reconnectTimeout = setTimeout(() => {
+      if (this.stopped) return;
+      this.checkForMissedUpdates().then(() => {
+        this.connect();
+        this.backoffDelay = Math.min(this.backoffDelay * 2, this.options.maxBackoff);
+      }).catch((err) => {
+        WARN(`[IpnsWatcher] Error during catch-up for ${this.name}:`, err);
+        this.options.onError(err instanceof Error ? err : new Error(String(err)));
+        this.connect();
+        this.backoffDelay = Math.min(this.backoffDelay * 2, this.options.maxBackoff);
+      });
+    }, this.backoffDelay);
+  }
+  /**
+   * Resolve current IPNS value via HTTP API
+   */
+  async resolveCurrentValue() {
+    try {
+      const response = await fetch(`${NAME_HTTP_URL}/${this.name}`);
+      if (!response.ok) {
+        if (response.status === 404) {
+          DEBUG(`[IpnsWatcher] IPNS ${this.name} not yet published`);
+          return null;
+        }
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+      }
+      const record = await response.json();
+      return record;
+    } catch (err) {
+      WARN(`[IpnsWatcher] Failed to resolve IPNS ${this.name}:`, err);
+      return null;
+    }
+  }
+  async checkForMissedUpdates() {
+    try {
+      const currentRecord = await this.resolveCurrentValue();
+      if (currentRecord && currentRecord.value !== this.lastKnownValue) {
+        DEBUG(
+          `[IpnsWatcher] Detected missed update for ${this.name}`,
+          "previous:",
+          this.lastKnownValue,
+          "current:",
+          currentRecord.value
+        );
+        this.lastKnownValue = currentRecord.value;
+        await this.options.onUpdate(currentRecord);
+      }
+    } catch (err) {
+      WARN(`[IpnsWatcher] Failed to check for missed updates for ${this.name}:`, err);
+      throw err;
+    }
+  }
+};
+function watchName(name, options) {
+  const watcher = new IpnsWatcher(name, options);
+  watcher.start();
+  return watcher;
+}
+
+export {
+  watchNameRaw,
+  IpnsWatcher,
+  watchName
+};
+//# sourceMappingURL=chunk-GB53WLYA.min.js.map

package/dist/chunk-GB53WLYA.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/watcher.ts"],"sourcesContent":["/**\n * IPNS Thread Watcher\n * Watches an IPNS thread for new audio files via WebSocket\n */\n\nimport { Logger } from 'besonders-logger'\n\nconst { WARN, LOG, DEBUG, ERROR } = Logger.setup(Logger.INFO)\n\nconst NAME_WS_URL = 'wss://name.web3.storage/name'\nconst NAME_HTTP_URL = 'https://name.web3.storage/name'\n\nexport interface W3NameRecord {\n\tvalue: string // e.g. \"/ipfs/bafybeig...\"\n\tseq?: number\n\tvalidity?: string\n}\n\nexport interface WatchSubscription {\n\tclose: () => void\n\tws: WebSocket\n}\n\nexport interface WatchOptions {\n\tonUpdate: (record: W3NameRecord) => void\n\tonError?: (error: Event | Error) => void\n\tonOpen?: () => void\n\tonClose?: (event: CloseEvent) => void\n}\n\nexport interface IpnsWatcherOptions {\n\tonUpdate: (record: W3NameRecord) => void | Promise<void>\n\tonError?: (error: Error | Event) => void\n\tonConnected?: () => void\n\tonDisconnected?: () => void\n\t/** Initial backoff delay in ms (default: 5000) */\n\tinitialBackoff?: number\n\t/** Max backoff delay in ms (default: 900000 = 15min) */\n\tmaxBackoff?: number\n}\n\n/**\n * Low-level WebSocket watcher for IPNS (no reconnect logic)\n * @internal Use IpnsWatcher for robust watching with auto-reconnect\n */\nexport function watchNameRaw(name: string, options: WatchOptions): WatchSubscription {\n\tconst url = `${NAME_WS_URL}/${name}/watch`\n\tDEBUG('[w3name-watch] connecting to', url)\n\n\tconst ws = new WebSocket(url)\n\n\tws.onopen = () => {\n\t\tLOG('[w3name-watch] connected to', name)\n\t\toptions.onOpen?.()\n\t}\n\n\tws.onmessage = (event) => {\n\t\ttry {\n\t\t\tconst record: W3NameRecord = JSON.parse(event.data)\n\t\t\tDEBUG('[w3name-watch] received update for', name, record)\n\t\t\toptions.onUpdate(record)\n\t\t} catch (err) {\n\t\t\tWARN('[w3name-watch] failed to parse message:', event.data, err)\n\t\t\toptions.onError?.(err instanceof Error ? err : new Error(String(err)))\n\t\t}\n\t}\n\n\tws.onerror = (event) => {\n\t\tWARN('[w3name-watch] error for', name, event)\n\t\toptions.onError?.(event)\n\t}\n\n\tws.onclose = (event) => {\n\t\tDEBUG('[w3name-watch] closed for', name, 'code:', event.code, 'reason:', event.reason)\n\t\toptions.onClose?.(event)\n\t}\n\n\treturn {\n\t\tclose: () => {\n\t\t\tDEBUG('[w3name-watch] closing connection for', name)\n\t\t\tws.close()\n\t\t},\n\t\tws,\n\t}\n}\n\n/**\n * Robust IPNS watcher with auto-reconnect and catch-up logic\n */\nexport class IpnsWatcher {\n\tprivate name: string\n\tprivate options: Required<Omit<IpnsWatcherOptions, 'onError' | 'onConnected' | 'onDisconnected'>> & {\n\t\tonError: (error: Error | Event) => void\n\t\tonConnected: () => void\n\t\tonDisconnected: () => void\n\t}\n\tprivate subscription: WatchSubscription | null = null\n\tprivate backoffDelay: number\n\tprivate lastKnownValue: string | null = null\n\tprivate stopped: boolean = false\n\tprivate reconnectTimeout: NodeJS.Timeout | null = null\n\n\tconstructor(name: string, options: IpnsWatcherOptions) {\n\t\tthis.name = name\n\t\tthis.options = {\n\t\t\tonUpdate: options.onUpdate,\n\t\t\tonError: options.onError ?? (() => {}),\n\t\t\tonConnected: options.onConnected ?? (() => {}),\n\t\t\tonDisconnected: options.onDisconnected ?? (() => {}),\n\t\t\tinitialBackoff: options.initialBackoff ?? 5000,\n\t\t\tmaxBackoff: options.maxBackoff ?? 900000,\n\t\t}\n\t\tthis.backoffDelay = this.options.initialBackoff\n\t}\n\n\tstart(): void {\n\t\tif (this.stopped) {\n\t\t\tWARN(`[IpnsWatcher] Cannot restart stopped watcher for ${this.name}`)\n\t\t\treturn\n\t\t}\n\t\tthis.connect()\n\t}\n\n\tstop(): void {\n\t\tthis.stopped = true\n\t\tif (this.reconnectTimeout) {\n\t\t\tclearTimeout(this.reconnectTimeout)\n\t\t\tthis.reconnectTimeout = null\n\t\t}\n\t\tif (this.subscription) {\n\t\t\tthis.subscription.close()\n\t\t\tthis.subscription = null\n\t\t}\n\t\tLOG(`[IpnsWatcher] Stopped watching ${this.name}`)\n\t}\n\n\tprivate connect(): void {\n\t\tif (this.stopped) return\n\n\t\tthis.subscription = watchNameRaw(this.name, {\n\t\t\tonUpdate: async (record) => {\n\t\t\t\tthis.lastKnownValue = record.value\n\t\t\t\tthis.backoffDelay = this.options.initialBackoff\n\t\t\t\tawait this.options.onUpdate(record)\n\t\t\t},\n\t\t\tonError: (error) => {\n\t\t\t\tthis.options.onError(error)\n\t\t\t},\n\t\t\tonOpen: () => {\n\t\t\t\tthis.options.onConnected()\n\t\t\t},\n\t\t\tonClose: () => {\n\t\t\t\tthis.options.onDisconnected()\n\t\t\t\tthis.scheduleReconnect()\n\t\t\t},\n\t\t})\n\t}\n\n\tprivate scheduleReconnect(): void {\n\t\tif (this.stopped) return\n\n\t\tWARN(\n\t\t\t`[IpnsWatcher] Scheduling reconnect for ${this.name} in ${this.backoffDelay}ms`,\n\t\t)\n\n\t\tthis.reconnectTimeout = setTimeout(() => {\n\t\t\tif (this.stopped) return\n\n\t\t\tthis.checkForMissedUpdates()\n\t\t\t\t.then(() => {\n\t\t\t\t\tthis.connect()\n\t\t\t\t\t// Exponential backoff: double delay up to max\n\t\t\t\t\tthis.backoffDelay = Math.min(this.backoffDelay * 2, this.options.maxBackoff)\n\t\t\t\t})\n\t\t\t\t.catch((err) => {\n\t\t\t\t\tWARN(`[IpnsWatcher] Error during catch-up for ${this.name}:`, err)\n\t\t\t\t\tthis.options.onError(err instanceof Error ? err : new Error(String(err)))\n\t\t\t\t\t// Still reconnect, but don't update lastKnownValue\n\t\t\t\t\tthis.connect()\n\t\t\t\t\tthis.backoffDelay = Math.min(this.backoffDelay * 2, this.options.maxBackoff)\n\t\t\t\t})\n\t\t}, this.backoffDelay)\n\t}\n\n\t/**\n\t * Resolve current IPNS value via HTTP API\n\t */\n\tprivate async resolveCurrentValue(): Promise<W3NameRecord | null> {\n\t\ttry {\n\t\t\tconst response = await fetch(`${NAME_HTTP_URL}/${this.name}`)\n\t\t\tif (!response.ok) {\n\t\t\t\tif (response.status === 404) {\n\t\t\t\t\tDEBUG(`[IpnsWatcher] IPNS ${this.name} not yet published`)\n\t\t\t\t\treturn null\n\t\t\t\t}\n\t\t\t\tthrow new Error(`HTTP ${response.status}: ${response.statusText}`)\n\t\t\t}\n\t\t\tconst record: W3NameRecord = await response.json()\n\t\t\treturn record\n\t\t} catch (err) {\n\t\t\tWARN(`[IpnsWatcher] Failed to resolve IPNS ${this.name}:`, err)\n\t\t\treturn null\n\t\t}\n\t}\n\n\tprivate async checkForMissedUpdates(): Promise<void> {\n\t\ttry {\n\t\t\tconst currentRecord = await this.resolveCurrentValue()\n\t\t\tif (currentRecord && currentRecord.value !== this.lastKnownValue) {\n\t\t\t\tDEBUG(\n\t\t\t\t\t`[IpnsWatcher] Detected missed update for ${this.name}`,\n\t\t\t\t\t'previous:',\n\t\t\t\t\tthis.lastKnownValue,\n\t\t\t\t\t'current:',\n\t\t\t\t\tcurrentRecord.value,\n\t\t\t\t)\n\t\t\t\tthis.lastKnownValue = currentRecord.value\n\t\t\t\tawait this.options.onUpdate(currentRecord)\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tWARN(`[IpnsWatcher] Failed to check for missed updates for ${this.name}:`, err)\n\t\t\tthrow err\n\t\t}\n\t}\n}\n\n/**\n * Subscribe to IPNS name updates with auto-reconnect and catch-up logic\n */\nexport function watchName(name: string, options: IpnsWatcherOptions): IpnsWatcher {\n\tconst watcher = new IpnsWatcher(name, options)\n\twatcher.start()\n\treturn watcher\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-XAFSYOU2.min.js → chunk-IUNRH65Q.min.js}

@@ -13,8 +13,9 @@ async function loadSecret(envVar, secretFile) {
 async function loadSecretOrThrow(envVar, secretFile, displayName) {
   const secret = await loadSecret(envVar, secretFile);
   if (!secret) {
+    const name = displayName || envVar.split("_").map((word) => word.charAt(0) + word.slice(1).toLowerCase()).join(" ");
     throw new Error(
-      `${displayName} not found. Set ${envVar} environment variable or create ${secretFile} file`
+      `${name} not found. Set ${envVar} environment variable or create ${secretFile} file`
     );
   }
   return secret;
@@ -24,4 +25,4 @@ export {
   loadSecret,
   loadSecretOrThrow
 };
-//# sourceMappingURL=chunk-XAFSYOU2.min.js.map
+//# sourceMappingURL=chunk-IUNRH65Q.min.js.map

package/dist/chunk-IUNRH65Q.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/secrets.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\n\n/**\n * Utility functions for loading API keys from environment variables or secret files\n */\n\n/**\n * Load an API key from environment variable or secret file\n * @param envVar - Environment variable name (e.g., 'REGOLO_API_KEY')\n * @param secretFile - Path to secret file (e.g., 'secret/regolo')\n * @returns The API key, or undefined if not found\n */\nexport async function loadSecret(envVar: string, secretFile: string): Promise<string | undefined> {\n\t// Try environment variable first\n\tconst envValue = process.env[envVar]\n\tif (envValue) return envValue\n\n\t// Fall back to secret file\n\ttry {\n\t\tconst fileContent = await readFile(secretFile, 'utf-8')\n\t\treturn fileContent.trim() || undefined\n\t} catch {\n\t\t// File doesn't exist or can't be read\n\t\treturn undefined\n\t}\n}\n\n/**\n * Load an API key from environment variable or secret file, with error handling\n * @param envVar - Environment variable name\n * @param secretFile - Path to secret file\n * @param displayName - Human-readable name for error messages. Defaults to capitalized envVar (e.g., 'MISTRAL_API_KEY' -> 'Mistral Api Key')\n * @returns The API key\n * @throws If the key is not found\n */\nexport async function loadSecretOrThrow(\n\tenvVar: string,\n\tsecretFile: string,\n\tdisplayName?: string,\n): Promise<string> {\n\tconst secret = await loadSecret(envVar, secretFile)\n\tif (!secret) {\n\t\tconst name = displayName || envVar.split('_').map(word => word.charAt(0) + word.slice(1).toLowerCase()).join(' ')\n\t\tthrow new Error(\n\t\t\t`${name} not found. Set ${envVar} environment variable or create ${secretFile} file`,\n\t\t)\n\t}\n\treturn secret\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAYzB,eAAsB,WAAW,QAAgB,YAAiD;AAEjG,QAAM,WAAW,QAAQ,IAAI,MAAM;AACnC,MAAI,SAAU,QAAO;AAGrB,MAAI;AACH,UAAM,cAAc,MAAM,SAAS,YAAY,OAAO;AACtD,WAAO,YAAY,KAAK,KAAK;AAAA,EAC9B,QAAQ;AAEP,WAAO;AAAA,EACR;AACD;AAUA,eAAsB,kBACrB,QACA,YACA,aACkB;AAClB,QAAM,SAAS,MAAM,WAAW,QAAQ,UAAU;AAClD,MAAI,CAAC,QAAQ;AACZ,UAAM,OAAO,eAAe,OAAO,MAAM,GAAG,EAAE,IAAI,UAAQ,KAAK,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,YAAY,CAAC,EAAE,KAAK,GAAG;AAChH,UAAM,IAAI;AAAA,MACT,GAAG,IAAI,mBAAmB,MAAM,mCAAmC,UAAU;AAAA,IAC9E;AAAA,EACD;AACA,SAAO;AACR;","names":[]}

package/dist/index.min.js

@@ -13,13 +13,16 @@ import {
 import {
   loadSecret,
   loadSecretOrThrow
-} from "./chunk-XAFSYOU2.min.js";
+} from "./chunk-IUNRH65Q.min.js";
 import {
-  watchName
-} from "./chunk-IAQU2NGT.min.js";
+  IpnsWatcher,
+  watchName,
+  watchNameRaw
+} from "./chunk-GB53WLYA.min.js";
 import "./chunk-MZUPFLFH.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
+  IpnsWatcher,
   ManagedThread,
   generateIpnsKey,
   getW3NamePublic,
@@ -28,6 +31,7 @@ export {
   loadSecretOrThrow,
   publishIPNS,
   publishIpnsThread,
-  watchName
+  watchName,
+  watchNameRaw
 };
 //# sourceMappingURL=index.min.js.map

package/dist/secrets.d.ts

@@ -12,9 +12,9 @@ export declare function loadSecret(envVar: string, secretFile: string): Promise<
  * Load an API key from environment variable or secret file, with error handling
  * @param envVar - Environment variable name
  * @param secretFile - Path to secret file
- * @param displayName - Human-readable name for error messages (e.g., 'REGOLO API key')
+ * @param displayName - Human-readable name for error messages. Defaults to capitalized envVar (e.g., 'MISTRAL_API_KEY' -> 'Mistral Api Key')
  * @returns The API key
  * @throws If the key is not found
  */
-export declare function loadSecretOrThrow(envVar: string, secretFile: string, displayName: string): Promise<string>;
+export declare function loadSecretOrThrow(envVar: string, secretFile: string, displayName?: string): Promise<string>;
 //# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAahG;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAQjB"}
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAahG;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/dist/secrets.min.js

@@ -1,7 +1,7 @@
 import {
   loadSecret,
   loadSecretOrThrow
-} from "./chunk-XAFSYOU2.min.js";
+} from "./chunk-IUNRH65Q.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   loadSecret,

package/dist/watcher.d.ts

@@ -17,8 +17,45 @@ export interface WatchOptions {
     onOpen?: () => void;
     onClose?: (event: CloseEvent) => void;
 }
+export interface IpnsWatcherOptions {
+    onUpdate: (record: W3NameRecord) => void | Promise<void>;
+    onError?: (error: Error | Event) => void;
+    onConnected?: () => void;
+    onDisconnected?: () => void;
+    /** Initial backoff delay in ms (default: 5000) */
+    initialBackoff?: number;
+    /** Max backoff delay in ms (default: 900000 = 15min) */
+    maxBackoff?: number;
+}
+/**
+ * Low-level WebSocket watcher for IPNS (no reconnect logic)
+ * @internal Use IpnsWatcher for robust watching with auto-reconnect
+ */
+export declare function watchNameRaw(name: string, options: WatchOptions): WatchSubscription;
+/**
+ * Robust IPNS watcher with auto-reconnect and catch-up logic
+ */
+export declare class IpnsWatcher {
+    private name;
+    private options;
+    private subscription;
+    private backoffDelay;
+    private lastKnownValue;
+    private stopped;
+    private reconnectTimeout;
+    constructor(name: string, options: IpnsWatcherOptions);
+    start(): void;
+    stop(): void;
+    private connect;
+    private scheduleReconnect;
+    /**
+     * Resolve current IPNS value via HTTP API
+     */
+    private resolveCurrentValue;
+    private checkForMissedUpdates;
+}
 /**
- * Subscribe to IPNS name updates via WebSocket
+ * Subscribe to IPNS name updates with auto-reconnect and catch-up logic
  */
-export declare function watchName(name: string, options: WatchOptions): WatchSubscription;
+export declare function watchName(name: string, options: IpnsWatcherOptions): IpnsWatcher;
 //# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,EAAE,EAAE,SAAS,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,KAAK,IAAI,CAAA;IACxC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACrC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,iBAAiB,CAuChF"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,EAAE,EAAE,SAAS,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,KAAK,IAAI,CAAA;IACxC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACrC;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,KAAK,IAAI,CAAA;IACxC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,iBAAiB,CAuCnF;AAED;;GAEG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,OAAO,CAId;IACD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;IAarD,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,OAAO;IAsBf,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;YACW,mBAAmB;YAkBnB,qBAAqB;CAmBnC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAIhF"}

package/dist/watcher.min.js

@@ -1,9 +1,13 @@
 import {
-  watchName
-} from "./chunk-IAQU2NGT.min.js";
+  IpnsWatcher,
+  watchName,
+  watchNameRaw
+} from "./chunk-GB53WLYA.min.js";
 import "./chunk-MZUPFLFH.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
-  watchName
+  IpnsWatcher,
+  watchName,
+  watchNameRaw
 };
 //# sourceMappingURL=watcher.min.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wovin/daemon-utils",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "type": "module",
   "main": "./dist/index.min.js",
   "module": "./dist/index.min.js",
@@ -18,8 +18,8 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@wovin/core": "^0.0.18",
-    "@wovin/connect-ucan-store-proxy": "^0.0.18"
+    "@wovin/core": "0.0.20",
+    "@wovin/connect-ucan-store-proxy": "0.0.20"
   },
   "dependencies": {
     "besonders-logger": "1.0.2",
@@ -29,8 +29,11 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.21",
+    "@wovin/connect-ucan-store-proxy": "0.0.20",
+    "@wovin/core": "0.0.20",
     "concurrently": "^8.2.2",
     "tsup": "^8.5.0",
+    "tsx": "^4.19.2",
     "typescript": "^5.9.2",
     "tsupconfig": "^0.0.0"
   },
@@ -41,6 +44,7 @@
     "dev": "concurrently \"pnpm dev:code\" \"pnpm dev:types\"",
     "dev:code": "tsup --watch",
     "dev:types": "tsc --emitDeclarationOnly --declaration --watch",
+    "test": "tsx test.ts",
     "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
     "pub": "npm publish --tag latest --access=public"
   }

package/dist/chunk-IAQU2NGT.min.js

@@ -1,46 +0,0 @@
-import {
-  g
-} from "./chunk-MZUPFLFH.min.js";
-
-// src/watcher.ts
-var { WARN, LOG, DEBUG, ERROR } = g.setup(g.INFO);
-var NAME_WS_URL = "wss://name.web3.storage/name";
-function watchName(name, options) {
-  const url = `${NAME_WS_URL}/${name}/watch`;
-  DEBUG("[w3name-watch] connecting to", url);
-  const ws = new WebSocket(url);
-  ws.onopen = () => {
-    LOG("[w3name-watch] connected to", name);
-    options.onOpen?.();
-  };
-  ws.onmessage = (event) => {
-    try {
-      const record = JSON.parse(event.data);
-      DEBUG("[w3name-watch] received update for", name, record);
-      options.onUpdate(record);
-    } catch (err) {
-      WARN("[w3name-watch] failed to parse message:", event.data, err);
-      options.onError?.(err instanceof Error ? err : new Error(String(err)));
-    }
-  };
-  ws.onerror = (event) => {
-    ERROR("[w3name-watch] error for", name, event);
-    options.onError?.(event);
-  };
-  ws.onclose = (event) => {
-    DEBUG("[w3name-watch] closed for", name, "code:", event.code, "reason:", event.reason);
-    options.onClose?.(event);
-  };
-  return {
-    close: () => {
-      DEBUG("[w3name-watch] closing connection for", name);
-      ws.close();
-    },
-    ws
-  };
-}
-
-export {
-  watchName
-};
-//# sourceMappingURL=chunk-IAQU2NGT.min.js.map

package/dist/chunk-IAQU2NGT.min.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/watcher.ts"],"sourcesContent":["/**\n * IPNS Thread Watcher\n * Watches an IPNS thread for new audio files via WebSocket\n */\n\nimport { Logger } from 'besonders-logger'\n\nconst { WARN, LOG, DEBUG, ERROR } = Logger.setup(Logger.INFO)\n\nconst NAME_WS_URL = 'wss://name.web3.storage/name'\n\nexport interface W3NameRecord {\n\tvalue: string // e.g. \"/ipfs/bafybeig...\"\n\tseq?: number\n\tvalidity?: string\n}\n\nexport interface WatchSubscription {\n\tclose: () => void\n\tws: WebSocket\n}\n\nexport interface WatchOptions {\n\tonUpdate: (record: W3NameRecord) => void\n\tonError?: (error: Event | Error) => void\n\tonOpen?: () => void\n\tonClose?: (event: CloseEvent) => void\n}\n\n/**\n * Subscribe to IPNS name updates via WebSocket\n */\nexport function watchName(name: string, options: WatchOptions): WatchSubscription {\n\tconst url = `${NAME_WS_URL}/${name}/watch`\n\tDEBUG('[w3name-watch] connecting to', url)\n\n\tconst ws = new WebSocket(url)\n\n\tws.onopen = () => {\n\t\tLOG('[w3name-watch] connected to', name)\n\t\toptions.onOpen?.()\n\t}\n\n\tws.onmessage = (event) => {\n\t\ttry {\n\t\t\tconst record: W3NameRecord = JSON.parse(event.data)\n\t\t\tDEBUG('[w3name-watch] received update for', name, record)\n\t\t\toptions.onUpdate(record)\n\t\t} catch (err) {\n\t\t\tWARN('[w3name-watch] failed to parse message:', event.data, err)\n\t\t\toptions.onError?.(err instanceof Error ? err : new Error(String(err)))\n\t\t}\n\t}\n\n\tws.onerror = (event) => {\n\t\tERROR('[w3name-watch] error for', name, event)\n\t\toptions.onError?.(event)\n\t}\n\n\tws.onclose = (event) => {\n\t\tDEBUG('[w3name-watch] closed for', name, 'code:', event.code, 'reason:', event.reason)\n\t\toptions.onClose?.(event)\n\t}\n\n\treturn {\n\t\tclose: () => {\n\t\t\tDEBUG('[w3name-watch] closing connection for', name)\n\t\t\tws.close()\n\t\t},\n\t\tws,\n\t}\n}\n"],"mappings":";;;;;AAOA,IAAM,EAAE,MAAM,KAAK,OAAO,MAAM,IAAI,EAAO,MAAM,EAAO,IAAI;AAE5D,IAAM,cAAc;AAuBb,SAAS,UAAU,MAAc,SAA0C;AACjF,QAAM,MAAM,GAAG,WAAW,IAAI,IAAI;AAClC,QAAM,gCAAgC,GAAG;AAEzC,QAAM,KAAK,IAAI,UAAU,GAAG;AAE5B,KAAG,SAAS,MAAM;AACjB,QAAI,+BAA+B,IAAI;AACvC,YAAQ,SAAS;AAAA,EAClB;AAEA,KAAG,YAAY,CAAC,UAAU;AACzB,QAAI;AACH,YAAM,SAAuB,KAAK,MAAM,MAAM,IAAI;AAClD,YAAM,sCAAsC,MAAM,MAAM;AACxD,cAAQ,SAAS,MAAM;AAAA,IACxB,SAAS,KAAK;AACb,WAAK,2CAA2C,MAAM,MAAM,GAAG;AAC/D,cAAQ,UAAU,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;AAAA,IACtE;AAAA,EACD;AAEA,KAAG,UAAU,CAAC,UAAU;AACvB,UAAM,4BAA4B,MAAM,KAAK;AAC7C,YAAQ,UAAU,KAAK;AAAA,EACxB;AAEA,KAAG,UAAU,CAAC,UAAU;AACvB,UAAM,6BAA6B,MAAM,SAAS,MAAM,MAAM,WAAW,MAAM,MAAM;AACrF,YAAQ,UAAU,KAAK;AAAA,EACxB;AAEA,SAAO;AAAA,IACN,OAAO,MAAM;AACZ,YAAM,yCAAyC,IAAI;AACnD,SAAG,MAAM;AAAA,IACV;AAAA,IACA;AAAA,EACD;AACD;","names":[]}

package/dist/chunk-XAFSYOU2.min.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/secrets.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises'\n\n/**\n * Utility functions for loading API keys from environment variables or secret files\n */\n\n/**\n * Load an API key from environment variable or secret file\n * @param envVar - Environment variable name (e.g., 'REGOLO_API_KEY')\n * @param secretFile - Path to secret file (e.g., 'secret/regolo')\n * @returns The API key, or undefined if not found\n */\nexport async function loadSecret(envVar: string, secretFile: string): Promise<string | undefined> {\n\t// Try environment variable first\n\tconst envValue = process.env[envVar]\n\tif (envValue) return envValue\n\n\t// Fall back to secret file\n\ttry {\n\t\tconst fileContent = await readFile(secretFile, 'utf-8')\n\t\treturn fileContent.trim() || undefined\n\t} catch {\n\t\t// File doesn't exist or can't be read\n\t\treturn undefined\n\t}\n}\n\n/**\n * Load an API key from environment variable or secret file, with error handling\n * @param envVar - Environment variable name\n * @param secretFile - Path to secret file\n * @param displayName - Human-readable name for error messages (e.g., 'REGOLO API key')\n * @returns The API key\n * @throws If the key is not found\n */\nexport async function loadSecretOrThrow(\n\tenvVar: string,\n\tsecretFile: string,\n\tdisplayName: string,\n): Promise<string> {\n\tconst secret = await loadSecret(envVar, secretFile)\n\tif (!secret) {\n\t\tthrow new Error(\n\t\t\t`${displayName} not found. Set ${envVar} environment variable or create ${secretFile} file`,\n\t\t)\n\t}\n\treturn secret\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AAYzB,eAAsB,WAAW,QAAgB,YAAiD;AAEjG,QAAM,WAAW,QAAQ,IAAI,MAAM;AACnC,MAAI,SAAU,QAAO;AAGrB,MAAI;AACH,UAAM,cAAc,MAAM,SAAS,YAAY,OAAO;AACtD,WAAO,YAAY,KAAK,KAAK;AAAA,EAC9B,QAAQ;AAEP,WAAO;AAAA,EACR;AACD;AAUA,eAAsB,kBACrB,QACA,YACA,aACkB;AAClB,QAAM,SAAS,MAAM,WAAW,QAAQ,UAAU;AAClD,MAAI,CAAC,QAAQ;AACZ,UAAM,IAAI;AAAA,MACT,GAAG,WAAW,mBAAmB,MAAM,mCAAmC,UAAU;AAAA,IACrF;AAAA,EACD;AACA,SAAO;AACR;","names":[]}