@pol-studios/db 1.0.58 → 1.0.61

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

@@ -377,6 +377,14 @@ declare function createResultJoiner(): ResultJoiner;
  * against the local SQLite database via PowerSync.
  */
 
+/**
+ * Function type for resolving schema-qualified table names to PowerSync aliases.
+ * Used to look up configured aliases from DataLayerConfig.
+ *
+ * @param qualifiedName - Schema-qualified table name (e.g., "core.Profile")
+ * @returns The resolved alias (e.g., "Profile" if configured, or "CoreProfile" as fallback)
+ */
+type TableAliasResolver = (qualifiedName: string) => string;
 /**
  * Interface for PowerSync database.
  * This matches the getAll method signature from @powersync/react-native.
@@ -416,11 +424,27 @@ declare class QueryExecutor {
     private resolver;
     private builder;
     private joiner;
+    /**
+     * Optional resolver for looking up table aliases from config.
+     * When provided, explicit FK resolution will use configured aliases
+     * instead of always defaulting to schema concatenation.
+     */
+    private tableAliasResolver?;
     /**
      * Cache for resolved relationships to avoid repeated schema lookups
      */
     private relationCache;
-    constructor(db: PowerSyncDatabase, schema: DatabaseSchema);
+    /**
+     * Create a new QueryExecutor.
+     *
+     * @param db - PowerSync database instance
+     * @param schema - Database schema for relationship resolution
+     * @param tableAliasResolver - Optional resolver for looking up configured table aliases.
+     *   When provided, getTableNameFromQualified will use this to resolve schema-qualified
+     *   names like "core.Profile" to their configured aliases. If not provided or if the
+     *   resolver returns the same value as input, falls back to default concatenation behavior.
+     */
+    constructor(db: PowerSyncDatabase, schema: DatabaseSchema, tableAliasResolver?: TableAliasResolver);
     /**
      * Execute a query and return results.
      *
@@ -510,6 +534,19 @@ declare class QueryExecutor {
      * to handle both "core.Profile" -> "CoreProfile" (PowerSync alias) and
      * simple table names.
      *
+     * Resolution order:
+     * 1. If a tableAliasResolver is configured, use it to look up the alias
+     * 2. If the resolver returns a different value than the input, use it
+     * 3. Otherwise, fall back to default behavior:
+     *    - Schema-qualified names: convert to PascalCase (core.Profile -> CoreProfile)
+     *    - Simple names: return as-is
+     *
+     * This allows DataLayerConfig to define explicit aliases for tables,
+     * supporting cases where:
+     * - An alias is explicitly configured (e.g., "core.Profile" -> "UserProfile")
+     * - No conflict exists (e.g., "core.Profile" -> "Profile" via schema stripping)
+     * - A conflict exists requiring concatenation (e.g., both public.Profile and core.Profile)
+     *
      * @param qualifiedName - Table name, optionally schema-qualified (e.g., "core.Profile")
      * @returns The table name to use in queries
      */
