@zuzjs/flare 0.2.15 → 0.2.16

package/dist/chunk-DGCKTOF5.cjs

@@ -0,0 +1,2 @@
+'use strict';/* ZuzFlare Client */
+var e=()=>typeof document>"u"?new URL(`file:${__filename}`).href:document.currentScript&&document.currentScript.tagName.toUpperCase()==="SCRIPT"?document.currentScript.src:new URL("main.js",document.baseURI).href,t=e();exports.a=t;

package/dist/grpc.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkDGCKTOF5_cjs=require('./chunk-DGCKTOF5.cjs'),i=require('path'),url=require('url'),y=require('fs');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var i__default=/*#__PURE__*/_interopDefault(i);var y__default=/*#__PURE__*/_interopDefault(y);/* ZuzFlare Client */
+var w=()=>typeof process<"u"&&!!process.versions?.node,f=e=>!(e.transport==="ws"||e.transport==="http"||!e.grpcUrl||e.grpcUrl.trim().length===0||!w());async function k(e){let t=await import('@grpc/grpc-js'),s=await import('@grpc/proto-loader'),o=i__default.default.dirname(url.fileURLToPath(chunkDGCKTOF5_cjs.a)),r=[i__default.default.resolve(o,"../../proto"),i__default.default.resolve(o,"../proto"),i__default.default.resolve(process.cwd(),"proto")],n=r.find(p=>y__default.default.existsSync(i__default.default.join(p,"flare.proto")))??r[0],l=i__default.default.join(n,"flare.proto"),a=await s.load(l,{keepCase:false,longs:String,enums:String,defaults:true,oneofs:true,includeDirs:[n]}),u=t.loadPackageDefinition(a).flare;return new u.QueryService(e,t.credentials.createInsecure())}async function m(e){let t=await import('@grpc/grpc-js'),s=await import('@grpc/proto-loader'),o=i__default.default.dirname(url.fileURLToPath(chunkDGCKTOF5_cjs.a)),r=[i__default.default.resolve(o,"../../proto"),i__default.default.resolve(o,"../proto"),i__default.default.resolve(process.cwd(),"proto")],n=r.find(p=>y__default.default.existsSync(i__default.default.join(p,"flare.proto")))??r[0],l=i__default.default.join(n,"flare.proto"),a=await s.load(l,{keepCase:false,longs:String,enums:String,defaults:true,oneofs:true,includeDirs:[n]}),u=t.loadPackageDefinition(a).flare;return new u.AuthService(e,t.credentials.createInsecure())}function h(e,t){return new Promise((s,o)=>{e.RunQuery(t,(r,n)=>{if(r)return o(r);s(n??{});});})}async function v(e,t,s){if(!f(e))return null;let o=await k(e.grpcUrl),r=await h(o,{app_id:e.appId,collection:t,query:s});if(r?.error)throw new Error(`[flare-client][grpc] run_query failed: ${r.error_description||r.error}`);try{let n=JSON.parse(r?.data_json||"[]");return Array.isArray(n)?n:[]}catch{return []}}async function C(e,t,s){if(!f(e))return null;let o=await m(e.grpcUrl),r=await new Promise((n,l)=>{o.Login({app_id:e.appId,client_id:e.apiKey??"",email:t,password:s},(a,c)=>{if(a)return l(a);n(c??{});});});if(r?.error)throw new Error(`[flare-client][grpc] login failed: ${r.error_description||r.error}`);return {token:String(r?.token??""),refreshToken:r?.refresh_token?String(r.refresh_token):null,role:String(r?.role??"user")}}async function D(e,t,s){if(!f(e))return null;let o=await m(e.grpcUrl),r=await new Promise((n,l)=>{o.Register({app_id:e.appId,client_id:e.apiKey??"",email:t,password:s},(a,c)=>{if(a)return l(a);n(c??{});});});if(r?.error)throw new Error(`[flare-client][grpc] register failed: ${r.error_description||r.error}`);return {token:String(r?.token??""),role:String(r?.role??"user"),userId:String(r?.user_id??"")}}exports.runGrpcLogin=C;exports.runGrpcQuery=v;exports.runGrpcRegister=D;

