@livestore/utils 0.4.0 → 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;AAEjF,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAA;AAI/C,eAAO,MAAM,YAAY,QA6BO,IAAI,CAAC,IACpC,CAAA;AAED,eAAO,MAAM,cAAc,QAEa,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;CAgCjB"}
+{"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,9 +1,6 @@
-/** biome-ignore-all lint/complexity/noArguments: using arguments is fine here */
-import { cuid } from '@livestore/utils/cuid';
+import { INVALID_SPAN_CONTEXT } from '@opentelemetry/api';
 export const makeNoopSpan = () => {
-    const performanceStartTime = performance.now();
     const spanImpl = {
-        _performanceStartTime: performanceStartTime,
         setAttribute: () => null,
         setAttributes: () => null,
         addEvent: () => null,
@@ -11,20 +8,8 @@ export const makeNoopSpan = () => {
         setStatus: () => null,
         updateName: () => null,
         recordException: () => null,
-        end: () => {
-            const endTime = performance.now();
-            const duration = endTime - performanceStartTime;
-            const durationSecs = duration / 1000;
-            const durationRestNs = (duration % 1000) * 1_000_000;
-            spanImpl._duration = [durationSecs, durationRestNs];
-        },
-        spanContext: () => {
-            return {
-                traceId: `livestore-noop-trace-id${cuid()}`,
-                spanId: `livestore-noop-span-id${cuid()}`,
-            };
-        },
-        _duration: [0, 0],
+        end: () => null,
+        spanContext: () => INVALID_SPAN_CONTEXT,
     };
     // oxlint-disable-next-line typescript-eslint(no-unsafe-type-assertion) -- noop otel.Span implementation; only implements the subset needed by LiveStore
     return spanImpl;

package/dist/NoopTracer.js.map

@@ -1 +1 @@
-{"version":3,"file":"NoopTracer.js","sourceRoot":"","sources":["../src/NoopTracer.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAIjF,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAE9C,MAAM,QAAQ,GAAG;QACf,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,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YACjC,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,CAAA;YACpD,QAAQ,CAAC,SAAS,GAAG,CAAC,YAAY,EAAE,cAAc,CAAqB,CAAA;QACzE,CAAC;QACD,WAAW,EAAE,GAAG,EAAE;YAChB,OAAO;gBACL,OAAO,EAAE,0BAA0B,IAAI,EAAE,EAAE;gBAC3C,MAAM,EAAE,yBAAyB,IAAI,EAAE,EAAE;aAC1C,CAAA;QACH,CAAC;QACD,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAqB;KACtC,CAAA;IAED,wJAAwJ;IACxJ,OAAO,QAAgC,CAAA;AACzC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,0JAA0J;IAC1J,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,+IAA+I;YAC/I,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;aAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,8IAA8I;YAC9I,KAAK,GAAG,IAAoC,CAAA;YAC5C,+IAA+I;YAC/I,EAAE,GAAG,IAAS,CAAA;QAChB,CAAC;aAAM,CAAC;YACN,8IAA8I;YAC9I,KAAK,GAAG,IAAoC,CAAA;YAC5C,0IAA0I;YAC1I,IAAI,GAAG,IAAgC,CAAA;YACvC,+IAA+I;YAC/I,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/browser/Opfs/Opfs.d.ts

@@ -1,26 +1,5 @@
-import { Effect, Option, Schema, Stream } from 'effect';
+import { Context, Effect, Layer, Option, Schema, type Scope, Stream } from 'effect';
 import * as WebError from '../WebError.ts';
-declare const Opfs_base: Effect.Service.Class<Opfs, "@livestore/utils/Opfs", {
-    readonly sync: () => {
-        readonly getRootDirectoryHandle: Effect.Effect<FileSystemDirectoryHandle, WebError.SecurityError | WebError.UnknownError, never>;
-        readonly getFileHandle: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemGetFileOptions) => Effect.Effect<FileSystemFileHandle, WebError.TypeError | WebError.NotFoundError | WebError.NotAllowedError | WebError.TypeMismatchError | WebError.UnknownError, never>;
-        readonly getDirectoryHandle: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemGetDirectoryOptions) => Effect.Effect<FileSystemDirectoryHandle, WebError.TypeError | WebError.NotFoundError | WebError.NotAllowedError | WebError.TypeMismatchError | WebError.UnknownError, never>;
-        readonly removeEntry: (parent: FileSystemDirectoryHandle, name: string, options?: FileSystemRemoveOptions) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.InvalidModificationError | WebError.UnknownError, never>;
-        readonly values: (directory: FileSystemDirectoryHandle) => Stream.Stream<FileSystemHandle, WebError.NotAllowedError | WebError.NotFoundError | WebError.UnknownError, never>;
-        readonly resolve: (parent: FileSystemDirectoryHandle, child: FileSystemHandle) => Effect.Effect<Option.None<string[]> | Option.Some<string[]>, WebError.WebError, never>;
-        readonly getFile: (handle: FileSystemFileHandle) => Effect.Effect<File, WebError.NotFoundError | WebError.NotAllowedError | WebError.UnknownError, never>;
-        readonly writeFile: (handle: FileSystemFileHandle, data: FileSystemWriteChunkType, options?: FileSystemCreateWritableOptions) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.AbortError | WebError.QuotaExceededError | WebError.UnknownError, never>;
-        readonly appendToFile: (handle: FileSystemFileHandle, data: FileSystemWriteChunkType) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.AbortError | WebError.QuotaExceededError | WebError.UnknownError, never>;
-        readonly truncateFile: (handle: FileSystemFileHandle, size: number) => Effect.Effect<void, WebError.TypeError | WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.AbortError | WebError.QuotaExceededError | WebError.UnknownError, never>;
-        readonly createSyncAccessHandle: (handle: FileSystemFileHandle) => Effect.Effect<FileSystemSyncAccessHandle, WebError.NoModificationAllowedError | WebError.NotFoundError | WebError.NotAllowedError | WebError.InvalidStateError | WebError.UnknownError, import("effect/Scope").Scope>;
-        readonly syncRead: (handle: FileSystemSyncAccessHandle, buffer: ArrayBuffer | ArrayBufferView, options?: FileSystemReadWriteOptions) => Effect.Effect<number, WebError.RangeError | WebError.TypeError | WebError.InvalidStateError | WebError.UnknownError, never>;
-        readonly syncWrite: (handle: FileSystemSyncAccessHandle, buffer: AllowSharedBufferSource, options?: FileSystemReadWriteOptions) => Effect.Effect<number, WebError.WebError, never>;
-        readonly syncTruncate: (handle: FileSystemSyncAccessHandle, size: number) => Effect.Effect<void, WebError.WebError, never>;
-        readonly syncGetSize: (handle: FileSystemSyncAccessHandle) => Effect.Effect<number, WebError.WebError, never>;
-        readonly syncFlush: (handle: FileSystemSyncAccessHandle) => Effect.Effect<void, WebError.WebError, never>;
-    };
-    readonly accessors: true;
-}>;
 /**
  * Effect service that exposes ergonomic wrappers around Origin Private File System (OPFS) operations.
  *
@@ -30,18 +9,189 @@ declare const Opfs_base: Effect.Service.Class<Opfs, "@livestore/utils/Opfs", {
  *
  * @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 noopOpfs: Opfs;
-declare const OpfsError_base: Schema.TaggedErrorClass<OpfsError, "OpfsError", {
-    readonly _tag: Schema.tag<"OpfsError">;
-} & {
-    message: typeof Schema.String;
-    cause: Schema.optional<typeof Schema.Defect>;
-}>;
+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.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"Opfs.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/Opfs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;;;;yCAkCP,yBAAyB,QAAQ,MAAM,YAAY,wBAAwB;8CAsBhG,yBAAyB,QAC3B,MAAM,YACF,6BAA6B;uCAsBZ,yBAAyB,QAAQ,MAAM,YAAY,uBAAuB;qCAsB1F,yBAAyB,KACnC,MAAM,CAAC,MAAM,CACd,gBAAgB,EAChB,QAAQ,CAAC,eAAe,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,YAAY,EACzE,KAAK,CACN;mCAewB,yBAAyB,SAAS,gBAAgB;mCAalD,oBAAoB;qCAgBnC,oBAAoB,QACtB,wBAAwB,YACpB,+BAA+B;wCAkCb,oBAAoB,QAAQ,wBAAwB;wCAwCpD,oBAAoB,QAAQ,MAAM;kDAqCxB,oBAAoB;oCA6BlD,0BAA0B,UAC1B,WAAW,GAAG,eAAe,YAC3B,0BAA0B;qCAqB5B,0BAA0B,UAC1B,uBAAuB,YACrB,0BAA0B;wCAkBR,0BAA0B,QAAQ,MAAM;uCAiBzC,0BAA0B;qCAgB5B,0BAA0B;;;;AA/WzD;;;;;;;;GAQG;AACH,qBAAa,IAAK,SAAQ,SAgYxB;CAAG;AAQL;;GAEG;AACH,eAAO,MAAM,QAAQ,MAiBnB,CAAA;;;;;;;AAEF;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAG7B;CAAG"}
+{"version":3,"file":"Opfs.d.ts","sourceRoot":"","sources":["../../../src/browser/Opfs/Opfs.ts"],"names":[],"mappings":"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"}