@syncular/core 0.0.4-25 → 0.0.4-32

package/dist/utils/compression.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Gzip-compress a byte array using CompressionStream when available,
+ * with node:zlib fallback for Node/Bun runtimes.
+ */
+export declare function gzipBytes(payload: Uint8Array): Promise<Uint8Array>;
+/**
+ * Gzip-compress bytes and return a stream. When streaming compression is not
+ * available, falls back to eager compression and includes byteLength metadata.
+ */
+export declare function gzipBytesToStream(payload: Uint8Array): Promise<{
+    stream: ReadableStream<Uint8Array>;
+    byteLength?: number;
+}>;
+//# sourceMappingURL=compression.d.ts.map

package/dist/utils/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/utils/compression.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBxE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;IACpE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAgBD"}

package/dist/utils/compression.js

@@ -0,0 +1,77 @@
+function bytesToReadableStream(bytes) {
+    return new ReadableStream({
+        start(controller) {
+            controller.enqueue(bytes);
+            controller.close();
+        },
+    });
+}
+async function streamToBytes(stream) {
+    const reader = stream.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (!value)
+                continue;
+            chunks.push(value);
+            total += value.length;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    if (chunks.length === 0)
+        return new Uint8Array();
+    if (chunks.length === 1)
+        return chunks[0] ?? new Uint8Array();
+    const merged = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        merged.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return merged;
+}
+/**
+ * Gzip-compress a byte array using CompressionStream when available,
+ * with node:zlib fallback for Node/Bun runtimes.
+ */
+export async function gzipBytes(payload) {
+    if (typeof CompressionStream !== 'undefined') {
+        const stream = bytesToReadableStream(payload).pipeThrough(new CompressionStream('gzip'));
+        return streamToBytes(stream);
+    }
+    const nodeZlib = await import('node:zlib');
+    return await new Promise((resolve, reject) => {
+        nodeZlib.gzip(payload, (error, compressed) => {
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve(new Uint8Array(compressed));
+        });
+    });
+}
+/**
+ * Gzip-compress bytes and return a stream. When streaming compression is not
+ * available, falls back to eager compression and includes byteLength metadata.
+ */
+export async function gzipBytesToStream(payload) {
+    if (typeof CompressionStream !== 'undefined') {
+        const source = bytesToReadableStream(payload);
+        const gzipStream = new CompressionStream('gzip');
+        return {
+            stream: source.pipeThrough(gzipStream),
+        };
+    }
+    const compressed = await gzipBytes(payload);
+    return {
+        stream: bytesToReadableStream(compressed),
+        byteLength: compressed.length,
+    };
+}
+//# sourceMappingURL=compression.js.map

package/dist/utils/compression.js.map

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

package/dist/utils/crypto.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cross-runtime SHA-256 digest helper.
+ *
+ * Uses Web Crypto when available, with Node crypto fallback.
+ */
+export declare function sha256Hex(input: string | Uint8Array): Promise<string>;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/utils/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB3E"}

package/dist/utils/crypto.js

@@ -0,0 +1,25 @@
+const textEncoder = new TextEncoder();
+function toHex(bytes) {
+    return Array.from(bytes)
+        .map((byte) => byte.toString(16).padStart(2, '0'))
+        .join('');
+}
+/**
+ * Cross-runtime SHA-256 digest helper.
+ *
+ * Uses Web Crypto when available, with Node crypto fallback.
+ */
+export async function sha256Hex(input) {
+    const payload = typeof input === 'string' ? textEncoder.encode(input) : input;
+    if (typeof crypto !== 'undefined' && crypto.subtle) {
+        const digestBuffer = await crypto.subtle.digest('SHA-256', payload.slice().buffer);
+        return toHex(new Uint8Array(digestBuffer));
+    }
+    try {
+        const nodeCrypto = await import('node:crypto');
+        return nodeCrypto.createHash('sha256').update(payload).digest('hex');
+    }
+    catch { }
+    throw new Error('Failed to create SHA-256 hash, no crypto implementation available');
+}
+//# sourceMappingURL=crypto.js.map

package/dist/utils/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,SAAS,KAAK,CAAC,KAAiB,EAAU;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AAAA,CACb;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAA0B,EAAmB;IAC3E,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE9E,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAC7C,SAAS,EACT,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,CACvB,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC/C,OAAO,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;AAAA,CACH"}

package/dist/utils/id.d.ts

