@livestore/utils 0.4.0-dev.9 → 0.5.0-dev.0

package/dist/qr.js

@@ -0,0 +1,109 @@
+import qrcode from 'qrcode-generator';
+export { default as QR } from 'qrcode-generator';
+/**
+ * Print a QR code to the terminal using Unicode block characters.
+ *
+ * Notes
+ * - Uses `qrcode-generator` under the hood. `typeNumber` is set to `0` which means
+ *   “auto-select the smallest QR version (1..40) that fits the data”. Larger versions
+ *   create larger matrices (each version adds 4 modules per side). See the library:
+ *   - Types (TypeNumber, ErrorCorrectionLevel):
+ *     https://unpkg.com/qrcode-generator@2.0.4/dist/qrcode.d.ts
+ *   - Repository / README:
+ *     https://github.com/kazuhikoarase/qrcode-generator
+ * - Error correction level (ECL) controls how much damage/occlusion can be
+ *   tolerated by adding redundancy. Higher ECL means bigger codes and lower
+ *   payload capacity:
+ *   - L ≈ 7% recovery (highest capacity, lowest redundancy)
+ *   - M ≈ 15% recovery (balanced, common default)
+ *   - Q ≈ 25% recovery (more robust in noisy/low-contrast prints)
+ *   - H ≈ 30% recovery (most robust; largest symbols)
+ *   Reference: https://www.qrcode.com/en/about/error_correction.html
+ * - `small` mode compresses two QR rows into one terminal row using the half-block
+ *   character `▀` and optional ANSI colors (foreground=top, background=bottom).
+ *   This roughly halves the height while keeping readability in modern terminals.
+ * - The QR “quiet zone” (margin) is important for scanners. If scanning is unreliable,
+ *   consider increasing `margin` to 2–4.
+ */
+export const printQrTerminal = (text, options) => {
+    const ec = options?.errorCorrectionLevel ?? 'M';
+    const margin = options?.margin ?? 2;
+    const invert = options?.invert ?? false;
+    // Auto-enable ANSI on TTY; avoid in browsers
+    const useAnsi = options?.useAnsi ?? (typeof process !== 'undefined' && !!process?.stdout?.isTTY);
+    // Create the QR code. `0` means: choose the smallest possible version automatically.
+    // Error correction level (L/M/Q/H) trades capacity for redundancy.
+    const qr = qrcode(0, ec);
+    qr.addData(text);
+    qr.make();
+    const size = qr.getModuleCount();
+    // Helper: read a module, applying margin and optional inversion.
+    // qrcode-generator’s `isDark` signature is (row, col) i.e. (y, x).
+    const isDarkAt = (x, y) => {
+        const row = y - margin;
+        const col = x - margin;
+        if (row < 0 || col < 0 || row >= size || col >= size)
+            return false;
+        const bit = qr.isDark(row, col);
+        return invert === true ? !bit : bit;
+    };
+    const lines = [];
+    // Compact rendering: combine two QR rows into one terminal row using half-blocks.
+    // With ANSI enabled: use `▀` and paint top as FG, bottom as BG (clear and crisp).
+    // Without ANSI: fall back to block chars (`█`, `▀`, `▄`, space). Note that the
+    // non-ANSI fallback cannot enforce a white background on dark themes, which may
+    // reduce scanner reliability—prefer ANSI when possible.
+    const width = size + 2 * margin;
+    const height = size + 2 * margin;
+    // ANSI helpers (only used when enabled)
+    // Use bright white for a strong “paper-like” background on dark terminals.
+    const RESET = '\x1b[0m';
+    const FG_BLACK = '\x1b[30m';
+    const FG_WHITE = '\x1b[97m';
+    const BG_BLACK = '\x1b[40m';
+    const BG_WHITE = '\x1b[107m';
+    for (let y = 0; y < height; y += 2) {
+        let row = '';
+        let currentStyle = '';
+        const setStyle = (style) => {
+            if (style !== currentStyle) {
+                if (currentStyle !== undefined)
+                    row += RESET;
+                if (style !== undefined)
+                    row += style;
+                currentStyle = style;
+            }
+        };
+        for (let x = 0; x < width; x++) {
+            const top = isDarkAt(x, y);
+            const bottom = isDarkAt(x, y + 1);
+            if (useAnsi === true) {
+                // Represent two stacked modules with a single `▀` character.
+                // Foreground corresponds to the top pixel; background to the bottom pixel.
+                // Always paint both halves to enforce a white quiet zone even on dark terminals.
+                const fg = top === true ? FG_BLACK : FG_WHITE;
+                const bg = bottom === true ? BG_BLACK : BG_WHITE;
+                setStyle(fg + bg);
+                row += '▀';
+            }
+            else {
+                // No ANSI: approximate using block characters.
+                let ch = ' ';
+                if (top === true && bottom === true)
+                    ch = '█';
+                else if (top === true && bottom === false)
+                    ch = '▀';
+                else if (top === false && bottom === true)
+                    ch = '▄';
+                row += ch;
+            }
+        }
+        if (useAnsi === true) {
+            if (currentStyle !== undefined)
+                row += RESET;
+        }
+        lines.push(row);
+    }
+    console.log(lines.join('\n'));
+};
+//# sourceMappingURL=qr.js.map

