@syncular/server 0.0.1-60

package/dist/shapes/types.d.ts

@@ -0,0 +1,204 @@
+import type { ScopePattern, ScopeValues, StoredScopes, SyncOp, SyncOperation, SyncOperationResult } from '@syncular/core';
+import type { ZodSchema, z } from 'zod';
+import type { DbExecutor } from '../dialect/types';
+import type { SyncCoreDb } from '../schema';
+/**
+ * Emitted change to be stored in the oplog.
+ * Uses JSONB scopes instead of scope_keys array.
+ */
+export interface EmittedChange {
+    /** Table name */
+    table: string;
+    /** Row primary key */
+    row_id: string;
+    /** Operation type */
+    op: SyncOp;
+    /** Row data as JSON (null for deletes) */
+    row_json: unknown | null;
+    /** Row version for optimistic concurrency */
+    row_version: number | null;
+    /**
+     * Scope values for this change (stored as JSONB).
+     * Example: { user_id: 'U1', project_id: 'P1' }
+     */
+    scopes: StoredScopes;
+}
+export interface ApplyOperationResult {
+    result: SyncOperationResult;
+    emittedChanges: EmittedChange[];
+}
+/**
+ * Context for server operations.
+ */
+export interface ServerContext<DB extends SyncCoreDb = SyncCoreDb> {
+    /** Database connection (transaction in applyOperation) */
+    db: DbExecutor<DB>;
+    /** Actor ID (user ID from auth) */
+    actorId: string;
+}
+/**
+ * Context passed to snapshot method.
+ */
+export interface ServerSnapshotContext<DB extends SyncCoreDb = SyncCoreDb> extends ServerContext<DB> {
+    /** Database executor for the snapshot */
+    db: DbExecutor<DB>;
+    /** Effective scope values for this subscription */
+    scopeValues: ScopeValues;
+    /** Pagination cursor (row_id for keyset pagination) */
+    cursor: string | null;
+    /** Max rows to return */
+    limit: number;
+}
+/**
+ * Context passed to applyOperation method.
+ */
+export interface ServerApplyOperationContext<DB extends SyncCoreDb = SyncCoreDb> extends ServerContext<DB> {
+    /** Database executor for the operation */
+    trx: DbExecutor<DB>;
+    /** Client/device identifier */
+    clientId: string;
+    /** Unique commit identifier */
+    commitId: string;
+    /**
+     * Client's schema version when the commit was created.
+     * Use this to transform payloads from older client versions.
+     */
+    schemaVersion: number;
+}
+/**
+ * Server-side scope configuration for advanced use cases.
+ * Use this when you need custom extraction, access control, or filtering.
+ *
+ * For simple cases, use the simplified scope array format:
+ * `scopes: ['user:{user_id}']`
+ */
+interface ServerScopeConfig {
+    /**
+     * Column name containing the scope value.
+     * For simple patterns like 'user:{user_id}' → column: 'user_id'
+     */
+    column?: string;
+    /**
+     * Custom extractor for complex patterns.
+     * Example: extract year/month from a date column
+     */
+    extract?: (row: Record<string, unknown>) => Record<string, string>;
+    /**
+     * Optional access control per scope pattern.
+     * Return true if the actor can access this scope value.
+     */
+    access?: (ctx: ServerContext, vars: Record<string, string>) => Promise<boolean>;
+    /**
+     * Optional filter builder for wildcard subscriptions.
+     * Called when the subscription uses wildcards for this pattern.
+     */
+    toFilter?: (vars: Record<string, string | undefined>, query: unknown) => unknown;
+}
+/**
+ * Server shape options - configuration for a table's sync behavior.
+ */
+export interface ServerShapeOptions<DB extends SyncCoreDb = SyncCoreDb, Scopes extends Record<ScopePattern, Record<string, string>> = Record<ScopePattern, Record<string, string>>, TableName extends string = string, Params extends ZodSchema = ZodSchema> {
+    /**
+     * Scope patterns this shape uses.
+     * Array of pattern keys from SharedScopes.
+     */
+    scopes: (keyof Scopes)[];
+    /**
+     * Scope definitions - how each pattern maps to row data.
+     * Defaults to using column name = variable name.
+     */
+    scopeDefinitions?: Partial<Record<keyof Scopes, ServerScopeConfig>>;
+    /**
+     * Resolve allowed scope values for the current actor.
+     * Called once per request to determine what the actor can access.
+     *
+     * Returns scope values the actor is allowed to access.
+     * The server will intersect requested scopes with these.
+     *
+     * @example
+     * resolveScopes: async (ctx) => ({
+     *   user_id: [ctx.user.id],
+     *   project_id: ctx.user.projectIds,
+     * })
+     */
+    resolveScopes: (ctx: ServerContext<DB>) => Promise<ScopeValues>;
+    /**
+     * Optional Zod schema for subscription parameters.
+     */
+    params?: Params;
+    /**
+     * Primary key column (default: 'id')
+     */
+    primaryKey?: string;
+    /**
+     * Version column for optimistic concurrency (default: 'server_version')
+     */
+    versionColumn?: string;
+    /**
+     * Tables that must be bootstrapped before this one.
+     */
+    dependsOn?: string[];
+    /**
+     * TTL for cached snapshot chunks (ms). Default: 24 hours.
+     */
+    snapshotChunkTtlMs?: number;
+    /**
+     * Transform client payload → server row on writes.
+     */
+    transformInbound?: (payload: Record<string, unknown>, ctx: ServerApplyOperationContext<DB>) => Partial<DB[TableName & keyof DB]>;
+    /**
+     * Transform server row → client payload on reads.
+     */
+    transformOutbound?: (row: DB[TableName & keyof DB]) => Record<string, unknown>;
+    /**
+     * Custom snapshot implementation.
+     * Default uses keyset pagination ordered by primary key.
+     */
+    snapshot?: (ctx: ServerSnapshotContext<DB>, params: Params extends ZodSchema ? z.infer<Params> : undefined) => Promise<{
+        rows: unknown[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * Custom apply operation implementation.
+     */
+    applyOperation?: (ctx: ServerApplyOperationContext<DB>, op: SyncOperation, opIndex: number) => Promise<ApplyOperationResult>;
+}
+/**
+ * Server-side table handler for snapshots and mutations.
+ * This is the internal handler interface used by the sync engine.
+ */
+export interface ServerTableHandler<DB extends SyncCoreDb = SyncCoreDb> {
+    /** Table name */
+    table: string;
+    /** Scope patterns used by this shape */
+    scopePatterns: ScopePattern[];
+    /**
+     * Tables that must be bootstrapped before this one.
+     */
+    dependsOn?: string[];
+    /**
+     * TTL for cached snapshot chunks (ms).
+     */
+    snapshotChunkTtlMs?: number;
+    /**
+     * Resolve allowed scope values for the current actor.
+     */
+    resolveScopes: (ctx: ServerContext<DB>) => Promise<ScopeValues>;
+    /**
+     * Extract stored scopes from a row.
+     */
+    extractScopes: (row: Record<string, unknown>) => StoredScopes;
+    /**
+     * Build a bootstrap snapshot page.
+     */
+    snapshot(ctx: ServerSnapshotContext<DB>, params: Record<string, unknown> | undefined): Promise<{
+        rows: unknown[];
+        nextCursor: string | null;
+    }>;
+    /**
+     * Apply a single operation.
+     */
+    applyOperation(ctx: ServerApplyOperationContext<DB>, op: SyncOperation, opIndex: number): Promise<ApplyOperationResult>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/shapes/types.d.ts.map

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

package/dist/shapes/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shapes/types.js.map

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

package/dist/snapshot-chunks/adapters/s3.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @syncular/server - S3-compatible snapshot chunk storage adapter
+ *
+ * Stores snapshot chunk bodies in S3/R2/MinIO with metadata in database.
+ */
+import type { BlobStorageAdapter } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { SyncCoreDb } from '../../schema';
+export interface S3SnapshotChunkStorageOptions {
+    /** Database instance for metadata */
+    db: Kysely<SyncCoreDb>;
+    /** S3 blob storage adapter */
+    s3Adapter: BlobStorageAdapter;
+    /** Optional key prefix for all chunks */
+    keyPrefix?: string;
+}
+/**
+ * Create S3-compatible snapshot chunk storage.
+ *
+ * Stores chunk bodies in S3/R2/MinIO and metadata in the database.
+ * Supports presigned URLs for direct client downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createS3BlobStorageAdapter } from '@syncular/server/blobs/adapters/s3';
+ * import { createS3SnapshotChunkStorage } from '@syncular/server/snapshot-chunks/adapters/s3';
+ *
+ * const s3Adapter = createS3BlobStorageAdapter({
+ *   client: new S3Client({ region: 'us-east-1' }),
+ *   bucket: 'my-snapshot-chunks',
+ *   commands: { PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand },
+ *   getSignedUrl,
+ * });
+ *
+ * const chunkStorage = createS3SnapshotChunkStorage({
+ *   db: kysely,
+ *   s3Adapter,
+ *   keyPrefix: 'snapshots/',
+ * });
+ * ```
+ */
+export declare function createS3SnapshotChunkStorage(options: S3SnapshotChunkStorageOptions): {
+    name: string;
+    storeChunk: (metadata: Omit<import("..").SnapshotChunkMetadata, "blobHash" | "byteLength" | "chunkId"> & {
+        body: Uint8Array<ArrayBufferLike>;
+    }) => Promise<{
+        id: string;
+        byteLength: number;
+        sha256: string;
+        encoding: "ndjson";
+        compression: "gzip";
+    }>;
+    readChunk: (chunkId: string) => Promise<Uint8Array<ArrayBufferLike> | null>;
+    findChunk: (pageKey: import("..").SnapshotChunkPageKey) => Promise<{
+        id: string;
+        byteLength: number;
+        sha256: string;
+        encoding: "ndjson";
+        compression: "gzip";
+    } | null>;
+    cleanupExpired: (beforeIso: string) => Promise<number>;
+};
+//# sourceMappingURL=s3.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/snapshot-chunks/adapters/s3.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,6BAA6B;IAC5C,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACvB,8BAA8B;IAC9B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;EAqBvC"}

package/dist/snapshot-chunks/adapters/s3.js

@@ -0,0 +1,50 @@
+/**
+ * @syncular/server - S3-compatible snapshot chunk storage adapter
+ *
+ * Stores snapshot chunk bodies in S3/R2/MinIO with metadata in database.
+ */
+import { createDbMetadataChunkStorage } from '../db-metadata';
+/**
+ * Create S3-compatible snapshot chunk storage.
+ *
+ * Stores chunk bodies in S3/R2/MinIO and metadata in the database.
+ * Supports presigned URLs for direct client downloads.
+ *
+ * @example
+ * ```typescript
+ * import { createS3BlobStorageAdapter } from '@syncular/server/blobs/adapters/s3';
+ * import { createS3SnapshotChunkStorage } from '@syncular/server/snapshot-chunks/adapters/s3';
+ *
+ * const s3Adapter = createS3BlobStorageAdapter({
+ *   client: new S3Client({ region: 'us-east-1' }),
+ *   bucket: 'my-snapshot-chunks',
+ *   commands: { PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand },
+ *   getSignedUrl,
+ * });
+ *
+ * const chunkStorage = createS3SnapshotChunkStorage({
+ *   db: kysely,
+ *   s3Adapter,
+ *   keyPrefix: 'snapshots/',
+ * });
+ * ```
+ */
+export function createS3SnapshotChunkStorage(options) {
+    const { db, s3Adapter, keyPrefix } = options;
+    // Wrap the S3 adapter to use prefixed keys
+    const prefixedAdapter = keyPrefix
+        ? {
+            ...s3Adapter,
+            name: `${s3Adapter.name}+prefixed`,
+            // Keys are already handled by the S3 adapter, prefix is applied there
+        }
+        : s3Adapter;
+    // Use the database metadata storage with S3 for bodies
+    const storage = createDbMetadataChunkStorage({
+        db,
+        blobAdapter: prefixedAdapter,
+        chunkIdPrefix: keyPrefix ? `${keyPrefix.replace(/\/$/, '')}_` : 'chunk_',
+    });
+    return storage;
+}
+//# sourceMappingURL=s3.js.map

package/dist/snapshot-chunks/adapters/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../../src/snapshot-chunks/adapters/s3.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAW9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAsC,EACtC;IACA,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE7C,2CAA2C;IAC3C,MAAM,eAAe,GAAuB,SAAS;QACnD,CAAC,CAAC;YACE,GAAG,SAAS;YACZ,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,WAAW;YAClC,sEAAsE;SACvE;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,uDAAuD;IACvD,MAAM,OAAO,GAAG,4BAA4B,CAAC;QAC3C,EAAE;QACF,WAAW,EAAE,eAAe;QAC5B,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ;KACzE,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AAAA,CAChB"}

package/dist/snapshot-chunks/db-metadata.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @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 type { BlobStorageAdapter, SyncSnapshotChunkRef } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { SyncCoreDb } from '../schema';
+import type { SnapshotChunkMetadata, SnapshotChunkPageKey } from './types';
+export interface DbMetadataSnapshotChunkStorageOptions {
+    /** Database instance */
+    db: Kysely<SyncCoreDb>;
+    /** Blob storage adapter for body content */
+    blobAdapter: BlobStorageAdapter;
+    /** Optional prefix for chunk IDs */
+    chunkIdPrefix?: string;
+}
+/**
+ * Create a snapshot chunk storage that uses:
+ * - Database for metadata (scope, commit seq, etc.)
+ * - Blob adapter for body content
+ */
+export declare function createDbMetadataChunkStorage(options: DbMetadataSnapshotChunkStorageOptions): {
+    name: string;
+    storeChunk: (metadata: Omit<SnapshotChunkMetadata, 'chunkId' | 'byteLength' | 'blobHash'> & {
+        body: Uint8Array;
+    }) => Promise<SyncSnapshotChunkRef>;
+    readChunk: (chunkId: string) => Promise<Uint8Array | null>;
+    findChunk: (pageKey: SnapshotChunkPageKey) => Promise<SyncSnapshotChunkRef | null>;
+    cleanupExpired: (beforeIso: string) => Promise<number>;
+};
+//# sourceMappingURL=db-metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-metadata.d.ts","sourceRoot":"","sources":["../../src/snapshot-chunks/db-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,WAAW,qCAAqC;IACpD,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACvB,4CAA4C;IAC5C,WAAW,EAAE,kBAAkB,CAAC;IAChC,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,qCAAqC,GAC7C;IACD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,CACV,QAAQ,EAAE,IAAI,CACZ,qBAAqB,EACrB,SAAS,GAAG,YAAY,GAAG,UAAU,CACtC,GAAG;QACF,IAAI,EAAE,UAAU,CAAC;KAClB,KACE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC3D,SAAS,EAAE,CACT,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC1C,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD,CAiMA"}

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

@@ -0,0 +1,169 @@
+/**
+ * @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 { createHash } from 'node:crypto';
+/**
+ * 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_' } = options;
+    // Generate deterministic blob hash from content
+    function computeBlobHash(body) {
+        return `sha256:${createHash('sha256').update(body).digest('hex')}`;
+    }
+    // Generate unique chunk ID
+    function generateChunkId() {
+        return `${chunkIdPrefix}${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+    }
+    return {
+        name: `db-metadata+${blobAdapter.name}`,
+        async storeChunk(metadata) {
+            const { body, ...metaWithoutBody } = metadata;
+            const blobHash = computeBlobHash(body);
+            const chunkId = generateChunkId();
+            const now = new Date().toISOString();
+            // 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);
+                }
+                else {
+                    throw new Error(`Blob adapter ${blobAdapter.name} does not support direct put() for snapshot chunks`);
+                }
+            }
+            // Upsert metadata in database
+            await db
+                .insertInto('sync_snapshot_chunks')
+                .values({
+                chunk_id: chunkId,
+                partition_id: metaWithoutBody.partitionId,
+                scope_key: metaWithoutBody.scopeKey,
+                scope: metaWithoutBody.scope,
+                as_of_commit_seq: metaWithoutBody.asOfCommitSeq,
+                row_cursor: metaWithoutBody.rowCursor ?? '',
+                row_limit: metaWithoutBody.rowLimit,
+                encoding: metaWithoutBody.encoding,
+                compression: metaWithoutBody.compression,
+                sha256: metaWithoutBody.sha256,
+                byte_length: body.length,
+                blob_hash: blobHash,
+                expires_at: metaWithoutBody.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: metaWithoutBody.expiresAt,
+                blob_hash: blobHash,
+                sha256: metaWithoutBody.sha256,
+                byte_length: body.length,
+                row_cursor: metaWithoutBody.rowCursor ?? '',
+            }))
+                .execute();
+            return {
+                id: chunkId,
+                sha256: metaWithoutBody.sha256,
+                byteLength: body.length,
+                encoding: metaWithoutBody.encoding,
+                compression: metaWithoutBody.compression,
+            };
+        },
+        async readChunk(chunkId) {
+            // Get metadata to find blob hash
+            const row = await db
+                .selectFrom('sync_snapshot_chunks')
+                .select(['blob_hash'])
+                .where('chunk_id', '=', chunkId)
+                .executeTakeFirst();
+            if (!row)
+                return null;
+            // Read from blob adapter
+            if (blobAdapter.get) {
+                return blobAdapter.get(row.blob_hash);
+            }
+            throw new Error(`Blob adapter ${blobAdapter.name} does not support direct get() for snapshot chunks`);
+        },
+        async findChunk(pageKey) {
+            const nowIso = new Date().toISOString();
+            const rowCursorKey = pageKey.rowCursor ?? '';
+            const row = await db
+                .selectFrom('sync_snapshot_chunks')
+                .select([
+                'chunk_id',
+                'sha256',
+                'byte_length',
+                'encoding',
+                'compression',
+            ])
+                .where('partition_id', '=', pageKey.partitionId)
+                .where('scope_key', '=', pageKey.scopeKey)
+                .where('scope', '=', pageKey.scope)
+                .where('as_of_commit_seq', '=', pageKey.asOfCommitSeq)
+                .where('row_cursor', '=', rowCursorKey)
+                .where('row_limit', '=', pageKey.rowLimit)
+                .where('encoding', '=', pageKey.encoding)
+                .where('compression', '=', pageKey.compression)
+                .where('expires_at', '>', nowIso)
+                .executeTakeFirst();
+            if (!row)
+                return null;
+            if (row.encoding !== 'ndjson') {
+                throw new Error(`Unexpected snapshot chunk encoding: ${String(row.encoding)}`);
+            }
+            if (row.compression !== 'gzip') {
+                throw new Error(`Unexpected snapshot chunk compression: ${String(row.compression)}`);
+            }
+            return {
+                id: row.chunk_id,
+                sha256: row.sha256,
+                byteLength: Number(row.byte_length ?? 0),
+                encoding: row.encoding,
+                compression: row.compression,
+            };
+        },
+        async cleanupExpired(beforeIso) {
+            // Find expired chunks
+            const expiredRows = await db
+                .selectFrom('sync_snapshot_chunks')
+                .select(['chunk_id', 'blob_hash'])
+                .where('expires_at', '<=', beforeIso)
+                .execute();
+            if (expiredRows.length === 0)
+                return 0;
+            // Delete from blob storage (best effort)
+            for (const row of expiredRows) {
+                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`);
+                }
+            }
+            // Delete metadata from database
+            const result = await db
+                .deleteFrom('sync_snapshot_chunks')
+                .where('expires_at', '<=', beforeIso)
+                .executeTakeFirst();
+            return Number(result.numDeletedRows ?? 0);
+        },
+    };
+}
+//# sourceMappingURL=db-metadata.js.map

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

@@ -0,0 +1 @@
+{"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

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

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

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

package/dist/snapshot-chunks/index.js

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

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * @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 { 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: 'ndjson';
+    compression: 'gzip';
+}
+/**
+ * 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;
+    encoding: 'ndjson';
+    compression: 'gzip';
+    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>;
+    /**
+     * Read chunk body by chunk ID
+     */
+    readChunk(chunkId: string): Promise<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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/snapshot-chunks/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;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,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;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,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,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;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAEvD;;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"}