blink 1.1.23 → 1.1.25

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

@@ -1,9 +1,59 @@
 import { ID, UIOptions, UIOptionsSchema } from "../index.node-CFw4ITad.cjs";
 import { BuildLog, BuildResult } from "../index-DYOqnOdZ.cjs";
 import { UIMessage, UIMessageChunk } from "ai";
+import * as react0 from "react";
 
+//#region src/local/rw-lock.d.ts
+declare class ReadLock {
+  private onRelease;
+  constructor(onRelease: () => void);
+  [Symbol.dispose](): void;
+}
+declare class WriteLock {
+  private onRelease;
+  constructor(onRelease: () => void);
+  [Symbol.dispose](): void;
+}
+/**
+ * RWLock is a read/write lock that allows multiple concurrent readers
+ * or a single writer. Writers wait for all readers to finish before acquiring
+ * the lock.
+ *
+ * This is designed for in-memory, single-process synchronization using the
+ * explicit resource management pattern (Symbol.dispose).
+ *
+ * Example usage:
+ * ```typescript
+ * const lock = new RWLock();
+ *
+ * // Multiple readers can acquire the lock concurrently
+ * using readLock = await lock.read();
+ * // ... do read operations ...
+ *
+ * // Writers wait for all readers to finish
+ * using writeLock = await lock.write();
+ * // ... do write operations ...
+ * ```
+ */
+declare class RWLock {
+  private _lock;
+  /**
+   * Acquire a read lock. Multiple readers can hold the lock concurrently.
+   * If a writer is waiting, new readers will wait until the writer completes.
+   *
+   * The lock is automatically released when the returned object is disposed.
+   */
+  read(): Promise<ReadLock>;
+  /**
+   * Acquire a write lock. Waits for all readers to finish before acquiring.
+   * Only one writer can hold the lock at a time.
+   *
+   * The lock is automatically released when the returned object is disposed.
+   */
+  write(): Promise<WriteLock>;
+}
+//#endregion
 //#region src/agent/client/index.d.ts
