@pol-studios/db 1.0.54 → 1.0.55

package/dist/index.js

@@ -24,7 +24,7 @@ import {
   useHasConflicts,
   usePendingConflicts,
   useSupabaseUpload
-} from "./chunk-BZSAPFFB.js";
+} from "./chunk-AA3VUWTP.js";
 import {
   ADAPTER_STRATEGIES,
   AdapterAutoDetector,
@@ -77,7 +77,7 @@ import {
   useUpsertChangelog,
   useUpsertChangelogEntry,
   useUpsertChangelogMedia
-} from "./chunk-2XS2PM62.js";
+} from "./chunk-OC6S4XFL.js";
 import {
   LiveChangeContext,
   LiveChangeContextProvider,
@@ -88,7 +88,7 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "./chunk-FIAXWEBK.js";
+} from "./chunk-7YGDT46S.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-AKCNWHXV.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-BRFFTGVJ.js";
 import {
   DEFAULT_QUERY_TIMEOUT,
   TIMEOUT_ERROR_MESSAGE,
   isTimeoutError
-} from "./chunk-DP3YEVSX.js";
+} from "./chunk-WILXD5X3.js";
 import {
   DataLayerContext,
   DataLayerCoreContext,
@@ -337,7 +337,7 @@ import {
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "./chunk-WQLIGVQR.js";
+} from "./chunk-WSKBZIEI.js";
 import "./chunk-RT4O5H2E.js";
 import "./chunk-HZIVE5AZ.js";
 import {
@@ -347,7 +347,7 @@ import {
 import {
   useBatchDelete,
   useBatchUpsert
-} from "./chunk-ZGQ7Q4ZU.js";
+} from "./chunk-WM25QE7E.js";
 import {
   OPERATOR_MAP,
   PostgrestParser,
@@ -361,10 +361,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

@@ -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-AA3VUWTP.js";
 import {
   ADAPTER_STRATEGIES,
   AdapterAutoDetector,
@@ -65,7 +65,7 @@ import {
   useUpsertChangelog,
   useUpsertChangelogEntry,
   useUpsertChangelogMedia
-} from "./chunk-2XS2PM62.js";
+} from "./chunk-OC6S4XFL.js";
 import {
   LiveChangeContext,
   LiveChangeContextProvider,
@@ -76,7 +76,7 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "./chunk-FIAXWEBK.js";
+} from "./chunk-7YGDT46S.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-AKCNWHXV.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-BRFFTGVJ.js";
 import {
   DEFAULT_QUERY_TIMEOUT,
   TIMEOUT_ERROR_MESSAGE,
   isTimeoutError
-} from "./chunk-DP3YEVSX.js";
+} from "./chunk-WILXD5X3.js";
 import {
   DataLayerContext,
   DataLayerCoreContext,
@@ -326,7 +326,7 @@ import {
   useDataLayerStatus,
   useDbQuery,
   useDbQueryById
-} from "./chunk-WQLIGVQR.js";
+} from "./chunk-WSKBZIEI.js";
 import "./chunk-RT4O5H2E.js";
 import "./chunk-HZIVE5AZ.js";
 import {
@@ -336,7 +336,7 @@ import {
 import {
   useBatchDelete,
   useBatchUpsert
-} from "./chunk-ZGQ7Q4ZU.js";
+} from "./chunk-WM25QE7E.js";
 import {
   OPERATOR_MAP,
   PostgrestParser,
@@ -350,10 +350,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.js

@@ -56,7 +56,7 @@ import {
   useUpsertChangelog,
   useUpsertChangelogEntry,
   useUpsertChangelogMedia
-} from "./chunk-2XS2PM62.js";
+} from "./chunk-OC6S4XFL.js";
 import {
   LiveChangeContext,
   LiveChangeContextProvider,
@@ -67,7 +67,7 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "./chunk-FIAXWEBK.js";
+} from "./chunk-7YGDT46S.js";
 import {
   PostgrestFilter,
   binarySearch,
@@ -95,7 +95,7 @@ import {
   removeAliasFromDeclaration,
   removeFirstPathElement,
   setFilterValue
-} from "./chunk-YA6MUTA7.js";
+} from "./chunk-FI6JAD5G.js";
 import {
   useAdvanceQuery,
   useDbCount,
@@ -104,13 +104,13 @@ import {
   useDbInsert,
   useDbUpdate,
   useDbUpsert
-} from "./chunk-3Q74DK5K.js";
+} from "./chunk-AKCNWHXV.js";
 import {
   Constants,
   createCombinedStatus,
   normalizeFilter,
   useDbAdvanceFilterQuery
-} from "./chunk-Z3EJX3VG.js";
+} from "./chunk-Z456IHCB.js";
 import {
   Accessory,
   Address,
@@ -299,20 +299,20 @@ import {
   UserMetadata
 } from "./chunk-SM73S2DY.js";
 import "./chunk-NSIAAYW3.js";
-import "./chunk-FMYXG4VN.js";
+import "./chunk-BRFFTGVJ.js";
 import {
   DEFAULT_QUERY_TIMEOUT,
   TIMEOUT_ERROR_MESSAGE,
   isTimeoutError,
   useDbQuery as useDbQuery2
-} from "./chunk-DP3YEVSX.js";
+} from "./chunk-WILXD5X3.js";
 import {
   DataLayerContext,
   useDataLayer,
   useDataLayerOptional,
   useDbQuery,
   useDbQueryById
-} from "./chunk-WQLIGVQR.js";
+} from "./chunk-WSKBZIEI.js";
 import "./chunk-RT4O5H2E.js";
 import {
   useAdvancedFilterQuery,
@@ -321,7 +321,7 @@ import {
   usePartialAdvancedQuery,
   usePartialQuery,
   useQuery
-} from "./chunk-OKYHI6JG.js";
+} from "./chunk-LF3V3ERS.js";
 import {
   QueryExecutor,
   RelationshipResolver,
@@ -346,7 +346,7 @@ import {
 import {
   useBatchDelete,
   useBatchUpsert
-} from "./chunk-ZGQ7Q4ZU.js";
+} from "./chunk-WM25QE7E.js";
 import {
   OPERATOR_MAP,
   PostgrestParser,
@@ -360,14 +360,14 @@ import {
   parseSelectParam,
   parseValue,
   sortSearchParams
-} from "./chunk-UJWETW36.js";
+} from "./chunk-JOULSXOI.js";
 import "./chunk-J4ZVCXZ4.js";
 import {
   encode,
   useInsertMutation,
   useUpsertItem
-} from "./chunk-CTRY7JDP.js";
-import "./chunk-INEUG6MC.js";
+} from "./chunk-YUX6RGLZ.js";
+import "./chunk-AKIRHA4Q.js";
 import {
   ClientInstanceId,
   SupabaseProvider,

package/dist/mutation/index.js

@@ -1,15 +1,15 @@
 import {
   useBatchDelete,
   useBatchUpsert
-} from "../chunk-ZGQ7Q4ZU.js";
+} from "../chunk-WM25QE7E.js";
 import {
   buildNormalizedQuery,
   useDeleteItem,
   useInsertMutation,
   useQueriesForTableLoader,
   useUpsertItem
-} from "../chunk-CTRY7JDP.js";
-import "../chunk-INEUG6MC.js";
+} from "../chunk-YUX6RGLZ.js";
+import "../chunk-AKIRHA4Q.js";
 import {
   useSupabase
 } from "../chunk-DMVUEJG2.js";

