@pol-studios/db 1.0.54 → 1.0.56

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (77) hide show
  1. package/dist/{DataLayerContext-C7cJtiO8.d.ts → DataLayerContext-BYZtDD0g.d.ts} +1 -1
  2. package/dist/auth/context.js +6 -4
  3. package/dist/auth/hooks.js +7 -5
  4. package/dist/auth/index.js +7 -5
  5. package/dist/{chunk-FIAXWEBK.js → chunk-4EO55YV2.js} +10 -7
  6. package/dist/chunk-4EO55YV2.js.map +1 -0
  7. package/dist/{chunk-DP3YEVSX.js → chunk-6SDH7M7J.js} +26 -10
  8. package/dist/chunk-6SDH7M7J.js.map +1 -0
  9. package/dist/{chunk-UJWETW36.js → chunk-AKIRHA4Q.js} +527 -418
  10. package/dist/chunk-AKIRHA4Q.js.map +1 -0
  11. package/dist/{chunk-2XS2PM62.js → chunk-DDL63KLQ.js} +388 -107
  12. package/dist/chunk-DDL63KLQ.js.map +1 -0
  13. package/dist/{chunk-YA6MUTA7.js → chunk-FI6JAD5G.js} +3 -3
  14. package/dist/{chunk-WQLIGVQR.js → chunk-GWYTROSD.js} +98 -1
  15. package/dist/chunk-GWYTROSD.js.map +1 -0
  16. package/dist/chunk-JOULSXOI.js +415 -0
  17. package/dist/chunk-JOULSXOI.js.map +1 -0
  18. package/dist/{chunk-OKYHI6JG.js → chunk-LF3V3ERS.js} +3 -3
  19. package/dist/{chunk-FMYXG4VN.js → chunk-MEBT5YHA.js} +2 -2
  20. package/dist/{chunk-BZSAPFFB.js → chunk-N4KK5G5T.js} +116 -18
  21. package/dist/chunk-N4KK5G5T.js.map +1 -0
  22. package/dist/chunk-QYAFI34Q.js +64 -0
  23. package/dist/chunk-QYAFI34Q.js.map +1 -0
  24. package/dist/{chunk-3Q74DK5K.js → chunk-VYFAMTHI.js} +2 -2
  25. package/dist/chunk-W7PERM66.js +215 -0
  26. package/dist/chunk-W7PERM66.js.map +1 -0
  27. package/dist/{chunk-ZGQ7Q4ZU.js → chunk-WM25QE7E.js} +2 -2
  28. package/dist/{chunk-HZIVE5AZ.js → chunk-YRIPM2AN.js} +253 -338
  29. package/dist/chunk-YRIPM2AN.js.map +1 -0
  30. package/dist/chunk-YUX6RGLZ.js +1858 -0
  31. package/dist/chunk-YUX6RGLZ.js.map +1 -0
  32. package/dist/{chunk-Z3EJX3VG.js → chunk-Z456IHCB.js} +3 -3
  33. package/dist/core/index.d.ts +24 -1
  34. package/dist/{executor-YJw4m7Q7.d.ts → executor-D15yjeMo.d.ts} +20 -0
  35. package/dist/hooks/index.d.ts +3 -3
  36. package/dist/hooks/index.js +4 -2
  37. package/dist/{index-jVYdTeWx.d.ts → index-CFUuTzXO.d.ts} +1 -1
  38. package/dist/index.d.ts +5 -5
  39. package/dist/index.js +16 -14
  40. package/dist/index.native.d.ts +62 -8
  41. package/dist/index.native.js +16 -14
  42. package/dist/index.web.d.ts +10 -9
  43. package/dist/index.web.js +30 -19
  44. package/dist/index.web.js.map +1 -1
  45. package/dist/mutation/index.js +3 -3
  46. package/dist/parser/index.js +3 -3
  47. package/dist/powersync-bridge/index.d.ts +1 -1
  48. package/dist/query/index.d.ts +4 -83
  49. package/dist/query/index.js +17 -7
  50. package/dist/realtime/index.d.ts +80 -1
  51. package/dist/realtime/index.js +14 -12
  52. package/dist/realtime/index.js.map +1 -1
  53. package/dist/select-parser-BAV7fOaM.d.ts +144 -0
  54. package/dist/types/index.d.ts +3 -3
  55. package/dist/types/index.js +4 -4
  56. package/dist/{useDbCount-DHLJzmkO.d.ts → useDbCount-Ckb-FhZk.d.ts} +1 -1
  57. package/dist/{useResolveFeedback-B0UcYWVI.d.ts → useResolveFeedback-CuUkdHoR.d.ts} +13 -29
  58. package/dist/with-auth/index.js +9 -7
  59. package/dist/with-auth/index.js.map +1 -1
  60. package/package.json +9 -4
  61. package/dist/chunk-2XS2PM62.js.map +0 -1
  62. package/dist/chunk-BZSAPFFB.js.map +0 -1
  63. package/dist/chunk-CTRY7JDP.js +0 -4112
  64. package/dist/chunk-CTRY7JDP.js.map +0 -1
  65. package/dist/chunk-DP3YEVSX.js.map +0 -1
  66. package/dist/chunk-FIAXWEBK.js.map +0 -1
  67. package/dist/chunk-HZIVE5AZ.js.map +0 -1
  68. package/dist/chunk-INEUG6MC.js +0 -521
  69. package/dist/chunk-INEUG6MC.js.map +0 -1
  70. package/dist/chunk-UJWETW36.js.map +0 -1
  71. package/dist/chunk-WQLIGVQR.js.map +0 -1
  72. /package/dist/{chunk-YA6MUTA7.js.map → chunk-FI6JAD5G.js.map} +0 -0
  73. /package/dist/{chunk-OKYHI6JG.js.map → chunk-LF3V3ERS.js.map} +0 -0
  74. /package/dist/{chunk-FMYXG4VN.js.map → chunk-MEBT5YHA.js.map} +0 -0
  75. /package/dist/{chunk-3Q74DK5K.js.map → chunk-VYFAMTHI.js.map} +0 -0
  76. /package/dist/{chunk-ZGQ7Q4ZU.js.map → chunk-WM25QE7E.js.map} +0 -0
  77. /package/dist/{chunk-Z3EJX3VG.js.map → chunk-Z456IHCB.js.map} +0 -0
@@ -3,10 +3,10 @@ import {
3
3
  PostgrestQueryParser,
4
4
  isObject,
5
5
  parseValue
6
- } from "./chunk-UJWETW36.js";
6
+ } from "./chunk-JOULSXOI.js";
7
7
  import {
8
8
  unflatten
9
- } from "./chunk-INEUG6MC.js";
9
+ } from "./chunk-AKIRHA4Q.js";
10
10
 
