@syncular/server 0.0.6-95 → 0.1.0

package/dist/s3/index.js

@@ -0,0 +1,223 @@
+/**
+ * S3-compatible blob storage adapter.
+ *
+ * Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services.
+ * Requires @aws-sdk/client-s3 and @aws-sdk/s3-request-presigner as peer dependencies.
+ */
+/**
+ * Create an S3-compatible blob storage adapter.
+ *
+ * @example
+ * ```typescript
+ * import { S3Client, PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand } from '@aws-sdk/client-s3';
+ * import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+ *
+ * const adapter = createS3BlobStorageAdapter({
+ *   client: new S3Client({ region: 'us-east-1' }),
+ *   bucket: 'my-bucket',
+ *   keyPrefix: 'blobs/',
+ *   commands: { PutObjectCommand, GetObjectCommand, HeadObjectCommand, DeleteObjectCommand },
+ *   getSignedUrl,
+ * });
+ * ```
+ */
+export function createS3BlobStorageAdapter(options) {
+    const { client, bucket, keyPrefix = '', commands, getSignedUrl, requireChecksum = true, } = options;
+    function getKey(hash, partitionId) {
+        // Remove "sha256:" prefix and use hex as key
+        const hex = hash.startsWith('sha256:') ? hash.slice(7) : hash;
+        const normalizedPartition = partitionId?.trim();
+        if (!normalizedPartition || normalizedPartition === 'default') {
+            return `${keyPrefix}${hex}`;
+        }
+        return `${keyPrefix}${encodeURIComponent(normalizedPartition)}/${hex}`;
+    }
+    return {
+        name: 's3',
+        async signUpload(opts) {
+            const key = getKey(opts.hash, opts.partitionId);
+            // Extract hex hash for checksum (S3 expects base64-encoded SHA-256)
+            const hexHash = opts.hash.startsWith('sha256:')
+                ? opts.hash.slice(7)
+                : opts.hash;
+            // Convert hex to base64 for S3 checksum header
+            const checksumBase64 = hexToBase64(hexHash);
+            const commandInput = {
+                Bucket: bucket,
+                Key: key,
+                ContentLength: opts.size,
+                ContentType: opts.mimeType,
+            };
+            if (requireChecksum) {
+                commandInput.ChecksumSHA256 = checksumBase64;
+            }
+            const command = new commands.PutObjectCommand(commandInput);
+            const url = await getSignedUrl(client, command, {
+                expiresIn: opts.expiresIn,
+            });
+            const headers = {
+                'Content-Type': opts.mimeType,
+                'Content-Length': String(opts.size),
+            };
+            if (requireChecksum) {
+                headers['x-amz-checksum-sha256'] = checksumBase64;
+            }
+            return {
+                url,
+                method: 'PUT',
+                headers,
+            };
+        },
+        async signDownload(opts) {
+            const key = getKey(opts.hash, opts.partitionId);
+            const command = new commands.GetObjectCommand({
+                Bucket: bucket,
+                Key: key,
+            });
+            return getSignedUrl(client, command, { expiresIn: opts.expiresIn });
+        },
+        async exists(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            try {
+                const command = new commands.HeadObjectCommand({
+                    Bucket: bucket,
+                    Key: key,
+                });
+                await client.send(command);
+                return true;
+            }
+            catch (err) {
+                // Check for NotFound error
+                if (isNotFoundError(err)) {
+                    return false;
+                }
+                throw err;
+            }
+        },
+        async delete(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            const command = new commands.DeleteObjectCommand({
+                Bucket: bucket,
+                Key: key,
+            });
+            await client.send(command);
+        },
+        async getMetadata(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            try {
+                const command = new commands.HeadObjectCommand({
+                    Bucket: bucket,
+                    Key: key,
+                });
+                const response = (await client.send(command));
+                return {
+                    size: response.ContentLength ?? 0,
+                    mimeType: response.ContentType,
+                };
+            }
+            catch (err) {
+                if (isNotFoundError(err)) {
+                    return null;
+                }
+                throw err;
+            }
+        },
+        async put(hash, data, _metadata, options) {
+            const key = getKey(hash, options?.partitionId);
+            const command = new commands.PutObjectCommand({
+                Bucket: bucket,
+                Key: key,
+                Body: data,
+                ContentLength: data.length,
+                ContentType: 'application/octet-stream',
+            });
+            await client.send(command);
+        },
+        async get(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            try {
+                const command = new commands.GetObjectCommand({
+                    Bucket: bucket,
+                    Key: key,
+                });
+                const response = (await client.send(command));
+                if (!response.Body)
+                    return null;
+                return response.Body.transformToByteArray();
+            }
+            catch (err) {
+                if (isNotFoundError(err)) {
+                    return null;
+                }
+                throw err;
+            }
+        },
+        async getStream(hash, options) {
+            const key = getKey(hash, options?.partitionId);
+            try {
+                const command = new commands.GetObjectCommand({
+                    Bucket: bucket,
+                    Key: key,
+                });
+                const response = (await client.send(command));
+                if (!response.Body)
+                    return null;
+                return response.Body.transformToWebStream();
+            }
+            catch (err) {
+                if (isNotFoundError(err)) {
+                    return null;
+                }
+                throw err;
+            }
+        },
+    };
+}
+function isNotFoundError(err) {
+    if (typeof err !== 'object' || err === null)
+        return false;
+    const e = err;
+    return (e.name === 'NotFound' ||
+        e.name === 'NoSuchKey' ||
+        e.$metadata?.httpStatusCode === 404);
+}
+function hexToBase64(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    // Use Buffer if available (Node/Bun), otherwise manual base64
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(bytes).toString('base64');
+    }
+    // Manual base64 encoding
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+    let result = '';
+    const len = bytes.length;
+    const remainder = len % 3;
+    for (let i = 0; i < len - remainder; i += 3) {
+        const a = bytes[i];
+        const b = bytes[i + 1];
+        const c = bytes[i + 2];
+        result +=
+            chars.charAt((a >> 2) & 0x3f) +
+                chars.charAt(((a << 4) | (b >> 4)) & 0x3f) +
+                chars.charAt(((b << 2) | (c >> 6)) & 0x3f) +
+                chars.charAt(c & 0x3f);
+    }
+    if (remainder === 1) {
+        const a = bytes[len - 1];
+        result += `${chars.charAt((a >> 2) & 0x3f) + chars.charAt((a << 4) & 0x3f)}==`;
+    }
+    else if (remainder === 2) {
+        const a = bytes[len - 2];
+        const b = bytes[len - 1];
+        result +=
+            chars.charAt((a >> 2) & 0x3f) +
+                chars.charAt(((a << 4) | (b >> 4)) & 0x3f) +
+                chars.charAt((b << 2) & 0x3f) +
+                '=';
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/s3/index.js.map

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

package/dist/schema.d.ts

@@ -5,6 +5,7 @@
  * - sync_commits: one row per committed push
  * - sync_changes: one row per emitted change, stamped with scopes
  * - sync_table_commits: commit routing index for fast pull
+ * - sync_scope_commits: scope routing index for scoped incremental pull
  */
 import type { SyncOp } from '@syncular/core';
 import type { Generated } from 'kysely';
@@ -30,6 +31,10 @@ export interface SyncCommitsTable {
     result_json: unknown | null;
     /** Number of emitted changes (denormalized for observability) */
     change_count: Generated<number>;
+    /** Hex SHA-256 digest of the canonical persisted commit payload */
+    commit_digest: Generated<string | null>;
+    /** Hex SHA-256 root chaining this commit to the previous partition root */
+    commit_chain_root: Generated<string | null>;
     /**
      * Tables affected by this commit (for realtime notifications).
      * Array of table names that had changes.
@@ -79,6 +84,15 @@ export interface SyncClientCursorsTable {
      * This is the intersection of requested scopes and allowed scopes.
      */
     effective_scopes: unknown;
+    /**
+     * Last active realtime subscription snapshot for websocket binary packs.
+     *
+     * This duplicates the protocol-level subscription id/table/scope/cursor/root
+     * shape from the latest successful pull so a restarted realtime server can
+     * rebuild scoped binary notifications before the client performs another
+     * HTTP pull.
+     */
+    realtime_subscriptions: unknown | null;
     /** Last update timestamp */
     updated_at: Generated<string>;
 }
@@ -100,7 +114,11 @@ export interface SyncSnapshotChunksTable {
     row_cursor: string;
     /** Snapshot row limit used to produce this chunk */
     row_limit: number;
-    /** Row encoding (e.g. 'json-row-frame-v1') */
+    /** Cursor after this chunk; null means no next row for this table */
+    next_row_cursor?: string | null;
+    /** 1 when this chunk reaches the end of the table snapshot */
+    is_last_page?: number;
+    /** Row encoding (e.g. 'binary-table-v1') */
     encoding: string;
     /** Compression algorithm (e.g. 'gzip') */
     compression: string;
@@ -117,6 +135,105 @@ export interface SyncSnapshotChunksTable {
     /** Expiration timestamp (server may delete after this) */
     expires_at: string;
 }
+/**
+ * Cached scoped snapshot artifacts.
+ *
+ * Artifacts are larger immutable bootstrap payloads, such as scoped SQLite
+ * snapshot files, addressed by a verified manifest and stored in object
+ * storage via blob_hash.
+ */
+export interface SyncSnapshotArtifactsTable {
+    /** Opaque artifact id */
+    artifact_id: string;
+    /** Logical partition key (tenant / demo / workspace) */
+    partition_id: string;
+    /** Effective scope key this artifact belongs to */
+    scope_key: string;
+    /** Stable subscription id this artifact serves */
+    subscription_id: string;
+    /** App table represented by the artifact */
+    table: string;
+    /** Artifact format (e.g. 'sqlite-snapshot-v1') */
+    artifact_kind: string;
+    /** App schema/cache semantic version */
+    schema_version: string;
+    /** Snapshot as-of commit sequence */
+    as_of_commit_seq: number;
+    /** Snapshot row cursor key (empty string represents null) */
+    row_cursor: string;
+    /** Snapshot row limit used to produce this artifact */
+    row_limit: number;
+    /** Number of rows included in the artifact */
+    row_count: number;
+    /** Cursor after this artifact; null means no next row for this table */
+    next_row_cursor?: string | null;
+    /** 1 when this artifact starts at the table's first page */
+    is_first_page: number;
+    /** 1 when this artifact reaches the end of the table snapshot */
+    is_last_page: number;
+    /** Artifact compression algorithm */
+    compression: string;
+    /** Hex-encoded sha256 of artifact body bytes */
+    sha256: string;
+    /** Byte length of artifact body bytes */
+    byte_length: number;
+    /** Hex digest of the scoped artifact manifest */
+    manifest_digest: string;
+    /** Normalized JSON feature set */
+    feature_set_json: string;
+    /** Canonical manifest JSON */
+    manifest_json: string;
+    /** Reference to blob storage */
+    blob_hash: string;
+    /** Created timestamp */
+    created_at: Generated<string>;
+    /** Expiration timestamp (server may delete after this) */
+    expires_at: string;
+}
+/**
+ * Shared encrypted CRDT update log.
+ *
+ * One physical table stores updates for every encrypted CRDT field. The logical
+ * stream is keyed by partition_id + stream_id, where stream_id is derived from
+ * app_table + row_id + field_name.
+ */
+export interface SyncCrdtUpdatesTable {
+    seq: Generated<number>;
+    partition_id: string;
+    stream_id: string;
+    app_table: string;
+    row_id: string;
+    field_name: string;
+    update_id: string;
+    actor_id: string | null;
+    client_id: string | null;
+    key_id: string;
+    ciphertext: string;
+    scopes: unknown;
+    created_at: Generated<string>;
+}
+/**
+ * Shared encrypted CRDT checkpoints.
+ *
+ * Checkpoints contain encrypted full Yjs/Yrs state snapshots and allow old
+ * update-log rows to be garbage-collected after retention rules are satisfied.
+ */
+export interface SyncCrdtCheckpointsTable {
+    seq: Generated<number>;
+    partition_id: string;
+    stream_id: string;
+    app_table: string;
+    row_id: string;
+    field_name: string;
+    checkpoint_id: string;
+    covers_seq: number;
+    actor_id: string | null;
+    client_id: string | null;
+    key_id: string;
+    ciphertext: string;
+    scopes: unknown;
+    created_at: Generated<string>;
+}
 /**
  * Index table: which commits affect which tables.
  *
@@ -129,6 +246,19 @@ export interface SyncTableCommitsTable {
     table: string;
     commit_seq: number;
 }
+/**
+ * Index table: which commits affect which table/scope route keys.
+ *
+ * Used to avoid scanning table-level commits that cannot match a scoped
+ * subscription. JSON scope filtering still validates exact multi-scope matches.
+ */
+export interface SyncScopeCommitsTable {
+    /** Logical partition key (tenant / demo / workspace) */
+    partition_id: string;
+    table: string;
+    scope_key: string;
+    commit_seq: number;
+}
 /**
  * Database interface for sync infrastructure tables
  * Merge this with your app's database interface
@@ -137,8 +267,12 @@ export interface SyncCoreDb {
     sync_commits: SyncCommitsTable;
     sync_changes: SyncChangesTable;
     sync_client_cursors: SyncClientCursorsTable;
+    sync_crdt_updates: SyncCrdtUpdatesTable;
+    sync_crdt_checkpoints: SyncCrdtCheckpointsTable;
     sync_table_commits: SyncTableCommitsTable;
+    sync_scope_commits: SyncScopeCommitsTable;
     sync_snapshot_chunks: SyncSnapshotChunksTable;
+    sync_snapshot_artifacts: SyncSnapshotArtifactsTable;
 }
 /**
  * Commit metadata row for pull responses
@@ -148,6 +282,8 @@ export interface SyncCommitRow {
     actor_id: string;
     created_at: string;
     result_json: unknown | null;
+    commit_digest: string | null;
+    commit_chain_root: string | null;
 }
 /**
  * Change row for pull responses

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,wBAAwB;IACxB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,2CAA2C;IAC3C,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,mEAAmE;IACnE,aAAa,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,2EAA2E;IAC3E,iBAAiB,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5C;;;OAGG;IACH,eAAe,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7B,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,sDAAsD;IACtD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,sBAAsB,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,4BAA4B;IAC5B,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,wBAAwB;IACxB,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,mBAAmB,EAAE,sBAAsB,CAAC;IAC5C,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,qBAAqB,EAAE,wBAAwB,CAAC;IAChD,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,kBAAkB,EAAE,qBAAqB,CAAC;IAC1C,oBAAoB,EAAE,uBAAuB,CAAC;IAC9C,uBAAuB,EAAE,0BAA0B,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/schema.js

@@ -5,6 +5,7 @@
  * - sync_commits: one row per committed push
  * - sync_changes: one row per emitted change, stamped with scopes
  * - sync_table_commits: commit routing index for fast pull
+ * - sync_scope_commits: scope routing index for scoped incremental pull
  */
 export {};
 //# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/service-worker/index.d.ts

@@ -0,0 +1,114 @@
+import { type SyncTransport } from '@syncular/core';
+import { type ClientOptions } from '@syncular/core/http';
+export declare const SERVICE_WORKER_WAKE_CHANNEL = "syncular-sw-realtime-v1";
+export declare const SERVICE_WORKER_WAKE_MESSAGE_TYPE = "syncular:service-worker:wakeup";
+export type ServiceWorkerConnectionState = 'disconnected' | 'connecting' | 'connected';
+export interface ServiceWorkerWakeMessage {
+    type: string;
+    timestamp: number;
+    cursor?: number;
+    sourceClientId?: string;
+}
+export declare function isServiceWorkerWakeMessage(value: unknown): value is ServiceWorkerWakeMessage;
+export interface ServiceWorkerWakeTransport extends SyncTransport {
+    connect(args: {
+        clientId: string;
+    }, onEvent: (event: {
+        event: 'sync';
+        data: {
+            cursor?: number;
+            timestamp: number;
+        };
+    }) => void, onStateChange?: (state: ServiceWorkerConnectionState) => void): () => void;
+    getConnectionState(): ServiceWorkerConnectionState;
+    reconnect(): void;
+}
+export interface ServiceWorkerWakeTransportOptions extends ClientOptions {
+    channelName?: string;
+    includeServiceWorkerMessages?: boolean;
+    isWakeMessage?: (payload: unknown) => payload is ServiceWorkerWakeMessage;
+}
+export declare function createServiceWorkerWakeTransport(options: ServiceWorkerWakeTransportOptions): ServiceWorkerWakeTransport;
+export interface ServiceWorkerServer {
+    shouldHandleRequest(request: Request, localOrigin?: string): boolean;
+    handleRequest(request: Request): Promise<Response>;
+    captureWakeContext(request: Request): Promise<unknown>;
+    resolveWakeMessage(args: {
+        request: Request;
+        response: Response;
+        wakeContext: unknown;
+    }): Promise<ServiceWorkerWakeMessage | null>;
+}
+export interface ResolveWakeMessageArgs {
+    request: Request;
+    response: Response;
+    wakeContext: unknown;
+}
+export interface ServiceWorkerSyncWakeContext {
+    sourceClientId?: string;
+}
+export interface ServiceWorkerSyncWakeMessageResolverOptions {
+    syncPathnames?: string[];
+}
+export interface CreateServiceWorkerServerOptions {
+    handleRequest: (request: Request) => Promise<Response> | Response;
+    apiPrefix?: string;
+    serviceWorkerScriptPath?: string;
+    syncPathnames?: string[];
+    captureWakeContext?: (request: Request) => Promise<unknown>;
+    resolveWakeMessage?: (args: ResolveWakeMessageArgs) => Promise<ServiceWorkerWakeMessage | null>;
+    onError?: (error: unknown, request: Request) => Promise<Response> | Response;
+}
+export declare function createSyncWakeMessageResolver(options?: ServiceWorkerSyncWakeMessageResolverOptions): {
+    captureContext: (request: Request) => Promise<ServiceWorkerSyncWakeContext | null>;
+    resolveMessage: (args: ResolveWakeMessageArgs) => Promise<ServiceWorkerWakeMessage | null>;
+};
+export declare function createServiceWorkerServer(options: CreateServiceWorkerServerOptions): ServiceWorkerServer;
+export interface ServiceWorkerGlobalScopeLike {
+    addEventListener(type: string, listener: (event: unknown) => void): void;
+    location?: {
+        origin?: string;
+    };
+    skipWaiting?: () => Promise<void>;
+    clients?: {
+        claim?: () => Promise<void>;
+        matchAll?: (options?: {
+            type?: 'window' | 'worker' | 'sharedworker' | 'all';
+            includeUncontrolled?: boolean;
+        }) => Promise<Array<{
+            postMessage: (message: unknown) => void;
+        }>>;
+    };
+}
+export interface AttachServiceWorkerServerOptions {
+    manageLifecycle?: boolean;
+    channelName?: string;
+    logger?: {
+        error?: (...args: unknown[]) => void;
+    };
+}
+export declare function attachServiceWorkerServer(globalScope: ServiceWorkerGlobalScopeLike, server: ServiceWorkerServer, options?: AttachServiceWorkerServerOptions): void;
+export interface ConfigureServiceWorkerServerOptions {
+    scriptPath: string;
+    scriptVersion?: string;
+    healthPath?: string;
+    healthCheck?: (response: Response) => boolean | Promise<boolean>;
+    enabled?: boolean;
+    scope?: string;
+    type?: 'classic' | 'module';
+    updateViaCache?: 'imports' | 'all' | 'none';
+    unregisterOnDisable?: boolean;
+    controllerTimeoutMs?: number;
+    healthTimeoutMs?: number;
+    healthRetryDelayMs?: number;
+    healthRequestTimeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    logger?: {
+        info?: (...args: unknown[]) => void;
+        warn?: (...args: unknown[]) => void;
+        error?: (...args: unknown[]) => void;
+    };
+}
+export declare function unregisterServiceWorkerRegistrations(scriptPath: string): Promise<void>;
+export declare function configureServiceWorkerServer(options: ConfigureServiceWorkerServerOptions): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/service-worker/index.d.ts.map

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