@evolu/common 8.0.0-next.4 → 8.0.0

package/src/local-first/Timestamp.ts

@@ -4,27 +4,30 @@
  * @module
  */
 
-import { bytesToHex } from "../Buffer.js";
-import type { RandomBytesDep } from "../Crypto.js";
-import { createEqObject, eqNumber, eqString } from "../Eq.js";
-import { increment } from "../Number.js";
-import type { Order } from "../Order.js";
-import { orderUint8Array } from "../Order.js";
-import type { Result } from "../Result.js";
-import { err, ok } from "../Result.js";
-import type { TimeDep } from "../Time.js";
-import { Millis, minMillis } from "../Time.js";
-import type { DateIso, InferType, Typed } from "../Type.js";
+import { bytesToHex } from "../Buffer.ts";
+import type { RandomBytesDep } from "../Crypto.ts";
+import { createEqObject, eqNumber, eqString } from "../Eq.ts";
+import { increment } from "../Number.ts";
+import type { Order } from "../Order.ts";
+import { orderUint8Array } from "../Order.ts";
+import type { Result } from "../Result.ts";
+import { err, ok } from "../Result.ts";
+import type { TimeDep } from "../Time.ts";
+import { Millis, minMillis } from "../Time.ts";
 import {
   brand,
+  type DateIso,
+  type InferType,
   length,
   lessThanOrEqualTo,
   NonNegativeInt,
   object,
+  type ObjectType,
   regex,
   String,
+  type Typed,
   Uint8Array,
-} from "../Type.js";
+} from "../Type.ts";
 
 export interface TimestampConfig {
   /**
@@ -60,7 +63,7 @@ export const Counter = /*#__PURE__*/ brand(
   "Counter",
   /*#__PURE__*/ lessThanOrEqualTo(65535)(NonNegativeInt),
 );
-export type Counter = typeof Counter.Type;
+export type Counter = typeof Counter.Output;
 
 export const minCounter = 0 as Counter;
 export const maxCounter = 65535 as Counter;
@@ -91,7 +94,7 @@ export const maxCounter = 65535 as Counter;
  * resolved by resetting one device to generate a new NodeId.
  */
 export const NodeId = /*#__PURE__*/ regex("NodeId", /^[a-f0-9]{16}$/)(String);
-export type NodeId = typeof NodeId.Type;
+export type NodeId = typeof NodeId.Output;
 
 export const minNodeId = "0000000000000000" as NodeId;
 export const maxNodeId = "ffffffffffffffff" as NodeId;
@@ -156,7 +159,11 @@ export const maxNodeId = "ffffffffffffffff" as NodeId;
  * real usage patterns. This preserves real-time collaboration but increases
  * storage and bandwidth usage.
  */
-export const Timestamp = /*#__PURE__*/ object({
+export const Timestamp: ObjectType<{
+  readonly millis: typeof Millis;
+  readonly counter: typeof Counter;
+  readonly nodeId: typeof NodeId;
+}> = /*#__PURE__*/ object({
   millis: Millis,
   counter: Counter,
   nodeId: NodeId,
@@ -186,7 +193,7 @@ const getNextMillis =
   (
     millis: ReadonlyArray<Millis>,
   ): Result<Millis, TimestampTimeOutOfRangeError | TimestampDriftError> => {
-    const now = Millis.from(deps.time.now());
+    const now = Millis.fromUnknown(deps.time.now());
     if (!now.ok) {
       return err({ type: "TimestampTimeOutOfRangeError" });
     }
@@ -203,7 +210,7 @@ const getNextMillis =
 const incrementCounter = (
   counter: Counter,
 ): Result<Counter, TimestampCounterOverflowError> => {
-  const next = Counter.from(increment(counter));
+  const next = Counter.fromUnknown(increment(counter));
   if (!next.ok) return err({ type: "TimestampCounterOverflowError" });
   return ok(next.value);
 };
@@ -271,7 +278,7 @@ export const TimestampBytes = /*#__PURE__*/ brand(
   "TimestampBytes",
   /*#__PURE__*/ length(16)(Uint8Array),
 );
-export type TimestampBytes = typeof TimestampBytes.Type;
+export type TimestampBytes = typeof TimestampBytes.Output;
 
 export const timestampBytesLength = /*#__PURE__*/ NonNegativeInt.orThrow(16);
 

package/src/local-first/index.ts

@@ -1,11 +1,11 @@
-export * from "./Db.js";
-export * from "./Error.js";
-export * from "./Evolu.js";
-export * from "./Owner.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 "./Timestamp.js";
+export * from "./Db.ts";
+export * from "./Error.ts";
+export * from "./Evolu.ts";
+export * from "./Owner.ts";
+export * from "./Protocol.ts";
+export * from "./Query.ts";
+export * from "./Relay.ts";
+export * from "./Schema.ts";
+export * from "./Shared.ts";
+export * from "./Storage.ts";
+export * from "./Timestamp.ts";

package/dist/src/Skiplist.d.ts

@@ -1,28 +0,0 @@
-/**
- * Skiplist data structure with probabilistic level generation.
- *
- * @module
- */
-import type { RandomDep } from "./Random.js";
-import { PositiveInt } from "./Type.js";
-export interface SkiplistLevel {
-    readonly create: () => PositiveInt;
-}
-export interface SkiplistLevelDep {
-    readonly skiplistLevel: SkiplistLevel;
-}
-export interface SkiplistLevelConfig {
-    readonly probability?: number;
-    readonly maxLevel?: number;
-}
-export declare const createSkiplistLevel: (deps: RandomDep) => (config?: SkiplistLevelConfig) => SkiplistLevel;
-export interface Skiplist {
-    readonly insert: (key: number) => void;
-    readonly find: (key: number) => SkiplistNode | null;
-}
-export interface SkiplistNode {
-    readonly key: number;
-    readonly pointers: Array<SkiplistNode>;
-}
-export declare const createSkiplist: (deps: SkiplistLevelDep) => Skiplist;
-//# sourceMappingURL=Skiplist.d.ts.map

package/dist/src/Skiplist.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Skiplist.d.ts","sourceRoot":"","sources":["../../src/Skiplist.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAGD,eAAO,MAAM,mBAAmB,GAC7B,MAAM,SAAS,MACf,SAAQ,mBAAwB,KAAG,aAWnC,CAAC;AAEJ,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,gBAAgB,KAAG,QA2DvD,CAAC"}

package/dist/src/Skiplist.js

@@ -1,64 +0,0 @@
-/**
- * Skiplist data structure with probabilistic level generation.
- *
- * @module
- */
-import { PositiveInt } from "./Type.js";
-// TODO: Use in Storage.
-export const createSkiplistLevel = (deps) => (config = {}) => {
-    const { probability = 0.5, maxLevel = 32 } = config;
-    return {
-        create: () => {
-            let level = 1;
-            while (deps.random.next() <= probability && level < maxLevel) {
-                level += 1;
-            }
-            return PositiveInt.orThrow(level);
-        },
-    };
-};
-export const createSkiplist = (deps) => {
-    const tail = {
-        key: Number.MAX_VALUE,
-        pointers: [],
-    };
-    const head = {
-        key: Number.MIN_VALUE,
-        pointers: [tail],
-    };
-    // Cached to reuse the array.
-    const path = [];
-    return {
-        insert: (key) => {
-            let cur = head;
-            for (let i = head.pointers.length - 1; i >= 0; i--) {
-                while (cur.pointers[i].key < key) {
-                    cur = cur.pointers[i];
-                }
-                path[i] = cur;
-            }
-            const level = deps.skiplistLevel.create();
-            if (level > head.pointers.length) {
-                const tails = Array(level - head.pointers.length).fill(tail);
-                const heads = Array(level - head.pointers.length).fill(head);
-                head.pointers.push(...tails);
-                path.push(...heads);
-            }
-            const newNode = { key, pointers: [] };
-            for (let i = 0; i < level; i++) {
-                newNode.pointers[i] = path[i].pointers[i];
-                path[i].pointers[i] = newNode;
-            }
-        },
-        find: (key) => {
-            let cur = head;
-            for (let i = head.pointers.length - 1; i >= 0; i--) {
-                while (cur.pointers[i] && cur.pointers[i].key < key) {
-                    cur = cur.pointers[i];
-                }
-            }
-            const candidate = cur.pointers[0];
-            return candidate.key === key ? candidate : null;
-        },
-    };
-};

package/dist/src/Tracer.d.ts

@@ -1,48 +0,0 @@
-/**
- * Minimal tracer interface for observability.
- *
- * @module
- */
-import type { Ref } from "./Ref.js";
-/**
- * Minimal tracer interface for observability.
- *
- * Tracer provides unified observability for both sync and async code. Use it
- * directly for sync operations, or let {@link Run} use it automatically for
- * async tasks.
- *
- * ### Example
- *
- * ```ts
- * // Sync code — use tracer directly
- * const result = deps.tracer?.span("parseData", () => parseData(input));
- *
- * // Async code — Run traces automatically
- * await using run = createRun(deps);
- * const result = await run(fetchUser(id)); // Traced if tracer provided
- * ```
- *
- * TODO: Complete implementation with OpenTelemetry adapter.
- */
-export interface Tracer {
-    /**
-     * Wraps a sync function in a traced span.
-     *
-     * Records start time, end time, and success/failure status.
-     */
-    readonly span: <T>(name: string, fn: () => T) => T;
-    /** Records an event/fact (e.g., "user.purchased", "sync.completed"). */
-    readonly event: (name: string, data?: unknown) => void;
-}
-export interface TracerDep {
-    readonly tracer: Tracer;
-}
-/** Configuration for tracing. */
-export interface TracerConfig {
-    /** When `true`, enables trace data collection. Can be toggled at runtime. */
-    readonly tracing?: Ref<boolean>;
-}
-export interface TracerConfigDep {
-    readonly tracerConfig: TracerConfig;
-}
-//# sourceMappingURL=Tracer.d.ts.map

package/dist/src/Tracer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Tracer.d.ts","sourceRoot":"","sources":["../../src/Tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnD,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC"}

package/dist/src/Tracer.js

@@ -1,6 +0,0 @@
-/**
- * Minimal tracer interface for observability.
- *
- * @module
- */
-export {};

package/src/Skiplist.ts

@@ -1,108 +0,0 @@
-/**
- * Skiplist data structure with probabilistic level generation.
- *
- * @module
- */
-
-import type { RandomDep } from "./Random.js";
-import { PositiveInt } from "./Type.js";
-
-export interface SkiplistLevel {
-  readonly create: () => PositiveInt;
-}
-
-export interface SkiplistLevelDep {
-  readonly skiplistLevel: SkiplistLevel;
-}
-
-export interface SkiplistLevelConfig {
-  readonly probability?: number;
-  readonly maxLevel?: number;
-}
-
-// TODO: Use in Storage.
-export const createSkiplistLevel =
-  (deps: RandomDep) =>
-  (config: SkiplistLevelConfig = {}): SkiplistLevel => {
-    const { probability = 0.5, maxLevel = 32 } = config;
-    return {
-      create: () => {
-        let level = 1;
-        while (deps.random.next() <= probability && level < maxLevel) {
-          level += 1;
-        }
-        return PositiveInt.orThrow(level);
-      },
-    };
-  };
-
-export interface Skiplist {
-  readonly insert: (key: number) => void;
-  readonly find: (key: number) => SkiplistNode | null;
-}
-
-export interface SkiplistNode {
-  readonly key: number;
-  readonly pointers: Array<SkiplistNode>;
-}
-
-export const createSkiplist = (deps: SkiplistLevelDep): Skiplist => {
-  const tail: SkiplistNode = {
-    key: Number.MAX_VALUE,
-    pointers: [],
-  };
-
-  const head: SkiplistNode = {
-    key: Number.MIN_VALUE,
-    pointers: [tail],
-  };
-
-  // Cached to reuse the array.
-  const path: Array<SkiplistNode> = [];
-
-  return {
-    insert: (key) => {
-      let cur = head;
-
-      for (let i = head.pointers.length - 1; i >= 0; i--) {
-        while (cur.pointers[i].key < key) {
-          cur = cur.pointers[i];
-        }
-        path[i] = cur;
-      }
-
-      const level = deps.skiplistLevel.create();
-
-      if (level > head.pointers.length) {
-        const tails = Array<SkiplistNode>(level - head.pointers.length).fill(
-          tail,
-        );
-        const heads = Array<SkiplistNode>(level - head.pointers.length).fill(
-          head,
-        );
-        head.pointers.push(...tails);
-        path.push(...heads);
-      }
-
-      const newNode: SkiplistNode = { key, pointers: [] };
-
-      for (let i = 0; i < level; i++) {
-        newNode.pointers[i] = path[i].pointers[i];
-        path[i].pointers[i] = newNode;
-      }
-    },
-
-    find: (key) => {
-      let cur = head;
-
-      for (let i = head.pointers.length - 1; i >= 0; i--) {
-        while (cur.pointers[i] && cur.pointers[i].key < key) {
-          cur = cur.pointers[i];
-        }
-      }
-
-      const candidate = cur.pointers[0];
-      return candidate.key === key ? candidate : null;
-    },
-  };
-};

package/src/Tracer.ts

@@ -1,54 +0,0 @@
-/**
- * Minimal tracer interface for observability.
- *
- * @module
- */
-
-import type { Ref } from "./Ref.js";
-import type { Run } from "./Task.js";
-
-/**
- * Minimal tracer interface for observability.
- *
- * Tracer provides unified observability for both sync and async code. Use it
- * directly for sync operations, or let {@link Run} use it automatically for
- * async tasks.
- *
- * ### Example
- *
- * ```ts
- * // Sync code — use tracer directly
- * const result = deps.tracer?.span("parseData", () => parseData(input));
- *
- * // Async code — Run traces automatically
- * await using run = createRun(deps);
- * const result = await run(fetchUser(id)); // Traced if tracer provided
- * ```
- *
- * TODO: Complete implementation with OpenTelemetry adapter.
- */
-export interface Tracer {
-  /**
-   * Wraps a sync function in a traced span.
-   *
-   * Records start time, end time, and success/failure status.
-   */
-  readonly span: <T>(name: string, fn: () => T) => T;
-
-  /** Records an event/fact (e.g., "user.purchased", "sync.completed"). */
-  readonly event: (name: string, data?: unknown) => void;
-}
-
-export interface TracerDep {
-  readonly tracer: Tracer;
-}
-
-/** Configuration for tracing. */
-export interface TracerConfig {
-  /** When `true`, enables trace data collection. Can be toggled at runtime. */
-  readonly tracing?: Ref<boolean>;
-}
-
-export interface TracerConfigDep {
-  readonly tracerConfig: TracerConfig;
-}