package/dist/grpc.d.cts

@@ -0,0 +1,16 @@
+import { F as FlareConfig, ad as StructuredQuery } from './index-BAvE1URE.cjs';
+import '@zuzjs/auth';
+
+declare function runGrpcQuery<T = Record<string, unknown>>(config: FlareConfig, collection: string, query: StructuredQuery): Promise<T[] | null>;
+declare function runGrpcLogin(config: FlareConfig, email: string, password: string): Promise<{
+    token: string;
+    refreshToken: string | null;
+    role: string;
+} | null>;
+declare function runGrpcRegister(config: FlareConfig, email: string, password: string): Promise<{
+    token: string;
+    role: string;
+    userId: string;
+} | null>;
+
+export { runGrpcLogin, runGrpcQuery, runGrpcRegister };

package/dist/grpc.d.ts

@@ -0,0 +1,16 @@
+import { F as FlareConfig, ad as StructuredQuery } from './index-BAvE1URE.js';
+import '@zuzjs/auth';
+
+declare function runGrpcQuery<T = Record<string, unknown>>(config: FlareConfig, collection: string, query: StructuredQuery): Promise<T[] | null>;
+declare function runGrpcLogin(config: FlareConfig, email: string, password: string): Promise<{
+    token: string;
+    refreshToken: string | null;
+    role: string;
+} | null>;
+declare function runGrpcRegister(config: FlareConfig, email: string, password: string): Promise<{
+    token: string;
+    role: string;
+    userId: string;
+} | null>;
+
+export { runGrpcLogin, runGrpcQuery, runGrpcRegister };

package/dist/grpc.js

@@ -0,0 +1 @@
+import i from'path';import {fileURLToPath}from'url';import g from'fs';var m=()=>typeof process<"u"&&!!process.versions?.node,d=e=>!(e.transport==="ws"||e.transport==="http"||!e.grpcUrl||e.grpcUrl.trim().length===0||!m());async function w(e){let t=await import('@grpc/grpc-js'),s=await import('@grpc/proto-loader'),o=i.dirname(fileURLToPath(import.meta.url)),r=[i.resolve(o,"../../proto"),i.resolve(o,"../proto"),i.resolve(process.cwd(),"proto")],n=r.find(u=>g.existsSync(i.join(u,"flare.proto")))??r[0],l=i.join(n,"flare.proto"),a=await s.load(l,{keepCase:false,longs:String,enums:String,defaults:true,oneofs:true,includeDirs:[n]}),p=t.loadPackageDefinition(a).flare;return new p.QueryService(e,t.credentials.createInsecure())}async function y(e){let t=await import('@grpc/grpc-js'),s=await import('@grpc/proto-loader'),o=i.dirname(fileURLToPath(import.meta.url)),r=[i.resolve(o,"../../proto"),i.resolve(o,"../proto"),i.resolve(process.cwd(),"proto")],n=r.find(u=>g.existsSync(i.join(u,"flare.proto")))??r[0],l=i.join(n,"flare.proto"),a=await s.load(l,{keepCase:false,longs:String,enums:String,defaults:true,oneofs:true,includeDirs:[n]}),p=t.loadPackageDefinition(a).flare;return new p.AuthService(e,t.credentials.createInsecure())}function k(e,t){return new Promise((s,o)=>{e.RunQuery(t,(r,n)=>{if(r)return o(r);s(n??{});});})}async function C(e,t,s){if(!d(e))return null;let o=await w(e.grpcUrl),r=await k(o,{app_id:e.appId,collection:t,query:s});if(r?.error)throw new Error(`[flare-client][grpc] run_query failed: ${r.error_description||r.error}`);try{let n=JSON.parse(r?.data_json||"[]");return Array.isArray(n)?n:[]}catch{return []}}async function D(e,t,s){if(!d(e))return null;let o=await y(e.grpcUrl),r=await new Promise((n,l)=>{o.Login({app_id:e.appId,client_id:e.apiKey??"",email:t,password:s},(a,c)=>{if(a)return l(a);n(c??{});});});if(r?.error)throw new Error(`[flare-client][grpc] login failed: ${r.error_description||r.error}`);return {token:String(r?.token??""),refreshToken:r?.refresh_token?String(r.refresh_token):null,role:String(r?.role??"user")}}async function F(e,t,s){if(!d(e))return null;let o=await y(e.grpcUrl),r=await new Promise((n,l)=>{o.Register({app_id:e.appId,client_id:e.apiKey??"",email:t,password:s},(a,c)=>{if(a)return l(a);n(c??{});});});if(r?.error)throw new Error(`[flare-client][grpc] register failed: ${r.error_description||r.error}`);return {token:String(r?.token??""),role:String(r?.role??"user"),userId:String(r?.user_id??"")}}export{D as runGrpcLogin,C as runGrpcQuery,F as runGrpcRegister};

