sgerp-frontend-lib 0.1.0

package/dist/sgerp/client.d.ts

@@ -0,0 +1,236 @@
+import type { SGERPConfig, Connection } from './types/config';
+import type { User } from './types/account/user';
+import type { Project } from './types/sharing/project';
+import type { ProjectMember } from './types/sharing/project-member';
+import type { Organization } from './types/sharing/organization';
+import type { OrganizationProject } from './types/sharing/organization-project';
+import type { Pricing } from './types/sharing/pricing';
+import type { Passenger } from './types/transportation/passenger';
+import type { Ticket } from './types/transportation/ticket';
+import type { Transaction } from './types/transportation/transaction';
+import type { Simulation } from './types/simulation/simulation';
+import type { Driver } from './types/simulation/driver';
+import type { Vehicle } from './types/simulation/vehicle';
+import type { VehicleType } from './types/simulation/vehicletype';
+import type { Booking } from './types/simulation/booking';
+import type { Node } from './types/simulation/node';
+import type { Dataset } from './types/simulation/dataset';
+import type { SimulationProcessor } from './types/simulation/simulationprocessor';
+import type { OperationsLocation } from './types/simulation/operationslocation';
+import type { OperationsLocationGroup } from './types/simulation/operationslocationgroup';
+import type { RoutingProfile } from './types/simulation/routingprofile';
+import type { Geofence } from './types/simulation/geofence';
+import type { MapboxToken } from './types/simulation/mapboxtoken';
+import type { SMSScheduled } from './types/sms_notify/smsscheduled';
+import type { TransitStop } from './types/masstransit/transitstop';
+import type { Building } from './types/masstransit/building';
+import type { TransitStopSet } from './types/masstransit/transitstopset';
+import { ProjectCollection } from './collections/sharing/project';
+import { ProjectMemberCollection } from './collections/sharing/project-member';
+import { OrganizationCollection } from './collections/sharing/organization';
+import { OrganizationProjectCollection } from './collections/sharing/organization-project';
+import { PricingCollection } from './collections/sharing/pricing';
+import { PassengerCollection } from './collections/transportation/passenger';
+import { TicketCollection } from './collections/transportation/ticket';
+import { TransactionCollection } from './collections/transportation/transaction';
+import { UserCollection } from './collections/account/user';
+import { SimulationCollection } from './collections/simulation/simulation';
+import { DriverCollection } from './collections/simulation/driver';
+import { VehicleCollection } from './collections/simulation/vehicle';
+import { VehicleTypeCollection } from './collections/simulation/vehicletype';
+import { BookingCollection } from './collections/simulation/booking';
+import { NodeCollection } from './collections/simulation/node';
+import { DatasetCollection } from './collections/simulation/dataset';
+import { SimulationProcessorCollection } from './collections/simulation/simulationprocessor';
+import { OperationsLocationCollection } from './collections/simulation/operationslocation';
+import { OperationsLocationGroupCollection } from './collections/simulation/operationslocationgroup';
+import { RoutingProfileCollection } from './collections/simulation/routingprofile';
+import { GeofenceCollection } from './collections/simulation/geofence';
+import { MapboxTokenCollection } from './collections/simulation/mapboxtoken';
+import { SMSScheduledCollection } from './collections/sms_notify/smsscheduled';
+import { TransitStopCollection } from './collections/masstransit/transitstop';
+import { BuildingCollection } from './collections/masstransit/building';
+import { TransitStopSetCollection } from './collections/masstransit/transitstopset';
+import type { Collection } from './collection';
+declare const COLLECTION_REGISTRY: {
+    readonly project: typeof ProjectCollection;
+    readonly projectmember: typeof ProjectMemberCollection;
+    readonly organization: typeof OrganizationCollection;
+    readonly organizationproject: typeof OrganizationProjectCollection;
+    readonly pricing: typeof PricingCollection;
+    readonly passenger: typeof PassengerCollection;
+    readonly ticket: typeof TicketCollection;
+    readonly transaction: typeof TransactionCollection;
+    readonly user: typeof UserCollection;
+    readonly simulation: typeof SimulationCollection;
+    readonly vehicle: typeof VehicleCollection;
+    readonly vehicletype: typeof VehicleTypeCollection;
+    readonly booking: typeof BookingCollection;
+    readonly node: typeof NodeCollection;
+    readonly driver: typeof DriverCollection;
+    readonly dataset: typeof DatasetCollection;
+    readonly simulationprocessor: typeof SimulationProcessorCollection;
+    readonly operationslocation: typeof OperationsLocationCollection;
+    readonly operationslocationgroup: typeof OperationsLocationGroupCollection;
+    readonly transitstop: typeof TransitStopCollection;
+    readonly routingprofile: typeof RoutingProfileCollection;
+    readonly geofence: typeof GeofenceCollection;
+    readonly mapboxtoken: typeof MapboxTokenCollection;
+    readonly smsscheduled: typeof SMSScheduledCollection;
+    readonly building: typeof BuildingCollection;
+    readonly transitstopset: typeof TransitStopSetCollection;
+};
+type CollectionType = keyof typeof COLLECTION_REGISTRY;
+export type ModelTypeMap = {
+    project: Project;
+    projectmember: ProjectMember;
+    organization: Organization;
+    organizationproject: OrganizationProject;
+    pricing: Pricing;
+    passenger: Passenger;
+    ticket: Ticket;
+    transaction: Transaction;
+    user: User;
+    simulation: Simulation;
+    vehicle: Vehicle;
+    vehicletype: VehicleType;
+    booking: Booking;
+    node: Node;
+    driver: Driver;
+    dataset: Dataset;
+    simulationprocessor: SimulationProcessor;
+    operationslocation: OperationsLocation;
+    operationslocationgroup: OperationsLocationGroup;
+    transitstop: TransitStop;
+    routingprofile: RoutingProfile;
+    geofence: Geofence;
+    mapboxtoken: MapboxToken;
+    smsscheduled: SMSScheduled;
+    building: Building;
+    transitstopset: TransitStopSet;
+};
+/**
+ * Main SGERP API Client
+ */
+export declare class SGERPClient {
+    private config;
+    private _collections?;
+    private _contextCollections;
+    constructor(config: SGERPConfig);
+    /**
+     * Get the currently active connection
+     */
+    getActiveConnection(): Connection;
+    /**
+     * Get all available connections
+     */
+    getAllConnections(): Connection[];
+    /**
+     * Get a specific connection by ID
+     */
+    getConnection(connectionId: string): Connection | undefined;
+    /**
+     * Switch to a different connection
+     */
+    switchConnection(connectionId: string): void;
+    /**
+     * Add a new connection
+     */
+    addConnection(connection: Connection): void;
+    /**
+     * Remove a connection
+     */
+    removeConnection(connectionId: string): void;
+    /**
+     * Update password for a connection
+     */
+    updateConnectionPassword(connectionId: string, password: string): void;
+    /**
+     * Get the global timeout value
+     */
+    getTimeout(): number;
+    /**
+     * Get the base URL for the active connection
+     */
+    getBaseUrl(): string;
+    /**
+     * Access collections via api.collections.project, api.collections.projectmember, api.collections.passenger, api.collections.user, or api.collections.simulation
+     *
+     * @example
+     * const projects = api.collections.project;
+     * await projects.fetch({ limit: 20 });
+     * const project = projects.get(1);
+     *
+     * @example
+     * const members = api.collections.projectmember;
+     * await members.fetch({ limit: 100 });
+     *
+     * @example
+     * const passengers = api.collections.passenger;
+     * await passengers.fetch({ limit: 50 });
+     *
+     * @example
+     * const simulations = api.collections.simulation;
+     * await simulations.fetch({ limit: 10 });
+     */
+    get collections(): {
+        project: ProjectCollection;
+        projectmember: ProjectMemberCollection;
+        organization: OrganizationCollection;
+        organizationproject: OrganizationProjectCollection;
+        pricing: PricingCollection;
+        passenger: PassengerCollection;
+        ticket: TicketCollection;
+        transaction: TransactionCollection;
+        user: UserCollection;
+        simulation: SimulationCollection;
+        vehicle: VehicleCollection;
+        vehicletype: VehicleTypeCollection;
+        booking: BookingCollection;
+        node: NodeCollection;
+        driver: DriverCollection;
+        dataset: DatasetCollection;
+        simulationprocessor: SimulationProcessorCollection;
+        operationslocation: OperationsLocationCollection;
+        operationslocationgroup: OperationsLocationGroupCollection;
+        transitstop: TransitStopCollection;
+        routingprofile: RoutingProfileCollection;
+        geofence: GeofenceCollection;
+        mapboxtoken: MapboxTokenCollection;
+        smsscheduled: SMSScheduledCollection;
+        building: BuildingCollection;
+        transitstopset: TransitStopSetCollection;
+    };
+    /**
+     * Get or create a context-specific collection instance
+     * Allows multiple independent collections of the same type
+     *
+     * @example
+     * // Get separate collections for services and templates
+     * const services = api.getCollection('simulation', 'services');
+     * const templates = api.getCollection('simulation', 'templates');
+     *
+     * // Each maintains its own data independently
+     * await services.fetch({ simulation_mode: 'service' });
+     * await templates.fetch({ simulation_mode: 'template' });
+     */
+    getCollection<T extends CollectionType>(modelType: T, context?: string): ModelTypeMap[T] extends infer U extends {
+        id: number | string;
+    } ? Collection<U> : never;
+    /**
+     * Create a new Collection instance for a model type
+     * @internal
+     */
+    private Collection;
+    /**
+     * Generic method to fetch models from the API
+     * @private
+     */
+    private getModels;
+}
+/**
+ * Initialize SGERP library and return a client instance
+ */
+export declare function initializeSGERP(config: SGERPConfig): SGERPClient;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/sgerp/client.d.ts.map

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

