@pol-studios/db 1.0.54 → 1.0.56

package/dist/core/index.d.ts

@@ -535,6 +535,23 @@ interface SelectColumn {
     /** Optional alias for the column */
     alias?: string;
 }
+/**
+ * Explicit FK specification for cross-schema relations without database FK constraints.
+ * Allows specifying the join relationship directly in the select string.
+ *
+ * @example
+ * // Syntax: Alias!sourceField:targetTable(columns)
+ * "Sender!senderId:core.Profile(*)"
+ * // explicitFk: { sourceField: "senderId", targetTable: "core.Profile", targetColumn: "id" }
+ */
+interface ExplicitFkSpec {
+    /** FK column on the parent table (e.g., "senderId") */
+    sourceField: string;
+    /** Table to query, optionally schema-qualified (e.g., "core.Profile") */
+    targetTable: string;
+    /** Column to match in target table, defaults to "id" */
+    targetColumn?: string;
+}
 /**
  * A relation in a parsed select statement (e.g., RelatedTable(*))
  */
@@ -547,6 +564,12 @@ interface SelectRelation {
     columns: "*" | SelectColumn[];
     /** Nested relations within this relation */
     relations: SelectRelation[];
+    /**
+     * Explicit FK specification for cross-schema relations.
+     * When present, the relationship is built directly from this spec
+     * instead of looking it up in the database schema.
+     */
+    explicitFk?: ExplicitFkSpec;
 }
 /**
  * Complete parsed select statement AST
@@ -588,4 +611,4 @@ interface BuiltQuery {
     params: (string | number | boolean | null)[];
 }
 
-export type { AdapterRegistry, AutoStrategy, BuiltQuery, CachedStrategy, ColumnInfo, ColumnType, ConnectionConfig, DataAdapter, DataLayerConfig, DataLayerHooks, DatabaseSchema, DeleteMutationResult, ExtractInsert, ExtractRow, ExtractUpdate, HybridStrategy, MutationHookResult, MutationResult, OrderBy, ParsedSelect, PowerSyncStrategy, QueryOptions, QueryResult, QuerySingleResult, RelationshipInfo, RelationshipType, ResolvedRelationship, ScopeDefinition, SelectColumn, SelectRelation, SupabaseStrategy, SyncControl, SyncSchedule, SyncScope, SyncStatus, TableNames, TableSchema, TableStrategy, UseDbMutationHook, UseDbQueryByIdHook, UseDbQueryHook, WhereClause, WhereOperators };
+export type { AdapterRegistry, AutoStrategy, BuiltQuery, CachedStrategy, ColumnInfo, ColumnType, ConnectionConfig, DataAdapter, DataLayerConfig, DataLayerHooks, DatabaseSchema, DeleteMutationResult, ExplicitFkSpec, ExtractInsert, ExtractRow, ExtractUpdate, HybridStrategy, MutationHookResult, MutationResult, OrderBy, ParsedSelect, PowerSyncStrategy, QueryOptions, QueryResult, QuerySingleResult, RelationshipInfo, RelationshipType, ResolvedRelationship, ScopeDefinition, SelectColumn, SelectRelation, SupabaseStrategy, SyncControl, SyncSchedule, SyncScope, SyncStatus, TableNames, TableSchema, TableStrategy, UseDbMutationHook, UseDbQueryByIdHook, UseDbQueryHook, WhereClause, WhereOperators };

package/dist/{executor-YJw4m7Q7.d.ts → executor-D15yjeMo.d.ts}

@@ -495,6 +495,25 @@ declare class QueryExecutor {
      * @returns Parent records with relations attached
      */
     private queryAndJoinRelations;
+    /**
+     * Build a ResolvedRelationship from an explicit FK specification.
+     * This bypasses schema lookup and constructs the relationship directly.
+     *
+     * @param parentTable - The parent table name
+     * @param relation - The relation with explicitFk specification
+     * @returns ResolvedRelationship for the explicit FK
+     */
+    private buildExplicitFkRelationship;
+    /**
+     * Extract the table name from a potentially schema-qualified identifier.
+     * For PowerSync, tables are flattened to a single namespace, so we need
+     * to handle both "core.Profile" -> "CoreProfile" (PowerSync alias) and
+     * simple table names.
+     *
+     * @param qualifiedName - Table name, optionally schema-qualified (e.g., "core.Profile")
+     * @returns The table name to use in queries
+     */
+    private getTableNameFromQualified;
     /**
      * Get parent IDs needed for a relation query.
      */