package/dist/{index-DQHYN410.d.cts → index-5uGluFZz.d.ts}

@@ -1,509 +1,6 @@
+import { an as WhereCondition, af as SubscriptionCallback, Z as QueryConfig, v as DocUpdatedCallback, u as DocDeletedCallback, t as DocChangedCallback, $ as QueryPresetMap, a0 as QueryPresetParams, a1 as QueryPresetRow, a as AggregateSpec, N as HavingClause, O as JoinClause, al as VectorSearchClause, ad as StructuredQuery, aj as SubscriptionHandle, o as CollectionStreamOptions, l as CollectionStream, k as CollectionExternalStore, s as DocAddedCallback, F as FlareConfig, ae as SubscribeOptions, ai as SubscriptionErrorCallback, ah as SubscriptionError, p as ConnectionState, U as PresenceCallback, V as PresenceJoinCallback, W as PresenceLeaveCallback, ak as VectorFieldConfig, a2 as QueryPresetSpec, y as FlareAuthConfig, f as AuthStateListener, d as AuthConfigListener, J as FlareAuthSession, K as FlareAuthUser, z as FlareAuthHydrationInput, G as FlareAuthHydrationOptions, i as BrowserPushTokenOptions, B as BrowserPushRegistrationOptions, a4 as RegisterPushTokenInput, a9 as SendPushNotificationInput, Y as PushSendResult, e as AuthResult } from './index-BAvE1URE.js';
 import { AuthToken } from '@zuzjs/auth';
 
