@evolu/common 7.4.0 → 8.0.0-next.0

package/dist/src/local-first/Timestamp.js

@@ -1,25 +1,19 @@
+/**
+ * Hybrid logical clock timestamps for CRDT ordering.
+ *
+ * @module
+ */
 import { bytesToHex } from "../Buffer.js";
 import { createEqObject, eqNumber, eqString } from "../Eq.js";
 import { increment } from "../Number.js";
 import { orderUint8Array } from "../Order.js";
 import { err, ok } from "../Result.js";
-import { brand, lessThanOrEqualTo, NonNegativeInt, object, regex, String, Uint8Array, } from "../Type.js";
-/**
- * Millis is a timestamp in milliseconds, like `Date.now()`, but limited to the
- * maximum value representable in 6 bytes (281474976710655) minus 1 (reserved
- * for infinity). This enables more efficient binary serialization, saving 2
- * bytes compared to the typical 8-byte (64-bit) timestamp representation.
- *
- * This limit is enforced to prevent data corruption. If a device's clock
- * exceeds this range, Evolu will stop saving data until the clock is
- * corrected.
- *
- * `new Date(281474976710654).toString()` = Tue Aug 02 10889 07:31:49
- */
-export const Millis = brand("Millis", lessThanOrEqualTo(281474976710655 - 1)(NonNegativeInt));
-export const minMillis = 0;
-export const maxMillis = (281474976710655 - 1);
-export const Counter = brand("Counter", lessThanOrEqualTo(65535)(NonNegativeInt));
+import { Millis, minMillis } from "../Time.js";
+import { brand, length, lessThanOrEqualTo, NonNegativeInt, object, regex, String, Uint8Array, } from "../Type.js";
+/** Default value for {@link TimestampConfig.maxDrift}. */
+export const defaultTimestampMaxDrift = 5 * 60 * 1000;
+export const Counter = /*#__PURE__*/ brand("Counter", 
+/*#__PURE__*/ lessThanOrEqualTo(65535)(NonNegativeInt));
 export const minCounter = 0;
 export const maxCounter = 65535;
 /**
@@ -47,7 +41,7 @@ export const maxCounter = 65535;
  * yet they will think they are synced. This is extremely rare and can be
  * resolved by resetting one device to generate a new NodeId.
  */
-export const NodeId = regex("NodeId", /^[a-f0-9]{16}$/)(String);
+export const NodeId = /*#__PURE__*/ regex("NodeId", /^[a-f0-9]{16}$/)(String);
 export const minNodeId = "0000000000000000";
 export const maxNodeId = "ffffffffffffffff";
 /**
@@ -56,7 +50,7 @@ export const maxNodeId = "ffffffffffffffff";
  * Timestamps serve as globally unique, causally ordered identifiers for CRDT
  * messages in Evolu's sync protocol.
  *
- * ### Why Hybrid Logical Clocks
+ * ## Why Hybrid Logical Clocks
  *
  * Evolu uses Hybrid Logical Clocks (HLC), which combine physical time (millis)
  * with a logical counter. This hybrid approach preserves causality like logical
@@ -81,14 +75,14 @@ export const maxNodeId = "ffffffffffffffff";
  * configuration protects against buggy clocks and prevents problematic
  * future-dated entries from propagating through the network.
  *
- * ### References
+ * ## References
  *
  * - https://muratbuffalo.blogspot.com/2014/07/hybrid-logical-clocks.html
  * - https://sergeiturukin.com/2017/06/26/hybrid-logical-clocks.html
  * - https://jaredforsyth.com/posts/hybrid-logical-clocks/
  * - https://willowprotocol.org/more/timestamps_really/index.html
  *
- * ### Privacy Considerations
+ * ## Privacy Considerations
  *
  * Timestamps are metadata visible to relays and collaborators. While it can be
  * considered a privacy leak, let us explain why it's necessary, and how to
@@ -105,14 +99,18 @@ export const maxNodeId = "ffffffffffffffff";
  * 2. Periodically and randomly flush messages to sync tables
  *
  * **Trade-off:** It breaks real-time collaboration.
+ *
+ * Another technique is generating fake random activity (dummy messages) to mask
+ * real usage patterns. This preserves real-time collaboration but increases
+ * storage and bandwidth usage.
  */