package/dist/parser/index.js

@@ -25,7 +25,7 @@ import {
   removeAliasFromDeclaration,
   removeFirstPathElement,
   setFilterValue
-} from "../chunk-YA6MUTA7.js";
+} from "../chunk-FI6JAD5G.js";
 import {
   OPERATOR_MAP,
   PostgrestParser,
@@ -39,8 +39,8 @@ import {
   parseSelectParam,
   parseValue,
   sortSearchParams
-} from "../chunk-UJWETW36.js";
-import "../chunk-INEUG6MC.js";
+} from "../chunk-JOULSXOI.js";
+import "../chunk-AKIRHA4Q.js";
 import "../chunk-7D4SUZUM.js";
 export {
   OPERATOR_MAP,

package/dist/query/index.js

@@ -5,7 +5,7 @@ import {
   usePartialAdvancedQuery,
   usePartialQuery,
   useQuery
-} from "../chunk-OKYHI6JG.js";
+} from "../chunk-LF3V3ERS.js";
 import {
   QueryExecutor,
   RelationshipResolver,
@@ -24,10 +24,10 @@ import {
   tokenizeTopLevel
 } from "../chunk-HZIVE5AZ.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/realtime/index.js

@@ -1,6 +1,6 @@
 import {
   PostgrestParser
-} from "../chunk-UJWETW36.js";
+} from "../chunk-JOULSXOI.js";
 import "../chunk-J4ZVCXZ4.js";
 import {
   buildNormalizedQuery,
@@ -10,8 +10,8 @@ import {
   useQueriesForTableLoader,
   useQuery,
   useUpsertItem
-} from "../chunk-CTRY7JDP.js";
-import "../chunk-INEUG6MC.js";
+} from "../chunk-YUX6RGLZ.js";
+import "../chunk-AKIRHA4Q.js";
 import {
   UserSessionId,
   useSupabase

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/with-auth/index.js

@@ -5,27 +5,27 @@ import {
   useUserMetadataState,
   useUserMetadataValue,
   userMetadataContext
-} from "../chunk-FIAXWEBK.js";
+} from "../chunk-7YGDT46S.js";
 import {
   useDbUpsert
-} from "../chunk-3Q74DK5K.js";
+} from "../chunk-AKCNWHXV.js";
 import "../chunk-SM73S2DY.js";
 import "../chunk-NSIAAYW3.js";
 import {
   useAuth,
   useSetupAuth
-} from "../chunk-FMYXG4VN.js";
+} from "../chunk-BRFFTGVJ.js";
 import {
   useDbQuery
-} from "../chunk-DP3YEVSX.js";
-import "../chunk-WQLIGVQR.js";
+} from "../chunk-WILXD5X3.js";
+import "../chunk-WSKBZIEI.js";
 import "../chunk-RT4O5H2E.js";
 import {
   getSupabaseUrl
 } from "../chunk-GC3TBUWE.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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pol-studios/db",
-  "version": "1.0.54",
+  "version": "1.0.55",
   "description": "Database layer for React applications with Supabase and PowerSync support",
   "license": "UNLICENSED",
   "type": "module",
@@ -189,14 +189,16 @@
   },
   "dependencies": {
     "@supabase/postgrest-js": "^2.87.1",
-    "@pol-studios/utils": "1.0.13",
-    "@pol-studios/hooks": "1.0.14"
+    "fast-json-stable-stringify": "^2.1.0",
+    "@pol-studios/hooks": "1.0.14",
+    "@pol-studios/utils": "1.0.13"
   },
   "devDependencies": {
     "@babel/core": "^7.28.0",
     "@supabase-cache-helpers/postgrest-core": "^0.12.3",
     "@supabase-cache-helpers/postgrest-react-query": "^1.0.0",
     "@types/flat": "^5.0.5",
+    "@types/fast-json-stable-stringify": "^2.1.0",
     "babel-plugin-react-compiler": "^1.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"