@syncular/server 0.1.2 → 0.2.0

package/dist/snapshot-chunks/db-metadata.js

@@ -1,360 +0,0 @@
-/**
- * @syncular/server - Database-backed metadata store for snapshot chunks
- *
- * Stores chunk metadata in sync_snapshot_chunks_metadata table,
- * body content in blob storage adapter.
- */
-import { bytesToReadableStream, randomId, readAllBytesFromStream, SYNC_SNAPSHOT_CHUNK_COMPRESSION, sha256Hex, } from '@syncular/core';
-export const SNAPSHOT_CHUNK_CLEANUP_TUNING_PRESETS = {
-    server: {
-        batchSize: 500,
-        deleteConcurrency: 16,
-    },
-    edge: {
-        batchSize: 100,
-        deleteConcurrency: 4,
-    },
-};
-/**
- * Create a snapshot chunk storage that uses:
- * - Database for metadata (scope, commit seq, etc.)
- * - Blob adapter for body content
- */
-export function createDbMetadataChunkStorage(options) {
-    const { db, blobAdapter, chunkIdPrefix = 'chunk_', cleanupTuning } = options;
-    function positiveIntOrDefault(value, fallback) {
-        if (value === undefined)
-            return fallback;
-        if (!Number.isFinite(value))
-            return fallback;
-        const normalized = Math.trunc(value);
-        return normalized > 0 ? normalized : fallback;
-    }
-    const CLEANUP_BATCH_SIZE = positiveIntOrDefault(cleanupTuning?.batchSize, 250);
-    const CLEANUP_DELETE_CONCURRENCY = positiveIntOrDefault(cleanupTuning?.deleteConcurrency, 8);
-    // Generate deterministic blob hash from chunk identity metadata.
-    async function computeBlobHash(metadata) {
-        const digest = await sha256Hex(`${metadata.encoding}:${metadata.compression}:${metadata.sha256}`);
-        return `sha256:${digest}`;
-    }
-    async function streamByteLength(stream) {
-        const reader = stream.getReader();
-        try {
-            let total = 0;
-            while (true) {
-                const { done, value } = await reader.read();
-                if (done)
-                    break;
-                if (!value)
-                    continue;
-                total += value.length;
-            }
-            return total;
-        }
-        finally {
-            reader.releaseLock();
-        }
-    }
-    async function runWithConcurrency(items, concurrency, worker) {
-        if (items.length === 0)
-            return;
-        const workerCount = Math.max(1, Math.min(concurrency, items.length));
-        let nextIndex = 0;
-        async function runWorker() {
-            while (nextIndex < items.length) {
-                const index = nextIndex;
-                nextIndex += 1;
-                const item = items[index];
-                if (item === undefined)
-                    continue;
-                await worker(item);
-            }
-        }
-        await Promise.all(Array.from({ length: workerCount }, () => runWorker()));
-    }
-    // Generate unique chunk ID
-    function generateChunkId() {
-        return `${chunkIdPrefix}${randomId()}`;
-    }
-    async function readStoredRef(args) {
-        const nowIso = args.nowIso ?? new Date().toISOString();
-        const rowCursorKey = args.rowCursor ?? '';
-        const baseQuery = db
-            .selectFrom('sync_snapshot_chunks')
-            .select([
-            'chunk_id',
-            'sha256',
-            'byte_length',
-            'next_row_cursor',
-            'is_last_page',
-            'encoding',
-            'compression',
-        ])
-            .where('partition_id', '=', args.partitionId)
-            .where('scope_key', '=', args.scopeKey)
-            .where('scope', '=', args.scope)
-            .where('as_of_commit_seq', '=', args.asOfCommitSeq)
-            .where('row_cursor', '=', rowCursorKey)
-            .where('row_limit', '=', args.rowLimit)
-            .where('encoding', '=', args.encoding)
-            .where('compression', '=', args.compression);
-        const row = await (args.includeExpired
-            ? baseQuery.executeTakeFirst()
-            : baseQuery.where('expires_at', '>', nowIso).executeTakeFirst());
-        if (!row)
-            return null;
-        if (row.encoding !== args.encoding) {
-            throw new Error(`Unexpected snapshot chunk encoding: ${String(row.encoding)}`);
-        }
-        if (row.compression !== SYNC_SNAPSHOT_CHUNK_COMPRESSION) {
-            throw new Error(`Unexpected snapshot chunk compression: ${String(row.compression)}`);
-        }
-        return {
-            id: row.chunk_id,
-            sha256: row.sha256,
-            byteLength: Number(row.byte_length ?? 0),
-            nextRowCursor: row.next_row_cursor == null ? null : String(row.next_row_cursor),
-            isLastPage: Number(row.is_last_page ?? 0) === 1,
-            encoding: args.encoding,
-            compression: row.compression,
-        };
-    }
-    async function readBlobHash(chunkId) {
-        const row = await db
-            .selectFrom('sync_snapshot_chunks')
-            .select(['blob_hash'])
-            .where('chunk_id', '=', chunkId)
-            .executeTakeFirst();
-        return row?.blob_hash ?? null;
-    }
-    async function upsertChunkMetadata(metadata, args) {
-        const chunkId = generateChunkId();
-        const now = new Date().toISOString();
-        await db
-            .insertInto('sync_snapshot_chunks')
-            .values({
-            chunk_id: chunkId,
-            partition_id: metadata.partitionId,
-            scope_key: metadata.scopeKey,
-            scope: metadata.scope,
-            as_of_commit_seq: metadata.asOfCommitSeq,
-            row_cursor: metadata.rowCursor ?? '',
-            row_limit: metadata.rowLimit,
-            next_row_cursor: metadata.nextRowCursor ?? null,
-            is_last_page: metadata.isLastPage ? 1 : 0,
-            encoding: metadata.encoding,
-            compression: metadata.compression,
-            sha256: metadata.sha256,
-            byte_length: args.byteLength,
-            blob_hash: args.blobHash,
-            expires_at: metadata.expiresAt,
-            created_at: now,
-        })
-            .onConflict((oc) => oc
-            .columns([
-            'partition_id',
-            'scope_key',
-            'scope',
-            'as_of_commit_seq',
-            'row_cursor',
-            'row_limit',
-            'encoding',
-            'compression',
-        ])
-            .doUpdateSet({
-            expires_at: metadata.expiresAt,
-            blob_hash: args.blobHash,
-            sha256: metadata.sha256,
-            byte_length: args.byteLength,
-            next_row_cursor: metadata.nextRowCursor ?? null,
-            is_last_page: metadata.isLastPage ? 1 : 0,
-            row_cursor: metadata.rowCursor ?? '',
-        }))
-            .execute();
-    }
-    async function readChunkStreamById(chunkId) {
-        const blobHash = await readBlobHash(chunkId);
-        if (!blobHash)
-            return null;
-        if (blobAdapter.getStream) {
-            return blobAdapter.getStream(blobHash);
-        }
-        if (blobAdapter.get) {
-            const bytes = await blobAdapter.get(blobHash);
-            return bytes ? bytesToReadableStream(bytes) : null;
-        }
-        throw new Error(`Blob adapter ${blobAdapter.name} does not support direct get() for snapshot chunks`);
-    }
-    return {
-        name: `db-metadata+${blobAdapter.name}`,
-        async storeChunk(metadata) {
-            const { body, ...metaWithoutBody } = metadata;
-            const blobHash = await computeBlobHash(metaWithoutBody);
-            // Check if blob already exists (content-addressed dedup)
-            const blobExists = await blobAdapter.exists(blobHash);
-            if (!blobExists) {
-                // Store body in blob adapter
-                if (blobAdapter.put) {
-                    await blobAdapter.put(blobHash, body, {
-                        disableChecksum: true,
-                        byteLength: body.length,
-                        contentLength: body.length,
-                    });
-                }
-                else if (blobAdapter.putStream) {
-                    await blobAdapter.putStream(blobHash, bytesToReadableStream(body), {
-                        disableChecksum: true,
-                        byteLength: body.length,
-                        contentLength: body.length,
-                    });
-                }
-                else {
-                    throw new Error(`Blob adapter ${blobAdapter.name} does not support direct put() for snapshot chunks`);
-                }
-            }
-            await upsertChunkMetadata(metaWithoutBody, {
-                blobHash,
-                byteLength: body.length,
-            });
-            const storedRef = await readStoredRef({
-                partitionId: metaWithoutBody.partitionId,
-                scopeKey: metaWithoutBody.scopeKey,
-                scope: metaWithoutBody.scope,
-                asOfCommitSeq: metaWithoutBody.asOfCommitSeq,
-                rowCursor: metaWithoutBody.rowCursor,
-                rowLimit: metaWithoutBody.rowLimit,
-                encoding: metaWithoutBody.encoding,
-                compression: metaWithoutBody.compression,
-                includeExpired: true,
-            });
-            if (!storedRef) {
-                throw new Error('Failed to read stored snapshot chunk reference');
-            }
-            return storedRef;
-        },
-        async storeChunkStream(metadata) {
-            const { bodyStream, byteLength, ...metaWithoutBody } = metadata;
-            const blobHash = await computeBlobHash(metaWithoutBody);
-            const blobExists = await blobAdapter.exists(blobHash);
-            let observedByteLength;
-            if (!blobExists) {
-                if (blobAdapter.putStream) {
-                    const [uploadStream, countStream] = bodyStream.tee();
-                    const uploadPromise = typeof byteLength === 'number'
-                        ? blobAdapter.putStream(blobHash, uploadStream, {
-                            disableChecksum: true,
-                            byteLength,
-                            contentLength: byteLength,
-                        })
-                        : blobAdapter.putStream(blobHash, uploadStream, {
-                            disableChecksum: true,
-                        });
-                    const countPromise = streamByteLength(countStream);
-                    const [, countedByteLength] = await Promise.all([
-                        uploadPromise,
-                        countPromise,
-                    ]);
-                    observedByteLength = countedByteLength;
-                }
-                else if (blobAdapter.put) {
-                    const body = await readAllBytesFromStream(bodyStream);
-                    await blobAdapter.put(blobHash, body);
-                    observedByteLength = body.length;
-                }
-                else {
-                    throw new Error(`Blob adapter ${blobAdapter.name} does not support direct put() for snapshot chunks`);
-                }
-            }
-            else if (typeof byteLength === 'number') {
-                observedByteLength = byteLength;
-                await bodyStream.cancel();
-            }
-            else if (blobAdapter.getMetadata) {
-                const metadata = await blobAdapter.getMetadata(blobHash);
-                if (!metadata) {
-                    throw new Error(`Blob metadata missing for existing chunk ${blobHash}`);
-                }
-                observedByteLength = metadata.size;
-                await bodyStream.cancel();
-            }
-            else {
-                observedByteLength = await streamByteLength(bodyStream);
-            }
-            if (typeof byteLength === 'number' &&
-                Number.isFinite(byteLength) &&
-                observedByteLength !== byteLength) {
-                throw new Error(`Snapshot chunk byte length mismatch: expected ${byteLength}, got ${observedByteLength}`);
-            }
-            await upsertChunkMetadata(metaWithoutBody, {
-                blobHash,
-                byteLength: observedByteLength,
-            });
-            const storedRef = await readStoredRef({
-                partitionId: metaWithoutBody.partitionId,
-                scopeKey: metaWithoutBody.scopeKey,
-                scope: metaWithoutBody.scope,
-                asOfCommitSeq: metaWithoutBody.asOfCommitSeq,
-                rowCursor: metaWithoutBody.rowCursor,
-                rowLimit: metaWithoutBody.rowLimit,
-                encoding: metaWithoutBody.encoding,
-                compression: metaWithoutBody.compression,
-                includeExpired: true,
-            });
-            if (!storedRef) {
-                throw new Error('Failed to read stored snapshot chunk reference');
-            }
-            return storedRef;
-        },
-        async readChunk(chunkId) {
-            const stream = await readChunkStreamById(chunkId);
-            if (!stream)
-                return null;
-            return readAllBytesFromStream(stream);
-        },
-        async readChunkStream(chunkId) {
-            return readChunkStreamById(chunkId);
-        },
-        async findChunk(pageKey) {
-            return readStoredRef(pageKey);
-        },
-        async cleanupExpired(beforeIso) {
-            let deleted = 0;
-            while (true) {
-                const expiredRows = await db
-                    .selectFrom('sync_snapshot_chunks')
-                    .select(['chunk_id', 'blob_hash'])
-                    .where('expires_at', '<=', beforeIso)
-                    .orderBy('expires_at', 'asc')
-                    .limit(CLEANUP_BATCH_SIZE)
-                    .execute();
-                if (expiredRows.length === 0) {
-                    break;
-                }
-                // Delete from blob storage (best effort).
-                await runWithConcurrency(expiredRows, CLEANUP_DELETE_CONCURRENCY, async (row) => {
-                    try {
-                        await blobAdapter.delete(row.blob_hash);
-                    }
-                    catch {
-                        // Ignore deletion errors - blob may be shared or already deleted
-                        // Log for observability but don't fail the cleanup
-                        console.warn(`Failed to delete blob ${row.blob_hash} for chunk ${row.chunk_id}, may be already deleted or shared`);
-                    }
-                });
-                const chunkIds = expiredRows.map((row) => row.chunk_id);
-                if (chunkIds.length > 0) {
-                    const result = await db
-                        .deleteFrom('sync_snapshot_chunks')
-                        .where('chunk_id', 'in', chunkIds)
-                        .executeTakeFirst();
-                    deleted += Number(result.numDeletedRows ?? 0);
-                }
-                if (expiredRows.length < CLEANUP_BATCH_SIZE) {
-                    break;
-                }
-            }
-            return deleted;
-        },
-    };
-}
-//# sourceMappingURL=db-metadata.js.map