@@ -1,2 +1,3 @@
+export declare function generateId(): string;
 export declare function randomId(): string;
 //# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,IAAI,MAAM,CAMjC"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,IAAI,MAAM,CAmBnC;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC"}

package/dist/utils/id.js

@@ -1,8 +1,22 @@
-export function randomId() {
-    const cryptoObj = globalThis.crypto;
+export function generateId() {
+    const cryptoObj = typeof crypto !== 'undefined' ? crypto : globalThis.crypto;
     if (cryptoObj && typeof cryptoObj.randomUUID === 'function') {
         return cryptoObj.randomUUID();
     }
+    if (cryptoObj && typeof cryptoObj.getRandomValues === 'function') {
+        const bytes = new Uint8Array(16);
+        cryptoObj.getRandomValues(bytes);
+        // UUID v4 variant bits.
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = Array.from(bytes)
+            .map((byte) => byte.toString(16).padStart(2, '0'))
+            .join('');
+        return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+    }
     return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
 }
+export function randomId() {
+    return generateId();
+}
 //# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,GAAW;IACjC,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAAA,CAC/D"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,GAAW;IACnC,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IAC7E,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;QACjC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACjC,wBAAwB;QACxB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACrC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QACrC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;aAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aACjD,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACjH,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAAA,CAC/D;AAED,MAAM,UAAU,QAAQ,GAAW;IACjC,OAAO,UAAU,EAAE,CAAC;AAAA,CACrB"}

package/dist/utils/index.d.ts

@@ -1,3 +1,5 @@
+export * from './compression';
+export * from './crypto';
 export * from './id';
 export * from './object';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -1,3 +1,5 @@
+export * from './compression.js';
+export * from './crypto.js';
 export * from './id.js';
 export * from './object.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/core",
-  "version": "0.0.4-25",
+  "version": "0.0.4-32",
   "description": "Core protocol types and shared utilities for the Syncular sync framework",
   "license": "MIT",
   "author": "Benjamin Kniffler",

package/src/__tests__/compression.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, it } from 'bun:test';
+import { gunzipSync } from 'node:zlib';
+import { gzipBytes, gzipBytesToStream } from '../utils';
+
+async function readStream(
+  stream: ReadableStream<Uint8Array>
+): Promise<Uint8Array> {
+  const reader = stream.getReader();
+  const chunks: Uint8Array[] = [];
+  let total = 0;
+
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    if (!value) continue;
+    chunks.push(value);
+    total += value.length;
+  }
+
+  if (chunks.length === 0) return new Uint8Array();
+  if (chunks.length === 1) return chunks[0] ?? new Uint8Array();
+
+  const merged = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    merged.set(chunk, offset);
+    offset += chunk.length;
+  }
+  return merged;
+}
+
+describe('gzipBytes', () => {
+  it('compresses bytes that can be decompressed via gunzip', async () => {
+    const payload = new TextEncoder().encode(
+      'syncular compression test '.repeat(64)
+    );
+    const compressed = await gzipBytes(payload);
+    const decompressed = new Uint8Array(gunzipSync(compressed));
+    expect(decompressed).toEqual(payload);
+  });
+});
+
+describe('gzipBytesToStream', () => {
+  it('returns a gzip stream that round-trips', async () => {
+    const payload = new TextEncoder().encode('stream compression '.repeat(64));
+    const result = await gzipBytesToStream(payload);
+    const compressed = await readStream(result.stream);
+    const decompressed = new Uint8Array(gunzipSync(compressed));
+    expect(decompressed).toEqual(payload);
+    if (typeof result.byteLength === 'number') {
+      expect(result.byteLength).toBe(compressed.length);
+    }
+  });
+});

package/src/utils/compression.ts

