cry-synced-db-client 0.1.75 → 0.1.77

package/dist/src/db/SyncedDb.d.ts

@@ -27,6 +27,8 @@ export declare class SyncedDb implements I_SyncedDb {
     private syncing;
     private syncLock;
     private wsUpdateQueue;
+    /** When non-null, only these collections participate in sync/in-mem loading. */
+    private syncOnlyCollections;
     private readonly updaterId;
     private readonly syncedDbInstanceId;
     private syncMetaCache;
@@ -44,6 +46,20 @@ export declare class SyncedDb implements I_SyncedDb {
     getInstanceId(): string;
     getCrossTabSyncDebounceMs(): number;
     isLeaderTab(): boolean;
+    /**
+     * Restrict sync to only these collections. When non-empty, only the listed
+     * collections load from Dexie→in-mem and download from server. Pass an empty
+     * array to sync all collections again.
+     *
+     * Newly-allowed collections are loaded from Dexie immediately and a sync is
+     * triggered if online.
+     */
+    setSyncOnlyTheseCollections(collections: string[]): Promise<void>;
+    /**
+     * Get the current syncOnlyTheseCollections filter.
+     * Returns null when all collections are synced.
+     */
+    getSyncOnlyTheseCollections(): ReadonlySet<string> | null;
     /**
      * Test helper: simulate receiving a cross-tab broadcast from another instance.
      */
@@ -114,5 +130,25 @@ export declare class SyncedDb implements I_SyncedDb {
      * Per-call values take precedence over global defaults.
      */
     private resolveOpts;
+    /**
+     * Whether a collection participates in sync (server download,
+     * WS notifications, cross-tab sync, Dexie→in-mem loading).
+     * False for writeOnly collections and collections excluded by syncOnlyCollections.
+     */
+    private isSyncAllowed;
+    /**
+     * Load a single collection from Dexie into in-memory cache.
+     * Filters out deleted and archived items.
+     */
+    private loadCollectionToInMem;
     private assertCollection;
+    /**
+     * Asserts write-only collection has online connectivity for reads.
+     * @throws Error if offline
+     */
+    private assertWriteOnlyOnline;
+    private writeOnlyFindById;
+    private writeOnlyFindByIds;
+    private writeOnlyFindOne;
+    private writeOnlyFind;
 }

package/dist/src/db/types/managers.d.ts

@@ -50,6 +50,8 @@ export interface CrossTabSyncDeps {
     dexieDb: I_DexieDb;
     /** Write to in-mem batch. */
     writeToInMemBatch: <T extends DbEntity>(collection: string, items: T[], operation: "upsert" | "delete") => void;
+    /** Whether a collection participates in sync (not writeOnly, not filtered out). */
+    isSyncAllowed: (collection: string) => boolean;
 }
 export interface CrossTabSyncConfig {
     tenant: string;
@@ -225,6 +227,8 @@ export interface SyncEngineDeps {
     awaitRestUpload: () => Promise<void>;
     /** Broadcast updated IDs to other tabs */
     broadcastUpdates: (updates: Record<string, string[]>) => void;
+    /** Whether a collection participates in sync (not writeOnly, not filtered out). */
+    isSyncAllowed: (collection: string) => boolean;
 }
 export interface SyncEngineConfig {
     tenant: string;
@@ -256,6 +260,8 @@ export interface ServerUpdateHandlerDeps {
     getPendingChange: (collection: string, id: Id) => PendingChange | undefined;
     broadcastUpdates: (updates: Record<string, string[]>) => void;
     writeToInMemBatch: <T extends DbEntity>(collection: string, items: T[], operation: "upsert" | "delete") => void;
+    /** Whether a collection participates in sync (not writeOnly, not filtered out). */
+    isSyncAllowed: (collection: string) => boolean;
 }
 export interface ServerUpdateHandlerConfig {
     tenant: string;

package/dist/src/types/CollectionConfig.d.ts

@@ -20,4 +20,10 @@ export interface CollectionConfig<T = any> {
      */
     syncConfig?: CollectionSyncConfig<T>;
     resolveSyncConflict?(local: T, external: T): T;
+    /**
+     * Write-only mode: writes are persisted locally (Dexie) and uploaded
+     * to the server, but no data is downloaded or kept in the in-memory cache.
+     * Read operations throw. Server sync and WS notifications are skipped.
+     */
+    writeOnly?: boolean;
 }

package/dist/src/types/I_SyncedDb.d.ts

@@ -254,6 +254,12 @@ export interface CollectionConfig<T extends DbEntity = any, M = any> {
     syncConfig?: CollectionSyncConfig;
     /** Opcijska funkcija za razreševanje konfliktov */
     resolveSyncConflict?(local: T, external: T): T;
+    /**
+     * Write-only mode: writes are persisted locally (Dexie) and uploaded
+     * to the server, but no data is downloaded or kept in the in-memory cache.
+     * Read operations throw. Server sync and WS notifications are skipped.
+     */
+    writeOnly?: boolean;
     /** Whether this collection uses in-memory metadata */
     hasMetadata?: boolean;
     /** Callback called when a single object is written to in-mem. Returns metadata to store. */
@@ -512,6 +518,18 @@ export interface I_SyncedDb {
     sync(calledFrom?: string): Promise<void>;
     /** Ali je sinhronizacija v teku */
     isSyncing(): boolean;
+    /**
+     * Restrict sync to only these collections. When non-empty, only listed
+     * collections load Dexie→in-mem and download from server. Pass empty
+     * array to sync all collections. Newly-allowed collections are loaded
+     * immediately and a sync is triggered if online.
+     */
+    setSyncOnlyTheseCollections(collections: string[]): Promise<void>;
+    /**
+     * Get the current syncOnlyTheseCollections filter.
+     * Returns null when all collections are synced.
+     */
+    getSyncOnlyTheseCollections(): ReadonlySet<string> | null;
     /**
      * Izvede batch upsert na serverju
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cry-synced-db-client",
-  "version": "0.1.75",
+  "version": "0.1.77",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -17,7 +17,7 @@
   "scripts": {
     "clean": "rm -rf dist",
     "build": "bun run clean && bun run build:js && bun run build:types",
-    "build:js": "bun build ./src/index.ts --outdir ./dist --target browser --format esm --external dexie --external bson --external cry-helpers --external notepack.io",
+    "build:js": "esbuild ./src/index.ts --bundle --outdir=./dist --target=es2017 --format=esm --platform=browser --external:dexie --external:bson --external:cry-helpers --external:notepack.io",
     "build:types": "tsc --emitDeclarationOnly --outDir dist",
     "test": "bun test test/*.test.ts test/restProxy/*.test.ts && vitest run",
     "test:bun": "bun test test/*.test.ts test/restProxy/*.test.ts",
@@ -29,6 +29,7 @@
     "bson": "^7.2.0",
     "cry-ebus-proxy": "^1.0.3",
     "dexie": "^4.4.1",
+    "esbuild": "^0.27.4",
     "fake-indexeddb": "^6.2.5",
     "typescript": "^6",
     "vitest": "^4.1.2"