pbtsdb 0.0.1

package/dist/index.js

@@ -0,0 +1,545 @@
+import { createCollection } from '@tanstack/db';
+import { queryCollectionOptions } from '@tanstack/query-db-collection';
+import { createContext, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/collection.ts
+
+// src/logger.ts
+var defaultLogger = {
+  debug: (msg, context) => {
+    if (process.env.NODE_ENV === "development") {
+      console.log(`[pbtsdb] ${msg}`, context || "");
+    }
+  },
+  warn: (msg, context) => {
+    console.warn(`[pbtsdb] ${msg}`, context || "");
+  },
+  error: (msg, context) => {
+    console.error(`[pbtsdb] ${msg}`, context || "");
+  }
+};
+var currentLogger = defaultLogger;
+var logger = {
+  debug: (msg, context) => currentLogger.debug(msg, context),
+  warn: (msg, context) => currentLogger.warn(msg, context),
+  error: (msg, context) => currentLogger.error(msg, context)
+};
+function setLogger(customLogger) {
+  currentLogger = customLogger;
+}
+function resetLogger() {
+  currentLogger = defaultLogger;
+}
+
+// src/subscription-manager.ts
+var SUBSCRIPTION_CONFIG = {
+  MAX_RECONNECT_ATTEMPTS: 5,
+  BASE_RECONNECT_DELAY_MS: 1e3,
+  DEFAULT_WAIT_TIMEOUT_MS: 5e3,
+  CLEANUP_DELAY_MS: 5e3
+};
+function hasId(record) {
+  return typeof record === "object" && record !== null && "id" in record && typeof record.id === "string";
+}
+function createPendingSubscriptionState(recordId) {
+  return {
+    unsubscribe: async () => {
+    },
+    recordId,
+    reconnectAttempts: 0,
+    isReconnecting: false
+  };
+}
+function getSubscriptionKey(recordId) {
+  return recordId || "*";
+}
+var SubscriptionManager = class {
+  constructor(pocketbase) {
+    this.pocketbase = pocketbase;
+    this.subscriptions = /* @__PURE__ */ new Map();
+    this.subscriptionPromises = /* @__PURE__ */ new Map();
+    this.cleanupTimers = /* @__PURE__ */ new Map();
+    this.subscriberCounts = /* @__PURE__ */ new Map();
+  }
+  // ============================================================================
+  // Internal Helpers
+  // ============================================================================
+  async setupSubscription(collectionName, collection, recordId) {
+    const subscriptionKey = getSubscriptionKey(recordId);
+    const eventHandler = (event) => {
+      collection.utils.writeBatch(() => {
+        switch (event.action) {
+          case "create":
+            collection.utils.writeInsert(event.record);
+            break;
+          case "update":
+            collection.utils.writeUpdate(event.record);
+            break;
+          case "delete":
+            if (!hasId(event.record)) {
+              logger.error("Delete event record missing id field", {
+                collectionName,
+                record: event.record
+              });
+              return;
+            }
+            collection.utils.writeDelete(event.record.id);
+            break;
+        }
+      });
+    };
+    const unsubscribe = await this.pocketbase.collection(collectionName).subscribe(subscriptionKey, eventHandler);
+    logger.debug("Subscription established", { collectionName, subscriptionKey });
+    return unsubscribe;
+  }
+  async handleReconnection(collectionName, collection, recordId) {
+    const collectionSubs = this.subscriptions.get(collectionName);
+    if (!collectionSubs) return;
+    const subscriptionKey = getSubscriptionKey(recordId);
+    const state = collectionSubs.get(subscriptionKey);
+    if (!state || state.isReconnecting) return;
+    state.isReconnecting = true;
+    logger.warn("Starting reconnection attempts", { collectionName, subscriptionKey });
+    while (state.reconnectAttempts < SUBSCRIPTION_CONFIG.MAX_RECONNECT_ATTEMPTS) {
+      const delay = SUBSCRIPTION_CONFIG.BASE_RECONNECT_DELAY_MS * Math.pow(2, state.reconnectAttempts);
+      logger.debug(`Reconnection attempt ${state.reconnectAttempts + 1}, waiting ${delay}ms`, {
+        collectionName,
+        subscriptionKey
+      });
+      await new Promise((resolve) => setTimeout(resolve, delay));
+      try {
+        const newUnsubscribe = await this.setupSubscription(
+          collectionName,
+          collection,
+          recordId
+        );
+        state.unsubscribe = newUnsubscribe;
+        state.reconnectAttempts = 0;
+        state.isReconnecting = false;
+        logger.debug("Reconnection successful", { collectionName, subscriptionKey });
+        return;
+      } catch (error) {
+        state.reconnectAttempts++;
+        logger.warn(`Reconnection attempt ${state.reconnectAttempts} failed`, {
+          collectionName,
+          subscriptionKey,
+          error
+        });
+      }
+    }
+    logger.error("Max reconnection attempts reached", {
+      collectionName,
+      subscriptionKey,
+      attempts: state.reconnectAttempts
+    });
+    state.isReconnecting = false;
+    collectionSubs.delete(subscriptionKey);
+  }
+  // ============================================================================
+  // Core Subscription Methods
+  // ============================================================================
+  /**
+   * Subscribe to real-time updates for a collection.
+   * Returns a promise that resolves when the subscription is fully established.
+   *
+   * @param collectionName - The PocketBase collection name
+   * @param collection - The TanStack DB collection to sync with
+   * @param recordId - Optional: Subscribe to specific record, or omit for collection-wide updates
+   */
+  async subscribe(collectionName, collection, recordId) {
+    if (!this.subscriptions.has(collectionName)) {
+      this.subscriptions.set(collectionName, /* @__PURE__ */ new Map());
+    }
+    if (!this.subscriptionPromises.has(collectionName)) {
+      this.subscriptionPromises.set(collectionName, /* @__PURE__ */ new Map());
+    }
+    const collectionSubs = this.subscriptions.get(collectionName);
+    const collectionPromises = this.subscriptionPromises.get(collectionName);
+    const subscriptionKey = getSubscriptionKey(recordId);
+    if (collectionSubs.has(subscriptionKey)) {
+      logger.debug("Already subscribed, skipping", { collectionName, subscriptionKey });
+      return;
+    }
+    const existingPromise = collectionPromises.get(subscriptionKey);
+    if (existingPromise) {
+      logger.debug("Pending subscription found, waiting", { collectionName, subscriptionKey });
+      return existingPromise;
+    }
+    collectionSubs.set(subscriptionKey, createPendingSubscriptionState(recordId));
+    const subscriptionPromise = (async () => {
+      try {
+        const unsubscribe = await this.setupSubscription(collectionName, collection, recordId);
+        const state = collectionSubs.get(subscriptionKey);
+        if (state) {
+          state.unsubscribe = unsubscribe;
+        }
+      } catch (error) {
+        collectionSubs.delete(subscriptionKey);
+        collectionPromises.delete(subscriptionKey);
+        logger.error("Subscription failed", { collectionName, subscriptionKey, error });
+        await this.handleReconnection(collectionName, collection, recordId);
+        throw error;
+      }
+    })();
+    collectionPromises.set(subscriptionKey, subscriptionPromise);
+    try {
+      await subscriptionPromise;
+    } catch (_error) {
+    }
+  }
+  /**
+   * Unsubscribe from real-time updates.
+   *
+   * @param collectionName - The PocketBase collection name
+   * @param recordId - Optional: Unsubscribe from specific record, or omit for collection-wide
+   */
+  unsubscribe(collectionName, recordId) {
+    const collectionSubs = this.subscriptions.get(collectionName);
+    if (!collectionSubs) return;
+    const subscriptionKey = getSubscriptionKey(recordId);
+    const state = collectionSubs.get(subscriptionKey);
+    if (state) {
+      const unsubPromise = state.unsubscribe();
+      if (unsubPromise && typeof unsubPromise.catch === "function") {
+        unsubPromise.catch((error) => {
+          logger.debug("Unsubscribe failed (expected if connection closed)", {
+            collectionName,
+            subscriptionKey,
+            error
+          });
+        });
+      }
+      collectionSubs.delete(subscriptionKey);
+      logger.debug("Unsubscribed", { collectionName, subscriptionKey });
+    }
+    const collectionPromises = this.subscriptionPromises.get(collectionName);
+    if (collectionPromises) {
+      collectionPromises.delete(subscriptionKey);
+      if (collectionPromises.size === 0) {
+        this.subscriptionPromises.delete(collectionName);
+      }
+    }
+    if (collectionSubs.size === 0) {
+      this.subscriptions.delete(collectionName);
+    }
+  }
+  /**
+   * Unsubscribe from all subscriptions for a collection.
+   *
+   * @param collectionName - The PocketBase collection name
+   */
+  unsubscribeAll(collectionName) {
+    const collectionSubs = this.subscriptions.get(collectionName);
+    if (!collectionSubs) return;
+    logger.debug("Unsubscribing from all subscriptions", { collectionName, count: collectionSubs.size });
+    for (const state of collectionSubs.values()) {
+      const unsubPromise = state.unsubscribe();
+      if (unsubPromise && typeof unsubPromise.catch === "function") {
+        unsubPromise.catch((error) => {
+          logger.debug("Unsubscribe failed (expected if connection closed)", {
+            collectionName,
+            error
+          });
+        });
+      }
+    }
+    this.subscriptions.delete(collectionName);
+    this.subscriptionPromises.delete(collectionName);
+  }
+  // ============================================================================
+  // State Queries
+  // ============================================================================
+  /**
+   * Check if subscribed to a collection.
+   *
+   * @param collectionName - The PocketBase collection name
+   * @param recordId - Optional: Check specific record subscription, or omit for collection-wide
+   */
+  isSubscribed(collectionName, recordId) {
+    const collectionSubs = this.subscriptions.get(collectionName);
+    if (!collectionSubs) return false;
+    const subscriptionKey = getSubscriptionKey(recordId);
+    return collectionSubs.has(subscriptionKey);
+  }
+  /**
+   * Wait for a subscription to be fully established (useful for testing).
+   *
+   * @param collectionName - The collection name
+   * @param recordId - Optional specific record ID
+   * @param timeoutMs - Timeout in milliseconds
+   */
+  async waitForSubscription(collectionName, recordId, timeoutMs = SUBSCRIPTION_CONFIG.DEFAULT_WAIT_TIMEOUT_MS) {
+    const subscriptionKey = getSubscriptionKey(recordId);
+    const collectionSubs = this.subscriptions.get(collectionName);
+    if (collectionSubs?.has(subscriptionKey)) {
+      const collectionPromises2 = this.subscriptionPromises.get(collectionName);
+      if (!collectionPromises2?.has(subscriptionKey)) {
+        return;
+      }
+    }
+    const collectionPromises = this.subscriptionPromises.get(collectionName);
+    const promise = collectionPromises?.get(subscriptionKey);
+    if (!promise) {
+      const isSubscribed = collectionSubs?.has(subscriptionKey);
+      if (!isSubscribed) {
+        throw new Error(`No subscription found for ${collectionName}:${subscriptionKey}`);
+      }
+      return;
+    }
+    const timeoutPromise = new Promise((_, reject) => {
+      setTimeout(() => reject(new Error(`Subscription timeout after ${timeoutMs}ms`)), timeoutMs);
+    });
+    await Promise.race([promise, timeoutPromise]);
+  }
+  // ============================================================================
+  // Lifecycle Management
+  // ============================================================================
+  /**
+   * Track subscriber addition for a collection.
+   * Automatically subscribes when first subscriber is added.
+   *
+   * @param collectionName - The PocketBase collection name
+   * @param collection - The TanStack DB collection to sync with
+   */
+  async addSubscriber(collectionName, collection) {
+    const currentCount = this.subscriberCounts.get(collectionName) || 0;
+    const newCount = currentCount + 1;
+    this.subscriberCounts.set(collectionName, newCount);
+    logger.debug("Subscriber added", { collectionName, count: newCount });
+    const cleanupTimer = this.cleanupTimers.get(collectionName);
+    if (cleanupTimer) {
+      clearTimeout(cleanupTimer);
+      this.cleanupTimers.delete(collectionName);
+      logger.debug("Cleanup timer cancelled", { collectionName });
+    }
+    if (newCount === 1 && !this.isSubscribed(collectionName)) {
+      logger.debug("First subscriber - starting subscription", { collectionName });
+      await this.subscribe(collectionName, collection);
+    }
+  }
+  /**
+   * Track subscriber removal for a collection.
+   * Automatically unsubscribes (with delay) when last subscriber is removed.
+   *
+   * @param collectionName - The PocketBase collection name
+   */
+  removeSubscriber(collectionName) {
+    const currentCount = this.subscriberCounts.get(collectionName) || 0;
+    const newCount = Math.max(0, currentCount - 1);
+    this.subscriberCounts.set(collectionName, newCount);
+    logger.debug("Subscriber removed", { collectionName, count: newCount });
+    if (newCount === 0) {
+      const existingTimer = this.cleanupTimers.get(collectionName);
+      if (existingTimer) {
+        clearTimeout(existingTimer);
+      }
+      const cleanupTimer = setTimeout(() => {
+        const finalCount = this.subscriberCounts.get(collectionName) || 0;
+        if (finalCount === 0) {
+          logger.debug("Cleanup timer fired - unsubscribing", { collectionName });
+          this.unsubscribeAll(collectionName);
+          this.subscriberCounts.delete(collectionName);
+        }
+        this.cleanupTimers.delete(collectionName);
+      }, SUBSCRIPTION_CONFIG.CLEANUP_DELAY_MS);
+      this.cleanupTimers.set(collectionName, cleanupTimer);
+      logger.debug("Cleanup timer scheduled", {
+        collectionName,
+        delayMs: SUBSCRIPTION_CONFIG.CLEANUP_DELAY_MS
+      });
+    }
+  }
+  /**
+   * Get the current subscriber count for a collection.
+   * Useful for debugging and testing.
+   *
+   * @param collectionName - The PocketBase collection name
+   * @returns Current subscriber count
+   */
+  getSubscriberCount(collectionName) {
+    return this.subscriberCounts.get(collectionName) || 0;
+  }
+};
+var CollectionsContext = createContext(null);
+function CollectionsProvider({ collections, children }) {
+  return /* @__PURE__ */ jsx(CollectionsContext.Provider, { value: collections, children });
+}
+function useStore(key) {
+  const context = useContext(CollectionsContext);
+  if (!context) {
+    throw new Error("useStore must be used within a CollectionsProvider");
+  }
+  if (!(key in context)) {
+    throw new Error(`Collection "${key}" not found in CollectionsProvider`);
+  }
+  return context[key];
+}
+function useStores(keys) {
+  const context = useContext(CollectionsContext);
+  if (!context) {
+    throw new Error("useStores must be used within a CollectionsProvider");
+  }
+  const collections = keys.map((key) => {
+    if (!(key in context)) {
+      throw new Error(`Collection "${key}" not found in CollectionsProvider`);
+    }
+    return context[key];
+  });
+  return collections;
+}
+
+// src/collection.ts
+var CollectionFactory = class {
+  constructor(pocketbase, queryClient) {
+    this.pocketbase = pocketbase;
+    this.queryClient = queryClient;
+    this.subscriptionManager = new SubscriptionManager(pocketbase);
+  }
+  /**
+   * Setup automatic subscription lifecycle management.
+   * Hooks into TanStack DB's subscriber events to manage real-time subscriptions.
+   */
+  setupSubscriptionLifecycle(collectionName, baseCollection) {
+    baseCollection.on("subscribers:change", (event) => {
+      const newCount = event.subscriberCount;
+      const previousCount = event.previousSubscriberCount;
+      if (newCount > previousCount) {
+        this.subscriptionManager.addSubscriber(collectionName, baseCollection).catch(() => {
+        });
+      } else if (newCount < previousCount) {
+        this.subscriptionManager.removeSubscriber(collectionName);
+      }
+    });
+  }
+  /**
+   * Create a TanStack DB collection from a PocketBase collection.
+   *
+   * Collections are lazy by default - they don't fetch data or subscribe until queried.
+   * Real-time subscriptions automatically start when the first query becomes active
+   * and stop when the last query unmounts (with a cleanup delay to prevent thrashing).
+   *
+   * @param collection - The name of the collection
+   * @param options - Optional configuration including relations and expand
+   *
+   * @example
+   * Basic usage with automatic lifecycle management:
+   * ```ts
+   * const jobsCollection = factory.create('jobs');
+   *
+   * // In your component - subscription starts automatically
+   * const { data } = useLiveQuery((q) =>
+   *     q.from({ jobs: jobsCollection })
+   * );
+   * // Subscription stops automatically when component unmounts
+   * ```
+   *
+   * @example
+   * With query operators (filters, sorting):
+   * ```ts
+   * const jobsCollection = factory.create('jobs');
+   *
+   * // In your component:
+   * const { data } = useLiveQuery((q) =>
+   *     q.from({ jobs: jobsCollection })
+   *      .where(({ jobs }) => and(
+   *          eq(jobs.status, 'ACTIVE'),
+   *          gt(jobs.created, new Date('2025-01-01'))
+   *      ))
+   *      .orderBy(({ jobs }) => jobs.created, 'desc')
+   * );
+   * ```
+   *
+   * @example
+   * With relation expansion:
+   * ```ts
+   * const jobsCollection = factory.create('jobs', {
+   *     expand: 'customer,location'
+   * });
+   *
+   * // Expanded relations available in record.expand
+   * ```
+   *
+   * @example
+   * With relations (for manual joins):
+   * ```ts
+   * const customersCollection = factory.create('customers');
+   * const jobsCollection = factory.create('jobs', {
+   *     relations: { customer: customersCollection }
+   * });
+   *
+   * // In your component, manually build joins:
+   * const { data } = useLiveQuery((q) =>
+   *     q.from({ job: jobsCollection })
+   *      .join(
+   *          { customer: customersCollection },
+   *          ({ job, customer }) => eq(job.customer, customer.id),
+   *          "left"
+   *      )
+   *      .select(({ job, customer }) => ({
+   *          ...job,
+   *          expand: {
+   *              customer: customer ? { ...customer } : undefined
+   *          }
+   *      }))
+   * );
+   * ```
+   *
+   * @example
+   * Manual subscription control (advanced):
+   * ```ts
+   * const jobsCollection = factory.create('jobs');
+   *
+   * // Manually subscribe to specific record (bypasses automatic lifecycle)
+   * await jobsCollection.subscribe('record_id_123');
+   *
+   * // Check subscription status
+   * const isSubbed = jobsCollection.isSubscribed('record_id_123');
+   *
+   * // Manually unsubscribe
+   * jobsCollection.unsubscribe('record_id_123');
+   * ```
+   */
+  create(collection, options) {
+    const baseCollection = createCollection(
+      queryCollectionOptions({
+        queryKey: [collection],
+        queryFn: async () => {
+          const queryOptions = {};
+          if (options?.expand) {
+            queryOptions.expand = options.expand;
+          }
+          const result = await this.pocketbase.collection(collection).getFullList(queryOptions);
+          return result;
+        },
+        queryClient: this.queryClient,
+        getKey: (item) => item.id,
+        startSync: options?.startSync ?? false
+      })
+    );
+    const subscribableCollection = Object.assign(baseCollection, {
+      subscribe: async (recordId) => {
+        await this.subscriptionManager.subscribe(collection, baseCollection, recordId);
+      },
+      unsubscribe: (recordId) => {
+        this.subscriptionManager.unsubscribe(collection, recordId);
+      },
+      unsubscribeAll: () => {
+        this.subscriptionManager.unsubscribeAll(collection);
+      },
+      isSubscribed: (recordId) => {
+        return this.subscriptionManager.isSubscribed(collection, recordId);
+      },
+      waitForSubscription: async (recordId, timeoutMs) => {
+        await this.subscriptionManager.waitForSubscription(collection, recordId, timeoutMs);
+      },
+      relations: options?.relations || {}
+    });
+    this.setupSubscriptionLifecycle(collection, baseCollection);
+    return subscribableCollection;
+  }
+};
+
+export { CollectionFactory, CollectionsProvider, SUBSCRIPTION_CONFIG, SubscriptionManager, resetLogger, setLogger, useStore, useStores };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts","../src/subscription-manager.ts","../src/provider.tsx","../src/collection.ts"],"names":["collectionPromises"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Logger interface for subscription events and internal operations.\n * Users can provide their own implementation to integrate with external logging services.\n */\nexport interface Logger {\n    /**\n     * Log debug-level messages (typically only shown in development).\n     * @param msg - The message to log\n     * @param context - Optional context object with additional information\n     */\n    debug: (msg: string, context?: object) => void;\n\n    /**\n     * Log warning-level messages.\n     * @param msg - The message to log\n     * @param context - Optional context object with additional information\n     */\n    warn: (msg: string, context?: object) => void;\n\n    /**\n     * Log error-level messages.\n     * @param msg - The message to log\n     * @param context - Optional context object with additional information\n     */\n    error: (msg: string, context?: object) => void;\n}\n\n/**\n * Default console-based logger implementation.\n * Only logs debug messages in development mode.\n */\nconst defaultLogger: Logger = {\n    debug: (msg: string, context?: object) => {\n        // Only log debug in development\n        if (process.env.NODE_ENV === 'development') {\n            // biome-ignore lint/suspicious/noConsoleLog: Debug logging is acceptable in development\n            console.log(`[pbtsdb] ${msg}`, context || '');\n        }\n    },\n    warn: (msg: string, context?: object) => {\n        // biome-ignore lint/suspicious/noConsoleLog: Warning logging is acceptable\n        console.warn(`[pbtsdb] ${msg}`, context || '');\n    },\n    error: (msg: string, context?: object) => {\n        // biome-ignore lint/suspicious/noConsoleLog: Error logging is acceptable\n        console.error(`[pbtsdb] ${msg}`, context || '');\n    },\n};\n\n/**\n * Current logger instance (can be replaced by users).\n */\nlet currentLogger: Logger = defaultLogger;\n\n/**\n * Internal logger instance used by the library.\n */\nexport const logger: Logger = {\n    debug: (msg: string, context?: object) => currentLogger.debug(msg, context),\n    warn: (msg: string, context?: object) => currentLogger.warn(msg, context),\n    error: (msg: string, context?: object) => currentLogger.error(msg, context),\n};\n\n/**\n * Set a custom logger implementation.\n * This allows users to integrate with their own logging services (e.g., Sentry, LogRocket, etc.).\n *\n * @param customLogger - The custom logger implementation\n *\n * @example\n * ```ts\n * import { setLogger } from 'pocketbase-tanstack-db';\n *\n * // Example: Integration with a custom logging service\n * setLogger({\n *     debug: (msg, context) => {\n *         myLogger.debug(msg, context);\n *     },\n *     warn: (msg, context) => {\n *         myLogger.warn(msg, context);\n *     },\n *     error: (msg, context) => {\n *         myLogger.error(msg, context);\n *         // Also send to error tracking service\n *         Sentry.captureMessage(msg, { level: 'error', extra: context });\n *     },\n * });\n * ```\n *\n * @example\n * ```ts\n * // Example: Disable all logging\n * setLogger({\n *     debug: () => {},\n *     warn: () => {},\n *     error: () => {},\n * });\n * ```\n */\nexport function setLogger(customLogger: Logger): void {\n    currentLogger = customLogger;\n}\n\n/**\n * Reset the logger to the default implementation.\n */\nexport function resetLogger(): void {\n    currentLogger = defaultLogger;\n}\n","import PocketBase from 'pocketbase';\nimport type { UnsubscribeFunc } from 'pocketbase';\nimport type { Collection } from \"@tanstack/db\"\nimport type { RealtimeEvent, SubscriptionState } from './types';\nimport { logger } from './logger';\n\nexport const SUBSCRIPTION_CONFIG = {\n    MAX_RECONNECT_ATTEMPTS: 5,\n    BASE_RECONNECT_DELAY_MS: 1000,\n    DEFAULT_WAIT_TIMEOUT_MS: 5000,\n    CLEANUP_DELAY_MS: 5000,\n} as const;\n\nfunction hasId(record: unknown): record is { id: string } {\n    return typeof record === 'object'\n        && record !== null\n        && 'id' in record\n        && typeof (record as { id: unknown }).id === 'string';\n}\n\nfunction createPendingSubscriptionState(recordId?: string): SubscriptionState {\n    return {\n        unsubscribe: async () => {},\n        recordId,\n        reconnectAttempts: 0,\n        isReconnecting: false,\n    };\n}\n\nfunction getSubscriptionKey(recordId?: string): string {\n    return recordId || '*';\n}\n\n\n/**\n * Manages real-time subscriptions to PocketBase collections.\n * Handles subscription lifecycle, reconnection with exponential backoff,\n * and automatic synchronization with TanStack DB collections.\n *\n * Subscriptions are automatically managed based on TanStack DB's subscriber count:\n * - Start subscribing when first query becomes active\n * - Stop subscribing when last query becomes inactive (with cleanup delay)\n */\nexport class SubscriptionManager {\n    private subscriptions: Map<string, Map<string, SubscriptionState>> = new Map();\n    private subscriptionPromises: Map<string, Map<string, Promise<void>>> = new Map();\n    private cleanupTimers: Map<string, NodeJS.Timeout> = new Map();\n    private subscriberCounts: Map<string, number> = new Map();\n\n    constructor(private pocketbase: PocketBase) {}\n\n    // ============================================================================\n    // Internal Helpers\n    // ============================================================================\n\n    private async setupSubscription<T extends object>(\n        collectionName: string,\n        collection: Collection<T>,\n        recordId?: string\n    ): Promise<UnsubscribeFunc> {\n        const subscriptionKey = getSubscriptionKey(recordId);\n\n        const eventHandler = (event: RealtimeEvent<T>) => {\n            collection.utils.writeBatch(() => {\n                switch (event.action) {\n                    case 'create':\n                        collection.utils.writeInsert(event.record);\n                        break;\n                    case 'update':\n                        collection.utils.writeUpdate(event.record);\n                        break;\n                    case 'delete':\n                        if (!hasId(event.record)) {\n                            logger.error('Delete event record missing id field', {\n                                collectionName,\n                                record: event.record\n                            });\n                            return;\n                        }\n                        collection.utils.writeDelete(event.record.id);\n                        break;\n                }\n            });\n        };\n\n        const unsubscribe = await this.pocketbase\n            .collection(collectionName)\n            .subscribe(subscriptionKey, eventHandler);\n\n        logger.debug('Subscription established', { collectionName, subscriptionKey });\n\n        return unsubscribe;\n    }\n\n    private async handleReconnection<T extends object>(\n        collectionName: string,\n        collection: Collection<T>,\n        recordId?: string\n    ): Promise<void> {\n        const collectionSubs = this.subscriptions.get(collectionName);\n        if (!collectionSubs) return;\n\n        const subscriptionKey = getSubscriptionKey(recordId);\n        const state = collectionSubs.get(subscriptionKey);\n        if (!state || state.isReconnecting) return;\n\n        state.isReconnecting = true;\n        logger.warn('Starting reconnection attempts', { collectionName, subscriptionKey });\n\n        while (state.reconnectAttempts < SUBSCRIPTION_CONFIG.MAX_RECONNECT_ATTEMPTS) {\n            const delay = SUBSCRIPTION_CONFIG.BASE_RECONNECT_DELAY_MS * Math.pow(2, state.reconnectAttempts);\n            logger.debug(`Reconnection attempt ${state.reconnectAttempts + 1}, waiting ${delay}ms`, {\n                collectionName,\n                subscriptionKey\n            });\n            await new Promise(resolve => setTimeout(resolve, delay));\n\n            try {\n                const newUnsubscribe = await this.setupSubscription(\n                    collectionName,\n                    collection,\n                    recordId\n                );\n\n                state.unsubscribe = newUnsubscribe;\n                state.reconnectAttempts = 0;\n                state.isReconnecting = false;\n                logger.debug('Reconnection successful', { collectionName, subscriptionKey });\n                return;\n            } catch (error) {\n                state.reconnectAttempts++;\n                logger.warn(`Reconnection attempt ${state.reconnectAttempts} failed`, {\n                    collectionName,\n                    subscriptionKey,\n                    error\n                });\n            }\n        }\n\n        logger.error('Max reconnection attempts reached', {\n            collectionName,\n            subscriptionKey,\n            attempts: state.reconnectAttempts\n        });\n        state.isReconnecting = false;\n        collectionSubs.delete(subscriptionKey);\n    }\n\n    // ============================================================================\n    // Core Subscription Methods\n    // ============================================================================\n\n    /**\n     * Subscribe to real-time updates for a collection.\n     * Returns a promise that resolves when the subscription is fully established.\n     *\n     * @param collectionName - The PocketBase collection name\n     * @param collection - The TanStack DB collection to sync with\n     * @param recordId - Optional: Subscribe to specific record, or omit for collection-wide updates\n     */\n    async subscribe<T extends object>(\n        collectionName: string,\n        collection: Collection<T>,\n        recordId?: string\n    ): Promise<void> {\n        if (!this.subscriptions.has(collectionName)) {\n            this.subscriptions.set(collectionName, new Map());\n        }\n        if (!this.subscriptionPromises.has(collectionName)) {\n            this.subscriptionPromises.set(collectionName, new Map());\n        }\n\n        const collectionSubs = this.subscriptions.get(collectionName)!;\n        const collectionPromises = this.subscriptionPromises.get(collectionName)!;\n        const subscriptionKey = getSubscriptionKey(recordId);\n\n        if (collectionSubs.has(subscriptionKey)) {\n            logger.debug('Already subscribed, skipping', { collectionName, subscriptionKey });\n            return;\n        }\n\n        const existingPromise = collectionPromises.get(subscriptionKey);\n        if (existingPromise) {\n            logger.debug('Pending subscription found, waiting', { collectionName, subscriptionKey });\n            return existingPromise;\n        }\n\n        // Placeholder ensures isSubscribed() returns true immediately\n        collectionSubs.set(subscriptionKey, createPendingSubscriptionState(recordId));\n\n        const subscriptionPromise = (async () => {\n            try {\n                const unsubscribe = await this.setupSubscription(collectionName, collection, recordId);\n\n                const state = collectionSubs.get(subscriptionKey);\n                if (state) {\n                    state.unsubscribe = unsubscribe;\n                }\n            } catch (error) {\n                collectionSubs.delete(subscriptionKey);\n                collectionPromises.delete(subscriptionKey);\n                logger.error('Subscription failed', { collectionName, subscriptionKey, error });\n                await this.handleReconnection(collectionName, collection, recordId);\n                throw error;\n            }\n            // Keep promise for waitForSubscription to check completion\n        })();\n\n        collectionPromises.set(subscriptionKey, subscriptionPromise);\n\n        try {\n            await subscriptionPromise;\n        } catch (_error) {\n            // Error logged and reconnection initiated above\n        }\n    }\n\n    /**\n     * Unsubscribe from real-time updates.\n     *\n     * @param collectionName - The PocketBase collection name\n     * @param recordId - Optional: Unsubscribe from specific record, or omit for collection-wide\n     */\n    unsubscribe(collectionName: string, recordId?: string): void {\n        const collectionSubs = this.subscriptions.get(collectionName);\n        if (!collectionSubs) return;\n\n        const subscriptionKey = getSubscriptionKey(recordId);\n        const state = collectionSubs.get(subscriptionKey);\n\n        if (state) {\n            const unsubPromise = state.unsubscribe();\n            if (unsubPromise && typeof unsubPromise.catch === 'function') {\n                unsubPromise.catch((error) => {\n                    logger.debug('Unsubscribe failed (expected if connection closed)', {\n                        collectionName,\n                        subscriptionKey,\n                        error\n                    });\n                });\n            }\n            collectionSubs.delete(subscriptionKey);\n            logger.debug('Unsubscribed', { collectionName, subscriptionKey });\n        }\n\n        const collectionPromises = this.subscriptionPromises.get(collectionName);\n        if (collectionPromises) {\n            collectionPromises.delete(subscriptionKey);\n            if (collectionPromises.size === 0) {\n                this.subscriptionPromises.delete(collectionName);\n            }\n        }\n\n        if (collectionSubs.size === 0) {\n            this.subscriptions.delete(collectionName);\n        }\n    }\n\n    /**\n     * Unsubscribe from all subscriptions for a collection.\n     *\n     * @param collectionName - The PocketBase collection name\n     */\n    unsubscribeAll(collectionName: string): void {\n        const collectionSubs = this.subscriptions.get(collectionName);\n        if (!collectionSubs) return;\n\n        logger.debug('Unsubscribing from all subscriptions', { collectionName, count: collectionSubs.size });\n\n        for (const state of collectionSubs.values()) {\n            const unsubPromise = state.unsubscribe();\n            if (unsubPromise && typeof unsubPromise.catch === 'function') {\n                unsubPromise.catch((error) => {\n                    logger.debug('Unsubscribe failed (expected if connection closed)', {\n                        collectionName,\n                        error\n                    });\n                });\n            }\n        }\n\n        this.subscriptions.delete(collectionName);\n        this.subscriptionPromises.delete(collectionName);\n    }\n\n    // ============================================================================\n    // State Queries\n    // ============================================================================\n\n    /**\n     * Check if subscribed to a collection.\n     *\n     * @param collectionName - The PocketBase collection name\n     * @param recordId - Optional: Check specific record subscription, or omit for collection-wide\n     */\n    isSubscribed(collectionName: string, recordId?: string): boolean {\n        const collectionSubs = this.subscriptions.get(collectionName);\n        if (!collectionSubs) return false;\n\n        const subscriptionKey = getSubscriptionKey(recordId);\n        return collectionSubs.has(subscriptionKey);\n    }\n\n    /**\n     * Wait for a subscription to be fully established (useful for testing).\n     *\n     * @param collectionName - The collection name\n     * @param recordId - Optional specific record ID\n     * @param timeoutMs - Timeout in milliseconds\n     */\n    async waitForSubscription(\n        collectionName: string,\n        recordId?: string,\n        timeoutMs: number = SUBSCRIPTION_CONFIG.DEFAULT_WAIT_TIMEOUT_MS\n    ): Promise<void> {\n        const subscriptionKey = getSubscriptionKey(recordId);\n        const collectionSubs = this.subscriptions.get(collectionName);\n\n        if (collectionSubs?.has(subscriptionKey)) {\n            const collectionPromises = this.subscriptionPromises.get(collectionName);\n            if (!collectionPromises?.has(subscriptionKey)) {\n                return;\n            }\n        }\n\n        const collectionPromises = this.subscriptionPromises.get(collectionName);\n        const promise = collectionPromises?.get(subscriptionKey);\n\n        if (!promise) {\n            const isSubscribed = collectionSubs?.has(subscriptionKey);\n            if (!isSubscribed) {\n                throw new Error(`No subscription found for ${collectionName}:${subscriptionKey}`);\n            }\n            return;\n        }\n\n        const timeoutPromise = new Promise<void>((_, reject) => {\n            setTimeout(() => reject(new Error(`Subscription timeout after ${timeoutMs}ms`)), timeoutMs);\n        });\n\n        await Promise.race([promise, timeoutPromise]);\n    }\n\n    // ============================================================================\n    // Lifecycle Management\n    // ============================================================================\n\n    /**\n     * Track subscriber addition for a collection.\n     * Automatically subscribes when first subscriber is added.\n     *\n     * @param collectionName - The PocketBase collection name\n     * @param collection - The TanStack DB collection to sync with\n     */\n    async addSubscriber<T extends object>(\n        collectionName: string,\n        collection: Collection<T>\n    ): Promise<void> {\n        const currentCount = this.subscriberCounts.get(collectionName) || 0;\n        const newCount = currentCount + 1;\n        this.subscriberCounts.set(collectionName, newCount);\n\n        logger.debug('Subscriber added', { collectionName, count: newCount });\n\n        const cleanupTimer = this.cleanupTimers.get(collectionName);\n        if (cleanupTimer) {\n            clearTimeout(cleanupTimer);\n            this.cleanupTimers.delete(collectionName);\n            logger.debug('Cleanup timer cancelled', { collectionName });\n        }\n\n        if (newCount === 1 && !this.isSubscribed(collectionName)) {\n            logger.debug('First subscriber - starting subscription', { collectionName });\n            await this.subscribe(collectionName, collection);\n        }\n    }\n\n    /**\n     * Track subscriber removal for a collection.\n     * Automatically unsubscribes (with delay) when last subscriber is removed.\n     *\n     * @param collectionName - The PocketBase collection name\n     */\n    removeSubscriber(collectionName: string): void {\n        const currentCount = this.subscriberCounts.get(collectionName) || 0;\n        const newCount = Math.max(0, currentCount - 1);\n        this.subscriberCounts.set(collectionName, newCount);\n\n        logger.debug('Subscriber removed', { collectionName, count: newCount });\n\n        if (newCount === 0) {\n            const existingTimer = this.cleanupTimers.get(collectionName);\n            if (existingTimer) {\n                clearTimeout(existingTimer);\n            }\n\n            const cleanupTimer = setTimeout(() => {\n                const finalCount = this.subscriberCounts.get(collectionName) || 0;\n                if (finalCount === 0) {\n                    logger.debug('Cleanup timer fired - unsubscribing', { collectionName });\n                    this.unsubscribeAll(collectionName);\n                    this.subscriberCounts.delete(collectionName);\n                }\n                this.cleanupTimers.delete(collectionName);\n            }, SUBSCRIPTION_CONFIG.CLEANUP_DELAY_MS);\n\n            this.cleanupTimers.set(collectionName, cleanupTimer);\n            logger.debug('Cleanup timer scheduled', {\n                collectionName,\n                delayMs: SUBSCRIPTION_CONFIG.CLEANUP_DELAY_MS\n            });\n        }\n    }\n\n    /**\n     * Get the current subscriber count for a collection.\n     * Useful for debugging and testing.\n     *\n     * @param collectionName - The PocketBase collection name\n     * @returns Current subscriber count\n     */\n    getSubscriberCount(collectionName: string): number {\n        return this.subscriberCounts.get(collectionName) || 0;\n    }\n}\n","import React, { createContext, useContext, type ReactNode } from 'react';\nimport type { Collection } from '@tanstack/db';\nimport type { SchemaDeclaration } from './types';\n\n/**\n * Map of collection names to TanStack DB Collection instances.\n * Keys are user-defined strings, values are Collection instances.\n *\n * @example\n * ```ts\n * const stores = {\n *     jobs: jobsCollection,\n *     customers: customersCollection,\n *     addresses: addressesCollection\n * };\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type CollectionsMap = Record<string, Collection<any>>;\n\n/**\n * Context for providing collections to React components.\n * @internal\n */\nconst CollectionsContext = createContext<CollectionsMap | null>(null);\n\n/**\n * Props for the CollectionsProvider component.\n */\nexport interface CollectionsProviderProps {\n    /** Map of collection name to Collection instance */\n    collections: CollectionsMap;\n    /** React children to render */\n    children: ReactNode;\n}\n\n/**\n * Provider component that makes collections available to all child components.\n * Wrap your app with this provider to use the useStore and useStores hooks.\n *\n * @example\n * ```tsx\n * const factory = new CollectionFactory<Schema>(pb, queryClient);\n * const collections = {\n *     jobs: factory.create('jobs'),\n *     customers: factory.create('customers'),\n *     addresses: factory.create('addresses')\n * };\n *\n * function App() {\n *     return (\n *         <CollectionsProvider collections={collections}>\n *             <YourApp />\n *         </CollectionsProvider>\n *     );\n * }\n * ```\n */\nexport function CollectionsProvider({ collections, children }: CollectionsProviderProps) {\n    return (\n        <CollectionsContext.Provider value={collections}>\n            {children}\n        </CollectionsContext.Provider>\n    );\n}\n\n/**\n * Hook to access a single collection from the provider.\n * Returns the Collection instance for the specified key.\n *\n * @template T - The record type for the collection\n * @param key - The collection key as defined in the provider\n * @returns The Collection instance\n * @throws Error if used outside of CollectionsProvider or if key doesn't exist\n *\n * @example\n * ```tsx\n * function JobsList() {\n *     const jobsCollection = useStore<JobsRecord>('jobs');\n *\n *     const { data } = useLiveQuery((q) =>\n *         q.from({ jobs: jobsCollection })\n *     );\n *\n *     return (\n *         <ul>\n *             {data?.map(job => <li key={job.id}>{job.name}</li>)}\n *         </ul>\n *     );\n * }\n * ```\n */\nexport function useStore<T extends object = object>(key: string): Collection<T> {\n    const context = useContext(CollectionsContext);\n\n    if (!context) {\n        throw new Error('useStore must be used within a CollectionsProvider');\n    }\n\n    if (!(key in context)) {\n        throw new Error(`Collection \"${key}\" not found in CollectionsProvider`);\n    }\n\n    return context[key] as Collection<T>;\n}\n\n/**\n * Hook to access multiple collections from the provider.\n * Returns an array of Collection instances matching the order of the keys array.\n *\n * @template T - Tuple type of record types for each collection\n * @param keys - Array of collection keys as defined in the provider\n * @returns Array of Collection instances in the same order as keys\n * @throws Error if used outside of CollectionsProvider or if any key doesn't exist\n *\n * @example\n * ```tsx\n * function JobsWithCustomers() {\n *     const [jobsCollection, customersCollection] = useStores<\n *         [JobsRecord, CustomersRecord]\n *     >(['jobs', 'customers']);\n *\n *     const { data } = useLiveQuery((q) =>\n *         q.from({ job: jobsCollection })\n *          .join(\n *              { customer: customersCollection },\n *              ({ job, customer }) => eq(job.customer, customer.id),\n *              'left'\n *          )\n *     );\n *\n *     return <div>...</div>;\n * }\n * ```\n */\nexport function useStores<T extends readonly object[]>(\n    keys: readonly string[]\n): { [K in keyof T]: Collection<T[K]> } {\n    const context = useContext(CollectionsContext);\n\n    if (!context) {\n        throw new Error('useStores must be used within a CollectionsProvider');\n    }\n\n    const collections = keys.map((key) => {\n        if (!(key in context)) {\n            throw new Error(`Collection \"${key}\" not found in CollectionsProvider`);\n        }\n        return context[key];\n    });\n\n    return collections as { [K in keyof T]: Collection<T[K]> };\n}\n","import PocketBase from 'pocketbase';\nimport { createCollection, type Collection } from \"@tanstack/db\"\nimport { queryCollectionOptions } from \"@tanstack/query-db-collection\"\nimport { QueryClient } from '@tanstack/react-query'\nimport { SubscriptionManager } from './subscription-manager';\nimport type {\n    SchemaDeclaration,\n    SubscribableCollection,\n    JoinHelper,\n    CreateCollectionOptions,\n    RelationsConfig,\n    WithExpand,\n} from './types';\n\nexport type {\n    SchemaDeclaration,\n    SubscribableCollection,\n    JoinHelper,\n    CreateCollectionOptions,\n    RelationsConfig,\n} from './types';\n\nexport {\n    CollectionsProvider,\n    useStore,\n    useStores,\n    type CollectionsMap,\n    type CollectionsProviderProps,\n} from './provider';\n\n/**\n * Factory for creating type-safe TanStack DB collections backed by PocketBase.\n * Integrates real-time subscriptions with automatic synchronization.\n */\nexport class CollectionFactory<Schema extends SchemaDeclaration, TMaxDepth extends 0 | 1 | 2 | 3 | 4 | 5 | 6 = 2> {\n    private subscriptionManager: SubscriptionManager;\n\n    constructor(public pocketbase: PocketBase, public queryClient: QueryClient) {\n        this.subscriptionManager = new SubscriptionManager(pocketbase);\n    }\n\n    /**\n     * Setup automatic subscription lifecycle management.\n     * Hooks into TanStack DB's subscriber events to manage real-time subscriptions.\n     */\n    private setupSubscriptionLifecycle<T extends object>(\n        collectionName: string,\n        baseCollection: Collection<T>\n    ): void {\n        baseCollection.on('subscribers:change', (event) => {\n            const newCount = event.subscriberCount;\n            const previousCount = event.previousSubscriberCount;\n\n            if (newCount > previousCount) {\n                // Fire and forget - subscription handled asynchronously\n                this.subscriptionManager.addSubscriber(collectionName, baseCollection).catch(() => {\n                    // Silently handle subscription errors - reconnection will be attempted\n                });\n            } else if (newCount < previousCount) {\n                this.subscriptionManager.removeSubscriber(collectionName);\n            }\n        });\n    }\n\n    /**\n     * Create a TanStack DB collection from a PocketBase collection.\n     *\n     * Collections are lazy by default - they don't fetch data or subscribe until queried.\n     * Real-time subscriptions automatically start when the first query becomes active\n     * and stop when the last query unmounts (with a cleanup delay to prevent thrashing).\n     *\n     * @param collection - The name of the collection\n     * @param options - Optional configuration including relations and expand\n     *\n     * @example\n     * Basic usage with automatic lifecycle management:\n     * ```ts\n     * const jobsCollection = factory.create('jobs');\n     *\n     * // In your component - subscription starts automatically\n     * const { data } = useLiveQuery((q) =>\n     *     q.from({ jobs: jobsCollection })\n     * );\n     * // Subscription stops automatically when component unmounts\n     * ```\n     *\n     * @example\n     * With query operators (filters, sorting):\n     * ```ts\n     * const jobsCollection = factory.create('jobs');\n     *\n     * // In your component:\n     * const { data } = useLiveQuery((q) =>\n     *     q.from({ jobs: jobsCollection })\n     *      .where(({ jobs }) => and(\n     *          eq(jobs.status, 'ACTIVE'),\n     *          gt(jobs.created, new Date('2025-01-01'))\n     *      ))\n     *      .orderBy(({ jobs }) => jobs.created, 'desc')\n     * );\n     * ```\n     *\n     * @example\n     * With relation expansion:\n     * ```ts\n     * const jobsCollection = factory.create('jobs', {\n     *     expand: 'customer,location'\n     * });\n     *\n     * // Expanded relations available in record.expand\n     * ```\n     *\n     * @example\n     * With relations (for manual joins):\n     * ```ts\n     * const customersCollection = factory.create('customers');\n     * const jobsCollection = factory.create('jobs', {\n     *     relations: { customer: customersCollection }\n     * });\n     *\n     * // In your component, manually build joins:\n     * const { data } = useLiveQuery((q) =>\n     *     q.from({ job: jobsCollection })\n     *      .join(\n     *          { customer: customersCollection },\n     *          ({ job, customer }) => eq(job.customer, customer.id),\n     *          \"left\"\n     *      )\n     *      .select(({ job, customer }) => ({\n     *          ...job,\n     *          expand: {\n     *              customer: customer ? { ...customer } : undefined\n     *          }\n     *      }))\n     * );\n     * ```\n     *\n     * @example\n     * Manual subscription control (advanced):\n     * ```ts\n     * const jobsCollection = factory.create('jobs');\n     *\n     * // Manually subscribe to specific record (bypasses automatic lifecycle)\n     * await jobsCollection.subscribe('record_id_123');\n     *\n     * // Check subscription status\n     * const isSubbed = jobsCollection.isSubscribed('record_id_123');\n     *\n     * // Manually unsubscribe\n     * jobsCollection.unsubscribe('record_id_123');\n     * ```\n     */\n    create<\n        C extends keyof Schema & string,\n        E extends string | undefined = undefined\n    >(\n        collection: C,\n        options?: CreateCollectionOptions<Schema, C, E>\n    ): Collection<WithExpand<Schema, C, E>> & SubscribableCollection<WithExpand<Schema, C, E>> & JoinHelper<Schema, C, WithExpand<Schema, C, E>> {\n        type RecordType = WithExpand<Schema, C, E>;\n\n        const baseCollection = createCollection(\n            queryCollectionOptions<RecordType>({\n                queryKey: [collection],\n                queryFn: async () => {\n                    const queryOptions: { expand?: string } = {};\n                    if (options?.expand) {\n                        queryOptions.expand = options.expand;\n                    }\n\n                    const result = await this.pocketbase\n                        .collection(collection)\n                        .getFullList(queryOptions);\n\n                    return result as unknown as RecordType[];\n                },\n                queryClient: this.queryClient,\n                getKey: (item: RecordType) => (item as { id: string }).id,\n                startSync: options?.startSync ?? false,\n            })\n        );\n\n        const subscribableCollection = Object.assign(baseCollection, {\n            subscribe: async (recordId?: string) => {\n                await this.subscriptionManager.subscribe(collection, baseCollection, recordId);\n            },\n            unsubscribe: (recordId?: string) => {\n                this.subscriptionManager.unsubscribe(collection, recordId);\n            },\n            unsubscribeAll: () => {\n                this.subscriptionManager.unsubscribeAll(collection);\n            },\n            isSubscribed: (recordId?: string) => {\n                return this.subscriptionManager.isSubscribed(collection, recordId);\n            },\n            waitForSubscription: async (recordId?: string, timeoutMs?: number) => {\n                await this.subscriptionManager.waitForSubscription(collection, recordId, timeoutMs);\n            },\n            relations: options?.relations || {} as RelationsConfig<Schema, C>\n        });\n\n        this.setupSubscriptionLifecycle(collection, baseCollection);\n\n        return subscribableCollection as Collection<RecordType> & SubscribableCollection<RecordType> & JoinHelper<Schema, C, RecordType>;\n    }\n}\n"]}