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

package/dist/NoopTracer.d.ts

@@ -1,11 +1,10 @@
-/** biome-ignore-all lint/complexity/noArguments: using arguments is fine here */
-import type * as otel from '@opentelemetry/api';
-export declare const makeNoopSpan: () => otel.Span;
-export declare const makeNoopTracer: () => otel.Tracer;
+import { type Context, type Span, type SpanOptions, type Tracer } from '@opentelemetry/api';
+export declare const makeNoopSpan: () => Span;
+export declare const makeNoopTracer: () => Tracer;
 export declare class NoopTracer {
-    startSpan: () => otel.Span;
-    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>>(name: string, opts: otel.SpanOptions, ctx: otel.Context, fn: F): ReturnType<F>;
+    startSpan: () => Span;
+    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: SpanOptions, ctx: Context, fn: F): ReturnType<F>;
 }
 //# sourceMappingURL=NoopTracer.d.ts.map

package/dist/NoopTracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NoopTracer.d.ts","sourceRoot":"","sources":["../src/NoopTracer.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAE/C,eAAO,MAAM,YAAY,iBA0BxB,CAAA;AAED,eAAO,MAAM,cAAc,QACa,IAAI,CAAC,MAC5C,CAAA;AAED,qBAAa,UAAU;IACrB,SAAS,kBAAuB;IAEhC,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACjG,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAC1D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,CAAC,WAAW,EACtB,EAAE,EAAE,CAAC,GACJ,UAAU,CAAC,CAAC,CAAC;IAChB,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAC1D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,CAAC,WAAW,EACtB,GAAG,EAAE,IAAI,CAAC,OAAO,EACjB,EAAE,EAAE,CAAC,GACJ,UAAU,CAAC,CAAC,CAAC;CA0BjB"}
+{"version":3,"file":"NoopTracer.d.ts","sourceRoot":"","sources":["../src/NoopTracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEjH,eAAO,MAAM,YAAY,QAcO,IAC/B,CAAA;AAED,eAAO,MAAM,cAAc,QAEa,MACvC,CAAA;AAED,qBAAa,UAAU;IACrB,SAAS,aAAuB;IAEhC,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAC5F,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAC/G,eAAe,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EACrD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,CAAC,GACJ,UAAU,CAAC,CAAC,CAAC;CAgCjB"}

package/dist/NoopTracer.js

@@ -1,7 +1,6 @@
+import { INVALID_SPAN_CONTEXT } from '@opentelemetry/api';
 export const makeNoopSpan = () => {
-    const performanceStartTime = performance.now();
-    const span = {
-        _performanceStartTime: performanceStartTime,
+    const spanImpl = {
         setAttribute: () => null,
         setAttributes: () => null,
         addEvent: () => null,
@@ -9,21 +8,14 @@ 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;
-            span._duration = [durationSecs, durationRestNs];
-        },
-        spanContext: () => {
-            return { traceId: 'livestore-noop-trace-id', spanId: 'livestore-noop-span-id' };
-        },
-        _duration: [0, 0],
+        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;
 };
 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();
 };
 export class NoopTracer {
@@ -36,15 +28,21 @@ export class NoopTracer {
             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;
         }
         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;
+            // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 3 args, arg3 is the callback
             fn = arg3;
         }
         else {
+            // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg2 is SpanOptions
             _opts = arg2;
+            // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg3 is Context
             _ctx = arg3;
+            // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- arguments-based overload dispatch: with 4 args, arg4 is the callback
             fn = arg4;
         }
         return fn(makeNoopSpan());

package/dist/NoopTracer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NoopTracer.js","sourceRoot":"","sources":["../src/NoopTracer.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,oBAAoB,GAAwB,WAAW,CAAC,GAAG,EAAE,CAAA;IAEnE,MAAM,IAAI,GAAG;QACX,qBAAqB,EAAE,oBAAoB;QAC3C,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;QACxB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;QACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;QACtB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;QAC3B,GAAG,EAAE,GAAG,EAAE;YACR,MAAM,OAAO,GAAwB,WAAW,CAAC,GAAG,EAAE,CAAA;YACtD,MAAM,QAAQ,GAAG,OAAO,GAAG,oBAAoB,CAAA;YAC/C,MAAM,YAAY,GAAG,QAAQ,GAAG,IAAI,CAAA;YACpC,MAAM,cAAc,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,SAAS,CACnD;YAAC,IAAY,CAAC,SAAS,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;QAC3D,CAAC;QACD,WAAW,EAAE,GAAG,EAAE;YAChB,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAA;QACjF,CAAC;QACD,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;KACM,CAAA;IAEzB,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,OAAO,IAAI,UAAU,EAA4B,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,OAAO,UAAU;IACrB,SAAS,GAAG,GAAG,EAAE,CAAC,YAAY,EAAE,CAAA;IAchC,eAAe,CACb,KAAa,EACb,IAA2B,EAC3B,IAAuB,EACvB,IAAQ;QAER,IAAI,KAAmC,CAAA;QACvC,IAAI,IAA8B,CAAA;QAClC,IAAI,EAAK,CAAA;QAET,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAM;QACR,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,KAAK,GAAG,IAAoC,CAAA;YAC5C,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAoC,CAAA;YAC5C,IAAI,GAAG,IAAgC,CAAA;YACvC,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,CAAA;IAC3B,CAAC;CACF"}
+{"version":3,"file":"NoopTracer.js","sourceRoot":"","sources":["../src/NoopTracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA0D,MAAM,oBAAoB,CAAA;AAEjH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG;QACf,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI;QACxB,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI;QACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI;QACrB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI;QACtB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI;QAC3B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;QACf,WAAW,EAAE,GAAG,EAAE,CAAC,oBAAoB;KACxC,CAAA;IAED,wJAAwJ;IACxJ,OAAO,QAA2B,CAAA;AACpC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,0JAA0J;IAC1J,OAAO,IAAI,UAAU,EAAuB,CAAA;AAC9C,CAAC,CAAA;AAED,MAAM,OAAO,UAAU;IACrB,SAAS,GAAG,GAAG,EAAE,CAAC,YAAY,EAAE,CAAA;IAUhC,eAAe,CACb,KAAa,EACb,IAAsB,EACtB,IAAkB,EAClB,IAAQ;QAER,IAAI,KAA8B,CAAA;QAClC,IAAI,IAAyB,CAAA;QAC7B,IAAI,EAAK,CAAA;QAET,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAM;QACR,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,+IAA+I;YAC/I,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,8IAA8I;YAC9I,KAAK,GAAG,IAA+B,CAAA;YACvC,+IAA+I;YAC/I,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;aAAM,CAAC;YACN,8IAA8I;YAC9I,KAAK,GAAG,IAA+B,CAAA;YACvC,0IAA0I;YAC1I,IAAI,GAAG,IAA2B,CAAA;YAClC,+IAA+I;YAC/I,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;QAED,OAAO,EAAE,CAAC,YAAY,EAAE,CAAC,CAAA;IAC3B,CAAC;CACF"}

package/dist/NoopTracer.test.d.ts

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

package/dist/NoopTracer.test.d.ts.map

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

package/dist/NoopTracer.test.js

@@ -0,0 +1,17 @@
+import { INVALID_SPAN_CONTEXT, isSpanContextValid, ROOT_CONTEXT } from '@opentelemetry/api';
+import { describe, expect, it } from 'vitest';
+import { makeNoopSpan, makeNoopTracer } from "./NoopTracer.js";
+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');
+    });
+});
+//# sourceMappingURL=NoopTracer.test.js.map