11
11
  // src/parser/lib/remove-first-path-element.ts
12
12
  var removeFirstPathElement = (p) => {
@@ -498,4 +498,4 @@ export {
498
498
  isPostgrestHasMorePaginationResponse,
499
499
  setFilterValue
500
500
  };
501
- //# sourceMappingURL=chunk-YA6MUTA7.js.map
501
+ //# sourceMappingURL=chunk-FI6JAD5G.js.map
@@ -1,3 +1,12 @@
1
+ import {
2
+ extractExplicitFkRelations,
3
+ parseSelect,
4
+ selectHasExplicitFkSyntax
5
+ } from "./chunk-W7PERM66.js";
6
+ import {
7
+ mergeRelatedUpdate
8
+ } from "./chunk-QYAFI34Q.js";
9
+
1
10
  // src/providers/DataLayerContext.ts
2
11
  import { createContext } from "react";
3
12
  var DataLayerCoreContext = createContext(null);
@@ -6,6 +15,8 @@ var DataLayerStatusContext = createContext(null);
6
15
  DataLayerStatusContext.displayName = "DataLayerStatusContext";
7
16
  var DataLayerContext = createContext(null);
8
17
  DataLayerContext.displayName = "DataLayerContext";
18
+ var DataLayerNestingContext = createContext(false);
19
+ DataLayerNestingContext.displayName = "DataLayerNestingContext";
9
20
 
10
21
  // src/hooks/useDataLayer.ts
11
22
  import { useContext } from "react";
@@ -172,6 +183,91 @@ function useDbQuery(table, options = {}) {
172
183
  unsubscribe?.();
173
184
  };
174
185
  }, [realtime, registry, tableName, memoizedQueryOptions, queryClient, queryKey, debouncedInvalidate]);
