keepwork-sdk 1.0.0

package/dist-npm/types/src/rtc/SpeechRTC.d.ts

@@ -0,0 +1,156 @@
+/**
+ * SpeechRTC — VolcEngine bidirectional TTS client with managed session reuse.
+ *
+ * 协议层（constants, helpers, SpeechRTCTransport）已拆分至 SpeechRTC.transport.js。
+ */
+import { EVENT, SESSION_STATE } from './SpeechRTC.transport';
+/** _waitForEvent 等待者 */
+interface SpeechRTCWaiter {
+    values: unknown[];
+    resolve: (payload: unknown) => void;
+    reject: (error: unknown) => void;
+}
+/** 会话池条目 */
+interface SpeechRTCPoolEntry {
+    key: string;
+    session: SpeechRTCSession;
+    lastUsedAt: number;
+}
+/** SpeechRTCTransport 的结构化调用表面（供 Session 使用） */
+interface ITransport {
+    connectId: string;
+    prepareSession(session: unknown): Promise<void>;
+    releaseSession(session: unknown): void;
+    sendEvent(eventCode: number, payload: unknown, sessionId?: string): Promise<void>;
+    shutdown(options?: unknown): Promise<void>;
+    _closeSocket(options?: unknown): void;
+    _tryCancelStaleSession(sessionId: string): void;
+    [key: string]: unknown;
+}
+declare class SpeechRTC {
+    static EVENT: {
+        NONE: number;
+        START_CONNECTION: number;
+        FINISH_CONNECTION: number;
+        CONNECTION_STARTED: number;
+        CONNECTION_FAILED: number;
+        CONNECTION_FINISHED: number;
+        START_SESSION: number;
+        CANCEL_SESSION: number;
+        FINISH_SESSION: number;
+        SESSION_STARTED: number;
+        SESSION_CANCELED: number;
+        SESSION_FINISHED: number;
+        SESSION_FAILED: number;
+        USAGE_RESPONSE: number;
+        TASK_REQUEST: number;
+        UPDATE_CONFIG: number;
+        AUDIO_MUTED: number;
+        TTS_SENTENCE_START: number;
+        TTS_SENTENCE_END: number;
+        TTS_RESPONSE: number;
+        TTS_ENDED: number;
+        PODCAST_ROUND_START: number;
+        PODCAST_ROUND_RESPONSE: number;
+        PODCAST_ROUND_END: number;
+        SOURCE_SUBTITLE_START: number;
+        SOURCE_SUBTITLE_RESPONSE: number;
+        SOURCE_SUBTITLE_END: number;
+        TRANSLATION_SUBTITLE_START: number;
+        TRANSLATION_SUBTITLE_RESPONSE: number;
+        TRANSLATION_SUBTITLE_END: number;
+    };
+    static SESSION_STATE: {
+        IDLE: string;
+        CONNECTING: string;
+        CONNECTED: string;
+        STARTING: string;
+        ACTIVE: string;
+        FINISHING: string;
+        FINISHED: string;
+        CANCELED: string;
+        CLOSED: string;
+        FAILED: string;
+    };
+    sdk: unknown;
+    options: Record<string, unknown>;
+    maxParallelSessions: number;
+    _sessionPool: SpeechRTCPoolEntry[];
+    _transports: Set<Record<string, unknown>>;
+    [key: string]: unknown;
+    constructor(sdk: unknown, options?: Record<string, unknown>);
+    createSession(config?: Record<string, unknown>): SpeechRTCSession;
+    createTextStream(config?: Record<string, unknown>): SpeechRTCSession;
+    synthesize(text: string, config?: Record<string, unknown>): Promise<unknown>;
+    synthesizeChunks(chunks: unknown, config?: Record<string, unknown>): Promise<unknown>;
+    shutdown(options?: Record<string, unknown>): Promise<void>;
+    _createSessionInstance(config?: Record<string, unknown>, metadata?: Record<string, unknown>): SpeechRTCSession;
+    _buildTextStreamPoolKey(config?: Record<string, unknown>): string;
+    _findPooledSession(poolKey: string): SpeechRTCPoolEntry | null;
+    _touchPooledSession(entry: SpeechRTCPoolEntry): void;
+    _evictLeastRecentlyUsedInactiveSession(): SpeechRTCPoolEntry | null;
+}
+declare class SpeechRTCSession {
+    speechRTC: Record<string, unknown>;
+    transport: ITransport;
+    sdk: unknown;
+    options: Record<string, unknown>;
+    isPooledStream: boolean;
+    poolKey: string;
+    _onStateChange: ((state?: unknown, session?: unknown) => void) | null;
+    state: unknown;
+    isConnected: boolean;
+    isSessionActive: boolean;
+    _listeners: Record<string, Array<(payload?: unknown) => void>>;
+    _waiters: Map<unknown, SpeechRTCWaiter[]>;
+    _audioContext: AudioContext | null;
+    _audioTime: number;
+    _activeSources: Set<unknown>;
+    _encodedChunks: unknown[];
+    _sessionResult: Record<string, unknown> | null;
+    _usage: unknown;
+    _sentenceText: string;
+    _sessionIdleTimer: ReturnType<typeof setTimeout> | null;
+    _audioUrl: string | null;
+    [key: string]: unknown;
+    constructor(speechRTC: Record<string, unknown>, config?: Record<string, unknown>, runtime?: Record<string, unknown>);
+    on(event: string, callback: (payload?: unknown) => void): this;
+    off(event: string, callback: (payload?: unknown) => void): this;
+    emit(event: string, payload?: unknown): void;
+    start(): Promise<this>;
+    sendText(text: string, options?: Record<string, unknown>): Promise<void>;
+    sendTextChunks(chunks: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    streamText(chunks: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    appendText(text: string, options?: Record<string, unknown>): Promise<void>;
+    interrupt(options?: Record<string, unknown>): Promise<this>;
+    beginText(text?: string, options?: Record<string, unknown>): Promise<this>;
+    finish(options?: Record<string, unknown>): Promise<unknown>;
+    cancel(options?: Record<string, unknown>): Promise<void>;
+    stop(options?: Record<string, unknown>): Promise<unknown>;
+    close(options?: Record<string, unknown>): Promise<unknown>;
+    synthesize(text: string, options?: Record<string, unknown>): Promise<unknown>;
+    synthesizeChunks(chunks: unknown, options?: Record<string, unknown>): Promise<unknown>;
+    _sendSessionStart(): Promise<void>;
+    _buildSessionStartPayload(): Record<string, unknown>;
+    _handleFrame(frame: Record<string, unknown>): Promise<void>;
+    _handleAudioFrame(frame: Record<string, unknown>): Promise<void>;
+    _ensureAudioContext(): Promise<AudioContext | null>;
+    _playPCMChunk(bytes: Uint8Array): Promise<void>;
+    _buildAudioUrl(): string | null;
+    _armSessionIdleTimer(): void;
+    _clearSessionIdleTimer(): void;
+    _handleSessionIdleTimeout(): Promise<void>;
+    _waitForEvent(eventCodes: unknown, timeout?: number): Promise<unknown>;
+    _resolveWaiters(key: unknown, payload: unknown): void;
+    _resolveAllWaiters(error: unknown): void;
+    _removeWaiter(waiter: SpeechRTCWaiter, skipKey?: unknown): void;
+    _setState(state: unknown): void;
+    _createProtocolError(frame: Record<string, unknown>, message: string): Error;
+    _fail(error: unknown, source: string): void;
+    _resetForReuse(): void;
+    getRemainingPlaybackTime(): number;
+    _closeAudio(): Promise<void>;
+}
+export { SpeechRTCSession, EVENT as SPEECH_RTC_EVENT, SESSION_STATE as SPEECH_RTC_SESSION_STATE };
+export default SpeechRTC;
+//# sourceMappingURL=SpeechRTC.d.ts.map

package/dist-npm/types/src/rtc/SpeechRTC.d.ts.map

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

package/dist-npm/types/src/rtc/SpeechRTC.transport.d.ts

@@ -0,0 +1,191 @@
+/**
+ * SpeechRTC — VolcEngine bidirectional TTS client with managed session reuse.
+ *
+ * https://www.volcengine.com/docs/6561/1329505?lang=zh
+ *
+ * Browser callers work with text streams rather than raw WebSocket lifecycle.
+ * The SDK opens connections lazily, reuses pooled stream objects created via
+ * createTextStream(), auto-finishes an idle session after 10 seconds by
+ * default, and closes an underlying connection after 60 seconds of silence by
+ * default. Repeated createTextStream() calls with matching voice/connection
+ * settings will reuse an existing pooled stream instead of allocating a fresh
+ * one, up to maxParallelSessions pooled streams per SpeechRTC instance.
+ *
+ * Example usage:
+ * const speechRTC = new SpeechRTC(window.keepwork, {
+ *   // appId and accessToken are optional when the proxy provides defaults.
+ *   proxyUrl: 'wss://tts.keepwork.com/ws/tts/',
+ *   voiceType: 'zh_female_tianmeiyueyue_moon_bigtts',
+ * });
+ *
+ * const stream = speechRTC.createTextStream();
+ * stream.on('audioChunk', ({ bytes }) => console.log('audio chunk', bytes?.byteLength));
+ * stream.on('sentenceEnd', ({ text }) => console.log('sentence end', text));
+ *
+ * await stream.beginText('你好，欢迎使用 SpeechRTC。');
+ * await stream.appendText('这一段会继续发送到同一个会话。');
+ * const result = await stream.finish();
+ *
+ * // Or forward model output incrementally:
+ * await speechRTC.synthesizeChunks(asyncChunkSource);
+ */
+declare const DEFAULT_WS_URL = "wss://openspeech.bytedance.com/api/v3/tts/bidirection";
+declare const DEFAULT_PROXY_URL = "wss://speechrtc.keepwork.com/tts";
+declare const DEFAULT_RESOURCE_ID = "volc.service_type.10029";
+declare const DEFAULT_NAMESPACE = "BidirectionalTTS";
+declare const DEFAULT_FORMAT = "pcm";
+declare const DEFAULT_SAMPLE_RATE = 24000;
+declare const DEFAULT_SPEAKER = "zh_female_tianmeiyueyue_moon_bigtts";
+declare const EVENT: {
+    NONE: number;
+    START_CONNECTION: number;
+    FINISH_CONNECTION: number;
+    CONNECTION_STARTED: number;
+    CONNECTION_FAILED: number;
+    CONNECTION_FINISHED: number;
+    START_SESSION: number;
+    CANCEL_SESSION: number;
+    FINISH_SESSION: number;
+    SESSION_STARTED: number;
+    SESSION_CANCELED: number;
+    SESSION_FINISHED: number;
+    SESSION_FAILED: number;
+    USAGE_RESPONSE: number;
+    TASK_REQUEST: number;
+    UPDATE_CONFIG: number;
+    AUDIO_MUTED: number;
+    TTS_SENTENCE_START: number;
+    TTS_SENTENCE_END: number;
+    TTS_RESPONSE: number;
+    TTS_ENDED: number;
+    PODCAST_ROUND_START: number;
+    PODCAST_ROUND_RESPONSE: number;
+    PODCAST_ROUND_END: number;
+    SOURCE_SUBTITLE_START: number;
+    SOURCE_SUBTITLE_RESPONSE: number;
+    SOURCE_SUBTITLE_END: number;
+    TRANSLATION_SUBTITLE_START: number;
+    TRANSLATION_SUBTITLE_RESPONSE: number;
+    TRANSLATION_SUBTITLE_END: number;
+};
+declare const SESSION_STATE: {
+    IDLE: string;
+    CONNECTING: string;
+    CONNECTED: string;
+    STARTING: string;
+    ACTIVE: string;
+    FINISHING: string;
+    FINISHED: string;
+    CANCELED: string;
+    CLOSED: string;
+    FAILED: string;
+};
+declare const MESSAGE_TYPE: {
+    INVALID: number;
+    FULL_CLIENT_REQUEST: number;
+    AUDIO_ONLY_REQUEST: number;
+    FULL_SERVER_RESPONSE: number;
+    AUDIO_ONLY_RESPONSE: number;
+    FRONT_END_RESULT_RESPONSE: number;
+    ERROR_INFORMATION: number;
+};
+declare const MESSAGE_FLAG: {
+    NO_SEQUENCE: number;
+    POSITIVE_SEQUENCE: number;
+    LAST_NO_SEQUENCE: number;
+    NEGATIVE_SEQUENCE: number;
+    WITH_EVENT: number;
+};
+declare const VERSION_BITS: {
+    VERSION_1: number;
+};
+declare const HEADER_SIZE_BITS: {
+    HEADER_SIZE_4: number;
+};
+declare const SERIALIZATION: {
+    RAW: number;
+    JSON: number;
+};
+declare const COMPRESSION: {
+    NONE: number;
+    GZIP: number;
+};
+declare const CONNECTION_EVENTS: Set<number>;
+declare const CONNECT_ID_EVENTS: Set<number>;
+/** _waitForEvent 等待者 */
+interface SpeechRTCWaiter {
+    values: unknown[];
+    resolve: (payload: unknown) => void;
+    reject: (error: unknown) => void;
+}
+declare function randomId(prefix?: string, length?: number): string;
+declare function clamp(value: unknown, min: number, max: number, fallback: number): number;
+declare function ensureObject(value: unknown): Record<string, unknown>;
+declare function mergeDeep(base: unknown, extra: unknown): Record<string, unknown>;
+declare function concatUint8Arrays(chunks: Uint8Array[]): Uint8Array;
+declare function shouldIncludeSessionId(eventCode: number): boolean;
+declare function shouldIncludeConnectId(eventCode: number): boolean;
+declare function inferResourceId(voiceType: unknown): string;
+declare function pcm16ToFloat32(bytes: Uint8Array): Float32Array;
+declare function isSessionTerminalState(state: unknown): boolean;
+declare function positiveNumberOr(value: unknown, fallback: number): number;
+declare function stableJson(value: unknown): string;
+declare function iterateTextChunks(input: unknown): AsyncGenerator<string>;
+declare const DEFAULT_SESSION_IDLE_TIMEOUT_MS = 10000;
+declare const DEFAULT_CONNECTION_IDLE_TIMEOUT_MS = 60000;
+declare const DEFAULT_CONNECTION_MAX_LIFETIME_MS: number;
+declare class SpeechRTCTransport {
+    speechRTC: Record<string, unknown>;
+    sdk: unknown;
+    ws: WebSocket | null;
+    isConnected: boolean;
+    connectId: string;
+    _connectionPromise: Promise<unknown> | null;
+    _waiters: Map<unknown, SpeechRTCWaiter[]>;
+    _activeSession: Record<string, unknown> | null;
+    _connectionOptions: Record<string, unknown> | null;
+    _connectionSignature: string;
+    _restartPending: boolean;
+    _socketOpenedAt: number;
+    _lastActivityAt: number;
+    _connectionIdleTimer: ReturnType<typeof setTimeout> | null;
+    baseOptions: Record<string, unknown>;
+    [key: string]: unknown;
+    constructor(speechRTC: Record<string, unknown>, options?: Record<string, unknown>);
+    updateBaseOptions(options?: Record<string, unknown>): void;
+    prepareSession(session: Record<string, unknown>): Promise<void>;
+    releaseSession(session: Record<string, unknown>): void;
+    /**
+     * Fire-and-forget CANCEL_SESSION for a session that failed locally but may
+     * still be alive on the Volcengine server. Silently ignored if the socket
+     * is not open.
+     */
+    _tryCancelStaleSession(sessionId: string): void;
+    sendEvent(eventCode: number, payload: unknown, sessionId?: string): Promise<void>;
+    shutdown(options?: {
+        graceful?: boolean;
+        timeout?: number;
+    }): Promise<void>;
+    _applyConnectionOptions(options?: Record<string, unknown>): void;
+    _shouldRestartConnection(): boolean;
+    _ensureConnected(): Promise<WebSocket | null | unknown>;
+    _createWebSocket(): unknown;
+    _buildHandshakeHeaders(): Record<string, unknown>;
+    _sendConnectionStart(): Promise<void>;
+    _handleMessage(data: unknown): Promise<void>;
+    _handleTransportFailure(error: unknown, source: string): void;
+    _sendBinary(buffer: ArrayBufferLike | ArrayBufferView): void;
+    _touchActivity(): void;
+    _scheduleConnectionIdleTimer(): void;
+    _clearConnectionIdleTimer(): void;
+    _waitForEvent(eventCodes: unknown, timeout?: number): Promise<unknown>;
+    _resolveWaiters(key: unknown, payload: unknown): void;
+    _resolveAllWaiters(error: unknown): void;
+    _removeWaiter(waiter: SpeechRTCWaiter, skipKey?: unknown): void;
+    _createProtocolError(frame: Record<string, unknown>, message: string): Error;
+    _closeSocket(options?: {
+        preserveWaiters?: boolean;
+    }): void;
+}
+export { SpeechRTCTransport, DEFAULT_WS_URL, DEFAULT_PROXY_URL, DEFAULT_RESOURCE_ID, DEFAULT_NAMESPACE, DEFAULT_FORMAT, DEFAULT_SAMPLE_RATE, DEFAULT_SPEAKER, DEFAULT_SESSION_IDLE_TIMEOUT_MS, DEFAULT_CONNECTION_IDLE_TIMEOUT_MS, DEFAULT_CONNECTION_MAX_LIFETIME_MS, EVENT, SESSION_STATE, MESSAGE_TYPE, MESSAGE_FLAG, VERSION_BITS, HEADER_SIZE_BITS, SERIALIZATION, COMPRESSION, CONNECTION_EVENTS, CONNECT_ID_EVENTS, randomId, clamp, ensureObject, mergeDeep, concatUint8Arrays, shouldIncludeSessionId, shouldIncludeConnectId, inferResourceId, positiveNumberOr, stableJson, pcm16ToFloat32, isSessionTerminalState, iterateTextChunks, };
+//# sourceMappingURL=SpeechRTC.transport.d.ts.map

package/dist-npm/types/src/rtc/SpeechRTC.transport.d.ts.map

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

package/dist-npm/types/src/store/CloudDrive.d.ts

@@ -0,0 +1,140 @@
+/**
+ * CloudDrive.ts — 个人文件上传/管理（经七牛 CDN，完整 TypeScript 实现）
+ *
+ * 提供上传、列表、删除、重命名、原始 URL 等能力：与 Keepwork 存储网关
+ * （`/ts-storage`）通信，并把文件直传到七牛 `z2` 区域。
+ *
+ * @example
+ *   const drive = window.keepwork.cloudDrive;
+ *   const file = (document.querySelector('input[type=file]') as HTMLInputElement).files![0];
+ *   const result = await drive.upload(file, { onProgress: p => console.log(p) });
+ *   const list   = await drive.list();
+ *   await drive.rename(result.key, 'newName.png');
+ *   const url    = await drive.getRawUrl(result.key);
+ *   await drive.remove(result.key);
+ */
+/** 上传进度信息 */
+export interface UploadProgress {
+    percent: number;
+    loaded: number;
+    total: number;
+}
+/** 上传进度回调 */
+export type UploadProgressCallback = (progress: UploadProgress) => void;
+/** upload() 选项 */
+export interface CloudDriveUploadOptions {
+    /** 显示名（默认 file.name） */
+    filename?: string;
+    /** 显式七牛 key（省略则自动生成） */
+    key?: string;
+    /** 进度回调 */
+    onProgress?: UploadProgressCallback;
+}
+/** uploadTempFile() 选项 */
+export interface CloudDriveTempUploadOptions extends CloudDriveUploadOptions {
+    /** 生命周期（自动删除时间），见类内文档 */
+    expire?: string | number | null;
+}
+/** upload() 返回结果 */
+export interface CloudDriveUploadResult {
+    key: string;
+    fileId: string | number | undefined;
+    filename: string;
+    size: number;
+}
+/** uploadTempFile() 返回结果 */
+export interface CloudDriveTempUploadResult extends CloudDriveUploadResult {
+    url: string;
+}
+/** list() 选项 */
+export interface CloudDriveListOptions {
+    /** 页码（1-based） */
+    page?: number;
+    /** 每页条数 */
+    perPage?: number;
+    /** 按文件名子串过滤 */
+    filename?: string;
+}
+/** sdk 需提供的最小接口 */
+interface CloudDriveSdk {
+    baseURL?: string;
+    user?: {
+        id?: string | number;
+    };
+    getAuthHeaders(): Record<string, string>;
+}
+export default class CloudDrive {
+    sdk: CloudDriveSdk;
+    constructor(sdk: unknown);
+    /**
+     * 从 SDK 的核心 API 基地址推导存储网关基地址。
+     * api.keepwork.com/core/v0 → api.keepwork.com/ts-storage
+     */
+    private _getStorageBase;
+    /**
+     * 向存储网关发起带认证的请求。
+     */
+    private _storageRequest;
+    /**
+     * 为给定文件生成唯一七牛 object key。格式：`{userId}-{uuid}.{ext}`
+     */
+    private _generateKey;
+    /**
+     * 上传 File/Blob 到个人 CDN 文件夹。
+     */
+    upload(file: File | Blob, opts?: CloudDriveUploadOptions): Promise<CloudDriveUploadResult>;
+    /**
+     * 底层七牛上传（XMLHttpRequest，支持进度）。
+     * 七牛 z2 区上传端点：https://upload-z2.qiniup.com
+     */
+    private _qiniuUpload;
+    /**
+     * 把 `opts.expire`（string | number | null）解析为控制
+     * `keepwork-public-temporary` 桶生命周期的桶前缀。
+     *
+     * 生命周期规则：
+     *   - （无前缀）→ 服务端默认过期时间
+     *   - `tmpImg`    → 7 天
+     *   - `temp_90`   → 90 天
+     *   - `temp_180`  → 180 天
+     *   - `temp_360`  → 360 天
+     *
+     * 接受：null/undefined/'' → ''；精确前缀字符串原样用；number(天数)→最小满足的前缀；
+     * 形如 '91days'/'180 d'/'7' 的字符串→解析为天数。
+     */
+    private _resolveTempPrefix;
+    /**
+     * 为临时桶生成七牛 object key。镜像 `_generateKey()` 但可选地前置生命周期前缀
+     * 并保留原始文件名。格式：`{prefix}_{userId}-{originalFilename}`（无前缀时省略 prefix_）
+     */
+    private _generateTempKey;
+    /**
+     * 上传 File/Blob 到公共临时 CDN 桶。生命周期（自动删除时间）由 `opts.expire` 控制
+     * （映射为桶 key 前缀，见 _resolveTempPrefix）。
+     *
+     * 结果 URL：`https://qiniu-public-temporary.keepwork.com/{key}`
+     */
+    uploadTempFile(file: File | Blob, opts?: CloudDriveTempUploadOptions): Promise<CloudDriveTempUploadResult>;
+    /**
+     * 列出用户个人 CDN 文件夹中的文件。返回 `{ data: [...], total, page, ... }`。
+     */
+    list(opts?: CloudDriveListOptions): Promise<unknown>;
+    /**
+     * 获取存储用量统计。
+     */
+    info(): Promise<unknown>;
+    /**
+     * 重命名文件的显示名（七牛 key 保持不变）。
+     */
+    rename(key: string, filename: string): Promise<unknown>;
+    /**
+     * 按 id（或当作 id 的 key）删除文件。
+     */
+    remove(id: string | number): Promise<unknown>;
+    /**
+     * 获取文件的公共 CDN URL。
+     */
+    getRawUrl(fileId: string | number): Promise<string>;
+}
+export {};
+//# sourceMappingURL=CloudDrive.d.ts.map

package/dist-npm/types/src/store/CloudDrive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudDrive.d.ts","sourceRoot":"","sources":["../../../../src/store/CloudDrive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,aAAa;AACb,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;AAExE,kBAAkB;AAClB,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW;IACX,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAED,0BAA0B;AAC1B,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,oBAAoB;AACpB,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4BAA4B;AAC5B,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,gBAAgB;AAChB,MAAM,WAAW,qBAAqB;IACpC,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,mBAAmB;AACnB,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAChC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAUD,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,GAAG,EAAE,aAAa,CAAC;gBAEP,GAAG,EAAE,OAAO;IAMxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;YACW,eAAe;IA8B7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAwBpG;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAE,2BAAgC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA8BpH;;OAEG;IACG,IAAI,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAM9B;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7D;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI1D"}

package/dist-npm/types/src/store/LocalStorageUtil.d.ts

@@ -0,0 +1,136 @@
+/**
+ * LocalStorageUtil — 基于 IndexedDB 的持久化存储工具，配备内存 LRU 缓存
+ *
+ * 数据流向：
+ * - 写入：立即更新内存缓存（L1），然后异步写入 IndexedDB（L2）
+ * - 读取：内存缓存命中直接返回；未命中时触发后台异步预热
+ * - 旧版 localStorage 数据在首次读取时自动迁移到 IndexedDB
+ *
+ * 超大项（默认 > 2MB）跳过内存缓存，直接操作 IndexedDB，
+ * 防止单个巨型对象挤出整个缓存。
+ */
+/** getStorageStats 返回的存储使用情况统计 */
+export interface StorageStats {
+    /** IndexedDB 中所有 key/value 的估算字节数 */
+    indexedDB: number;
+    /** 当前内存缓存的 key 数量 */
+    memoryCache: number;
+    /** 当前内存缓存的估算字节数 */
+    memoryCacheSize: number;
+    /** 内存缓存的最大字节限制 */
+    memoryCacheMaxSize: number;
+}
+declare class LocalStorageUtil {
+    static readonly DB_NAME = "keepwork-personal-store";
+    static readonly STORE_NAME = "keyval";
+    /** IndexedDB 连接 Promise（单例，全生命周期共享） */
+    private static _dbPromise;
+    /** 内存 LRU 缓存（L1），key → 任意值 */
+    private static _memoryCache;
+    /** 当前内存缓存的估算字节数 */
+    private static _memoryCacheSize;
+    /** 各 key 的最近访问时间戳（用于 LRU 淘汰） */
+    private static _memoryCacheAccess;
+    /** 内存缓存最大字节限制（10 MB） */
+    static MAX_CACHE_SIZE: number;
+    /** 单项占内存缓存最大比例（20%），超过此比例的项跳过内存缓存 */
+    static MAX_ITEM_SIZE_RATIO: number;
+    /** 触发 LRU 淘汰的缓存使用率阈值（80%） */
+    static CACHE_EVICTION_THRESHOLD: number;
+    static get MAX_ITEM_SIZE_FOR_CACHE(): number;
+    /**
+     * 估算值在内存中的字节占用（近似值，UTF-16 计算）。
+     * @internal
+     */
+    private static _estimateSize;
+    /**
+     * 将项写入内存缓存。
+     * 超大项跳过缓存；若缓存接近阈值则先触发 LRU 淘汰。
+     *
+     * @returns 是否成功写入内存缓存
+     * @internal
+     */
+    private static _setCacheItem;
+    /** 从内存缓存读取项，并更新 LRU 访问时间。@internal */
+    private static _getCacheItem;
+    /** 从内存缓存中移除项。@internal */
+    private static _removeCacheItem;
+    /**
+     * LRU 淘汰：按最近访问时间升序逐项删除，直到腾出足够空间。
+     * @internal
+     */
+    private static _evictLRUItems;
+    /**
+     * 获取（或初始化）IndexedDB 连接，返回单例 Promise。
+     * @internal
+     */
+    private static _getDB;
+    /**
+     * 在 IndexedDB 事务中执行回调。
+     * `callback` 接收 store、resolve、reject 三个参数，
+     * 可在其中调用 store 方法并决定 Promise 结果。
+     * @internal
+     */
+    private static _withStore;
+    /**
+     * 同步写入（立即更新内存缓存，异步写入 IndexedDB）。
+     * 适用于写入频繁、读取延迟不敏感的场景。
+     *
+     * @param key   - 存储键
+     * @param value - 要存储的值（任意可序列化对象）
+     * @returns 始终返回 true（写入操作已调度）
+     */
+    static setItem(key: string, value: unknown): boolean;
+    /** @internal */
+    private static _setItemAsync;
+    /**
+     * 同步读取（从内存缓存取值，并在后台异步预热缓存）。
+     * 若内存缓存未命中，立即返回 `defaultValue` 并在后台加载 IndexedDB 数据。
+     *
+     * @param key          - 存储键
+     * @param defaultValue - 缓存未命中时的默认值（默认 null）
+     */
+    static getItem<T = unknown>(key: string, defaultValue?: T | null): T | null;
+    /** @internal */
+    private static _getItemAsync;
+    /**
+     * 异步读取，保证获得持久化数据。
+     * 优先级：内存缓存 → IndexedDB → localStorage 旧版迁移。
+     *
+     * @param key          - 存储键
+     * @param defaultValue - 未找到时的默认值
+     */
+    static getItemAsync<T = unknown>(key: string, defaultValue?: T | null): Promise<T | null>;
+    /**
+     * 直接从 IndexedDB 读取（绕过内存缓存，适合需要强一致性的场景）。
+     */
+    static getFromIndexedDB<T = unknown>(key: string, defaultValue?: T | null): Promise<T | null>;
+    /** 直接写入 IndexedDB（绕过内存缓存）。 */
+    static setToIndexedDB(key: string, value: unknown): Promise<boolean>;
+    /**
+     * 获取 IndexedDB 中所有 key 的列表。
+     */
+    static getAllKeys(): Promise<IDBValidKey[]>;
+    /**
+     * 同步删除（立即清理内存缓存，异步删除 IndexedDB）。
+     */
+    static removeItem(key: string): boolean;
+    /** @internal */
+    private static _removeItemAsync;
+    /**
+     * 清空所有数据（内存缓存 + IndexedDB）。
+     */
+    static clear(): boolean;
+    /** @internal */
+    private static _clearAsync;
+    /**
+     * 获取存储使用情况统计（内存缓存 + IndexedDB 估算大小）。
+     * 用于调试和容量监控。
+     */
+    static getStorageStats(): Promise<StorageStats>;
+}
+/** StorageUtil 是 LocalStorageUtil 的别名，保持向后兼容 */
+declare const StorageUtil: typeof LocalStorageUtil;
+export default LocalStorageUtil;
+export { LocalStorageUtil, StorageUtil };
+//# sourceMappingURL=LocalStorageUtil.d.ts.map

package/dist-npm/types/src/store/LocalStorageUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalStorageUtil.d.ts","sourceRoot":"","sources":["../../../../src/store/LocalStorageUtil.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,cAAM,gBAAgB;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,6BAA6B;IACpD,MAAM,CAAC,QAAQ,CAAC,UAAU,YAAY;IAEtC,uCAAuC;IACvC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAqC;IAE9D,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAC,YAAY,CAA+B;IAC1D,mBAAmB;IACnB,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAK;IACpC,gCAAgC;IAChC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA8B;IAE/D,wBAAwB;IACxB,MAAM,CAAC,cAAc,SAAoB;IACzC,qCAAqC;IACrC,MAAM,CAAC,mBAAmB,SAAO;IACjC,6BAA6B;IAC7B,MAAM,CAAC,wBAAwB,SAAO;IAEtC,MAAM,KAAK,uBAAuB,IAAI,MAAM,CAE3C;IAID;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA6B5B,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,aAAa;IAQ5B,0BAA0B;IAC1B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAS/B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAwB7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,MAAM;IA8BrB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAyBzB;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAQpD,gBAAgB;mBACK,aAAa;IAYlC;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,CAAC,GAAG,IAAW,GAAG,CAAC,GAAG,IAAI;IAcjF,gBAAgB;mBACK,aAAa;IAiBlC;;;;;;OAMG;WACU,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgCrG;;OAEG;WACU,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKzG,8BAA8B;WACjB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E;;OAEG;WACU,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBjD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQvC,gBAAgB;mBACK,gBAAgB;IAYrC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,OAAO;IAUvB,gBAAgB;mBACK,WAAW;IAYhC;;;OAGG;WACU,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;CAsEtD;AAED,gDAAgD;AAChD,QAAA,MAAM,WAAW,yBAAmB,CAAC;AAErC,eAAe,gBAAgB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC"}