@livestore/utils 0.4.0-dev.9 → 0.4.0

package/dist/effect/spanEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanEvent.d.ts","sourceRoot":"","sources":["../../src/effect/spanEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA6B,MAAM,QAAQ,CAAA;AAE1D;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,GAAG,EAAE,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,sCAGzE,CAAA"}

package/dist/effect/spanEvent.js

@@ -0,0 +1,12 @@
+import { Effect, FiberRef, HashSet, Logger } from 'effect';
+/**
+ * Emits a span event on the current Effect span via the tracer logger.
+ *
+ * @remarks
+ *
+ * Unlike raw `otelSpan.addEvent`, this doesn't require manual span threading —
+ * it automatically targets the nearest enclosing `Effect.withSpan`. If no span
+ * is in context, the call is a no-op.
+ */
+export const spanEvent = (message, attributes) => Effect.locallyWith(Effect.log(message).pipe(Effect.annotateLogs(attributes ?? {})), FiberRef.currentLoggers, () => HashSet.make(Logger.tracerLogger));
+//# sourceMappingURL=spanEvent.js.map

package/dist/effect/spanEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanEvent.js","sourceRoot":"","sources":["../../src/effect/spanEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE1D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAY,EAAE,UAAoC,EAAE,EAAE,CAC9E,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,CAChH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAClC,CAAA"}

package/dist/effect/spanEvent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spanEvent.test.d.ts.map

package/dist/effect/spanEvent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanEvent.test.d.ts","sourceRoot":"","sources":["../../src/effect/spanEvent.test.ts"],"names":[],"mappings":""}

package/dist/effect/spanEvent.test.js

@@ -0,0 +1,82 @@
+import { it, describe, expect } from '@effect/vitest';
+import { Effect, Tracer } from 'effect';
+import { spanEvent } from "./spanEvent.js";
+/**
+ * Creates a test tracer that captures span events for assertion,
+ * using only the public `Tracer` API (no internal NativeSpan access).
+ * Each span records its own events, retrievable by span name.
+ */
+const makeTestTracer = () => {
+    const spanEvents = new Map();
+    const tracer = Tracer.make({
+        span(name, parent, context, links, startTime, kind) {
+            const events = [];
+            spanEvents.set(name, events);
+            const attributes = new Map();
+            return {
+                _tag: 'Span',
+                name,
+                spanId: `test-${name}`,
+                traceId: 'test-trace',
+                parent,
+                context,
+                status: { _tag: 'Started', startTime },
+                attributes,
+                links: [...links],
+                sampled: true,
+                kind,
+                end() { },
+                attribute(key, value) {
+                    attributes.set(key, value);
+                },
+                event(eventName, _startTime, attrs) {
+                    events.push({ name: eventName, attributes: attrs });
+                },
+                addLinks() { },
+            };
+        },
+        context(f) {
+            return f();
+        },
+    });
+    return {
+        tracer,
+        getEvents: (spanName) => spanEvents.get(spanName) ?? [],
+    };
+};
+describe('spanEvent', () => {
+    it.effect('should emit a span event with the given message', () => {
+        const { tracer, getEvents } = makeTestTracer();
+        return Effect.gen(function* () {
+            yield* spanEvent('test-event');
+            const events = getEvents('test-span');
+            expect(events).toHaveLength(1);
+            expect(events[0].name).toBe('test-event');
+        }).pipe(Effect.withSpan('test-span'), Effect.withTracer(tracer));
+    });
+    it.effect('should emit a span event with attributes', () => {
+        const { tracer, getEvents } = makeTestTracer();
+        return Effect.gen(function* () {
+            yield* spanEvent('event-with-attrs', { key1: 'value1', key2: 42 });
+            const events = getEvents('test-span');
+            expect(events).toHaveLength(1);
+            expect(events[0].name).toBe('event-with-attrs');
+            expect(events[0].attributes).toMatchObject({ key1: 'value1', key2: 42 });
+        }).pipe(Effect.withSpan('test-span'), Effect.withTracer(tracer));
+    });
+    it.effect('should emit to the nearest enclosing span', () => {
+        const { tracer, getEvents } = makeTestTracer();
+        return Effect.gen(function* () {
+            yield* spanEvent('outer-event');
+            yield* spanEvent('inner-event').pipe(Effect.withSpan('inner-span'));
+            const outerEvents = getEvents('outer-span');
+            const innerEvents = getEvents('inner-span');
+            expect(outerEvents).toHaveLength(1);
+            expect(outerEvents[0].name).toBe('outer-event');
+            expect(innerEvents).toHaveLength(1);
+            expect(innerEvents[0].name).toBe('inner-event');
+        }).pipe(Effect.withSpan('outer-span'), Effect.withTracer(tracer));
+    });
+    it.effect('should be a no-op when no span is in context', () => spanEvent('orphan-event'));
+});
+//# sourceMappingURL=spanEvent.test.js.map

