@powersync/service-core 0.0.0-dev-20240620165206

package/dist/storage/ChecksumCache.js

@@ -0,0 +1,234 @@
+import { addBucketChecksums } from '../util/utils.js';
+import { LRUCache } from 'lru-cache/min';
+import { OrderedSet } from '@js-sdsl/ordered-set';
+// Approximately 5MB of memory, if we assume 50 bytes per entry
+const DEFAULT_MAX_SIZE = 100000;
+/**
+ * Implement a LRU cache for checksum requests. Each (bucket, checkpoint) request is cached separately,
+ * while the lookups occur in batches.
+ *
+ * For each bucket, we keep a separate OrderedSet of cached checkpoints.
+ * This allows us to do incrementally update checksums by using the last cached checksum for the same bucket.
+ *
+ * We use the LRUCache fetchMethod to deduplicate in-progress requests.
+ */
+export class ChecksumCache {
+    constructor(options) {
+        /**
+         * For each bucket, an ordered set of cached checkpoints.
+         */
+        this.bucketCheckpoints = new Map();
+        this.fetchChecksums = options.fetchChecksums;
+        this.cache = new LRUCache({
+            max: options.maxSize ?? DEFAULT_MAX_SIZE,
+            fetchMethod: async (cacheKey, _staleValue, options) => {
+                // Called when this checksum hasn't been cached yet.
+                // Pass the call back to the request, which implements batch fetching.
+                const { bucket } = parseCacheKey(cacheKey);
+                const result = await options.context.fetch(bucket);
+                // Add to the set of cached checkpoints for the bucket.
+                let checkpointSet = this.bucketCheckpoints.get(bucket);
+                if (checkpointSet == null) {
+                    checkpointSet = new OrderedSet();
+                    this.bucketCheckpoints.set(bucket, checkpointSet);
+                }
+                checkpointSet.insert(options.context.checkpoint);
+                return result;
+            },
+            dispose: (value, key) => {
+                // Remove from the set of cached checkpoints for the bucket
+                const { checkpointString } = parseCacheKey(key);
+                const checkpoint = BigInt(checkpointString);
+                const checkpointSet = this.bucketCheckpoints.get(value.bucket);
+                if (checkpointSet == null) {
+                    return;
+                }
+                checkpointSet.eraseElementByKey(checkpoint);
+                if (checkpointSet.length == 0) {
+                    this.bucketCheckpoints.delete(value.bucket);
+                }
+            },
+            noDisposeOnSet: true,
+            // When we have more fetches than the cache size, complete the fetches instead
+            // of failing with Error('evicted').
+            ignoreFetchAbort: true
+        });
+    }
+    async getChecksums(checkpoint, buckets) {
+        const checksums = await this.getChecksumMap(checkpoint, buckets);
+        // Return results in the same order as the request
+        return buckets.map((bucket) => checksums.get(bucket));
+    }
+    /**
+     * Get bucket checksums for a checkpoint.
+     *
+     * Any checksums not found upstream are returned as zero checksums.
+     *
+     * @returns a Map with exactly one entry for each bucket requested
+     */
+    async getChecksumMap(checkpoint, buckets) {
+        // Buckets that don't have a cached checksum for this checkpoint yet
+        let toFetch = new Set();
+        // Newly fetched results
+        let fetchResults = new Map();
+        // Promise for the bactch new fetch requests
+        let resolveFetch;
+        let rejectFetch;
+        let fetchPromise = new Promise((resolve, reject) => {
+            resolveFetch = resolve;
+            rejectFetch = reject;
+        });
+        // Accumulated results - both from cached checksums, and fetched checksums
+        let finalResults = new Map();
+        const context = {
+            async fetch(bucket) {
+                await fetchPromise;
+                if (!toFetch.has(bucket)) {
+                    // Should never happen
+                    throw new Error(`Expected to fetch ${bucket}`);
+                }
+                const checksum = fetchResults.get(bucket);
+                if (checksum == null) {
+                    // Should never happen
+                    throw new Error(`Failed to fetch checksum for bucket ${bucket}`);
+                }
+                return checksum;
+            },
+            checkpoint: BigInt(checkpoint)
+        };
+        // One promise to await to ensure all fetch requests completed.
+        let settledPromise = null;
+        try {
+            // Individual cache fetch promises
+            let cacheFetchPromises = [];
+            for (let bucket of buckets) {
+                const cacheKey = makeCacheKey(checkpoint, bucket);
+                let status = {};
+                const p = this.cache.fetch(cacheKey, { context: context, status: status }).then((checksums) => {
+                    if (checksums == null) {
+                        // Should never happen
+                        throw new Error(`Failed to get checksums for ${cacheKey}`);
+                    }
+                    finalResults.set(bucket, checksums);
+                });
+                cacheFetchPromises.push(p);
+                if (status.fetch == 'hit' || status.fetch == 'inflight') {
+                    // The checksums is either cached already (hit), or another request is busy
+                    // fetching (inflight).
+                    // In either case, we don't need to fetch a new checksum.
+                }
+                else {
+                    // We need a new request for this checksum.
+                    toFetch.add(bucket);
+                }
+            }
+            // We do this directly after creating the promises, otherwise
+            // we could end up with weird uncaught rejection errors.
+            settledPromise = Promise.allSettled(cacheFetchPromises);
+            if (toFetch.size == 0) {
+                // Nothing to fetch, but resolve in case
+                resolveFetch();
+            }
+            else {
+                let bucketRequests = [];
+                // Partial checksum (previously cached) to add to the partial fetch
+                let add = new Map();
+                for (let bucket of toFetch) {
+                    let bucketRequest = null;
+                    const checkpointSet = this.bucketCheckpoints.get(bucket);
+                    if (checkpointSet != null) {
+                        // Find smaller checkpoints, sorted in descending order
+                        let iter = checkpointSet.reverseUpperBound(context.checkpoint);
+                        const begin = checkpointSet.begin();
+                        while (iter.isAccessible()) {
+                            const cp = iter.pointer;
+                            const cacheKey = makeCacheKey(cp, bucket);
+                            // peek to avoid refreshing the key
+                            const cached = this.cache.peek(cacheKey);
+                            // As long as dispose() works correctly, the checkpointset should
+                            // match up with the cache, and `cached` should also have a value here.
+                            // However, we handle caces where it's not present either way.
+                            // Test by disabling the `dispose()` callback.
+                            if (cached != null) {
+                                // Partial checksum found - make a partial checksum request
+                                bucketRequest = {
+                                    bucket,
+                                    start: cp.toString(),
+                                    end: checkpoint
+                                };
+                                add.set(bucket, cached);
+                                break;
+                            }
+                            if (iter.equals(begin)) {
+                                // Cannot iterate further
+                                break;
+                            }
+                            // Iterate backwards
+                            iter = iter.pre();
+                        }
+                    }
+                    if (bucketRequest == null) {
+                        // No partial checksum found - make a new full checksum request
+                        bucketRequest = {
+                            bucket,
+                            end: checkpoint
+                        };
+                        add.set(bucket, {
+                            bucket,
+                            checksum: 0,
+                            count: 0
+                        });
+                    }
+                    bucketRequests.push(bucketRequest);
+                }
+                // Fetch partial checksums from upstream
+                const results = await this.fetchChecksums(bucketRequests);
+                for (let bucket of toFetch) {
+                    const result = results.get(bucket);
+                    const toAdd = add.get(bucket);
+                    if (toAdd == null) {
+                        // Should never happen
+                        throw new Error(`toAdd null for ${bucket}`);
+                    }
+                    // Compute the full checksum from the two partials.
+                    // No results returned are treated the same as a zero result.
+                    const added = addBucketChecksums(toAdd, result ?? null);
+                    fetchResults.set(bucket, added);
+                }
+                // fetchResults is fully populated, so we resolve the Promise
+                resolveFetch();
+            }
+        }
+        catch (e) {
+            // Failure when fetching checksums - reject the Promise.
+            // This will reject all individual cache fetch requests, and each will be retried
+            // on the next request.
+            rejectFetch(e);
+            // Wait for the above rejection to propagate, otherwise we end up with "uncaught" errors.
+            // This promise never throws.
+            await settledPromise;
+            throw e;
+        }
+        // Wait for all cache fetch reqeusts to complete
+        const settledResults = (await settledPromise) ?? [];
+        // Check if any of them failed
+        for (let result of settledResults) {
+            if (result.status == 'rejected') {
+                throw result.reason;
+            }
+        }
+        if (finalResults.size != buckets.length) {
+            // Should not happen
+            throw new Error(`Bucket results mismatch: ${finalResults.size} != ${buckets.length}`);
+        }
+        return finalResults;
+    }
+}
+function makeCacheKey(checkpoint, bucket) {
+    return `${checkpoint}/${bucket}`;
+}
+function parseCacheKey(key) {
+    const index = key.indexOf('/');
+    return { checkpointString: key.substring(0, index), bucket: key.substring(index + 1) };
+}
+//# sourceMappingURL=ChecksumCache.js.map