package/dist/snapshot-chunks/db-metadata.js.map

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

package/dist/snapshot-chunks/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * @syncular/server - Snapshot chunk storage
- *
- * Separates chunk metadata (database) from body content (blob storage).
- */
-export * from './db-metadata';
-export * from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/snapshot-chunks/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot-chunks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC"}

package/dist/snapshot-chunks/index.js

@@ -1,8 +0,0 @@
-/**
- * @syncular/server - Snapshot chunk storage
- *
- * Separates chunk metadata (database) from body content (blob storage).
- */
-export * from './db-metadata.js';
-export * from './types.js';
-//# sourceMappingURL=index.js.map

package/dist/snapshot-chunks/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshot-chunks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC"}

package/dist/snapshot-chunks/types.d.ts

@@ -1,80 +0,0 @@
-/**
- * @syncular/server - Snapshot chunk storage types
- *
- * Separates chunk metadata (in database) from chunk body (in blob storage).
- * Enables flexible storage backends (database, S3, R2, etc.)
- */
-import type { SyncSnapshotChunkCompression, SyncSnapshotChunkEncoding, SyncSnapshotChunkRef } from '@syncular/core';
-/**
- * Page key for identifying a specific chunk
- */
-export interface SnapshotChunkPageKey {
-    partitionId: string;
-    scopeKey: string;
-    scope: string;
-    asOfCommitSeq: number;
-    rowCursor: string | null;
-    rowLimit: number;
-    encoding: SyncSnapshotChunkEncoding;
-    compression: SyncSnapshotChunkCompression;
-}
-/**
- * Metadata stored in the database for each chunk
- */
-export interface SnapshotChunkMetadata {
-    chunkId: string;
-    partitionId: string;
-    scopeKey: string;
-    scope: string;
-    asOfCommitSeq: number;
-    rowCursor: string | null;
-    rowLimit: number;
-    nextRowCursor?: string | null;
-    isLastPage?: boolean;
-    encoding: SyncSnapshotChunkEncoding;
-    compression: SyncSnapshotChunkCompression;
-    sha256: string;
-    byteLength: number;
-    blobHash: string;
-    expiresAt: string;
-}
-/**
- * Storage interface for snapshot chunks
- */
-export interface SnapshotChunkStorage {
-    /** Storage adapter name */
-    readonly name: string;
-    /**
-     * Store a chunk. Returns chunk reference.
-     * If chunk with same content already exists (by hash), returns existing reference.
-     */
-    storeChunk(metadata: Omit<SnapshotChunkMetadata, 'chunkId' | 'byteLength' | 'blobHash'> & {
-        body: Uint8Array;
-    }): Promise<SyncSnapshotChunkRef>;
-    /**
-     * Store a chunk from a stream.
-     * Preferred for large payloads to avoid full buffering in memory.
-     */
-    storeChunkStream?(metadata: Omit<SnapshotChunkMetadata, 'chunkId' | 'byteLength' | 'blobHash'> & {
-        bodyStream: ReadableStream<Uint8Array>;
-        byteLength?: number;
-    }): Promise<SyncSnapshotChunkRef>;
-    /**
-     * Read chunk body by chunk ID
-     */
-    readChunk(chunkId: string): Promise<Uint8Array | null>;
-    /**
-     * Read chunk body as a stream.
-     * Preferred for large payloads to avoid full buffering in memory.
-     */
-    readChunkStream?(chunkId: string): Promise<ReadableStream<Uint8Array> | null>;
-    /**
-     * Find existing chunk by page key
-     */
-    findChunk(pageKey: SnapshotChunkPageKey): Promise<SyncSnapshotChunkRef | null>;
-    /**
-     * Delete expired chunks. Returns number deleted.
-     */
-    cleanupExpired(beforeIso: string): Promise<number>;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/snapshot-chunks/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/snapshot-chunks/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,4BAA4B,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,CACR,QAAQ,EAAE,IAAI,CACZ,qBAAqB,EACrB,SAAS,GAAG,YAAY,GAAG,UAAU,CACtC,GAAG;QACF,IAAI,EAAE,UAAU,CAAC;KAClB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;;OAGG;IACH,gBAAgB,CAAC,CACf,QAAQ,EAAE,IAAI,CACZ,qBAAqB,EACrB,SAAS,GAAG,YAAY,GAAG,UAAU,CACtC,GAAG;QACF,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;QACvC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEvD;;;OAGG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IAE9E;;OAEG;IACH,SAAS,CACP,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD"}

package/dist/snapshot-chunks/types.js

@@ -1,8 +0,0 @@
-/**
- * @syncular/server - Snapshot chunk storage types
- *
- * Separates chunk metadata (in database) from chunk body (in blob storage).
- * Enables flexible storage backends (database, S3, R2, etc.)
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/snapshot-chunks/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/snapshot-chunks/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/snapshot-chunks.d.ts

@@ -1,90 +0,0 @@
-/**
- * @syncular/server - Encoded snapshot chunk cache (server-side)
- *
- * Used for efficiently serving large bootstrap snapshots (e.g. catalogs)
- * without embedding huge JSON payloads into pull responses.
- */
-import { type ScopeValues, type SyncSnapshotChunkCompression, type SyncSnapshotChunkEncoding, type SyncSnapshotChunkRef } from '@syncular/core';
-import { type Kysely } from 'kysely';
-import type { SyncCoreDb } from './schema';
-export interface SnapshotChunkPageKey {
-    partitionId: string;
-    scopeKey: string;
-    scope: string;
-    asOfCommitSeq: number;
-    rowCursor: string | null;
-    rowLimit: number;
-    encoding: SyncSnapshotChunkEncoding;
-    compression: SyncSnapshotChunkCompression;
-}
-export interface SnapshotChunkScopeCacheKeyInput {
-    partitionId: string;
-    scopes: ScopeValues;
-    schemaVersion?: number | string | null;
-    encoding: SyncSnapshotChunkEncoding;
-    compression: SyncSnapshotChunkCompression;
-    gzipLevel: number;
-    features?: readonly string[];
-}
-export type SnapshotChunkRefWithContinuation = SyncSnapshotChunkRef & {
-    nextRowCursor: string | null;
-    isLastPage: boolean;
-};
-export interface SnapshotChunkRow {
-    chunkId: string;
-    partitionId: string;
-    scopeKey: string;
-    scope: string;
-    asOfCommitSeq: number;
-    rowCursor: string;
-    rowLimit: number;
-    nextRowCursor: string | null;
-    isLastPage: boolean;
-    encoding: SyncSnapshotChunkEncoding;
-    compression: SyncSnapshotChunkCompression;
-    sha256: string;
-    byteLength: number;
-    body: Uint8Array | ReadableStream<Uint8Array>;
-    expiresAt: string;
-}
-/**
- * Generate a stable cache key for snapshot chunks from effective scopes.
- */
-export declare function scopesToSnapshotChunkScopeKey(scopes: ScopeValues): Promise<string>;
-/**
- * Generate the full server-side snapshot chunk cache key.
- *
- * The database page key also stores table, as-of commit, row cursor, row
- * limit, encoding, and compression as indexed columns. This scope key carries
- * the remaining semantic dimensions that otherwise invalidate all pages for a
- * subscription scope.
- */
-export declare function createSnapshotChunkScopeCacheKey(input: SnapshotChunkScopeCacheKeyInput): Promise<string>;
-export declare function readSnapshotChunkRefByPageKey<DB extends SyncCoreDb>(db: Kysely<DB>, args: SnapshotChunkPageKey & {
-    nowIso?: string;
-}): Promise<SnapshotChunkRefWithContinuation | null>;
-export declare function insertSnapshotChunk<DB extends SyncCoreDb>(db: Kysely<DB>, args: {
-    chunkId: string;
-    partitionId: string;
-    scopeKey: string;
-    scope: string;
-    asOfCommitSeq: number;
-    rowCursor: string | null;
-    rowLimit: number;
-    nextRowCursor?: string | null;
-    isLastPage?: boolean;
-    encoding: SyncSnapshotChunkEncoding;
-    compression: SyncSnapshotChunkCompression;
-    sha256: string;
-    body: Uint8Array;
-    expiresAt: string;
-}): Promise<SnapshotChunkRefWithContinuation>;
-export declare function readSnapshotChunk<DB extends SyncCoreDb>(db: Kysely<DB>, chunkId: string, options?: {
-    /** External chunk storage for reading from S3/R2/etc */
-    chunkStorage?: {
-        readChunk(chunkId: string): Promise<Uint8Array | null>;
-        readChunkStream?(chunkId: string): Promise<ReadableStream<Uint8Array> | null>;
-    };
-}): Promise<SnapshotChunkRow | null>;
-export declare function deleteExpiredSnapshotChunks<DB extends SyncCoreDb>(db: Kysely<DB>, nowIso?: string): Promise<number>;
-//# sourceMappingURL=snapshot-chunks.d.ts.map

package/dist/snapshot-chunks.d.ts.map

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