@@ -549,8 +586,11 @@ declare class QueryExecutor {
  *
  * @param db - PowerSync database instance
  * @param schema - Database schema
+ * @param tableAliasResolver - Optional resolver for looking up configured table aliases.
+ *   When provided, explicit FK resolution (e.g., `Profile!userId:core.Profile(*)`)
+ *   will use this to resolve schema-qualified names to their configured aliases.
  * @returns QueryExecutor instance
  */
-declare function createQueryExecutor(db: PowerSyncDatabase, schema: DatabaseSchema): QueryExecutor;
+declare function createQueryExecutor(db: PowerSyncDatabase, schema: DatabaseSchema, tableAliasResolver?: TableAliasResolver): QueryExecutor;
 
-export { type PowerSyncDatabase as P, QueryExecutor as Q, RelationshipResolver as R, SQLBuilder as S, createSQLBuilder as a, ResultJoiner as b, createRelationshipResolver as c, createResultJoiner as d, type RelationJoinData as e, createQueryExecutor as f };
+export { type PowerSyncDatabase as P, QueryExecutor as Q, RelationshipResolver as R, SQLBuilder as S, type TableAliasResolver as T, createSQLBuilder as a, ResultJoiner as b, createRelationshipResolver as c, createResultJoiner as d, type RelationJoinData as e, createQueryExecutor as f };

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-Ckb-FhZk.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-dCkdaBpP.js';
 import { SyncStatus, SyncControl } from '../core/index.js';
-import '../DataLayerContext-BYZtDD0g.js';
+import '../DataLayerContext-V5FotiSk.js';
 import 'react';
 import '@supabase/supabase-js';
 import '@tanstack/react-query';
-import '../executor-D15yjeMo.js';
+import '../executor-Bu1OlqCl.js';
 
 /**
  * V3 useSyncStatus Hook

package/dist/hooks/index.js

@@ -9,7 +9,7 @@ import {
   useOnlineStatus,
   useSyncControl,
   useSyncStatus
-} from "../chunk-VYFAMTHI.js";
+} from "../chunk-ZPFZ2ZRW.js";
 import {
   useDataLayer,
   useDataLayerCore,
@@ -18,7 +18,7 @@ import {
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "../chunk-GWYTROSD.js";
+} from "../chunk-L4DFVMTS.js";
 import "../chunk-GC3TBUWE.js";
 import "../chunk-W7PERM66.js";
 import "../chunk-QYAFI34Q.js";

package/dist/{index-CFUuTzXO.d.ts → index-vwVJ0BWj.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-BYZtDD0g.js';
+import { r as DataLayerStatus, o as DataLayerContextValue } from './DataLayerContext-V5FotiSk.js';
 
 /**
  * Represents a change log entry for database records.
@@ -339,14 +339,6 @@ interface DataLayerWithPowerSyncProps<DB = unknown> {
      * React Query client (required).
      */
     queryClient: QueryClient;
-    /**
-     * Optional callback when initialization completes.
-     */
-    onInitialized?: (context: DataLayerContextValue) => void;
-    /**
-     * Optional callback when error occurs.
-     */
-    onError?: (error: Error) => void;
 }
 /**
  * Return type for useDataLayer when PowerSync is available.

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-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 { 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-vwVJ0BWj.js';
+export { G as AIOptions, H as AIResponse, v as AdapterRegistry, Z as AlertProps, A as AttachmentQueueProvider, P as BUCKETS, Q as BucketName, O as CustomPageQueryResult, V as DEFAULT_QUERY_TIMEOUT, ag as FeedbackListItem, ah as FeedbackListParams, _ as LiveChangeContext, $ as LiveChangeContextProvider, J as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, aj as SubmitFeedbackParams, B as SupabaseAdapter, E as SyncTracker, D as SyncTrackingAdapter, T as TIMEOUT_ERROR_MESSAGE, M as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, X as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, Y as convertFilterToRealtimeQuery, w as createAdapterRegistry, R as createInCondition, C as createSupabaseAdapter, N as executeAdvanceQuery, y as generatePowerSyncAlias, F as getErrorBody, z as getPowerSyncAlias, g as getStorageUrl, p as getSupabaseUrl, W as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, x as stripSchemaPrefix, I as useAI, ak as useApplyFeedback, c as useAutosave, b as useAutosaveState, ab as useChangelogById, ac as useChangelogBySlug, ad as useChangelogEntries, ae as useChangelogMedia, a9 as useChangelogs, o as useDbRealtimeQuery, a1 as useDeleteChangelog, a4 as useDeleteChangelogEntry, a7 as useDeleteChangelogMedia, af as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, a5 as useMultiDeleteChangelogEntries, a3 as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, aa as usePublishedChangelogs, o as useRealtimeQuery, al as useResolveFeedback, L as useSearchQuery, K as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ai as useSubmitFeedback, e as useToastError, a8 as useUploadChangelogMedia, a0 as useUpsertChangelog, a2 as useUpsertChangelogEntry, a6 as useUpsertChangelogMedia } from './useResolveFeedback-thFi-4h8.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-BYZtDD0g.js';
+export { f as ADAPTER_STRATEGIES, g as AdapterAutoDetector, c as AdapterCapabilities, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, A as AdapterQueryResult, e as AdapterStrategyType, i as AutoDetectionResult, j as AutoDetectorOptions, k as BackendChangeListener, B as BackendStatus, C as CapableDataAdapter, D as DataLayerContext, o as DataLayerContextValue, l as DataLayerCoreContext, p as DataLayerCoreContextValue, n as DataLayerNestingContext, r as DataLayerStatus, m as DataLayerStatusContext, q as DataLayerStatusContextValue, s as SimpleAdapterRegistry, S as SyncStatusInfo, T as TableDataAdapter, h as createAdapterAutoDetector } from './DataLayerContext-V5FotiSk.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-Ckb-FhZk.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-dCkdaBpP.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-D15yjeMo.js';
+import './executor-Bu1OlqCl.js';
 import 'react-dropzone';
 import '@supabase/supabase-js/dist/module/lib/types.js';
 

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   getPowerSyncInstance,
   isAbstractPowerSyncDatabase,
   isPowerSyncAvailable
-} from "./chunk-7BGDQT5X.js";
+} from "./chunk-PIPB3JMK.js";
 import {
   useReceiptAI_default,
   useSupabaseFunction
@@ -24,27 +24,27 @@ import {
   useHasConflicts,
   usePendingConflicts,
   useSupabaseUpload
-} from "./chunk-OK2C54B6.js";
+} from "./chunk-7PBTPCRN.js";
 import {
   ADAPTER_STRATEGIES,
-  AdapterAutoDetector,
   AdapterRegistry,
   BUCKETS,
-  BackendStatus,
   StorageQueueContext,
   StorageQueueProvider,
   SupabaseAdapter,
   SyncTrackingAdapter,
   convertFilterToRealtimeQuery,
-  createAdapterAutoDetector,
   createAdapterRegistry,
   createInCondition,
   createSupabaseAdapter,
   executeAdvanceQuery,
+  generatePowerSyncAlias,
   getErrorBody,
+  getPowerSyncAlias,
   getStorageUrl,
   isStorageAuthError,
   newTimeActivity,
+  stripSchemaPrefix,
   useAI,
   useApplyFeedback,
   useAutosave,
@@ -77,7 +77,7 @@ import {
   useUpsertChangelog,
   useUpsertChangelogEntry,
   useUpsertChangelogMedia
-} from "./chunk-LG3OHLGB.js";
+} from "./chunk-FWCHS5NN.js";
 import {
   LiveChangeContext,
   LiveChangeContextProvider,
@@ -88,7 +88,7 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "./chunk-4EO55YV2.js";
+} from "./chunk-H4Z73DC4.js";
 import {
   PostgrestFilter,
   binarySearch,
@@ -128,11 +128,11 @@ import {
   useOnlineStatus,
   useSyncControl,
   useSyncStatus
-} from "./chunk-VYFAMTHI.js";
+} from "./chunk-ZPFZ2ZRW.js";
 import {
   Constants,
   createCombinedStatus
-} from "./chunk-Z456IHCB.js";
+} from "./chunk-F4HW4NT5.js";
 import {
   Accessory,
   Address,
@@ -321,25 +321,29 @@ import {
   UserMetadata
 } from "./chunk-SM73S2DY.js";
 import "./chunk-NSIAAYW3.js";
-import "./chunk-MEBT5YHA.js";
+import "./chunk-SNPZMRBC.js";
 import {
   DEFAULT_QUERY_TIMEOUT,
   TIMEOUT_ERROR_MESSAGE,
   isTimeoutError
-} from "./chunk-6SDH7M7J.js";
+} from "./chunk-ARALLEDJ.js";
 import {
+  AdapterAutoDetector,
+  BackendStatus,
   DataLayerContext,
   DataLayerCoreContext,
+  DataLayerNestingContext,
   DataLayerStatusContext,
+  createAdapterAutoDetector,
   useDataLayer,
   useDataLayerCore,
   useDataLayerOptional,
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "./chunk-GWYTROSD.js";
+} from "./chunk-L4DFVMTS.js";
 import "./chunk-RT4O5H2E.js";
-import "./chunk-YRIPM2AN.js";
+import "./chunk-4PZ744G2.js";
 import {
   getSupabaseUrl,
   setSupabaseUrl
@@ -420,6 +424,7 @@ export {
   DataExchangeImport,
   DataLayerContext,
   DataLayerCoreContext,
+  DataLayerNestingContext,
   DataLayerProvider,
   DataLayerStatusContext,
   Datasheet,
@@ -612,8 +617,10 @@ export {
   findFilters,
   findIndexOrdered,
   findLastIndex,
+  generatePowerSyncAlias,
   get,
   getErrorBody,
+  getPowerSyncAlias,
   getPowerSyncInstance,
   getStorageUrl,
   getSupabaseUrl,
@@ -648,6 +655,7 @@ export {
   setFilterValue,
   setSupabaseUrl,
   sortSearchParams,
+  stripSchemaPrefix,
   typedSupabase,
   useAI,
   useAdvanceQuery,

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-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 { 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-vwVJ0BWj.js';
+export { G as AIOptions, H as AIResponse, v as AdapterRegistry, Z as AlertProps, A as AttachmentQueueProvider, P as BUCKETS, Q as BucketName, O as CustomPageQueryResult, V as DEFAULT_QUERY_TIMEOUT, ag as FeedbackListItem, ah as FeedbackListParams, _ as LiveChangeContext, $ as LiveChangeContextProvider, J as ServerAvailabilityState, k as StorageQueueContext, m as StorageQueueContextValue, S as StorageQueueProvider, j as StorageQueueProviderProps, aj as SubmitFeedbackParams, B as SupabaseAdapter, E as SyncTracker, D as SyncTrackingAdapter, T as TIMEOUT_ERROR_MESSAGE, M as UpdateOptions, U as UseAutosaveOptions, d as UseAutosaveResult, X as UseDbRealtimeQueryResult, q as UseMutationSuccessOptions, h as UseStorageSourceOptions, i as UseStorageSourceResult, Y as convertFilterToRealtimeQuery, w as createAdapterRegistry, R as createInCondition, C as createSupabaseAdapter, N as executeAdvanceQuery, y as generatePowerSyncAlias, F as getErrorBody, z as getPowerSyncAlias, g as getStorageUrl, p as getSupabaseUrl, W as isTimeoutError, n as newTimeActivity, s as setSupabaseUrl, x as stripSchemaPrefix, I as useAI, ak as useApplyFeedback, c as useAutosave, b as useAutosaveState, ab as useChangelogById, ac as useChangelogBySlug, ad as useChangelogEntries, ae as useChangelogMedia, a9 as useChangelogs, o as useDbRealtimeQuery, a1 as useDeleteChangelog, a4 as useDeleteChangelogEntry, a7 as useDeleteChangelogMedia, af as useFeedbackList, a as useLatestOperationLog, u as useLiveChangeTracking, a5 as useMultiDeleteChangelogEntries, a3 as useMultiUpsertChangelogEntries, r as useMutationSuccess, t as useMutationSuccessRN, aa as usePublishedChangelogs, o as useRealtimeQuery, al as useResolveFeedback, L as useSearchQuery, K as useServerAvailability, l as useStorageQueueContext, f as useStorageSource, ai as useSubmitFeedback, e as useToastError, a8 as useUploadChangelogMedia, a0 as useUpsertChangelog, a2 as useUpsertChangelogEntry, a6 as useUpsertChangelogMedia } from './useResolveFeedback-thFi-4h8.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-dCkdaBpP.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-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 { T as TableDataAdapter, C as CapableDataAdapter, c as AdapterCapabilities, A as AdapterQueryResult, S as SyncStatusInfo } from './DataLayerContext-V5FotiSk.js';
+export { f as ADAPTER_STRATEGIES, g as AdapterAutoDetector, a as AdapterConfig, d as AdapterDependencies, b as AdapterFactory, e as AdapterStrategyType, i as AutoDetectionResult, j as AutoDetectorOptions, k as BackendChangeListener, B as BackendStatus, D as DataLayerContext, o as DataLayerContextValue, l as DataLayerCoreContext, p as DataLayerCoreContextValue, n as DataLayerNestingContext, r as DataLayerStatus, m as DataLayerStatusContext, q as DataLayerStatusContextValue, s as SimpleAdapterRegistry, h as createAdapterAutoDetector } from './DataLayerContext-V5FotiSk.js';
+import { Q as QueryExecutor, P as PowerSyncDatabase$1 } from './executor-Bu1OlqCl.js';
 import * as react from 'react';
 import react__default, { ReactNode, JSX } from 'react';
 import { SupabaseClient } from '@supabase/supabase-js';
@@ -302,60 +302,96 @@ declare class PowerSyncAdapter implements TableDataAdapter, CapableDataAdapter {
  *
  * @param db - PowerSync database instance
  * @param schema - Database schema for relationship resolution
+ * @param options - Optional configuration:
+ *   - `tableNameResolver`: Function to resolve schema-qualified table names to PowerSync aliases.
+ *     Used for explicit FK syntax (e.g., "Profile!userId:core.Profile(*)") to look up
+ *     configured aliases from DataLayerConfig.
+ *   - `maxSubscriptions`: Maximum number of subscriptions in the registry (default: 100)
  * @returns A new PowerSyncAdapter instance
  *
  * @example
  * import { createPowerSyncAdapter } from "./adapters/powersync-adapter";
  *
+ * // Basic usage
  * const adapter = createPowerSyncAdapter(powerSyncDb, databaseSchema);
  *
+ * // With table alias resolver (for explicit FK syntax support)
+ * const adapter = createPowerSyncAdapter(powerSyncDb, databaseSchema, {
+ *   tableNameResolver: (table) => registry.getTableAlias(table),
+ * });
+ *
  * // Use the adapter
  * const { data } = await adapter.query("EquipmentUnit", {
  *   where: { status: "active" }
  * });
  */