@@ -0,0 +1,91 @@
+function bytesToReadableStream(bytes: Uint8Array): ReadableStream<Uint8Array> {
+  return new ReadableStream<Uint8Array>({
+    start(controller) {
+      controller.enqueue(bytes);
+      controller.close();
+    },
+  });
+}
+
+async function streamToBytes(
+  stream: ReadableStream<Uint8Array>
+): Promise<Uint8Array> {
+  const reader = stream.getReader();
+  const chunks: Uint8Array[] = [];
+  let total = 0;
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (!value) continue;
+      chunks.push(value);
+      total += value.length;
+    }
+  } finally {
+    reader.releaseLock();
+  }
+
+  if (chunks.length === 0) return new Uint8Array();
+  if (chunks.length === 1) return chunks[0] ?? new Uint8Array();
+
+  const merged = new Uint8Array(total);
+  let offset = 0;
+  for (const chunk of chunks) {
+    merged.set(chunk, offset);
+    offset += chunk.length;
+  }
+  return merged;
+}
+
+/**
+ * Gzip-compress a byte array using CompressionStream when available,
+ * with node:zlib fallback for Node/Bun runtimes.
+ */
+export async function gzipBytes(payload: Uint8Array): Promise<Uint8Array> {
+  if (typeof CompressionStream !== 'undefined') {
+    const stream = bytesToReadableStream(payload).pipeThrough(
+      new CompressionStream('gzip') as unknown as TransformStream<
+        Uint8Array,
+        Uint8Array
+      >
+    );
+    return streamToBytes(stream);
+  }
+
+  const nodeZlib = await import('node:zlib');
+  return await new Promise<Uint8Array>((resolve, reject) => {
+    nodeZlib.gzip(payload, (error, compressed) => {
+      if (error) {
+        reject(error);
+        return;
+      }
+      resolve(new Uint8Array(compressed));
+    });
+  });
+}
+
+/**
+ * Gzip-compress bytes and return a stream. When streaming compression is not
+ * available, falls back to eager compression and includes byteLength metadata.
+ */
+export async function gzipBytesToStream(payload: Uint8Array): Promise<{
+  stream: ReadableStream<Uint8Array>;
+  byteLength?: number;
+}> {
+  if (typeof CompressionStream !== 'undefined') {
+    const source = bytesToReadableStream(payload);
+    const gzipStream = new CompressionStream(
+      'gzip'
+    ) as unknown as TransformStream<Uint8Array, Uint8Array>;
+    return {
+      stream: source.pipeThrough(gzipStream),
+    };
+  }
+
+  const compressed = await gzipBytes(payload);
+  return {
+    stream: bytesToReadableStream(compressed),
+    byteLength: compressed.length,
+  };
+}

package/src/utils/crypto.ts

@@ -0,0 +1,33 @@
+const textEncoder = new TextEncoder();
+
+function toHex(bytes: Uint8Array): string {
+  return Array.from(bytes)
+    .map((byte) => byte.toString(16).padStart(2, '0'))
+    .join('');
+}
+
+/**
+ * Cross-runtime SHA-256 digest helper.
+ *
+ * Uses Web Crypto when available, with Node crypto fallback.
+ */
+export async function sha256Hex(input: string | Uint8Array): Promise<string> {
+  const payload = typeof input === 'string' ? textEncoder.encode(input) : input;
+
+  if (typeof crypto !== 'undefined' && crypto.subtle) {
+    const digestBuffer = await crypto.subtle.digest(
+      'SHA-256',
+      payload.slice().buffer
+    );
+    return toHex(new Uint8Array(digestBuffer));
+  }
+
+  try {
+    const nodeCrypto = await import('node:crypto');
+    return nodeCrypto.createHash('sha256').update(payload).digest('hex');
+  } catch {}
+
+  throw new Error(
+    'Failed to create SHA-256 hash, no crypto implementation available'
+  );
+}

package/src/utils/id.ts

@@ -1,7 +1,24 @@
-export function randomId(): string {
-  const cryptoObj = globalThis.crypto;
+export function generateId(): string {
+  const cryptoObj = typeof crypto !== 'undefined' ? crypto : globalThis.crypto;
   if (cryptoObj && typeof cryptoObj.randomUUID === 'function') {
     return cryptoObj.randomUUID();
   }
+
+  if (cryptoObj && typeof cryptoObj.getRandomValues === 'function') {
+    const bytes = new Uint8Array(16);
+    cryptoObj.getRandomValues(bytes);
+    // UUID v4 variant bits.
+    bytes[6] = (bytes[6]! & 0x0f) | 0x40;
+    bytes[8] = (bytes[8]! & 0x3f) | 0x80;
+    const hex = Array.from(bytes)
+      .map((byte) => byte.toString(16).padStart(2, '0'))
+      .join('');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+  }
+
   return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
 }
+
+export function randomId(): string {
+  return generateId();
+}

package/src/utils/index.ts

@@ -1,2 +1,4 @@
+export * from './compression';
+export * from './crypto';
 export * from './id';
 export * from './object';