@@ -517,6 +536,7 @@ declare class QueryExecutor {
     getJoiner(): ResultJoiner;
     /**
      * Resolve a relationship with caching.
+     * Uses true LRU eviction: accessed items are moved to the end of the Map.
      *
      * @param fromTable - The source table
      * @param toTable - The target table/relation name

package/dist/hooks/index.d.ts

@@ -1,10 +1,10 @@
-export { C as ClarificationQuestion, D as DatabaseTypes, F as Filter, x as FilterGroup, y as FilterOperator, z as Pagination, P as PublicTableNames, Q as QueryState, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, A as Sort, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, K as UseDbDeleteOptions, L as UseDbDeleteResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, B as UseDbInsertOptions, E as UseDbInsertResult, v as UseDbQueryByIdOptions, w as UseDbQueryByIdResult, s as UseDbQueryOptions, t as UseDbQueryResult, G as UseDbUpdateOptions, H as UseDbUpdateResult, I as UseDbUpsertOptions, J as UseDbUpsertResult, u as useAdvanceQuery, a as useDataLayer, b as useDataLayerCore, M as useDataLayerCoreOptional, c as useDataLayerOptional, d as useDataLayerStatus, e as useDbCount, f as useDbDelete, g as useDbInfiniteQuery, h as useDbInsert, i as useDbQuery, j as useDbQueryById, k as useDbUpdate, l as useDbUpsert } from '../useDbCount-DHLJzmkO.js';
+export { C as ClarificationQuestion, D as DatabaseTypes, F as Filter, x as FilterGroup, y as FilterOperator, z as Pagination, P as PublicTableNames, Q as QueryState, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, A as Sort, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, K as UseDbDeleteOptions, L as UseDbDeleteResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, B as UseDbInsertOptions, E as UseDbInsertResult, v as UseDbQueryByIdOptions, w as UseDbQueryByIdResult, s as UseDbQueryOptions, t as UseDbQueryResult, G as UseDbUpdateOptions, H as UseDbUpdateResult, I as UseDbUpsertOptions, J as UseDbUpsertResult, u as useAdvanceQuery, a as useDataLayer, b as useDataLayerCore, M as useDataLayerCoreOptional, c as useDataLayerOptional, d as useDataLayerStatus, e as useDbCount, f as useDbDelete, g as useDbInfiniteQuery, h as useDbInsert, i as useDbQuery, j as useDbQueryById, k as useDbUpdate, l as useDbUpsert } from '../useDbCount-Ckb-FhZk.js';
 import { SyncStatus, SyncControl } from '../core/index.js';
-import '../DataLayerContext-C7cJtiO8.js';
+import '../DataLayerContext-BYZtDD0g.js';
 import 'react';
 import '@supabase/supabase-js';
 import '@tanstack/react-query';
-import '../executor-YJw4m7Q7.js';
+import '../executor-D15yjeMo.js';
 
 /**
  * V3 useSyncStatus Hook

package/dist/hooks/index.js

@@ -9,7 +9,7 @@ import {
   useOnlineStatus,
   useSyncControl,
   useSyncStatus
-} from "../chunk-3Q74DK5K.js";
+} from "../chunk-VYFAMTHI.js";
 import {
   useDataLayer,
   useDataLayerCore,
@@ -18,8 +18,10 @@ import {
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "../chunk-WQLIGVQR.js";
+} from "../chunk-GWYTROSD.js";
 import "../chunk-GC3TBUWE.js";
+import "../chunk-W7PERM66.js";
+import "../chunk-QYAFI34Q.js";
 import "../chunk-J4ZVCXZ4.js";
 import "../chunk-DMVUEJG2.js";
 import "../chunk-7D4SUZUM.js";

package/dist/{index-jVYdTeWx.d.ts → index-CFUuTzXO.d.ts}

@@ -5,7 +5,7 @@ import { PostgrestSingleResponse, SupabaseClient } from '@supabase/supabase-js';
 import { Dispatch, SetStateAction } from 'react';
 import { UseQueryOptions, DefinedUseQueryResult, QueryClient } from '@tanstack/react-query';
 import { SyncControl, SyncStatus, DataLayerConfig } from './core/index.js';
-import { u as DataLayerStatus, r as DataLayerContextValue } from './DataLayerContext-C7cJtiO8.js';
+import { u as DataLayerStatus, r as DataLayerContextValue } from './DataLayerContext-BYZtDD0g.js';
 
 /**
  * Represents a change log entry for database records.

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { C as CompositeTypes, c as Constants, D as Database, E as Enums, J as Json, T as Tables, a as TablesInsert, b as TablesUpdate } from './database.types-ChFCG-4M.js';
 export { a as FilterConfig, F as FilterConfigOption, G as Group, P as PropertyType, S as SortConfig, T as TableInfo, V as ValueForPropertyType, W as WhereFilter } from './FilterConfig-Bt2Ek74z.js';
-export { r as BackendSelectionResult, B as BooleanOperator, l as ClarificationQuestion, k as ClarificationSuggestion, C as CombinedProviderStatus, j as ComputedSortConfig, n as DataLayerWithPowerSyncProps, D as DbChangeLog, E as EnhancedSyncControl, a as EnhancedSyncStatus, e as Filter, d as FilterConditionType, m as FilterContextType, f as FilterGroup, g as FilterInput, F as FilterOperator, h as FilterState, H as HasPowerSyncConfig, O as OrderColumn, i as Pagination, P as PowerSyncEnabledConfig, b as PowerSyncEnabledContextValue, q as PowerSyncTables, Q as QueryState, S as Sort, U as UseDataLayerWithPowerSync, p as UseSyncControlWithPowerSync, o as UseSyncStatusWithPowerSync, V as ValueOrArrayForPropertyType, c as createCombinedStatus } from './index-jVYdTeWx.js';
-export { y as AIOptions, z as AIResponse, P as AlertProps, A as AttachmentQueueProvider, I as BUCKETS, J as BucketName, H as CustomPageQueryResult, L as DEFAULT_QUERY_TIMEOUT, a9 as FeedbackListItem, aa as FeedbackListParams, Q as LiveChangeContext, R as LiveChangeContextProvider, C as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, ac as SubmitFeedbackParams, v as SupabaseAdapter, T as TIMEOUT_ERROR_MESSAGE, F as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, N as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, O as convertFilterToRealtimeQuery, K as createInCondition, w as createSupabaseAdapter, G as executeAdvanceQuery, x as getErrorBody, g as getStorageUrl, p as getSupabaseUrl, M as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, B as useAI, ad as useApplyFeedback, c as useAutosave, b as useAutosaveState, a4 as useChangelogById, a5 as useChangelogBySlug, a6 as useChangelogEntries, a7 as useChangelogMedia, a2 as useChangelogs, o as useDbRealtimeQuery, W as useDeleteChangelog, Z as useDeleteChangelogEntry, a0 as useDeleteChangelogMedia, a8 as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, _ as useMultiDeleteChangelogEntries, Y as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, a3 as usePublishedChangelogs, o as useRealtimeQuery, ae as useResolveFeedback, E as useSearchQuery, D as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ab as useSubmitFeedback, e as useToastError, a1 as useUploadChangelogMedia, V as useUpsertChangelog, X as useUpsertChangelogEntry, $ as useUpsertChangelogMedia } from './useResolveFeedback-B0UcYWVI.js';
+export { r as BackendSelectionResult, B as BooleanOperator, l as ClarificationQuestion, k as ClarificationSuggestion, C as CombinedProviderStatus, j as ComputedSortConfig, n as DataLayerWithPowerSyncProps, D as DbChangeLog, E as EnhancedSyncControl, a as EnhancedSyncStatus, e as Filter, d as FilterConditionType, m as FilterContextType, f as FilterGroup, g as FilterInput, F as FilterOperator, h as FilterState, H as HasPowerSyncConfig, O as OrderColumn, i as Pagination, P as PowerSyncEnabledConfig, b as PowerSyncEnabledContextValue, q as PowerSyncTables, Q as QueryState, S as Sort, U as UseDataLayerWithPowerSync, p as UseSyncControlWithPowerSync, o as UseSyncStatusWithPowerSync, V as ValueOrArrayForPropertyType, c as createCombinedStatus } from './index-CFUuTzXO.js';
+export { y as AIOptions, z as AIResponse, P as AlertProps, A as AttachmentQueueProvider, I as BUCKETS, J as BucketName, H as CustomPageQueryResult, L as DEFAULT_QUERY_TIMEOUT, a9 as FeedbackListItem, aa as FeedbackListParams, Q as LiveChangeContext, R as LiveChangeContextProvider, C as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, ac as SubmitFeedbackParams, v as SupabaseAdapter, T as TIMEOUT_ERROR_MESSAGE, F as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, N as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, O as convertFilterToRealtimeQuery, K as createInCondition, w as createSupabaseAdapter, G as executeAdvanceQuery, x as getErrorBody, g as getStorageUrl, p as getSupabaseUrl, M as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, B as useAI, ad as useApplyFeedback, c as useAutosave, b as useAutosaveState, a4 as useChangelogById, a5 as useChangelogBySlug, a6 as useChangelogEntries, a7 as useChangelogMedia, a2 as useChangelogs, o as useDbRealtimeQuery, W as useDeleteChangelog, Z as useDeleteChangelogEntry, a0 as useDeleteChangelogMedia, a8 as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, _ as useMultiDeleteChangelogEntries, Y as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, a3 as usePublishedChangelogs, o as useRealtimeQuery, ae as useResolveFeedback, E as useSearchQuery, D as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ab as useSubmitFeedback, e as useToastError, a1 as useUploadChangelogMedia, V as useUpsertChangelog, X as useUpsertChangelogEntry, $ as useUpsertChangelogMedia } from './useResolveFeedback-CuUkdHoR.js';
 export { u as useBatchDelete, a as useBatchUpsert } from './useBatchUpsert-DAkiCNo3.js';
 export { AdapterRegistry as AdapterRegistryInterface, AutoStrategy, BuiltQuery, CachedStrategy, ColumnInfo, ColumnType, ConnectionConfig, DataAdapter, DataLayerConfig, DataLayerHooks, DatabaseSchema, DeleteMutationResult, ExtractInsert, ExtractRow, ExtractUpdate, HybridStrategy, MutationHookResult, MutationResult, OrderBy, ParsedSelect, PowerSyncStrategy, QueryOptions, QueryResult, QuerySingleResult, RelationshipInfo, RelationshipType, ResolvedRelationship, ScopeDefinition, SelectColumn, SelectRelation, SupabaseStrategy, SyncControl, SyncSchedule, SyncScope, SyncStatus, TableNames, TableSchema, TableStrategy, UseDbMutationHook, UseDbQueryByIdHook, UseDbQueryHook, WhereClause, WhereOperators } from './core/index.js';
-export { f as ADAPTER_STRATEGIES, i as AdapterAutoDetector, c as AdapterCapabilities, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, A as AdapterQueryResult, g as AdapterRegistry, e as AdapterStrategyType, k as AutoDetectionResult, l as AutoDetectorOptions, m as BackendChangeListener, B as BackendStatus, C as CapableDataAdapter, D as DataLayerContext, r as DataLayerContextValue, p as DataLayerCoreContext, s as DataLayerCoreContextValue, u as DataLayerStatus, q as DataLayerStatusContext, t as DataLayerStatusContextValue, S as SyncStatusInfo, o as SyncTracker, n as SyncTrackingAdapter, T as TableDataAdapter, j as createAdapterAutoDetector, h as createAdapterRegistry } from './DataLayerContext-C7cJtiO8.js';
+export { f as ADAPTER_STRATEGIES, i as AdapterAutoDetector, c as AdapterCapabilities, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, A as AdapterQueryResult, g as AdapterRegistry, e as AdapterStrategyType, k as AutoDetectionResult, l as AutoDetectorOptions, m as BackendChangeListener, B as BackendStatus, C as CapableDataAdapter, D as DataLayerContext, r as DataLayerContextValue, p as DataLayerCoreContext, s as DataLayerCoreContextValue, u as DataLayerStatus, q as DataLayerStatusContext, t as DataLayerStatusContextValue, S as SyncStatusInfo, o as SyncTracker, n as SyncTrackingAdapter, T as TableDataAdapter, j as createAdapterAutoDetector, h as createAdapterRegistry } from './DataLayerContext-BYZtDD0g.js';
 export { ConflictCheckResult, ConflictContext, ConflictContextValue, ConflictProvider, ConflictProviderProps, ConflictResolution, DataLayerProvider, DataLayerProviderProps, FieldConflict, PowerSyncAdapter, UseConflictResolutionReturn, UseSupabaseUploadOptions, UseSupabaseUploadReturn, createPowerSyncAdapter, useBulkConflictResolution, useConflictCountByTable, useConflictForRecord, useConflictResolution, useConflictState, useConflictsForTable, useHasConflicts, usePendingConflicts, useSupabaseUpload } from './index.native.js';
-export { D as DatabaseTypes, P as PublicTableNames, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, s as UseDbQueryOptions, t as UseDbQueryResult, u as useAdvanceQuery, a as useDataLayer, b as useDataLayerCore, c as useDataLayerOptional, d as useDataLayerStatus, e as useDbCount, e as useDbCountV3, f as useDbDelete, g as useDbInfiniteQuery, g as useDbInfiniteQueryV3, h as useDbInsert, i as useDbQuery, j as useDbQueryById, k as useDbUpdate, l as useDbUpsert } from './useDbCount-DHLJzmkO.js';
+export { D as DatabaseTypes, P as PublicTableNames, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, s as UseDbQueryOptions, t as UseDbQueryResult, u as useAdvanceQuery, a as useDataLayer, b as useDataLayerCore, c as useDataLayerOptional, d as useDataLayerStatus, e as useDbCount, e as useDbCountV3, f as useDbDelete, g as useDbInfiniteQuery, g as useDbInfiniteQueryV3, h as useDbInsert, i as useDbQuery, j as useDbQueryById, k as useDbUpdate, l as useDbUpsert } from './useDbCount-Ckb-FhZk.js';
 export { useOnlineStatus, useSyncControl, useSyncStatus } from './hooks/index.js';
 export { C as ClientInstanceId, S as SupabaseDatabaseTypes, a as SupabaseProvider, T as TypedSupabaseClient, U as UserSessionId, c as createNewSupabaseClient, u as default, o as onSupabaseInitialized, s as setDefaultOptions, t as typedSupabase, u as useSupabase } from './useSupabase-DSZNeXnF.js';
 export { B as BatchAnalysisProgress, E as ExtractedReceipt, P as PendingExpense, a as useReceiptAI, u as useSupabaseFunction } from './useReceiptAI-6HkRpRml.js';
@@ -27,7 +27,7 @@ import '@pol-studios/utils';
 import '@supabase-cache-helpers/postgrest-react-query';
 import 'react/jsx-runtime';
 import '@supabase/storage-js';
-import './executor-YJw4m7Q7.js';
+import './executor-D15yjeMo.js';
 import 'react-dropzone';
 import '@supabase/supabase-js/dist/module/lib/types.js';
 

package/dist/index.js

@@ -24,7 +24,7 @@ import {
   useHasConflicts,
   usePendingConflicts,
   useSupabaseUpload
-} from "./chunk-BZSAPFFB.js";
+} from "./chunk-N4KK5G5T.js";
 import {
   ADAPTER_STRATEGIES,
   AdapterAutoDetector,
@@ -77,7 +77,7 @@ import {
   useUpsertChangelog,
   useUpsertChangelogEntry,
   useUpsertChangelogMedia
-} from "./chunk-2XS2PM62.js";
+} from "./chunk-DDL63KLQ.js";
 import {
   LiveChangeContext,
   LiveChangeContextProvider,
@@ -88,7 +88,7 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "./chunk-FIAXWEBK.js";
+} from "./chunk-4EO55YV2.js";
 import {
   PostgrestFilter,
   binarySearch,
@@ -116,7 +116,7 @@ import {
   removeAliasFromDeclaration,
   removeFirstPathElement,
   setFilterValue
-} from "./chunk-YA6MUTA7.js";
+} from "./chunk-FI6JAD5G.js";
 import {
   useAdvanceQuery,
   useDbCount,
@@ -128,11 +128,11 @@ import {
   useOnlineStatus,
   useSyncControl,
   useSyncStatus
-} from "./chunk-3Q74DK5K.js";
+} from "./chunk-VYFAMTHI.js";
 import {
   Constants,
   createCombinedStatus
-} from "./chunk-Z3EJX3VG.js";
+} from "./chunk-Z456IHCB.js";
 import {
   Accessory,
   Address,
@@ -321,12 +321,12 @@ import {
   UserMetadata
 } from "./chunk-SM73S2DY.js";
 import "./chunk-NSIAAYW3.js";
-import "./chunk-FMYXG4VN.js";
+import "./chunk-MEBT5YHA.js";
 import {
   DEFAULT_QUERY_TIMEOUT,
   TIMEOUT_ERROR_MESSAGE,
   isTimeoutError
-} from "./chunk-DP3YEVSX.js";
+} from "./chunk-6SDH7M7J.js";
 import {
   DataLayerContext,
   DataLayerCoreContext,
@@ -337,17 +337,19 @@ import {
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "./chunk-WQLIGVQR.js";
+} from "./chunk-GWYTROSD.js";
 import "./chunk-RT4O5H2E.js";
-import "./chunk-HZIVE5AZ.js";
+import "./chunk-YRIPM2AN.js";
 import {
   getSupabaseUrl,
   setSupabaseUrl
 } from "./chunk-GC3TBUWE.js";
+import "./chunk-W7PERM66.js";
 import {
   useBatchDelete,
   useBatchUpsert
-} from "./chunk-ZGQ7Q4ZU.js";
+} from "./chunk-WM25QE7E.js";
+import "./chunk-QYAFI34Q.js";
 import {
   OPERATOR_MAP,
   PostgrestParser,
@@ -361,10 +363,10 @@ import {
   parseSelectParam,
   parseValue,
   sortSearchParams
-} from "./chunk-UJWETW36.js";
+} from "./chunk-JOULSXOI.js";
 import "./chunk-J4ZVCXZ4.js";
-import "./chunk-CTRY7JDP.js";
-import "./chunk-INEUG6MC.js";
+import "./chunk-YUX6RGLZ.js";
+import "./chunk-AKIRHA4Q.js";
 import {
   ClientInstanceId,
   SupabaseProvider,

package/dist/index.native.d.ts

@@ -1,15 +1,15 @@
 export { C as CompositeTypes, c as Constants, D as Database, E as Enums, J as Json, T as Tables, a as TablesInsert, b as TablesUpdate } from './database.types-ChFCG-4M.js';
 export { a as FilterConfig, F as FilterConfigOption, G as Group, P as PropertyType, S as SortConfig, T as TableInfo, V as ValueForPropertyType, W as WhereFilter } from './FilterConfig-Bt2Ek74z.js';
-export { r as BackendSelectionResult, B as BooleanOperator, l as ClarificationQuestion, k as ClarificationSuggestion, C as CombinedProviderStatus, j as ComputedSortConfig, n as DataLayerWithPowerSyncProps, D as DbChangeLog, E as EnhancedSyncControl, a as EnhancedSyncStatus, e as Filter, d as FilterConditionType, m as FilterContextType, f as FilterGroup, g as FilterInput, F as FilterOperator, h as FilterState, H as HasPowerSyncConfig, O as OrderColumn, i as Pagination, P as PowerSyncEnabledConfig, b as PowerSyncEnabledContextValue, q as PowerSyncTables, Q as QueryState, S as Sort, U as UseDataLayerWithPowerSync, p as UseSyncControlWithPowerSync, o as UseSyncStatusWithPowerSync, V as ValueOrArrayForPropertyType, c as createCombinedStatus, u as useDbAdvanceFilterQuery } from './index-jVYdTeWx.js';
-export { y as AIOptions, z as AIResponse, P as AlertProps, A as AttachmentQueueProvider, I as BUCKETS, J as BucketName, H as CustomPageQueryResult, L as DEFAULT_QUERY_TIMEOUT, a9 as FeedbackListItem, aa as FeedbackListParams, Q as LiveChangeContext, R as LiveChangeContextProvider, C as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, ac as SubmitFeedbackParams, v as SupabaseAdapter, T as TIMEOUT_ERROR_MESSAGE, F as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, N as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, O as convertFilterToRealtimeQuery, K as createInCondition, w as createSupabaseAdapter, G as executeAdvanceQuery, x as getErrorBody, g as getStorageUrl, p as getSupabaseUrl, M as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, B as useAI, ad as useApplyFeedback, c as useAutosave, b as useAutosaveState, a4 as useChangelogById, a5 as useChangelogBySlug, a6 as useChangelogEntries, a7 as useChangelogMedia, a2 as useChangelogs, o as useDbRealtimeQuery, W as useDeleteChangelog, Z as useDeleteChangelogEntry, a0 as useDeleteChangelogMedia, a8 as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, _ as useMultiDeleteChangelogEntries, Y as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, a3 as usePublishedChangelogs, o as useRealtimeQuery, ae as useResolveFeedback, E as useSearchQuery, D as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ab as useSubmitFeedback, e as useToastError, a1 as useUploadChangelogMedia, V as useUpsertChangelog, X as useUpsertChangelogEntry, $ as useUpsertChangelogMedia } from './useResolveFeedback-B0UcYWVI.js';
-export { D as DatabaseTypes, P as PublicTableNames, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, s as UseDbQueryOptions, t as UseDbQueryResult, u as useAdvanceQuery, a as useDataLayer, b as useDataLayerCore, c as useDataLayerOptional, d as useDataLayerStatus, e as useDbCount, e as useDbCountV3, f as useDbDelete, f as useDbDeleteV3, g as useDbInfiniteQuery, g as useDbInfiniteQueryV3, h as useDbInsert, h as useDbInsertV3, i as useDbQuery, j as useDbQueryById, i as useDbQueryV3, k as useDbUpdate, k as useDbUpdateV3, l as useDbUpsert, l as useDbUpsertV3, l as useUpsert } from './useDbCount-DHLJzmkO.js';
+export { r as BackendSelectionResult, B as BooleanOperator, l as ClarificationQuestion, k as ClarificationSuggestion, C as CombinedProviderStatus, j as ComputedSortConfig, n as DataLayerWithPowerSyncProps, D as DbChangeLog, E as EnhancedSyncControl, a as EnhancedSyncStatus, e as Filter, d as FilterConditionType, m as FilterContextType, f as FilterGroup, g as FilterInput, F as FilterOperator, h as FilterState, H as HasPowerSyncConfig, O as OrderColumn, i as Pagination, P as PowerSyncEnabledConfig, b as PowerSyncEnabledContextValue, q as PowerSyncTables, Q as QueryState, S as Sort, U as UseDataLayerWithPowerSync, p as UseSyncControlWithPowerSync, o as UseSyncStatusWithPowerSync, V as ValueOrArrayForPropertyType, c as createCombinedStatus, u as useDbAdvanceFilterQuery } from './index-CFUuTzXO.js';
+export { y as AIOptions, z as AIResponse, P as AlertProps, A as AttachmentQueueProvider, I as BUCKETS, J as BucketName, H as CustomPageQueryResult, L as DEFAULT_QUERY_TIMEOUT, a9 as FeedbackListItem, aa as FeedbackListParams, Q as LiveChangeContext, R as LiveChangeContextProvider, C as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, ac as SubmitFeedbackParams, v as SupabaseAdapter, T as TIMEOUT_ERROR_MESSAGE, F as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, N as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, O as convertFilterToRealtimeQuery, K as createInCondition, w as createSupabaseAdapter, G as executeAdvanceQuery, x as getErrorBody, g as getStorageUrl, p as getSupabaseUrl, M as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, B as useAI, ad as useApplyFeedback, c as useAutosave, b as useAutosaveState, a4 as useChangelogById, a5 as useChangelogBySlug, a6 as useChangelogEntries, a7 as useChangelogMedia, a2 as useChangelogs, o as useDbRealtimeQuery, W as useDeleteChangelog, Z as useDeleteChangelogEntry, a0 as useDeleteChangelogMedia, a8 as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, _ as useMultiDeleteChangelogEntries, Y as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, a3 as usePublishedChangelogs, o as useRealtimeQuery, ae as useResolveFeedback, E as useSearchQuery, D as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ab as useSubmitFeedback, e as useToastError, a1 as useUploadChangelogMedia, V as useUpsertChangelog, X as useUpsertChangelogEntry, $ as useUpsertChangelogMedia } from './useResolveFeedback-CuUkdHoR.js';
+export { D as DatabaseTypes, P as PublicTableNames, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, s as UseDbQueryOptions, t as UseDbQueryResult, u as useAdvanceQuery, a as useDataLayer, b as useDataLayerCore, c as useDataLayerOptional, d as useDataLayerStatus, e as useDbCount, e as useDbCountV3, f as useDbDelete, f as useDbDeleteV3, g as useDbInfiniteQuery, g as useDbInfiniteQueryV3, h as useDbInsert, h as useDbInsertV3, i as useDbQuery, j as useDbQueryById, i as useDbQueryV3, k as useDbUpdate, k as useDbUpdateV3, l as useDbUpsert, l as useDbUpsertV3, l as useUpsert } from './useDbCount-Ckb-FhZk.js';
 export { useOnlineStatus, useSyncControl, useSyncStatus } from './hooks/index.js';
 export { u as useBatchDelete, a as useBatchUpsert } from './useBatchUpsert-DAkiCNo3.js';
 import { DatabaseSchema, QueryOptions, DataLayerConfig, SyncControl } from './core/index.js';
 export { AdapterRegistry as AdapterRegistryInterface, AutoStrategy, BuiltQuery, CachedStrategy, ColumnInfo, ColumnType, ConnectionConfig, DataAdapter, DataLayerHooks, DeleteMutationResult, ExtractInsert, ExtractRow, ExtractUpdate, HybridStrategy, MutationHookResult, MutationResult, OrderBy, ParsedSelect, PowerSyncStrategy, QueryResult, QuerySingleResult, RelationshipInfo, RelationshipType, ResolvedRelationship, ScopeDefinition, SelectColumn, SelectRelation, SupabaseStrategy, SyncSchedule, SyncScope, SyncStatus, TableNames, TableSchema, TableStrategy, UseDbMutationHook, UseDbQueryByIdHook, UseDbQueryHook, WhereClause, WhereOperators } from './core/index.js';
-import { T as TableDataAdapter, C as CapableDataAdapter, c as AdapterCapabilities, A as AdapterQueryResult, r as DataLayerContextValue, S as SyncStatusInfo } from './DataLayerContext-C7cJtiO8.js';
-export { f as ADAPTER_STRATEGIES, i as AdapterAutoDetector, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, g as AdapterRegistry, e as AdapterStrategyType, k as AutoDetectionResult, l as AutoDetectorOptions, m as BackendChangeListener, B as BackendStatus, D as DataLayerContext, p as DataLayerCoreContext, s as DataLayerCoreContextValue, u as DataLayerStatus, q as DataLayerStatusContext, t as DataLayerStatusContextValue, o as SyncTracker, n as SyncTrackingAdapter, j as createAdapterAutoDetector, h as createAdapterRegistry } from './DataLayerContext-C7cJtiO8.js';
-import { Q as QueryExecutor, P as PowerSyncDatabase$1 } from './executor-YJw4m7Q7.js';
+import { T as TableDataAdapter, C as CapableDataAdapter, c as AdapterCapabilities, A as AdapterQueryResult, r as DataLayerContextValue, S as SyncStatusInfo } from './DataLayerContext-BYZtDD0g.js';
+export { f as ADAPTER_STRATEGIES, i as AdapterAutoDetector, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, g as AdapterRegistry, e as AdapterStrategyType, k as AutoDetectionResult, l as AutoDetectorOptions, m as BackendChangeListener, B as BackendStatus, D as DataLayerContext, p as DataLayerCoreContext, s as DataLayerCoreContextValue, u as DataLayerStatus, q as DataLayerStatusContext, t as DataLayerStatusContextValue, o as SyncTracker, n as SyncTrackingAdapter, j as createAdapterAutoDetector, h as createAdapterRegistry } from './DataLayerContext-BYZtDD0g.js';
+import { Q as QueryExecutor, P as PowerSyncDatabase$1 } from './executor-D15yjeMo.js';
 import * as react from 'react';
 import react__default, { ReactNode, JSX } from 'react';
 import { SupabaseClient } from '@supabase/supabase-js';
@@ -106,6 +106,21 @@ interface PowerSyncDatabase {
  * Used to map schema-qualified names like "core.Profile" to aliases like "CoreProfile".
  */
 type TableNameResolver = (table: string) => string;
+/**
+ * Configuration options for the PowerSyncAdapter.
+ */
+interface PowerSyncAdapterOptions {
+    /**
+     * Optional custom resolver for table names to PowerSync aliases.
+     */
+    tableNameResolver?: TableNameResolver;
+    /**
+     * Maximum number of subscriptions to keep in the registry.
+     * When exceeded, the least recently used subscriptions are evicted.
+     * @default 100
+     */
+    maxSubscriptions?: number;
+}
 declare class PowerSyncAdapter implements TableDataAdapter, CapableDataAdapter {
     private db;
     private schema;
@@ -126,14 +141,36 @@ declare class PowerSyncAdapter implements TableDataAdapter, CapableDataAdapter {
      * If not provided, uses default auto-alias generation.
      */
     private tableNameResolver?;
+    /**
+     * Maximum number of subscriptions to keep in the registry.
+     */
+    private maxSubscriptions;
+    /**
+     * Subscription deduplication registry.
+     * Maps cache keys (table + serialized options) to shared subscription entries.
+     * This prevents duplicate PowerSync watch() calls when multiple components
+     * subscribe to the same query.
+     *
+     * Uses Map insertion order for LRU eviction - most recently accessed entries
+     * are moved to the end by deleting and re-adding.
+     */
+    private subscriptionRegistry;
     /**
      * Create a new PowerSyncAdapter
      *
      * @param db - PowerSync database instance
      * @param schema - Database schema for relationship resolution
-     * @param tableNameResolver - Optional custom resolver for table names to PowerSync aliases
+     * @param options - Optional configuration (tableNameResolver, maxSubscriptions)
+     */
+    constructor(db: PowerSyncDatabase, schema: DatabaseSchema, options?: TableNameResolver | PowerSyncAdapterOptions);
+    /**
+     * Move a subscription entry to the end of the Map for LRU tracking.
+     * The most recently accessed entries are at the end; oldest are at the start.
+     *
+     * @param key - The subscription cache key
+     * @param entry - The subscription entry to touch
      */
-    constructor(db: PowerSyncDatabase, schema: DatabaseSchema, tableNameResolver?: TableNameResolver);
+    private touchSubscription;
     /**
      * Resolve a table name to its PowerSync alias.
      * Schema-qualified names like "chat.Conversation" become "Conversation" (schema stripped).
@@ -160,12 +197,29 @@ declare class PowerSyncAdapter implements TableDataAdapter, CapableDataAdapter {
      * @returns Promise resolving to the record or null if not found
      */
     queryById<T>(table: string, id: string, options?: Pick<QueryOptions, "select">): Promise<T | null>;
+    /**
+     * Generate a unique cache key for subscription deduplication.
+     * Combines table name and serialized options to identify identical queries.
+     * Uses sorted keys to ensure consistent serialization regardless of property order.
+     *
+     * @param table - The table name
+     * @param options - Query options
+     * @returns A unique string key for the subscription registry
+     */
+    private generateSubscriptionKey;
     /**
      * Subscribe to changes on a query using PowerSync's native watch() API.
      *
      * This uses PowerSync's reactive query watching which efficiently detects
      * changes to the underlying data and re-executes the query only when needed.
      *
+     * Subscription Deduplication:
+     * Multiple components subscribing to the same query (same table + options)
+     * will share a single underlying PowerSync watch. This optimization:
+     * - Reduces database load by avoiding duplicate watches
+     * - Provides instant data to new subscribers from cached results
+     * - Properly cleans up when all subscribers unsubscribe
+     *
      * If the database doesn't support watch(), falls back to polling every 5 seconds.
      *
      * @param table - The table name to watch

package/dist/index.native.js

@@ -13,7 +13,7 @@ import {
   useHasConflicts,
   usePendingConflicts,
   useSupabaseUpload
-} from "./chunk-BZSAPFFB.js";
+} from "./chunk-N4KK5G5T.js";
 import {
   ADAPTER_STRATEGIES,
   AdapterAutoDetector,
@@ -65,7 +65,7 @@ import {
   useUpsertChangelog,
   useUpsertChangelogEntry,
   useUpsertChangelogMedia
-} from "./chunk-2XS2PM62.js";
+} from "./chunk-DDL63KLQ.js";
 import {
   LiveChangeContext,
   LiveChangeContextProvider,
@@ -76,7 +76,7 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "./chunk-FIAXWEBK.js";
+} from "./chunk-4EO55YV2.js";
 import {
   PostgrestFilter,
   binarySearch,
@@ -104,7 +104,7 @@ import {
   removeAliasFromDeclaration,
   removeFirstPathElement,
   setFilterValue
-} from "./chunk-YA6MUTA7.js";
+} from "./chunk-FI6JAD5G.js";
 import {
   useAdvanceQuery,
   useDbCount,
@@ -116,12 +116,12 @@ import {
   useOnlineStatus,
   useSyncControl,
   useSyncStatus
-} from "./chunk-3Q74DK5K.js";
+} from "./chunk-VYFAMTHI.js";
 import {
   Constants,
   createCombinedStatus,
   useDbAdvanceFilterQuery
-} from "./chunk-Z3EJX3VG.js";
+} from "./chunk-Z456IHCB.js";
 import {
   Accessory,
   Address,
@@ -310,12 +310,12 @@ import {
   UserMetadata
 } from "./chunk-SM73S2DY.js";
 import "./chunk-NSIAAYW3.js";
-import "./chunk-FMYXG4VN.js";
+import "./chunk-MEBT5YHA.js";
 import {
   DEFAULT_QUERY_TIMEOUT,
   TIMEOUT_ERROR_MESSAGE,
   isTimeoutError
-} from "./chunk-DP3YEVSX.js";
+} from "./chunk-6SDH7M7J.js";
 import {
   DataLayerContext,
   DataLayerCoreContext,
@@ -326,17 +326,19 @@ import {
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "./chunk-WQLIGVQR.js";
+} from "./chunk-GWYTROSD.js";
 import "./chunk-RT4O5H2E.js";
-import "./chunk-HZIVE5AZ.js";
+import "./chunk-YRIPM2AN.js";
 import {
   getSupabaseUrl,
   setSupabaseUrl
 } from "./chunk-GC3TBUWE.js";
+import "./chunk-W7PERM66.js";
 import {
   useBatchDelete,
   useBatchUpsert
-} from "./chunk-ZGQ7Q4ZU.js";
+} from "./chunk-WM25QE7E.js";
+import "./chunk-QYAFI34Q.js";
 import {
   OPERATOR_MAP,
   PostgrestParser,
@@ -350,10 +352,10 @@ import {
   parseSelectParam,
   parseValue,
   sortSearchParams
-} from "./chunk-UJWETW36.js";
+} from "./chunk-JOULSXOI.js";
 import "./chunk-J4ZVCXZ4.js";
-import "./chunk-CTRY7JDP.js";
-import "./chunk-INEUG6MC.js";
+import "./chunk-YUX6RGLZ.js";
+import "./chunk-AKIRHA4Q.js";
 import {
   ClientInstanceId,
   SupabaseProvider,

package/dist/index.web.d.ts

@@ -1,8 +1,8 @@
 export { C as CompositeTypes, c as Constants, D as Database, E as Enums, J as Json, T as Tables, a as TablesInsert, b as TablesUpdate } from './database.types-ChFCG-4M.js';
 export { a as FilterConfig, F as FilterConfigOption, G as Group, P as PropertyType, S as SortConfig, T as TableInfo, V as ValueForPropertyType, W as WhereFilter } from './FilterConfig-Bt2Ek74z.js';
-import { u as useDbAdvanceFilterQuery, Q as QueryState } from './index-jVYdTeWx.js';
-export { r as BackendSelectionResult, B as BooleanOperator, k as ClarificationSuggestion, C as CombinedProviderStatus, j as ComputedSortConfig, n as DataLayerWithPowerSyncProps, D as DbChangeLog, E as EnhancedSyncControl, a as EnhancedSyncStatus, d as FilterConditionType, m as FilterContextType, g as FilterInput, h as FilterState, H as HasPowerSyncConfig, O as OrderColumn, P as PowerSyncEnabledConfig, b as PowerSyncEnabledContextValue, q as PowerSyncTables, U as UseDataLayerWithPowerSync, p as UseSyncControlWithPowerSync, o as UseSyncStatusWithPowerSync, V as ValueOrArrayForPropertyType, c as createCombinedStatus, s as normalizeFilter } from './index-jVYdTeWx.js';
-export { y as AIOptions, z as AIResponse, P as AlertProps, A as AttachmentQueueProvider, I as BUCKETS, J as BucketName, H as CustomPageQueryResult, L as DEFAULT_QUERY_TIMEOUT, a9 as FeedbackListItem, aa as FeedbackListParams, Q as LiveChangeContext, R as LiveChangeContextProvider, C as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, ac as SubmitFeedbackParams, v as SupabaseAdapter, T as TIMEOUT_ERROR_MESSAGE, F as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, af as UseDbPartialQueryResult, N as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, O as convertFilterToRealtimeQuery, K as createInCondition, w as createSupabaseAdapter, G as executeAdvanceQuery, x as getErrorBody, g as getStorageUrl, p as getSupabaseUrl, M as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, B as useAI, ad as useApplyFeedback, c as useAutosave, b as useAutosaveState, a4 as useChangelogById, a5 as useChangelogBySlug, a6 as useChangelogEntries, a7 as useChangelogMedia, a2 as useChangelogs, ag as useDbPartialQuery, o as useDbRealtimeQuery, W as useDeleteChangelog, Z as useDeleteChangelogEntry, a0 as useDeleteChangelogMedia, a8 as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, _ as useMultiDeleteChangelogEntries, Y as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, a3 as usePublishedChangelogs, o as useRealtimeQuery, ae as useResolveFeedback, E as useSearchQuery, D as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ab as useSubmitFeedback, e as useToastError, a1 as useUploadChangelogMedia, V as useUpsertChangelog, X as useUpsertChangelogEntry, $ as useUpsertChangelogMedia } from './useResolveFeedback-B0UcYWVI.js';
+import { u as useDbAdvanceFilterQuery, Q as QueryState } from './index-CFUuTzXO.js';
+export { r as BackendSelectionResult, B as BooleanOperator, k as ClarificationSuggestion, C as CombinedProviderStatus, j as ComputedSortConfig, n as DataLayerWithPowerSyncProps, D as DbChangeLog, E as EnhancedSyncControl, a as EnhancedSyncStatus, d as FilterConditionType, m as FilterContextType, g as FilterInput, h as FilterState, H as HasPowerSyncConfig, O as OrderColumn, P as PowerSyncEnabledConfig, b as PowerSyncEnabledContextValue, q as PowerSyncTables, U as UseDataLayerWithPowerSync, p as UseSyncControlWithPowerSync, o as UseSyncStatusWithPowerSync, V as ValueOrArrayForPropertyType, c as createCombinedStatus, s as normalizeFilter } from './index-CFUuTzXO.js';
+export { y as AIOptions, z as AIResponse, P as AlertProps, A as AttachmentQueueProvider, I as BUCKETS, J as BucketName, H as CustomPageQueryResult, L as DEFAULT_QUERY_TIMEOUT, a9 as FeedbackListItem, aa as FeedbackListParams, Q as LiveChangeContext, R as LiveChangeContextProvider, C as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, ac as SubmitFeedbackParams, v as SupabaseAdapter, T as TIMEOUT_ERROR_MESSAGE, F as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, af as UseDbPartialQueryResult, N as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, O as convertFilterToRealtimeQuery, K as createInCondition, w as createSupabaseAdapter, G as executeAdvanceQuery, x as getErrorBody, g as getStorageUrl, p as getSupabaseUrl, M as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, B as useAI, ad as useApplyFeedback, c as useAutosave, b as useAutosaveState, a4 as useChangelogById, a5 as useChangelogBySlug, a6 as useChangelogEntries, a7 as useChangelogMedia, a2 as useChangelogs, ag as useDbPartialQuery, o as useDbRealtimeQuery, W as useDeleteChangelog, Z as useDeleteChangelogEntry, a0 as useDeleteChangelogMedia, a8 as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, _ as useMultiDeleteChangelogEntries, Y as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, a3 as usePublishedChangelogs, o as useRealtimeQuery, ae as useResolveFeedback, E as useSearchQuery, D as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ab as useSubmitFeedback, e as useToastError, a1 as useUploadChangelogMedia, V as useUpsertChangelog, X as useUpsertChangelogEntry, $ as useUpsertChangelogMedia } from './useResolveFeedback-CuUkdHoR.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseInfiniteQueryOptions, InfiniteData, UseQueryOptions, QueryClient } from '@tanstack/react-query';
 import { D as Database } from './useSupabase-DSZNeXnF.js';
@@ -14,14 +14,15 @@ export { F as Fetch, i as GenericFunction, g as GenericNonUpdatableView, f as Ge
 import { PostgrestSingleResponse, RealtimePostgresChangesPayload, SupabaseClient } from '@supabase/supabase-js';
 import { useInsertMutation, useUpdateMutation } from '@supabase-cache-helpers/postgrest-react-query';
 export { U as UseDbQuerySingleReturn, u as useDbQuery } from './useDbQuery-C-TL8jY1.js';
-export { C as ClarificationQuestion, D as DatabaseTypes, F as Filter, x as FilterGroup, y as FilterOperator, z as Pagination, P as PublicTableNames, Q as QueryState, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, A as Sort, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, K as UseDbDeleteOptions, L as UseDbDeleteResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, B as UseDbInsertOptions, E as UseDbInsertResult, v as UseDbQueryByIdOptions, w as UseDbQueryByIdResult, s as UseDbQueryOptions, t as UseDbQueryResult, G as UseDbUpdateOptions, H as UseDbUpdateResult, I as UseDbUpsertOptions, J as UseDbUpsertResult, u as useAdvanceQuery, a as useDataLayer, c as useDataLayerOptional, e as useDbCount, e as useDbCountV3, f as useDbDeleteV3, g as useDbInfiniteQueryV3, h as useDbInsertV3, j as useDbQueryById, i as useDbQueryV3, k as useDbUpdateV3, l as useDbUpsert, l as useDbUpsertV3, l as useUpsert } from './useDbCount-DHLJzmkO.js';
+export { C as ClarificationQuestion, D as DatabaseTypes, F as Filter, x as FilterGroup, y as FilterOperator, z as Pagination, P as PublicTableNames, Q as QueryState, R as ResolveRowType, S as SchemaNames, m as SchemaTableNames, A as Sort, T as TableIdentifier, U as UseAdvanceQueryOptions, n as UseAdvanceQueryResult, o as UseDbCountOptions, p as UseDbCountResult, K as UseDbDeleteOptions, L as UseDbDeleteResult, q as UseDbInfiniteQueryOptions, r as UseDbInfiniteQueryResult, B as UseDbInsertOptions, E as UseDbInsertResult, v as UseDbQueryByIdOptions, w as UseDbQueryByIdResult, s as UseDbQueryOptions, t as UseDbQueryResult, G as UseDbUpdateOptions, H as UseDbUpdateResult, I as UseDbUpsertOptions, J as UseDbUpsertResult, u as useAdvanceQuery, a as useDataLayer, c as useDataLayerOptional, e as useDbCount, e as useDbCountV3, f as useDbDeleteV3, g as useDbInfiniteQueryV3, h as useDbInsertV3, j as useDbQueryById, i as useDbQueryV3, k as useDbUpdateV3, l as useDbUpsert, l as useDbUpsertV3, l as useUpsert } from './useDbCount-Ckb-FhZk.js';
 import { DataLayerConfig } from './core/index.js';
-export { AdapterRegistry as AdapterRegistryInterface, AutoStrategy, BuiltQuery, CachedStrategy, ColumnInfo, ColumnType, ConnectionConfig, DataAdapter, DataLayerHooks, DatabaseSchema, DeleteMutationResult, ExtractInsert, ExtractRow, ExtractUpdate, HybridStrategy, MutationHookResult, MutationResult, OrderBy, ParsedSelect, PowerSyncStrategy, QueryOptions, QueryResult, QuerySingleResult, RelationshipInfo, RelationshipType, ResolvedRelationship, ScopeDefinition, SelectColumn, SelectRelation, SupabaseStrategy, SyncControl, SyncSchedule, SyncScope, SyncStatus, TableNames, TableSchema, TableStrategy, UseDbMutationHook, UseDbQueryByIdHook, UseDbQueryHook, WhereClause, WhereOperators } from './core/index.js';
+export { AdapterRegistry as AdapterRegistryInterface, AutoStrategy, BuiltQuery, CachedStrategy, ColumnInfo, ColumnType, ConnectionConfig, DataAdapter, DataLayerHooks, DatabaseSchema, DeleteMutationResult, ExplicitFkSpec, ExtractInsert, ExtractRow, ExtractUpdate, HybridStrategy, MutationHookResult, MutationResult, OrderBy, ParsedSelect, PowerSyncStrategy, QueryOptions, QueryResult, QuerySingleResult, RelationshipInfo, RelationshipType, ResolvedRelationship, ScopeDefinition, SelectColumn, SelectRelation, SupabaseStrategy, SyncControl, SyncSchedule, SyncScope, SyncStatus, TableNames, TableSchema, TableStrategy, UseDbMutationHook, UseDbQueryByIdHook, UseDbQueryHook, WhereClause, WhereOperators } from './core/index.js';
 export { u as useBatchDelete, a as useBatchUpsert } from './useBatchUpsert-DAkiCNo3.js';
-export { UsePartialAdvancedQueryResult, UsePartialQueryResult, UseQuerySingleReturn, extractColumnNames, extractRelationNames, getRelationSelect, hasRelation, parseSelect, stringifySelect, tokenizeTopLevel, useAdvancedFilterQuery, useAdvancedQuery, useInfiniteQuery, usePartialAdvancedQuery, usePartialQuery, useQuery } from './query/index.js';
-export { P as PowerSyncDatabase, Q as QueryExecutor, e as RelationJoinData, R as RelationshipResolver, b as ResultJoiner, S as SQLBuilder, f as createQueryExecutor, c as createRelationshipResolver, d as createResultJoiner, a as createSQLBuilder } from './executor-YJw4m7Q7.js';
-import { r as DataLayerContextValue } from './DataLayerContext-C7cJtiO8.js';
-export { f as ADAPTER_STRATEGIES, i as AdapterAutoDetector, c as AdapterCapabilities, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, A as AdapterQueryResult, g as AdapterRegistry, e as AdapterStrategyType, k as AutoDetectionResult, l as AutoDetectorOptions, m as BackendChangeListener, B as BackendStatus, C as CapableDataAdapter, D as DataLayerContext, u as DataLayerStatus, T as TableDataAdapter, j as createAdapterAutoDetector, h as createAdapterRegistry } from './DataLayerContext-C7cJtiO8.js';
+export { E as ExtractedExplicitFk, e as extractColumnNames, d as extractExplicitFkRelations, f as extractExplicitFkTables, a as extractRelationNames, g as getRelationSelect, b as hasExplicitFk, h as hasRelation, p as parseSelect, c as selectHasExplicitFkSyntax, s as stringifySelect, t as tokenizeTopLevel } from './select-parser-BAV7fOaM.js';
+export { P as PowerSyncDatabase, Q as QueryExecutor, e as RelationJoinData, R as RelationshipResolver, b as ResultJoiner, S as SQLBuilder, f as createQueryExecutor, c as createRelationshipResolver, d as createResultJoiner, a as createSQLBuilder } from './executor-D15yjeMo.js';
+export { UsePartialAdvancedQueryResult, UsePartialQueryResult, UseQuerySingleReturn, useAdvancedFilterQuery, useAdvancedQuery, useInfiniteQuery, usePartialAdvancedQuery, usePartialQuery, useQuery } from './query/index.js';
+import { r as DataLayerContextValue } from './DataLayerContext-BYZtDD0g.js';
+export { f as ADAPTER_STRATEGIES, i as AdapterAutoDetector, c as AdapterCapabilities, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, A as AdapterQueryResult, g as AdapterRegistry, e as AdapterStrategyType, k as AutoDetectionResult, l as AutoDetectorOptions, m as BackendChangeListener, B as BackendStatus, C as CapableDataAdapter, D as DataLayerContext, u as DataLayerStatus, T as TableDataAdapter, j as createAdapterAutoDetector, h as createAdapterRegistry } from './DataLayerContext-BYZtDD0g.js';
 import { ReactNode, JSX } from 'react';
 export { B as BatchAnalysisProgress, E as ExtractedReceipt, P as PendingExpense, a as useReceiptAI, u as useSupabaseFunction } from './useReceiptAI-6HkRpRml.js';
 export { e as UserMetadataContextProvider, c as UserMetadataContextType, a as UserMetadataInsert, U as UserMetadataRow, b as UserMetadataUpdate, u as useLiveChangesIndicator, h as useSetUserMetadata, f as useUserMetadata, i as useUserMetadataState, g as useUserMetadataValue, d as userMetadataContext } from './UserMetadataContext-pQb3A8_Q.js';