-
 interface ClientOptions {
   readonly baseUrl: string;
   readonly headers?: Record<string, string>;
@@ -15,6 +65,7 @@ type CapabilitiesResponse = Awaited<ReturnType<Client["capabilities"]>>;
 declare class Client {
   readonly baseUrl: string;
   private readonly client;
+  readonly agentLock: RWLock;
   constructor(options: ClientOptions);
   /**
    * chat starts chatting with the agent.
@@ -123,6 +174,19 @@ interface UseAuth {
  */
 declare function useAuth(options?: UseAuthOptions): UseAuth;
 //#endregion
+//#region src/react/use-logger.d.ts
+type Source = "system" | "agent";
+type PrintLog = (level: "error" | "log", source: Source, ...message: unknown[]) => Promise<void>;
+declare class Logger {
+  private printLog;
+  constructor(printLog: PrintLog);
+  setPrintLog(printLog: PrintLog): void;
+  error(source: Source, ...message: [unknown, ...unknown[]]): void;
+  log(source: Source, ...message: [unknown, ...unknown[]]): void;
+  flush(): Promise<void>;
+}
+declare const LoggerContext: react0.Context<Logger | undefined>;
+//#endregion
 //#region src/react/use-bundler.d.ts
 type BundlerStatus = "building" | "success" | "error";
 interface BundlerContext {
@@ -134,6 +198,7 @@ interface BundlerContext {
 }
 interface UseBundlerOptions {
   readonly directory: string;
+  readonly logger: Logger;
   readonly onBuildStart?: () => void;
   readonly onBuildSuccess?: (result: BuildResult & {
     duration: number;
@@ -203,6 +268,7 @@ interface ChatState {
   readonly streamingMessage?: StoredMessage;
   readonly loading: boolean;
   readonly queuedMessages: StoredMessage[];
+  readonly queuedLogs: StoredMessage[];
 }
 interface ChatManagerOptions {
   readonly chatId?: ID;
@@ -239,6 +305,7 @@ declare class ChatManager {
   private streamingMessage;
   private status;
   private queue;
+  private logQueue;
   private abortController;
   private isProcessingQueue;
   private listeners;
@@ -262,6 +329,16 @@ declare class ChatManager {
    */
   upsertMessages(messages: UIMessage[], lock?: LockedStoreEntry<StoredChat>): Promise<void>;
   deleteMessages(ids: string[]): Promise<void>;
+  queueLogMessage({
+    message: logMessage,
+    level,
+    source
+  }: {
+    message: string;
+    level: "error" | "log";
+    source: Source;
+  }): Promise<void>;
+  private flushLogQueue;
   /**
    * Send a message to the agent
    */
@@ -312,6 +389,7 @@ interface UseChatOptions {
 interface UseChat extends ChatState {
   readonly sendMessage: (message: StoredMessage) => Promise<void>;
   readonly upsertMessage: (message: StoredMessage) => Promise<void>;
+  readonly queueLogMessage: ChatManager["queueLogMessage"];
   readonly deleteMessage: (id: string) => Promise<void>;
   readonly stopStreaming: () => void;
   readonly resetChat: () => Promise<void>;
@@ -348,6 +426,7 @@ declare function createLocalServer(options: CreateLocalServerOptions): {
 type DevMode = "run" | "edit";
 interface UseDevModeOptions {
   readonly directory: string;
+  readonly logger: Logger;
   readonly onBuildStart?: () => void;
   readonly onBuildSuccess?: (result: {
     duration: number;
@@ -424,6 +503,7 @@ interface UseDevhookOptions {
   readonly disabled?: boolean;
   readonly onRequest: (request: Request) => Promise<Response>;
   readonly directory: string;
+  readonly logger: Logger;
 }
 declare function useDevhook(options: UseDevhookOptions): {
   id: string | undefined;
@@ -432,7 +512,7 @@ declare function useDevhook(options: UseDevhookOptions): {
 };
 //#endregion
 //#region src/react/use-dotenv.d.ts
-declare function useDotenv(directory: string, name?: string): Record<string, string>;
+declare function useDotenv(directory: string, logger: Logger, name?: string): Record<string, string>;
 //#endregion
 //#region src/react/use-edit-agent.d.ts
 interface UseEditAgentOptions {
@@ -473,4 +553,4 @@ declare function useOptions({
   error: Error | undefined;
 };
 //#endregion
-export { useAgent, useAuth, useBundler, useChat, useDevMode, useDevhook, useDotenv, useEditAgent, useOptions };
+export { Logger, LoggerContext, useAgent, useAuth, useBundler, useChat, useDevMode, useDevhook, useDotenv, useEditAgent, useOptions };

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

@@ -1,9 +1,59 @@
 import { ID, UIOptions, UIOptionsSchema } from "../index.node-D5_czyKY.js";
 import { BuildLog, BuildResult } from "../index-B4OXlWm3.js";
 import { UIMessage, UIMessageChunk } from "ai";
+import * as react0 from "react";
 
+//#region src/local/rw-lock.d.ts
+declare class ReadLock {
+  private onRelease;
+  constructor(onRelease: () => void);
+  [Symbol.dispose](): void;
+}
+declare class WriteLock {
+  private onRelease;
+  constructor(onRelease: () => void);
+  [Symbol.dispose](): void;
+}
+/**
+ * RWLock is a read/write lock that allows multiple concurrent readers
+ * or a single writer. Writers wait for all readers to finish before acquiring
+ * the lock.
+ *
+ * This is designed for in-memory, single-process synchronization using the
+ * explicit resource management pattern (Symbol.dispose).
+ *
+ * Example usage:
+ * ```typescript
+ * const lock = new RWLock();
+ *
+ * // Multiple readers can acquire the lock concurrently
+ * using readLock = await lock.read();
+ * // ... do read operations ...
+ *
+ * // Writers wait for all readers to finish
+ * using writeLock = await lock.write();
+ * // ... do write operations ...
+ * ```
+ */
+declare class RWLock {
+  private _lock;
+  /**
+   * Acquire a read lock. Multiple readers can hold the lock concurrently.
+   * If a writer is waiting, new readers will wait until the writer completes.
+   *
+   * The lock is automatically released when the returned object is disposed.
+   */
+  read(): Promise<ReadLock>;
+  /**
+   * Acquire a write lock. Waits for all readers to finish before acquiring.
+   * Only one writer can hold the lock at a time.
+   *
+   * The lock is automatically released when the returned object is disposed.
+   */
+  write(): Promise<WriteLock>;
+}
+//#endregion
 //#region src/agent/client/index.d.ts
-
 interface ClientOptions {
   readonly baseUrl: string;
   readonly headers?: Record<string, string>;
@@ -15,6 +65,7 @@ type CapabilitiesResponse = Awaited<ReturnType<Client["capabilities"]>>;
 declare class Client {
   readonly baseUrl: string;
   private readonly client;
+  readonly agentLock: RWLock;
   constructor(options: ClientOptions);
   /**
    * chat starts chatting with the agent.
@@ -123,6 +174,19 @@ interface UseAuth {
  */
 declare function useAuth(options?: UseAuthOptions): UseAuth;
 //#endregion
+//#region src/react/use-logger.d.ts
+type Source = "system" | "agent";
+type PrintLog = (level: "error" | "log", source: Source, ...message: unknown[]) => Promise<void>;
+declare class Logger {
+  private printLog;
+  constructor(printLog: PrintLog);
+  setPrintLog(printLog: PrintLog): void;
+  error(source: Source, ...message: [unknown, ...unknown[]]): void;
+  log(source: Source, ...message: [unknown, ...unknown[]]): void;
+  flush(): Promise<void>;
+}
+declare const LoggerContext: react0.Context<Logger | undefined>;
+//#endregion
 //#region src/react/use-bundler.d.ts
 type BundlerStatus = "building" | "success" | "error";
 interface BundlerContext {
@@ -134,6 +198,7 @@ interface BundlerContext {
 }
 interface UseBundlerOptions {
   readonly directory: string;
+  readonly logger: Logger;
   readonly onBuildStart?: () => void;
   readonly onBuildSuccess?: (result: BuildResult & {
     duration: number;
@@ -203,6 +268,7 @@ interface ChatState {
   readonly streamingMessage?: StoredMessage;
   readonly loading: boolean;
   readonly queuedMessages: StoredMessage[];
+  readonly queuedLogs: StoredMessage[];
 }
 interface ChatManagerOptions {
   readonly chatId?: ID;
@@ -239,6 +305,7 @@ declare class ChatManager {
   private streamingMessage;
   private status;
   private queue;
+  private logQueue;
   private abortController;
   private isProcessingQueue;
   private listeners;
@@ -262,6 +329,16 @@ declare class ChatManager {
    */
   upsertMessages(messages: UIMessage[], lock?: LockedStoreEntry<StoredChat>): Promise<void>;
   deleteMessages(ids: string[]): Promise<void>;
+  queueLogMessage({
+    message: logMessage,
+    level,
+    source
+  }: {
+    message: string;
+    level: "error" | "log";
+    source: Source;
+  }): Promise<void>;
+  private flushLogQueue;
   /**
    * Send a message to the agent
    */
@@ -312,6 +389,7 @@ interface UseChatOptions {
 interface UseChat extends ChatState {
   readonly sendMessage: (message: StoredMessage) => Promise<void>;
   readonly upsertMessage: (message: StoredMessage) => Promise<void>;
+  readonly queueLogMessage: ChatManager["queueLogMessage"];
   readonly deleteMessage: (id: string) => Promise<void>;
   readonly stopStreaming: () => void;
   readonly resetChat: () => Promise<void>;
@@ -348,6 +426,7 @@ declare function createLocalServer(options: CreateLocalServerOptions): {
 type DevMode = "run" | "edit";
 interface UseDevModeOptions {
   readonly directory: string;
+  readonly logger: Logger;
   readonly onBuildStart?: () => void;
   readonly onBuildSuccess?: (result: {
     duration: number;
@@ -424,6 +503,7 @@ interface UseDevhookOptions {
   readonly disabled?: boolean;
   readonly onRequest: (request: Request) => Promise<Response>;
   readonly directory: string;
+  readonly logger: Logger;
 }
 declare function useDevhook(options: UseDevhookOptions): {
   id: string | undefined;
@@ -432,7 +512,7 @@ declare function useDevhook(options: UseDevhookOptions): {
 };
 //#endregion
 //#region src/react/use-dotenv.d.ts
-declare function useDotenv(directory: string, name?: string): Record<string, string>;
+declare function useDotenv(directory: string, logger: Logger, name?: string): Record<string, string>;
 //#endregion
 //#region src/react/use-edit-agent.d.ts
 interface UseEditAgentOptions {
@@ -473,4 +553,4 @@ declare function useOptions({
   error: Error | undefined;
 };
 //#endregion
-export { useAgent, useAuth, useBundler, useChat, useDevMode, useDevhook, useDotenv, useEditAgent, useOptions };
+export { Logger, LoggerContext, useAgent, useAuth, useBundler, useChat, useDevMode, useDevhook, useDotenv, useEditAgent, useOptions };