-declare function createPowerSyncAdapter(db: PowerSyncDatabase, schema: DatabaseSchema): PowerSyncAdapter;
+declare function createPowerSyncAdapter(db: PowerSyncDatabase, schema: DatabaseSchema, options?: TableNameResolver | PowerSyncAdapterOptions): PowerSyncAdapter;
 
 /**
- * V3 Data Layer Provider
+ * V3 Data Layer Provider - SIMPLIFIED
+ *
+ * Single provider with stable context values and lazy PowerSync initialization.
+ * Starts with Supabase and automatically switches to PowerSync when available.
+ *
+ * The provider supports two usage patterns:
+ *
+ * 1. **Lazy Init (recommended)** - Mount immediately, PowerSync arrives later:
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { db } = usePowerSync(); // db may be null initially
+ *
+ *   return (
+ *     <DataLayerProvider
+ *       powerSyncInstance={db}  // null -> uses Supabase, db -> uses PowerSync
+ *       supabaseClient={supabase}
+ *       queryClient={queryClient}
+ *       config={dataLayerConfig}
+ *     >
+ *       <YourApp />
+ *     </DataLayerProvider>
+ *   );
+ * }
+ * ```
+ *
+ * 2. **Eager Init** - Wait for PowerSync before mounting:
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { db, isReady } = usePowerSync();
+ *   if (!isReady) return <Loading />;
  *
- * React context provider that initializes adapters, manages the PowerSync lifecycle,
- * and provides context for all V3 hooks. This is the main entry point for the V3
- * data layer in a React application.
+ *   return (
+ *     <DataLayerProvider
+ *       powerSyncInstance={db}
+ *       supabaseClient={supabase}
+ *       queryClient={queryClient}
+ *       config={dataLayerConfig}
+ *     >
+ *       <YourApp />
+ *     </DataLayerProvider>
+ *   );
+ * }
+ * ```
  */
 
