@routstr/sdk 0.3.9 → 0.3.10

package/dist/discovery/index.d.mts

@@ -1,6 +1,6 @@
 import { D as DiscoveryAdapter } from '../interfaces-Cv1k2EUK.mjs';
 import { S as SdkLogger, e as Model, k as ProviderInfo } from '../types-_21yYFZG.mjs';
-import { EventStore } from 'applesauce-core';
+import { IEventDatabase, EventStore } from 'applesauce-core';
 
 /**
  * ModelManager class for discovering, fetching, and managing models from providers
@@ -8,6 +8,18 @@ import { EventStore } from 'applesauce-core';
  * (lowest cost) across multiple providers
  */
 
+type SqliteStatement = {
+    run?: (...params: any[]) => unknown;
+    get?: (...params: any[]) => any;
+};
+type PersistentEventDatabase = IEventDatabase & {
+    db?: {
+        exec: (sql: string) => void;
+        prepare: (sql: string) => SqliteStatement;
+    };
+    close?: () => void;
+};
+type PersistentEventDatabaseFactory = (dbPath: string) => Promise<PersistentEventDatabase> | PersistentEventDatabase;
 /**
  * Configuration for ModelManager
  */
@@ -22,13 +34,24 @@ interface ModelManagerConfig {
     cacheTTL?: number;
     /** Nostr pubkey for routstr review/model events (kind 38425/38423). Defaults to routstr's key. */
     routstrPubkey?: string;
+    /** Nostr relay URLs for provider/model discovery.
+     * When set, these relays are used for all Nostr queries (kinds 38421, 38423, 38425).
+     * When unset, each method uses its own default relay set. */
+    nostrRelays?: string[];
     /** Optional injectable logger */
     logger?: SdkLogger;
-    /** Path to SQLite database for persistent Nostr event storage.
+    /** Path to database for persistent Nostr event storage.
      * If provided, events fetched by ModelManager from relays (kinds 38421,
      * 38423, 38425) are persisted and survive process restarts. The underlying
-     * EventStore can also be accessed for advanced/manual event management. */
+     * EventStore can also be accessed for advanced/manual event management.
+     *
+     * Runtime-specific SQLite implementations are intentionally not imported by
+     * the browser-safe default SDK entrypoint. Use @routstr/sdk/node or
+     * @routstr/sdk/bun to get a ModelManager preconfigured with a SQLite-backed
+     * persistentEventDatabaseFactory, or inject your own factory here. */
     eventStoreDbPath?: string;
+    /** Factory used with eventStoreDbPath to create the persistent event DB. */
+    persistentEventDatabaseFactory?: PersistentEventDatabaseFactory;
 }
 /**
  * ModelManager handles all model discovery and caching logic
@@ -41,6 +64,7 @@ declare class ModelManager {
     private readonly includeProviderUrls;
     private readonly excludeProviderUrls;
     private readonly routstrPubkey;
+    private readonly nostrRelays;
     private readonly logger;
     private providerNodePubkeysByUrl;
     /** Persistent event store for relay-fetched events (null if not configured/initialized) */
