svelte-firekit 0.1.9 → 0.2.0

package/dist/firebase.js

@@ -4,19 +4,18 @@ import { getAuth } from 'firebase/auth';
 import { getFunctions } from 'firebase/functions';
 import { getDatabase } from 'firebase/database';
 import { getStorage } from 'firebase/storage';
-import { getAnalytics } from 'firebase/analytics';
-import { firebaseConfig } from './config.js';
+import { getAnalytics, isSupported as isAnalyticsSupported } from 'firebase/analytics';
+import { getPerformance } from 'firebase/performance';
+import { getMessaging, isSupported as isMessagingSupported } from 'firebase/messaging';
+import { getFirekitConfig } from './config.js';
 import { FirebaseServiceStatus, FirebaseServiceError } from './types/firebase.js';
 /**
- * Singleton service class that manages Firebase service instances.
- * Handles initialization and access to Firebase app and its various services.
+ * Singleton service that manages all Firebase service instances.
+ * Services are initialized lazily — they spin up only when first accessed.
  *
- * @example
- * // Get Firestore instance
- * const db = firebaseService.getDbInstance();
- *
- * // Get Auth instance
- * const auth = firebaseService.getAuthInstance();
+ * Core services (Firestore, Auth, Functions, RTDB, Storage) are always available.
+ * Browser-only services (Analytics, Performance, Messaging) check the environment.
+ * Security services (AppCheck, RemoteConfig) are initialized by their dedicated service files.
  */
 class FirebaseService {
     static instance;
@@ -27,46 +26,26 @@ class FirebaseService {
     database = null;
     storage = null;
     analytics = null;
+    appCheck = null;
+    remoteConfig = null;
+    performance = null;
+    messaging = null;
     status = FirebaseServiceStatus.UNINITIALIZED;
     initializationError = null;
     isBrowser = typeof window !== 'undefined';
-    /** @private */
     constructor() { }
-    /**
-     * Gets the singleton instance of FirebaseService.
-     * Creates a new instance if one doesn't exist.
-     *
-     * @returns {FirebaseService} The singleton FirebaseService instance
-     */
     static getInstance() {
         if (!FirebaseService.instance) {
             FirebaseService.instance = new FirebaseService();
         }
         return FirebaseService.instance;
     }
-    /**
-     * Gets the current status of the Firebase service
-     *
-     * @returns {FirebaseServiceStatus} The current service status
-     */
     getStatus() {
         return this.status;
     }
-    /**
-     * Gets the initialization error if any occurred
-     *
-     * @returns {Error | null} The initialization error or null if none occurred
-     */
     getInitializationError() {
         return this.initializationError;
     }
-    /**
-     * Initializes or retrieves the Firebase app instance.
-     * Also initializes Firestore if running in browser environment.
-     *
-     * @returns {FirebaseApp} The Firebase app instance
-     * @throws {FirebaseServiceError} If initialization fails
-     */
     getFirebaseApp() {
         if (this.status === FirebaseServiceStatus.ERROR) {
             throw new FirebaseServiceError('Firebase service is in error state', 'app');
@@ -76,13 +55,9 @@ class FirebaseService {
         try {
             this.status = FirebaseServiceStatus.INITIALIZING;
             const existingApps = getApps();
-            if (existingApps.length) {
-                this.firebaseApp = existingApps[0];
-            }
-            else {
-                this.firebaseApp = initializeApp(firebaseConfig);
-                console.log(`${firebaseConfig.projectId} initialized on ${this.isBrowser ? 'client' : 'server'}`);
-            }
+            this.firebaseApp = existingApps.length
+                ? existingApps[0]
+                : initializeApp(getFirekitConfig());
             this.initializeFirestoreInstance();
             this.status = FirebaseServiceStatus.INITIALIZED;
             return this.firebaseApp;
@@ -93,13 +68,6 @@ class FirebaseService {
             throw new FirebaseServiceError('Failed to initialize Firebase app', 'app');
         }
     }
-    /**
-     * Initializes Firestore with persistent cache and multi-tab support.
-     * Only runs in browser environment.
-     *
-     * @private
-     * @throws {FirebaseServiceError} If Firestore initialization fails
-     */
     initializeFirestoreInstance() {
         if (this.db || !this.isBrowser)
             return;
@@ -113,49 +81,23 @@ class FirebaseService {
             const indexManager = getPersistentCacheIndexManager(this.db);
             if (indexManager) {
                 enablePersistentCacheIndexAutoCreation(indexManager);
-                console.log('Firestore persistent cache indexing is enabled');
-            }
-            else {
-                console.warn('Failed to initialize the Firestore cache index manager');
             }
         }
         catch (error) {
             throw new FirebaseServiceError('Failed to initialize Firestore', 'firestore');
         }
     }
-    /**
-     * Gets the Firestore instance, initializing it if necessary.
-     *
-     * @returns {Firestore} The Firestore instance
-     * @throws {FirebaseServiceError} If Firestore is not available
-     */
     getDbInstance() {
         if (!this.db) {
-            try {
-                this.getFirebaseApp();
-                if (!this.db) {
-                    // If we're not in a browser environment, Firestore won't be available
-                    if (!this.isBrowser) {
-                        throw new FirebaseServiceError('Firestore is not available in server environment', 'firestore');
-                    }
-                    throw new FirebaseServiceError('Firestore instance not available', 'firestore');
-                }
-            }
-            catch (error) {
-                if (error instanceof FirebaseServiceError) {
-                    throw error;
-                }
-                throw new FirebaseServiceError('Failed to initialize Firestore', 'firestore');
+            this.getFirebaseApp();
+            if (!this.db) {
+                throw new FirebaseServiceError(this.isBrowser
+                    ? 'Firestore instance not available'
+                    : 'Firestore is not available in server environment', 'firestore');
             }
         }
         return this.db;
     }
-    /**
-     * Gets the Authentication instance, initializing it if necessary.
-     *
-     * @returns {Auth} The Authentication instance
-     * @throws {FirebaseServiceError} If Auth initialization fails
-     */
     getAuthInstance() {
         try {
             if (!this.auth) {
@@ -163,16 +105,10 @@ class FirebaseService {
             }
             return this.auth;
         }
-        catch (error) {
+        catch {
             throw new FirebaseServiceError('Failed to initialize Auth', 'auth');
         }
     }
-    /**
-     * Gets the Cloud Functions instance, initializing it if necessary.
-     *
-     * @returns {Functions} The Cloud Functions instance
-     * @throws {FirebaseServiceError} If Functions initialization fails
-     */
     getFunctionsInstance() {
         try {
             if (!this.functions) {
@@ -180,16 +116,10 @@ class FirebaseService {
             }
             return this.functions;
         }
-        catch (error) {
+        catch {
             throw new FirebaseServiceError('Failed to initialize Functions', 'functions');
         }
     }
-    /**
-     * Gets the Realtime Database instance, initializing it if necessary.
-     *
-     * @returns {Database} The Realtime Database instance
-     * @throws {FirebaseServiceError} If Database initialization fails
-     */
     getDatabaseInstance() {
         try {
             if (!this.database) {
@@ -197,16 +127,10 @@ class FirebaseService {
             }
             return this.database;
         }
-        catch (error) {
-            throw new FirebaseServiceError('Failed to initialize Database', 'database');
+        catch {
+            throw new FirebaseServiceError('Failed to initialize Realtime Database', 'database');
         }
     }
-    /**
-     * Gets the Storage instance, initializing it if necessary.
-     *
-     * @returns {FirebaseStorage} The Storage instance
-     * @throws {FirebaseServiceError} If Storage initialization fails
-     */
     getStorageInstance() {
         try {
             if (!this.storage) {
@@ -214,36 +138,62 @@ class FirebaseService {
             }
             return this.storage;
         }
-        catch (error) {
+        catch {
             throw new FirebaseServiceError('Failed to initialize Storage', 'storage');
         }
     }
     /**
-     * Gets the Analytics instance, initializing it if necessary.
-     * Only available in browser environment.
-     *
-     * @returns {Analytics} The Analytics instance
-     * @throws {FirebaseServiceError} If Analytics initialization fails
+     * Gets the Analytics instance. Returns null if analytics is not supported
+     * (e.g. no measurementId in config, ad-blockers, SSR).
      */
-    getAnalyticsInstance() {
-        if (!this.isBrowser) {
-            throw new FirebaseServiceError('Analytics is not available in server environment', 'analytics');
-        }
+    async getAnalyticsInstance() {
+        if (!this.isBrowser)
+            return null;
         try {
-            if (!this.analytics) {
+            if (!this.analytics && (await isAnalyticsSupported())) {
                 this.analytics = getAnalytics(this.getFirebaseApp());
             }
             return this.analytics;
         }
-        catch (error) {
-            throw new FirebaseServiceError('Failed to initialize Analytics', 'analytics');
+        catch {
+            return null;
         }
     }
     /**
-     * Resets the Firebase service to its initial state.
-     * Useful for testing or when you need to reinitialize the services.
-     *
-     * @returns {Promise<void>}
+     * Gets the Performance Monitoring instance. Browser-only.
+     */
+    getPerformanceInstance() {
+        if (!this.isBrowser)
+            return null;
+        try {
+            if (!this.performance) {
+                this.performance = getPerformance(this.getFirebaseApp());
+            }
+            return this.performance;
+        }
+        catch {
+            throw new FirebaseServiceError('Failed to initialize Performance Monitoring', 'performance');
+        }
+    }
+    /**
+     * Gets the Cloud Messaging instance. Returns null if not supported
+     * (requires HTTPS, service workers, and browser support).
+     */
+    async getMessagingInstance() {
+        if (!this.isBrowser)
+            return null;
+        try {
+            if (!this.messaging && (await isMessagingSupported())) {
+                this.messaging = getMessaging(this.getFirebaseApp());
+            }
+            return this.messaging;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Resets all service instances. Primarily useful for testing.
      */
     async reset() {
         this.firebaseApp = null;
@@ -253,21 +203,21 @@ class FirebaseService {
         this.database = null;
         this.storage = null;
         this.analytics = null;
+        this.appCheck = null;
+        this.remoteConfig = null;
+        this.performance = null;
+        this.messaging = null;
         this.status = FirebaseServiceStatus.UNINITIALIZED;
         this.initializationError = null;
     }
 }
 /**
- * Pre-initialized Firebase service instance.
- * Use this to access Firebase services directly.
+ * The global Firebase service singleton.
+ * Access Firebase service instances through this object.
  *
  * @example
- * import { firebaseService } from './firebase-service';
- *
- * // Get Firestore
+ * import { firebaseService } from 'svelte-firekit';
  * const db = firebaseService.getDbInstance();
- *
- * // Get Auth
  * const auth = firebaseService.getAuthInstance();
  */
 export const firebaseService = FirebaseService.getInstance();

package/dist/index.d.ts

@@ -1,24 +1,36 @@
-export * from './types/index.js';
-export { firebaseConfig } from './config.js';
+export { initFirekit, getFirekitConfig, isFirekitConfigured } from './config.js';
+export { getFirebaseAppContext, getAuthContext, getFirestoreContext, getStorageContext, getRTDBContext, getFunctionsContext, getAppCheckContext, getAnalyticsContext, getMessagingContext } from './context.js';
 export { firebaseService } from './firebase.js';
-export { firekitUser } from './services/user.svelte.js';
 export { firekitAuth } from './services/auth.js';
+export { firekitUser } from './services/user.svelte.js';
+export type { ExtendedUserData } from './services/user.svelte.js';
+export type { MFAEnrollmentResult, MFAChallengeResult } from './types/auth.js';
+export { firekitAppCheck } from './services/app-check.svelte.js';
+export { ReCaptchaV3Provider, ReCaptchaEnterpriseProvider, CustomProvider } from './services/app-check.svelte.js';
+export type { AppCheckOptions, AppCheckTokenResult } from './services/app-check.svelte.js';
+export { FirekitDoc, firekitDoc, firekitDocOnce, firekitDocWithMetadata, type FirekitDocOptions } from './services/document.svelte.js';
+export { FirekitCollection, FirekitCollectionGroup, FirekitQueryBuilder, firekitCollection, firekitCollectionOnce, firekitCollectionGroup, type FirekitCollectionOptions } from './services/collection.svelte.js';
+export { firekitMutations, type FirekitBatchOp, type FirekitBatchResult } from './services/mutations.js';
+export { FirekitGenerate, FirekitStream, FirekitChat, firekitGenerate, firekitStream, firekitChat, textPart, imagePart, imageUrlPart, GoogleAIBackend, VertexAIBackend, type FirekitAIOptions, type ChatMessage, type AIBackendType, type Part, type Content, type GenerationConfig, type SafetySetting } from './services/ai.svelte.js';
+export { FirekitNode, FirekitNodeList, firekitNode, firekitNodeList, rtdbServerTimestamp, rtdbIncrement } from './services/realtime.svelte.js';
+export { FirekitDownloadUrl, FirekitStorageList, FirekitUploadTask, firekitDownloadUrl, firekitStorageList, firekitUploadTask, deleteFile, getFileMetadata, updateFileMetadata, type UploadState, type SettableMetadata } from './services/storage.svelte.js';
+export { FirekitCallable, FirekitCallableFromURL, firekitCallable, firekitCallableFromURL } from './services/callable.js';
 export { firekitPresence } from './services/presence.svelte.js';
+export { FirekitRemoteConfig, firekitRemoteConfig, type FirekitRemoteConfigOptions } from './services/remote-config.svelte.js';
+export { firekitPerformance, type PerformanceTrace } from './services/performance.js';
+export { firekitMessaging, type MessagePayload } from './services/messaging.svelte.js';
 export { firekitAnalytics } from './services/analytics.js';
-export { firekitDoc, firekitDocOnce, firekitDocWithMetadata } from './services/document.svelte.js';
-export { firekitDocMutations } from './services/mutations.js';
-export { firekitCollection, firekitCollectionGroup, firekitCollectionOnce } from './services/collection.svelte.js';
-export { firekitRealtimeDB, firekitRealtimeList } from './services/realtime.svelte.js';
-export { firekitStorageList, firekitUploadTask, firekitDownloadUrl } from './services/storage.svelte.js';
-export { default as FirebaseApp } from './components/firekit/firebase-app.svelte';
-export { default as AuthGuard } from './components/firekit/auth-guard.svelte';
-export { default as CustomGuard } from './components/firekit/custom-guard.svelte';
-export { default as SignedIn } from './components/firekit/signed-in.svelte';
-export { default as SignedOut } from './components/firekit/signed-out.svelte';
-export { default as Doc } from './components/firekit/Doc.svelte';
-export { default as Collection } from './components/firekit/Collection.svelte';
-export { default as Node } from './components/firekit/Node.svelte';
-export { default as NodeList } from './components/firekit/node-list.svelte';
-export { default as StorageList } from './components/firekit/storage-list.svelte';
-export { default as DownloadURL } from './components/firekit/download-url.svelte';
-export { default as UploadTask } from './components/firekit/upload-task.svelte';
+export { firekitInAppMessaging } from './services/in-app-messaging.js';
+export { loadFirestoreBundle, getNamedQuery } from './services/bundles.js';
+export { default as FirebaseApp } from './components/FirebaseApp.svelte';
+export { default as SignedIn } from './components/SignedIn.svelte';
+export { default as SignedOut } from './components/SignedOut.svelte';
+export { default as AuthGuard } from './components/AuthGuard.svelte';
+export { default as CustomGuard } from './components/CustomGuard.svelte';
+export { default as Doc } from './components/Doc.svelte';
+export { default as Collection } from './components/Collection.svelte';
+export { default as Node } from './components/Node.svelte';
+export { default as DownloadURL } from './components/DownloadURL.svelte';
+export { default as UploadTask } from './components/UploadTask.svelte';
+export * from './types/index.js';
+export * from './utils/index.js';

package/dist/index.js

@@ -1,34 +1,53 @@
-// types
-export * from './types/index.js';
-// Firebase config
-export { firebaseConfig } from './config.js';
+// ─── Configuration ───────────────────────────────────────────────────────────
+export { initFirekit, getFirekitConfig, isFirekitConfigured } from './config.js';
+// ─── Context helpers ──────────────────────────────────────────────────────────
+export { getFirebaseAppContext, getAuthContext, getFirestoreContext, getStorageContext, getRTDBContext, getFunctionsContext, getAppCheckContext, getAnalyticsContext, getMessagingContext } from './context.js';
+// ─── Firebase service singleton ──────────────────────────────────────────────
 export { firebaseService } from './firebase.js';
-// auth services
-export { firekitUser } from './services/user.svelte.js';
+// ─── Auth & User services ────────────────────────────────────────────────────
 export { firekitAuth } from './services/auth.js';
+export { firekitUser } from './services/user.svelte.js';
+// ─── App Check ───────────────────────────────────────────────────────────────
+export { firekitAppCheck } from './services/app-check.svelte.js';
+export { ReCaptchaV3Provider, ReCaptchaEnterpriseProvider, CustomProvider } from './services/app-check.svelte.js';
+// ─── Firestore ────────────────────────────────────────────────────────────────
+export { FirekitDoc, firekitDoc, firekitDocOnce, firekitDocWithMetadata } from './services/document.svelte.js';
+export { FirekitCollection, FirekitCollectionGroup, FirekitQueryBuilder, firekitCollection, firekitCollectionOnce, firekitCollectionGroup } from './services/collection.svelte.js';
+export { firekitMutations } from './services/mutations.js';
+// ─── Firebase AI ──────────────────────────────────────────────────────────────
+export { FirekitGenerate, FirekitStream, FirekitChat, firekitGenerate, firekitStream, firekitChat, textPart, imagePart, imageUrlPart, GoogleAIBackend, VertexAIBackend } from './services/ai.svelte.js';
+// ─── Realtime Database ────────────────────────────────────────────────────────
+export { FirekitNode, FirekitNodeList, firekitNode, firekitNodeList, rtdbServerTimestamp, rtdbIncrement } from './services/realtime.svelte.js';
+// ─── Storage ──────────────────────────────────────────────────────────────────
+export { FirekitDownloadUrl, FirekitStorageList, FirekitUploadTask, firekitDownloadUrl, firekitStorageList, firekitUploadTask, deleteFile, getFileMetadata, updateFileMetadata } from './services/storage.svelte.js';
+// ─── Cloud Functions ──────────────────────────────────────────────────────────
+export { FirekitCallable, FirekitCallableFromURL, firekitCallable, firekitCallableFromURL } from './services/callable.js';
+// ─── Presence ─────────────────────────────────────────────────────────────────
 export { firekitPresence } from './services/presence.svelte.js';
-// analytics services
+// ─── Remote Config ────────────────────────────────────────────────────────────
+export { FirekitRemoteConfig, firekitRemoteConfig } from './services/remote-config.svelte.js';
+// ─── Performance ──────────────────────────────────────────────────────────────
+export { firekitPerformance } from './services/performance.js';
+// ─── Messaging ────────────────────────────────────────────────────────────────
+export { firekitMessaging } from './services/messaging.svelte.js';
+// ─── Analytics ────────────────────────────────────────────────────────────────
 export { firekitAnalytics } from './services/analytics.js';
-// document services
-export { firekitDoc, firekitDocOnce, firekitDocWithMetadata } from './services/document.svelte.js';
-// mutations services
-export { firekitDocMutations } from './services/mutations.js';
-// collection services
-export { firekitCollection, firekitCollectionGroup, firekitCollectionOnce } from './services/collection.svelte.js';
-// realtime services
-export { firekitRealtimeDB, firekitRealtimeList } from './services/realtime.svelte.js';
-// storage services
-export { firekitStorageList, firekitUploadTask, firekitDownloadUrl } from './services/storage.svelte.js';
-// Components
-export { default as FirebaseApp } from './components/firekit/firebase-app.svelte';
-export { default as AuthGuard } from './components/firekit/auth-guard.svelte';
-export { default as CustomGuard } from './components/firekit/custom-guard.svelte';
-export { default as SignedIn } from './components/firekit/signed-in.svelte';
-export { default as SignedOut } from './components/firekit/signed-out.svelte';
-export { default as Doc } from './components/firekit/Doc.svelte';
-export { default as Collection } from './components/firekit/Collection.svelte';
-export { default as Node } from './components/firekit/Node.svelte';
-export { default as NodeList } from './components/firekit/node-list.svelte';
-export { default as StorageList } from './components/firekit/storage-list.svelte';
-export { default as DownloadURL } from './components/firekit/download-url.svelte';
-export { default as UploadTask } from './components/firekit/upload-task.svelte';
+// ─── In-App Messaging ─────────────────────────────────────────────────────────
+export { firekitInAppMessaging } from './services/in-app-messaging.js';
+// ─── Firestore bundles ────────────────────────────────────────────────────────
+export { loadFirestoreBundle, getNamedQuery } from './services/bundles.js';
+// ─── Components ──────────────────────────────────────────────────────────────
+export { default as FirebaseApp } from './components/FirebaseApp.svelte';
+export { default as SignedIn } from './components/SignedIn.svelte';
+export { default as SignedOut } from './components/SignedOut.svelte';
+export { default as AuthGuard } from './components/AuthGuard.svelte';
+export { default as CustomGuard } from './components/CustomGuard.svelte';
+export { default as Doc } from './components/Doc.svelte';
+export { default as Collection } from './components/Collection.svelte';
+export { default as Node } from './components/Node.svelte';
+export { default as DownloadURL } from './components/DownloadURL.svelte';
+export { default as UploadTask } from './components/UploadTask.svelte';
+// ─── Types ───────────────────────────────────────────────────────────────────
+export * from './types/index.js';
+// ─── Utilities ───────────────────────────────────────────────────────────────
+export * from './utils/index.js';

package/dist/services/ai.svelte.d.ts

@@ -0,0 +1,152 @@
+import { GoogleAIBackend, VertexAIBackend, type Part, type Content, type GenerateContentRequest, type GenerationConfig, type SafetySetting } from 'firebase/ai';
+/** Available backend types for Firebase AI. */
+export type AIBackendType = 'googleai' | 'vertexai';
+/** Builds a text Part. */
+export declare function textPart(text: string): Part;
+/** Builds an inline image Part from a base64 data URL or raw base64 string. */
+export declare function imagePart(base64: string, mimeType?: string): Part;
+/** Builds an image Part from a publicly accessible URL. */
+export declare function imageUrlPart(url: string, mimeType?: string): Part;
+export interface FirekitAIOptions {
+    /** Firebase AI backend. Default: 'googleai' */
+    backend?: AIBackendType;
+    /** Gemini model name. Default: 'gemini-2.0-flash' */
+    model?: string;
+    generationConfig?: GenerationConfig;
+    safetySettings?: SafetySetting[];
+    systemInstruction?: string | Part | Content;
+}
+export interface ChatMessage {
+    role: 'user' | 'model';
+    parts: Part[];
+    text: string;
+}
+/**
+ * Reactive one-shot AI generation.
+ *
+ * Calls `generateContent` and exposes reactive state. Re-call `generate()`
+ * to produce new results.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { firekitGenerate } from 'svelte-firekit';
+ *   const gen = firekitGenerate({ model: 'gemini-2.0-flash' });
+ *   gen.generate('Summarize the following: ...');
+ * </script>
+ * {#if gen.loading}<p>Thinking…</p>{/if}
+ * {#if gen.text}<p>{gen.text}</p>{/if}
+ * ```
+ */
+export declare class FirekitGenerate {
+    private _text;
+    private _loading;
+    private _error;
+    readonly hasResult: boolean;
+    private _model;
+    constructor(options?: FirekitAIOptions);
+    get text(): string | null;
+    get loading(): boolean;
+    get error(): Error | null;
+    /**
+     * Generates a response for the given prompt (text or multi-part content).
+     * Returns the generated text, or null on error.
+     */
+    generate(prompt: string | Part | Part[] | GenerateContentRequest): Promise<string | null>;
+    /** Resets result and error state. */
+    reset(): void;
+}
+/**
+ * Reactive streaming AI generation.
+ *
+ * Streams tokens into `text` as they arrive from the model.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { firekitStream } from 'svelte-firekit';
+ *   const gen = firekitStream({ model: 'gemini-2.0-flash' });
+ *   gen.generate('Write a poem about Svelte.');
+ * </script>
+ * {#if gen.streaming}<span class="cursor">▍</span>{/if}
+ * <p>{gen.text}</p>
+ * ```
+ */
+export declare class FirekitStream {
+    private _text;
+    private _streaming;
+    private _loading;
+    private _error;
+    readonly done: boolean;
+    private _model;
+    constructor(options?: FirekitAIOptions);
+    get text(): string;
+    get streaming(): boolean;
+    get loading(): boolean;
+    get error(): Error | null;
+    /**
+     * Streams a response for the given prompt.
+     * Resolves with the full text once streaming completes.
+     */
+    generate(prompt: string | Part | Part[] | GenerateContentRequest): Promise<string>;
+    /** Resets accumulated text and error. */
+    reset(): void;
+}
+/**
+ * Reactive multi-turn chat session.
+ *
+ * Maintains conversation history and exposes reactive state for each
+ * assistant turn (supports both streaming and non-streaming).
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   import { firekitChat } from 'svelte-firekit';
+ *   const chat = firekitChat({ model: 'gemini-2.0-flash' });
+ *   await chat.send('Hello!');
+ * </script>
+ * {#each chat.history as msg}
+ *   <div class={msg.role}>{msg.text}</div>
+ * {/each}
+ * {#if chat.streaming}<span>▍</span>{/if}
+ * ```
+ */
+export declare class FirekitChat {
+    private _history;
+    private _pendingText;
+    private _loading;
+    private _streaming;
+    private _error;
+    readonly lastMessage: ChatMessage | null;
+    readonly isEmpty: boolean;
+    private _session;
+    constructor(options?: FirekitAIOptions, initialHistory?: Content[]);
+    get history(): ChatMessage[];
+    get pendingText(): string;
+    get loading(): boolean;
+    get streaming(): boolean;
+    get error(): Error | null;
+    /**
+     * Sends a message and returns the model's response text.
+     * Uses streaming by default for a responsive UI.
+     */
+    send(message: string | Part[], { stream }?: {
+        stream?: boolean;
+    }): Promise<string>;
+    /** Clears the conversation history and starts a fresh session. */
+    clear(): void;
+}
+/**
+ * Creates a reactive one-shot AI text generator.
+ */
+export declare function firekitGenerate(options?: FirekitAIOptions): FirekitGenerate;
+/**
+ * Creates a reactive streaming AI text generator.
+ */
+export declare function firekitStream(options?: FirekitAIOptions): FirekitStream;
+/**
+ * Creates a reactive multi-turn AI chat session.
+ */
+export declare function firekitChat(options?: FirekitAIOptions, initialHistory?: Content[]): FirekitChat;
+export { GoogleAIBackend, VertexAIBackend };
+export type { Part, Content, GenerationConfig, SafetySetting };