package/dist/sgerp/collections/simulation/node.d.ts

@@ -0,0 +1,11 @@
+import { Collection } from '../../collection';
+import type { Node } from '../../types/simulation/node';
+import type { SGERPListResponse } from '../../types/account/user';
+import type { RequestConfig } from '../../types/config';
+/**
+ * Collection class for Node models
+ */
+export declare class NodeCollection extends Collection<Node> {
+    constructor(fetchFn: (params?: unknown, config?: RequestConfig) => Promise<SGERPListResponse<Node>>);
+}
+//# sourceMappingURL=node.d.ts.map

package/dist/sgerp/collections/simulation/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../sgerplib/sgerp/collections/simulation/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU,CAAC,IAAI,CAAC;gBAEhD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;CAI1F"}

package/dist/sgerp/collections/simulation/vehicle.d.ts

@@ -0,0 +1,11 @@
+import { Collection } from '../../collection';
+import type { Vehicle } from '../../types/simulation/vehicle';
+import type { SGERPListResponse } from '../../types/account/user';
+import type { RequestConfig } from '../../types/config';
+/**
+ * Collection class for Vehicle models
+ */
+export declare class VehicleCollection extends Collection<Vehicle> {
+    constructor(fetchFn: (params?: unknown, config?: RequestConfig) => Promise<SGERPListResponse<Vehicle>>);
+}
+//# sourceMappingURL=vehicle.d.ts.map