package/dist/NoopTracer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoopTracer.test.js","sourceRoot":"","sources":["../src/NoopTracer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC3F,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE9D,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC,WAAW,EAAE,CAAA;QAEhD,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC9C,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,iBAAiB,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAClF,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,gBAAgB,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/F,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/binary.js

@@ -32,7 +32,7 @@ export const isUint8ArrayBuffer = (array) => {
  * Safer alternative to type assertions.
  */
 export const toUint8ArrayBuffer = (array) => {
-    if (isUint8ArrayBuffer(array)) {
+    if (isUint8ArrayBuffer(array) === true) {
         return array;
     }
     // Copy to ensure ArrayBuffer backing

package/dist/binary.js.map

@@ -1 +1 @@
-{"version":3,"file":"binary.js","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAiB,EAA2B,EAAE;IACnF,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW,EAAE,CAAC;QACxC,OAAO,KAAgC,CAAA;IACzC,CAAC;IACD,wFAAwF;IACxF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjB,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAA2B,EAAE;IAC/E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9C,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAA;AACxC,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAiB,EAAoC,EAAE;IACxF,OAAO,KAAK,CAAC,MAAM,YAAY,WAAW,CAAA;AAC5C,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAiB,EAA2B,EAAE;IAC/E,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,qCAAqC;IACrC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjB,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAiB,EAA2B,EAAE;IACnF,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW,EAAE,CAAC;QACxC,OAAO,KAAgC,CAAA;IACzC,CAAC;IACD,wFAAwF;IACxF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjB,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAA2B,EAAE;IAC/E,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC9C,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAA;AACxC,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAiB,EAAoC,EAAE;IACxF,OAAO,KAAK,CAAC,MAAM,YAAY,WAAW,CAAA;AAC5C,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAiB,EAA2B,EAAE;IAC/E,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,OAAO,KAAK,CAAA;IACd,CAAC;IACD,qCAAqC;IACrC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACjB,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/browser/Opfs/Opfs.d.ts

@@ -0,0 +1,201 @@
+import { Context, Effect, Layer, Option, Schema, type Scope, Stream } from 'effect';
+import * as WebError from '../WebError.ts';
+/**
+ * Effect service that exposes ergonomic wrappers around Origin Private File System (OPFS) operations.
+ *
+ * @remarks
+ * - Helpers mirror the File System Access API where possible and parse web exceptions into Effect errors.
+ * - Sync access handle helpers can only be used in dedicated workers; invoking them in other contexts fails at runtime.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Origin_private_file_system | MDN Reference}
+ */
+export interface Service {
+    /**
+     * Acquire the OPFS root directory handle.
+     *
+     * @returns Root directory handle for the current origin.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/StorageManager/getDirectory | MDN Reference}
+     */
+    readonly getRootDirectoryHandle: Effect.Effect<FileSystemDirectoryHandle, WebError.WebError>;
+    /**
+     * Resolve (and optionally create) a file handle relative to a directory.
+     *
+     * @param parent - Directory to search.
+     * @param name - Target file name.
+     * @param options - Forwarded `getFileHandle` options such as `{ create: true }`.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getFileHandle | MDN Reference}
+     */
+    readonly getFileHandle: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemGetFileOptions) => Effect.Effect<FileSystemFileHandle, WebError.WebError>;
+    /**
+     * Resolve (and optionally create) a directory handle relative to another directory.
+     *
+     * @param parent - Directory to search.
+     * @param name - Target directory name.
+     * @param options - Forwarded `getDirectoryHandle` options such as `{ create: true }`.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle | MDN Reference}
+     */
+    readonly getDirectoryHandle: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemGetDirectoryOptions) => Effect.Effect<FileSystemDirectoryHandle, WebError.WebError>;
+    /**
+     * Remove a file-system entry (file or directory) from its parent directory.
+     *
+     * @param parent - Directory containing the entry.
+     * @param name - Entry name.
+     * @param options - Removal behavior (for example `{ recursive: true }`).
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/removeEntry | MDN Reference}
+     */
+    readonly removeEntry: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemRemoveOptions) => Effect.Effect<void, WebError.WebError>;
+    /**
+     * Return a stream of child file-system handles for a directory.
+     *
+     * @param directory - Directory whose children are to be streamed
+     * @returns `Stream` of `FileSystemHandle`
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/values | MDN Reference}
+     */
+    readonly values: (directory: FileSystemDirectoryHandle) => Stream.Stream<FileSystemHandle, WebError.NotAllowedError | WebError.NotFoundError | WebError.UnknownError>;
+    /**
+     * Resolve the relative path from a parent directory to a descendant handle.
+     *
+     * @param parent - Reference directory.
+     * @param child - File or directory handle within the parent hierarchy.
+     * @returns `Option.some(pathSegments)` when reachable, otherwise `Option.none()`.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemDirectoryHandle/resolve | MDN Reference}
+     */
+    readonly resolve: (parent: FileSystemDirectoryHandle, child: FileSystemHandle) => Effect.Effect<Option.Option<ReadonlyArray<string>>, WebError.WebError>;
+    /**
+     * Read the underlying `File` for a file handle.
+     *
+     * @param handle - Handle referencing the target file.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/getFile | MDN Reference}
+     */
+    readonly getFile: (handle: FileSystemFileHandle) => Effect.Effect<File, WebError.WebError>;
+    /**
+     * Overwrite the contents of a file with the provided data.
+     *
+     * @param handle - File to write to.
+     * @param data - Chunk(s) accepted by `FileSystemWritableFileStream.write`.
+     * @param options - Stream creation options (for example, `{ keepExistingData: false }`).
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createWritable | MDN Reference}
+     */
+    readonly writeFile: (handle: FileSystemFileHandle, data: FileSystemWriteChunkType, options?: FileSystemCreateWritableOptions) => Effect.Effect<void, WebError.WebError>;
+    /**
+     * Append data to the end of an existing file.
+     *
+     * @param handle - File to extend.
+     * @param data - Data to append.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/write | MDN Reference}
+     */
+    readonly appendToFile: (handle: FileSystemFileHandle, data: FileSystemWriteChunkType) => Effect.Effect<void, WebError.WebError>;
+    /**
+     * Truncate a file to the specified size in bytes.
+     *
+     * @param handle - File to shrink or pad.
+     * @param size - Target byte length.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemWritableFileStream/truncate | MDN Reference}
+     */
+    readonly truncateFile: (handle: FileSystemFileHandle, size: number) => Effect.Effect<void, WebError.WebError>;
+    /**
+     * Create a synchronous access handle for a file.
+     *
+     * @param handle - File handle to open.
+     * @returns A managed handle that is automatically closed when released.
+     *
+     * @remarks
+     * - Only available in Dedicated Web Workers.
+     * - This method is asynchronous even though the `FileSystemSyncAccessHandle` APIs are synchronous.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileHandle/createSyncAccessHandle | MDN Reference}
+     */
+    readonly createSyncAccessHandle: (handle: FileSystemFileHandle) => Effect.Effect<FileSystemSyncAccessHandle, WebError.WebError, Scope.Scope>;
+    /**
+     * Perform a synchronous read into the provided buffer from a sync access handle.
+     *
+     * @param handle - Sync access handle to read from.
+     * @param buffer - Destination buffer (can be a specific view like Uint8Array).
+     * @param options - Read position options.
+     * @returns Number of bytes read.
+     *
+     * @remarks
+     * Only available in Dedicated Web Workers.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/read | MDN Reference}
+     */
+    readonly syncRead: (handle: FileSystemSyncAccessHandle, buffer: ArrayBuffer | ArrayBufferView, options?: FileSystemReadWriteOptions) => Effect.Effect<number, WebError.WebError>;
+    /**
+     * Perform a synchronous write from the provided buffer into the file.
+     *
+     * @param handle - Sync access handle to write to.
+     * @param buffer - Source data.
+     * @param options - Write position options.
+     * @returns Number of bytes written.
+     *
+     * @remarks
+     * Only available in Dedicated Web Workers.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/write | MDN Reference}
+     */
+    readonly syncWrite: (handle: FileSystemSyncAccessHandle, buffer: AllowSharedBufferSource, options?: FileSystemReadWriteOptions) => Effect.Effect<number, WebError.WebError>;
+    /**
+     * Truncate the file associated with a sync access handle to the specified size.
+     *
+     * @param handle - Sync access handle to mutate.
+     * @param size - Desired byte length.
+     *
+     * @remarks
+     * Only available in Dedicated Web Workers.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate | MDN Reference}
+     */
+    readonly syncTruncate: (handle: FileSystemSyncAccessHandle, size: number) => Effect.Effect<void, WebError.WebError>;
+    /**
+     * Retrieve the current size of a file via its sync access handle.
+     *
+     * @param handle - Sync access handle.
+     * @returns File size in bytes.
+     *
+     * @remarks
+     * Only available in Dedicated Web Workers.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/getSize | MDN Reference}
+     */
+    readonly syncGetSize: (handle: FileSystemSyncAccessHandle) => Effect.Effect<number, WebError.WebError>;
+    /**
+     * Flush pending synchronous writes to durable storage.
+     *
+     * @param handle - Sync access handle to flush.
+     *
+     * @remarks
+     * Only available in Dedicated Web Workers.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/flush | MDN Reference}
+     */
+    readonly syncFlush: (handle: FileSystemSyncAccessHandle) => Effect.Effect<void, WebError.WebError>;
+}
+declare const Opfs_base: Context.ServiceClass<Opfs, "@livestore/utils/Opfs", Service>;
+export declare class Opfs extends Opfs_base {
+}
+export declare const layer: Layer.Layer<Opfs, never, never>;
+/**
+ * A no-op Opfs service that can be used for testing.
+ */
+export declare const layerNoop: Layer.Layer<Opfs, never, never>;
+declare const OpfsError_base: Schema.Class<OpfsError, Schema.TaggedStruct<"OpfsError", {
+    readonly message: Schema.String;
+    readonly cause: Schema.optional<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Error raised when OPFS operations fail.
+ */
+export declare class OpfsError extends OpfsError_base {
+}
+export {};
+//# sourceMappingURL=Opfs.d.ts.map

package/dist/browser/Opfs/Opfs.d.ts.map

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

package/dist/browser/Opfs/Opfs.js

@@ -0,0 +1,170 @@
+/// <reference lib="webworker" />
+import { Context, Effect, Layer, Option, Schema, Stream } from 'effect';
+import * as WebError from "../WebError.js";
+export class Opfs extends Context.Service()('@livestore/utils/Opfs') {
+}
+export const layer = Layer.succeed(Opfs, Opfs.of({
+    getRootDirectoryHandle: Effect.tryPromise({
+        try: () => navigator.storage.getDirectory(),
+        catch: (u) => WebError.classifyWebError(u, [WebError.SecurityError]),
+    }),
+    getFileHandle: (parent, name, options) => Effect.tryPromise({
+        try: () => parent.getFileHandle(name, options),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.NotAllowedError,
+            WebError.TypeError,
+            WebError.TypeMismatchError,
+            WebError.NotFoundError,
+        ]),
+    }),
+    getDirectoryHandle: (parent, name, options) => Effect.tryPromise({
+        try: () => parent.getDirectoryHandle(name, options),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.NotAllowedError,
+            WebError.TypeError,
+            WebError.TypeMismatchError,
+            WebError.NotFoundError,
+        ]),
+    }),
+    removeEntry: (parent, name, options) => Effect.tryPromise({
+        try: () => parent.removeEntry(name, options),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.TypeError,
+            WebError.NotAllowedError,
+            WebError.InvalidModificationError,
+            WebError.NotFoundError,
+            WebError.NoModificationAllowedError,
+        ]),
+    }),
+    values: (directory) => Stream.fromAsyncIterable(directory.values(), (u) => WebError.classifyWebError(u, [WebError.NotAllowedError, WebError.NotFoundError])),
+    resolve: (parent, child) => Effect.tryPromise({
+        try: () => parent.resolve(child),
+        catch: (u) => WebError.classifyWebError(u),
+    }).pipe(Effect.map((path) => (path === null ? Option.none() : Option.some(path)))),
+    getFile: (handle) => Effect.tryPromise({
+        try: () => handle.getFile(),
+        catch: (u) => WebError.classifyWebError(u, [WebError.NotAllowedError, WebError.NotFoundError]),
+    }),
+    writeFile: (handle, data, options) => Effect.acquireUseRelease(Effect.tryPromise({
+        try: () => handle.createWritable(options),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.NotAllowedError,
+            WebError.NotFoundError,
+            WebError.NoModificationAllowedError,
+            WebError.AbortError,
+        ]),
+    }), (stream) => Effect.tryPromise({
+        try: () => stream.write(data),
+        catch: (u) => WebError.classifyWebError(u, [WebError.NotAllowedError, WebError.QuotaExceededError, WebError.TypeError]),
+    }), (stream) => Effect.tryPromise({
+        try: () => stream.close(),
+        catch: (u) => WebError.classifyWebError(u, [WebError.TypeError]),
+    }).pipe(Effect.catchCause(() => Effect.void))),
+    appendToFile: (handle, data) => Effect.acquireUseRelease(Effect.tryPromise({
+        try: () => handle.createWritable({ keepExistingData: true }),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.NotAllowedError,
+            WebError.NotFoundError,
+            WebError.NoModificationAllowedError,
+            WebError.AbortError,
+        ]),
+    }), (stream) => Effect.gen(function* () {
+        const file = yield* Effect.tryPromise({
+            try: () => handle.getFile(),
+            catch: (u) => WebError.classifyWebError(u, [WebError.NotAllowedError, WebError.NotFoundError]),
+        });
+        yield* Effect.tryPromise({
+            try: () => stream.seek(file.size),
+            catch: (u) => WebError.classifyWebError(u, [WebError.NotAllowedError, WebError.TypeError]),
+        });
+        yield* Effect.tryPromise({
+            try: () => stream.write(data),
+            catch: (u) => WebError.classifyWebError(u, [
+                WebError.NotAllowedError,
+                WebError.QuotaExceededError,
+                WebError.TypeError,
+            ]),
+        });
+    }), (stream) => Effect.tryPromise({
+        try: () => stream.close(),
+        catch: (u) => WebError.classifyWebError(u, [WebError.TypeError]),
+    }).pipe(Effect.catchCause(() => Effect.void))),
+    truncateFile: (handle, size) => Effect.acquireUseRelease(Effect.tryPromise({
+        try: () => handle.createWritable({ keepExistingData: true }),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.NotAllowedError,
+            WebError.NotFoundError,
+            WebError.NoModificationAllowedError,
+            WebError.AbortError,
+        ]),
+    }), (stream) => Effect.tryPromise({
+        try: () => stream.truncate(size),
+        catch: (u) => WebError.classifyWebError(u, [WebError.NotAllowedError, WebError.TypeError, WebError.QuotaExceededError]),
+    }), (stream) => Effect.tryPromise({
+        try: () => stream.close(),
+        catch: (u) => WebError.classifyWebError(u, [WebError.TypeError]),
+    }).pipe(Effect.catchCause(() => Effect.void))),
+    createSyncAccessHandle: (handle) => Effect.acquireRelease(Effect.tryPromise({
+        try: () => handle.createSyncAccessHandle(),
+        catch: (u) => WebError.classifyWebError(u, [
+            WebError.NotAllowedError,
+            WebError.InvalidStateError,
+            WebError.NotFoundError,
+            WebError.NoModificationAllowedError,
+        ]),
+    }), (syncHandle) => Effect.sync(() => syncHandle.close())),
+    syncRead: (handle, buffer, options) => Effect.try({
+        try: () => handle.read(buffer, options),
+        catch: (u) => WebError.classifyWebError(u, [WebError.RangeError, WebError.InvalidStateError, WebError.TypeError]),
+    }),
+    syncWrite: (handle, buffer, options) => Effect.try({
+        try: () => handle.write(buffer, options),
+        catch: (u) => WebError.classifyWebError(u),
+    }),
+    syncTruncate: (handle, size) => Effect.try({
+        try: () => handle.truncate(size),
+        catch: (u) => WebError.classifyWebError(u),
+    }),
+    syncGetSize: (handle) => Effect.try({
+        try: () => handle.getSize(),
+        catch: (u) => WebError.classifyWebError(u),
+    }),
+    syncFlush: (handle) => Effect.try({
+        try: () => handle.flush(),
+        catch: (u) => WebError.classifyWebError(u),
+    }),
+}));
+const notFoundError = new WebError.NotFoundError({
+    cause: new DOMException('The object can not be found here.', 'NotFoundError'),
+});
+const unknownError = (message) => new WebError.UnknownError({ description: message });
+/**
+ * A no-op Opfs service that can be used for testing.
+ */
+export const layerNoop = Layer.succeed(Opfs, Opfs.of({
+    getRootDirectoryHandle: Effect.fail(unknownError('OPFS is not supported in this environment')),
+    getFileHandle: () => Effect.fail(notFoundError),
+    getDirectoryHandle: () => Effect.fail(notFoundError),
+    removeEntry: () => Effect.fail(notFoundError),
+    values: () => Stream.fail(notFoundError),
+    resolve: () => Effect.succeed(Option.none()),
+    getFile: () => Effect.fail(notFoundError),
+    writeFile: () => Effect.fail(notFoundError),
+    appendToFile: () => Effect.fail(notFoundError),
+    truncateFile: () => Effect.fail(notFoundError),
+    createSyncAccessHandle: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncRead: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncWrite: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncTruncate: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncGetSize: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+    syncFlush: () => Effect.fail(unknownError('OPFS is not supported in this environment')),
+}));
+/**
+ * Error raised when OPFS operations fail.
+ */
+export class OpfsError extends Schema.TaggedError('~@livestore/utils/OpfsError')('OpfsError', {
+    message: Schema.String,
+    cause: Schema.optional(Schema.Defect()),
+}) {
+}
+//# sourceMappingURL=Opfs.js.map