186
+ const explicitFkRelations = useMemo(() => {
187
+ const select = memoizedQueryOptions.select;
188
+ if (!select || !selectHasExplicitFkSyntax(select)) {
189
+ return [];
190
+ }
191
+ const parsed = parseSelect(select);
192
+ return extractExplicitFkRelations(parsed);
193
+ }, [memoizedQueryOptions.select]);
194
+ useEffect(() => {
195
+ if (!realtime || explicitFkRelations.length === 0) {
196
+ return;
197
+ }
198
+ let currentAdapter_1;
199
+ try {
200
+ currentAdapter_1 = registry.getAdapter(tableName);
201
+ } catch {
202
+ return;
203
+ }
204
+ if (!currentAdapter_1?.subscribe) {
205
+ return;
206
+ }
207
+ const isPowerSyncAdapter_0 = currentAdapter_1.name === "powersync";
208
+ const unsubscribes = [];
209
+ const relationsByTable = /* @__PURE__ */ new Map();
210
+ for (const relation of explicitFkRelations) {
211
+ const existing = relationsByTable.get(relation.targetTable) ?? [];
212
+ existing.push(relation);
213
+ relationsByTable.set(relation.targetTable, existing);
214
+ }
215
+ for (const [targetTable, relations] of relationsByTable) {
216
+ let isFirstCallback_0 = isPowerSyncAdapter_0;
217
+ let mergeTimeoutId = null;
218
+ const unsubscribe_0 = currentAdapter_1.subscribe(
219
+ targetTable,
220
+ {
221
+ select: "*"
222
+ },
223
+ // Watch all columns on the related table
224
+ (changedRecords) => {
225
+ if (isFirstCallback_0) {
226
+ isFirstCallback_0 = false;
227
+ return;
228
+ }
229
+ if (mergeTimeoutId) {
230
+ clearTimeout(mergeTimeoutId);
231
+ }
232
+ mergeTimeoutId = setTimeout(() => {
233
+ mergeTimeoutId = null;
234
+ const cachedResult = queryClient.getQueryData(queryKey);
235
+ if (!cachedResult?.data || cachedResult.data.length === 0) {
236
+ debouncedInvalidate();
237
+ return;
238
+ }
239
+ let updatedData = cachedResult.data;
240
+ let hasChanges = false;
241
+ for (const relation_0 of relations) {
242
+ const merged = mergeRelatedUpdate(updatedData, relation_0, changedRecords);
243
+ if (merged !== updatedData) {
244
+ updatedData = merged;
245
+ hasChanges = true;
246
+ }
247
+ }
248
+ if (hasChanges) {
249
+ queryClient.setQueryData(queryKey, {
250
+ data: updatedData,
251
+ count: cachedResult.count
252
+ });
253
+ devLog("useDbQuery", `${tableName}: Optimistic merge from ${targetTable} change`);
254
+ }
255
+ }, 50);
256
+ }
257
+ );
258
+ unsubscribes.push(() => {
259
+ if (mergeTimeoutId) {
260
+ clearTimeout(mergeTimeoutId);
261
+ }
262
+ unsubscribe_0?.();
263
+ });
264
+ }
265
+ return () => {
266
+ for (const unsubscribe_1 of unsubscribes) {
267
+ unsubscribe_1();
268
+ }
269
+ };
270
+ }, [realtime, registry, tableName, explicitFkRelations, queryClient, queryKey, debouncedInvalidate]);
175
271
  useEffect(() => {
176
272
  const adapterName = lastUsedAdapterNameRef.current;
177
273
  if (query.isError && query.error) {
@@ -278,6 +374,7 @@ export {
278
374
  DataLayerCoreContext,
279
375
  DataLayerStatusContext,
280
376
  DataLayerContext,
377
+ DataLayerNestingContext,
281
378
  useDataLayerCore,
282
379
  useDataLayerCoreOptional,
283
380
  useDataLayerStatus,
@@ -288,4 +385,4 @@ export {
288
385
  useDbQuery,
289
386
  useDbQueryById
290
387
  };
291
- //# sourceMappingURL=chunk-WQLIGVQR.js.map
388
+ //# sourceMappingURL=chunk-GWYTROSD.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/providers/DataLayerContext.ts","../src/hooks/useDataLayer.ts","../src/hooks/useDbQuery.ts","../src/utils/dev-log.ts","../src/hooks/useDbQueryById.ts"],"sourcesContent":["/**\n * V3 Data Layer Context\n *\n * Defines the React context and types for the V3 data layer provider.\n * This context provides access to adapters, sync status, and core instances.\n *\n * PERFORMANCE OPTIMIZATION:\n * The context is split into two separate contexts to prevent unnecessary re-renders:\n * - DataLayerCoreContext: Stable values that don't change after initialization\n * - DataLayerStatusContext: Dynamic values that change during runtime\n *\n * The original DataLayerContext is kept for backward compatibility.\n */\n\nimport { createContext } from \"react\";\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport type { QueryClient } from \"@tanstack/react-query\";\nimport type { AdapterRegistry } from \"../adapters/registry\";\nimport type { PowerSyncDatabase } from \"../query/executor\";\nimport type { DatabaseSchema, SyncStatus, SyncControl } from \"../core/types\";\nimport type { BackendStatus, AutoDetectionResult } from \"../adapters/auto-detector\";\nimport type { TableDataAdapter } from \"../adapters/types\";\n\n// =============================================================================\n// Status Types\n// =============================================================================\n\n/**\n * Status of the data layer initialization\n */\nexport interface DataLayerStatus {\n /** Whether the data layer is fully initialized */\n isInitialized: boolean;\n /** Current active backend */\n currentBackend: \"powersync\" | \"supabase\" | null;\n /** PowerSync connection status */\n powerSyncStatus: BackendStatus;\n /** Whether device is online */\n isOnline: boolean;\n /** Last auto-detection result */\n lastDetection: AutoDetectionResult | null;\n /** Initialization error if any */\n error: Error | null;\n /** Whether initial sync has completed (from PowerSync) */\n hasSynced: boolean;\n}\n\n// =============================================================================\n// Split Context Types (Performance Optimization)\n// =============================================================================\n\n/**\n * STABLE core context - values that don't change after initialization\n *\n * Use useDataLayerCore() to access these values in query/mutation hooks\n * to avoid re-renders when sync status changes.\n */\nexport interface DataLayerCoreContextValue {\n /** Adapter registry for getting table adapters */\n registry: AdapterRegistry;\n /** Get adapter for a specific table (defaults to 'read' operation) */\n getAdapter: (table: string, operation?: 'read' | 'write') => TableDataAdapter;\n /** PowerSync database instance (null when not available) */\n powerSync: PowerSyncDatabase | null;\n /** Supabase client (always available) */\n supabase: SupabaseClient;\n /** React Query client */\n queryClient: QueryClient;\n /** Database schema */\n schema: DatabaseSchema;\n /** Sync controls (for PowerSync, no-op for Supabase-only) - stable reference */\n syncControl: SyncControl;\n}\n\n/**\n * DYNAMIC status context - values that change during runtime\n *\n * Use useDataLayerStatus() for UI components that display sync status,\n * online indicator, etc. Components using this WILL re-render when status changes.\n */\nexport interface DataLayerStatusContextValue {\n /** Current status */\n status: DataLayerStatus;\n /** Sync status (for PowerSync, no-op for Supabase-only) */\n syncStatus: SyncStatus;\n}\n\n// =============================================================================\n// Combined Context Value Type (Backward Compatibility)\n// =============================================================================\n\n/**\n * Context value for the data layer (combines core and status)\n *\n * @deprecated Prefer using useDataLayerCore() or useDataLayerStatus() for better performance.\n * This combined interface is kept for backward compatibility.\n */\nexport interface DataLayerContextValue {\n /** Adapter registry for getting table adapters */\n registry: AdapterRegistry;\n\n /** Get adapter for a specific table (defaults to 'read' operation) */\n getAdapter: (table: string, operation?: 'read' | 'write') => TableDataAdapter;\n\n /** PowerSync database instance (null when not available) */\n powerSync: PowerSyncDatabase | null;\n\n /** Supabase client (always available) */\n supabase: SupabaseClient;\n\n /** React Query client */\n queryClient: QueryClient;\n\n /** Database schema */\n schema: DatabaseSchema;\n\n /** Current status */\n status: DataLayerStatus;\n\n /** Sync status (for PowerSync, no-op for Supabase-only) */\n syncStatus: SyncStatus;\n\n /** Sync controls (for PowerSync, no-op for Supabase-only) */\n syncControl: SyncControl;\n}\n\n// =============================================================================\n// Context Creation\n// =============================================================================\n\n/**\n * STABLE Core context - values that don't change after initialization\n *\n * Use useDataLayerCore() hook to access. Components consuming this context\n * will NOT re-render when sync status or network status changes.\n */\nexport const DataLayerCoreContext = createContext<DataLayerCoreContextValue | null>(null);\nDataLayerCoreContext.displayName = \"DataLayerCoreContext\";\n\n/**\n * DYNAMIC Status context - values that change during runtime\n *\n * Use useDataLayerStatus() hook to access. Components consuming this context\n * WILL re-render when sync status or network status changes.\n */\nexport const DataLayerStatusContext = createContext<DataLayerStatusContextValue | null>(null);\nDataLayerStatusContext.displayName = \"DataLayerStatusContext\";\n\n/**\n * Combined data layer context (backward compatibility)\n *\n * @deprecated Prefer using DataLayerCoreContext or DataLayerStatusContext for better performance.\n * Provides access to the V3 data layer throughout the React component tree.\n * Must be accessed via the useDataLayer hook or similar consumer.\n */\nexport const DataLayerContext = createContext<DataLayerContextValue | null>(null);\nDataLayerContext.displayName = \"DataLayerContext\";\n\n/**\n * Internal context to detect nested DataLayerProviders.\n *\n * This prevents the common mistake of wrapping an app with multiple DataLayerProviders,\n * which causes confusion about which provider's context is being used.\n *\n * When a DataLayerProvider mounts, it checks this context:\n * - If false/null: First provider, proceed normally\n * - If true: Nested provider detected, warn in dev mode\n */\nexport const DataLayerNestingContext = createContext<boolean>(false);\nDataLayerNestingContext.displayName = \"DataLayerNestingContext\";","/**\n * V3 Data Layer Hooks\n *\n * Provides access to the V3 data layer context for components.\n * This module provides three hooks for different use cases:\n *\n * - useDataLayerCore(): Stable values only (registry, adapters, clients)\n * Use in query/mutation hooks to avoid re-renders on status changes.\n *\n * - useDataLayerStatus(): Dynamic values only (status, syncStatus, syncControl)\n * Use for UI components that display sync status, online indicator, etc.\n *\n * - useDataLayer(): Combined access (backward compatible)\n * Use when you need both core and status values.\n */\n\nimport { useContext } from \"react\";\nimport { DataLayerContext, DataLayerCoreContext, DataLayerStatusContext, type DataLayerContextValue, type DataLayerCoreContextValue, type DataLayerStatusContextValue } from \"../providers/DataLayerContext\";\n\n// =============================================================================\n// PERFORMANCE-OPTIMIZED HOOKS (Recommended)\n// =============================================================================\n\n/**\n * Hook to access ONLY the stable core values (registry, adapters, clients)\n *\n * PERFORMANCE BENEFIT: Components using this hook will NOT re-render when\n * network status or sync status changes. Use this in query/mutation hooks.\n *\n * Provides access to:\n * - registry: Adapter registry for getting table adapters\n * - getAdapter: Function to get adapter for a specific table\n * - powerSync: PowerSync database instance (null when not available)\n * - supabase: Supabase client (always available)\n * - queryClient: React Query client\n * - schema: Database schema\n *\n * @throws Error if used outside of DataLayerProvider\n *\n * @example\n * const { getAdapter, supabase } = useDataLayerCore();\n * const adapter = getAdapter(\"Task\");\n * // This component won't re-render on sync status changes\n */\nexport function useDataLayerCore() {\n const context = useContext(DataLayerCoreContext);\n if (!context) {\n throw new Error(\"useDataLayerCore must be used within a DataLayerProvider. Make sure you have wrapped your app with <DataLayerProvider>.\");\n }\n return context;\n}\n\n/**\n * Hook to access ONLY the STABLE core context (optional version).\n * Returns null if DataLayerProvider is not present, rather than throwing.\n * Use this when you need graceful fallback behavior.\n *\n * @example\n * const dataLayerCore = useDataLayerCoreOptional();\n * if (dataLayerCore) {\n * // Use V3 adapter pattern\n * } else {\n * // Fall back to Supabase\n * }\n */\nexport function useDataLayerCoreOptional() {\n return useContext(DataLayerCoreContext);\n}\n\n/**\n * Hook to access ONLY the dynamic status values\n *\n * PERFORMANCE BENEFIT: Only components that actually need status information\n * will re-render when status changes. Use for UI components that display\n * sync status, online indicator, pending uploads count, etc.\n *\n * Provides access to:\n * - status: Current initialization and connection status\n * - syncStatus: Sync status for PowerSync\n * - syncControl: Sync controls for PowerSync\n *\n * @throws Error if used outside of DataLayerProvider\n *\n * @example\n * const { status, syncStatus } = useDataLayerStatus();\n *\n * return (\n * <StatusBar\n * isOnline={status.isOnline}\n * pendingUploads={syncStatus.pendingUploads}\n * />\n * );\n */\nexport function useDataLayerStatus() {\n const context = useContext(DataLayerStatusContext);\n if (!context) {\n throw new Error(\"useDataLayerStatus must be used within a DataLayerProvider. Make sure you have wrapped your app with <DataLayerProvider>.\");\n }\n return context;\n}\n\n// =============================================================================\n// BACKWARD COMPATIBLE HOOKS\n// =============================================================================\n\n/**\n * Hook to access the V3 data layer context (combined core + status)\n *\n * NOTE: Consider using useDataLayerCore() or useDataLayerStatus() instead\n * for better render performance. This hook re-renders on ALL status changes.\n *\n * Provides access to:\n * - registry: Adapter registry for getting table adapters\n * - getAdapter: Function to get adapter for a specific table\n * - powerSync: PowerSync database instance (null when not available)\n * - supabase: Supabase client (always available)\n * - queryClient: React Query client\n * - schema: Database schema\n * - status: Current initialization and connection status\n * - syncStatus: Sync status for PowerSync\n * - syncControl: Sync controls for PowerSync\n *\n * @throws Error if used outside of DataLayerProvider\n *\n * @example\n * const { getAdapter, status } = useDataLayer();\n *\n * if (status.isInitialized) {\n * const adapter = getAdapter(\"Task\");\n * // Use adapter...\n * }\n */\nexport function useDataLayer() {\n const context = useContext(DataLayerContext);\n if (!context) {\n throw new Error(\"useDataLayer must be used within a DataLayerProvider. Make sure you have wrapped your app with <DataLayerProvider>.\");\n }\n return context;\n}\n\n/**\n * Hook to safely access data layer context (returns null if not in provider)\n *\n * Use this when you need to check if the data layer is available\n * without throwing an error. Useful for conditional rendering or\n * components that may be rendered outside the provider context.\n *\n * @example\n * const dataLayer = useDataLayerOptional();\n *\n * if (dataLayer) {\n * // Safe to use data layer\n * } else {\n * // Render fallback UI\n * }\n */\nexport function useDataLayerOptional() {\n return useContext(DataLayerContext);\n}\nexport default useDataLayer;","/**\n * V3 useDbQuery Hook\n *\n * React hook for querying multiple records from a table.\n * Works identically whether PowerSync or Supabase is the backend.\n * Uses React Query for state management and caching.\n *\n * Types are automatically inferred from table names when you augment\n * the DatabaseTypes interface with your app's Database type.\n *\n * @example\n * // In your app's types/db.d.ts:\n * declare module \"@pol-studios/db\" {\n * interface DatabaseTypes {\n * database: import(\"@/database.types\").Database;\n * }\n * }\n *\n * // Then usage auto-infers types:\n * const { data } = useDbQuery(\"EquipmentFixtureUnit\", { ... });\n * // data is typed as Tables<\"EquipmentFixtureUnit\">[]\n */\n\nimport { useMemo, useEffect, useCallback, useRef } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { useDataLayerCore } from \"./useDataLayer\";\nimport type { QueryOptions } from \"../core/types\";\nimport { devLog, devWarn } from \"../utils/dev-log\";\nimport { parseSelect, extractExplicitFkRelations, selectHasExplicitFkSyntax } from \"../query/select-parser\";\nimport type { ExtractedExplicitFk } from \"../query/select-parser\";\nimport { mergeRelatedUpdate } from \"../realtime/explicit-fk-merge\";\n\n// =============================================================================\n// Module Augmentation Interface\n// =============================================================================\n\n/**\n * Augment this interface in your app to enable automatic type inference.\n *\n * @example\n * // In types/db.d.ts\n * declare module \"@pol-studios/db\" {\n * interface DatabaseTypes {\n * database: import(\"@/database.types\").Database;\n * }\n * }\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface DatabaseTypes {}\n\n// =============================================================================\n// Database Type Helpers\n// =============================================================================\n\n/**\n * The configured Database type, or a generic fallback\n */\ntype ConfiguredDatabase = DatabaseTypes extends {\n database: infer DB;\n} ? DB : GenericSchema;\n\n/**\n * Generic schema structure for fallback\n */\ntype GenericSchema = {\n public: {\n Tables: Record<string, {\n Row: Record<string, unknown>;\n }>;\n Views: Record<string, {\n Row: Record<string, unknown>;\n }>;\n };\n [schema: string]: {\n Tables: Record<string, {\n Row: Record<string, unknown>;\n }>;\n Views?: Record<string, {\n Row: Record<string, unknown>;\n }>;\n };\n};\n\n/**\n * Default schema from Database (usually \"public\")\n */\ntype DefaultSchema = ConfiguredDatabase extends {\n public: infer S;\n} ? S : never;\n\n/**\n * Extract all valid table names from the default schema\n */\nexport type PublicTableNames = DefaultSchema extends {\n Tables: infer T;\n} ? keyof T & string : string;\n\n/**\n * Extract all valid schema names\n */\nexport type SchemaNames = keyof ConfiguredDatabase & string;\n\n/**\n * Extract table names for a specific schema\n */\nexport type SchemaTableNames<S extends string> = ConfiguredDatabase extends { [K in S]: {\n Tables: infer T;\n} } ? keyof T & string : string;\n\n/**\n * Build dot notation strings for all schema.table combinations\n */\ntype SchemaDotTable = { [S in SchemaNames]: S extends \"public\" ? never // Skip public schema for dot notation\n: `${S}.${SchemaTableNames<S>}` }[SchemaNames];\n\n/**\n * Table identifier - provides autocomplete for valid table names\n *\n * Supports:\n * - \"TableName\" - public schema tables\n * - \"schema.TableName\" - dot notation for other schemas\n * - { schema, table } - object format for other schemas\n */\nexport type TableIdentifier = PublicTableNames | SchemaDotTable | { [S in Exclude<SchemaNames, \"public\">]: {\n schema: S;\n table: SchemaTableNames<S>;\n} }[Exclude<SchemaNames, \"public\">];\n\n/**\n * Resolve row type from a table identifier\n *\n * Supports:\n * - \"TableName\" → public schema\n * - \"schema.TableName\" → specified schema (dot notation)\n * - { schema: \"schema\", table: \"TableName\" } → specified schema (object)\n */\nexport type ResolveRowType<T extends TableIdentifier> = T extends string ?\n// Check for dot notation first (e.g., \"core.Profile\")\nT extends `${infer Schema}.${infer Table}` ? ConfiguredDatabase extends { [K in Schema]: {\n Tables: { [K2 in Table]: {\n Row: infer R;\n } };\n} } ? R : Record<string, unknown> :\n// Plain string - look in public schema\nDefaultSchema extends {\n Tables: { [K in T]: {\n Row: infer R;\n } };\n} ? R : DefaultSchema extends {\n Views: { [K in T]: {\n Row: infer R;\n } };\n} ? R : Record<string, unknown> : T extends {\n schema: infer S;\n table: infer TN;\n} ?\n// Object with schema - look in specified schema\nS extends string ? TN extends string ? ConfiguredDatabase extends { [K in S]: {\n Tables: { [K2 in TN]: {\n Row: infer R;\n } };\n} } ? R : Record<string, unknown> : Record<string, unknown> : Record<string, unknown> : Record<string, unknown>;\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Options for useDbQuery hook\n */\nexport interface UseDbQueryOptions extends Omit<QueryOptions, \"enabled\"> {\n /** Whether the query is enabled (default: true) */\n enabled?: boolean;\n /**\n * React Query stale time in ms\n * Default depends on backend:\n * - PowerSync (offline): 0 - always refetch from SQLite (disk is fast)\n * - Supabase (online): 30000 - use normal caching\n */\n staleTime?: number;\n /** React Query gcTime (cache time) in ms (default: 300000 - 5 minutes) */\n gcTime?: number;\n /** Whether to refetch on window focus (default: true) */\n refetchOnWindowFocus?: boolean;\n /**\n * Whether to refetch on mount\n * Default depends on backend:\n * - PowerSync (offline): \"always\" - always query SQLite\n * - Supabase (online): true - refetch if stale\n */\n refetchOnMount?: boolean | \"always\";\n /** Whether to enable real-time subscriptions (if adapter supports) */\n realtime?: boolean;\n /** If true, returns single item instead of array (for compatibility with V2) */\n single?: boolean;\n}\n\n/**\n * Result from useDbQuery hook\n */\nexport interface UseDbQueryResult<T> {\n /** Query data */\n data: T[] | undefined;\n /** Whether query is loading (initial load) */\n isLoading: boolean;\n /** Whether query is in pending state */\n isPending: boolean;\n /** Whether query is currently fetching (including refetch) */\n isFetching: boolean;\n /** Whether query is currently refetching (alias for isFetching for V2 compatibility) */\n isRefetching: boolean;\n /** Whether query completed successfully */\n isSuccess: boolean;\n /** Whether query errored */\n isError: boolean;\n /** Query error if any */\n error: Error | null;\n /** Refetch the query */\n refetch: () => Promise<void>;\n /** Total count (if pagination is used) */\n count?: number;\n /** Whether data is stale */\n isStale: boolean;\n /** Timestamp of last data update */\n dataUpdatedAt: number | null;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Build a query key for React Query\n *\n * Creates a stable, unique key for caching based on table and query options.\n * Keys are namespaced with \"v3\" to avoid collisions with V2 queries.\n *\n * NOTE: Backend is intentionally NOT included in the key. The data is the same\n * regardless of whether it comes from Supabase or PowerSync - switching backends\n * should NOT invalidate the cache. This is critical for offline-first UX.\n */\nfunction buildQueryKey(table: string, options: UseDbQueryOptions): unknown[] {\n return [\"v3\", \"query\", table, options.select ?? \"*\", JSON.stringify(options.where ?? {}), JSON.stringify(options.orderBy ?? []), options.limit, options.offset];\n}\n\n/**\n * Serialize query options for dependency tracking\n */\nfunction serializeQueryOptions(options: UseDbQueryOptions): string {\n return JSON.stringify({\n select: options.select,\n where: options.where,\n orderBy: options.orderBy,\n limit: options.limit,\n offset: options.offset\n });\n}\n\n// =============================================================================\n// Hook Implementation\n// =============================================================================\n\n/**\n * Helper to resolve table name from TableIdentifier\n */\nfunction resolveTableName(table: TableIdentifier): string {\n if (typeof table === \"string\") {\n return table;\n }\n return `${table.schema}.${table.table}`;\n}\n\n/**\n * Hook for querying multiple records from a table\n *\n * This hook provides a unified interface for querying data that works\n * identically whether the backend is PowerSync (offline-first) or\n * Supabase (online-only). It uses React Query for caching and state management.\n *\n * Features:\n * - Automatic type inference from table names (when DatabaseTypes is augmented)\n * - Automatic backend selection based on DataLayerProvider configuration\n * - React Query integration for caching, deduplication, and background updates\n * - Optional real-time subscriptions (when adapter supports it)\n * - Pagination support with count\n *\n * @param table - Table name (string) or { schema, table } object\n * @param options - Query options (select, where, orderBy, limit, offset, etc.)\n * @returns Query result with data, loading states, error, and refetch function\n *\n * @example\n * // Basic query - types auto-inferred from table name\n * const { data } = useDbQuery(\"EquipmentFixtureUnit\");\n * // data is typed as Tables<\"EquipmentFixtureUnit\">[]\n *\n * @example\n * // Query from non-public schema\n * const { data } = useDbQuery({ schema: \"core\", table: \"Profile\" });\n * // data is typed as Tables<{ schema: \"core\" }, \"Profile\">[]\n *\n * @example\n * // Query with filters and sorting\n * const { data } = useDbQuery(\"Task\", {\n * select: \"*, Project(*)\",\n * where: { status: \"active\" },\n * orderBy: [{ field: \"createdAt\", direction: \"desc\" }],\n * limit: 10,\n * });\n */\n/**\n * Main hook signature with auto-inferred types from table identifiers\n */\nexport function useDbQuery<T extends TableIdentifier>(table: T, options?: UseDbQueryOptions): UseDbQueryResult<ResolveRowType<T>>;\n\n/**\n * Overload for explicit type parameter when table name is a string literal\n */\nexport function useDbQuery<T>(table: string, options?: UseDbQueryOptions): UseDbQueryResult<T>;\n\n// Implementation signature - uses any to satisfy both overloads\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useDbQuery<T = any>(table: TableIdentifier | string, options: UseDbQueryOptions = {}): UseDbQueryResult<T> {\n const tableName = typeof table === \"string\" ? table : resolveTableName(table as TableIdentifier);\n const {\n registry,\n queryClient,\n powerSync\n } = useDataLayerCore();\n\n // Determine if using PowerSync (offline/SQLite) or Supabase (online)\n const isPowerSync = powerSync !== null;\n\n // Backend-aware defaults:\n // - PowerSync: staleTime=0, refetchOnMount=\"always\" (SQLite is fast, always query disk)\n // - Supabase: staleTime=30000, refetchOnMount=true (use normal React Query caching)\n // - realtime: PowerSync=true (use watch() for live updates), Supabase=false (no streaming)\n const {\n enabled = true,\n staleTime = isPowerSync ? 0 : 30000,\n gcTime = 300000,\n // 5 minutes - keep in memory for instant display while refetching\n refetchOnWindowFocus = true,\n refetchOnMount = isPowerSync ? \"always\" : true,\n realtime = isPowerSync,\n // Enable real-time subscriptions by default for PowerSync\n ...queryOptions\n } = options;\n\n // Get adapter for this table\n // No isInitialized check needed - if we get here, core context exists = initialized\n const adapter = useMemo(() => {\n try {\n return registry.getAdapter(tableName);\n } catch {\n return null;\n }\n }, [registry, tableName]);\n\n // Serialize options into a stable memoized value BEFORE using in other dependencies\n const serializedOptions = useMemo(() => serializeQueryOptions(options), [options.select, options.where, options.orderBy, options.limit, options.offset]);\n\n // Build query key - memoized to prevent unnecessary re-renders\n // Backend is NOT included - cache persists across backend switches for offline-first UX\n const queryKey = useMemo(() => buildQueryKey(tableName, options), [tableName, serializedOptions]);\n\n // Memoize query options to prevent re-creating on every render\n const memoizedQueryOptions = useMemo(() => ({\n select: queryOptions.select,\n where: queryOptions.where,\n orderBy: queryOptions.orderBy,\n limit: queryOptions.limit,\n offset: queryOptions.offset\n }), [serializedOptions]);\n\n // Track the adapter name that was actually used for the most recent query\n // This is used for accurate logging since the memoized adapter may be stale\n const lastUsedAdapterNameRef = useRef<string>(\"unknown\");\n\n // Query function - resolve adapter lazily at query time to ensure we always\n // have the latest adapter instance (the memoized adapter may be stale)\n const queryFn = useCallback(async () => {\n // Use currentAdapter directly - registry.getAdapter() throws if unavailable\n const currentAdapter = registry.getAdapter(tableName);\n\n // Track which adapter was actually used for accurate logging\n lastUsedAdapterNameRef.current = currentAdapter.name;\n const result = await currentAdapter.query(tableName, memoizedQueryOptions);\n return result;\n }, [registry, tableName, memoizedQueryOptions]);\n\n // Execute query with React Query\n // Backend-aware caching strategy:\n // - PowerSync: SQLite is source of truth, always refetch from disk (it's fast)\n // - Supabase: Use normal React Query caching to avoid unnecessary network requests\n const query = useQuery({\n queryKey,\n queryFn,\n enabled: enabled && adapter !== null,\n staleTime,\n gcTime,\n refetchOnWindowFocus,\n refetchOnMount\n });\n\n // Create debounced invalidation function for subscriptions\n const invalidateTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n const debouncedInvalidate = useCallback(() => {\n if (invalidateTimeoutRef.current) {\n clearTimeout(invalidateTimeoutRef.current);\n }\n invalidateTimeoutRef.current = setTimeout(() => {\n queryClient.invalidateQueries({\n queryKey\n });\n }, 100);\n }, [queryClient, queryKey]);\n\n // Clean up timeout on unmount\n useEffect(() => {\n return () => {\n if (invalidateTimeoutRef.current) {\n clearTimeout(invalidateTimeoutRef.current);\n }\n };\n }, []);\n\n // Set up real-time subscription if enabled\n useEffect(() => {\n // Resolve adapter lazily to get current backend\n let currentAdapter_0;\n try {\n currentAdapter_0 = registry.getAdapter(tableName);\n } catch {\n return; // Adapter not available yet\n }\n if (!realtime || !currentAdapter_0?.subscribe) {\n return;\n }\n\n // Only skip first callback for PowerSync adapter (which fires immediately with current data)\n // SupabaseAdapter's subscribe only fires on actual database changes\n // Use currentAdapter.name for the isFirstCallback check (survives minification)\n const isPowerSyncAdapter = currentAdapter_0.name === \"powersync\";\n let isFirstCallback = isPowerSyncAdapter;\n const unsubscribe = currentAdapter_0.subscribe(tableName, memoizedQueryOptions, data => {\n // Skip the first callback since initial query handles it\n if (isFirstCallback) {\n isFirstCallback = false;\n return;\n }\n\n // Check if query has relations (contains parentheses like \"Table(*)\")\n const hasRelations = memoizedQueryOptions.select?.includes(\"(\");\n if (hasRelations) {\n // Has relations - use debounced invalidation to prevent rapid successive invalidations\n debouncedInvalidate();\n } else {\n // No relations - safe to directly update cache with flat data\n queryClient.setQueryData(queryKey, {\n data,\n count: data.length\n });\n }\n });\n return () => {\n unsubscribe?.();\n };\n }, [realtime, registry, tableName, memoizedQueryOptions, queryClient, queryKey, debouncedInvalidate]);\n\n // Extract explicit FK relations for optimistic merge subscriptions\n const explicitFkRelations = useMemo<ExtractedExplicitFk[]>(() => {\n const select = memoizedQueryOptions.select;\n if (!select || !selectHasExplicitFkSyntax(select)) {\n return [];\n }\n const parsed = parseSelect(select);\n return extractExplicitFkRelations(parsed);\n }, [memoizedQueryOptions.select]);\n\n // Set up realtime subscriptions for explicit FK target tables\n // This enables optimistic merge when related records change\n useEffect(() => {\n // Skip if no explicit FK relations or realtime not enabled\n if (!realtime || explicitFkRelations.length === 0) {\n return;\n }\n\n // Resolve adapter lazily to get current backend\n let currentAdapter_1;\n try {\n currentAdapter_1 = registry.getAdapter(tableName);\n } catch {\n return; // Adapter not available yet\n }\n if (!currentAdapter_1?.subscribe) {\n return;\n }\n const isPowerSyncAdapter_0 = currentAdapter_1.name === \"powersync\";\n\n // Track unsubscribe functions for all related table watchers\n const unsubscribes: (() => void)[] = [];\n\n // Group relations by target table to avoid duplicate subscriptions\n const relationsByTable = new Map<string, ExtractedExplicitFk[]>();\n for (const relation of explicitFkRelations) {\n const existing = relationsByTable.get(relation.targetTable) ?? [];\n existing.push(relation);\n relationsByTable.set(relation.targetTable, existing);\n }\n\n // Set up a watcher for each unique target table\n for (const [targetTable, relations] of relationsByTable) {\n // Track if first callback (PowerSync fires immediately with current data)\n let isFirstCallback_0 = isPowerSyncAdapter_0;\n\n // Debounce timer for this table's updates\n let mergeTimeoutId: ReturnType<typeof setTimeout> | null = null;\n const unsubscribe_0 = currentAdapter_1.subscribe(targetTable, {\n select: \"*\"\n },\n // Watch all columns on the related table\n (changedRecords: Record<string, unknown>[]) => {\n // Skip the first callback since initial query handles it\n if (isFirstCallback_0) {\n isFirstCallback_0 = false;\n return;\n }\n\n // Debounce rapid updates during sync\n if (mergeTimeoutId) {\n clearTimeout(mergeTimeoutId);\n }\n mergeTimeoutId = setTimeout(() => {\n mergeTimeoutId = null;\n\n // Get current cached data\n const cachedResult = queryClient.getQueryData(queryKey) as {\n data?: Record<string, unknown>[];\n count?: number;\n } | undefined;\n if (!cachedResult?.data || cachedResult.data.length === 0) {\n // No cached data to merge into - trigger refetch instead\n debouncedInvalidate();\n return;\n }\n\n // Apply optimistic merge for each relation that uses this table\n let updatedData = cachedResult.data;\n let hasChanges = false;\n for (const relation_0 of relations) {\n const merged = mergeRelatedUpdate(updatedData, relation_0, changedRecords as {\n id: string;\n [key: string]: unknown;\n }[]);\n if (merged !== updatedData) {\n updatedData = merged;\n hasChanges = true;\n }\n }\n if (hasChanges) {\n // Update cache with merged data\n queryClient.setQueryData(queryKey, {\n data: updatedData,\n count: cachedResult.count\n });\n devLog(\"useDbQuery\", `${tableName}: Optimistic merge from ${targetTable} change`);\n }\n }, 50); // Small debounce to batch rapid changes\n });\n unsubscribes.push(() => {\n if (mergeTimeoutId) {\n clearTimeout(mergeTimeoutId);\n }\n unsubscribe_0?.();\n });\n }\n return () => {\n for (const unsubscribe_1 of unsubscribes) {\n unsubscribe_1();\n }\n };\n }, [realtime, registry, tableName, explicitFkRelations, queryClient, queryKey, debouncedInvalidate]);\n\n // Dev logging for debugging\n // Uses lastUsedAdapterNameRef to log the adapter that was ACTUALLY used for the query,\n // not the memoized adapter from render time (which may be stale due to auto-detection)\n useEffect(() => {\n const adapterName = lastUsedAdapterNameRef.current;\n\n // Log errors\n if (query.isError && query.error) {\n devWarn(\"useDbQuery\", `${tableName} via ${adapterName}: Error - ${query.error.message}`);\n }\n\n // Log empty results (only after successful fetch, not during loading)\n if (query.isSuccess && query.data?.data?.length === 0) {\n devLog(\"useDbQuery\", `${tableName} via ${adapterName}: 0 results`);\n }\n }, [query.isError, query.error, query.isSuccess, query.data, tableName]);\n\n // Build refetch function\n const refetch = useCallback(async () => {\n await query.refetch();\n }, [query]);\n return {\n data: query.data?.data as T[] | undefined,\n isLoading: query.isLoading,\n isPending: query.isPending,\n isFetching: query.isFetching,\n isRefetching: query.isFetching,\n // Alias for V2 compatibility\n isSuccess: query.isSuccess,\n isError: query.isError,\n error: query.error as Error | null,\n refetch,\n count: query.data?.count,\n isStale: query.isStale,\n dataUpdatedAt: query.dataUpdatedAt ?? null\n };\n}\nexport default useDbQuery;","/**\n * Development-only logging utility for V3 hooks\n *\n * Logs are only output when __DEV__ is true (development builds).\n * In production builds, these calls are no-ops.\n */\n\ndeclare const __DEV__: boolean;\n\n/**\n * Log a message with a prefix, only in development\n *\n * @param prefix - Hook or component name (e.g., \"useDbQuery\")\n * @param message - Message to log\n *\n * @example\n * devLog(\"useDbQuery\", \"EquipmentUnit via PowerSync: 0 results\");\n * // Output: [useDbQuery] EquipmentUnit via PowerSync: 0 results\n */\nexport function devLog(prefix: string, message: string): void {\n if (typeof __DEV__ !== \"undefined\" && __DEV__) {\n console.log(`[${prefix}] ${message}`);\n }\n}\n\n/**\n * Log a warning with a prefix, only in development\n */\nexport function devWarn(prefix: string, message: string): void {\n if (typeof __DEV__ !== \"undefined\" && __DEV__) {\n console.warn(`[${prefix}] ${message}`);\n }\n}\n\n/**\n * Log an error with a prefix, only in development\n */\nexport function devError(prefix: string, message: string, error?: unknown): void {\n if (typeof __DEV__ !== \"undefined\" && __DEV__) {\n if (error) {\n console.error(`[${prefix}] ${message}`, error);\n } else {\n console.error(`[${prefix}] ${message}`);\n }\n }\n}","/**\n * V3 useDbQueryById Hook\n *\n * React hook for querying a single record by ID from a table.\n * Works identically whether PowerSync or Supabase is the backend.\n * Uses React Query for state management and caching.\n */\n\nimport { useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport { useDataLayerCore } from \"./useDataLayer\";\nimport type { WhereClause } from \"../core/types\";\nimport { devLog, devWarn } from \"../utils/dev-log\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Options for useDbQueryById hook\n */\nexport interface UseDbQueryByIdOptions {\n /** Columns to select (Supabase-style select string) */\n select?: string;\n /** Whether the query is enabled (default: true if id is provided) */\n enabled?: boolean;\n /** React Query stale time in ms (default: 30000) */\n staleTime?: number;\n}\n\n/**\n * Result from useDbQueryById hook\n */\nexport interface UseDbQueryByIdResult<T> {\n /** Query data (undefined while loading, null if not found) */\n data: T | null | undefined;\n /** Whether query is loading (initial load) */\n isLoading: boolean;\n /** Whether query is in pending state */\n isPending: boolean;\n /** Whether query is currently fetching (including refetch) */\n isFetching: boolean;\n /** Query error if any */\n error: Error | null;\n /** Refetch the query */\n refetch: () => Promise<void>;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Build a query key for React Query\n *\n * Creates a stable, unique key for caching based on table, ID, and select.\n * Keys are namespaced with \"v3\" to avoid collisions with V2 queries.\n */\nfunction buildQueryKey(table: string, id: string | number | null | undefined, select?: string): unknown[] {\n return [\"v3\", \"queryById\", table, id, select ?? \"*\"];\n}\n\n// =============================================================================\n// Hook Implementation\n// =============================================================================\n\n/**\n * Hook for querying a single record by ID\n *\n * This hook provides a unified interface for fetching a single record that works\n * identically whether the backend is PowerSync (offline-first) or\n * Supabase (online-only). It uses React Query for caching and state management.\n *\n * Features:\n * - Automatic backend selection based on DataLayerProvider configuration\n * - React Query integration for caching, deduplication, and background updates\n * - Automatic disabling when ID is null/undefined\n * - Fallback to query with where clause if adapter doesn't support queryById\n * - Type-safe with generic type parameter\n *\n * @param table - The table name to query\n * @param id - The record ID (query is disabled if null/undefined)\n * @param options - Query options (select, enabled, staleTime)\n * @returns Query result with data, loading states, error, and refetch function\n *\n * @example\n * // Basic query by ID\n * const { data, isLoading, error } = useDbQueryById<Task>(\"Task\", taskId);\n *\n * @example\n * // Query with relations\n * const { data, isLoading, error } = useDbQueryById<Task>(\"Task\", taskId, {\n * select: \"*, Project(*), AssignedUser:User(*)\",\n * });\n *\n * @example\n * // Conditional query based on other state\n * const { data } = useDbQueryById<Project>(\"Project\", selectedProjectId, {\n * enabled: hasPermission && !!selectedProjectId,\n * });\n *\n * @example\n * // With custom stale time\n * const { data } = useDbQueryById<User>(\"User\", userId, {\n * staleTime: 60000, // 1 minute\n * });\n */\nexport function useDbQueryById<T = Record<string, unknown>>(table: string, id: string | number | null | undefined, options: UseDbQueryByIdOptions = {}): UseDbQueryByIdResult<T> {\n const {\n registry\n } = useDataLayerCore();\n const {\n select,\n enabled = id != null,\n staleTime = 30000\n } = options;\n\n // Get adapter for this table\n // No isInitialized check needed - if we get here, core context exists = initialized\n const adapter = useMemo(() => {\n try {\n return registry.getAdapter(table);\n } catch (error) {\n devWarn(\"useDbQueryById\", `Failed to get adapter for ${table}: ${(error as Error).message}`);\n return null;\n }\n }, [registry, table]);\n\n // Build query key - memoized to prevent unnecessary re-renders\n const queryKey = useMemo(() => buildQueryKey(table, id, select), [table, id, select]);\n\n // Track the adapter name that was actually used for the most recent query\n // This is used for accurate logging since the memoized adapter may be stale\n const lastUsedAdapterNameRef = useRef<string>(\"unknown\");\n\n // Query function - resolve adapter lazily at query time to ensure we always\n // have the latest adapter instance (the memoized adapter may be stale)\n const queryFn = useCallback(async (): Promise<T | null> => {\n if (id == null) {\n return null;\n }\n\n // Use currentAdapter directly - registry.getAdapter() throws if unavailable\n const currentAdapter = registry.getAdapter(table);\n\n // Track which adapter was actually used for accurate logging\n lastUsedAdapterNameRef.current = currentAdapter.name;\n\n // Use queryById if available, otherwise fall back to query with where\n if (currentAdapter.queryById) {\n return currentAdapter.queryById<T>(table, String(id), {\n select\n });\n }\n\n // Fallback: use query with where clause\n const result = await currentAdapter.query<T>(table, {\n select,\n where: {\n id\n } as WhereClause,\n limit: 1\n });\n return result.data[0] ?? null;\n }, [registry, table, id, select]);\n\n // Execute query with React Query\n const query = useQuery({\n queryKey,\n queryFn,\n enabled: enabled && adapter !== null && id != null,\n staleTime\n });\n\n // Dev logging for debugging\n // Uses lastUsedAdapterNameRef to log the adapter that was ACTUALLY used for the query,\n // not the memoized adapter from render time (which may be stale due to auto-detection)\n useEffect(() => {\n const adapterName = lastUsedAdapterNameRef.current;\n\n // Log errors\n if (query.isError && query.error) {\n devWarn(\"useDbQueryById\", `${table}(${id}) via ${adapterName}: Error - ${query.error.message}`);\n }\n\n // Log not found (only after successful fetch, not during loading)\n if (query.isSuccess && query.data === null) {\n devLog(\"useDbQueryById\", `${table}(${id}) via ${adapterName}: not found`);\n }\n }, [query.isError, query.error, query.isSuccess, query.data, table, id]);\n\n // Build refetch function\n const refetch = useCallback(async () => {\n await query.refetch();\n }, [query]);\n return {\n data: query.data,\n isLoading: query.isLoading,\n isPending: query.isPending,\n isFetching: query.isFetching,\n error: query.error as Error | null,\n refetch\n };\n}\nexport default useDbQueryById;"],"mappings":"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","names":["useCallback","useEffect","useMemo","useRef","useQuery","buildQueryKey","useMemo","useRef","useCallback","useQuery","useEffect"]}