@@ -48,6 +72,7 @@ declare class ModelManager {
     private eventStoreDb;
     private eventStoreInitPromise;
     private readonly eventStoreDbPath?;
+    private readonly persistentEventDatabaseFactory?;
     constructor(adapter: DiscoveryAdapter, config?: ModelManagerConfig);
     /**
      * Get the list of bootstrapped provider base URLs
@@ -90,6 +115,11 @@ declare class ModelManager {
      * @throws ProviderBootstrapError if all providers fail to fetch
      */
     bootstrapProviders(torMode?: boolean, forceRefresh?: boolean): Promise<string[]>;
+    /**
+     * Resolve Nostr relay URLs for a given use case.
+     * Returns user-configured relays if set, otherwise the provided defaults.
+     */
+    private getNostrRelays;
     /**
      * Bootstrap providers from Nostr network (kind 38421)
      * @param kind The Nostr kind to fetch

package/dist/discovery/index.d.ts

@@ -1,6 +1,6 @@
 import { D as DiscoveryAdapter } from '../interfaces-iL7CWeG5.js';
 import { S as SdkLogger, e as Model, k as ProviderInfo } from '../types-_21yYFZG.js';
-import { EventStore } from 'applesauce-core';
+import { IEventDatabase, EventStore } from 'applesauce-core';
 
 /**
  * ModelManager class for discovering, fetching, and managing models from providers
@@ -8,6 +8,18 @@ import { EventStore } from 'applesauce-core';
  * (lowest cost) across multiple providers
  */
 
+type SqliteStatement = {
+    run?: (...params: any[]) => unknown;
+    get?: (...params: any[]) => any;
+};
+type PersistentEventDatabase = IEventDatabase & {
+    db?: {
+        exec: (sql: string) => void;
+        prepare: (sql: string) => SqliteStatement;
+    };
+    close?: () => void;
+};
+type PersistentEventDatabaseFactory = (dbPath: string) => Promise<PersistentEventDatabase> | PersistentEventDatabase;
 /**
  * Configuration for ModelManager
  */
@@ -22,13 +34,24 @@ interface ModelManagerConfig {
     cacheTTL?: number;
     /** Nostr pubkey for routstr review/model events (kind 38425/38423). Defaults to routstr's key. */
     routstrPubkey?: string;
+    /** Nostr relay URLs for provider/model discovery.
+     * When set, these relays are used for all Nostr queries (kinds 38421, 38423, 38425).
+     * When unset, each method uses its own default relay set. */
+    nostrRelays?: string[];
     /** Optional injectable logger */
     logger?: SdkLogger;
-    /** Path to SQLite database for persistent Nostr event storage.
+    /** Path to database for persistent Nostr event storage.
      * If provided, events fetched by ModelManager from relays (kinds 38421,
      * 38423, 38425) are persisted and survive process restarts. The underlying
-     * EventStore can also be accessed for advanced/manual event management. */
+     * EventStore can also be accessed for advanced/manual event management.
+     *
+     * Runtime-specific SQLite implementations are intentionally not imported by
+     * the browser-safe default SDK entrypoint. Use @routstr/sdk/node or
+     * @routstr/sdk/bun to get a ModelManager preconfigured with a SQLite-backed
+     * persistentEventDatabaseFactory, or inject your own factory here. */
     eventStoreDbPath?: string;
+    /** Factory used with eventStoreDbPath to create the persistent event DB. */
+    persistentEventDatabaseFactory?: PersistentEventDatabaseFactory;
 }
 /**
  * ModelManager handles all model discovery and caching logic
@@ -41,6 +64,7 @@ declare class ModelManager {
     private readonly includeProviderUrls;
     private readonly excludeProviderUrls;
     private readonly routstrPubkey;
+    private readonly nostrRelays;
     private readonly logger;
     private providerNodePubkeysByUrl;
     /** Persistent event store for relay-fetched events (null if not configured/initialized) */
@@ -48,6 +72,7 @@ declare class ModelManager {
     private eventStoreDb;
     private eventStoreInitPromise;
     private readonly eventStoreDbPath?;
+    private readonly persistentEventDatabaseFactory?;
     constructor(adapter: DiscoveryAdapter, config?: ModelManagerConfig);
     /**
      * Get the list of bootstrapped provider base URLs
@@ -90,6 +115,11 @@ declare class ModelManager {
      * @throws ProviderBootstrapError if all providers fail to fetch
      */
     bootstrapProviders(torMode?: boolean, forceRefresh?: boolean): Promise<string[]>;
+    /**
+     * Resolve Nostr relay URLs for a given use case.
+     * Returns user-configured relays if set, otherwise the provided defaults.
+     */
+    private getNostrRelays;
     /**
      * Bootstrap providers from Nostr network (kind 38421)
      * @param kind The Nostr kind to fetch

package/dist/discovery/index.js

@@ -34,9 +34,6 @@ var NoProvidersAvailableError = class extends Error {
     this.name = "NoProvidersAvailableError";
   }
 };
-function isBunRuntime() {
-  return typeof Bun !== "undefined";
-}
 var ModelManager = class _ModelManager {
   constructor(adapter, config = {}) {
     this.adapter = adapter;
@@ -45,8 +42,10 @@ var ModelManager = class _ModelManager {
     this.includeProviderUrls = config.includeProviderUrls || [];
     this.excludeProviderUrls = config.excludeProviderUrls || [];
     this.routstrPubkey = config.routstrPubkey || "4ad6fa2d16e2a9b576c863b4cf7404a70d4dc320c0c447d10ad6ff58993eacc8";
+    this.nostrRelays = config.nostrRelays;
     this.logger = (config.logger ?? consoleLogger).child("ModelManager");
     this.eventStoreDbPath = config.eventStoreDbPath;
+    this.persistentEventDatabaseFactory = config.persistentEventDatabaseFactory;
   }
   adapter;
   cacheTTL;
@@ -54,6 +53,7 @@ var ModelManager = class _ModelManager {
   includeProviderUrls;
   excludeProviderUrls;
   routstrPubkey;
+  nostrRelays;
   logger;
   providerNodePubkeysByUrl = /* @__PURE__ */ new Map();
   /** Persistent event store for relay-fetched events (null if not configured/initialized) */
@@ -61,6 +61,7 @@ var ModelManager = class _ModelManager {
   eventStoreDb = null;
   eventStoreInitPromise = null;
   eventStoreDbPath;
+  persistentEventDatabaseFactory;
   /**
    * Get the list of bootstrapped provider base URLs
    * @returns Array of provider base URLs
@@ -89,7 +90,7 @@ var ModelManager = class _ModelManager {
         } catch (error) {
           this.eventStoreInitPromise = null;
           throw new Error(
-            `applesauce-sqlite with a supported SQLite driver is required for persistent Nostr event storage. Bun uses bun:sqlite; Node.js uses better-sqlite3. Install optional dependencies or omit eventStoreDbPath. (${error})`
+            `Persistent Nostr event storage requires a runtime-specific database factory. Use @routstr/sdk/node, @routstr/sdk/bun, inject persistentEventDatabaseFactory, or omit eventStoreDbPath. (${error})`
           );
         }
       })();
@@ -104,16 +105,15 @@ var ModelManager = class _ModelManager {
     return this.ensureEventStore();
   }
   async createPersistentEventDatabase() {
-    if (isBunRuntime()) {
-      const { BunSqliteEventDatabase } = await import('applesauce-sqlite/bun');
-      return new BunSqliteEventDatabase(
-        this.eventStoreDbPath
+    if (!this.eventStoreDbPath) {
+      throw new Error("eventStoreDbPath is required");
+    }
+    if (!this.persistentEventDatabaseFactory) {
+      throw new Error(
+        "persistentEventDatabaseFactory is required. Import ModelManager from @routstr/sdk/node or @routstr/sdk/bun for SQLite-backed persistent event storage."
       );
     }
-    const { BetterSqlite3EventDatabase } = await import('applesauce-sqlite/better-sqlite3');
-    return new BetterSqlite3EventDatabase(
-      this.eventStoreDbPath
-    );
+    return this.persistentEventDatabaseFactory(this.eventStoreDbPath);
   }
   /** Close the persistent event store database handle, if configured. */
   closeEventStore() {
@@ -226,6 +226,13 @@ var ModelManager = class _ModelManager {
     }
     return this.bootstrapFromHttp(torMode, forceRefresh);
   }
+  /**
+   * Resolve Nostr relay URLs for a given use case.
+   * Returns user-configured relays if set, otherwise the provided defaults.
+   */
+  getNostrRelays(defaults) {
+    return this.nostrRelays && this.nostrRelays.length > 0 ? this.nostrRelays : defaults;
+  }
   /**
    * Bootstrap providers from Nostr network (kind 38421)
    * @param kind The Nostr kind to fetch
@@ -233,11 +240,11 @@ var ModelManager = class _ModelManager {
    * @returns Array of provider base URLs
    */
   async bootstrapFromNostr(kind, torMode, forceRefresh = false) {
-    const DEFAULT_RELAYS = [
+    const relays = this.getNostrRelays([
       "wss://relay.primal.net",
       "wss://nos.lol",
       "wss://relay.damus.io"
-    ];
+    ]);
     const cached = await this.getCachedNostrEvents(
       { kinds: [kind] },
       this.cacheTTL,
@@ -248,7 +255,7 @@ var ModelManager = class _ModelManager {
       const pool = new applesauceRelay.RelayPool();
       const timeoutMs = 5e3;
       await new Promise((resolve) => {
-        pool.req(DEFAULT_RELAYS, {
+        pool.req(relays, {
           kinds: [kind],
           limit: 100
         }).pipe(
@@ -420,16 +427,16 @@ var ModelManager = class _ModelManager {
       );
       let sessionEvents = cached;
       if (cached.length === 0) {
-        const LGTM_RELAYS = [
+        const lgtmRelays = this.getNostrRelays([
           "wss://relay.primal.net",
           "wss://nos.lol",
           "wss://relay.damus.io",
           "wss://relay.routstr.com"
-        ];
+        ]);
         const pool = new applesauceRelay.RelayPool();
         const timeoutMs = 5e3;
         await new Promise((resolve) => {
-          pool.req(LGTM_RELAYS, {
+          pool.req(lgtmRelays, {
             kinds: [38425],
             "#t": ["lgtm"],
             limit: 500,
@@ -671,11 +678,11 @@ var ModelManager = class _ModelManager {
         return cachedModels;
       }
     }
-    const DEFAULT_RELAYS = [
+    const relays = this.getNostrRelays([
       "wss://relay.damus.io",
       "wss://nos.lol",
       "wss://relay.routstr.com"
-    ];
+    ]);
     const cached = await this.getCachedNostrEvents(
       { kinds: [38423], "#d": ["routstr-21-models"], authors: [this.routstrPubkey] },
       this.cacheTTL,
@@ -686,7 +693,7 @@ var ModelManager = class _ModelManager {
       const pool = new applesauceRelay.RelayPool();
       const timeoutMs = 5e3;
       await new Promise((resolve) => {
-        pool.req(DEFAULT_RELAYS, {
+        pool.req(relays, {
           kinds: [38423],
           "#d": ["routstr-21-models"],
           limit: 1,