package/dist/sgerp/collections/simulation/vehicle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicle.d.ts","sourceRoot":"","sources":["../../../../sgerplib/sgerp/collections/simulation/vehicle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU,CAAC,OAAO,CAAC;gBAEtD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;CAI7F"}

package/dist/sgerp/context/sgerp-context.d.ts

@@ -0,0 +1,54 @@
+import React, { type ReactNode } from 'react';
+import type { SGERPClient } from '../client';
+export interface SGERPProviderProps {
+    children: ReactNode;
+}
+/**
+ * Provider component that creates a single SGERP API instance
+ * and shares it with all child components via React Context.
+ *
+ * This should wrap your entire application (e.g., in app/layout.tsx)
+ * to ensure the same API instance and collections persist across page navigations.
+ *
+ * The provider automatically re-initializes when the active connection changes
+ * (e.g., when user logs out and logs in with different credentials).
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { SGERPProvider } from '@/sgerplib/sgerp/context/sgerp-context';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <SGERPProvider>
+ *           {children}
+ *         </SGERPProvider>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export declare function SGERPProvider({ children }: SGERPProviderProps): React.JSX.Element;
+/**
+ * Hook to access the shared SGERP API instance from context.
+ *
+ * Must be used within a SGERPProvider.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const api = useSGERPContext();
+ *
+ *   if (!api) {
+ *     return <div>Not connected</div>;
+ *   }
+ *
+ *   return <ProjectTable collection={api.collections.project} api={api} />;
+ * }
+ * ```
+ */
+export declare function useSGERPContext(): SGERPClient | null;
+//# sourceMappingURL=sgerp-context.d.ts.map

package/dist/sgerp/context/sgerp-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sgerp-context.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/context/sgerp-context.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAA2D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAQ7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,kBAAkB,qBAiD7D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAEpD"}

package/dist/sgerp/hooks/use-collection.d.ts