package/dist/effect/spanEvent.test.js.map

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

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAY3C,CAAA;AAGD,eAAO,MAAM,aAAa,SAAsF,CAAA;AAEhH,iDAAiD;AACjD,eAAO,MAAM,MAAM,SAA4D,CAAA;AAE/E,eAAO,MAAM,KAAK,SAAuB,CAAA;AAEzC,eAAO,MAAM,MAAM,SAA6B,CAAA;AAEhD,eAAO,MAAM,eAAe,SAA0E,CAAA"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAY3C,CAAA;AAGD,eAAO,MAAM,aAAa,SAAsF,CAAA;AAEhH,iDAAiD;AACjD,eAAO,MAAM,MAAM,SAA4D,CAAA;AAE/E,eAAO,MAAM,KAAK,SAAuB,CAAA;AAEzC,eAAO,MAAM,MAAM,SAA6B,CAAA;AAEhD,eAAO,MAAM,eAAe,SACwF,CAAA"}

package/dist/env.js

@@ -17,5 +17,5 @@ export const TRACE_VERBOSE = env('LS_TRACE_VERBOSE') !== undefined || env('VITE_
 export const LS_DEV = envTruish(env('LS_DEV')) || envTruish(env('VITE_LS_DEV'));
 export const IS_CI = envTruish(env('CI'));
 export const IS_BUN = typeof Bun !== 'undefined';
-export const IS_REACT_NATIVE = typeof navigator !== 'undefined' && navigator.product === 'ReactNative';
+export const IS_REACT_NATIVE = typeof navigator !== 'undefined' && navigator['product'] === 'ReactNative';
 //# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE;IACtD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,kBAAkB,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,uBAAuB,CAAC,KAAK,SAAS,CAAA;AAEhH,iDAAiD;AACjD,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAA;AAE/E,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,WAAW,CAAA;AAEhD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,OAAO,KAAK,aAAa,CAAA"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE;IACtD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC,kBAAkB,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,uBAAuB,CAAC,KAAK,SAAS,CAAA;AAEhH,iDAAiD;AACjD,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAA;AAE/E,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,WAAW,CAAA;AAEhD,MAAM,CAAC,MAAM,eAAe,GAC1B,OAAO,SAAS,KAAK,WAAW,IAAK,SAAgD,CAAC,SAAS,CAAC,KAAK,aAAa,CAAA"}

package/dist/fast-deep-equal.js

@@ -3,20 +3,20 @@
 export const deepEqual = (a, b) => {
     if (a === b)
         return true;
-    if (a && b && typeof a === 'object' && typeof b === 'object') {
+    if (a != null && b != null && typeof a === 'object' && typeof b === 'object') {
         if (a.constructor !== b.constructor)
             return false;
         let length;
         let i;
         let keys;
-        if (Array.isArray(a)) {
+        if (Array.isArray(a) === true) {
             length = a.length;
             // @ts-expect-error ...
             if (length !== b.length)
                 return false;
             for (i = length; i-- !== 0;)
                 // @ts-expect-error ...
-                if (!deepEqual(a[i], b[i]))
+                if (deepEqual(a[i], b[i]) === false)
                     return false;
             return true;
         }
@@ -24,10 +24,10 @@ export const deepEqual = (a, b) => {
             if (a.size !== b.size)
                 return false;
             for (i of a.entries())
-                if (!b.has(i[0]))
+                if (b.has(i[0]) === false)
                     return false;
             for (i of a.entries())
-                if (!deepEqual(i[1], b.get(i[0])))
+                if (deepEqual(i[1], b.get(i[0])) === false)
                     return false;
             return true;
         }
@@ -35,11 +35,11 @@ export const deepEqual = (a, b) => {
             if (a.size !== b.size)
                 return false;
             for (i of a.entries())
-                if (!b.has(i[0]))
+                if (b.has(i[0]) === false)
                     return false;
             return true;
         }
-        if (ArrayBuffer.isView(a) && ArrayBuffer.isView(b)) {
+        if (ArrayBuffer.isView(a) === true && ArrayBuffer.isView(b) === true) {
             // @ts-expect-error ...
             length = a.length;
             // @ts-expect-error ...
@@ -63,12 +63,12 @@ export const deepEqual = (a, b) => {
         if (length !== Object.keys(b).length)
             return false;
         for (i = length; i-- !== 0;)
-            if (!Object.hasOwn(b, keys[i]))
+            if (Object.prototype.hasOwnProperty.call(b, keys[i]) === false)
                 return false;
         for (i = length; i-- !== 0;) {
             const key = keys[i];
             // @ts-expect-error ...
-            if (!deepEqual(a[key], b[key]))
+            if (deepEqual(a[key], b[key]) === false)
                 return false;
         }
         return true;

package/dist/fast-deep-equal.js.map

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

package/dist/global.d.ts

@@ -1,6 +1,9 @@
 declare global {
     export type TODO<_Reason extends string = 'unknown'> = any;
     export type UNUSED<_Reason extends string = 'unknown'> = any;
+    interface ImportMeta {
+        main: boolean;
+    }
 }
 export {};
 //# sourceMappingURL=global.d.ts.map

package/dist/global.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,SAAS,IAAI,GAAG,CAAA;IAC1D,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,MAAM,GAAG,SAAS,IAAI,GAAG,CAAA;CAC7D;AAED,OAAO,EAAE,CAAA"}
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,MAAM,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,SAAS,IAAI,GAAG,CAAA;IAC1D,MAAM,MAAM,MAAM,CAAC,OAAO,SAAS,MAAM,GAAG,SAAS,IAAI,GAAG,CAAA;IAE5D,UAAU,UAAU;QAClB,IAAI,EAAE,OAAO,CAAA;KACd;CACF"}

package/dist/global.js.map

@@ -1 +1 @@
-{"version":3,"file":"global.js","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":""}

package/dist/guards.d.ts

@@ -1,6 +1,20 @@
+/** Type guard that narrows `T | undefined` to `T`. Useful for filtering arrays. */
 export declare const isNotUndefined: <T>(_: T | undefined) => _ is T;
+/** Type guard that narrows `T | null` to `T`. */
 export declare const isNotNull: <T>(_: T | null) => _ is T;
+/** Type guard that checks if a value is `undefined`. */
 export declare const isUndefined: <T>(_: T | undefined) => _ is undefined;
+/** Type guard that checks if a value is `null` or `undefined`. */
 export declare const isNil: (val: any) => val is null | undefined;
+/**
+ * Type guard that narrows `T | undefined | null` to `T`.
+ * Commonly used to filter out nullish values from arrays.
+ *
+ * @example
+ * ```ts
+ * const values = [1, null, 2, undefined, 3]
+ * const nonNil = values.filter(isNotNil) // [1, 2, 3] (type: number[])
+ * ```
+ */
 export declare const isNotNil: <T>(val: T | undefined | null) => val is T;
 //# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,KAAG,CAAC,IAAI,CAAoB,CAAA;AAE9E,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,KAAG,CAAC,IAAI,CAAe,CAAA;AAC/D,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,KAAG,CAAC,IAAI,SAA4B,CAAA;AAEnF,eAAO,MAAM,KAAK,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,IAAI,GAAG,SAA8C,CAAA;AAE7F,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,KAAG,GAAG,IAAI,CAAsC,CAAA"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,KAAG,CAAC,IAAI,CAAoB,CAAA;AAE9E,iDAAiD;AACjD,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,KAAG,CAAC,IAAI,CAAe,CAAA;AAE/D,wDAAwD;AACxD,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,KAAG,CAAC,IAAI,SAA4B,CAAA;AAEnF,kEAAkE;AAClE,eAAO,MAAM,KAAK,GAAI,KAAK,GAAG,KAAG,GAAG,IAAI,IAAI,GAAG,SAA8C,CAAA;AAE7F;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,KAAG,GAAG,IAAI,CAAsC,CAAA"}

package/dist/guards.js

@@ -1,6 +1,20 @@
+/** Type guard that narrows `T | undefined` to `T`. Useful for filtering arrays. */
 export const isNotUndefined = (_) => _ !== undefined;
+/** Type guard that narrows `T | null` to `T`. */
 export const isNotNull = (_) => _ !== null;
+/** Type guard that checks if a value is `undefined`. */
 export const isUndefined = (_) => _ === undefined;
+/** Type guard that checks if a value is `null` or `undefined`. */
 export const isNil = (val) => val === null || val === undefined;
+/**
+ * Type guard that narrows `T | undefined | null` to `T`.
+ * Commonly used to filter out nullish values from arrays.
+ *
+ * @example
+ * ```ts
+ * const values = [1, null, 2, undefined, 3]
+ * const nonNil = values.filter(isNotNil) // [1, 2, 3] (type: number[])
+ * ```
+ */
 export const isNotNil = (val) => val !== null && val !== undefined;
 //# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,CAAgB,EAAU,EAAE,CAAC,CAAC,KAAK,SAAS,CAAA;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,CAAW,EAAU,EAAE,CAAC,CAAC,KAAK,IAAI,CAAA;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,CAAgB,EAAkB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAA;AAEnF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAQ,EAA2B,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAA;AAE7F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,GAAyB,EAAY,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAA"}
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,CAAgB,EAAU,EAAE,CAAC,CAAC,KAAK,SAAS,CAAA;AAE9E,iDAAiD;AACjD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAI,CAAW,EAAU,EAAE,CAAC,CAAC,KAAK,IAAI,CAAA;AAE/D,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,CAAgB,EAAkB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAA;AAEnF,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAQ,EAA2B,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAA;AAE7F;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,GAAyB,EAAY,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAA"}

package/dist/misc.d.ts

@@ -2,5 +2,13 @@ export declare const isDevEnv: () => string | boolean | undefined;
 export declare const objectToString: (error: any) => string;
 export declare const tryAsFunctionAndNew: <TArg, TResult>(fnOrConstructor: ((arg: TArg) => TResult) | (new (arg: TArg) => TResult), arg: TArg) => TResult;
 export declare const envTruish: (env: string | undefined) => boolean;
-export declare const shouldNeverHappen: (msg?: string, ...args: any[]) => never;
+/**
+ * Logs and throws for impossible states, pausing at a breakpoint in development.
+ *
+ * @param msg - The error message to log and pass to the error.
+ * @param args - Arbitrary arguments to include in the log.
+ *
+ * @see {@link dieDebugger} for the Effect equivalent.
+ */
+export declare const shouldNeverHappen: (msg?: string, ...args: ReadonlyArray<unknown>) => never;
 //# sourceMappingURL=misc.d.ts.map

package/dist/misc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,oCAiBpB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,MAW3C,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,IAAI,EAAE,OAAO,EAC/C,iBAAiB,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,EACxE,KAAK,IAAI,KACR,OAQF,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,GAAG,SAAS,YACgC,CAAA;AAEjF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,KAAG,KAQhE,CAAA"}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,oCAiBpB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,MAW3C,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,IAAI,EAAE,OAAO,EAC/C,iBAAiB,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,EACxE,KAAK,IAAI,KACR,OAQF,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,GAAG,SAAS,YACgC,CAAA;AAEjF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAG,KAQjF,CAAA"}

package/dist/misc.js

@@ -8,7 +8,7 @@ export const isDevEnv = () => {
         return import.meta.env.DEV;
     }
     // @ts-expect-error Only exists in Expo / RN
-    if (globalThis?.__DEV__) {
+    if (globalThis?.__DEV__ === true) {
         return true;
     }
     return false;
@@ -36,10 +36,18 @@ export const tryAsFunctionAndNew = (fnOrConstructor, arg) => {
     }
 };
 export const envTruish = (env) => env !== undefined && env.toLowerCase() !== 'false' && env.toLowerCase() !== '0';
+/**
+ * Logs and throws for impossible states, pausing at a breakpoint in development.
+ *
+ * @param msg - The error message to log and pass to the error.
+ * @param args - Arbitrary arguments to include in the log.
+ *
+ * @see {@link dieDebugger} for the Effect equivalent.
+ */
 export const shouldNeverHappen = (msg, ...args) => {
     console.error(msg, ...args);
-    if (isDevEnv()) {
-        // biome-ignore lint/suspicious/noDebugger: debugging
+    if (isDevEnv() === true) {
+        // oxlint-disable-next-line eslint(no-debugger) -- intentional breakpoint during development
         debugger;
     }
     throw new Error(`This should never happen: ${msg}`);

package/dist/misc.js.map

@@ -1 +1 @@
-{"version":3,"file":"misc.js","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;IAC9C,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IAC5B,CAAC;IAED,4CAA4C;IAC5C,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAU,EAAU,EAAE;IACnD,MAAM,GAAG,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC7B,IAAI,GAAG,KAAK,iBAAiB;QAAE,OAAO,GAAG,CAAA;IAEzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACvC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAElB,OAAO,+BAA+B,CAAC,EAAE,CAAA;IAC3C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,eAAwE,EACxE,GAAS,EACA,EAAE;IACX,IAAI,CAAC;QACH,0CAA0C;QAC1C,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,uCAAuC;QACvC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAuB,EAAE,EAAE,CACnD,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,GAAG,CAAA;AAEjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAY,EAAE,GAAG,IAAW,EAAS,EAAE;IACvE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IAC3B,IAAI,QAAQ,EAAE,EAAE,CAAC;QACf,qDAAqD;QACrD,QAAQ,CAAA;IACV,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAA;AACrD,CAAC,CAAA"}
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../src/misc.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;IAC9C,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IAC5B,CAAC;IAED,4CAA4C;IAC5C,IAAI,UAAU,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAU,EAAU,EAAE;IACnD,MAAM,GAAG,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAA;IAC7B,IAAI,GAAG,KAAK,iBAAiB;QAAE,OAAO,GAAG,CAAA;IAEzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACvC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAElB,OAAO,+BAA+B,CAAC,EAAE,CAAA;IAC3C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,eAAwE,EACxE,GAAS,EACA,EAAE;IACX,IAAI,CAAC;QACH,0CAA0C;QAC1C,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,uCAAuC;QACvC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAuB,EAAE,EAAE,CACnD,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,GAAG,CAAA;AAEjF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAY,EAAE,GAAG,IAA4B,EAAS,EAAE;IACxF,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IAC3B,IAAI,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;QACxB,4FAA4F;QAC5F,QAAQ,CAAA;IACV,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAA;AACrD,CAAC,CAAA"}

package/dist/mod.d.ts

@@ -1,7 +1,6 @@
 export { default as prettyBytes } from 'pretty-bytes';
 export * as base64 from './base64.ts';
 export * from './binary.ts';
-export * from './browser.ts';
 export * from './Deferred.ts';
 export * from './env.ts';
 export * from './fast-deep-equal.ts';
@@ -10,76 +9,269 @@ export * from './misc.ts';
 export * from './NoopTracer.ts';
 export * from './object/index.ts';
 export * from './promise.ts';
+export * as QR from './qr.ts';
 export * from './set.ts';
 export * from './string.ts';
 export * from './time.ts';
 import type * as otel from '@opentelemetry/api';
 import type { Types } from 'effect';
+/**
+ * Recursively expands type aliases for better IDE hover display.
+ *
+ * Transforms `{ a: string } & { b: number }` into `{ a: string; b: number }`.
+ */
 export type Prettify<T> = T extends infer U ? {
     [K in keyof U]: Prettify<U[K]>;
 } : never;
+/**
+ * Type-level equality check. Returns `true` if `A` and `B` are exactly the same type.
+ *
+ * @example
+ * ```ts
+ * type Test1 = TypeEq<string, string> // true
+ * type Test2 = TypeEq<string, number> // false
+ * type Test3 = TypeEq<{ a: 1 }, { a: 1 }> // true
+ * ```
+ */
 export type TypeEq<A, B> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;
-/** `A` is subtype of `B` */
+/**
+ * Type-level subtype check. Returns `true` if `A` extends `B`.
+ *
+ * @example
+ * ```ts
+ * type Test1 = IsSubtype<'foo', string> // true
+ * type Test2 = IsSubtype<string, 'foo'> // false
+ * ```
+ */
 export type IsSubtype<A, B> = A extends B ? true : false;
+/** Compile-time assertion that `T` is `true`. Useful for type tests. */
 export type AssertTrue<T extends true> = T;
+/** Removes `readonly` modifier from all properties of `T`. */
 export type Writeable<T> = {
     -readonly [P in keyof T]: T[P];
 };
+/** Recursively removes `readonly` modifier from all properties. */
 export type DeepWriteable<T> = {
     -readonly [P in keyof T]: DeepWriteable<T[P]>;
 };
+/** Makes all properties of `T` nullable (allows `null`). */
 export type Nullable<T> = {
     [K in keyof T]: T[K] | null;
 };
+/** Union of JavaScript primitive types. */
 export type Primitive = null | undefined | string | number | boolean | symbol | bigint;
+/**
+ * Creates a union type that allows specific literals while still accepting the base type.
+ * Useful for string/number enums with autocomplete support.
+ *
+ * @example
+ * ```ts
+ * type Status = LiteralUnion<'pending' | 'active', string>
+ * // Allows 'pending', 'active', or any other string
+ * ```
+ */
 export type LiteralUnion<LiteralType, BaseType extends Primitive> = LiteralType | (BaseType & Record<never, never>);
+/** Extracts the value type for key `K` from object type `T`, or `never` if key doesn't exist. */
 export type GetValForKey<T, K> = K extends keyof T ? T[K] : never;
+/** Accepts either a single value or a readonly array of values. */
 export type SingleOrReadonlyArray<T> = T | ReadonlyArray<T>;
+/** Returns a Promise that resolves after `ms` milliseconds. */
 export declare const sleep: (ms: number) => Promise<unknown>;
+/**
+ * Creates a mutable reference object with a `current` property.
+ * Similar to React's `useRef` but works outside of React.
+ *
+ * @example
+ * ```ts
+ * const counter = ref(0)
+ * counter.current += 1
+ * ```
+ */
 export declare const ref: <T>(val: T) => {
     current: T;
 };
+/**
+ * Calls a function `n` times with the current index.
+ *
+ * @example
+ * ```ts
+ * times(3, (i) => console.log(i)) // logs 0, 1, 2
+ * ```
+ */
 export declare const times: (n: number, fn: (index: number) => {}) => void;
+/**
+ * Wraps a function call in a try/catch that triggers the debugger on error.
+ * Useful for debugging exceptions during development.
+ */
 export declare const debugCatch: <T>(try_: () => T) => T;
+/**
+ * Recursively removes `undefined` values from an object or array in place.
+ * Mutates the input value.
+ */
 export declare const recRemoveUndefinedValues: (val: any) => void;
 /**
  * Replace non-alphanumeric characters with a dash.
  */
 export declare const sluggify: (str: string, separator?: string) => string;
+/**
+ * Creates a property accessor function for use in pipelines.
+ *
+ * @example
+ * ```ts
+ * const users = [{ name: 'Alice' }, { name: 'Bob' }]
+ * const names = users.map(prop('name')) // ['Alice', 'Bob']
+ * ```
+ */
 export declare const prop: <T extends {}, K extends keyof T>(key: K) => (obj: T) => T[K];
+/** Capitalizes the first letter of a string. */
 export declare const capitalizeFirstLetter: (str: string) => string;
+/** Type guard that checks if a value is a readonly array. */
 export declare const isReadonlyArray: <I, T>(value: ReadonlyArray<I> | T) => value is ReadonlyArray<I>;
 /**
  * Use this to make assertion at end of if-else chain that all members of a
  * union have been accounted for.
  */
-export declare function casesHandled(unexpectedCase: never): never;
+export declare const casesHandled: (unexpectedCase: never) => never;
+/**
+ * Throws if the condition is false. Use for runtime assertions that should never fail.
+ *
+ * @example
+ * ```ts
+ * assertNever(user !== undefined, 'User must be loaded')
+ * ```
+ */
 export declare const assertNever: (failIfFalse: boolean, msg?: string) => void;
+/**
+ * Identity function that triggers the debugger. Useful for debugging pipelines.
+ *
+ * @example
+ * ```ts
+ * data.pipe(transform, debuggerPipe, format) // Pauses debugger here
+ * ```
+ */
 export declare const debuggerPipe: <T>(val: T) => T;
+/**
+ * Placeholder for unimplemented code paths. Triggers debugger and throws.
+ *
+ * @example
+ * ```ts
+ * const parseFormat = (format: Format) => {
+ *   switch (format) {
+ *     case 'json': return parseJson
+ *     case 'xml': return notYetImplemented('XML parsing')
+ *   }
+ * }
+ * ```
+ */
 export declare const notYetImplemented: (msg?: string) => never;
+/** A function that does nothing. Useful as a default callback. */
 export declare const noop: () => void;
+/** A function that returns a value of type `T`. */
 export type Thunk<T> = () => T;
+/**
+ * If the input is a function, calls it and returns the result. Otherwise returns the value directly.
+ *
+ * @example
+ * ```ts
+ * unwrapThunk(5) // 5
+ * unwrapThunk(() => 5) // 5
+ * ```
+ */
 export declare const unwrapThunk: <T>(_: T | (() => T)) => T;
+/**
+ * Transforms nullable fields (those that include `null`) into optional fields.
+ * Useful for converting database schemas to TypeScript types.
+ */
 export type NullableFieldsToOptional<T> = Types.Simplify<Partial<T> & {
     [K in keyof T as null extends T[K] ? K : never]?: Exclude<T[K], null>;
 } & {
     [K in keyof T as null extends T[K] ? never : K]: T[K];
 }>;
-/** `end` is not included */
+/**
+ * Creates an array of numbers from `start` (inclusive) to `end` (exclusive).
+ *
+ * @example
+ * ```ts
+ * range(0, 5) // [0, 1, 2, 3, 4]
+ * range(3, 7) // [3, 4, 5, 6]
+ * ```
+ */
 export declare const range: (start: number, end: number) => number[];
+/**
+ * Rate-limits function calls to at most once per `ms` milliseconds.
+ * Trailing calls are preserved—if called during the wait period, the function
+ * will be called again after the timeout.
+ *
+ * @example
+ * ```ts
+ * const throttledSave = throttle(() => saveData(), 1000)
+ * throttledSave() // Executes immediately
+ * throttledSave() // Queued, executes after 1 second
+ * throttledSave() // Ignored (already queued)
+ * ```
+ */
 export declare const throttle: (fn: () => void, ms: number) => () => void;
+/**
+ * Generates a W3C Trace Context `traceparent` header from an OpenTelemetry span.
+ * @see https://www.w3.org/TR/trace-context/#examples-of-http-traceparent-headers
+ */
 export declare const getTraceParentHeader: (parentSpan: otel.Span) => string;
+/**
+ * Asserts that a tagged union value has a specific tag, narrowing its type.
+ * Throws if the tag doesn't match.
+ *
+ * @example
+ * ```ts
+ * type Result = { _tag: 'ok'; value: number } | { _tag: 'error'; message: string }
+ * const result: Result = ...
+ * const ok = assertTag(result, 'ok') // Type is { _tag: 'ok'; value: number }
+ * ```
+ */
 export declare const assertTag: <TObj extends {
     _tag: string;
 }, TTag extends TObj["_tag"]>(obj: TObj, tag: TTag) => Extract<TObj, {
     _tag: TTag;
 }>;
+/**
+ * Memoizes a function by JSON-stringifying its arguments as the cache key.
+ * Suitable for functions with serializable arguments.
+ *
+ * @example
+ * ```ts
+ * const expensiveCalc = memoizeByStringifyArgs((a: number, b: number) => {
+ *   console.log('Computing...')
+ *   return a + b
+ * })
+ * expensiveCalc(1, 2) // logs 'Computing...', returns 3
+ * expensiveCalc(1, 2) // returns 3 (cached, no log)
+ * ```
+ */
 export declare const memoizeByStringifyArgs: <T extends (...args: any[]) => any>(fn: T) => T;
+/**
+ * Memoizes a single-argument function using reference equality for cache lookup.
+ * Suitable for functions where arguments are objects that should be compared by reference.
+ *
+ * @example
+ * ```ts
+ * const processUser = memoizeByRef((user: User) => expensiveTransform(user))
+ * processUser(userA) // Computes
+ * processUser(userA) // Returns cached (same reference)
+ * processUser(userB) // Computes (different reference)
+ * ```
+ */
 export declare const memoizeByRef: <T extends (arg: any) => any>(fn: T) => T;
+/** Type guard that checks if a value is a non-empty string. */
 export declare const isNonEmptyString: (str: string | undefined | null) => str is string;
+/** Type guard that checks if a value is a Promise (has a `then` method). */
 export declare const isPromise: (value: any) => value is Promise<unknown>;
+/** Type guard that checks if a value is iterable (has a `Symbol.iterator` method). */
 export declare const isIterable: <T>(value: any) => value is Iterable<T>;
-/** This utility "lies" as a means of compat with libs that don't explicitly type optionals as unioned with `undefined`. */
+/**
+ * Type-level utility that removes `undefined` from all property types.
+ * Used for compatibility with libraries that don't type optionals as `| undefined`.
+ *
+ * Note: This is a type-level lie—the runtime value is unchanged.
+ */
 export declare const omitUndefineds: <T extends Record<keyof any, unknown>>(rec: T) => { [K in keyof T]: Exclude<T[K], undefined>; };
 export { objectToString as errorToString } from './misc.ts';
 //# sourceMappingURL=mod.d.ts.map