@reverbia/sdk 1.0.0-next.20251215193957 → 1.0.0-next.20251217134403

package/dist/react/index.d.mts

@@ -1,4 +1,5 @@
 import { Database, Model } from '@nozbe/watermelondb';
+import * as _nozbe_watermelondb_Schema_migrations from '@nozbe/watermelondb/Schema/migrations';
 import * as _nozbe_watermelondb_Schema from '@nozbe/watermelondb/Schema';
 import { Associations } from '@nozbe/watermelondb/Model';
 
@@ -475,7 +476,7 @@ type SendMessageResult = {
     error: null;
     toolExecution?: ToolExecutionResult;
 } | {
-    data: null;
+    data: LlmapiChatCompletionResponse | null;
     error: string;
     toolExecution?: ToolExecutionResult;
 };
@@ -706,6 +707,8 @@ interface StoredMessage {
     sources?: SearchSource[];
     /** Response time in seconds */
     responseDuration?: number;
+    /** Whether the message generation was stopped by the user */
+    wasStopped?: boolean;
 }
 /**
  * Stored conversation record
@@ -755,6 +758,8 @@ interface CreateMessageOptions {
     vector?: number[];
     /** Model used to generate the embedding */
     embeddingModel?: string;
+    /** Whether the message generation was stopped by the user */
+    wasStopped?: boolean;
 }
 /**
  * Options for creating a new conversation
@@ -982,6 +987,15 @@ declare const chatStorageSchema: Readonly<{
     tables: _nozbe_watermelondb_Schema.TableMap;
     unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
 }>;
+/**
+ * Schema migrations
+ */
+declare const chatStorageMigrations: Readonly<{
+    validated: true;
+    minVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    maxVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    sortedMigrations: _nozbe_watermelondb_Schema_migrations.Migration[];
+}>;
 
 /**
  * Message model representing a single chat message
@@ -1018,6 +1032,8 @@ declare class Message extends Model {
     get sources(): SearchSource[] | undefined;
     /** Response time in seconds */
     get responseDuration(): number | undefined;
+    /** Whether the message generation was stopped by the user */
+    get wasStopped(): boolean;
 }
 /**
  * Conversation model representing conversation metadata
@@ -1396,6 +1412,139 @@ declare class Memory extends Model {
     get isDeleted(): boolean;
 }
 
+/**
+ * Stored model preference record (what gets persisted to the database)
+ */
+interface StoredModelPreference {
+    /** Primary key (WatermelonDB auto-generated) */
+    uniqueId: string;
+    /** User's wallet address */
+    walletAddress: string;
+    /** Preferred model identifiers */
+    models?: string;
+}
+/**
+ * Options for creating a new model preference
+ */
+interface CreateModelPreferenceOptions {
+    /** User's wallet address */
+    walletAddress: string;
+    /** Preferred model identifiers */
+    models?: string;
+}
+/**
+ * Options for updating a model preference
+ */
+interface UpdateModelPreferenceOptions {
+    /** New preferred model identifiers */
+    models?: string;
+}
+/**
+ * Base options for useSettings hook
+ */
+interface BaseUseSettingsOptions {
+    /** WatermelonDB database instance */
+    database: Database;
+    /** User's wallet address */
+    walletAddress?: string;
+}
+/**
+ * Base result returned by useSettings hook
+ */
+interface BaseUseSettingsResult {
+    /** Current model preference */
+    modelPreference: StoredModelPreference | null;
+    /** Whether the settings are loading */
+    isLoading: boolean;
+    /** Get model preference by wallet address. Throws on error. */
+    getModelPreference: (walletAddress: string) => Promise<StoredModelPreference | null>;
+    /** Create or update model preference. Throws on error. */
+    setModelPreference: (walletAddress: string, models?: string) => Promise<StoredModelPreference | null>;
+    /** Delete model preference. Throws on error. */
+    deleteModelPreference: (walletAddress: string) => Promise<boolean>;
+}
+
+/**
+ * Options for useSettings hook (React version)
+ */
+interface UseSettingsOptions extends BaseUseSettingsOptions {
+}
+/**
+ * Result returned by useSettings hook (React version)
+ */
+interface UseSettingsResult extends BaseUseSettingsResult {
+}
+/**
+ * A React hook for managing user settings with automatic persistence using WatermelonDB.
+ *
+ * This hook provides methods to get, set, and delete user model preferences,
+ * with automatic loading of preferences when a wallet address is provided.
+ *
+ * @param options - Configuration options
+ * @returns An object containing settings state and methods
+ *
+ * @example
+ * ```tsx
+ * import { Database } from '@nozbe/watermelondb';
+ * import { useSettings } from '@reverbia/sdk/react';
+ *
+ * function SettingsComponent({ database }: { database: Database }) {
+ *   const {
+ *     modelPreference,
+ *     isLoading,
+ *     setModelPreference,
+ *     getModelPreference,
+ *     deleteModelPreference,
+ *   } = useSettings({
+ *     database,
+ *     walletAddress: '0x123...', // Optional: auto-loads preference for this wallet
+ *   });
+ *
+ *   const handleModelChange = async (model: string) => {
+ *     await setModelPreference('0x123...', model);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Current model: {modelPreference?.model ?? 'Not set'}</p>
+ *       <button onClick={() => handleModelChange('gpt-4o')}>
+ *         Use GPT-4o
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @category Hooks
+ */
+declare function useSettings(options: UseSettingsOptions): UseSettingsResult;
+
+/**
+ * WatermelonDB schema for settings storage
+ *
+ * * Defines one table::
+ * - modelPreferences: Model preferences metadata
+ */
+declare const settingsStorageSchema: Readonly<{
+    version: _nozbe_watermelondb_Schema.SchemaVersion;
+    tables: _nozbe_watermelondb_Schema.TableMap;
+    unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
+}>;
+
+/**
+ * ModelPreference model representing user model preferences
+ *
+ * Note: This model uses raw column accessors instead of decorators
+ * for better TypeScript compatibility without requiring legacy decorators.
+ */
+declare class ModelPreference extends Model {
+    static table: string;
+    /** User's wallet address */
+    get walletAddress(): string;
+    /** Preferred model identifier */
+    get models(): string | undefined;
+}
+
 interface PdfFile {
     url: string;
     mediaType?: string;
@@ -1608,4 +1757,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, DEFAULT_TOOL_SELECTOR_MODEL, type FileMetadata, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, chatStorageSchema, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, selectTool, useChat, useChatStorage, useEncryption, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch };
+export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, DEFAULT_TOOL_SELECTOR_MODEL, type FileMetadata, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, selectTool, settingsStorageSchema, useChat, useChatStorage, useEncryption, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings };

