@wovin/daemon-utils 0.0.18

package/dist/chunk-XAFSYOU2.min.js

@@ -0,0 +1,27 @@
+// src/secrets.ts
+import { readFile } from "fs/promises";
+async function loadSecret(envVar, secretFile) {
+  const envValue = process.env[envVar];
+  if (envValue) return envValue;
+  try {
+    const fileContent = await readFile(secretFile, "utf-8");
+    return fileContent.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function loadSecretOrThrow(envVar, secretFile, displayName) {
+  const secret = await loadSecret(envVar, secretFile);
+  if (!secret) {
+    throw new Error(
+      `${displayName} not found. Set ${envVar} environment variable or create ${secretFile} file`
+    );
+  }
+  return secret;
+}
+
+export {
+  loadSecret,
+  loadSecretOrThrow
+};
+//# sourceMappingURL=chunk-XAFSYOU2.min.js.map

package/dist/chunk-XAFSYOU2.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 (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":[]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './secrets';
+export * from './ipns';
+export * from './ipnsThread';
+export * from './managedThread';
+export * from './watcher';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,WAAW,CAAA"}

package/dist/index.min.js

@@ -0,0 +1,33 @@
+import {
+  ManagedThread
+} from "./chunk-FVJJD45W.min.js";
+import {
+  initIpnsThread,
+  publishIpnsThread
+} from "./chunk-THCR5KJ7.min.js";
+import {
+  generateIpnsKey,
+  getW3NamePublic,
+  publishIPNS
+} from "./chunk-E3XT46LP.min.js";
+import {
+  loadSecret,
+  loadSecretOrThrow
+} from "./chunk-XAFSYOU2.min.js";
+import {
+  watchName
+} from "./chunk-IAQU2NGT.min.js";
+import "./chunk-MZUPFLFH.min.js";
+import "./chunk-PHITDXZT.min.js";
+export {
+  ManagedThread,
+  generateIpnsKey,
+  getW3NamePublic,
+  initIpnsThread,
+  loadSecret,
+  loadSecretOrThrow,
+  publishIPNS,
+  publishIpnsThread,
+  watchName
+};
+//# sourceMappingURL=index.min.js.map

package/dist/index.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/ipns.d.ts

@@ -0,0 +1,6 @@
+import { CID } from 'multiformats/cid';
+import * as W3Name from 'w3name';
+export declare function generateIpnsKey(): Promise<W3Name.WritableName>;
+export declare function publishIPNS(ipnsPrivateKey: Uint8Array, cid: CID): Promise<void>;
+export declare function getW3NamePublic(pk: Uint8Array): Promise<string>;
+//# sourceMappingURL=ipns.d.ts.map

package/dist/ipns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipns.d.ts","sourceRoot":"","sources":["../src/ipns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAIhC,wBAAsB,eAAe,iCAEpC;AACD,wBAAsB,WAAW,CAAC,cAAc,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,iBAYrE;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,UAAU,mBAGnD"}

package/dist/ipns.min.js

@@ -0,0 +1,13 @@
+import {
+  generateIpnsKey,
+  getW3NamePublic,
+  publishIPNS
+} from "./chunk-E3XT46LP.min.js";
+import "./chunk-MZUPFLFH.min.js";
+import "./chunk-PHITDXZT.min.js";
+export {
+  generateIpnsKey,
+  getW3NamePublic,
+  publishIPNS
+};
+//# sourceMappingURL=ipns.min.js.map

package/dist/ipns.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/ipnsThread.d.ts

@@ -0,0 +1,36 @@
+import { type AgentHash, type WriteableThread } from '@wovin/core';
+import { UcanStoreProxyConnector } from '@wovin/connect-ucan-store-proxy';
+export interface IpnsThreadInit {
+    thread: WriteableThread;
+    ipnsName: string;
+    ipnsKey: Uint8Array;
+    generated: boolean;
+}
+export interface InitIpnsThreadParams {
+    keyPath: string;
+    threadName?: string;
+    wovinConnector: UcanStoreProxyConnector;
+    agentHash: AgentHash;
+    agentString: string;
+}
+/**
+ * Initialize an IPNS-backed wovin thread with consistent key management and data loading.
+ *
+ * Pattern used for both main thread and transcript thread:
+ * 1. Load or generate IPNS key from file
+ * 2. Create thread
+ * 3. If key existed, fetch previous data from IPNS
+ * 4. Insert agent metadata
+ */
+export declare function initIpnsThread(params: InitIpnsThreadParams): Promise<IpnsThreadInit>;
+/**
+ * Publish a wovin thread to IPNS.
+ * Shared pattern for all IPNS-backed threads.
+ */
+export declare function publishIpnsThread(agent: any, // AppAgent type
+thread: WriteableThread, publication: {
+    id: string;
+    name: string;
+    pk: Uint8Array;
+}, wovinConnector: UcanStoreProxyConnector, first?: boolean, note3Url?: string): Promise<void>;
+//# sourceMappingURL=ipnsThread.d.ts.map

package/dist/ipnsThread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipnsThread.d.ts","sourceRoot":"","sources":["../src/ipnsThread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAuD,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAwBzE,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,UAAU,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,uBAAuB,CAAA;IACvC,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4D1F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,GAAG,EAAE,gBAAgB;AAC5B,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,EACzD,cAAc,EAAE,uBAAuB,EACvC,KAAK,UAAQ,EACb,QAAQ,SAAoB,iBA6B5B"}

package/dist/ipnsThread.min.js

@@ -0,0 +1,12 @@
+import {
+  initIpnsThread,
+  publishIpnsThread
+} from "./chunk-THCR5KJ7.min.js";
+import "./chunk-E3XT46LP.min.js";
+import "./chunk-MZUPFLFH.min.js";
+import "./chunk-PHITDXZT.min.js";
+export {
+  initIpnsThread,
+  publishIpnsThread
+};
+//# sourceMappingURL=ipnsThread.min.js.map

package/dist/ipnsThread.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/managedThread.d.ts

@@ -0,0 +1,65 @@
+import type { AppAgent, ApplogForInsert, WriteableThread } from '@wovin/core';
+import type { UcanStoreProxyConnector } from '@wovin/connect-ucan-store-proxy';
+/**
+ * Parameters for creating a ManagedThread
+ */
+export interface ManagedThreadParams {
+    thread: WriteableThread;
+    ipnsName: string;
+    ipnsKey: Uint8Array;
+    threadName: string;
+    agent: AppAgent;
+    wovinConnector: UcanStoreProxyConnector;
+    note3Url?: string;
+}
+/**
+ * A managed thread that encapsulates thread operations and publishing.
+ *
+ * Benefits:
+ * - Automatic runInAction wrapping for inserts
+ * - Simple push() API instead of 7 parameters
+ * - All thread metadata in one place
+ * - Type-safe operations
+ */
+export declare class ManagedThread {
+    private _thread;
+    private _ipnsName;
+    private _ipnsKey;
+    private _threadName;
+    private _agent;
+    private _wovinConnector;
+    private _note3Url?;
+    constructor(params: ManagedThreadParams);
+    /**
+     * Insert applogs into the thread.
+     * Automatically wraps with runInAction for MobX reactivity.
+     */
+    insert(applogs: ApplogForInsert[]): void;
+    /**
+     * Insert raw applogs into the thread (used during initialization).
+     * Automatically wraps with runInAction for MobX reactivity.
+     */
+    insertRaw(applogs: any[]): void;
+    /**
+     * Push the thread to IPNS.
+     * Handles all publication logic internally.
+     */
+    push(first?: boolean): Promise<void>;
+    /**
+     * Get read-only access to the underlying thread
+     */
+    get thread(): WriteableThread;
+    /**
+     * Get the IPNS name for this thread
+     */
+    get ipnsName(): string;
+    /**
+     * Get the thread name
+     */
+    get threadName(): string;
+    /**
+     * Get the agent hash from the agent
+     */
+    get agentHash(): string;
+}
+//# sourceMappingURL=managedThread.d.ts.map

package/dist/managedThread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managedThread.d.ts","sourceRoot":"","sources":["../src/managedThread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAO9E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,UAAU,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,QAAQ,CAAA;IACf,cAAc,EAAE,uBAAuB,CAAA;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,SAAS,CAAC,CAAQ;gBAEd,MAAM,EAAE,mBAAmB;IAUvC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI;IAOxC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI;IAO/B;;;OAGG;IACG,IAAI,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxC;;OAEG;IACH,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;CACD"}

package/dist/managedThread.min.js

@@ -0,0 +1,11 @@
+import {
+  ManagedThread
+} from "./chunk-FVJJD45W.min.js";
+import "./chunk-THCR5KJ7.min.js";
+import "./chunk-E3XT46LP.min.js";
+import "./chunk-MZUPFLFH.min.js";
+import "./chunk-PHITDXZT.min.js";
+export {
+  ManagedThread
+};
+//# sourceMappingURL=managedThread.min.js.map

package/dist/managedThread.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/secrets.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Utility functions for loading API keys from environment variables or secret files
+ */
+/**
+ * Load an API key from environment variable or secret file
+ * @param envVar - Environment variable name (e.g., 'REGOLO_API_KEY')
+ * @param secretFile - Path to secret file (e.g., 'secret/regolo')
+ * @returns The API key, or undefined if not found
+ */
+export declare function loadSecret(envVar: string, secretFile: string): Promise<string | undefined>;
+/**
+ * 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')
+ * @returns The API key
+ * @throws If the key is not found
+ */
+export declare function loadSecretOrThrow(envVar: string, secretFile: string, displayName: string): Promise<string>;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +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"}

package/dist/secrets.min.js

@@ -0,0 +1,10 @@
+import {
+  loadSecret,
+  loadSecretOrThrow
+} from "./chunk-XAFSYOU2.min.js";
+import "./chunk-PHITDXZT.min.js";
+export {
+  loadSecret,
+  loadSecretOrThrow
+};
+//# sourceMappingURL=secrets.min.js.map

package/dist/secrets.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/watcher.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IPNS Thread Watcher
+ * Watches an IPNS thread for new audio files via WebSocket
+ */
+export interface W3NameRecord {
+    value: string;
+    seq?: number;
+    validity?: string;
+}
+export interface WatchSubscription {
+    close: () => void;
+    ws: WebSocket;
+}
+export interface WatchOptions {
+    onUpdate: (record: W3NameRecord) => void;
+    onError?: (error: Event | Error) => void;
+    onOpen?: () => void;
+    onClose?: (event: CloseEvent) => void;
+}
+/**
+ * Subscribe to IPNS name updates via WebSocket
+ */
+export declare function watchName(name: string, options: WatchOptions): WatchSubscription;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +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"}

package/dist/watcher.min.js

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

package/dist/watcher.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@wovin/daemon-utils",
+  "version": "0.0.18",
+  "type": "module",
+  "main": "./dist/index.min.js",
+  "module": "./dist/index.min.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.min.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "./dist/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@wovin/core": "^0.0.18",
+    "@wovin/connect-ucan-store-proxy": "^0.0.18"
+  },
+  "dependencies": {
+    "besonders-logger": "1.0.2",
+    "mobx": "^6.13.7",
+    "multiformats": "^13.4.1",
+    "w3name": "^1.0.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "concurrently": "^8.2.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "tsupconfig": "^0.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist/ && concurrently \"pnpm build:code\" \"pnpm build:types\"",
+    "build:code": "tsup",
+    "build:types": "tsc --emitDeclarationOnly --declaration",
+    "dev": "concurrently \"pnpm dev:code\" \"pnpm dev:types\"",
+    "dev:code": "tsup --watch",
+    "dev:types": "tsc --emitDeclarationOnly --declaration --watch",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "pub": "npm publish --tag latest --access=public"
+  }
+}