simple-ai-sdk 1.0.0 → 1.0.2

package/dist/client/context.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+import { type IStreamManager } from "./manager.js";
+export type SimpleAIProviderProps = {
+    children: React.ReactNode;
+    maxSessions?: number;
+    debug?: boolean;
+    /**
+     * TTL（ミリ秒）。アクセスのない ready/error セッションを定期的に破棄する。
+     * 未指定の場合は破棄しない。
+     */
+    ttlMs?: number;
+};
+export declare function SimpleAIProvider({ children, maxSessions, debug, ttlMs, }: SimpleAIProviderProps): import("react/jsx-runtime.js").JSX.Element;
+export declare function useAIStreamManager(): IStreamManager;
+//# sourceMappingURL=context.d.ts.map

package/dist/client/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/client/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAIlE,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,WAAW,EACX,KAAK,EACL,KAAK,GACN,EAAE,qBAAqB,8CAevB;AAED,wBAAgB,kBAAkB,mBAMjC"}

package/dist/client/context.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { createContext, use, useMemo } from "react";
+import { StreamManager } from "./manager.js";
+const StreamContext = createContext(null);
+export function SimpleAIProvider({ children, maxSessions, debug, ttlMs, }) {
+    // Create StreamManager instance with custom options
+    const manager = useMemo(() => {
+        return new StreamManager({ maxSessions, debug, ttlMs });
+    }, [maxSessions, debug, ttlMs]);
+    // Provider がアンマウントされる際に、内部タイマーなどをクリーンアップする
+    // （メモリリーク防止のため）
+    React.useEffect(() => {
+        return () => {
+            manager.dispose();
+        };
+    }, [manager]);
+    return _jsx(StreamContext, { value: manager, children: children });
+}
+export function useAIStreamManager() {
+    const manager = use(StreamContext);
+    if (!manager) {
+        throw new Error("useAIStreamManager must be used within SimpleAIProvider");
+    }
+    return manager;
+}

package/{src/client/index.ts → dist/client/index.d.ts}

@@ -1,9 +1,5 @@
 export { SimpleAIProvider, useAIStreamManager } from "./context.js";
 export { useChatSession } from "./useChatSession.js";
 export { streamManager, type IStreamManager } from "./manager.js";
-export type {
-  ChatStatus,
-  ChatSession,
-  UseChatSessionOptions,
-  UseChatSessionReturn,
-} from "./types.js";
+export type { ChatStatus, ChatSession, UseChatSessionOptions, UseChatSessionReturn, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EACV,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { SimpleAIProvider, useAIStreamManager } from "./context.js";
+export { useChatSession } from "./useChatSession.js";
+export { streamManager } from "./manager.js";

package/dist/client/manager.d.ts

@@ -0,0 +1,101 @@
+import type { ChatSession, StreamManagerListener, StreamManagerState } from "./types.js";
+import type { Message, JSONValue } from "../shared/index.js";
+export interface IStreamManager {
+    subscribe(listener: StreamManagerListener): () => void;
+    getSnapshot(): StreamManagerState;
+    getSession(sessionId: string): ChatSession | undefined;
+    initSession(sessionId: string, initialMessages?: Message[]): void;
+    /**
+     * セッション単位で最新の onFinish ハンドラを登録する。
+     * - ストリーム完了時は常にこの最新ハンドラを呼び出す。
+     * - コンポーネントがアンマウントされても保持され、完了時に呼ばれる。
+     */
+    setOnFinishHandler(sessionId: string, handler: ((messages: Message[]) => void) | undefined): void;
+    /**
+     * セッション単位で最新の onMetadata ハンドラを登録する。
+     */
+    setOnMetadataHandler(sessionId: string, handler: ((metadata: Record<string, JSONValue>) => void) | undefined): void;
+    /**
+     * セッション単位で最新の onError ハンドラを登録する。
+     */
+    setOnErrorHandler(sessionId: string, handler: ((error: Error) => void) | undefined): void;
+    /**
+     * セッションに購読者を関連付ける（マウント時に呼ぶ）。
+     */
+    retainSession(sessionId: string): void;
+    /**
+     * セッションから購読者を外す（アンマウント時に呼ぶ）。
+     */
+    releaseSession(sessionId: string): void;
+    /**
+     * セッションの最終アクセス時刻を更新する（LRU用）。
+     * レンダリング中に呼ばれる可能性があるため、通知は行わない。
+     */
+    touchSession(sessionId: string): void;
+    updateSession(sessionId: string, updates: Partial<ChatSession>): void;
+    streamChat(sessionId: string, messages: Message[], options: {
+        api: string;
+        body?: Record<string, JSONValue>;
+    }): Promise<void>;
+    stopStream(sessionId: string): void;
+    /**
+     * ライフサイクル終了時のクリーンアップ用。
+     * SimpleAIProvider から呼び出される想定。
+     */
+    dispose(): void;
+}
+export type StreamManagerOptions = {
+    maxSessions?: number;
+    debug?: boolean;
+    /**
+     * TTL（ミリ秒）を過ぎてアクセスのない ready/error セッションを自動掃除する。
+     * 指定しない場合は自動掃除を行わない。
+     */
+    ttlMs?: number;
+};
+declare class StreamManager implements IStreamManager {
+    private state;
+    private listeners;
+    private rafScheduled;
+    private rafId;
+    private rafFallbackTimer;
+    private getRAF;
+    private getCAF;
+    private maxSessions;
+    private debug;
+    private ttlMs?;
+    private sweepTimer;
+    private activeSubscribers;
+    private latestOnFinish;
+    private latestOnMetadata;
+    private latestOnError;
+    private streamIds;
+    constructor(options?: StreamManagerOptions);
+    subscribe(listener: StreamManagerListener): () => void;
+    setOnFinishHandler(sessionId: string, handler: ((messages: Message[]) => void) | undefined): void;
+    setOnMetadataHandler(sessionId: string, handler: ((metadata: Record<string, JSONValue>) => void) | undefined): void;
+    setOnErrorHandler(sessionId: string, handler: ((error: Error) => void) | undefined): void;
+    getSnapshot(): StreamManagerState;
+    private notify;
+    getSession(sessionId: string): ChatSession | undefined;
+    touchSession(sessionId: string): void;
+    initSession(sessionId: string, initialMessages?: Message[]): void;
+    retainSession(sessionId: string): void;
+    releaseSession(sessionId: string): void;
+    private removeOldestSession;
+    private logSessionInfo;
+    updateSession(sessionId: string, updates: Partial<ChatSession>, immediate?: boolean): void;
+    streamChat(sessionId: string, messages: Message[], options: {
+        api: string;
+        body?: Record<string, JSONValue>;
+    }): Promise<void>;
+    stopStream(sessionId: string): void;
+    /**
+     * ライフサイクル終了時のクリーンアップ用。
+     * SimpleAIProvider から呼び出される想定。
+     */
+    dispose(): void;
+}
+export { StreamManager };
+export declare const streamManager: IStreamManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/client/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/client/manager.ts"],"names":[],"mappings":"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"}