package/dist/storage/ChecksumCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChecksumCache.js","sourceRoot":"","sources":["../../src/storage/ChecksumCache.ts"],"names":[],"mappings":"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"}

package/dist/storage/MongoBucketStorage.d.ts

@@ -0,0 +1,52 @@
+/// <reference types="node" resolution-mode="require"/>
+import { ActiveCheckpoint, BucketStorageFactory, PersistedSyncRules, PersistedSyncRulesContent, StorageMetrics, UpdateSyncRulesOptions, WriteCheckpoint } from './BucketStorage.js';
+import { MongoPersistedSyncRulesContent } from './mongo/MongoPersistedSyncRulesContent.js';
+import { MongoSyncBucketStorage } from './mongo/MongoSyncBucketStorage.js';
+import { PowerSyncMongo, PowerSyncMongoOptions } from './mongo/db.js';
+export interface MongoBucketStorageOptions extends PowerSyncMongoOptions {
+}
+export declare class MongoBucketStorage implements BucketStorageFactory {
+    private readonly client;
+    private readonly session;
+    readonly slot_name_prefix: string;
+    private readonly storageCache;
+    readonly db: PowerSyncMongo;
+    constructor(db: PowerSyncMongo, options: {
+        slot_name_prefix: string;
+    });
+    getInstance(options: PersistedSyncRules): MongoSyncBucketStorage;
+    configureSyncRules(sync_rules: string, options?: {
+        lock?: boolean;
+    }): Promise<{
+        updated: boolean;
+        persisted_sync_rules?: undefined;
+        lock?: undefined;
+    } | {
+        updated: boolean;
+        persisted_sync_rules: MongoPersistedSyncRulesContent;
+        lock: import("./storage-index.js").MongoSyncRulesLock | undefined;
+    }>;
+    slotRemoved(slot_name: string): Promise<void>;
+    updateSyncRules(options: UpdateSyncRulesOptions): Promise<MongoPersistedSyncRulesContent>;
+    getActiveSyncRulesContent(): Promise<MongoPersistedSyncRulesContent | null>;
+    getActiveSyncRules(): Promise<PersistedSyncRules | null>;
+    getNextSyncRulesContent(): Promise<MongoPersistedSyncRulesContent | null>;
+    getNextSyncRules(): Promise<PersistedSyncRules | null>;
+    getReplicatingSyncRules(): Promise<PersistedSyncRulesContent[]>;
+    getStoppedSyncRules(): Promise<PersistedSyncRulesContent[]>;
+    createWriteCheckpoint(user_id: string, lsns: Record<string, string>): Promise<bigint>;
+    lastWriteCheckpoint(user_id: string, lsn: string): Promise<bigint | null>;
+    getActiveCheckpoint(): Promise<ActiveCheckpoint>;
+    getStorageMetrics(): Promise<StorageMetrics>;
+    getPowerSyncInstanceId(): Promise<string>;
+    private makeActiveCheckpoint;
+    /**
+     * Instance-wide watch on the latest available checkpoint (op_id + lsn).
+     */
+    private watchActiveCheckpoint;
+    private readonly sharedIter;
+    /**
+     * User-specific watch on the latest checkpoint and/or write checkpoint.
+     */
+    watchWriteCheckpoint(user_id: string, signal: AbortSignal): AsyncIterable<WriteCheckpoint>;
+}