@spooky-sync/core 0.0.1-canary.161 → 0.0.1-canary.163

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/AGENTS.md +2 -1
  2. package/dist/index.d.ts +567 -5
  3. package/dist/index.js +2081 -296
  4. package/dist/otel/index.d.ts +1 -1
  5. package/dist/types.d.ts +124 -1
  6. package/package.json +3 -3
  7. package/src/index.ts +7 -0
  8. package/src/modules/crdt/crdt-hydration.test.ts +4 -0
  9. package/src/modules/crdt/crdt-reconnect.test.ts +195 -0
  10. package/src/modules/crdt/index.ts +109 -7
  11. package/src/modules/data/data.membership.test.ts +297 -0
  12. package/src/modules/data/id-set-plan.test.ts +122 -0
  13. package/src/modules/data/index.ts +291 -39
  14. package/src/modules/data/window-query.ts +53 -13
  15. package/src/modules/devtools/index.ts +17 -1
  16. package/src/modules/devtools/storage-info.ts +25 -0
  17. package/src/modules/sync/sync.live-removal.test.ts +134 -0
  18. package/src/modules/sync/sync.reconnect.test.ts +145 -0
  19. package/src/modules/sync/sync.ts +143 -43
  20. package/src/services/blobs/blob-cache.test.ts +341 -0
  21. package/src/services/blobs/blob-cache.ts +585 -0
  22. package/src/services/blobs/blob-manifest.ts +227 -0
  23. package/src/services/blobs/blob-store.test.ts +77 -0
  24. package/src/services/blobs/blob-store.ts +359 -0
  25. package/src/services/blobs/blob.fixture.ts +90 -0
  26. package/src/services/blobs/index.ts +70 -0
  27. package/src/services/database/connection-supervisor.test.ts +255 -0
  28. package/src/services/database/connection-supervisor.ts +351 -0
  29. package/src/services/database/database.query-timeout.test.ts +83 -0
  30. package/src/services/database/database.ts +21 -1
  31. package/src/services/database/index.ts +1 -0
  32. package/src/services/database/local-migrator.ts +2 -0
  33. package/src/services/database/remote.ts +99 -3
  34. package/src/services/database/sqlite-cache-engine.ts +5 -0
  35. package/src/sp00ky.ts +160 -3
  36. package/src/types.ts +125 -0
  37. package/src/utils/index.ts +38 -0
package/AGENTS.md CHANGED
@@ -24,7 +24,8 @@ Local mutations are applied optimistically, ingested into a DBSP layer that driv
24
24
  ## Key exports (`src/index.ts`)
25
25
 
26
26
  - `Sp00kyClient<S>` — main class. Methods: `init()`, `create(id, payload)`, `update(table, id, payload, options?)`, `delete(table, idOrSelector)`, `query(table, opts?)`, `run(backend, route, payload)`, `bucket(name)`, `useRemote(fn)`, `authenticate(token)`, `signOut()`. Plus `pendingMutationCount` and `subscribeToPendingMutations(cb)`.
27
- - `BucketHandle` — file storage handle (`put`, `get`, `delete`, `exists`).
27
+ - `BucketHandle` — file storage handle (`put`, `get`, `delete`, `exists`), plus the cache-aware `read`, `url`, `pin`/`unpin`, `evict`, `prefetch`. `get` is always remote; `read`/`url` go through the blob cache.
28
+ - `services/blobs/` — durable cache for bucket bytes: OPFS holds the files, `_00_blob` holds a manifest that reconcile rebuilds from disk (so a wiped local store costs metadata, not the offline cache). Nothing expires on a timer; eviction is LRU under a byte budget only, skipping pinned and on-screen entries. Config: `blobCache` in `types.ts`.
28
29
  - `AuthService` — token management, sign-in/sign-out events.
29
30
  - `CrdtManager`, `CrdtField`, `cursorColorFromName`, `CURSOR_COLORS` — Loro-CRDT integration.
30
31
  - Types: `Sp00kyConfig`, `SyncedDbConfig` (re-exported by client-solid as the consumer-facing shape), `QueryTimeToLive`, `PersistenceClient`, `StoreType`, `UpdateOptions`, `RunOptions`.