-/**
- * Client Configuration
- */
-interface FlareConfig {
-    /** Base URL for the Flare API. */
-    endpoint: string;
-    /**
-     * Optional HTTP base URL for auth API calls.
-     * When set, all auth HTTP calls go through this base instead of calling
-     * Flare directly. Use this to route calls through a Next.js proxy so CSRF
-     * is handled entirely server-side.
-     * Example: '/api/flare'  (relative, browser resolves against current origin)
-     */
-    httpBase?: string;
-    /**
-     * WebSocket path used for realtime transport.
-     * Defaults to '/' for backward compatibility.
-     */
-    wsPath?: string;
-    /** Unique identifier for the application. */
-    appId: string;
-    /** API key for the application. */
-    apiKey?: string;
-    /**
-     * Request content type for credential auth endpoints (/auth/token, /auth/register).
-     * Defaults to OAuth-compatible form encoding.
-     */
-    authRequestContentType?: "application/x-www-form-urlencoded" | "application/json";
-    /**
-     * Controls how onAuthStateChanged initializes auth in browser runtime.
-     * - `refresh` (default): attempt /auth/refresh once in httpBase mode.
-     * - `none`: skip automatic refresh bootstrap; listeners receive current in-memory state only.
-     */
-    authBootstrapMode?: "refresh" | "none";
-    /** Public key for the application. */
-    publicKey?: string;
-    /** Whether to automatically reconnect on connection loss. */
-    autoReconnect?: boolean;
-    /** Delay between reconnection attempts in milliseconds. */
-    reconnectDelay?: number;
-    /** Maximum delay between reconnection attempts in milliseconds. */
-    maxReconnectDelay?: number;
-    /** Enable or disable debug mode. */
-    debug?: boolean;
-    /** Enable or disable request timing. */
-    requestTiming?: boolean;
-    /** Connection timeout in milliseconds. */
-    connectionTimeout?: number;
-    /** Enable automatic push notification registration on supported platforms. */
-    pushNotifications?: boolean;
-    /**
-     * Optional per-collection mapper registry for shaping inbound data.
-     *
-     * Keys can be:
-     * - base collection names (e.g. "boards")
-     * - join aliases (`join(..., { as: "team" })` => "team")
-     */
-    dataMapper?: DataMapperRegistry;
-}
-type DataMapperFn<TRow = any, TMapped = any> = (row: TRow) => TMapped;
-type DataMapperRegistry = Record<string, DataMapperFn<any, any>>;
-type FlareAuthProviderId = "credentials" | "anonymous" | "google" | "facebook" | "github" | "dropbox" | "apple" | "twitter";
-interface FlareAuthProviderPublicConfig {
-    enabled: boolean;
-    clientId?: string;
-    scopes?: string[];
-}
-interface FlareAuthConfig {
-    appId: string;
-    enabled: boolean;
-    needsEmailVerification?: boolean;
-    autoSendVerificationEmail?: boolean;
-    redirectUri?: string;
-    csrfToken?: string;
-    cookie?: {
-        accessTokenName?: string;
-        refreshTokenName?: string;
-        csrfTokenName?: string;
-        domain?: string;
-        path?: string;
-        secure?: boolean;
-        sameSite?: "Lax" | "Strict" | "None";
-        accessTokenMaxAge?: number;
-        refreshTokenMaxAge?: number;
-        csrfTokenMaxAge?: number;
-    };
-    providers: Record<FlareAuthProviderId, FlareAuthProviderPublicConfig>;
-}
-interface FlareAuthSession {
-    uid: string;
-    accessToken: string;
-    refreshToken: string | null;
-    provider?: string;
-    email?: string | null;
-    emailVerified?: boolean;
-}
-interface FlareAuthUser {
-    uid: string;
-    email: string;
-    email_verified: string;
-    [x: string]: any;
-}
-interface FlareAuthHydrationInput {
-    uid?: string | null;
-    id?: string | null;
-    accessToken?: string | null;
-    refreshToken?: string | null;
-    ticket?: string | null;
-    provider?: string;
-    email?: string | null;
-    emailVerified?: boolean;
-    email_verified?: boolean;
-    profile?: Partial<FlareAuthUser> | null;
-}
-interface FlareAuthHydrationOptions {
-    source?: string;
-    markBootstrapAttempted?: boolean;
-    syncSocket?: boolean;
-}
-interface RegisterPushTokenInput {
-    token: string;
-    platform?: string;
-    deviceId?: string;
-    topics?: string[];
-    authAppId?: string;
-}
-interface BrowserPushTokenOptions {
-    /** Service worker registration used for PushManager subscription. */
-    serviceWorkerRegistration?: ServiceWorkerRegistration;
-    /** Existing PushSubscription to reuse instead of subscribing again. */
-    subscription?: PushSubscription;
-    /** Public VAPID key used when creating a new PushSubscription. */
-    applicationServerKey?: string;
-    /** When true, unsubscribe old subscriptions before creating a new one. */
-    forceResubscribe?: boolean;
-}
-interface BrowserPushRegistrationOptions extends BrowserPushTokenOptions {
-    /** Optional explicit platform label. Defaults to "web". */
-    platform?: string;
-    deviceId?: string;
-    topics?: string[];
-    authAppId?: string;
-}
-interface SendPushNotificationInput {
-    title?: string;
-    body?: string;
-    image?: string;
-    data?: Record<string, unknown>;
-    tokens?: string[];
-    uid?: string;
-    topic?: string;
-    priority?: "normal" | "high";
-    ttlSeconds?: number;
-    dryRun?: boolean;
-    authAppId?: string;
-}
-interface PushSendResult {
-    sent: boolean;
-    appId: string;
-    targetCount: number;
-    successCount: number;
-    failureCount: number;
-    invalidatedTokenCount: number;
-    dryRun: boolean;
-}
-interface SendEmailInput {
-    to: string | string[];
-    tag: string;
-    values?: Record<string, unknown>;
-    authAppId?: string;
-}
-interface EmailSendResult {
-    sent: boolean;
-    appId: string;
-    tag: string;
-    recipientCount: number;
-    acceptedCount: number;
-    rejectedCount: number;
-    includeVerificationLink?: boolean;
-    linkId?: string;
-    verifyUrl?: string;
-    messageId?: string;
-}
-interface VerifyEmailLinkInput {
-    token: string;
-    tag?: string;
-    email?: string;
-    authAppId?: string;
-}
-interface EmailLinkVerifyResult {
-    verified: boolean;
-    alreadyVerified: boolean;
-    appId: string;
-    linkId: string;
-    email: string;
-    tag: string;
-    verifiedAt?: string;
-    acceptedByUid?: string;
-}
-type AuthStateListener = (session: FlareAuthSession & FlareAuthUser | null) => void;
-type AuthConfigListener = (conf: FlareAuthConfig) => void;
-interface SubscribeOptions {
-    skipSnapshot?: boolean;
-}
-type QueryOperator = "==" | "!=" | "<" | "<=" | ">" | ">=" | "in" | "not-in" | "array-contains" | "array-contains-any" | "elem-match" | "like" | "not-like" | "contains" | "exists" | "not-exists";
-interface QueryConfig {
-    field: string;
-    op: QueryOperator;
-    value: unknown;
-}
-/** OR group */
-interface OrFilter {
-    or: AnyFilter[];
-}
-/** AND group */
-interface AndFilter {
-    and: AnyFilter[];
-}
-type AnyFilter = QueryConfig | OrFilter | AndFilter;
-type WhereCondition = Record<string, string | number | boolean | any[]>;
-interface OrderByClause {
-    field: string;
-    dir?: "asc" | "desc";
-}
-interface GroupByClause {
-    fields: string[];
-}
-interface HavingClause {
-    field: string;
-    op: "==" | "!=" | "<" | "<=" | ">" | ">=";
-    value: number;
-}
-interface CursorValue {
-    values: unknown[];
-}
-type AggregateFunction = "count" | "sum" | "avg" | "min" | "max" | "distinct";
-interface AggregateSpec {
-    fn: AggregateFunction;
-    field?: string;
-    alias?: string;
-}
-/**
- * Join definition used by CollectionReference.Join().
- *
- * Example:
- *   Join("tasks", { source: "id", target: "boardId", as: "tasks" })
- */
-interface JoinQueryPattern {
-    where?: AnyFilter[];
-    orderBy?: OrderByClause[];
-    limit?: number;
-    offset?: number;
-    startAt?: CursorValue;
-    startAfter?: CursorValue;
-    endAt?: CursorValue;
-    endBefore?: CursorValue;
-    aggregate?: AggregateSpec[];
-    groupBy?: GroupByClause;
-    having?: HavingClause[];
-    vectorSearch?: VectorSearchClause;
-    select?: string[];
-    distinctField?: string;
-}
-interface NestedJoinClause extends JoinQueryPattern {
-    /** Joined collection name for this nested join. */
-    collection: string;
-    /** Field from the parent join result. */
-    source: string;
-    /** Field from this nested collection to match source. */
-    target: string;
-    /** Alias where nested rows are attached in each parent join row. */
-    as: string;
-    /** If true, expect at most one joined row. */
-    single?: boolean;
-    /** Recursive nested joins. */
-    joins?: NestedJoinClause[];
-}
-interface JoinClause extends JoinQueryPattern {
-    /** Field from the base collection (the collection you started the query on). */
-    source: string;
-    /** Field from the joined collection that should match source. */
-    target: string;
-    /** Alias where joined rows will be attached in each result object. */
-    as: string;
-    /** If true, expect at most one joined row (object instead of array on server side). */
-    single?: boolean;
-    /** Optional nested joins under this join. */
-    joins?: NestedJoinClause[];
-}
-/** Internal wire-ready join shape sent to server query engine. */
-interface StructuredJoinClause extends JoinQueryPattern {
-    from: string;
-    localField: string;
-    foreignField: string;
-    as: string;
-    single?: boolean;
-    joins?: StructuredJoinClause[];
-}
-interface VectorSearchClause {
-    field: string;
-    vector: number[];
-    k: number;
-    metric?: "cosine" | "euclidean" | "dotProduct";
-    minScore?: number;
-}
-/** Full structured query (document query + SQL-style feature set) */
-interface StructuredQuery {
-    where?: AnyFilter[];
-    orderBy?: OrderByClause[];
-    limit?: number;
-    offset?: number;
-    startAt?: CursorValue;
-    startAfter?: CursorValue;
-    endAt?: CursorValue;
-    endBefore?: CursorValue;
-    aggregate?: AggregateSpec[];
-    groupBy?: GroupByClause;
-    having?: HavingClause[];
-    joins?: StructuredJoinClause[];
-    vectorSearch?: VectorSearchClause;
-    select?: string[];
-    distinctField?: string;
-}
-type QueryPresetSpec<Params extends Record<string, unknown> = Record<string, unknown>, Row = any> = {
-    params: Params;
-    row: Row;
-};
-type QueryPresetMap = Record<string, QueryPresetSpec<any, any>>;
-type QueryPresetParams<TSpec> = TSpec extends QueryPresetSpec<infer Params, any> ? Params : Record<string, unknown>;
-type QueryPresetRow<TSpec> = TSpec extends QueryPresetSpec<any, infer Row> ? Row : any;
-type ChangeOperation = 'insert' | 'update' | 'replace' | 'delete';
-/**
- * Fired once when the subscription is first established.
- * `data` is always an array — the full matching collection snapshot.
- */
-interface SnapshotEvent<T = any> {
-    type: 'snapshot';
-    subscriptionId: string;
-    collection: string;
-    data: T[];
-}
-/**
- * Fired on every subsequent document mutation that matches the subscription query.
- * `data` is the single affected document (null on delete).
- */
-interface ChangeEvent<T = any> {
-    type: 'change';
-    subscriptionId: string;
-    collection: string;
-    docId: string;
-    operation: ChangeOperation;
-    data: T | null;
-}
-/** Discriminated union — narrow on `event.type` to get the right shape. */
-type SubscriptionData<T = any> = SnapshotEvent<T> | ChangeEvent<T>;
-type SubscriptionCallback<T = any> = (data: SubscriptionData<T>) => void;
-interface SubscriptionError {
-    code?: string;
-    message: string;
-    permissionDenied: boolean;
-    raw?: unknown;
-}
-type SubscriptionErrorCallback = (error: SubscriptionError) => void;
-interface SubscriptionHandle {
-    (): void;
-    unsubscribe: () => void;
-    onError: (callback: SubscriptionErrorCallback) => SubscriptionHandle;
-    onPermissionDenied: (callback: SubscriptionErrorCallback) => SubscriptionHandle;
-    catch: (callback: SubscriptionErrorCallback) => SubscriptionHandle;
-}
-type DocAddedCallback<T = any> = (data: T, docId: string) => void;
-type DocUpdatedCallback<T = any> = (data: T, docId: string) => void;
-type DocDeletedCallback<T = any> = (docId: string) => void;
-type DocChangedCallback<T = any> = (data: T | null, docId: string, operation: ChangeOperation) => void;
-type StreamFlushReason = 'snapshot' | 'change-batch';
-interface CollectionStreamOptions<T = any> {
-    /** Delay before a queued burst is flushed to listeners. */
-    flushMs?: number;
-    /** Flush immediately when queued changes reach this count. */
-    maxBatchSize?: number;
-    /** Field used to identify docs inside snapshots when getId is not provided. */
-    idField?: keyof T & string;
-    /** Custom identifier extractor for snapshot rows. */
-    getId?: (doc: T) => string | undefined;
-    /** Where newly inserted docs should be placed when they were not in snapshot. */
-    insertAt?: 'start' | 'end';
-    /** Optional cap to keep only the newest N docs in local stream state. */
-    maxDocs?: number;
-    /** Optional local sort run after flush. */
-    sort?: (a: T, b: T) => number;
-}
-interface CollectionStreamMeta {
-    reason: StreamFlushReason;
-    batchSize: number;
-    version: number;
-    ready: boolean;
-}
-type CollectionStreamListener<T = any> = (rows: readonly T[], meta: CollectionStreamMeta) => void;
-interface CollectionStream<T = any> {
-    /** Subscribe to stream updates (call unsubscribe to stop). */
-    subscribe: (listener: CollectionStreamListener<T>, emitCurrent?: boolean) => () => void;
-    /** Returns the latest immutable snapshot of rows. */
-    getSnapshot: () => readonly T[];
-    /** Returns true after the initial snapshot has been received. */
-    isReady: () => boolean;
-    /** Monotonic version incremented on each flush. */
-    getVersion: () => number;
-    /** Stop the underlying realtime subscription and cleanup timers/listeners. */
-    close: () => void;
-    /** Attach subscription-level error handler. */
-    onError: (callback: SubscriptionErrorCallback) => CollectionStream<T>;
-    /** Attach permission-denied handler. */
-    onPermissionDenied: (callback: SubscriptionErrorCallback) => CollectionStream<T>;
-}
-interface CollectionExternalStore<T = any> {
-    /** Standard external-store subscribe signature used by UI store hooks. */
-    subscribe: (onStoreChange: () => void) => () => void;
-    /** Returns current immutable rows snapshot. */
-    getSnapshot: () => readonly T[];
-    /** Server snapshot fallback for SSR-safe store hooks. */
-    getServerSnapshot: () => readonly T[];
-    /** Access to underlying realtime stream for advanced handlers. */
-    stream: CollectionStream<T>;
-    /** Stops realtime stream and detaches listeners. */
-    destroy: () => void;
-}
-interface DocumentSnapshot<T = any> {
-    id: string;
-    data: T | null;
-    exists: boolean;
-}
-interface QuerySnapshot<T = any> {
-    docs: DocumentSnapshot<T>[];
-    size: number;
-    empty: boolean;
-}
-interface OfflineOperation {
-    id: string;
-    type: 'write' | 'delete';
-    collection: string;
-    docId: string;
-    data?: Record<string, unknown>;
-    merge?: boolean;
-    clientTs: number;
-}
-interface AuthResult {
-    uid: string;
-    token?: string;
-}
-type ConnectionState = 'connecting' | 'connected' | 'disconnected' | 'reconnecting' | 'error';
-interface AuthWithPendingVerificationResult {
-    verificationRequired: true;
-    created: true;
-    emailSent: boolean;
-    preview?: {
-        code: string;
-        link: string;
-    };
-}
-interface AuthWithTokenResult extends AuthResult {
-    accessToken: string;
-    refreshToken: string | null;
-    authToken: AuthToken;
-    created: boolean;
-}
-interface PresenceMember {
-    uid: string;
-    socketId: string;
-    room: string;
-    meta?: Record<string, unknown>;
-    joinedAt: number;
-    lastSeen: number;
-}
-type PresenceCallback = (members: PresenceMember[]) => void;
-type PresenceJoinCallback = (member: PresenceMember) => void;
-type PresenceLeaveCallback = (uid: string) => void;
-/** Fields marked as vector will be auto-embedded before write */
-type VectorFieldConfig = {
-    /** Dimensions of the vector (e.g. 1536 for OpenAI ada-002) */
-    dimensions: number;
-    /** Optional custom embedding function; defaults to client-configured embedder */
-    embed?: (text: string) => Promise<number[]>;
-};
-type RulePermission = "create" | "read" | "update" | "delete";
-interface FlareRule {
-    id: string;
-    name: string;
-    auth: "any" | "guest" | "auth";
-    collection: string;
-    document?: string;
-    condition?: string;
-    permissions: RulePermission[];
-}
-interface SecurityRuleEntry {
-    ".read"?: string;
-    ".write"?: string;
-    ".create"?: string;
-    ".update"?: string;
-    ".delete"?: string;
-}
-type SecurityRulesMap = Record<string, SecurityRuleEntry>;
-declare const flareRulesToSecurityMap: (rules: FlareRule[]) => SecurityRulesMap;
-declare const securityMapToFlareRules: (rules: SecurityRulesMap) => FlareRule[];
-
 /**
  * Parse ORM-style where condition: { age: ">= 25", role: "admin" }
  * Returns array of QueryConfig objects
@@ -975,6 +472,7 @@ declare class FlareBase<TPresetMap extends QueryPresetMap = {}> {
     doc<T = any>(collection: string, id: string): DocumentReference<T>;
     ping(): Promise<number>;
     call<T = Record<string, unknown>>(topic: string, payload?: Record<string, unknown>): Promise<T>;
+    trackAnalytics(event: string, payload?: Record<string, unknown>): Promise<void>;
     query<T = Record<string, unknown>>(collection: string, q?: StructuredQuery): Promise<T[]>;
     setEmbedder(fn: EmbedFn): void;
     markVectorField(collection: string, field: string, config?: VectorFieldConfig): void;
@@ -1319,4 +817,4 @@ declare class FlareClient<TPresetMap extends QueryPresetMap = {}> extends FlareA
     autoEnablePushNotifications(): Promise<void>;
 }
 
-export { type OrFilter as $, type AggregateFunction as A, type BaseMessage as B, type ChangeEvent as C, type DataMapperFn as D, type DocUpdatedCallback as E, type FlareConfig as F, DocumentQueryBuilder as G, DocumentReference as H, type DocumentSnapshot as I, type EmailLinkVerifyResult as J, type EmailSendResult as K, FlareAction as L, type FlareAuthConfig as M, type FlareAuthHydrationInput as N, type FlareAuthHydrationOptions as O, type FlareAuthProviderId as P, type FlareAuthProviderPublicConfig as Q, type FlareAuthSession as R, type FlareAuthUser as S, FlareEvent as T, type FlareRule as U, type GroupByClause as V, type HavingClause as W, type JoinClause as X, type JoinQueryPattern as Y, type NestedJoinClause as Z, type OfflineOperation as _, FlareClient as a, type OrderByClause as a0, type PresenceCallback as a1, type PresenceJoinCallback as a2, type PresenceLeaveCallback as a3, type PresenceMember as a4, type PushSendResult as a5, type QueryConfig as a6, type QueryOperator as a7, type QueryPresetMap as a8, type QueryPresetParams as a9, parseWhereCondition as aA, securityMapToFlareRules as aB, type QueryPresetRow as aa, type QueryPresetSpec as ab, type QuerySnapshot as ac, type RegisterPushTokenInput as ad, type RulePermission as ae, type SecurityRuleEntry as af, type SecurityRulesMap as ag, type SendEmailInput as ah, type SendPushNotificationInput as ai, type SnapshotEvent as aj, type StreamFlushReason as ak, type StructuredJoinClause as al, type StructuredQuery as am, type SubscribeMessage as an, type SubscribeOptions as ao, type SubscriptionCallback as ap, type SubscriptionData as aq, type SubscriptionError as ar, type SubscriptionErrorCallback as as, type SubscriptionHandle as at, type VectorFieldConfig as au, type VectorSearchClause as av, type VerifyEmailLinkInput as aw, type WhereCondition as ax, flareRulesToSecurityMap as ay, parseValue as az, type AggregateSpec as b, type AndFilter as c, type AnyFilter as d, type AuthConfigListener as e, type AuthResult as f, type AuthStateListener as g, type AuthWithPendingVerificationResult as h, type AuthWithTokenResult as i, type BrowserPushRegistrationOptions as j, type BrowserPushTokenOptions as k, type ChangeOperation as l, type CollectionExternalStore as m, type CollectionPresetMethods as n, type CollectionQuery as o, CollectionReference as p, type CollectionStream as q, type CollectionStreamListener as r, type CollectionStreamMeta as s, type CollectionStreamOptions as t, type ConnectionState as u, type CursorValue as v, type DataMapperRegistry as w, type DocAddedCallback as x, type DocChangedCallback as y, type DocDeletedCallback as z };
+export { type BaseMessage as B, type CollectionPresetMethods as C, DocumentQueryBuilder as D, FlareClient as F, type SubscribeMessage as S, type CollectionQuery as a, CollectionReference as b, DocumentReference as c, FlareAction as d, FlareEvent as e, parseWhereCondition as f, parseValue as p };