@routstr/sdk 0.3.7 → 0.3.9

package/dist/storage/index.d.mts

@@ -0,0 +1,113 @@
+import { a as StorageDriver, U as UsageTrackingDriver, b as UsageTrackingEntry, S as SdkStore } from '../store-C6dfj1cc.mjs';
+export { L as ListUsageTrackingOptions, c as createDiscoveryAdapterFromStore, d as createProviderRegistryFromStore, e as createSdkStore, f as createStorageAdapterFromStore } from '../store-C6dfj1cc.mjs';
+import { S as SdkLogger } from '../types-_21yYFZG.mjs';
+import { D as DiscoveryAdapter } from '../interfaces-Cv1k2EUK.mjs';
+import { P as ProviderRegistry, S as StorageAdapter } from '../interfaces-Csn8Uq04.mjs';
+export { X as XCashuTokenEntry } from '../interfaces-Csn8Uq04.mjs';
+import 'zustand/vanilla';
+
+interface IndexedDBUsageTrackingDriverOptions {
+    dbName?: string;
+    storeName?: string;
+    legacyStorageDriver?: StorageDriver;
+}
+declare const createIndexedDBUsageTrackingDriver: (options?: IndexedDBUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+interface SqliteUsageTrackingDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+    legacyStorageDriver?: StorageDriver;
+}
+declare const createSqliteUsageTrackingDriver: (options?: SqliteUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+interface BunSqliteUsageTrackingDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+    legacyStorageDriver?: StorageDriver;
+    sqlite?: {
+        Database: any;
+    };
+}
+declare const createBunSqliteUsageTrackingDriver: (options?: BunSqliteUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+declare const createMemoryUsageTrackingDriver: (seed?: UsageTrackingEntry[]) => UsageTrackingDriver;
+
+declare const localStorageDriver: StorageDriver;
+
+declare const createMemoryDriver: (seed?: Record<string, string>) => StorageDriver;
+
+interface SqliteDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+}
+declare const createSqliteDriver: (options?: SqliteDriverOptions) => StorageDriver;
+declare function createBunSqliteDriver(dbPath: string, options?: {
+    logger?: SdkLogger;
+}): Promise<StorageDriver>;
+
+interface IndexedDBDriverOptions {
+    dbName?: string;
+    storeName?: string;
+}
+declare const createIndexedDBDriver: (options?: IndexedDBDriverOptions) => StorageDriver;
+
+declare const SDK_STORAGE_KEYS: {
+    readonly MODELS_FROM_ALL_PROVIDERS: "modelsFromAllProviders";
+    readonly LAST_USED_MODEL: "lastUsedModel";
+    readonly BASE_URLS_LIST: "base_urls_list";
+    readonly DISABLED_PROVIDERS: "disabled_providers";
+    readonly MINTS_FROM_ALL_PROVIDERS: "mints_from_all_providers";
+    readonly INFO_FROM_ALL_PROVIDERS: "info_from_all_providers";
+    readonly LAST_MODELS_UPDATE: "lastModelsUpdate";
+    readonly LAST_BASE_URLS_UPDATE: "lastBaseUrlsUpdate";
+    readonly API_KEYS: "api_keys";
+    readonly CHILD_KEYS: "child_keys";
+    readonly XCASHU_TOKENS: "xcashu_tokens";
+    readonly ROUTSTR21_MODELS: "routstr21Models";
+    readonly LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate";
+    readonly CACHED_RECEIVE_TOKENS: "cached_receive_tokens";
+    readonly USAGE_TRACKING: "usage_tracking";
+    readonly CLIENT_IDS: "client_ids";
+    readonly FAILED_PROVIDERS: "failed_providers";
+    readonly LAST_FAILED: "last_failed";
+    readonly PROVIDERS_ON_COOLDOWN: "providers_on_cooldown";
+};
+
+/**
+ * Sharded DiscoveryAdapter
+ *
+ * Replaces the SQLite/IndexedDB ModelsDatabase layer with provider-scoped
+ * sharding over the existing key-value StorageDriver.
+ *
+ * Instead of one giant blob:
+ *   modelsFromAllProviders  →  Record<string, Model[]>
+ *   lastModelsUpdate        →  Record<string, number>
+ *
+ * We use provider-scoped keys:
+ *   models:provider:<encodedBaseUrl>           →  Model[]
+ *   models:provider_timestamp:<encodedBaseUrl>  →  number
+ *
+ * All model data is hydrated into memory at creation time so the
+ * synchronous DiscoveryAdapter contract is satisfied. Writes are
+ * fire-and-forget via void driver.setItem(...).
+ */
+
+interface ShardedDiscoveryAdapterOptions {
+    /** Key-value StorageDriver */
+    driver: StorageDriver;
+}
+declare const createShardedDiscoveryAdapter: (options: ShardedDiscoveryAdapterOptions) => Promise<DiscoveryAdapter>;
+declare const createProviderRegistryFromDiscoveryAdapter: (adapter: DiscoveryAdapter, logger?: SdkLogger) => ProviderRegistry;
+
+declare const getDefaultSdkDriver: () => StorageDriver;
+declare const getDefaultSdkStore: () => Promise<SdkStore>;
+declare const getDefaultUsageTrackingDriver: () => UsageTrackingDriver;
+/**
+ * Allow setting a custom usage tracking driver (useful for routstrd to use proper DB path)
+ */
+declare const setDefaultUsageTrackingDriver: (driver: UsageTrackingDriver) => void;
+declare const getDefaultDiscoveryAdapter: () => Promise<DiscoveryAdapter>;
+declare const getDefaultStorageAdapter: () => Promise<StorageAdapter>;
+declare const getDefaultProviderRegistry: () => Promise<ProviderRegistry>;
+
+export { DiscoveryAdapter, ProviderRegistry, SDK_STORAGE_KEYS, SdkStore, type ShardedDiscoveryAdapterOptions, StorageAdapter, StorageDriver, UsageTrackingDriver, UsageTrackingEntry, createBunSqliteDriver, createBunSqliteUsageTrackingDriver, createIndexedDBDriver, createIndexedDBUsageTrackingDriver, createMemoryDriver, createMemoryUsageTrackingDriver, createProviderRegistryFromDiscoveryAdapter, createShardedDiscoveryAdapter, createSqliteDriver, createSqliteUsageTrackingDriver, getDefaultDiscoveryAdapter, getDefaultProviderRegistry, getDefaultSdkDriver, getDefaultSdkStore, getDefaultStorageAdapter, getDefaultUsageTrackingDriver, localStorageDriver, setDefaultUsageTrackingDriver };