-/**
- * Props for DataLayerProvider
- */
 interface DataLayerProviderProps {
     /** Data layer configuration */
     config: DataLayerConfig;
     /** Children to render */
     children: ReactNode;
     /**
-     * Optional PowerSync database instance.
+     * PowerSync database instance.
      *
-     * This accepts any object that implements the PowerSyncDatabase interface,
-     * including the AbstractPowerSyncDatabase from @pol-studios/powersync.
+     * Supports lazy initialization:
+     * - Pass null initially to use Supabase as the backend
+     * - When PowerSync becomes available, pass the db instance
+     * - The provider automatically switches adapters when this prop changes
      *
-     * When using with @pol-studios/powersync, pass the `db` value from usePowerSync():
      * @example
      * ```tsx
-     * // With @pol-studios/powersync
-     * const { db, isReady } = usePowerSync();
-     *
-     * if (!isReady) return <Loading />;
-     *
-     * return (
-     *   <DataLayerProvider
-     *     config={config}
-     *     powerSyncInstance={db}
-     *     supabaseClient={supabase}
-     *     queryClient={queryClient}
-     *   >
-     *     {children}
-     *   </DataLayerProvider>
-     * );
+     * const { db } = usePowerSync(); // db may be null initially
+     * return <DataLayerProvider powerSyncInstance={db} ... />
      * ```
      */
     powerSyncInstance?: PowerSyncDatabase$1 | null;
@@ -363,53 +399,18 @@ interface DataLayerProviderProps {
     supabaseClient: SupabaseClient;
     /** React Query client (required) */
     queryClient: QueryClient;
-    /** Callback when initialization completes */
-    onInitialized?: (context: DataLayerContextValue) => void;
-    /** Callback when error occurs */
-    onError?: (error: Error) => void;
     /**
-     * Current sync status from @pol-studios/powersync.
-     * Pass the status object from useSyncStatus() hook.
-     * When hasSynced is false and useOnlineUntilSynced is true (default),
-     * queries will use Supabase until initial sync completes.
+     * Sync control from PowerSync provider.
+     * Enables mutation tracking and sync controls.
      */
-    powerSyncSyncStatus?: SyncStatusInfo;
+    syncControl?: SyncControl;
     /**
-     * Optional sync control from @pol-studios/powersync.
-     * When provided, enables mutation hooks to refresh pending mutations
-     * after writes without polling.
+     * Sync status from PowerSync.
+     * Used to determine hasSynced and isOnline.
      */
-    syncControl?: SyncControl;
+    powerSyncSyncStatus?: SyncStatusInfo;
 }
-/**
- * Provider component for the V3 data layer.
- *
- * This provider:
- * - Creates and manages the AdapterRegistry
- * - Initializes the AdapterAutoDetector for backend selection
- * - Sets up Supabase and PowerSync adapters
- * - Tracks online/offline status
- * - Provides context for all V3 hooks
- *
- * @example
- * ```tsx
- * import { DataLayerProvider } from "@pol-studios/db";
- *
- * function App() {
- *   return (
- *     <DataLayerProvider
- *       config={dataLayerConfig}
- *       supabaseClient={supabase}
- *       queryClient={queryClient}
- *       powerSyncInstance={powerSyncDb}
- *     >
- *       <YourApp />
- *     </DataLayerProvider>
- *   );
- * }
- * ```
- */
-declare function DataLayerProvider({ config, children, powerSyncInstance, supabaseClient, queryClient, onInitialized, onError, powerSyncSyncStatus, syncControl: externalSyncControl, }: DataLayerProviderProps): JSX.Element;
+declare function DataLayerProvider({ config, children, powerSyncInstance, supabaseClient, queryClient, syncControl: externalSyncControl, powerSyncSyncStatus, }: DataLayerProviderProps): JSX.Element;
 
 interface FileWithPreview extends File {
     preview?: string;
@@ -832,4 +833,4 @@ declare function useBulkConflictResolution(): {
     conflictCount: number;
 };
 
-export { AdapterCapabilities, AdapterQueryResult, CapableDataAdapter, type ConflictCheckResult, ConflictContext, type ConflictContextValue, ConflictProvider, type ConflictProviderProps, type ConflictResolution, DataLayerConfig, DataLayerContextValue, DataLayerProvider, type DataLayerProviderProps, DatabaseSchema, type FieldConflict, PowerSyncAdapter, QueryOptions, SyncControl, SyncStatusInfo, TableDataAdapter, type UseConflictResolutionReturn, type UseSupabaseUploadOptions, type UseSupabaseUploadReturn, createPowerSyncAdapter, useBulkConflictResolution, useConflictCountByTable, useConflictForRecord, useConflictResolution, useConflictState, useConflictsForTable, useHasConflicts, usePendingConflicts, useSupabaseUpload };
+export { AdapterCapabilities, AdapterQueryResult, CapableDataAdapter, type ConflictCheckResult, ConflictContext, type ConflictContextValue, ConflictProvider, type ConflictProviderProps, type ConflictResolution, DataLayerConfig, DataLayerProvider, type DataLayerProviderProps, DatabaseSchema, type FieldConflict, PowerSyncAdapter, QueryOptions, SyncControl, SyncStatusInfo, TableDataAdapter, type UseConflictResolutionReturn, type UseSupabaseUploadOptions, type UseSupabaseUploadReturn, createPowerSyncAdapter, useBulkConflictResolution, useConflictCountByTable, useConflictForRecord, useConflictResolution, useConflictState, useConflictsForTable, useHasConflicts, usePendingConflicts, useSupabaseUpload };