-export const Timestamp = object({
+export const Timestamp = /*#__PURE__*/ object({
     millis: Millis,
     counter: Counter,
     nodeId: NodeId,
 });
 /** Equality function for comparing {@link Timestamp}. */
-export const eqTimestamp = createEqObject({
+export const eqTimestamp = /*#__PURE__*/ createEqObject({
     millis: eqNumber,
     counter: eqNumber,
     nodeId: eqString,
@@ -177,8 +175,9 @@ export const receiveTimestamp = (deps) => (local, remote) => {
     });
 };
 /** Sortable bytes representation of {@link Timestamp}. */
-export const TimestampBytes = brand("TimestampBytes", Uint8Array);
-export const timestampBytesLength = NonNegativeInt.orThrow(16);
+export const TimestampBytes = /*#__PURE__*/ brand("TimestampBytes", 
+/*#__PURE__*/ length(16)(Uint8Array));
+export const timestampBytesLength = /*#__PURE__*/ NonNegativeInt.orThrow(16);
 export const timestampToTimestampBytes = (timestamp) => {
     const { millis, counter, nodeId } = timestamp;
     // 6 bytes for millis, 2 bytes for counter, 8 bytes for nodeId.

package/dist/src/local-first/index.d.ts

@@ -1,25 +1,12 @@
-/**
- * Internal local-first modules re-exported from "@evolu/common/local-first"
- *
- * These exports expose the internal building blocks of Evolu's local-first
- * implementation (Db, Relay, Sync, Query, Storage, Timestamp, etc.). They are
- * primarily intended for use within Evolu packages and for advanced use-cases
- * that require direct access to local-first internals.
- *
- * Public consumers should us top-level exports from `@evolu/common` unless you
- * have a specific need to import these internals.
- *
- * @module
- */
 export * from "./Db.js";
+export * from "./Error.js";
 export * from "./Evolu.js";
 export * from "./Owner.js";
-export * from "./Platform.js";
 export * from "./Protocol.js";
 export * from "./Query.js";
 export * from "./Relay.js";
 export * from "./Schema.js";
+export * from "./Shared.js";
 export * from "./Storage.js";
-export * from "./Sync.js";
 export * from "./Timestamp.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/local-first/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local-first/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local-first/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/src/local-first/index.js

@@ -1,24 +1,11 @@
-/**
- * Internal local-first modules re-exported from "@evolu/common/local-first"
- *
- * These exports expose the internal building blocks of Evolu's local-first
- * implementation (Db, Relay, Sync, Query, Storage, Timestamp, etc.). They are
- * primarily intended for use within Evolu packages and for advanced use-cases
- * that require direct access to local-first internals.
- *
- * Public consumers should us top-level exports from `@evolu/common` unless you
- * have a specific need to import these internals.
- *
- * @module
- */
 export * from "./Db.js";
+export * from "./Error.js";
 export * from "./Evolu.js";
 export * from "./Owner.js";
-export * from "./Platform.js";
 export * from "./Protocol.js";
 export * from "./Query.js";
 export * from "./Relay.js";
 export * from "./Schema.js";
+export * from "./Shared.js";
 export * from "./Storage.js";
-export * from "./Sync.js";
 export * from "./Timestamp.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/common",
-  "version": "7.4.0",
+  "version": "8.0.0-next.0",
   "description": "TypeScript library and local-first platform",
   "keywords": [
     "evolu",
@@ -23,15 +23,27 @@
       "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js",
       "browser": "./dist/src/index.js",
-      "react-native": "./dist/src/index.js"
+      "react-native": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
     },
     "./local-first": {
       "types": "./dist/src/local-first/index.d.ts",
-      "import": "./dist/src/local-first/index.js"
+      "import": "./dist/src/local-first/index.js",
+      "default": "./dist/src/local-first/index.js"
+    },
+    "./polyfills": {
+      "types": "./dist/src/Polyfills.d.ts",
+      "import": "./dist/src/Polyfills.js",
+      "browser": "./dist/src/Polyfills.js",
+      "react-native": "./dist/src/Polyfills.js",
+      "default": "./dist/src/Polyfills.js"
     }
   },
   "typesVersions": {
     "*": {
+      "polyfills": [
+        "./dist/src/Polyfills.d.ts"
+      ],
       "local-first": [
         "./dist/src/local-first/index.d.ts"
       ]
@@ -42,39 +54,37 @@
     "src/**",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "prepack": "npm run build",
+    "format": "prettier --write \"src/*.{ts,tsx,md}\""
+  },
   "dependencies": {
-    "@noble/ciphers": "^2.0.0",
-    "@noble/hashes": "^2.0.0",
-    "@scure/bip39": "^2.0.0",
-    "kysely": "^0.28.4",
-    "msgpackr": "^1.11.5",
+    "@noble/ciphers": "^2.1.1",
+    "@noble/hashes": "^2.0.1",
+    "@scure/bip39": "^2.0.1",
+    "kysely": "^0.28.15",
+    "msgpackr": "^1.11.8",
     "random": "^5.4.1"
   },
   "devDependencies": {
     "@bokuweb/zstd-wasm": "0.0.27",
+    "@evolu/typescript-config": "*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/ws": "^8.18.1",
-    "better-sqlite3": "^12.1.1",
-    "fast-check": "^4.2.0",
-    "typescript": "^5.9.2",
-    "vitest": "^4.0.4",
-    "ws": "^8.18.2",
-    "@evolu/tsconfig": "0.0.2"
+    "better-sqlite3": "^12.6.2",
+    "fast-check": "^4.5.3",
+    "playwright": "^1.58.1",
+    "typescript": "^5.9.3",
+    "webpack": "^5.98.0",
+    "ws": "^8.19.0",
+    "zod": "^4.3.6"
   },
   "publishConfig": {
     "access": "public"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
-  "sideEffects": [],
-  "scripts": {
-    "dev": "tsc --watch",
-    "build": "rimraf dist && tsc",
-    "test": "vitest run --disableConsoleIntercept",
-    "test:watch": "vitest --disableConsoleIntercept",
-    "clean": "rimraf .turbo node_modules dist",
-    "format": "prettier --write \"src/*.{ts,tsx,md}\"",
-    "bench": "vitest bench"
-  }
-}
+  "sideEffects": false
+}