@zuzjs/flare-admin 0.1.5 → 0.1.7

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+type AdminConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting' | 'error';
+type AdminConnectionStateListener = (state: AdminConnectionState) => void;
 interface FlareAdminConfig {
     /**
      * Base URL of your FlareServer instance.
@@ -16,6 +18,8 @@ interface FlareAdminConfig {
     grpcUrl?: string;
     /** Transport preference for supported operations. */
     transport?: "auto" | "http" | "grpc";
+    /** Optional HTTP base URL override for admin HTTP APIs. */
+    httpBase?: string;
     /** Default token TTL, e.g. "24h" */
     defaultTtl?: string;
     /**
@@ -502,11 +506,46 @@ interface StructuredQuery {
     select?: string[];
     distinctField?: string;
 }
+type AdminBulkWriteOperation = "addMany" | "updateMany" | "deleteMany";
+interface AdminBulkWriteProgress {
+    operation: AdminBulkWriteOperation;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    total?: number;
+    percent?: number;
+    lastDocId?: string;
+    lastError?: unknown;
+}
+interface AdminBulkWriteResult {
+    operation: AdminBulkWriteOperation;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    total?: number;
+}
+interface AdminBulkWriteOptions {
+    /** How many operations to execute per chunk; defaults to 250. */
+    batchSize?: number;
+    /** Number of in-flight writes within each chunk; defaults to 1. */
+    concurrency?: number;
+    /** Continue processing remaining items after individual failures. */
+    continueOnError?: boolean;
+    /** Optional cancellation signal for long-running bulk writes. */
+    signal?: AbortSignal;
+    /** Progress callback invoked after each processed item. */
+    onProgress?: (progress: AdminBulkWriteProgress) => void;
+}
+interface AdminUpdateManyItem<T = Record<string, unknown>> {
+    id: string;
+    data: Partial<T>;
+}
 /** Minimal structural interface satisfied by AdminCollectionReference<T>. */
 interface FlareAdminDb {
     collection<T = Record<string, unknown>>(name: string): AdminCollectionShape<T>;
 }
 interface AdminDocumentShape<T> {
+    readonly id: string;
     get(): Promise<T | null>;
     set(data: Partial<T>): Promise<void>;
     update(data: Partial<T>): Promise<void>;
@@ -581,6 +620,9 @@ interface AdminCollectionShape<T> {
     first(): Promise<T | null>;
     last(): Promise<T | null>;
     add(data: Partial<T>): Promise<AdminDocumentShape<T>>;
+    addMany(items: Iterable<Partial<T>> | AsyncIterable<Partial<T>>, options?: AdminBulkWriteOptions): Promise<AdminBulkWriteResult>;
+    updateMany(items: Iterable<AdminUpdateManyItem<T>> | AsyncIterable<AdminUpdateManyItem<T>>, options?: AdminBulkWriteOptions): Promise<AdminBulkWriteResult>;
+    deleteMany(docIds: Iterable<string> | AsyncIterable<string>, options?: AdminBulkWriteOptions): Promise<AdminBulkWriteResult>;
     deleteMany(): Promise<number>;
     doc(id: string): AdminDocumentShape<T>;
 }
@@ -597,6 +639,39 @@ type AdminDocAddedCallback<T = unknown> = (data: T, docId: string) => void;
 type AdminDocUpdatedCallback<T = unknown> = (data: T, docId: string) => void;
 type AdminDocDeletedCallback = (docId: string) => void;
 type AdminDocChangedCallback<T = unknown> = (data: T | null, docId: string, operation: "insert" | "update" | "delete" | "replace") => void;
+type AdminStreamFlushReason = "snapshot" | "change-batch";
+interface AdminCollectionStreamOptions<T = unknown> {
+    flushMs?: number;
+    maxBatchSize?: number;
+    idField?: keyof T & string;
+    getId?: (doc: T) => string | undefined;
+    insertAt?: "start" | "end";
+    maxDocs?: number;
+    sort?: (a: T, b: T) => number;
+}
+interface AdminCollectionStreamMeta {
+    reason: AdminStreamFlushReason;
+    batchSize: number;
+    version: number;
+    ready: boolean;
+}
+type AdminCollectionStreamListener<T = unknown> = (rows: readonly T[], meta: AdminCollectionStreamMeta) => void;
+interface AdminCollectionStream<T = unknown> {
+    subscribe: (listener: AdminCollectionStreamListener<T>, emitCurrent?: boolean) => () => void;
+    getSnapshot: () => readonly T[];
+    isReady: () => boolean;
+    getVersion: () => number;
+    close: () => void;
+    onError: (callback: AdminSubscriptionErrorCallback) => AdminCollectionStream<T>;
+    onPermissionDenied: (callback: AdminSubscriptionErrorCallback) => AdminCollectionStream<T>;
+}
+interface AdminCollectionExternalStore<T = unknown> {
+    subscribe: (onStoreChange: () => void) => () => void;
+    getSnapshot: () => readonly T[];
+    getServerSnapshot: () => readonly T[];
+    stream: AdminCollectionStream<T>;
+    destroy: () => void;
+}
 interface AdminSubscribeOptions {
     skipSnapshot?: boolean;
 }
@@ -727,8 +802,34 @@ declare class AdminCollectionReference<T = Record<string, unknown>> {
     get(): Promise<T[]>;
     first(): Promise<T | null>;
     last(): Promise<T | null>;
+    /**
+     * Create a single document and return its reference.
+     */
     add(data: Partial<T>): Promise<AdminDocumentReference<T>>;
+    private ensureBulkOptions;
+    private toPercent;
+    private emitBulkProgress;
+    private chunkIterable;
+    private assertBulkSignal;
+    private runChunkWorkers;
+    private runBulkWrite;
+    /**
+     * Create many documents with bounded memory and optional progress reporting.
+     */
+    addMany(items: Iterable<Partial<T>> | AsyncIterable<Partial<T>>, options?: AdminBulkWriteOptions): Promise<AdminBulkWriteResult>;
+    /**
+     * Update many documents by id with bounded memory and optional progress reporting.
+     */
+    updateMany(items: Iterable<AdminUpdateManyItem<T>> | AsyncIterable<AdminUpdateManyItem<T>>, options?: AdminBulkWriteOptions): Promise<AdminBulkWriteResult>;
+    /**
+     * Delete many specific document ids with bounded memory and optional progress reporting.
+     */
     deleteMany(): Promise<number>;
+    deleteMany(docIds: Iterable<string> | AsyncIterable<string>, options?: AdminBulkWriteOptions): Promise<AdminBulkWriteResult>;
+    private deleteManyByQuery;
+    /**
+     * Return a document reference by id.
+     */
     doc(id: string): AdminDocumentReference<T>;
 }
 
@@ -987,6 +1088,8 @@ declare class AdminLiveCollectionReference<T = Record<string, unknown>> {
         query: StructuredQuery;
     };
     onSnapshot(callback: AdminSnapshotCallback<T[]>): () => void;
+    stream(options?: AdminCollectionStreamOptions<T>): AdminCollectionStream<T>;
+    asStore(options?: AdminCollectionStreamOptions<T>): AdminCollectionExternalStore<T>;
     onDocAdded(callback: AdminDocAddedCallback<T>): () => void;
     onDocUpdated(callback: AdminDocUpdatedCallback<T>): () => void;
     onDocDeleted(callback: AdminDocDeletedCallback): () => void;
@@ -1023,6 +1126,19 @@ declare class FlareAdminConnection {
     collection<T = Record<string, unknown>>(name: string): AdminLiveCollectionReference<T>;
     /** Wait until the WebSocket is open and authenticated. */
     ready(): Promise<void>;
+    /** Current connection state. */
+    get connectionState(): AdminConnectionState;
+    /**
+     * Subscribe to connection state changes.
+     * Returns an unsubscribe function.
+     *
+     * @example
+     *   const unsub = admin.live().onConnectionStateChange((state) => {
+     *     console.log("connection:", state);
+     *   });
+     *   // state: 'connecting' | 'connected' | 'disconnected' | 'reconnecting' | 'error'
+     */
+    onConnectionStateChange(listener: AdminConnectionStateListener): () => void;
     /** Close the WebSocket connection permanently (no reconnect). */
     disconnect(): void;
 }
@@ -1044,12 +1160,21 @@ declare class FlareAdminWsConnection {
     private connected;
     private shouldReconnect;
     private reconnectDelay;
+    private _state;
+    private _stateListeners;
     private readonly wsUrl;
     private _readyResolve;
     private _readyPromise;
     constructor(cfg: Required<FlareAdminConfig>);
     /** Resolves once the WS is open and AUTH_OK is received from the server. */
     ready(): Promise<void>;
+    /** Current connection state. */
+    get connectionState(): AdminConnectionState;
+    /**
+     * Subscribe to connection state changes.
+     * Returns an unsubscribe function.
+     */
+    onConnectionStateChange(listener: AdminConnectionStateListener): () => void;
     /** Close the connection permanently (no reconnect). */
     disconnect(): void;
     /**
@@ -1066,6 +1191,7 @@ declare class FlareAdminWsConnection {
     private replayActiveSubscriptions;
     private toSubscriptionError;
     private emitSubscriptionError;
+    private _setState;
     private _connect;
     private _handle;
 }
@@ -1084,48 +1210,6 @@ declare const ServerTimeStampField: {
     readonly $serverTimestamp: true;
 };
 
-/**
- * @zuzjs/flare-admin
- *
- * Server-side admin SDK for FlareServer.
- * Runs only on your backend, never in a browser.
- *
- * ─── Quick start ──────────────────────────────────────────────────────────────
- *
- *   import { connectApp } from "@zuzjs/flare-admin";
- *
- *   const admin = connectApp({
- *     serverUrl: process.env.FLARE_URL!,
- *     appId:     process.env.FLARE_APP_ID!,
- *     adminKey:  process.env.FLARE_ADMIN_KEY!,
- *   });
- *
- *   // Mint a custom auth token (for use by the browser client)
- *   const token = await admin.auth().createCustomToken(String(user.id), {
- *     role:   user.isAdmin ? "admin" : "user",
- *     claims: { email: user.email, plan: user.plan },
- *   });
- *
- *   // One-shot DB queries (bypasses security rules)
- *   const users = await admin.db().collection("users").get();
- *   await admin.db().collection("users").doc("alice").set({ name: "Alice" });
- *
- *   // Rich queries
- *   const seniors = await admin.db()
- *     .collection("users")
- *     .where({ age: ">= 60" })
- *     .orderBy("name")
- *     .limit(10)
- *     .get();
- *
- *   // Real-time subscriptions over WebSocket
- *   const unsub = admin.connection()
- *     .collection("orders")
- *     .where({ status: "pending" })
- *     .orderBy("createdAt", "desc")
- *     .onSnapshot((snap) => console.log(snap));
- */
-
 /**
  * A FlareAdmin application instance.
  * Create one with `connectApp()` and keep it as a module-level singleton.
@@ -1172,7 +1256,7 @@ declare class FlareAdminApp {
     * `groupBy`, `having`, `Join`, `select`, `distinctField`, `vectorSearch`.
      *
      * @example
-     *   const unsub = admin.connection()
+     *   const unsub = admin.live()
      *     .collection("orders")
      *     .where({ status: "pending" })
      *     .orderBy("createdAt", "desc")
@@ -1182,15 +1266,15 @@ declare class FlareAdminApp {
      *       else console.log(snap.operation, snap.data);
      *     });
      *
-     *   const unsub2 = admin.connection()
+     *   const unsub2 = admin.live()
      *     .collection("users").doc("alice")
      *     .onSnapshot((snap) => console.log(snap.data));
      *
      *   unsub();
      *   unsub2();
-     *   admin.connection().disconnect();
+     *   admin.live().disconnect();
      */
-    connection(): FlareAdminConnection;
+    live(): FlareAdminConnection;
     /**
      * Access push notification management APIs.
      */
@@ -1243,6 +1327,25 @@ declare class FlareAdminApp {
         deleted: string[];
         errors: Record<string, string>;
     }>;
+    /**
+     * Subscribe to WebSocket connection state changes.
+     * Initializes the live connection if not already open.
+     * Returns an unsubscribe function.
+     *
+     * @example
+     *   const unsub = admin.onConnectionStateChange((state) => {
+     *     console.log("connection:", state);
+     *     // state: 'connecting' | 'connected' | 'disconnected' | 'reconnecting' | 'error'
+     *   });
+     *   // Later:
+     *   unsub();
+     */
+    onConnectionStateChange(listener: (state: AdminConnectionState) => void): () => void;
+    /**
+     * Disconnect realtime resources tied to this app instance.
+     * Safe to call multiple times.
+     */
+    disconnect(): void;
 }
 /**
  * Initialize a FlareAdmin app instance.
@@ -1264,6 +1367,15 @@ declare function connectApp(config: FlareAdminConfig, name?: string): FlareAdmin
  * @throws If the app has not been initialized yet.
  */
 declare function getApp(name?: string): FlareAdminApp;
+/**
+ * Disconnect and remove an initialized app by name.
+ * Returns true when an app existed and was removed.
+ */
+declare function disconnectApp(name?: string): boolean;
+/**
+ * Disconnect and clear all initialized apps.
+ */
+declare function disconnectAllApps(): void;
 /**
  * Get the auth service from the default app.
  * Equivalent to `getApp().auth()`.
@@ -1284,15 +1396,15 @@ declare function auth(name?: string): FlareAdminAuth;
 declare function db(name?: string): FlareAdminDb;
 /**
  * Get the real-time WebSocket connection from the default app.
- * Equivalent to `getApp().connection()`.
+ * Equivalent to `getApp().live()`.
  *
  * @example
- *   import { connection } from "@zuzjs/flare-admin";
- *   const unsub = connection().collection("users")
+ *   import { live } from "@zuzjs/flare-admin";
+ *   const unsub = live().collection("users")
  *     .where({ role: "admin" })
  *     .onSnapshot((snap) => console.log(snap));
  */
-declare function connection(name?: string): FlareAdminConnection;
+declare function live(name?: string): FlareAdminConnection;
 /**
  * Get the notifications service from the default app.
  * Equivalent to `getApp().notifications()`.
@@ -1300,4 +1412,4 @@ declare function connection(name?: string): FlareAdminConnection;
 declare function notifications(name?: string): FlareAdminNotifications;
 declare function storage(name?: string): FlareAdminStorageS3;
 
-export { AdminCollectionReference, type AdminCopyObjectInput, type AdminDeleteObjectsInput, type AdminDocAddedCallback, type AdminDocChangedCallback, type AdminDocDeletedCallback, type AdminDocUpdatedCallback, AdminDocumentReference, type AdminDownloadObjectInput, type AdminDownloadObjectResult, type AdminGetObjectInput, type AdminGetObjectResult, type AdminGetObjectUrlInput, type AdminHeadObjectInput, type AdminHeadObjectsInput, type AdminListObjectsInput, type AdminListObjectsResult, AdminLiveCollectionReference, AdminLiveDocumentReference, type AdminPushSendInput, type AdminPushSendResult, type AdminPushToken, type AdminPutObjectInput, type AdminPutObjectResult, type AdminSnapshotCallback, type AdminSnapshotData, type AdminStorageAwsConfig, type AdminStorageBucket, type AdminStorageBucketInput, type AdminStorageDeleteInput, type AdminStorageDownloadInput, type AdminStorageObjectMeta, type AdminStorageObjectResult, type AdminStorageRulesHistoryResult, type AdminStorageRulesPolicy, type AdminStorageServer, type AdminStorageServerInput, type AdminStorageServerPatchInput, AdminStorageSignedAction, type AdminStorageSignedUrlInput, type AdminStorageSignedUrlResult, type AdminStorageUploadInput, type AdminSubscriptionError, type AdminSubscriptionErrorCallback, type AdminSubscriptionHandle, type AggregateFunction, type AggregateSpec, type AnyFilter, type CreateCustomTokenOptions, type CursorValue, FlareAdminApp, type FlareAdminAuth, FlareAdminAuthService, type FlareAdminConfig, FlareAdminConnection, type FlareAdminDb, FlareAdminDbService, type FlareAdminNotifications, FlareAdminNotificationsService, type FlareAdminStorage, FlareAdminStorageS3, FlareAdminWsConnection, type GroupByClause, type HavingClause, type JoinClause, type OrFilter, type OrderByClause, type QueryOperator, ServerTimeStamp, ServerTimeStampField, type StructuredQuery, type VectorSearchClause, type WhereCondition, type WhereFilter, auth, connectApp, connection, db, getApp, notifications, storage };
+export { type AdminBulkWriteOperation, type AdminBulkWriteOptions, type AdminBulkWriteProgress, type AdminBulkWriteResult, AdminCollectionReference, type AdminConnectionState, type AdminConnectionStateListener, type AdminCopyObjectInput, type AdminDeleteObjectsInput, type AdminDocAddedCallback, type AdminDocChangedCallback, type AdminDocDeletedCallback, type AdminDocUpdatedCallback, AdminDocumentReference, type AdminDownloadObjectInput, type AdminDownloadObjectResult, type AdminGetObjectInput, type AdminGetObjectResult, type AdminGetObjectUrlInput, type AdminHeadObjectInput, type AdminHeadObjectsInput, type AdminListObjectsInput, type AdminListObjectsResult, AdminLiveCollectionReference, AdminLiveDocumentReference, type AdminPushSendInput, type AdminPushSendResult, type AdminPushToken, type AdminPutObjectInput, type AdminPutObjectResult, type AdminSnapshotCallback, type AdminSnapshotData, type AdminStorageAwsConfig, type AdminStorageBucket, type AdminStorageBucketInput, type AdminStorageDeleteInput, type AdminStorageDownloadInput, type AdminStorageObjectMeta, type AdminStorageObjectResult, type AdminStorageRulesHistoryResult, type AdminStorageRulesPolicy, type AdminStorageServer, type AdminStorageServerInput, type AdminStorageServerPatchInput, AdminStorageSignedAction, type AdminStorageSignedUrlInput, type AdminStorageSignedUrlResult, type AdminStorageUploadInput, type AdminSubscriptionError, type AdminSubscriptionErrorCallback, type AdminSubscriptionHandle, type AdminUpdateManyItem, type AggregateFunction, type AggregateSpec, type AnyFilter, type CreateCustomTokenOptions, type CursorValue, FlareAdminApp, type FlareAdminAuth, FlareAdminAuthService, type FlareAdminConfig, FlareAdminConnection, type FlareAdminDb, FlareAdminDbService, type FlareAdminNotifications, FlareAdminNotificationsService, type FlareAdminStorage, FlareAdminStorageS3, FlareAdminWsConnection, type GroupByClause, type HavingClause, type JoinClause, type OrFilter, type OrderByClause, type QueryOperator, ServerTimeStamp, ServerTimeStampField, type StructuredQuery, type VectorSearchClause, type WhereCondition, type WhereFilter, auth, connectApp, db, disconnectAllApps, disconnectApp, getApp, live, notifications, storage };

package/dist/index.d.ts

@@ -33,14 +33,14 @@
  *     .get();
  *
  *   // Real-time subscriptions over WebSocket
- *   const unsub = admin.connection()
+ *   const unsub = admin.live()
  *     .collection("orders")
  *     .where({ status: "pending" })
  *     .orderBy("createdAt", "desc")
  *     .onSnapshot((snap) => console.log(snap));
  */
 export { AdminStorageSignedAction } from "./types";
-export type { AdminCopyObjectInput, AdminDeleteObjectsInput, AdminDocAddedCallback, AdminDocChangedCallback, AdminDocDeletedCallback, AdminDocUpdatedCallback, AdminDownloadObjectInput, AdminDownloadObjectResult, AdminGetObjectInput, AdminGetObjectResult, AdminGetObjectUrlInput, AdminHeadObjectInput, AdminHeadObjectsInput, AdminListObjectsInput, AdminListObjectsResult, AdminPushSendInput, AdminPushSendResult, AdminPushToken, AdminPutObjectInput, AdminPutObjectResult, AdminSnapshotCallback, AdminSnapshotData, AdminStorageAwsConfig, AdminStorageBucket, AdminStorageBucketInput, AdminStorageDeleteInput, AdminStorageDownloadInput, AdminStorageObjectMeta, AdminStorageObjectResult, AdminStorageRulesHistoryResult, AdminStorageRulesPolicy, AdminStorageServer, AdminStorageServerInput, AdminStorageServerPatchInput, AdminStorageSignedUrlInput, AdminStorageSignedUrlResult, AdminStorageUploadInput, AdminSubscriptionError, AdminSubscriptionErrorCallback, AdminSubscriptionHandle, AggregateFunction, AggregateSpec, AnyFilter, CreateCustomTokenOptions, CursorValue, FlareAdminAuth, FlareAdminConfig, FlareAdminDb, FlareAdminNotifications, FlareAdminStorage, GroupByClause, HavingClause, JoinClause, OrderByClause, OrFilter, QueryOperator, StructuredQuery, VectorSearchClause, WhereCondition, WhereFilter } from "./types";
+export type { AdminBulkWriteOperation, AdminBulkWriteOptions, AdminBulkWriteProgress, AdminBulkWriteResult, AdminConnectionState, AdminConnectionStateListener, AdminCopyObjectInput, AdminDeleteObjectsInput, AdminDocAddedCallback, AdminDocChangedCallback, AdminDocDeletedCallback, AdminDocUpdatedCallback, AdminDownloadObjectInput, AdminDownloadObjectResult, AdminGetObjectInput, AdminGetObjectResult, AdminGetObjectUrlInput, AdminHeadObjectInput, AdminHeadObjectsInput, AdminListObjectsInput, AdminListObjectsResult, AdminPushSendInput, AdminPushSendResult, AdminPushToken, AdminPutObjectInput, AdminPutObjectResult, AdminSnapshotCallback, AdminSnapshotData, AdminStorageAwsConfig, AdminStorageBucket, AdminStorageBucketInput, AdminStorageDeleteInput, AdminStorageDownloadInput, AdminStorageObjectMeta, AdminStorageObjectResult, AdminStorageRulesHistoryResult, AdminStorageRulesPolicy, AdminStorageServer, AdminStorageServerInput, AdminStorageServerPatchInput, AdminStorageSignedUrlInput, AdminStorageSignedUrlResult, AdminStorageUploadInput, AdminSubscriptionError, AdminSubscriptionErrorCallback, AdminSubscriptionHandle, AdminUpdateManyItem, AggregateFunction, AggregateSpec, AnyFilter, CreateCustomTokenOptions, CursorValue, FlareAdminAuth, FlareAdminConfig, FlareAdminDb, FlareAdminNotifications, FlareAdminStorage, GroupByClause, HavingClause, JoinClause, OrderByClause, OrFilter, QueryOperator, StructuredQuery, VectorSearchClause, WhereCondition, WhereFilter } from "./types";
 export { AdminCollectionReference } from "./db/Collection";
 export { AdminDocumentReference } from "./db/Document";
 export { FlareAdminDbService } from "./db/index";
@@ -100,7 +100,7 @@ export declare class FlareAdminApp {
     * `groupBy`, `having`, `Join`, `select`, `distinctField`, `vectorSearch`.
      *
      * @example
-     *   const unsub = admin.connection()
+     *   const unsub = admin.live()
      *     .collection("orders")
      *     .where({ status: "pending" })
      *     .orderBy("createdAt", "desc")
@@ -110,15 +110,15 @@ export declare class FlareAdminApp {
      *       else console.log(snap.operation, snap.data);
      *     });
      *
-     *   const unsub2 = admin.connection()
+     *   const unsub2 = admin.live()
      *     .collection("users").doc("alice")
      *     .onSnapshot((snap) => console.log(snap.data));
      *
      *   unsub();
      *   unsub2();
-     *   admin.connection().disconnect();
+     *   admin.live().disconnect();
      */
-    connection(): FlareAdminConnection;
+    live(): FlareAdminConnection;
     /**
      * Access push notification management APIs.
      */
@@ -171,6 +171,25 @@ export declare class FlareAdminApp {
         deleted: string[];
         errors: Record<string, string>;
     }>;
+    /**
+     * Subscribe to WebSocket connection state changes.
+     * Initializes the live connection if not already open.
+     * Returns an unsubscribe function.
+     *
+     * @example
+     *   const unsub = admin.onConnectionStateChange((state) => {
+     *     console.log("connection:", state);
+     *     // state: 'connecting' | 'connected' | 'disconnected' | 'reconnecting' | 'error'
+     *   });
+     *   // Later:
+     *   unsub();
+     */
+    onConnectionStateChange(listener: (state: import("./types").AdminConnectionState) => void): () => void;
+    /**
+     * Disconnect realtime resources tied to this app instance.
+     * Safe to call multiple times.
+     */
+    disconnect(): void;
 }
 /**
  * Initialize a FlareAdmin app instance.
@@ -192,6 +211,15 @@ export declare function connectApp(config: FlareAdminConfig, name?: string): Fla
  * @throws If the app has not been initialized yet.
  */
 export declare function getApp(name?: string): FlareAdminApp;
+/**
+ * Disconnect and remove an initialized app by name.
+ * Returns true when an app existed and was removed.
+ */
+export declare function disconnectApp(name?: string): boolean;
+/**
+ * Disconnect and clear all initialized apps.
+ */
+export declare function disconnectAllApps(): void;
 /**
  * Get the auth service from the default app.
  * Equivalent to `getApp().auth()`.
@@ -212,15 +240,15 @@ export declare function auth(name?: string): FlareAdminAuth;
 export declare function db(name?: string): FlareAdminDb;
 /**
  * Get the real-time WebSocket connection from the default app.
- * Equivalent to `getApp().connection()`.
+ * Equivalent to `getApp().live()`.
  *
  * @example
- *   import { connection } from "@zuzjs/flare-admin";
- *   const unsub = connection().collection("users")
+ *   import { live } from "@zuzjs/flare-admin";
+ *   const unsub = live().collection("users")
  *     .where({ role: "admin" })
  *     .onSnapshot((snap) => console.log(snap));
  */
-export declare function connection(name?: string): FlareAdminConnection;
+export declare function live(name?: string): FlareAdminConnection;
 /**
  * Get the notifications service from the default app.
  * Equivalent to `getApp().notifications()`.