@aituber-onair/core 0.1.0

package/dist/services/youtube/YouTubeDataApiService.js

@@ -0,0 +1,255 @@
+import { ENDPOINT_YOUTUBE_API } from '../../constants';
+import { EventEmitter } from '../../core/EventEmitter';
+/**
+ * YouTube Data API implementation using YouTube service
+ */
+export class YouTubeDataApiService extends EventEmitter {
+    /**
+     * Constructor
+     * @param options Service settings options
+     */
+    constructor(options) {
+        super();
+        this.isWatchingLive = false;
+        this.watchingIntervalId = null;
+        this.nextPageToken = '';
+        this.currentLiveId = '';
+        this.options = {
+            apiKey: options.apiKey,
+            fetchInterval: options.fetchInterval || 20000, // デフォルト20秒
+            selectionStrategy: options.selectionStrategy || 'random',
+        };
+    }
+    /**
+     * Start watching live comments
+     * @param liveId Live ID
+     */
+    async startWatching(liveId) {
+        if (this.isWatchingLive) {
+            this.stopWatching();
+        }
+        this.isWatchingLive = true;
+        this.nextPageToken = '';
+        this.currentLiveId = liveId;
+        try {
+            // Get live chat ID
+            const liveChatId = await this.getLiveChatId(liveId);
+            if (!liveChatId) {
+                console.error('Could not get live chat ID');
+                this.isWatchingLive = false;
+                this.emit('error', new Error('Could not get live chat ID'));
+                return;
+            }
+            // Get comments periodically
+            this.watchingIntervalId = window.setInterval(async () => {
+                try {
+                    await this.fetchAndProcessComments(liveChatId);
+                }
+                catch (error) {
+                    console.error('Error fetching comments:', error);
+                    this.emit('error', error);
+                }
+            }, this.options.fetchInterval);
+            this.emit('watchingStarted', liveId);
+        }
+        catch (error) {
+            console.error('Error starting live monitoring:', error);
+            this.isWatchingLive = false;
+            this.emit('error', error);
+        }
+    }
+    /**
+     * Stop watching live comments
+     */
+    stopWatching() {
+        if (this.watchingIntervalId) {
+            window.clearInterval(this.watchingIntervalId);
+            this.watchingIntervalId = null;
+        }
+        this.isWatchingLive = false;
+        this.nextPageToken = '';
+        this.currentLiveId = '';
+        this.emit('watchingStopped');
+    }
+    /**
+     * Return whether currently fetching
+     */
+    isWatching() {
+        return this.isWatchingLive;
+    }
+    /**
+     * Set comment fetch interval
+     * @param interval Interval in milliseconds
+     */
+    setFetchInterval(interval) {
+        this.options.fetchInterval = interval;
+        // If currently watching, update interval
+        if (this.isWatchingLive && this.watchingIntervalId && this.currentLiveId) {
+            window.clearInterval(this.watchingIntervalId);
+            this.watchingIntervalId = window.setInterval(async () => {
+                try {
+                    const liveChatId = await this.getLiveChatId(this.currentLiveId);
+                    if (liveChatId) {
+                        await this.fetchAndProcessComments(liveChatId);
+                    }
+                }
+                catch (error) {
+                    console.error('Error fetching comments:', error);
+                    this.emit('error', error);
+                }
+            }, interval);
+        }
+    }
+    /**
+     * Set comment selection strategy
+     * @param strategy Selection strategy ('random' or 'latest')
+     */
+    setSelectionStrategy(strategy) {
+        this.options.selectionStrategy = strategy;
+    }
+    /**
+     * Fetch latest comments (for manual retrieval)
+     * @param liveId Live ID
+     * @returns Comments array
+     */
+    async fetchLatestComments(liveId) {
+        try {
+            const liveChatId = await this.getLiveChatId(liveId);
+            if (!liveChatId) {
+                return [];
+            }
+            return await this.retrieveLiveComments(liveChatId, false);
+        }
+        catch (error) {
+            console.error('Error fetching comments:', error);
+            this.emit('error', error);
+            return [];
+        }
+    }
+    /**
+     * Subscribe to comment reception event
+     * @param callback Callback when comment is received
+     */
+    onComment(callback) {
+        this.on('comment', callback);
+    }
+    /**
+     * Get live chat ID
+     * @param liveId Live ID
+     * @returns Live chat ID
+     */
+    async getLiveChatId(liveId) {
+        try {
+            const params = {
+                part: 'liveStreamingDetails',
+                id: liveId,
+                key: this.options.apiKey,
+            };
+            const query = new URLSearchParams(params);
+            const response = await fetch(`${ENDPOINT_YOUTUBE_API}/videos?${query}`, {
+                method: 'get',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+            const json = await response.json();
+            if (!json.items || json.items.length === 0) {
+                console.warn('Live broadcast information not found:', json);
+                return '';
+            }
+            const liveStreamingDetails = json.items[0].liveStreamingDetails;
+            if (!liveStreamingDetails || !liveStreamingDetails.activeLiveChatId) {
+                console.warn('Live chat ID not found:', json.items[0]);
+                return '';
+            }
+            return liveStreamingDetails.activeLiveChatId;
+        }
+        catch (error) {
+            console.error('Error fetching live chat ID:', error);
+            this.emit('error', error);
+            return '';
+        }
+    }
+    /**
+     * Fetch live comments
+     * @param liveChatId Live chat ID
+     * @param usePageToken Whether to use page token
+     * @returns Comments array
+     */
+    async retrieveLiveComments(liveChatId, usePageToken = true) {
+        try {
+            let url = `${ENDPOINT_YOUTUBE_API}/liveChat/messages?liveChatId=` +
+                liveChatId +
+                '&part=authorDetails%2Csnippet&key=' +
+                this.options.apiKey;
+            if (usePageToken && this.nextPageToken) {
+                url += '&pageToken=' + this.nextPageToken;
+            }
+            const response = await fetch(url, {
+                method: 'get',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+            });
+            const json = await response.json();
+            if (json.error) {
+                console.error('YouTube API error:', json.error);
+                this.emit('error', new Error(json.error.message || 'YouTube API error'));
+                return [];
+            }
+            // Save next page token
+            if (json.nextPageToken) {
+                this.nextPageToken = json.nextPageToken;
+            }
+            if (!json.items || json.items.length === 0) {
+                return [];
+            }
+            // Extract comment information
+            const comments = json.items
+                .map((item) => ({
+                userName: item.authorDetails.displayName,
+                userIconUrl: item.authorDetails.profileImageUrl,
+                userComment: item.snippet.textMessageDetails?.messageText ||
+                    item.snippet.superChatDetails?.userComment ||
+                    '',
+                publishedAt: item.snippet.publishedAt,
+            }))
+                .filter((comment) => comment.userComment !== '');
+            return comments;
+        }
+        catch (error) {
+            console.error('Error fetching live comments:', error);
+            this.emit('error', error);
+            return [];
+        }
+    }
+    /**
+     * Fetch and process comments
+     * @param liveChatId Live chat ID
+     */
+    async fetchAndProcessComments(liveChatId) {
+        try {
+            const comments = await this.retrieveLiveComments(liveChatId);
+            if (comments.length === 0) {
+                return;
+            }
+            // Select comment based on selection strategy
+            let selectedComment;
+            if (this.options.selectionStrategy === 'random') {
+                // Random selection
+                selectedComment = comments[Math.floor(Math.random() * comments.length)];
+            }
+            else {
+                // Latest comment selection
+                selectedComment = comments[comments.length - 1];
+            }
+            // Emit comment event
+            this.emit('comment', selectedComment);
+        }
+        catch (error) {
+            console.error('Error processing comments:', error);
+            this.emit('error', error);
+        }
+    }
+}
+//# sourceMappingURL=YouTubeDataApiService.js.map

package/dist/services/youtube/YouTubeDataApiService.js.map

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

package/dist/services/youtube/YouTubeService.d.ts

@@ -0,0 +1,63 @@
+/**
+ * YouTube comment type definition
+ */
+export interface YouTubeComment {
+    /** User name */
+    userName: string;
+    /** User icon URL */
+    userIconUrl: string;
+    /** Comment content */
+    userComment: string;
+    /** Published time */
+    publishedAt?: string;
+}
+/**
+ * YouTube service settings options
+ */
+export interface YouTubeServiceOptions {
+    /** YouTube Data API key */
+    apiKey: string;
+    /** Comment fetch interval (milliseconds) */
+    fetchInterval?: number;
+    /** Comment selection strategy ('random' or 'latest') */
+    selectionStrategy?: 'random' | 'latest';
+}
+/**
+ * YouTube service interface
+ */
+export interface YouTubeService {
+    /**
+     * Start watching live comments
+     * @param liveId Live ID
+     */
+    startWatching(liveId: string): Promise<void>;
+    /**
+     * Stop watching live comments
+     */
+    stopWatching(): void;
+    /**
+     * Return whether currently fetching
+     */
+    isWatching(): boolean;
+    /**
+     * Set comment fetch interval
+     * @param interval Interval in milliseconds
+     */
+    setFetchInterval(interval: number): void;
+    /**
+     * Set comment selection strategy
+     * @param strategy Selection strategy ('random' or 'latest')
+     */
+    setSelectionStrategy(strategy: 'random' | 'latest'): void;
+    /**
+     * Fetch latest comments (for manual retrieval)
+     * @param liveId Live ID
+     * @returns Comments array
+     */
+    fetchLatestComments(liveId: string): Promise<YouTubeComment[]>;
+    /**
+     * Subscribe to comment reception event
+     * @param callback Callback when comment is received
+     */
+    onComment(callback: (comment: YouTubeComment) => void): void;
+}

package/dist/services/youtube/YouTubeService.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=YouTubeService.js.map

package/dist/services/youtube/YouTubeService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"YouTubeService.js","sourceRoot":"","sources":["../../../src/services/youtube/YouTubeService.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * AITuber OnAir Core type definitions
+ */
+/**
+ * Chat message basic type
+ */
+export interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+    timestamp?: number;
+}
+/**
+ * Message type corresponding to vision (image)
+ */
+export interface MessageWithVision {
+    role: 'system' | 'user' | 'assistant';
+    content: string | Array<{
+        type: 'text' | 'image_url';
+        text?: string;
+        image_url?: {
+            url: string;
+            detail: 'low' | 'high';
+        };
+    }>;
+}
+/**
+ * Chat type
+ * - chatForm: Chat from text input
+ * - youtube: Chat from YouTube comments
+ * - vision: Chat from vision (image)
+ */
+export type ChatType = 'chatForm' | 'youtube' | 'vision';
+/**
+ * Memory storage interface for persistence
+ * Implementations can use various storage mechanisms (LocalStorage, IndexedDB, files, etc.)
+ */
+export interface MemoryStorage {
+    /**
+     * Load memory records from storage
+     * @returns Promise resolving to array of memory records
+     */
+    load(): Promise<MemoryRecord[]>;
+    /**
+     * Save memory records to storage
+     * @param records Memory records to save
+     * @returns Promise resolving when save is complete
+     */
+    save(records: MemoryRecord[]): Promise<void>;
+    /**
+     * Clear all stored memory records
+     * @returns Promise resolving when clear is complete
+     */
+    clear(): Promise<void>;
+}
+/**
+ * Memory record type
+ */
+export type MemoryType = 'short' | 'mid' | 'long';
+/**
+ * Memory record type
+ */
+export interface MemoryRecord {
+    type: MemoryType;
+    summary: string;
+    timestamp: number;
+}
+/**
+ * Screenplay (text with emotion)
+ */
+export interface Screenplay {
+    text: string;
+    emotion?: string;
+}
+/**
+ * Speech synthesis options
+ */
+export interface SpeakOptions {
+    speed?: number;
+    pitch?: number;
+    intonation?: number;
+    volumeScale?: number;
+}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * AITuber OnAir Core type definitions
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/nijiVoice.d.ts

@@ -0,0 +1,27 @@
+export interface VoiceActor {
+    id: string;
+    name: string;
+    nameReading?: string;
+    age?: number;
+    gender: string;
+    birthMonth?: number;
+    birthDay?: number;
+    smallImageUrl: string;
+    mediumImageUrl: string;
+    largeImageUrl: string;
+    sampleVoiceUrl: string;
+    sampleScript: string;
+    recommendedVoiceSpeed: number;
+    recommendedEmotionalLevel: number;
+    recommendedSoundDuration: number;
+    voiceStyles: Array<{
+        id: number;
+        style: string;
+    }>;
+}
+export interface VoiceActorResponse {
+    voice_actors: VoiceActor[];
+}
+export interface GeneratedVoiceResponse {
+    audio_base64: string;
+}

package/dist/types/nijiVoice.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nijiVoice.js.map

package/dist/types/nijiVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nijiVoice.js","sourceRoot":"","sources":["../../src/types/nijiVoice.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Export utility functions
+ */
+export * from './screenshot';
+export * from './screenplay';

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Export utility functions
+ */
+export * from './screenshot';
+export * from './screenplay';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/utils/screenplay.d.ts

@@ -0,0 +1,19 @@
+import { Screenplay } from '../types';
+/**
+ * Convert text to screenplay (text with emotion)
+ * @param text Original text (may contain emotion expressions like [happy])
+ * @returns Screenplay object with emotion and text separated
+ */
+export declare function textToScreenplay(text: string): Screenplay;
+/**
+ * Convert multiple texts to screenplay array
+ * @param texts Text array
+ * @returns Array of screenplay objects
+ */
+export declare function textsToScreenplay(texts: string[]): Screenplay[];
+/**
+ * Convert screenplay to text with emotion
+ * @param screenplay Screenplay object
+ * @returns Text with emotion (e.g. [happy] Hello)
+ */
+export declare function screenplayToText(screenplay: Screenplay): string;

package/dist/utils/screenplay.js

@@ -0,0 +1,42 @@
+/**
+ * Extract emotion from text using regex
+ * Extract emotion from text written in the format [happy], [sad], etc.
+ */
+const EMOTION_REGEX = /^\s*\[([a-z]+)\]\s*/i;
+/**
+ * Convert text to screenplay (text with emotion)
+ * @param text Original text (may contain emotion expressions like [happy])
+ * @returns Screenplay object with emotion and text separated
+ */
+export function textToScreenplay(text) {
+    const match = text.match(EMOTION_REGEX);
+    if (match) {
+        const emotion = match[1].toLowerCase();
+        const cleanText = text.replace(EMOTION_REGEX, '');
+        return {
+            emotion,
+            text: cleanText,
+        };
+    }
+    return { text };
+}
+/**
+ * Convert multiple texts to screenplay array
+ * @param texts Text array
+ * @returns Array of screenplay objects
+ */
+export function textsToScreenplay(texts) {
+    return texts.map((text) => textToScreenplay(text));
+}
+/**
+ * Convert screenplay to text with emotion
+ * @param screenplay Screenplay object
+ * @returns Text with emotion (e.g. [happy] Hello)
+ */
+export function screenplayToText(screenplay) {
+    if (screenplay.emotion) {
+        return `[${screenplay.emotion}] ${screenplay.text}`;
+    }
+    return screenplay.text;
+}
+//# sourceMappingURL=screenplay.js.map

package/dist/utils/screenplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenplay.js","sourceRoot":"","sources":["../../src/utils/screenplay.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAExC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO;YACL,OAAO;YACP,IAAI,EAAE,SAAS;SAChB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAsB;IACrD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC;AACzB,CAAC"}

package/dist/utils/screenshot.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Screenshot related utilities
+ */
+/**
+ * Capture screenshot from video element
+ * @param videoElement Video element to capture
+ * @param options Capture options
+ * @returns DataURL of image (JPEG), null if failed
+ */
+export declare function captureScreenshot(videoElement: HTMLVideoElement, options?: {
+    format?: 'image/jpeg' | 'image/png';
+    quality?: number;
+}): string | null;
+/**
+ * Convert DataURL to Blob
+ * @param dataUrl DataURL of image
+ * @returns Blob object
+ */
+export declare function dataUrlToBlob(dataUrl: string): Promise<Blob>;

package/dist/utils/screenshot.js

@@ -0,0 +1,44 @@
+/**
+ * Screenshot related utilities
+ */
+/**
+ * Capture screenshot from video element
+ * @param videoElement Video element to capture
+ * @param options Capture options
+ * @returns DataURL of image (JPEG), null if failed
+ */
+export function captureScreenshot(videoElement, options = {}) {
+    try {
+        if (!videoElement) {
+            console.warn('Video element not provided');
+            return null;
+        }
+        const format = options.format || 'image/jpeg';
+        const quality = options.quality || 0.9;
+        // Create <canvas> and draw <video>
+        const canvas = document.createElement('canvas');
+        const ctx = canvas.getContext('2d');
+        if (!ctx) {
+            console.warn('Failed to get canvas context');
+            return null;
+        }
+        canvas.width = videoElement.videoWidth;
+        canvas.height = videoElement.videoHeight;
+        ctx.drawImage(videoElement, 0, 0, canvas.width, canvas.height);
+        return canvas.toDataURL(format, quality);
+    }
+    catch (error) {
+        console.error('Error capturing screenshot:', error);
+        return null;
+    }
+}
+/**
+ * Convert DataURL to Blob
+ * @param dataUrl DataURL of image
+ * @returns Blob object
+ */
+export async function dataUrlToBlob(dataUrl) {
+    const response = await fetch(dataUrl);
+    return await response.blob();
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/utils/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/utils/screenshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAA8B,EAC9B,UAAqE,EAAE;IAEvE,IAAI,CAAC;QACH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;QAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;QAEvC,mCAAmC;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC;QACvC,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC;QACzC,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAE/D,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/utils/storage.d.ts

@@ -0,0 +1,44 @@
+import { MemoryRecord, MemoryStorage } from '../types';
+/**
+ * LocalStorage implementation of MemoryStorage
+ */
+export declare class LocalStorageMemoryStorage implements MemoryStorage {
+    private storageKey;
+    /**
+     * Constructor
+     * @param storageKey Key to use in localStorage
+     */
+    constructor(storageKey: string);
+    /**
+     * Load memory records from localStorage
+     * @returns Promise resolving to array of memory records
+     */
+    load(): Promise<MemoryRecord[]>;
+    /**
+     * Save memory records to localStorage
+     * @param records Memory records to save
+     * @returns Promise resolving when save is complete
+     */
+    save(records: MemoryRecord[]): Promise<void>;
+    /**
+     * Clear all stored memory records
+     * @returns Promise resolving when clear is complete
+     */
+    clear(): Promise<void>;
+}
+/**
+ * IndexedDB implementation of MemoryStorage (example skeleton)
+ * This is just a placeholder - would need to be implemented properly
+ */
+export declare class IndexedDBMemoryStorage implements MemoryStorage {
+    load(): Promise<MemoryRecord[]>;
+    save(records: MemoryRecord[]): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * Factory function to create appropriate storage based on environment
+ * @param storageKey Key to use for storage
+ * @param storageType Type of storage to use
+ * @returns MemoryStorage implementation
+ */
+export declare function createMemoryStorage(storageKey: string, storageType?: 'localStorage' | 'indexedDB'): MemoryStorage;