package/dist/storage/index.d.ts

@@ -0,0 +1,113 @@
+import { a as StorageDriver, U as UsageTrackingDriver, b as UsageTrackingEntry, S as SdkStore } from '../store-58VcEUoA.js';
+export { L as ListUsageTrackingOptions, c as createDiscoveryAdapterFromStore, d as createProviderRegistryFromStore, e as createSdkStore, f as createStorageAdapterFromStore } from '../store-58VcEUoA.js';
+import { S as SdkLogger } from '../types-_21yYFZG.js';
+import { D as DiscoveryAdapter } from '../interfaces-iL7CWeG5.js';
+import { P as ProviderRegistry, S as StorageAdapter } from '../interfaces-C-DYd9Jy.js';
+export { X as XCashuTokenEntry } from '../interfaces-C-DYd9Jy.js';
+import 'zustand/vanilla';
+
+interface IndexedDBUsageTrackingDriverOptions {
+    dbName?: string;
+    storeName?: string;
+    legacyStorageDriver?: StorageDriver;
+}
+declare const createIndexedDBUsageTrackingDriver: (options?: IndexedDBUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+interface SqliteUsageTrackingDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+    legacyStorageDriver?: StorageDriver;
+}
+declare const createSqliteUsageTrackingDriver: (options?: SqliteUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+interface BunSqliteUsageTrackingDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+    legacyStorageDriver?: StorageDriver;
+    sqlite?: {
+        Database: any;
+    };
+}
+declare const createBunSqliteUsageTrackingDriver: (options?: BunSqliteUsageTrackingDriverOptions) => UsageTrackingDriver;
+
+declare const createMemoryUsageTrackingDriver: (seed?: UsageTrackingEntry[]) => UsageTrackingDriver;
+
+declare const localStorageDriver: StorageDriver;
+
+declare const createMemoryDriver: (seed?: Record<string, string>) => StorageDriver;
+
+interface SqliteDriverOptions {
+    dbPath?: string;
+    tableName?: string;
+}
+declare const createSqliteDriver: (options?: SqliteDriverOptions) => StorageDriver;
+declare function createBunSqliteDriver(dbPath: string, options?: {
+    logger?: SdkLogger;
+}): Promise<StorageDriver>;
+
+interface IndexedDBDriverOptions {
+    dbName?: string;
+    storeName?: string;
+}
+declare const createIndexedDBDriver: (options?: IndexedDBDriverOptions) => StorageDriver;
+
+declare const SDK_STORAGE_KEYS: {
+    readonly MODELS_FROM_ALL_PROVIDERS: "modelsFromAllProviders";
+    readonly LAST_USED_MODEL: "lastUsedModel";
+    readonly BASE_URLS_LIST: "base_urls_list";
+    readonly DISABLED_PROVIDERS: "disabled_providers";
+    readonly MINTS_FROM_ALL_PROVIDERS: "mints_from_all_providers";
+    readonly INFO_FROM_ALL_PROVIDERS: "info_from_all_providers";
+    readonly LAST_MODELS_UPDATE: "lastModelsUpdate";
+    readonly LAST_BASE_URLS_UPDATE: "lastBaseUrlsUpdate";
+    readonly API_KEYS: "api_keys";
+    readonly CHILD_KEYS: "child_keys";
+    readonly XCASHU_TOKENS: "xcashu_tokens";
+    readonly ROUTSTR21_MODELS: "routstr21Models";
+    readonly LAST_ROUTSTR21_MODELS_UPDATE: "lastRoutstr21ModelsUpdate";
+    readonly CACHED_RECEIVE_TOKENS: "cached_receive_tokens";
+    readonly USAGE_TRACKING: "usage_tracking";
+    readonly CLIENT_IDS: "client_ids";
+    readonly FAILED_PROVIDERS: "failed_providers";
+    readonly LAST_FAILED: "last_failed";
+    readonly PROVIDERS_ON_COOLDOWN: "providers_on_cooldown";
+};
+
+/**
+ * Sharded DiscoveryAdapter
+ *
+ * Replaces the SQLite/IndexedDB ModelsDatabase layer with provider-scoped
+ * sharding over the existing key-value StorageDriver.
+ *
+ * Instead of one giant blob:
+ *   modelsFromAllProviders  →  Record<string, Model[]>
+ *   lastModelsUpdate        →  Record<string, number>
+ *
+ * We use provider-scoped keys:
+ *   models:provider:<encodedBaseUrl>           →  Model[]
+ *   models:provider_timestamp:<encodedBaseUrl>  →  number
+ *
+ * All model data is hydrated into memory at creation time so the
+ * synchronous DiscoveryAdapter contract is satisfied. Writes are
+ * fire-and-forget via void driver.setItem(...).
+ */
+
+interface ShardedDiscoveryAdapterOptions {
+    /** Key-value StorageDriver */
+    driver: StorageDriver;
+}
+declare const createShardedDiscoveryAdapter: (options: ShardedDiscoveryAdapterOptions) => Promise<DiscoveryAdapter>;
+declare const createProviderRegistryFromDiscoveryAdapter: (adapter: DiscoveryAdapter, logger?: SdkLogger) => ProviderRegistry;
+
+declare const getDefaultSdkDriver: () => StorageDriver;
+declare const getDefaultSdkStore: () => Promise<SdkStore>;
+declare const getDefaultUsageTrackingDriver: () => UsageTrackingDriver;
+/**
+ * Allow setting a custom usage tracking driver (useful for routstrd to use proper DB path)
+ */
+declare const setDefaultUsageTrackingDriver: (driver: UsageTrackingDriver) => void;
+declare const getDefaultDiscoveryAdapter: () => Promise<DiscoveryAdapter>;
+declare const getDefaultStorageAdapter: () => Promise<StorageAdapter>;
+declare const getDefaultProviderRegistry: () => Promise<ProviderRegistry>;
+
+export { DiscoveryAdapter, ProviderRegistry, SDK_STORAGE_KEYS, SdkStore, type ShardedDiscoveryAdapterOptions, StorageAdapter, StorageDriver, UsageTrackingDriver, UsageTrackingEntry, createBunSqliteDriver, createBunSqliteUsageTrackingDriver, createIndexedDBDriver, createIndexedDBUsageTrackingDriver, createMemoryDriver, createMemoryUsageTrackingDriver, createProviderRegistryFromDiscoveryAdapter, createShardedDiscoveryAdapter, createSqliteDriver, createSqliteUsageTrackingDriver, getDefaultDiscoveryAdapter, getDefaultProviderRegistry, getDefaultSdkDriver, getDefaultSdkStore, getDefaultStorageAdapter, getDefaultUsageTrackingDriver, localStorageDriver, setDefaultUsageTrackingDriver };