bunderstack-sync 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunderstack-sync",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "TanStack DB collections synced live to a bunderstack backend: optimistic mutations with SSE-driven realtime sync.",
   "keywords": [
     "bun",
@@ -35,8 +35,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "bunderstack": "0.6.0",
-    "bunderstack-query": "0.1.0"
+    "bunderstack-query": "0.7.0"
   },
   "devDependencies": {
     "@tanstack/db": "0.6.16",
@@ -50,6 +49,11 @@
     "@tanstack/db": "0.6.16",
     "@tanstack/query-db-collection": "1.1.0",
     "@tanstack/react-query": "^5.101.0",
-    "typescript": "^5"
+    "typescript": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
   }
 }

package/src/collection.ts

@@ -1,4 +1,8 @@
-import { createCollection } from '@tanstack/db'
+import {
+  createCollection,
+  type Collection,
+  type StandardSchema,
+} from '@tanstack/db'
 import { queryCollectionOptions } from '@tanstack/query-db-collection'
 import type { QueryClient } from '@tanstack/react-query'
 import {
@@ -294,8 +298,45 @@ export function createTableCollection<
   }
 }
 
+export type ScopedCollection<TRow extends { id: string | number }> = {
+  collection: Collection<
+    TRow,
+    string | number,
+    Record<string, any>,
+    StandardSchema<TRow>
+  >
+  loadMore: (count?: number) => Promise<void>
+  hasMore: () => boolean
+  size: () => number
+}
+
 export type TableCollection<
   TRow extends { id: string | number },
   TCreate = Partial<TRow>,
   TUpdate = Partial<TRow>,
-> = ReturnType<typeof createTableCollection<TRow, TCreate, TUpdate>>
+> = {
+  collection: Collection<
+    TRow,
+    string | number,
+    Record<string, any>,
+    StandardSchema<TRow>
+  >
+  table: TableClient<TRow, TCreate, TUpdate>
+  scopedCollection: (
+    options?: ScopedCollectionOptions,
+  ) => ScopedCollection<TRow>
+  collectionByIds: (
+    ids: readonly (string | number)[],
+    column?: string,
+  ) => Collection<
+    TRow,
+    string | number,
+    Record<string, any>,
+    StandardSchema<TRow>
+  >
+  applyRealtimeEvent: (
+    action: 'create' | 'update' | 'delete',
+    record: Record<string, unknown>,
+  ) => void
+  refetchAll: () => Promise<void>
+}