@@ -0,0 +1,83 @@
+import type { Collection } from '../collection';
+import type { SGERPClient } from '../client';
+import type { ProjectCollection } from '../collections/sharing/project';
+import type { ProjectMemberCollection } from '../collections/sharing/project-member';
+import type { OrganizationCollection } from '../collections/sharing/organization';
+import type { OrganizationProjectCollection } from '../collections/sharing/organization-project';
+import type { PricingCollection } from '../collections/sharing/pricing';
+import type { UserCollection } from '../collections/account/user';
+import type { PassengerCollection } from '../collections/transportation/passenger';
+import type { TicketCollection } from '../collections/transportation/ticket';
+import type { TransactionCollection } from '../collections/transportation/transaction';
+import type { SimulationCollection } from '../collections/simulation/simulation';
+import type { DriverCollection } from '../collections/simulation/driver';
+import type { VehicleCollection } from '../collections/simulation/vehicle';
+import type { VehicleTypeCollection } from '../collections/simulation/vehicletype';
+import type { BookingCollection } from '../collections/simulation/booking';
+import type { NodeCollection } from '../collections/simulation/node';
+import type { DatasetCollection } from '../collections/simulation/dataset';
+import type { SimulationProcessorCollection } from '../collections/simulation/simulationprocessor';
+import type { OperationsLocationCollection } from '../collections/simulation/operationslocation';
+import type { OperationsLocationGroupCollection } from '../collections/simulation/operationslocationgroup';
+import type { RoutingProfileCollection } from '../collections/simulation/routingprofile';
+import type { GeofenceCollection } from '../collections/simulation/geofence';
+import type { MapboxTokenCollection } from '../collections/simulation/mapboxtoken';
+import type { SMSScheduledCollection } from '../collections/sms_notify/smsscheduled';
+import type { TransitStopCollection } from '../collections/masstransit/transitstop';
+import type { BuildingCollection } from '../collections/masstransit/building';
+import type { TransitStopSetCollection } from '../collections/masstransit/transitstopset';
+/**
+ * React hook to subscribe to collection changes
+ */
+export declare function useCollection<T extends {
+    id: number | string;
+}>(collection: Collection<T> | null): Collection<T> | null;
+/**
+ * React-aware API wrapper with reactive collections
+ */
+interface ReactiveAPI {
+    collections: {
+        project: ProjectCollection;
+        simulation: SimulationCollection;
+        user: UserCollection;
+        projectmember: ProjectMemberCollection;
+        organization: OrganizationCollection;
+        organizationproject: OrganizationProjectCollection;
+        pricing: PricingCollection;
+        passenger: PassengerCollection;
+        ticket: TicketCollection;
+        transaction: TransactionCollection;
+        driver: DriverCollection;
+        vehicle: VehicleCollection;
+        vehicletype: VehicleTypeCollection;
+        booking: BookingCollection;
+        node: NodeCollection;
+        dataset: DatasetCollection;
+        simulationprocessor: SimulationProcessorCollection;
+        operationslocation: OperationsLocationCollection;
+        operationslocationgroup: OperationsLocationGroupCollection;
+        transitstop: TransitStopCollection;
+        routingprofile: RoutingProfileCollection;
+        geofence: GeofenceCollection;
+        mapboxtoken: MapboxTokenCollection;
+        smsscheduled: SMSScheduledCollection;
+        building: BuildingCollection;
+        transitstopset: TransitStopSetCollection;
+    };
+    getCollection: SGERPClient['getCollection'];
+}
+/**
+ * React hook to initialize SGERP API with active connection
+ * Returns an API with reactive collections that automatically re-render
+ *
+ * IMPORTANT: This hook will prefer to use the API instance from SGERPContext
+ * if available (when wrapped in SGERPProvider). This ensures the same API
+ * instance and collections persist across page navigations, preventing
+ * unnecessary data refetching.
+ *
+ * If no context is available, falls back to creating a local instance
+ * (backward compatible behavior).
+ */
+export declare function useSGERP(): ReactiveAPI | null;
+export {};
+//# sourceMappingURL=use-collection.d.ts.map

package/dist/sgerp/hooks/use-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-collection.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/hooks/use-collection.ts"],"names":[],"mappings":"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"}

package/dist/sgerp/hooks/use-live-updates.d.ts

@@ -0,0 +1,35 @@
+import type { Collection } from '../collection';
+interface UseLiveUpdatesOptions {
+    /**
+     * Interval in milliseconds (default: 5000 = 5 seconds)
+     */
+    interval?: number;
+    /**
+     * Whether to enable live updates (default: true)
+     */
+    enabled?: boolean;
+    /**
+     * Additional params to pass to fetchUpdates
+     */
+    params?: Record<string, unknown>;
+    /**
+     * Use modified_at__gte instead of modified_at__gt (default: false)
+     * Set to true for backends that don't support __gt filter
+     */
+    useGte?: boolean;
+    /**
+     * Callback when updates are received
+     */
+    onUpdate?: (hasUpdates: boolean) => void;
+}
+/**
+ * Hook to enable periodic live updates for a collection
+ * Fetches incremental updates based on modified_at timestamp
+ *
+ * @returns trigger function to manually trigger an immediate update
+ */
+export declare function useLiveUpdates<T extends {
+    id: number | string;
+}>(collection: Collection<T> | null, options?: UseLiveUpdatesOptions): () => Promise<void>;
+export {};
+//# sourceMappingURL=use-live-updates.d.ts.map

