@livestore/utils 0.4.0 → 0.5.0-dev.1

package/package.json

@@ -1,22 +1,23 @@
 {
-  "name": "@livestore/utils",
-  "version": "0.4.0",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/livestorejs/livestore.git"
+  "$genie": {
+    "source": "package.json.genie.ts",
+    "warning": "DO NOT EDIT - changes will be overwritten",
+    "workspaceClosureDirs": [
+      "packages/@livestore/utils"
+    ]
   },
-  "files": [
-    "dist",
-    "package.json",
-    "src"
-  ],
+  "name": "@livestore/utils",
+  "version": "0.5.0-dev.1",
   "type": "module",
   "sideEffects": [
     "./src/global.ts",
     "./dist/global.js"
   ],
-  "react-native": "./dist/index.js",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/livestorejs/livestore.git"
+  },
   "exports": {
     ".": {
       "types": "./dist/mod.d.ts",
@@ -53,33 +54,25 @@
       "default": "./dist/bun/mod.js"
     }
   },
-  "publishConfig": {
-    "access": "public"
-  },
+  "files": [
+    "dist",
+    "package.json",
+    "src"
+  ],
   "dependencies": {
-    "@effect/platform-node": "0.106.0",
+    "@effect/platform-node": "4.0.3",
     "@standard-schema/spec": "1.1.0",
     "nanoid": "5.0.9",
     "pretty-bytes": "7.0.1",
     "qrcode-generator": "2.0.4"
   },
   "devDependencies": {
-    "@effect/ai": "0.35.0",
-    "@effect/cli": "0.75.1",
-    "@effect/cluster": "0.58.2",
-    "@effect/experimental": "0.60.0",
-    "@effect/opentelemetry": "0.63.0",
-    "@effect/platform": "0.96.1",
-    "@effect/platform-browser": "0.76.0",
-    "@effect/platform-bun": "0.89.0",
-    "@effect/platform-node": "0.106.0",
-    "@effect/printer": "0.49.0",
-    "@effect/printer-ansi": "0.49.0",
-    "@effect/rpc": "0.75.1",
-    "@effect/sql": "0.51.1",
-    "@effect/typeclass": "0.40.0",
-    "@effect/vitest": "0.29.0",
-    "@effect/workflow": "0.18.0",
+    "@effect/opentelemetry": "4.0.3",
+    "@effect/platform-browser": "4.0.3",
+    "@effect/platform-bun": "4.0.3",
+    "@effect/platform-node": "4.0.3",
+    "@effect/platform-node-shared": "4.0.3",
+    "@effect/vitest": "4.0.3",
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/resources": "2.2.0",
     "@standard-schema/spec": "1.1.0",
@@ -87,38 +80,27 @@
     "@types/jsdom": "21.1.7",
     "@types/node": "25.3.3",
     "@types/web": "0.0.264",
-    "effect": "3.21.2",
+    "effect": "4.0.3",
+    "esbuild": "0.28.0",
     "jsdom": "26.1.0",
-    "vitest": "3.2.4"
+    "vitest": "4.1.9"
   },
   "peerDependencies": {
-    "@effect/ai": "^0.35.0",
-    "@effect/cli": "^0.75.1",
-    "@effect/cluster": "^0.58.2",
-    "@effect/experimental": "^0.60.0",
-    "@effect/opentelemetry": "^0.63.0",
-    "@effect/platform": "^0.96.1",
-    "@effect/platform-browser": "^0.76.0",
-    "@effect/platform-bun": "^0.89.0",
-    "@effect/platform-node": "^0.106.0",
-    "@effect/printer": "^0.49.0",
-    "@effect/printer-ansi": "^0.49.0",
-    "@effect/rpc": "^0.75.1",
-    "@effect/sql": "^0.51.1",
-    "@effect/typeclass": "^0.40.0",
-    "@effect/vitest": "^0.29.0",
+    "@effect/opentelemetry": "^4.0.3",
+    "@effect/platform-browser": "^4.0.3",
+    "@effect/platform-bun": "^4.0.3",
+    "@effect/platform-node": "^4.0.3",
+    "@effect/platform-node-shared": "^4.0.3",
+    "@effect/vitest": "^4.0.3",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/resources": "^2.2.0",
     "@standard-schema/spec": "^1.1.0",
-    "effect": "^3.21.2"
+    "effect": "^4.0.3"
   },
