@pol-studios/db 1.0.54 → 1.0.56

package/dist/realtime/index.d.ts

@@ -2,7 +2,9 @@ import { RealtimePostgresChangesPayload, PostgrestSingleResponse } from '@supaba
 import { ItemType } from '@pol-studios/utils';
 import { UseQueryOptions } from '@tanstack/react-query';
 import { U as UseDbQuerySingleReturn } from '../useDbQuery-C-TL8jY1.js';
+import { E as ExtractedExplicitFk } from '../select-parser-BAV7fOaM.js';
 import '@supabase-cache-helpers/postgrest-react-query';
+import '../core/index.js';
 
 declare function useRealtime(key: string, query: string, table: string | {
     table: string;
@@ -41,4 +43,81 @@ type DataType = Record<string, any>;
 declare function convertFilterToRealtimeQuery(filters: FilterDefinitions): string;
 declare function useRealtimeQuery<Result extends DataType>(query: PromiseLike<PostgrestSingleResponse<Result>>, config?: Omit<UseQueryOptions<PostgrestSingleResponse<Result>>, "queryKey" | "queryFn"> & ConfigurationOptions<Result>, primaryKeys?: (keyof ItemType<Result> & string)[]): UseRealtimeQueryResult<Result>;
 
-export { type UseRealtimeQueryResult, convertFilterToRealtimeQuery, useRealtimeQuery as useDbRealtimeQuery, useRealtime, useRealtimeQuery };
+/**
+ * Optimistic Merge Utilities for Explicit FK Relations
+ *
+ * When using realtime subscriptions with explicit FK joins (e.g., Sender!senderId:core.Profile(*)),
+ * changes to related tables need to be optimistically merged into cached query data.
+ *
+ * This module provides utilities for:
+ * 1. Extracting explicit FK relation info from select strings
+ * 2. Merging changes from related tables into parent query data
+ * 3. Managing multiple subscriptions for related tables
+ */
+
+/**
+ * A changed record from a related table.
+ */
+interface ChangedRecord {
+    /** The record ID */
+    id: string;
+    /** All record fields */
+    [key: string]: unknown;
+}
+/**
+ * Merge updated related records into parent query data.
+ *
+ * When a record in a related table changes, this function updates all references
+ * to that record within the parent data's nested relations.
+ *
+ * @param parentData - The current cached query data (array of parent records)
+ * @param relation - The explicit FK relation info (alias, sourceField, etc.)
+ * @param changedRecords - The updated records from the related table
+ * @returns New array with merged updates (immutable - does not modify input)
+ *
+ * @example
+ * // Parent data has: [{ id: "1", senderId: "user-1", Sender: { id: "user-1", name: "Alice" } }]
+ * // User "user-1" changed their name to "Bob"
+ * const updated = mergeRelatedUpdate(
+ *   parentData,
+ *   { alias: "Sender", sourceField: "senderId", targetTable: "User", targetColumn: "id" },
+ *   [{ id: "user-1", name: "Bob" }]
+ * );
+ * // Result: [{ id: "1", senderId: "user-1", Sender: { id: "user-1", name: "Bob" } }]
+ */
+declare function mergeRelatedUpdate<T extends Record<string, unknown>>(parentData: T[], relation: ExtractedExplicitFk, changedRecords: ChangedRecord[]): T[];
+/**
+ * Merge a single changed record into parent query data.
+ *
+ * Convenience wrapper around mergeRelatedUpdate for single record changes.
+ *
+ * @param parentData - The current cached query data
+ * @param relation - The explicit FK relation info
+ * @param changedRecord - The updated record from the related table
+ * @returns New array with merged update
+ */
+declare function mergeSingleRelatedUpdate<T extends Record<string, unknown>>(parentData: T[], relation: ExtractedExplicitFk, changedRecord: ChangedRecord): T[];
+/**
+ * Check if any parent records reference a given related record ID.
+ *
+ * Useful for determining whether a change to a related record is relevant
+ * to the current query data.
+ *
+ * @param parentData - The current cached query data
+ * @param relation - The explicit FK relation info
+ * @param relatedId - The ID of the related record that changed
+ * @returns true if any parent references this related record
+ */
+declare function parentReferencesRelated<T extends Record<string, unknown>>(parentData: T[], relation: ExtractedExplicitFk, relatedId: string): boolean;
+/**
+ * Extract all related IDs from parent data for a given relation.
+ *
+ * Useful for filtering realtime subscriptions to only watch relevant records.
+ *
+ * @param parentData - The current cached query data
+ * @param relation - The explicit FK relation info
+ * @returns Set of related record IDs referenced by the parent data
+ */
+declare function extractRelatedIds<T extends Record<string, unknown>>(parentData: T[], relation: ExtractedExplicitFk): Set<string>;
+
+export { type ChangedRecord, type UseRealtimeQueryResult, convertFilterToRealtimeQuery, extractRelatedIds, mergeRelatedUpdate, mergeSingleRelatedUpdate, parentReferencesRelated, useRealtimeQuery as useDbRealtimeQuery, useRealtime, useRealtimeQuery };

package/dist/realtime/index.js

@@ -1,6 +1,12 @@
+import {
+  extractRelatedIds,
+  mergeRelatedUpdate,
+  mergeSingleRelatedUpdate,
+  parentReferencesRelated
+} from "../chunk-QYAFI34Q.js";
 import {
   PostgrestParser
-} from "../chunk-UJWETW36.js";
+} from "../chunk-JOULSXOI.js";
 import "../chunk-J4ZVCXZ4.js";
 import {
   buildNormalizedQuery,
@@ -10,8 +16,8 @@ import {
   useQueriesForTableLoader,
   useQuery,
   useUpsertItem
-} from "../chunk-CTRY7JDP.js";
-import "../chunk-INEUG6MC.js";
+} from "../chunk-YUX6RGLZ.js";
+import "../chunk-AKIRHA4Q.js";
 import {
   UserSessionId,
   useSupabase
@@ -106,7 +112,7 @@ function useRealtime(key, query, table, primaryKeys, options) {
             query
           });
           if (payload.eventType !== REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE && selectQuery) {
-            if (selectQuery.groupedUserQueryPaths.every((x) => x.path in data) === false) {
+            if (selectQuery.groupedUserQueryPaths?.every((x) => x.path in data) === false) {
               const qb = supabase.schema(payload.schema).from(payload.table).select(selectQuery.selectQuery);
               for (const pk of primaryKeys) {
                 qb.eq(pk.toString(), data[pk]);
@@ -135,14 +141,6 @@ function useRealtime(key, query, table, primaryKeys, options) {
         if (onChange) {
           onChange(payload);
         }
-      }).on("postgres_changes", {
-        event: "DELETE",
-        schema: schemaValue,
-        table: tableNameValue
-      }, async (payload_0) => {
-        if (payload_0.eventType === REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE) {
-          await deleteItem(payload_0.old);
-        }
       }).subscribe((status) => {
         setRealtimeState(status);
         if (status === "SUBSCRIBED") {
@@ -367,6 +365,10 @@ function useRealtimeQuery(query, config, t0) {
 }
 export {
   convertFilterToRealtimeQuery,
+  extractRelatedIds,
+  mergeRelatedUpdate,
+  mergeSingleRelatedUpdate,
+  parentReferencesRelated,
   useRealtimeQuery as useDbRealtimeQuery,
   useRealtime,
   useRealtimeQuery

package/dist/realtime/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/realtime/useRealtime.ts","../../src/realtime/useRealtimeQuery.ts"],"sourcesContent":["import { c as _c } from \"react/compiler-runtime\";\nimport { useDeleteItem, useQueriesForTableLoader, useUpsertItem } from \"@supabase-cache-helpers/postgrest-react-query\";\nimport { useEffect, useState, useRef } from \"react\";\nimport useSupabase, { UserSessionId } from \"../useSupabase\";\nimport { newUuid } from \"@pol-studios/utils\";\nimport { buildNormalizedQuery, normalizeResponse } from \"@supabase-cache-helpers/postgrest-core\";\nimport { REALTIME_POSTGRES_CHANGES_LISTEN_EVENT, type RealtimePostgresChangesPayload } from \"@supabase/supabase-js\";\nimport { useDelayedValue } from \"@pol-studios/hooks/state\";\nexport default function useRealtime(key, query, table, primaryKeys, options) {\n  const $ = _c(37);\n  const supabase = useSupabase();\n  const tableNameValue = typeof table === \"string\" ? table : table.table;\n  const schemaValue = typeof table === \"string\" ? \"public\" : table.schema;\n  const queriesForTable = useQueriesForTableLoader(tableNameValue);\n  let t0;\n  if ($[0] !== primaryKeys || $[1] !== schemaValue || $[2] !== tableNameValue) {\n    t0 = {\n      primaryKeys,\n      table: tableNameValue,\n      schema: schemaValue\n    };\n    $[0] = primaryKeys;\n    $[1] = schemaValue;\n    $[2] = tableNameValue;\n    $[3] = t0;\n  } else {\n    t0 = $[3];\n  }\n  const deleteItem = useDeleteItem(t0);\n  let t1;\n  if ($[4] !== primaryKeys || $[5] !== schemaValue || $[6] !== tableNameValue) {\n    t1 = {\n      primaryKeys,\n      table: tableNameValue,\n      schema: schemaValue\n    };\n    $[4] = primaryKeys;\n    $[5] = schemaValue;\n    $[6] = tableNameValue;\n    $[7] = t1;\n  } else {\n    t1 = $[7];\n  }\n  const upsertItem = useUpsertItem(t1);\n  const [realtimeState, setRealtimeState] = useState(\"CLOSED\");\n  const [retryTick, setRetryTick] = useState(0);\n  const channelRef = useRef(null);\n  const lastRetryTimeRef = useRef(0);\n  const retryCountRef = useRef(0);\n  const enabled = options?.enabled ?? true;\n  const filter = options?.filter;\n  const onChange = options?.onChange;\n  const debouncedKey = useDelayedValue(key, 50);\n  let t2;\n  if ($[8] !== deleteItem || $[9] !== enabled || $[10] !== filter || $[11] !== onChange || $[12] !== primaryKeys || $[13] !== queriesForTable || $[14] !== query || $[15] !== retryTick || $[16] !== schemaValue || $[17] !== supabase || $[18] !== tableNameValue || $[19] !== upsertItem) {\n    t2 = () => {\n      if (!enabled) {\n        if (channelRef.current) {\n          channelRef.current.unsubscribe();\n          supabase.removeChannel(channelRef.current);\n          channelRef.current = null;\n        }\n        setRealtimeState(\"CLOSED\");\n        return;\n      }\n      const now = Date.now();\n      const timeSinceLastRetry = now - lastRetryTimeRef.current;\n      if (timeSinceLastRetry < 2000 && retryTick > 0) {\n        return;\n      }\n      if (channelRef.current) {\n        channelRef.current.unsubscribe();\n        supabase.removeChannel(channelRef.current);\n        channelRef.current = null;\n      }\n      lastRetryTimeRef.current = now;\n      retryCountRef.current = retryCountRef.current + 1;\n      const channel = supabase.channel(newUuid()).on(\"postgres_changes\", {\n        event: \"*\",\n        schema: schemaValue,\n        table: tableNameValue,\n        filter\n      }, async payload => {\n        let data = payload.new ?? payload.old;\n        if (payload.new && Object.keys(payload.new).length > 0) {\n          const selectQuery = buildNormalizedQuery({\n            queriesForTable,\n            query\n          });\n          if (payload.eventType !== REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE && selectQuery) {\n            if (selectQuery.groupedUserQueryPaths.every(x => x.path in data) === false) {\n              const qb = supabase.schema(payload.schema as any).from(payload.table as any).select(selectQuery.selectQuery);\n              for (const pk of primaryKeys) {\n                qb.eq(pk.toString(), data[pk]);\n              }\n              const res = await qb.single();\n              if (res.data) {\n                data = normalizeResponse(selectQuery.groupedPaths, res.data);\n              }\n            }\n          }\n          if (\"changedBySessionId\" in data) {\n            const sessionId = data.changedBySessionId;\n            if (sessionId !== UserSessionId) {\n              await upsertItem(data);\n            }\n          } else {\n            await upsertItem(data);\n          }\n        }\n        if (payload.eventType === REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE) {\n          await deleteItem(payload.old);\n        }\n        if (payload.errors?.length > 0) {\n          setRealtimeState(\"CHANNEL_ERROR\");\n        }\n        if (onChange) {\n          onChange(payload);\n        }\n      }).on(\"postgres_changes\", {\n        event: \"DELETE\",\n        schema: schemaValue,\n        table: tableNameValue\n      }, async payload_0 => {\n        if (payload_0.eventType === REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE) {\n          await deleteItem(payload_0.old);\n        }\n      }).subscribe(status => {\n        setRealtimeState(status);\n        if (status === \"SUBSCRIBED\") {\n          retryCountRef.current = 0;\n        }\n      });\n      channelRef.current = channel;\n      return () => {\n        if (channelRef.current) {\n          channelRef.current.unsubscribe();\n          supabase.removeChannel(channelRef.current);\n          channelRef.current = null;\n        }\n      };\n    };\n    $[8] = deleteItem;\n    $[9] = enabled;\n    $[10] = filter;\n    $[11] = onChange;\n    $[12] = primaryKeys;\n    $[13] = queriesForTable;\n    $[14] = query;\n    $[15] = retryTick;\n    $[16] = schemaValue;\n    $[17] = supabase;\n    $[18] = tableNameValue;\n    $[19] = upsertItem;\n    $[20] = t2;\n  } else {\n    t2 = $[20];\n  }\n  let t3;\n  if ($[21] !== primaryKeys) {\n    t3 = primaryKeys.join(\",\");\n    $[21] = primaryKeys;\n    $[22] = t3;\n  } else {\n    t3 = $[22];\n  }\n  let t4;\n  if ($[23] !== debouncedKey || $[24] !== enabled || $[25] !== filter || $[26] !== query || $[27] !== retryTick || $[28] !== schemaValue || $[29] !== supabase || $[30] !== t3 || $[31] !== tableNameValue) {\n    t4 = [supabase, tableNameValue, schemaValue, enabled, filter, query, t3, retryTick, debouncedKey];\n    $[23] = debouncedKey;\n    $[24] = enabled;\n    $[25] = filter;\n    $[26] = query;\n    $[27] = retryTick;\n    $[28] = schemaValue;\n    $[29] = supabase;\n    $[30] = t3;\n    $[31] = tableNameValue;\n    $[32] = t4;\n  } else {\n    t4 = $[32];\n  }\n  useEffect(t2, t4);\n  let t5;\n  let t6;\n  if ($[33] !== enabled || $[34] !== realtimeState) {\n    t5 = () => {\n      if (!enabled || realtimeState === \"SUBSCRIBED\") {\n        retryCountRef.current = 0;\n        return;\n      }\n      const delay = Math.min(5000 * Math.pow(2, retryCountRef.current), 60000);\n      const id = setTimeout(() => {\n        setRetryTick(_temp);\n      }, delay);\n      return () => clearTimeout(id);\n    };\n    t6 = [realtimeState, enabled];\n    $[33] = enabled;\n    $[34] = realtimeState;\n    $[35] = t5;\n    $[36] = t6;\n  } else {\n    t5 = $[35];\n    t6 = $[36];\n  }\n  useEffect(t5, t6);\n  return realtimeState;\n}\nfunction _temp(t) {\n  return t + 1;\n}","import { c as _c } from \"react/compiler-runtime\";\nimport { PostgrestSingleResponse } from \"@supabase/supabase-js\";\nimport { useMemo } from \"react\";\nimport { ItemType } from \"@pol-studios/utils\";\nimport { encode, useQuery } from \"@supabase-cache-helpers/postgrest-react-query\";\nimport { UseQueryOptions } from \"@tanstack/react-query\";\nimport useRealtime from \"./useRealtime\";\nimport { isNullOrWhitespace } from \"@pol-studios/utils\";\nimport { UseDbQuerySingleReturn } from \"../useDbQuery\";\nimport { PostgrestParser } from \"../parser/PostgrestParser\";\ntype ConfigurationOptions<T> = {\n  crossOrganization?: boolean;\n};\ntype FilterOperator = \"or\" | \"eq\" | \"neq\" | \"gt\" | \"gte\" | \"lt\" | \"lte\" | \"like\" | \"ilike\" | \"is\" | \"in\" | \"cs\" | \"cd\" | \"fts\" | \"plfts\";\ntype ValueType = number | string | boolean | null | Date | object;\ntype FilterDefinition = {\n  path: string;\n  alias?: string;\n  operator: FilterOperator;\n  negate: boolean;\n  value: ValueType;\n};\ntype FilterDefinitions = (FilterComposite | FilterDefinition)[];\ntype FilterComposite = {\n  or?: FilterDefinitions;\n  and?: FilterDefinitions;\n};\nexport type UseRealtimeQueryResult<T> = UseDbQuerySingleReturn<T> & {\n  realtimeStatus: \"SUBSCRIBED\" | \"TIMED_OUT\" | \"CLOSED\" | \"CHANNEL_ERROR\" | \"Loading...\";\n  isRealtimeConnected: boolean;\n  isRealtimeLoading: boolean;\n};\ntype DataType = Record<string, any>;\nexport function convertFilterToRealtimeQuery(filters: FilterDefinitions): string {\n  function convert(filter: FilterComposite | FilterDefinition): string {\n    //TODO: I just added this line to make it work\n    if (!filter) return \"\";\n    if (\"path\" in filter) {\n      if (filter.path.includes(\".\")) return \"\";\n      let valueString = filter.value?.toString() ?? \"null\";\n      if (filter.operator === \"in\") {\n        valueString = '(\"' + valueString.slice(2, valueString.length - 2).split(\",\").join('\",\"') + '\")';\n      }\n      return `${filter.path}=${filter.negate ? \"not.\" : \"\"}${filter.operator}.${valueString}`;\n    } else {\n      if (filter.or) {\n        return `(${filter.or.map(f => convert(f)).join(\"|\")})`;\n      } else if (filter.and) {\n        return `(${filter.and.map(f => convert(f)).join(\"&\")})`;\n      }\n    }\n    return \"\";\n  }\n\n  //todo: review later when multiple filters are available\n  return convert(filters[0]);\n}\nexport function useRealtimeQuery(query, config, t0) {\n  const $ = _c(27);\n  let t1;\n  if ($[0] !== t0) {\n    t1 = t0 === undefined ? [\"id\" as any] : t0;\n    $[0] = t0;\n    $[1] = t1;\n  } else {\n    t1 = $[1];\n  }\n  const primaryKeys = t1;\n  const t2 = query as any;\n  let t3;\n  if ($[2] !== t2) {\n    t3 = new PostgrestParser(t2);\n    $[2] = t2;\n    $[3] = t3;\n  } else {\n    t3 = $[3];\n  }\n  const parser = t3;\n  const request = useQuery(query, config as any);\n  let filter;\n  let selectStatement;\n  let t4;\n  let t5;\n  if ($[4] !== parser.filters || $[5] !== parser.select || $[6] !== query || $[7] !== request.data) {\n    const queryKey = encode(query, false);\n    let t6;\n    if ($[12] !== parser.filters || $[13] !== request.data) {\n      const filterString = convertFilterToRealtimeQuery(parser.filters);\n      filter = request.data && typeof request.data === \"object\" && \"id\" in request.data ? \"id=eq.\" + request.data.id : filterString;\n      if (filter.includes(\"in.(\\\\\\\"\\\\\\\")\")) {\n        filter = undefined;\n      }\n      t6 = isNullOrWhitespace(filter);\n      $[12] = parser.filters;\n      $[13] = request.data;\n      $[14] = filter;\n      $[15] = t6;\n    } else {\n      filter = $[14];\n      t6 = $[15];\n    }\n    if (t6) {\n      filter = undefined;\n    }\n    selectStatement = parser.select;\n    t4 = useRealtime;\n    t5 = queryKey.join(\"-\");\n    $[4] = parser.filters;\n    $[5] = parser.select;\n    $[6] = query;\n    $[7] = request.data;\n    $[8] = filter;\n    $[9] = selectStatement;\n    $[10] = t4;\n    $[11] = t5;\n  } else {\n    filter = $[8];\n    selectStatement = $[9];\n    t4 = $[10];\n    t5 = $[11];\n  }\n  let t6;\n  if ($[16] !== parser.schema || $[17] !== parser.table) {\n    t6 = {\n      schema: parser.schema,\n      table: parser.table\n    };\n    $[16] = parser.schema;\n    $[17] = parser.table;\n    $[18] = t6;\n  } else {\n    t6 = $[18];\n  }\n  const t7 = typeof config?.enabled === \"boolean\" ? config.enabled : true;\n  let t8;\n  if ($[19] !== filter || $[20] !== t7) {\n    t8 = {\n      filter,\n      enabled: t7\n    };\n    $[19] = filter;\n    $[20] = t7;\n    $[21] = t8;\n  } else {\n    t8 = $[21];\n  }\n  const realtimeStatus = t4(t5, selectStatement, t6, primaryKeys, t8);\n  const outputRealtimeStatus = request.isFetching ? \"Loading...\" : realtimeStatus;\n  const t9 = request.data as Result | null | undefined;\n  const t10 = realtimeStatus == \"SUBSCRIBED\";\n  let t11;\n  if ($[22] !== outputRealtimeStatus || $[23] !== request || $[24] !== t10 || $[25] !== t9) {\n    t11 = {\n      ...request,\n      data: t9,\n      realtimeStatus: outputRealtimeStatus,\n      isRealtimeConnected: t10,\n      isRealtimeLoading: request.isFetching\n    };\n    $[22] = outputRealtimeStatus;\n    $[23] = request;\n    $[24] = t10;\n    $[25] = t9;\n    $[26] = t11;\n  } else {\n    t11 = $[26];\n  }\n  return t11 as UseRealtimeQueryResult<Result>;\n}"],"mappings":"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","names":["_c","_c","t6"]}
+{"version":3,"sources":["../../src/realtime/useRealtime.ts","../../src/realtime/useRealtimeQuery.ts"],"sourcesContent":["import { c as _c } from \"react/compiler-runtime\";\nimport { useDeleteItem, useQueriesForTableLoader, useUpsertItem } from \"@supabase-cache-helpers/postgrest-react-query\";\nimport { useEffect, useState, useRef } from \"react\";\nimport useSupabase, { UserSessionId } from \"../useSupabase\";\nimport { newUuid } from \"@pol-studios/utils\";\nimport { buildNormalizedQuery, normalizeResponse } from \"@supabase-cache-helpers/postgrest-core\";\nimport { REALTIME_POSTGRES_CHANGES_LISTEN_EVENT, type RealtimePostgresChangesPayload } from \"@supabase/supabase-js\";\nimport { useDelayedValue } from \"@pol-studios/hooks/state\";\nexport default function useRealtime(key, query, table, primaryKeys, options) {\n  const $ = _c(37);\n  const supabase = useSupabase();\n  const tableNameValue = typeof table === \"string\" ? table : table.table;\n  const schemaValue = typeof table === \"string\" ? \"public\" : table.schema;\n  const queriesForTable = useQueriesForTableLoader(tableNameValue);\n  let t0;\n  if ($[0] !== primaryKeys || $[1] !== schemaValue || $[2] !== tableNameValue) {\n    t0 = {\n      primaryKeys,\n      table: tableNameValue,\n      schema: schemaValue\n    };\n    $[0] = primaryKeys;\n    $[1] = schemaValue;\n    $[2] = tableNameValue;\n    $[3] = t0;\n  } else {\n    t0 = $[3];\n  }\n  const deleteItem = useDeleteItem(t0);\n  let t1;\n  if ($[4] !== primaryKeys || $[5] !== schemaValue || $[6] !== tableNameValue) {\n    t1 = {\n      primaryKeys,\n      table: tableNameValue,\n      schema: schemaValue\n    };\n    $[4] = primaryKeys;\n    $[5] = schemaValue;\n    $[6] = tableNameValue;\n    $[7] = t1;\n  } else {\n    t1 = $[7];\n  }\n  const upsertItem = useUpsertItem(t1);\n  const [realtimeState, setRealtimeState] = useState(\"CLOSED\");\n  const [retryTick, setRetryTick] = useState(0);\n  const channelRef = useRef(null);\n  const lastRetryTimeRef = useRef(0);\n  const retryCountRef = useRef(0);\n  const enabled = options?.enabled ?? true;\n  const filter = options?.filter;\n  const onChange = options?.onChange;\n  const debouncedKey = useDelayedValue(key, 50);\n  let t2;\n  if ($[8] !== deleteItem || $[9] !== enabled || $[10] !== filter || $[11] !== onChange || $[12] !== primaryKeys || $[13] !== queriesForTable || $[14] !== query || $[15] !== retryTick || $[16] !== schemaValue || $[17] !== supabase || $[18] !== tableNameValue || $[19] !== upsertItem) {\n    t2 = () => {\n      if (!enabled) {\n        if (channelRef.current) {\n          channelRef.current.unsubscribe();\n          supabase.removeChannel(channelRef.current);\n          channelRef.current = null;\n        }\n        setRealtimeState(\"CLOSED\");\n        return;\n      }\n      const now = Date.now();\n      const timeSinceLastRetry = now - lastRetryTimeRef.current;\n      if (timeSinceLastRetry < 2000 && retryTick > 0) {\n        return;\n      }\n      if (channelRef.current) {\n        channelRef.current.unsubscribe();\n        supabase.removeChannel(channelRef.current);\n        channelRef.current = null;\n      }\n      lastRetryTimeRef.current = now;\n      retryCountRef.current = retryCountRef.current + 1;\n      const channel = supabase.channel(newUuid()).on(\"postgres_changes\", {\n        event: \"*\",\n        schema: schemaValue,\n        table: tableNameValue,\n        filter\n      }, async payload => {\n        let data = payload.new ?? payload.old;\n        if (payload.new && Object.keys(payload.new).length > 0) {\n          const selectQuery = buildNormalizedQuery({\n            queriesForTable,\n            query\n          });\n          if (payload.eventType !== REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE && selectQuery) {\n            if (selectQuery.groupedUserQueryPaths?.every(x => x.path in data) === false) {\n              const qb = supabase.schema(payload.schema as any).from(payload.table as any).select(selectQuery.selectQuery);\n              for (const pk of primaryKeys) {\n                qb.eq(pk.toString(), data[pk]);\n              }\n              const res = await qb.single();\n              if (res.data) {\n                data = normalizeResponse(selectQuery.groupedPaths, res.data);\n              }\n            }\n          }\n          if (\"changedBySessionId\" in data) {\n            const sessionId = data.changedBySessionId;\n            if (sessionId !== UserSessionId) {\n              await upsertItem(data);\n            }\n          } else {\n            await upsertItem(data);\n          }\n        }\n        if (payload.eventType === REALTIME_POSTGRES_CHANGES_LISTEN_EVENT.DELETE) {\n          await deleteItem(payload.old);\n        }\n        if (payload.errors?.length > 0) {\n          setRealtimeState(\"CHANNEL_ERROR\");\n        }\n        if (onChange) {\n          onChange(payload);\n        }\n      }).subscribe(status => {\n        setRealtimeState(status);\n        if (status === \"SUBSCRIBED\") {\n          retryCountRef.current = 0;\n        }\n      });\n      channelRef.current = channel;\n      return () => {\n        if (channelRef.current) {\n          channelRef.current.unsubscribe();\n          supabase.removeChannel(channelRef.current);\n          channelRef.current = null;\n        }\n      };\n    };\n    $[8] = deleteItem;\n    $[9] = enabled;\n    $[10] = filter;\n    $[11] = onChange;\n    $[12] = primaryKeys;\n    $[13] = queriesForTable;\n    $[14] = query;\n    $[15] = retryTick;\n    $[16] = schemaValue;\n    $[17] = supabase;\n    $[18] = tableNameValue;\n    $[19] = upsertItem;\n    $[20] = t2;\n  } else {\n    t2 = $[20];\n  }\n  let t3;\n  if ($[21] !== primaryKeys) {\n    t3 = primaryKeys.join(\",\");\n    $[21] = primaryKeys;\n    $[22] = t3;\n  } else {\n    t3 = $[22];\n  }\n  let t4;\n  if ($[23] !== debouncedKey || $[24] !== enabled || $[25] !== filter || $[26] !== query || $[27] !== retryTick || $[28] !== schemaValue || $[29] !== supabase || $[30] !== t3 || $[31] !== tableNameValue) {\n    t4 = [supabase, tableNameValue, schemaValue, enabled, filter, query, t3, retryTick, debouncedKey];\n    $[23] = debouncedKey;\n    $[24] = enabled;\n    $[25] = filter;\n    $[26] = query;\n    $[27] = retryTick;\n    $[28] = schemaValue;\n    $[29] = supabase;\n    $[30] = t3;\n    $[31] = tableNameValue;\n    $[32] = t4;\n  } else {\n    t4 = $[32];\n  }\n  useEffect(t2, t4);\n  let t5;\n  let t6;\n  if ($[33] !== enabled || $[34] !== realtimeState) {\n    t5 = () => {\n      if (!enabled || realtimeState === \"SUBSCRIBED\") {\n        retryCountRef.current = 0;\n        return;\n      }\n      const delay = Math.min(5000 * Math.pow(2, retryCountRef.current), 60000);\n      const id = setTimeout(() => {\n        setRetryTick(_temp);\n      }, delay);\n      return () => clearTimeout(id);\n    };\n    t6 = [realtimeState, enabled];\n    $[33] = enabled;\n    $[34] = realtimeState;\n    $[35] = t5;\n    $[36] = t6;\n  } else {\n    t5 = $[35];\n    t6 = $[36];\n  }\n  useEffect(t5, t6);\n  return realtimeState;\n}\nfunction _temp(t) {\n  return t + 1;\n}","import { c as _c } from \"react/compiler-runtime\";\nimport { PostgrestSingleResponse } from \"@supabase/supabase-js\";\nimport { useMemo } from \"react\";\nimport { ItemType } from \"@pol-studios/utils\";\nimport { encode, useQuery } from \"@supabase-cache-helpers/postgrest-react-query\";\nimport { UseQueryOptions } from \"@tanstack/react-query\";\nimport useRealtime from \"./useRealtime\";\nimport { isNullOrWhitespace } from \"@pol-studios/utils\";\nimport { UseDbQuerySingleReturn } from \"../useDbQuery\";\nimport { PostgrestParser } from \"../parser/PostgrestParser\";\ntype ConfigurationOptions<T> = {\n  crossOrganization?: boolean;\n};\ntype FilterOperator = \"or\" | \"eq\" | \"neq\" | \"gt\" | \"gte\" | \"lt\" | \"lte\" | \"like\" | \"ilike\" | \"is\" | \"in\" | \"cs\" | \"cd\" | \"fts\" | \"plfts\";\ntype ValueType = number | string | boolean | null | Date | object;\ntype FilterDefinition = {\n  path: string;\n  alias?: string;\n  operator: FilterOperator;\n  negate: boolean;\n  value: ValueType;\n};\ntype FilterDefinitions = (FilterComposite | FilterDefinition)[];\ntype FilterComposite = {\n  or?: FilterDefinitions;\n  and?: FilterDefinitions;\n};\nexport type UseRealtimeQueryResult<T> = UseDbQuerySingleReturn<T> & {\n  realtimeStatus: \"SUBSCRIBED\" | \"TIMED_OUT\" | \"CLOSED\" | \"CHANNEL_ERROR\" | \"Loading...\";\n  isRealtimeConnected: boolean;\n  isRealtimeLoading: boolean;\n};\ntype DataType = Record<string, any>;\nexport function convertFilterToRealtimeQuery(filters: FilterDefinitions): string {\n  function convert(filter: FilterComposite | FilterDefinition): string {\n    //TODO: I just added this line to make it work\n    if (!filter) return \"\";\n    if (\"path\" in filter) {\n      if (filter.path.includes(\".\")) return \"\";\n      let valueString = filter.value?.toString() ?? \"null\";\n      if (filter.operator === \"in\") {\n        valueString = '(\"' + valueString.slice(2, valueString.length - 2).split(\",\").join('\",\"') + '\")';\n      }\n      return `${filter.path}=${filter.negate ? \"not.\" : \"\"}${filter.operator}.${valueString}`;\n    } else {\n      if (filter.or) {\n        return `(${filter.or.map(f => convert(f)).join(\"|\")})`;\n      } else if (filter.and) {\n        return `(${filter.and.map(f => convert(f)).join(\"&\")})`;\n      }\n    }\n    return \"\";\n  }\n\n  //todo: review later when multiple filters are available\n  return convert(filters[0]);\n}\nexport function useRealtimeQuery(query, config, t0) {\n  const $ = _c(27);\n  let t1;\n  if ($[0] !== t0) {\n    t1 = t0 === undefined ? [\"id\" as any] : t0;\n    $[0] = t0;\n    $[1] = t1;\n  } else {\n    t1 = $[1];\n  }\n  const primaryKeys = t1;\n  const t2 = query as any;\n  let t3;\n  if ($[2] !== t2) {\n    t3 = new PostgrestParser(t2);\n    $[2] = t2;\n    $[3] = t3;\n  } else {\n    t3 = $[3];\n  }\n  const parser = t3;\n  const request = useQuery(query, config as any);\n  let filter;\n  let selectStatement;\n  let t4;\n  let t5;\n  if ($[4] !== parser.filters || $[5] !== parser.select || $[6] !== query || $[7] !== request.data) {\n    const queryKey = encode(query, false);\n    let t6;\n    if ($[12] !== parser.filters || $[13] !== request.data) {\n      const filterString = convertFilterToRealtimeQuery(parser.filters);\n      filter = request.data && typeof request.data === \"object\" && \"id\" in request.data ? \"id=eq.\" + request.data.id : filterString;\n      if (filter.includes(\"in.(\\\\\\\"\\\\\\\")\")) {\n        filter = undefined;\n      }\n      t6 = isNullOrWhitespace(filter);\n      $[12] = parser.filters;\n      $[13] = request.data;\n      $[14] = filter;\n      $[15] = t6;\n    } else {\n      filter = $[14];\n      t6 = $[15];\n    }\n    if (t6) {\n      filter = undefined;\n    }\n    selectStatement = parser.select;\n    t4 = useRealtime;\n    t5 = queryKey.join(\"-\");\n    $[4] = parser.filters;\n    $[5] = parser.select;\n    $[6] = query;\n    $[7] = request.data;\n    $[8] = filter;\n    $[9] = selectStatement;\n    $[10] = t4;\n    $[11] = t5;\n  } else {\n    filter = $[8];\n    selectStatement = $[9];\n    t4 = $[10];\n    t5 = $[11];\n  }\n  let t6;\n  if ($[16] !== parser.schema || $[17] !== parser.table) {\n    t6 = {\n      schema: parser.schema,\n      table: parser.table\n    };\n    $[16] = parser.schema;\n    $[17] = parser.table;\n    $[18] = t6;\n  } else {\n    t6 = $[18];\n  }\n  const t7 = typeof config?.enabled === \"boolean\" ? config.enabled : true;\n  let t8;\n  if ($[19] !== filter || $[20] !== t7) {\n    t8 = {\n      filter,\n      enabled: t7\n    };\n    $[19] = filter;\n    $[20] = t7;\n    $[21] = t8;\n  } else {\n    t8 = $[21];\n  }\n  const realtimeStatus = t4(t5, selectStatement, t6, primaryKeys, t8);\n  const outputRealtimeStatus = request.isFetching ? \"Loading...\" : realtimeStatus;\n  const t9 = request.data as Result | null | undefined;\n  const t10 = realtimeStatus == \"SUBSCRIBED\";\n  let t11;\n  if ($[22] !== outputRealtimeStatus || $[23] !== request || $[24] !== t10 || $[25] !== t9) {\n    t11 = {\n      ...request,\n      data: t9,\n      realtimeStatus: outputRealtimeStatus,\n      isRealtimeConnected: t10,\n      isRealtimeLoading: request.isFetching\n    };\n    $[22] = outputRealtimeStatus;\n    $[23] = request;\n    $[24] = t10;\n    $[25] = t9;\n    $[26] = t11;\n  } else {\n    t11 = $[26];\n  }\n  return t11 as UseRealtimeQueryResult<Result>;\n}"],"mappings":"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","names":["_c","_c","t6"]}

package/dist/select-parser-BAV7fOaM.d.ts

@@ -0,0 +1,144 @@
+import { ParsedSelect, SelectRelation } from './core/index.js';
+
+/**
+ * Select String Parser
+ *
+ * Parses Supabase PostgREST select syntax into an AST for local SQLite processing.
+ *
+ * Supported Syntax:
+ * - "*"                                    -> All columns
+ * - "id, name, status"                     -> Specific columns
+ * - "*, RelatedTable(*)"                   -> All columns + relation
+ * - "id, RelatedTable(id, name)"           -> Specific + relation with specific columns
+ * - "*, Parent(*, Grandparent(name))"      -> Nested relations
+ * - "*, items:RelatedTable(*)"             -> Aliased relation
+ * - "aliasName:columnName"                 -> Aliased column
+ */
+
+/**
+ * Tokenize a string at the top level, respecting parentheses nesting.
+ * Splits by comma but keeps nested parentheses intact.
+ *
+ * @example
+ * tokenizeTopLevel("id, name, Parent(*, Child(name))")
+ * // Returns: ["id", "name", "Parent(*, Child(name))"]
+ */
+declare function tokenizeTopLevel(input: string): string[];
+/**
+ * Parse a Supabase PostgREST select string into an AST.
+ *
+ * @param select - The select string (e.g., "*, RelatedTable(*)")
+ * @returns Parsed select AST
+ *
+ * @example
+ * parseSelect("*")
+ * // Returns: { columns: "*", relations: [] }
+ *
+ * parseSelect("id, name, status")
+ * // Returns: {
+ * //   columns: [{ name: "id" }, { name: "name" }, { name: "status" }],
+ * //   relations: []
+ * // }
+ *
+ * parseSelect("*, EquipmentFixture(*)")
+ * // Returns: {
+ * //   columns: "*",
+ * //   relations: [{ name: "EquipmentFixture", columns: "*", relations: [] }]
+ * // }
+ *
+ * parseSelect("id, name, ProjectDatabase(name, Organization(*))")
+ * // Returns: {
+ * //   columns: [{ name: "id" }, { name: "name" }],
+ * //   relations: [{
+ * //     name: "ProjectDatabase",
+ * //     columns: [{ name: "name" }],
+ * //     relations: [{ name: "Organization", columns: "*", relations: [] }]
+ * //   }]
+ * // }
+ */
+declare function parseSelect(select: string): ParsedSelect;
+/**
+ * Convert a parsed select back to a string representation (for debugging)
+ */
+declare function stringifySelect(parsed: ParsedSelect): string;
+/**
+ * Extract all column names from a parsed select (for building SQL queries)
+ * Does not include relation names.
+ */
+declare function extractColumnNames(parsed: ParsedSelect): string[] | "*";
+/**
+ * Extract all relation names from a parsed select
+ */
+declare function extractRelationNames(parsed: ParsedSelect): string[];
+/**
+ * Check if a select string references a specific relation
+ */
+declare function hasRelation(parsed: ParsedSelect, relationName: string): boolean;
+/**
+ * Get the select configuration for a specific relation
+ */
+declare function getRelationSelect(parsed: ParsedSelect, relationName: string): SelectRelation | undefined;
+/**
+ * Check if a parsed select contains any explicit FK relations.
+ * This is used to determine if QueryExecutor should be used instead of PostgREST.
+ *
+ * @param parsed - The parsed select statement
+ * @returns true if any relation uses explicit FK syntax
+ */
+declare function hasExplicitFk(parsed: ParsedSelect): boolean;
+/**
+ * Check if a select string contains explicit FK syntax.
+ * Quick check without full parsing for performance.
+ *
+ * @param select - The select string
+ * @returns true if the string contains explicit FK syntax (! followed by field:table)
+ */
+declare function selectHasExplicitFkSyntax(select: string): boolean;
+/**
+ * Information about an explicit FK relation extracted from a select string.
+ * Used for setting up realtime subscriptions on related tables.
+ */
+interface ExtractedExplicitFk {
+    /** The alias used for this relation in the select string (e.g., "Sender") */
+    alias: string;
+    /** The FK column on the parent table (e.g., "senderId") */
+    sourceField: string;
+    /** The target table, optionally schema-qualified (e.g., "core.Profile") */
+    targetTable: string;
+    /** Column to match in target table, defaults to "id" */
+    targetColumn: string;
+}
+/**
+ * Extract all explicit FK relations from a parsed select statement.
+ * Recursively traverses the relation tree to find all explicit FK specs.
+ *
+ * @param parsed - The parsed select statement
+ * @returns Array of extracted explicit FK relations
+ *
+ * @example
+ * const parsed = parseSelect("*, Sender!senderId:core.Profile(*), Recipient!recipientId:core.Profile(*)");
+ * const explicitFks = extractExplicitFkRelations(parsed);
+ * // Returns:
+ * // [
+ * //   { alias: "Sender", sourceField: "senderId", targetTable: "core.Profile", targetColumn: "id" },
+ * //   { alias: "Recipient", sourceField: "recipientId", targetTable: "core.Profile", targetColumn: "id" }
+ * // ]
+ */
+declare function extractExplicitFkRelations(parsed: ParsedSelect): ExtractedExplicitFk[];
+/**
+ * Extract all unique target table names from explicit FK relations in a select string.
+ * This is useful for setting up realtime watchers on related tables.
+ *
+ * @param select - The select string (e.g., "*, Sender!senderId:core.Profile(*)")
+ * @returns Array of unique target table names
+ *
+ * @example
+ * extractExplicitFkTables("*, Sender!senderId:core.Profile(*), Recipient!recipientId:core.Profile(*)")
+ * // Returns: ["core.Profile"]
+ *
+ * extractExplicitFkTables("*, Author!authorId:User(*), Editor!editorId:Admin(*)")
+ * // Returns: ["User", "Admin"]
+ */
+declare function extractExplicitFkTables(select: string): string[];
+
+export { type ExtractedExplicitFk as E, extractRelationNames as a, hasExplicitFk as b, selectHasExplicitFkSyntax as c, extractExplicitFkRelations as d, extractColumnNames as e, extractExplicitFkTables as f, getRelationSelect as g, hasRelation as h, parseSelect as p, stringifySelect as s, tokenizeTopLevel as t };

package/dist/types/index.d.ts

@@ -1,10 +1,10 @@
 export { a as FilterConfig, F as FilterConfigOption, G as Group, P as PropertyType, S as SortConfig, T as TableInfo, V as ValueForPropertyType, b as WhereClause, 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 { 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 { D as Database } from '../database.types-ChFCG-4M.js';
 import 'moment';
 import '@supabase/supabase-js';
 import 'react';
 import '@tanstack/react-query';
 import '../core/index.js';
-import '../DataLayerContext-C7cJtiO8.js';
-import '../executor-YJw4m7Q7.js';
+import '../DataLayerContext-BYZtDD0g.js';
+import '../executor-D15yjeMo.js';

package/dist/types/index.js

@@ -1,11 +1,11 @@
 import {
   createCombinedStatus
-} from "../chunk-Z3EJX3VG.js";
+} from "../chunk-Z456IHCB.js";
 import "../chunk-GC3TBUWE.js";
-import "../chunk-UJWETW36.js";
+import "../chunk-JOULSXOI.js";
 import "../chunk-J4ZVCXZ4.js";
-import "../chunk-CTRY7JDP.js";
-import "../chunk-INEUG6MC.js";
+import "../chunk-YUX6RGLZ.js";
+import "../chunk-AKIRHA4Q.js";
 import "../chunk-DMVUEJG2.js";
 import "../chunk-7D4SUZUM.js";
 export {

package/dist/{useDbCount-DHLJzmkO.d.ts → useDbCount-Ckb-FhZk.d.ts}

@@ -1,4 +1,4 @@
-import { r as DataLayerContextValue, s as DataLayerCoreContextValue, t as DataLayerStatusContextValue } from './DataLayerContext-C7cJtiO8.js';
+import { r as DataLayerContextValue, s as DataLayerCoreContextValue, t as DataLayerStatusContextValue } from './DataLayerContext-BYZtDD0g.js';
 import { Dispatch, SetStateAction } from 'react';
 import { QueryOptions, WhereClause } from './core/index.js';
 

package/dist/{useResolveFeedback-B0UcYWVI.d.ts → useResolveFeedback-CuUkdHoR.d.ts}

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationResult, UseMutationOptions, UseQueryOptions } from '@tanstack/react-query';
 import { SupabaseClient, PostgrestSingleResponse as PostgrestSingleResponse$1, PostgrestError } from '@supabase/supabase-js';
-import { T as TableDataAdapter, C as CapableDataAdapter, c as AdapterCapabilities, A as AdapterQueryResult } from './DataLayerContext-C7cJtiO8.js';
+import { T as TableDataAdapter, C as CapableDataAdapter, c as AdapterCapabilities, A as AdapterQueryResult } from './DataLayerContext-BYZtDD0g.js';
 import { DatabaseSchema, QueryOptions } from './core/index.js';
 import { FunctionsResponse } from '@supabase/functions-js';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
@@ -9,9 +9,9 @@ import { PostgrestSingleResponse } from '@supabase/postgrest-js';
 import { G as GetResult } from './select-query-parser-BwyHum1L.js';
 import { G as GenericTable } from './types-CYr9JiUE.js';
 import { D as Database } from './useSupabase-DSZNeXnF.js';
-import { D as DbChangeLog, Q as QueryState } from './index-jVYdTeWx.js';
+import { D as DbChangeLog, Q as QueryState } from './index-CFUuTzXO.js';
 import { U as UseDbQuerySingleReturn } from './useDbQuery-C-TL8jY1.js';
-import { J as UseDbUpsertResult } from './useDbCount-DHLJzmkO.js';
+import { J as UseDbUpsertResult } from './useDbCount-Ckb-FhZk.js';
 import { Moment } from 'moment';
 import * as react from 'react';
 import { ReactNode } from 'react';
@@ -44,6 +44,9 @@ declare function useMutationSuccessRN<TData, TError, TVariables>(mutation: UseMu
  *
  * Implements the TableDataAdapter interface for direct Supabase/PostgREST queries.
  * This adapter is used for online-only data access without local caching.
+ *
+ * Supports explicit FK syntax (e.g., `Sender!senderId:core.Profile(*)`) by routing
+ * those queries through SupabaseQueryExecutor for client-side join merging.
  */
 
 /**
@@ -73,15 +76,16 @@ declare class SupabaseAdapter implements TableDataAdapter, CapableDataAdapter {
     private schema;
     readonly name = "supabase";
     readonly capabilities: AdapterCapabilities;
+    /**
+     * Query executor for handling explicit FK syntax.
+     * Lazily initialized when needed.
+     */
+    private queryExecutor;
     constructor(supabase: SupabaseClient, schema: DatabaseSchema);
     /**
-     * Parse a table identifier to extract schema and table name.
-     * Handles schema-qualified names like "core.Profile" -> { schema: "core", tableName: "Profile" }
-     *
-     * @param table - The table name, optionally schema-qualified (e.g., "users" or "core.Profile")
-     * @returns Object with schema (defaults to "public") and tableName
+     * Get or create the SupabaseQueryExecutor for explicit FK queries.
      */
-    private parseTableIdentifier;
+    private getQueryExecutor;
     /**
      * Check if a where clause contains invalid UUID values (empty strings for id fields).
      * Returns true if any id field has an empty string value.
@@ -150,26 +154,6 @@ declare class SupabaseAdapter implements TableDataAdapter, CapableDataAdapter {
      * @returns Unsubscribe function
      */
     subscribe<T>(table: string, options: QueryOptions, callback: (data: T[]) => void): () => void;
-    /**
-     * Apply where clause filters to a Supabase query
-     *
-     * Converts WhereClause to Supabase filter methods:
-     * - Direct value: .eq(field, value)
-     * - { in: [...] }: .in(field, values)
-     * - { gt: n }: .gt(field, n)
-     * - { gte: n }: .gte(field, n)
-     * - { lt: n }: .lt(field, n)
-     * - { lte: n }: .lte(field, n)
-     * - { like: s }: .ilike(field, s)
-     * - { is: null }: .is(field, null)
-     * - { neq: v }: .neq(field, v) or .not(field, "is", null)
-     * - { notIn: [...] }: .not().in(field, values)
-     *
-     * @param query - The Supabase query builder
-     * @param where - The where clause to apply
-     * @returns The query with filters applied
-     */
-    private applyWhereClause;
 }
 /**
  * Create a new SupabaseAdapter instance

package/dist/with-auth/index.js

@@ -5,27 +5,29 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "../chunk-FIAXWEBK.js";
+} from "../chunk-4EO55YV2.js";
 import {
   useDbUpsert
-} from "../chunk-3Q74DK5K.js";
+} from "../chunk-VYFAMTHI.js";
 import "../chunk-SM73S2DY.js";
 import "../chunk-NSIAAYW3.js";
 import {
   useAuth,
   useSetupAuth
-} from "../chunk-FMYXG4VN.js";
+} from "../chunk-MEBT5YHA.js";
 import {
   useDbQuery
-} from "../chunk-DP3YEVSX.js";
-import "../chunk-WQLIGVQR.js";
+} from "../chunk-6SDH7M7J.js";
+import "../chunk-GWYTROSD.js";
 import "../chunk-RT4O5H2E.js";
 import {
   getSupabaseUrl
 } from "../chunk-GC3TBUWE.js";
+import "../chunk-W7PERM66.js";
+import "../chunk-QYAFI34Q.js";
 import "../chunk-J4ZVCXZ4.js";
-import "../chunk-CTRY7JDP.js";
-import "../chunk-INEUG6MC.js";
+import "../chunk-YUX6RGLZ.js";
+import "../chunk-AKIRHA4Q.js";
 import {
   useSupabase
 } from "../chunk-DMVUEJG2.js";