package/dist/sgerp/hooks/use-live-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-live-updates.d.ts","sourceRoot":"","sources":["../../../sgerplib/sgerp/hooks/use-live-updates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,UAAU,qBAAqB;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC9D,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,EAChC,OAAO,GAAE,qBAA0B,GAClC,MAAM,OAAO,CAAC,IAAI,CAAC,CAmGrB"}

package/dist/sgerp/hooks/use-live-updates.js

@@ -0,0 +1,95 @@
+import { useEffect, useRef, useCallback } from 'react';
+/**
+ * Hook to enable periodic live updates for a collection
+ * Fetches incremental updates based on modified_at timestamp
+ *
+ * @returns trigger function to manually trigger an immediate update
+ */
+export function useLiveUpdates(collection, options = {}) {
+    const { interval = 5000, enabled = true, params = {}, useGte = false, onUpdate, } = options;
+    const intervalRef = useRef(null);
+    const paramsRef = useRef(params);
+    const useGteRef = useRef(useGte);
+    const collectionRef = useRef(collection);
+    const onUpdateRef = useRef(onUpdate);
+    // Update refs when they change
+    useEffect(() => {
+        paramsRef.current = params;
+    }, [params]);
+    useEffect(() => {
+        useGteRef.current = useGte;
+    }, [useGte]);
+    useEffect(() => {
+        collectionRef.current = collection;
+    }, [collection]);
+    useEffect(() => {
+        onUpdateRef.current = onUpdate;
+    }, [onUpdate]);
+    // Manual trigger function
+    const trigger = useCallback(async () => {
+        var _a;
+        const col = collectionRef.current;
+        if (!col)
+            return;
+        try {
+            // Check if fetchUpdates method exists
+            if (typeof col.fetchUpdates !== 'function') {
+                console.error('collection.fetchUpdates is not a function. Collection:', col);
+                console.error('Available methods:', Object.getOwnPropertyNames(Object.getPrototypeOf(col)));
+                return;
+            }
+            const hasUpdates = await col.fetchUpdates(paramsRef.current, useGteRef.current);
+            (_a = onUpdateRef.current) === null || _a === void 0 ? void 0 : _a.call(onUpdateRef, hasUpdates);
+        }
+        catch (error) {
+            // Suppress timeout errors - they're expected and will retry
+            if (error instanceof Error && error.message === 'Request timeout') {
+                return;
+            }
+            console.error('Manual live update trigger failed:', error);
+        }
+    }, []);
+    useEffect(() => {
+        if (!collection || !enabled) {
+            // Clear any existing interval
+            if (intervalRef.current) {
+                clearInterval(intervalRef.current);
+                intervalRef.current = null;
+            }
+            return;
+        }
+        // Start polling for updates
+        intervalRef.current = setInterval(async () => {
+            var _a;
+            const col = collectionRef.current;
+            if (!col)
+                return;
+            try {
+                if (typeof col.fetchUpdates !== 'function') {
+                    console.error('collection.fetchUpdates is not a function. Collection:', col);
+                    console.error('Available methods:', Object.getOwnPropertyNames(Object.getPrototypeOf(col)));
+                    return;
+                }
+                const hasUpdates = await col.fetchUpdates(paramsRef.current, useGteRef.current);
+                (_a = onUpdateRef.current) === null || _a === void 0 ? void 0 : _a.call(onUpdateRef, hasUpdates);
+            }
+            catch (error) {
+                // Suppress timeout errors - they're expected and will retry on next interval
+                if (error instanceof Error && error.message === 'Request timeout') {
+                    // Silent - timeouts are normal for live updates
+                    return;
+                }
+                // Log other errors
+                console.error('Live update failed:', error);
+            }
+        }, interval);
+        // Cleanup on unmount or when dependencies change
+        return () => {
+            if (intervalRef.current) {
+                clearInterval(intervalRef.current);
+                intervalRef.current = null;
+            }
+        };
+    }, [collection, enabled, interval, onUpdate]);
+    return trigger;
+}