package/dist/react/index.d.ts

@@ -1,4 +1,5 @@
 import { Database, Model } from '@nozbe/watermelondb';
+import * as _nozbe_watermelondb_Schema_migrations from '@nozbe/watermelondb/Schema/migrations';
 import * as _nozbe_watermelondb_Schema from '@nozbe/watermelondb/Schema';
 import { Associations } from '@nozbe/watermelondb/Model';
 
@@ -475,7 +476,7 @@ type SendMessageResult = {
     error: null;
     toolExecution?: ToolExecutionResult;
 } | {
-    data: null;
+    data: LlmapiChatCompletionResponse | null;
     error: string;
     toolExecution?: ToolExecutionResult;
 };
@@ -706,6 +707,8 @@ interface StoredMessage {
     sources?: SearchSource[];
     /** Response time in seconds */
     responseDuration?: number;
+    /** Whether the message generation was stopped by the user */
+    wasStopped?: boolean;
 }
 /**
  * Stored conversation record
@@ -755,6 +758,8 @@ interface CreateMessageOptions {
     vector?: number[];
     /** Model used to generate the embedding */
     embeddingModel?: string;
+    /** Whether the message generation was stopped by the user */
+    wasStopped?: boolean;
 }
 /**
  * Options for creating a new conversation
@@ -982,6 +987,15 @@ declare const chatStorageSchema: Readonly<{
     tables: _nozbe_watermelondb_Schema.TableMap;
     unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
 }>;
+/**
+ * Schema migrations
+ */
+declare const chatStorageMigrations: Readonly<{
+    validated: true;
+    minVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    maxVersion: _nozbe_watermelondb_Schema.SchemaVersion;
+    sortedMigrations: _nozbe_watermelondb_Schema_migrations.Migration[];
+}>;
 
 /**
  * Message model representing a single chat message
@@ -1018,6 +1032,8 @@ declare class Message extends Model {
     get sources(): SearchSource[] | undefined;
     /** Response time in seconds */
     get responseDuration(): number | undefined;