package/dist/qr.js.map

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

package/dist/set.js

@@ -1,7 +1,7 @@
 export const difference = (a, b) => {
     const diff = new Set();
     for (const item of a) {
-        if (!b.has(item)) {
+        if (b.has(item) === false) {
             diff.add(item);
         }
     }

package/dist/set.js.map

@@ -1 +1 @@
-{"version":3,"file":"set.js","sourceRoot":"","sources":["../src/set.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,CAAS,EAAE,CAAS,EAAE,EAAE;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../src/set.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,CAAS,EAAE,CAAS,EAAE,EAAE;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/string.d.ts

@@ -1,5 +1,3 @@
-export declare const lowercaseFirstChar: (str: string) => string;
-export declare const uppercaseFirstChar: (str: string) => string;
 /** Indents a string each line by `n` characters (default: spaces) */
 export declare const indent: (str: string, n: number, char?: string) => string;
 //# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,WAA+C,CAAA;AAC7F,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,WAA+C,CAAA;AAE7F,qEAAqE;AACrE,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,GAAG,MAAM,EAAE,aAAU,KAAG,MAI7C,CAAA"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,GAAG,MAAM,EAAE,aAAU,KAAG,MAI7C,CAAA"}

package/dist/string.js

@@ -1,5 +1,3 @@
-export const lowercaseFirstChar = (str) => str.charAt(0).toLowerCase() + str.slice(1);
-export const uppercaseFirstChar = (str) => str.charAt(0).toUpperCase() + str.slice(1);
 /** Indents a string each line by `n` characters (default: spaces) */
 export const indent = (str, n, char = ' ') => str
     .split('\n')

package/dist/string.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAE7F,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,CAAS,EAAE,IAAI,GAAG,GAAG,EAAU,EAAE,CACnE,GAAG;KACA,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KACpC,IAAI,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,CAAS,EAAE,IAAI,GAAG,GAAG,EAAU,EAAE,CACnE,GAAG;KACA,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KACpC,IAAI,CAAC,IAAI,CAAC,CAAA"}

package/package.json

@@ -1,16 +1,31 @@
 {
   "name": "@livestore/utils",
-  "version": "0.4.0-dev.9",
+  "version": "0.5.0-dev.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/livestorejs/livestore.git"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "src"
+  ],
   "type": "module",
   "sideEffects": [
     "./src/global.ts",
     "./dist/global.js"
   ],
+  "react-native": "./dist/index.js",
   "exports": {
     ".": {
       "types": "./dist/mod.d.ts",
       "default": "./dist/mod.js"
     },
+    "./browser": {
+      "types": "./dist/browser/mod.d.ts",
+      "default": "./dist/browser/mod.js"
+    },
     "./cuid": {
       "types": "./dist/cuid/cuid.node.d.ts",
       "browser": "./dist/cuid/cuid.browser.js",
@@ -22,8 +37,12 @@
       "default": "./dist/nanoid/index.js"
     },
     "./effect": {
-      "types": "./dist/effect/index.d.ts",
-      "default": "./dist/effect/index.js"
+      "types": "./dist/effect/mod.d.ts",
+      "default": "./dist/effect/mod.js"
+    },
+    "./effect/browser": {
+      "types": "./dist/browser/mod.d.ts",
+      "default": "./dist/browser/mod.js"
     },
     "./node": {
       "types": "./dist/node/mod.d.ts",
@@ -34,67 +53,54 @@
       "default": "./dist/bun/mod.js"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
-    "@standard-schema/spec": "1.0.0",
-    "nanoid": "5.1.5",
-    "pretty-bytes": "7.0.1"
+    "@effect/platform-node": "4.0.0-rc.111",
+    "@standard-schema/spec": "1.1.0",
+    "nanoid": "5.0.9",
+    "pretty-bytes": "7.0.1",
+    "qrcode-generator": "2.0.4"
   },
   "devDependencies": {
-    "@effect/ai": "^0.28.0",
-    "@effect/cli": "^0.70.0",
-    "@effect/cluster": "^0.49.0",
-    "@effect/experimental": "^0.55.0",
-    "@effect/opentelemetry": "0.57.0",
-    "@effect/platform": "^0.91.1",
-    "@effect/platform-browser": "^0.71.0",
-    "@effect/platform-bun": "^0.80.0",
-    "@effect/platform-node": "^0.97.0",
-    "@effect/printer": "^0.45.0",
-    "@effect/printer-ansi": "^0.45.0",
-    "@effect/rpc": "^0.70.0",
-    "@effect/sql": "^0.45.0",
-    "@effect/typeclass": "^0.36.0",
-    "@effect/vitest": "^0.25.1",
-    "@effect/workflow": "^0.10.0",
+    "@effect/opentelemetry": "4.0.0-rc.111",
+    "@effect/platform-browser": "4.0.0-rc.111",
+    "@effect/platform-bun": "4.0.0-rc.111",
+    "@effect/platform-node": "4.0.0-rc.111",
+    "@effect/platform-node-shared": "4.0.0-rc.111",
+    "@effect/vitest": "4.0.0-rc.111",
     "@opentelemetry/api": "1.9.0",
-    "@opentelemetry/resources": "^2.0.1",
-    "@types/bun": "^1.2.21",
-    "@types/jsdom": "^21.1.7",
-    "@types/node": "24.5.2",
-    "@types/web": "^0.0.264",
-    "effect": "3.17.14",
-    "jsdom": "^26.1.0",
-    "vitest": "3.2.4"
+    "@opentelemetry/resources": "2.2.0",
+    "@standard-schema/spec": "1.1.0",
+    "@types/bun": "1.3.10",
+    "@types/jsdom": "21.1.7",
+    "@types/node": "25.3.3",
+    "@types/web": "0.0.264",
+    "effect": "4.0.0-rc.111",
+    "esbuild": "0.28.0",
+    "jsdom": "26.1.0",
+    "vitest": "4.1.9"
   },
-  "files": [
-    "package.json",
-    "src",
-    "dist"
-  ],
-  "license": "Apache-2.0",
   "peerDependencies": {
-    "@effect/ai": "^0.28.0",
-    "@effect/cli": "^0.70.0",
-    "@effect/cluster": "^0.49.0",
-    "@effect/experimental": "^0.55.0",
-    "@effect/opentelemetry": "^0.57.0",
-    "@effect/platform": "^0.91.1",
-    "@effect/platform-browser": "^0.71.0",
-    "@effect/platform-bun": "^0.80.0",
-    "@effect/platform-node": "^0.97.0",
-    "@effect/printer": "^0.45.0",
-    "@effect/printer-ansi": "^0.45.0",
-    "@effect/rpc": "^0.70.0",
-    "@effect/sql": "^0.45.0",
-    "@effect/typeclass": "^0.36.0",
+    "@effect/opentelemetry": "^4.0.0-rc.111",
+    "@effect/platform-browser": "^4.0.0-rc.111",
+    "@effect/platform-bun": "^4.0.0-rc.111",
+    "@effect/platform-node": "^4.0.0-rc.111",
+    "@effect/platform-node-shared": "^4.0.0-rc.111",
+    "@effect/vitest": "^4.0.0-rc.111",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/resources": "^2.0.1",
-    "effect": "^3.17.14"
+    "@opentelemetry/resources": "^2.2.0",
+    "@standard-schema/spec": "^1.1.0",
+    "effect": "^4.0.0-rc.111"
   },
-  "publishConfig": {
-    "access": "public"
+  "$genie": {
+    "source": "package.json.genie.ts",
+    "warning": "DO NOT EDIT - changes will be overwritten",
+    "workspaceClosureDirs": [
+      "packages/@livestore/utils"
+    ]
   },
-  "react-native": "./dist/index.js",
   "scripts": {
     "test": "vitest"
   }

package/src/NoopTracer.test.ts

@@ -0,0 +1,20 @@
+import { INVALID_SPAN_CONTEXT, isSpanContextValid, ROOT_CONTEXT } from '@opentelemetry/api'
+import { describe, expect, it } from 'vitest'
+
+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')
+  })
+})

package/src/NoopTracer.ts

@@ -1,11 +1,7 @@
-/** biome-ignore-all lint/complexity/noArguments: using arguments is fine here */
-import type * as otel from '@opentelemetry/api'
+import { INVALID_SPAN_CONTEXT, type Context, type Span, type SpanOptions, type Tracer } from '@opentelemetry/api'
 
 export const makeNoopSpan = () => {
-  const performanceStartTime: DOMHighResTimeStamp = performance.now()
-
-  const span = {
-    _performanceStartTime: performanceStartTime,
+  const spanImpl = {
     setAttribute: () => null,
     setAttributes: () => null,
     addEvent: () => null,
@@ -13,61 +9,56 @@ export const makeNoopSpan = () => {
     setStatus: () => null,
     updateName: () => null,
     recordException: () => null,
-    end: () => {
-      const endTime: DOMHighResTimeStamp = performance.now()
-      const duration = endTime - performanceStartTime
-      const durationSecs = duration / 1000
-      const durationRestNs = (duration % 1000) * 1_000_000
-      ;(span as any)._duration = [durationSecs, durationRestNs]
-    },
-    spanContext: () => {
-      return { traceId: 'livestore-noop-trace-id', spanId: 'livestore-noop-span-id' }
-    },
-    _duration: [0, 0],
-  } as unknown as otel.Span
+    end: () => null,
+    spanContext: () => INVALID_SPAN_CONTEXT,
+  }
 
-  return span
+  // 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 Span
 }
 
 export const makeNoopTracer = () => {
-  return new NoopTracer() as unknown as otel.Tracer
+  // 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 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) {
       return
     } else if (arguments.length === 2) {
+      // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 2 args, arg2 is the callback
       fn = arg2 as F
     } else if (arguments.length === 3) {
-      _opts = arg2 as otel.SpanOptions | undefined
+      // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 3 args, arg2 is SpanOptions
+      _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 {
-      _opts = arg2 as otel.SpanOptions | undefined
-      _ctx = arg3 as otel.Context | undefined
+      // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg2 is SpanOptions
+      _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 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
     }
 

package/src/binary.ts

@@ -35,7 +35,7 @@ export const isUint8ArrayBuffer = (array: Uint8Array): array is Uint8Array<Array
  * Safer alternative to type assertions.
  */
 export const toUint8ArrayBuffer = (array: Uint8Array): Uint8Array<ArrayBuffer> => {
-  if (isUint8ArrayBuffer(array)) {
+  if (isUint8ArrayBuffer(array) === true) {
     return array
   }
   // Copy to ensure ArrayBuffer backing