package/dist/browser/Opfs/Opfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Opfs.js","sourceRoot":"","sources":["../../../src/browser/Opfs/Opfs.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAc,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEnF,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAyN1C,MAAM,OAAO,IAAK,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,uBAAuB,CAAC;CAAG;AAEtF,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAChC,IAAI,EACJ,IAAI,CAAC,EAAE,CAAC;IACN,sBAAsB,EAAE,MAAM,CAAC,UAAU,CAAC;QACxC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE;QAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;KACrE,CAAC;IACF,aAAa,EAAE,CAAC,MAAiC,EAAE,IAAY,EAAE,OAAkC,EAAE,EAAE,CACrG,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QAC9C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,SAAS;YAClB,QAAQ,CAAC,iBAAiB;YAC1B,QAAQ,CAAC,aAAa;SACvB,CAAC;KACL,CAAC;IACJ,kBAAkB,EAAE,CAAC,MAAiC,EAAE,IAAY,EAAE,OAAuC,EAAE,EAAE,CAC/G,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC;QACnD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,SAAS;YAClB,QAAQ,CAAC,iBAAiB;YAC1B,QAAQ,CAAC,aAAa;SACvB,CAAC;KACL,CAAC;IACJ,WAAW,EAAE,CAAC,MAAiC,EAAE,IAAY,EAAE,OAAiC,EAAE,EAAE,CAClG,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;QAC5C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,SAAS;YAClB,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,wBAAwB;YACjC,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,0BAA0B;SACpC,CAAC;KACL,CAAC;IACJ,MAAM,EAAE,CACN,SAAoC,EAKpC,EAAE,CACF,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CACjD,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CACjF;IACH,OAAO,EAAE,CAAC,MAAiC,EAAE,KAAuB,EAAE,EAAE,CACtE,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;KAC3C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,EAAE,CAAC,MAA4B,EAAE,EAAE,CACxC,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;KAC/F,CAAC;IACJ,SAAS,EAAE,CACT,MAA4B,EAC5B,IAA8B,EAC9B,OAAyC,EACzC,EAAE,CACF,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC;QACzC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,0BAA0B;YACnC,QAAQ,CAAC,UAAU;SACpB,CAAC;KACL,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KAC5G,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;KACjE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAChD;IACH,YAAY,EAAE,CAAC,MAA4B,EAAE,IAA8B,EAAE,EAAE,CAC7E,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;QAC5D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,0BAA0B;YACnC,QAAQ,CAAC,UAAU;SACpB,CAAC;KACL,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACpC,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;YAC3B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;SAC/F,CAAC,CAAA;QACF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACvB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;SAC3F,CAAC,CAAA;QACF,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;YACvB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YAC7B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;gBAC3B,QAAQ,CAAC,eAAe;gBACxB,QAAQ,CAAC,kBAAkB;gBAC3B,QAAQ,CAAC,SAAS;aACnB,CAAC;SACL,CAAC,CAAA;IACJ,CAAC,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;KACjE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAChD;IACH,YAAY,EAAE,CAAC,MAA4B,EAAE,IAAY,EAAE,EAAE,CAC3D,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;QAC5D,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,0BAA0B;YACnC,QAAQ,CAAC,UAAU;SACpB,CAAC;KACL,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;KAC5G,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;KACjE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAChD;IACH,sBAAsB,EAAE,CAAC,MAA4B,EAAE,EAAE,CACvD,MAAM,CAAC,cAAc,CACnB,MAAM,CAAC,UAAU,CAAC;QAChB,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE;QAC1C,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE;YAC3B,QAAQ,CAAC,eAAe;YACxB,QAAQ,CAAC,iBAAiB;YAC1B,QAAQ,CAAC,aAAa;YACtB,QAAQ,CAAC,0BAA0B;SACpC,CAAC;KACL,CAAC,EACF,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CACtD;IACH,QAAQ,EAAE,CACR,MAAkC,EAClC,MAAqC,EACrC,OAAoC,EACpC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;QACvC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,QAAQ,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KACtG,CAAC;IACJ,SAAS,EAAE,CACT,MAAkC,EAClC,MAA+B,EAC/B,OAAoC,EACpC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;QACxC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;KAC3C,CAAC;IACJ,YAAY,EAAE,CAAC,MAAkC,EAAE,IAAY,EAAE,EAAE,CACjE,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;KAC3C,CAAC;IACJ,WAAW,EAAE,CAAC,MAAkC,EAAE,EAAE,CAClD,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;KAC3C,CAAC;IACJ,SAAS,EAAE,CAAC,MAAkC,EAAE,EAAE,CAChD,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;KAC3C,CAAC;CACL,CAAC,CACH,CAAA;AAED,MAAM,aAAa,GAAG,IAAI,QAAQ,CAAC,aAAa,CAAC;IAC/C,KAAK,EAAE,IAAI,YAAY,CAAC,mCAAmC,EAAE,eAAe,CAAC;CAC9E,CAAC,CAAA;AAEF,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAA;AAE7F;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CACpC,IAAI,EACJ,IAAI,CAAC,EAAE,CAAC;IACN,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IAC9F,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC/C,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACpD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC7C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACxC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACzC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC3C,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC9C,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IAC9C,sBAAsB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACpG,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACtF,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACvF,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IAC1F,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;IACzF,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,2CAA2C,CAAC,CAAC;CACxF,CAAC,CACH,CAAA;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,MAAM,CAAC,WAAW,CAAY,6BAA6B,CAAC,CAAC,WAAW,EAAE;IACvG,OAAO,EAAE,MAAM,CAAC,MAAM;IACtB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;CACxC,CAAC;CAAG"}

package/dist/browser/Opfs/debug-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Debug utilities for OPFS (Origin Private File System) inspection and manipulation.
+ * These functions are designed for use in browser devtools console to help debug
+ * and inspect the OPFS structure during development.
+ */
+export declare const debugUtils: {
+    /**
+     * Print the entire OPFS tree structure to the console in an ASCII format.
+     */
+    readonly printTree: () => Promise<void>;
+    /**
+     * Reset the entire OPFS tree by removing all files and directories.
+     */
+    readonly resetTree: () => Promise<void>;
+    /**
+     * Get a directory handle for a given path, useful for inspecting or manipulating specific directories.
+     */
+    readonly getDirHandle: (path: string, options?: FileSystemGetDirectoryOptions) => Promise<FileSystemDirectoryHandle>;
+};
+//# sourceMappingURL=debug-utils.d.ts.map

package/dist/browser/Opfs/debug-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-utils.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/debug-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwIH,eAAO,MAAM,UAAU;IACrB;;OAEG;8BACY,OAAO,CAAC,IAAI,CAAC;IAC5B;;OAEG;8BACY,OAAO,CAAC,IAAI,CAAC;IAC5B;;OAEG;kCACkB,MAAM,YAAY,6BAA6B;CAC5D,CAAA"}