-  "$genie": {
-    "source": "package.json.genie.ts",
-    "warning": "DO NOT EDIT - changes will be overwritten",
-    "workspaceClosureDirs": [
-      "packages/@livestore/utils"
-    ]
+  "publishConfig": {
+    "access": "public"
   },
+  "react-native": "./dist/index.js",
   "scripts": {
     "test": "vitest"
   }

package/src/NoopTracer.test.ts

@@ -0,0 +1,36 @@
+import { INVALID_SPAN_CONTEXT, isSpanContextValid, ROOT_CONTEXT } from '@opentelemetry/api'
+import { Effect, FileSystem, type Layer } from 'effect'
+import { describe, expect, it } from 'vitest'
+
+import { NodeFileSystemWithWatch, NodeRecursiveWatchLayer } from '@livestore/utils/node'
+
+import { makeNoopSpan, makeNoopTracer } from './NoopTracer.ts'
+
+describe('NoopTracer', () => {
+  it('returns the canonical invalid OpenTelemetry span context', () => {
+    const spanContext = makeNoopSpan().spanContext()
+
+    expect(spanContext).toBe(INVALID_SPAN_CONTEXT)
+    expect(isSpanContextValid(spanContext)).toBe(false)
+  })
+
+  it('runs active-span callbacks for every tracer overload', () => {
+    const tracer = makeNoopTracer()
+    expect(tracer.startActiveSpan('two arguments', () => 'two')).toBe('two')
+    expect(tracer.startActiveSpan('three arguments', {}, () => 'three')).toBe('three')
+    expect(tracer.startActiveSpan('four arguments', {}, ROOT_CONTEXT, () => 'four')).toBe('four')
+  })
+})
+
+describe('@livestore/utils/node recursive watch compatibility', () => {
+  it('keeps the public layers type-compatible and runnable', async () => {
+    const watchLayer: Layer.Layer<FileSystem.WatchBackend> = NodeRecursiveWatchLayer
+    const fileSystemLayer: Layer.Layer<FileSystem.FileSystem> = NodeFileSystemWithWatch
+
+    const watchBackend = await Effect.runPromise(FileSystem.WatchBackend.pipe(Effect.provide(watchLayer)))
+    const fileSystem = await Effect.runPromise(FileSystem.FileSystem.pipe(Effect.provide(fileSystemLayer)))
+
+    expect(typeof watchBackend.register).toBe('function')
+    expect(typeof fileSystem.watch).toBe('function')
+  })
+})

package/src/NoopTracer.ts

@@ -1,14 +1,7 @@
-/** biome-ignore-all lint/complexity/noArguments: using arguments is fine here */
-
-import type * as otel from '@opentelemetry/api'
-
-import { cuid } from '@livestore/utils/cuid'
+import { INVALID_SPAN_CONTEXT, type Context, type Span, type SpanOptions, type Tracer } from '@opentelemetry/api'
 
 export const makeNoopSpan = () => {
-  const performanceStartTime = performance.now()
-
   const spanImpl = {
-    _performanceStartTime: performanceStartTime,
     setAttribute: () => null,
     setAttributes: () => null,
     addEvent: () => null,
@@ -16,54 +9,38 @@ export const makeNoopSpan = () => {
     setStatus: () => null,
     updateName: () => null,
     recordException: () => null,
-    end: () => {
-      const endTime = performance.now()
-      const duration = endTime - performanceStartTime
-      const durationSecs = duration / 1000
-      const durationRestNs = (duration % 1000) * 1_000_000
-      spanImpl._duration = [durationSecs, durationRestNs] as [number, number]
-    },
-    spanContext: () => {
-      return {
-        traceId: `livestore-noop-trace-id${cuid()}`,
-        spanId: `livestore-noop-span-id${cuid()}`,
-      }
-    },
-    _duration: [0, 0] as [number, number],
+    end: () => null,
+    spanContext: () => INVALID_SPAN_CONTEXT,
   }
 
   // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- noop otel.Span implementation; only implements the subset needed by LiveStore
-  return spanImpl as unknown as otel.Span
+  return spanImpl as unknown as Span
 }
 
 export const makeNoopTracer = () => {
   // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- noop otel.Tracer implementation; only implements the subset needed by LiveStore
-  return new NoopTracer() as unknown as otel.Tracer
+  return new NoopTracer() as unknown as Tracer
 }
 
 export class NoopTracer {
   startSpan = () => makeNoopSpan()
 
-  startActiveSpan<F extends (span: otel.Span) => ReturnType<F>>(name: string, fn: F): ReturnType<F>
-  startActiveSpan<F extends (span: otel.Span) => ReturnType<F>>(
-    name: string,
-    opts: otel.SpanOptions,
-    fn: F,
-  ): ReturnType<F>
-  startActiveSpan<F extends (span: otel.Span) => ReturnType<F>>(
+  startActiveSpan<F extends (span: Span) => ReturnType<F>>(name: string, fn: F): ReturnType<F>
+  startActiveSpan<F extends (span: Span) => ReturnType<F>>(name: string, opts: SpanOptions, fn: F): ReturnType<F>
+  startActiveSpan<F extends (span: Span) => ReturnType<F>>(
     name: string,
-    opts: otel.SpanOptions,
-    ctx: otel.Context,
+    opts: SpanOptions,
+    ctx: Context,
     fn: F,
   ): ReturnType<F>
-  startActiveSpan<F extends (span: otel.Span) => ReturnType<F>>(
+  startActiveSpan<F extends (span: Span) => ReturnType<F>>(
     _name: string,
-    arg2?: F | otel.SpanOptions,
-    arg3?: F | otel.Context,
+    arg2?: F | SpanOptions,
+    arg3?: F | Context,
     arg4?: F,
   ): ReturnType<F> | undefined {
-    let _opts: otel.SpanOptions | undefined
-    let _ctx: otel.Context | undefined
+    let _opts: SpanOptions | undefined
+    let _ctx: Context | undefined
     let fn: F
 
     if (arguments.length < 2) {
@@ -73,14 +50,14 @@ export class NoopTracer {
       fn = arg2 as F
     } else if (arguments.length === 3) {
       // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 3 args, arg2 is SpanOptions
-      _opts = arg2 as otel.SpanOptions | undefined
+      _opts = arg2 as SpanOptions | undefined
       // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 3 args, arg3 is the callback
       fn = arg3 as F
     } else {
       // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg2 is SpanOptions
-      _opts = arg2 as otel.SpanOptions | undefined
+      _opts = arg2 as SpanOptions | undefined
       // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg3 is Context
-      _ctx = arg3 as otel.Context | undefined
+      _ctx = arg3 as Context | undefined
       // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg4 is the callback
       fn = arg4 as F
     }