+    /** Whether the message generation was stopped by the user */
+    get wasStopped(): boolean;
 }
 /**
  * Conversation model representing conversation metadata
@@ -1396,6 +1412,139 @@ declare class Memory extends Model {
     get isDeleted(): boolean;
 }
 
+/**
+ * Stored model preference record (what gets persisted to the database)
+ */
+interface StoredModelPreference {
+    /** Primary key (WatermelonDB auto-generated) */
+    uniqueId: string;
+    /** User's wallet address */
+    walletAddress: string;
+    /** Preferred model identifiers */
+    models?: string;
+}
+/**
+ * Options for creating a new model preference
+ */
+interface CreateModelPreferenceOptions {
+    /** User's wallet address */
+    walletAddress: string;
+    /** Preferred model identifiers */
+    models?: string;
+}
+/**
+ * Options for updating a model preference
+ */
+interface UpdateModelPreferenceOptions {
+    /** New preferred model identifiers */
+    models?: string;
+}
+/**
+ * Base options for useSettings hook
+ */
+interface BaseUseSettingsOptions {
+    /** WatermelonDB database instance */
+    database: Database;
+    /** User's wallet address */
+    walletAddress?: string;
+}
+/**
+ * Base result returned by useSettings hook
+ */
+interface BaseUseSettingsResult {
+    /** Current model preference */
+    modelPreference: StoredModelPreference | null;
+    /** Whether the settings are loading */
+    isLoading: boolean;
+    /** Get model preference by wallet address. Throws on error. */
+    getModelPreference: (walletAddress: string) => Promise<StoredModelPreference | null>;
+    /** Create or update model preference. Throws on error. */
+    setModelPreference: (walletAddress: string, models?: string) => Promise<StoredModelPreference | null>;
+    /** Delete model preference. Throws on error. */
+    deleteModelPreference: (walletAddress: string) => Promise<boolean>;
+}
+
+/**
+ * Options for useSettings hook (React version)
+ */
+interface UseSettingsOptions extends BaseUseSettingsOptions {
+}
+/**
+ * Result returned by useSettings hook (React version)
+ */
+interface UseSettingsResult extends BaseUseSettingsResult {
+}
+/**
+ * A React hook for managing user settings with automatic persistence using WatermelonDB.
+ *
+ * This hook provides methods to get, set, and delete user model preferences,
+ * with automatic loading of preferences when a wallet address is provided.
+ *
+ * @param options - Configuration options
+ * @returns An object containing settings state and methods
+ *
+ * @example
+ * ```tsx
+ * import { Database } from '@nozbe/watermelondb';
+ * import { useSettings } from '@reverbia/sdk/react';
+ *
+ * function SettingsComponent({ database }: { database: Database }) {
+ *   const {
+ *     modelPreference,
+ *     isLoading,
+ *     setModelPreference,
+ *     getModelPreference,
+ *     deleteModelPreference,
+ *   } = useSettings({
+ *     database,
+ *     walletAddress: '0x123...', // Optional: auto-loads preference for this wallet
+ *   });
+ *
+ *   const handleModelChange = async (model: string) => {
+ *     await setModelPreference('0x123...', model);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Current model: {modelPreference?.model ?? 'Not set'}</p>
+ *       <button onClick={() => handleModelChange('gpt-4o')}>
+ *         Use GPT-4o
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @category Hooks
+ */
+declare function useSettings(options: UseSettingsOptions): UseSettingsResult;
+
+/**
+ * WatermelonDB schema for settings storage
+ *
+ * * Defines one table::
+ * - modelPreferences: Model preferences metadata
+ */
+declare const settingsStorageSchema: Readonly<{
+    version: _nozbe_watermelondb_Schema.SchemaVersion;
+    tables: _nozbe_watermelondb_Schema.TableMap;
+    unsafeSql?: (_: string, __: _nozbe_watermelondb_Schema.AppSchemaUnsafeSqlKind) => string;
+}>;
+
+/**
+ * ModelPreference model representing user model preferences
+ *
+ * Note: This model uses raw column accessors instead of decorators
+ * for better TypeScript compatibility without requiring legacy decorators.
+ */
+declare class ModelPreference extends Model {
+    static table: string;
+    /** User's wallet address */
+    get walletAddress(): string;
+    /** Preferred model identifier */
+    get models(): string | undefined;
+}
+
 interface PdfFile {
     url: string;
     mediaType?: string;
@@ -1608,4 +1757,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, DEFAULT_TOOL_SELECTOR_MODEL, type FileMetadata, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, chatStorageSchema, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, selectTool, useChat, useChatStorage, useEncryption, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch };
+export { Conversation as ChatConversation, Message as ChatMessage, type ChatRole, type ClientTool, type CreateConversationOptions, type CreateMemoryOptions, type CreateMessageOptions, type CreateModelPreferenceOptions, DEFAULT_TOOL_SELECTOR_MODEL, type FileMetadata, type MemoryItem, type MemoryType, type OCRFile, type PdfFile, type SearchMessagesOptions, type SearchSource, type SendMessageWithStorageArgs, type SendMessageWithStorageResult, type SignMessageFn, type ChatCompletionUsage as StoredChatCompletionUsage, type StoredConversation, type StoredMemory, Memory as StoredMemoryModel, type StoredMemoryWithSimilarity, type StoredMessage, type StoredMessageWithSimilarity, type StoredModelPreference, ModelPreference as StoredModelPreferenceModel, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, type UpdateMemoryOptions, type UpdateModelPreferenceOptions, type UseChatStorageOptions, type UseChatStorageResult, type UseMemoryStorageOptions, type UseMemoryStorageResult, type UseSettingsOptions, type UseSettingsResult, chatStorageMigrations, chatStorageSchema, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, generateCompositeKey, generateConversationId, generateUniqueKey, hasEncryptionKey, memoryStorageSchema, requestEncryptionKey, selectTool, settingsStorageSchema, useChat, useChatStorage, useEncryption, useImageGeneration, useMemoryStorage, useModels, useOCR, usePdf, useSearch, useSettings };