@syncular/client 0.0.1-60

package/dist/pull-engine.js

@@ -0,0 +1,391 @@
+/**
+ * @syncular/client - Sync pull engine
+ */
+import { sql } from 'kysely';
+// Simple JSON serialization cache to avoid repeated stringification
+// of the same objects during pull operations
+const jsonCache = new WeakMap();
+const jsonCacheStats = { hits: 0, misses: 0 };
+const SNAPSHOT_CHUNK_CONCURRENCY = 8;
+function serializeJsonCached(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return JSON.stringify(obj);
+    }
+    const cached = jsonCache.get(obj);
+    if (cached !== undefined) {
+        jsonCacheStats.hits++;
+        return cached;
+    }
+    jsonCacheStats.misses++;
+    const serialized = JSON.stringify(obj);
+    // Only cache objects that are likely to be reused (not one-off empty objects)
+    if (Object.keys(obj).length > 0) {
+        jsonCache.set(obj, serialized);
+    }
+    return serialized;
+}
+function isGzipBytes(bytes) {
+    return bytes.length >= 2 && bytes[0] === 0x1f && bytes[1] === 0x8b;
+}
+async function maybeGunzip(bytes) {
+    if (!isGzipBytes(bytes))
+        return bytes;
+    // Prefer Web Streams decompression when available (browser/modern runtimes).
+    if (typeof DecompressionStream !== 'undefined') {
+        const stream = new ReadableStream({
+            start(controller) {
+                controller.enqueue(new Uint8Array(bytes));
+                controller.close();
+            },
+        });
+        const decompressed = stream.pipeThrough(new DecompressionStream('gzip'));
+        const reader = decompressed.getReader();
+        try {
+            const chunks = [];
+            let total = 0;
+            while (true) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                if (!value)
+                    continue;
+                chunks.push(value);
+                total += value.length;
+            }
+            const out = new Uint8Array(total);
+            let offset = 0;
+            for (const chunk of chunks) {
+                out.set(chunk, offset);
+                offset += chunk.length;
+            }
+            return out;
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    // If the runtime didn't auto-decompress `Content-Encoding: gzip`, and doesn't
+    // support DecompressionStream, we can't safely decode the chunk.
+    throw new Error('Snapshot chunk appears gzip-compressed but gzip decompression is not available in this runtime');
+}
+function parseNdjsonRows(text) {
+    const rows = [];
+    for (const line of text.split('\n')) {
+        if (!line)
+            continue;
+        rows.push(JSON.parse(line));
+    }
+    return rows;
+}
+async function computeSha256Hex(bytes) {
+    // Use crypto.subtle if available (browsers, modern Node/Bun)
+    if (typeof crypto !== 'undefined' && crypto.subtle) {
+        // Create a fresh ArrayBuffer to satisfy crypto.subtle's type requirements
+        const buffer = new ArrayBuffer(bytes.length);
+        new Uint8Array(buffer).set(bytes);
+        const hashBuffer = await crypto.subtle.digest('SHA-256', buffer);
+        const hashArray = new Uint8Array(hashBuffer);
+        return Array.from(hashArray, (b) => b.toString(16).padStart(2, '0')).join('');
+    }
+    // Fallback for Node.js/Bun without crypto.subtle
+    if (typeof globalThis.require === 'function') {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { createHash } = await import('node:crypto');
+        return createHash('sha256').update(Buffer.from(bytes)).digest('hex');
+    }
+    throw new Error('No crypto implementation available for SHA-256. ' +
+        'Ensure crypto.subtle is available or running in Node.js/Bun.');
+}
+async function mapWithConcurrency(items, concurrency, mapper) {
+    if (items.length === 0)
+        return [];
+    const workerCount = Math.max(1, Math.min(concurrency, items.length));
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    async function worker() {
+        while (nextIndex < items.length) {
+            const index = nextIndex;
+            nextIndex += 1;
+            const item = items[index];
+            if (item === undefined)
+                continue;
+            results[index] = await mapper(item, index);
+        }
+    }
+    await Promise.all(Array.from({ length: workerCount }, () => worker()));
+    return results;
+}
+async function materializeChunkedSnapshots(transport, response) {
+    const chunkCache = new Map();
+    const decoder = new TextDecoder();
+    const subscriptions = await Promise.all(response.subscriptions.map(async (sub) => {
+        if (!sub.bootstrap)
+            return sub;
+        if (!sub.snapshots || sub.snapshots.length === 0)
+            return sub;
+        const snapshots = await mapWithConcurrency(sub.snapshots, SNAPSHOT_CHUNK_CONCURRENCY, async (snapshot) => {
+            const chunks = snapshot.chunks ?? [];
+            if (chunks.length === 0) {
+                return snapshot;
+            }
+            const parsedRowsByChunk = await mapWithConcurrency(chunks, SNAPSHOT_CHUNK_CONCURRENCY, async (chunk) => {
+                const promise = chunkCache.get(chunk.id) ??
+                    transport.fetchSnapshotChunk({ chunkId: chunk.id });
+                chunkCache.set(chunk.id, promise);
+                const raw = await promise;
+                const bytes = await maybeGunzip(raw);
+                // Verify chunk integrity using sha256 hash
+                if (chunk.sha256) {
+                    const actualHash = await computeSha256Hex(bytes);
+                    if (actualHash !== chunk.sha256) {
+                        throw new Error(`Snapshot chunk integrity check failed: expected sha256 ${chunk.sha256}, got ${actualHash}`);
+                    }
+                }
+                const text = decoder.decode(bytes);
+                return parseNdjsonRows(text);
+            });
+            const rows = [];
+            for (const parsedRows of parsedRowsByChunk) {
+                rows.push(...parsedRows);
+            }
+            return { ...snapshot, rows, chunks: undefined };
+        });
+        return { ...sub, snapshots };
+    }));
+    // Clear chunk cache after processing to prevent memory accumulation
+    chunkCache.clear();
+    return { ...response, subscriptions };
+}
+function parseBootstrapState(value) {
+    if (!value)
+        return null;
+    try {
+        // Handle both string (raw JSON) and object (already deserialized by SerializePlugin)
+        const parsed = typeof value === 'string'
+            ? JSON.parse(value)
+            : value;
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        if (typeof parsed.asOfCommitSeq !== 'number')
+            return null;
+        if (!Array.isArray(parsed.tables))
+            return null;
+        if (typeof parsed.tableIndex !== 'number')
+            return null;
+        if (parsed.rowCursor !== null && typeof parsed.rowCursor !== 'string')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build a pull request from subscription state. Exported for use
+ * by the combined sync path in sync-loop.ts.
+ */
+export async function buildPullRequest(db, options) {
+    const stateId = options.stateId ?? 'default';
+    const existingResult = await sql `
+    select
+      ${sql.ref('state_id')},
+      ${sql.ref('subscription_id')},
+      ${sql.ref('shape')},
+      ${sql.ref('scopes_json')},
+      ${sql.ref('params_json')},
+      ${sql.ref('cursor')},
+      ${sql.ref('bootstrap_state_json')},
+      ${sql.ref('status')},
+      ${sql.ref('created_at')},
+      ${sql.ref('updated_at')}
+    from ${sql.table('sync_subscription_state')}
+    where ${sql.ref('state_id')} = ${sql.val(stateId)}
+  `.execute(db);
+    const existing = existingResult.rows;
+    const existingById = new Map();
+    for (const row of existing)
+        existingById.set(row.subscription_id, row);
+    const request = {
+        clientId: options.clientId,
+        limitCommits: options.limitCommits ?? 50,
+        limitSnapshotRows: options.limitSnapshotRows ?? 1000,
+        maxSnapshotPages: options.maxSnapshotPages,
+        dedupeRows: options.dedupeRows,
+        subscriptions: (options.subscriptions ?? []).map((sub) => ({
+            ...sub,
+            cursor: Math.max(-1, existingById.get(sub.id)?.cursor ?? -1),
+            bootstrapState: parseBootstrapState(existingById.get(sub.id)?.bootstrap_state_json),
+        })),
+    };
+    return { request, existing, existingById, stateId };
+}
+/**
+ * Apply a pull response (run plugins + write to local DB).
+ * Exported for use by the combined sync path in sync-loop.ts.
+ */
+export async function applyPullResponse(db, transport, shapes, options, pullState, rawResponse) {
+    const { request, existing, existingById, stateId } = pullState;
+    const hydrated = await materializeChunkedSnapshots(transport, rawResponse);
+    const ctx = {
+        actorId: options.actorId ?? 'unknown',
+        clientId: options.clientId,
+    };
+    const plugins = options.plugins ?? [];
+    let responseToApply = hydrated;
+    for (const plugin of plugins) {
+        if (!plugin.afterPull)
+            continue;
+        responseToApply = await plugin.afterPull(ctx, {
+            request,
+            response: responseToApply,
+        });
+    }
+    await db.transaction().execute(async (trx) => {
+        const desiredIds = new Set((options.subscriptions ?? []).map((s) => s.id));
+        // Remove local data for subscriptions that are no longer desired.
+        for (const row of existing) {
+            if (desiredIds.has(row.subscription_id))
+                continue;
+            // Clear data for this shape matching the subscription's scopes
+            if (row.shape) {
+                try {
+                    const scopes = row.scopes_json
+                        ? typeof row.scopes_json === 'string'
+                            ? JSON.parse(row.scopes_json)
+                            : row.scopes_json
+                        : {};
+                    await shapes.getOrThrow(row.shape).clearAll({ trx, scopes });
+                }
+                catch {
+                    // ignore missing shape handler
+                }
+            }
+            await sql `
+	        delete from ${sql.table('sync_subscription_state')}
+	        where ${sql.ref('state_id')} = ${sql.val(stateId)}
+	          and ${sql.ref('subscription_id')} = ${sql.val(row.subscription_id)}
+	      `.execute(trx);
+        }
+        const subsById = new Map();
+        for (const s of options.subscriptions ?? [])
+            subsById.set(s.id, s);
+        for (const sub of responseToApply.subscriptions) {
+            const def = subsById.get(sub.id);
+            const prev = existingById.get(sub.id);
+            // Revoked: clear data and drop the subscription row.
+            if (sub.status === 'revoked') {
+                if (prev?.shape) {
+                    try {
+                        const scopes = prev.scopes_json
+                            ? typeof prev.scopes_json === 'string'
+                                ? JSON.parse(prev.scopes_json)
+                                : prev.scopes_json
+                            : {};
+                        await shapes.getOrThrow(prev.shape).clearAll({ trx, scopes });
+                    }
+                    catch {
+                        // ignore missing handler
+                    }
+                }
+                await sql `
+	          delete from ${sql.table('sync_subscription_state')}
+	          where ${sql.ref('state_id')} = ${sql.val(stateId)}
+	            and ${sql.ref('subscription_id')} = ${sql.val(sub.id)}
+	        `.execute(trx);
+                continue;
+            }
+            // Apply snapshots (bootstrap mode)
+            if (sub.bootstrap) {
+                for (const snapshot of sub.snapshots ?? []) {
+                    const handler = shapes.getOrThrow(snapshot.table);
+                    // Call onSnapshotStart hook when starting a new snapshot
+                    if (snapshot.isFirstPage && handler.onSnapshotStart) {
+                        await handler.onSnapshotStart({
+                            trx,
+                            table: snapshot.table,
+                            scopes: sub.scopes,
+                        });
+                    }
+                    await handler.applySnapshot({ trx }, snapshot);
+                    // Call onSnapshotEnd hook when snapshot is complete
+                    if (snapshot.isLastPage && handler.onSnapshotEnd) {
+                        await handler.onSnapshotEnd({
+                            trx,
+                            table: snapshot.table,
+                            scopes: sub.scopes,
+                        });
+                    }
+                }
+            }
+            else {
+                // Apply incremental changes
+                for (const commit of sub.commits) {
+                    for (const change of commit.changes) {
+                        const handler = shapes.getOrThrow(change.table);
+                        await handler.applyChange({ trx }, change);
+                    }
+                }
+            }
+            // Persist subscription cursor + metadata.
+            // Use cached JSON serialization to avoid repeated stringification
+            const now = Date.now();
+            const paramsJson = serializeJsonCached(def?.params ?? {});
+            const scopesJson = serializeJsonCached(def?.scopes ?? {});
+            const bootstrapStateJson = sub.bootstrap
+                ? sub.bootstrapState
+                    ? serializeJsonCached(sub.bootstrapState)
+                    : null
+                : null;
+            const shape = def?.shape ?? 'unknown';
+            await sql `
+	        insert into ${sql.table('sync_subscription_state')} (
+	          ${sql.join([
+                sql.ref('state_id'),
+                sql.ref('subscription_id'),
+                sql.ref('shape'),
+                sql.ref('scopes_json'),
+                sql.ref('params_json'),
+                sql.ref('cursor'),
+                sql.ref('bootstrap_state_json'),
+                sql.ref('status'),
+                sql.ref('created_at'),
+                sql.ref('updated_at'),
+            ])}
+	        ) values (
+	          ${sql.join([
+                sql.val(stateId),
+                sql.val(sub.id),
+                sql.val(shape),
+                sql.val(scopesJson),
+                sql.val(paramsJson),
+                sql.val(sub.nextCursor),
+                sql.val(bootstrapStateJson),
+                sql.val('active'),
+                sql.val(now),
+                sql.val(now),
+            ])}
+	        )
+	        on conflict (${sql.join([sql.ref('state_id'), sql.ref('subscription_id')])})
+	        do update set
+	          ${sql.ref('shape')} = ${sql.val(shape)},
+	          ${sql.ref('scopes_json')} = ${sql.val(scopesJson)},
+	          ${sql.ref('params_json')} = ${sql.val(paramsJson)},
+	          ${sql.ref('cursor')} = ${sql.val(sub.nextCursor)},
+	          ${sql.ref('bootstrap_state_json')} = ${sql.val(bootstrapStateJson)},
+	          ${sql.ref('status')} = ${sql.val('active')},
+	          ${sql.ref('updated_at')} = ${sql.val(now)}
+	      `.execute(trx);
+        }
+    });
+    return responseToApply;
+}
+export async function syncPullOnce(db, transport, shapes, options) {
+    const pullState = await buildPullRequest(db, options);
+    const { clientId, ...pullBody } = pullState.request;
+    const combined = await transport.sync({ clientId, pull: pullBody });
+    if (!combined.pull) {
+        return { ok: true, subscriptions: [] };
+    }
+    return applyPullResponse(db, transport, shapes, options, pullState, combined.pull);
+}
+//# sourceMappingURL=pull-engine.js.map

package/dist/pull-engine.js.map

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

package/dist/push-engine.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @syncular/client - Sync push engine (commit-based)
+ */
+import type { SyncPushResponse, SyncTransport } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { SyncClientPlugin } from './plugins/types';
+import type { SyncClientDb } from './schema';
+export interface SyncPushOnceOptions {
+    clientId: string;
+    actorId?: string;
+    plugins?: SyncClientPlugin[];
+}
+export interface SyncPushOnceResult {
+    pushed: boolean;
+    response?: SyncPushResponse;
+}
+export declare function syncPushOnce<DB extends SyncClientDb>(db: Kysely<DB>, transport: SyncTransport, options: SyncPushOnceOptions): Promise<SyncPushOnceResult>;
+//# sourceMappingURL=push-engine.d.ts.map

package/dist/push-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-engine.d.ts","sourceRoot":"","sources":["../src/push-engine.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,gBAAgB,EAChB,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQrC,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAiBD,wBAAsB,YAAY,CAAC,EAAE,SAAS,YAAY,EACxD,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EACd,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAmJ7B"}

package/dist/push-engine.js

@@ -0,0 +1,155 @@
+/**
+ * @syncular/client - Sync push engine (commit-based)
+ */
+import { upsertConflictsForRejectedCommit } from './conflicts';
+import { getNextSendableOutboxCommit, markOutboxCommitAcked, markOutboxCommitFailed, markOutboxCommitPending, } from './outbox';
+function hasPushViaWs(transport) {
+    return 'pushViaWs' in transport && typeof transport.pushViaWs === 'function';
+}
+function clonePushRequest(request) {
+    if (typeof structuredClone === 'function')
+        return structuredClone(request);
+    return JSON.parse(JSON.stringify(request));
+}
+export async function syncPushOnce(db, transport, options) {
+    // getNextSendableOutboxCommit now atomically claims the commit
+    // (marks it as 'sending' and returns it in one operation)
+    const next = await getNextSendableOutboxCommit(db);
+    if (!next)
+        return { pushed: false };
+    const request = {
+        clientId: options.clientId,
+        clientCommitId: next.client_commit_id,
+        operations: next.operations,
+        schemaVersion: next.schema_version,
+    };
+    const ctx = {
+        actorId: options.actorId ?? 'unknown',
+        clientId: options.clientId,
+    };
+    const plugins = options.plugins ?? [];
+    let requestToSend = request;
+    if (plugins.length > 0) {
+        try {
+            requestToSend = clonePushRequest(request);
+            for (const plugin of plugins) {
+                if (!plugin.beforePush)
+                    continue;
+                requestToSend = await plugin.beforePush(ctx, requestToSend);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            await markOutboxCommitPending(db, { id: next.id, error: message });
+            throw err;
+        }
+    }
+    let res;
+    try {
+        // Try WS push first if the transport supports it
+        let wsResponse = null;
+        if (hasPushViaWs(transport)) {
+            wsResponse = await transport.pushViaWs(requestToSend);
+        }
+        if (wsResponse) {
+            res = wsResponse;
+        }
+        else {
+            // Fall back to HTTP
+            const combined = await transport.sync({
+                clientId: requestToSend.clientId,
+                push: {
+                    clientCommitId: requestToSend.clientCommitId,
+                    operations: requestToSend.operations,
+                    schemaVersion: requestToSend.schemaVersion,
+                },
+            });
+            if (!combined.push) {
+                throw new Error('Server returned no push response');
+            }
+            res = combined.push;
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        // Treat transport exceptions as retryable. The sync loop already applies backoff,
+        // and failed commits are reserved for terminal server rejections (e.g. conflicts).
+        await markOutboxCommitPending(db, { id: next.id, error: message });
+        throw err;
+    }
+    let responseToUse = res;
+    if (plugins.length > 0) {
+        try {
+            for (const plugin of plugins) {
+                if (!plugin.afterPush)
+                    continue;
+                responseToUse = await plugin.afterPush(ctx, {
+                    request: requestToSend,
+                    response: responseToUse,
+                });
+            }
+        }
+        catch (err) {
+            // The server already received and processed this commit. Persist the raw response
+            // so we don't end up retrying a commit that was already applied.
+            const responseJson = JSON.stringify(res);
+            if (res.status === 'applied' || res.status === 'cached') {
+                await markOutboxCommitAcked(db, {
+                    id: next.id,
+                    commitSeq: res.commitSeq ?? null,
+                    responseJson,
+                });
+            }
+            else {
+                await upsertConflictsForRejectedCommit(db, {
+                    outboxCommitId: next.id,
+                    clientCommitId: next.client_commit_id,
+                    response: res,
+                });
+                await markOutboxCommitFailed(db, {
+                    id: next.id,
+                    error: 'REJECTED',
+                    responseJson,
+                });
+            }
+            throw err;
+        }
+    }
+    const responseJson = JSON.stringify(responseToUse);
+    if (responseToUse.status === 'applied' || responseToUse.status === 'cached') {
+        await markOutboxCommitAcked(db, {
+            id: next.id,
+            commitSeq: responseToUse.commitSeq ?? null,
+            responseJson,
+        });
+        return { pushed: true, response: responseToUse };
+    }
+    // Check if all errors are retriable - if so, keep pending for retry
+    const errorResults = responseToUse.results.filter((r) => r.status === 'error');
+    const allRetriable = errorResults.length > 0 && errorResults.every((r) => r.retriable === true);
+    if (allRetriable) {
+        // All errors are retriable - keep commit pending for retry
+        const errorMessages = errorResults
+            .map((r) => r.error ?? 'Unknown error')
+            .join('; ');
+        await markOutboxCommitPending(db, {
+            id: next.id,
+            error: `Retriable: ${errorMessages}`,
+            responseJson,
+        });
+        return { pushed: true, response: responseToUse };
+    }
+    // Terminal rejection - mark as failed and record conflicts
+    await upsertConflictsForRejectedCommit(db, {
+        outboxCommitId: next.id,
+        clientCommitId: next.client_commit_id,
+        response: responseToUse,
+    });
+    await markOutboxCommitFailed(db, {
+        id: next.id,
+        error: 'REJECTED',
+        responseJson,
+    });
+    return { pushed: true, response: responseToUse };
+}
+//# sourceMappingURL=push-engine.js.map

package/dist/push-engine.js.map

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

package/dist/query/FingerprintCollector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @syncular/client - Fingerprint Collector
+ *
+ * Accumulates fingerprint data from multiple queries.
+ */
+/**
+ * Fingerprint collector accumulates fingerprint data from multiple queries
+ */
+export declare class FingerprintCollector {
+    private fingerprints;
+    add(fingerprint: string): void;
+    /**
+     * Get combined fingerprint from all collected fingerprints
+     */
+    getCombined(): string;
+    clear(): void;
+}
+//# sourceMappingURL=FingerprintCollector.d.ts.map

package/dist/query/FingerprintCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FingerprintCollector.d.ts","sourceRoot":"","sources":["../../src/query/FingerprintCollector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAgB;IAEpC,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED;;OAEG;IACH,WAAW,IAAI,MAAM,CAIpB;IAED,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/query/FingerprintCollector.js

@@ -0,0 +1,28 @@
+/**
+ * @syncular/client - Fingerprint Collector
+ *
+ * Accumulates fingerprint data from multiple queries.
+ */
+/**
+ * Fingerprint collector accumulates fingerprint data from multiple queries
+ */
+export class FingerprintCollector {
+    fingerprints = [];
+    add(fingerprint) {
+        this.fingerprints.push(fingerprint);
+    }
+    /**
+     * Get combined fingerprint from all collected fingerprints
+     */
+    getCombined() {
+        if (this.fingerprints.length === 0)
+            return '';
+        if (this.fingerprints.length === 1)
+            return this.fingerprints[0] ?? '';
+        return this.fingerprints.join('|');
+    }
+    clear() {
+        this.fingerprints = [];
+    }
+}
+//# sourceMappingURL=FingerprintCollector.js.map

package/dist/query/FingerprintCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FingerprintCollector.js","sourceRoot":"","sources":["../../src/query/FingerprintCollector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACvB,YAAY,GAAa,EAAE,CAAC;IAEpC,GAAG,CAAC,WAAmB,EAAQ;QAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAAA,CACrC;IAED;;OAEG;IACH,WAAW,GAAW;QACpB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAAA,CACpC;IAED,KAAK,GAAS;QACZ,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IAAA,CACxB;CACF"}