blink 0.1.92 → 0.1.93

package/dist/node/react/index.node.d.cts

@@ -70,6 +70,39 @@ interface StoreEntry {
  * It works with filesystem locks - so multiple processes can
  * read and write to the store concurrently.
  */
+interface Store<T extends object> {
+  get: (key: string) => Promise<T | undefined>;
+  list: () => Promise<StoreEntry[]>;
+  lock: (key: string, opts?: {
+    force?: boolean;
+  }) => Promise<LockedStoreEntry<T>>;
+  dispose: () => void;
+}
+/**
+ * createFileStore creates a simple file-based store with atomic read/write.
+ * All operations are protected by filesystem locks for multi-process safety.
+ */
+
+interface DiskStoreWatcher<T = any> {
+  onChange: (callback: (event: {
+    key: string;
+    value: T | undefined;
+    locked: boolean;
+    pid?: number;
+  }) => void) => () => void;
+  dispose: () => void;
+}
+/**
+ * createDiskStoreWatcher creates a watcher for the disk store.
+ * It watches the disk store for changes and emits events when the
+ * store changes.
+ *
+ * It also polls the store for changes in case the watcher misses
+ * any changes.
+ *
+ * It also debounces the changes to prevent too many events from
+ * being emitted.
+ */
 //#endregion
 //#region src/local/types.d.ts
 interface StoredChat {
@@ -111,7 +144,8 @@ interface ChatState {
 }
 interface ChatManagerOptions {
   readonly chatId: string;
-  readonly chatsDirectory: string;
+  readonly store: Store<StoredChat>;
+  readonly watcher: DiskStoreWatcher<StoredChat>;
   /**
    * Optional function to filter messages before persisting them.
    * Return undefined to skip persisting the message.
@@ -142,7 +176,7 @@ declare class ChatManager {
   private abortController;
   private isProcessingQueue;
   private listeners;
-  private watcher;
+  private unwatchStore;
   private disposed;
   constructor(options: ChatManagerOptions);
   /**
@@ -161,6 +195,7 @@ declare class ChatManager {
    * Upsert a message to the chat
    */
   upsertMessage(message: UIMessage, lock?: LockedStoreEntry<StoredChat>): Promise<void>;
+  deleteMessage(id: string): Promise<void>;
   /**
    * Send a message to the agent
    */
@@ -191,6 +226,14 @@ interface UseChatOptions {
   readonly chatId: string;
   readonly agent: Client | undefined;
   readonly chatsDirectory: string;
+  /**
+   * Optional shared store to use. If not provided, a new one will be created.
+   */
+  readonly store?: Store<StoredChat>;
+  /**
+   * Optional shared watcher to use. If not provided, a new one will be created.
+   */
+  readonly watcher?: DiskStoreWatcher<StoredChat>;
   /**
    * Optional function to filter messages before persisting them.
    * Return undefined to skip persisting the message.
@@ -205,6 +248,7 @@ interface UseChatOptions {
 interface UseChat extends ChatState {
   readonly sendMessage: (message: StoredMessage) => Promise<void>;
   readonly upsertMessage: (message: StoredMessage) => Promise<void>;
+  readonly deleteMessage: (id: string) => Promise<void>;
   readonly stopStreaming: () => void;
   readonly resetChat: () => Promise<void>;
   readonly clearQueue: () => void;
@@ -231,6 +275,8 @@ declare function createLocalServer(options: CreateLocalServerOptions): {
   url: string;
   runtime: Context;
   chatsDirectory: string;
+  chatStore: Store<StoredChat>;
+  chatWatcher: DiskStoreWatcher<StoredChat>;
   getChatManager: (chatId: string) => ChatManager;
   listChats: () => Promise<StoreEntry[]>;
   lockChat: (chatId: string) => Promise<LockedStoreEntry<StoredChat>>;

package/dist/node/react/index.node.d.ts

@@ -70,6 +70,39 @@ interface StoreEntry {
  * It works with filesystem locks - so multiple processes can
  * read and write to the store concurrently.
  */
+interface Store<T extends object> {
+  get: (key: string) => Promise<T | undefined>;
+  list: () => Promise<StoreEntry[]>;
+  lock: (key: string, opts?: {
+    force?: boolean;
+  }) => Promise<LockedStoreEntry<T>>;
+  dispose: () => void;
+}
+/**
+ * createFileStore creates a simple file-based store with atomic read/write.
+ * All operations are protected by filesystem locks for multi-process safety.
+ */
+
+interface DiskStoreWatcher<T = any> {
+  onChange: (callback: (event: {
+    key: string;
+    value: T | undefined;
+    locked: boolean;
+    pid?: number;
+  }) => void) => () => void;
+  dispose: () => void;
+}
+/**
+ * createDiskStoreWatcher creates a watcher for the disk store.
+ * It watches the disk store for changes and emits events when the
+ * store changes.
+ *
+ * It also polls the store for changes in case the watcher misses
+ * any changes.
+ *
+ * It also debounces the changes to prevent too many events from
+ * being emitted.
+ */
 //#endregion
 //#region src/local/types.d.ts
 interface StoredChat {
@@ -111,7 +144,8 @@ interface ChatState {
 }
 interface ChatManagerOptions {
   readonly chatId: string;
-  readonly chatsDirectory: string;
+  readonly store: Store<StoredChat>;
+  readonly watcher: DiskStoreWatcher<StoredChat>;
   /**
    * Optional function to filter messages before persisting them.
    * Return undefined to skip persisting the message.
@@ -142,7 +176,7 @@ declare class ChatManager {
   private abortController;
   private isProcessingQueue;
   private listeners;
-  private watcher;
+  private unwatchStore;
   private disposed;
   constructor(options: ChatManagerOptions);
   /**
@@ -161,6 +195,7 @@ declare class ChatManager {
    * Upsert a message to the chat
    */
   upsertMessage(message: UIMessage, lock?: LockedStoreEntry<StoredChat>): Promise<void>;
+  deleteMessage(id: string): Promise<void>;
   /**
    * Send a message to the agent
    */
@@ -191,6 +226,14 @@ interface UseChatOptions {
   readonly chatId: string;
   readonly agent: Client | undefined;
   readonly chatsDirectory: string;
+  /**
+   * Optional shared store to use. If not provided, a new one will be created.
+   */
+  readonly store?: Store<StoredChat>;
+  /**
+   * Optional shared watcher to use. If not provided, a new one will be created.
+   */
+  readonly watcher?: DiskStoreWatcher<StoredChat>;
   /**
    * Optional function to filter messages before persisting them.
    * Return undefined to skip persisting the message.
@@ -205,6 +248,7 @@ interface UseChatOptions {
 interface UseChat extends ChatState {
   readonly sendMessage: (message: StoredMessage) => Promise<void>;
   readonly upsertMessage: (message: StoredMessage) => Promise<void>;
+  readonly deleteMessage: (id: string) => Promise<void>;
   readonly stopStreaming: () => void;
   readonly resetChat: () => Promise<void>;
   readonly clearQueue: () => void;
@@ -231,6 +275,8 @@ declare function createLocalServer(options: CreateLocalServerOptions): {
   url: string;
   runtime: Context;
   chatsDirectory: string;
+  chatStore: Store<StoredChat>;
+  chatWatcher: DiskStoreWatcher<StoredChat>;
   getChatManager: (chatId: string) => ChatManager;
   listChats: () => Promise<StoreEntry[]>;
   lockChat: (chatId: string) => Promise<LockedStoreEntry<StoredChat>>;