@effect-vfs/core 0.7.1 → 0.9.0

package/dist/internal/volumeLimits.d.ts

@@ -0,0 +1,53 @@
+import * as ByteSize from "effect/ByteSize";
+import * as Result from "effect/Result";
+import type { VolumeLimits } from "../VirtualFileSystem.js";
+import { type VolumeIdentity, VolumeOptions } from "../Volume.js";
+import type * as Tree from "./tree.js";
+type StoredLimits = Tree.Runtime["limits"];
+/** @internal */
+export declare const defaults: VolumeLimits;
+/** @internal */
+export declare const configuration: (options?: VolumeOptions, operation?: string) => Result.Result<{
+    options: {
+        readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
+        readonly maxEntries?: number;
+        readonly maxPendingOperations?: number;
+        readonly maxWatchEvents?: number;
+        readonly maxBytes?: ByteSize.ByteSize;
+        readonly maxFileBytes?: ByteSize.ByteSize;
+        readonly maxPathBytes?: ByteSize.ByteSize;
+    };
+    identity: (string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">) | undefined;
+    limits: Readonly<{
+        maxEntries: number | undefined;
+        maxBytes: ByteSize.ByteSize | undefined;
+        maxFileBytes: ByteSize.ByteSize;
+        maxPathBytes: ByteSize.ByteSize | undefined;
+        maxPendingOperations: number;
+        maxWatchEvents: number;
+    }>;
+}, import("../VfsError.js").ArgumentFailure>;
+/** @internal */
+export declare const fromOptions: (options?: VolumeOptions, operation?: string) => Result.Result<Readonly<{
+    maxEntries: number | undefined;
+    maxBytes: ByteSize.ByteSize | undefined;
+    maxFileBytes: ByteSize.ByteSize;
+    maxPathBytes: ByteSize.ByteSize | undefined;
+    maxPendingOperations: number;
+    maxWatchEvents: number;
+}>, import("../VfsError.js").ArgumentFailure>;
+/** @internal */
+export declare const fromStored: (stored: StoredLimits, runtime?: VolumeLimits) => Result.Result<Readonly<{
+    maxEntries: number | undefined;
+    maxBytes: ByteSize.ByteSize | undefined;
+    maxFileBytes: ByteSize.ByteSize;
+    maxPathBytes: ByteSize.ByteSize | undefined;
+    maxPendingOperations: number;
+    maxWatchEvents: number;
+}>, import("../VfsError.js").ArgumentFailure>;
+/** @internal */
+export declare const toStored: (limits: VolumeLimits) => StoredLimits;
+/** @internal */
+export declare const compatible: (stored: VolumeLimits, requested: VolumeLimits, identity: VolumeIdentity, requestedIdentity?: VolumeIdentity) => boolean;
+export {};
+//# sourceMappingURL=volumeLimits.d.ts.map

package/dist/internal/volumeLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumeLimits.d.ts","sourceRoot":"","sources":["../../src/internal/volumeLimits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,KAAK,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjE,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AAGtC,KAAK,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAM1C,gBAAgB;AAChB,eAAO,MAAM,QAAQ,EAAE,YAOrB,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,aAAa,aAAc,aAAa;;;;;;;;;;;;;;;;;;;4CAelD,CAAA;AAEH,gBAAgB;AAChB,eAAO,MAAM,WAAW,aAAc,aAAa;;;;;;;6CACyB,CAAA;AAE5E,gBAAgB;AAChB,eAAO,MAAM,UAAU,WAAY,YAAY,YAAW,YAAY;;;;;;;6CAerE,CAAA;AAED,gBAAgB;AAChB,eAAO,MAAM,QAAQ,WAAY,YAAY,KAAG,YAY/C,CAAA;AAKD,gBAAgB;AAChB,eAAO,MAAM,UAAU,WACb,YAAY,aACT,YAAY,YACb,cAAc,sBACJ,cAAc,KACjC,OAGkE,CAAA"}

package/dist/internal/volumeLimits.js

@@ -0,0 +1,63 @@
+import * as ByteSize from "effect/ByteSize";
+import * as Result from "effect/Result";
+import { VolumeOptions } from "../Volume.js";
+import { decodeConfiguration } from "./errors.js";
+import { MAX_FILE_BYTES } from "./volumeState.js";
+/** @internal */
+export const defaults = Object.freeze({
+    maxEntries: undefined,
+    maxBytes: undefined,
+    maxFileBytes: ByteSize.bytes(MAX_FILE_BYTES),
+    maxPathBytes: undefined,
+    maxPendingOperations: 64,
+    maxWatchEvents: 256
+});
+/** @internal */
+export const configuration = (options, operation = "make") => Result.map(decodeConfiguration(VolumeOptions, options === undefined ? {} : options, operation), (decoded) => ({
+    options: decoded,
+    identity: decoded.identity,
+    limits: Object.freeze({
+        maxEntries: decoded.maxEntries,
+        maxBytes: decoded.maxBytes,
+        maxFileBytes: decoded.maxFileBytes ?? defaults.maxFileBytes,
+        maxPathBytes: decoded.maxPathBytes,
+        maxPendingOperations: decoded.maxPendingOperations ?? defaults.maxPendingOperations,
+        maxWatchEvents: decoded.maxWatchEvents ?? defaults.maxWatchEvents
+    })
+}));
+/** @internal */
+export const fromOptions = (options, operation = "make") => Result.map(configuration(options, operation), (decoded) => decoded.limits);
+/** @internal */
+export const fromStored = (stored, runtime = defaults) => {
+    const options = {
+        maxPendingOperations: runtime.maxPendingOperations,
+        maxWatchEvents: runtime.maxWatchEvents
+    };
+    if (stored.maxEntries !== undefined)
+        options.maxEntries = stored.maxEntries;
+    if (stored.maxBytes !== undefined)
+        options.maxBytes = ByteSize.bytes(stored.maxBytes);
+    if (stored.maxFileBytes !== undefined)
+        options.maxFileBytes = ByteSize.bytes(stored.maxFileBytes);
+    if (stored.maxPathBytes !== undefined)
+        options.maxPathBytes = ByteSize.bytes(stored.maxPathBytes);
+    return fromOptions(options);
+};
+/** @internal */
+export const toStored = (limits) => {
+    const stored = {
+        maxFileBytes: ByteSize.toBigInt(limits.maxFileBytes)
+    };
+    if (limits.maxEntries !== undefined)
+        stored.maxEntries = limits.maxEntries;
+    if (limits.maxBytes !== undefined)
+        stored.maxBytes = ByteSize.toBigInt(limits.maxBytes);
+    if (limits.maxPathBytes !== undefined)
+        stored.maxPathBytes = ByteSize.toBigInt(limits.maxPathBytes);
+    return stored;
+};
+const sameSize = (left, right) => left === undefined || right === undefined ? left === right : ByteSize.toBigInt(left) === ByteSize.toBigInt(right);
+/** @internal */
+export const compatible = (stored, requested, identity, requestedIdentity) => stored.maxEntries === requested.maxEntries && sameSize(stored.maxBytes, requested.maxBytes) &&
+    sameSize(stored.maxFileBytes, requested.maxFileBytes) && sameSize(stored.maxPathBytes, requested.maxPathBytes) &&
+    (requestedIdentity === undefined || requestedIdentity === identity);

package/dist/internal/volumeState.d.ts

@@ -75,6 +75,8 @@ export declare const directoryMetadata: (ino: bigint, uid: number, gid: number,
 /** @internal */
 export declare const emptyRoot: (now: bigint) => Directory;
 /** @internal */
+export declare const emptyState: (now: bigint) => VolumeState;
+/** @internal */
 export declare const storedMetadata: (metadata: NodeMetadata) => StoredMetadata;
 /** @internal */
 export declare const reachableNodes: (state: VolumeState) => Effect.Effect<Node[], never, never>;

package/dist/internal/volumeState.d.ts.map

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

package/dist/internal/volumeState.js

@@ -63,6 +63,15 @@ export const emptyRoot = (now) => ({
     revision: 1n
 });
 /** @internal */
+export const emptyState = (now) => ({
+    inodes: InodeTable.set(InodeTable.empty(), ROOT_INO, emptyRoot(now)),
+    open: new Map(),
+    nextInode: Ino(2),
+    revision: 1n,
+    entries: 0,
+    usedBytes: 0n
+});
+/** @internal */
 export const storedMetadata = (metadata) => ({
     uid: metadata.uid,
     gid: metadata.gid,

package/dist/internal/watchHub.d.ts

@@ -10,15 +10,19 @@ export interface Coordinator {
  *
  * @internal
  */
-export interface Selection<A, C> {
+export interface Selection<A, C, E = never> {
     readonly includes: (event: A, context: C) => boolean;
+    readonly prepare?: (context: C) => void;
+    readonly project?: (event: A, context: C) => A | undefined;
+    readonly failure?: (context: C) => E | undefined;
+    readonly boundedTerminal?: boolean;
     readonly rescan: (context: C) => A;
     readonly settle?: (context: C) => Iterable<A> | undefined;
 }
 /** @internal */
 export interface WatchHub<A, C, E = never> {
     readonly publishUnsafe: (events: () => Iterable<A>, context: C) => void;
-    readonly subscribe: (select: Effect.Effect<Selection<A, C>, E>, afterSubscribe: Effect.Effect<void>) => Effect.Effect<Stream.Stream<A>, E, Scope.Scope>;
+    readonly subscribe: <F extends E = never>(select: Effect.Effect<Selection<A, C, F>, E>, afterSubscribe: Effect.Effect<void>) => Effect.Effect<Stream.Stream<A, F>, E, Scope.Scope>;
 }
 /** @internal */
 export declare const make: <A, C, E = never>(coordinate: Coordinator, capacity: number) => Effect.Effect<WatchHub<A, C, E>, never, never>;

package/dist/internal/watchHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watchHub.d.ts","sourceRoot":"","sources":["../../src/internal/watchHub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAClE;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAE7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAA;IACpD,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;IAElC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;CAC1D;AAED,gBAAgB;AAChB,MAAM,WAAW,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK;IACvC,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;IACvE,QAAQ,CAAC,SAAS,EAAE,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EACzC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CACrD;AAQD,gBAAgB;AAChB,eAAO,MAAM,IAAI,GAA+B,CAAC,EAAE,CAAC,EAAE,CAAC,sGAwFrD,CAAA"}
+{"version":3,"file":"watchHub.d.ts","sourceRoot":"","sources":["../../src/internal/watchHub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAClE;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK;IAExC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAA;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;IAElC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;CAC1D;AAED,gBAAgB;AAChB,MAAM,WAAW,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK;IACvC,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;IACvE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,KAAK,EACtC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5C,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CACxD;AAQD,gBAAgB;AAChB,eAAO,MAAM,IAAI,GAA+B,CAAC,EAAE,CAAC,EAAE,CAAC,sGAoHrD,CAAA"}

package/dist/internal/watchHub.js

@@ -1,3 +1,4 @@
+import * as Cause from "effect/Cause";
 import * as Effect from "effect/Effect";
 import * as Predicate from "effect/Predicate";
 import * as Queue from "effect/Queue";
@@ -17,20 +18,43 @@ export const make = Effect.fnUntraced(function* (coordinate, capacity) {
     const publishUnsafe = (events, context) => {
         if (subscribers.size === 0)
             return;
+        for (const subscriber of subscribers)
+            subscriber.selection.prepare?.(context);
         for (const event of events()) {
             for (const subscriber of subscribers) {
-                if (subscriber.selection.includes(event, context))
-                    offer(subscriber, event, context);
+                if (subscriber.selection.includes(event, context)) {
+                    const projected = subscriber.selection.project === undefined
+                        ? event
+                        : subscriber.selection.project(event, context);
+                    if (projected !== undefined)
+                        offer(subscriber, projected, context);
+                }
             }
         }
         for (const subscriber of subscribers) {
             const last = subscriber.selection.settle?.(context);
-            if (last === undefined)
+            const failure = subscriber.selection.failure?.(context);
+            if (last === undefined && failure === undefined)
                 continue;
-            for (const event of last)
-                Queue.offerUnsafe(subscriber.queue, event);
+            if (last !== undefined) {
+                if (subscriber.selection.boundedTerminal) {
+                    for (const event of last)
+                        offer(subscriber, event, context);
+                    if (subscriber.overflowed) {
+                        while (Queue.takeUnsafe(subscriber.queue) !== undefined) { /* Drain before replacing with Rescan. */ }
+                        Queue.offerUnsafe(subscriber.queue, subscriber.selection.rescan(context));
+                    }
+                }
+                else {
+                    for (const event of last)
+                        Queue.offerUnsafe(subscriber.queue, event);
+                }
+            }
             subscribers.delete(subscriber);
-            Queue.endUnsafe(subscriber.queue);
+            if (failure === undefined)
+                Queue.endUnsafe(subscriber.queue);
+            else
+                Queue.failCauseUnsafe(subscriber.queue, Cause.fail(failure));
         }
     };
     // Register cleanup before waiting for the volume, including when the scope closes during registration.
@@ -62,6 +86,7 @@ export const make = Effect.fnUntraced(function* (coordinate, capacity) {
             registered = created;
             return created;
         }));
+        // SAFETY: A subscription queue only receives failures from its own Selection<F>.
         return subscriber === undefined ? Stream.empty : Stream.fromEffectRepeat(Queue.take(subscriber.queue));
     });
     return { publishUnsafe, subscribe };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@effect-vfs/core",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "A runtime-neutral virtual filesystem core for Effect.",
   "homepage": "https://github.com/lloydrichards/effect-virtual-fs#readme",
   "bugs": {
@@ -22,7 +22,8 @@
     "build": "tsc --project tsconfig.build.json && tsc --project compatibility/node-next/tsconfig.json",
     "clean": "git clean -xdf .cache .turbo dist docs node_modules tsconfig.tsbuildinfo",
     "test": "bun --bun run vitest run --config ../../vitest.config.ts --project core",
-    "type-check": "tsc --noEmit && tsc --project contracts/tsconfig.json"
+    "type-check": "tsc --noEmit && tsc --project contracts/tsconfig.json && tsc --project tsconfig.benchmarks.json",
+    "benchmark": "bun --bun run vitest bench --run --config ../../vitest.config.ts --project 'core (bench)'"
   },
   "peerDependencies": {
     "effect": "^4.0.0"
@@ -32,7 +33,8 @@
     "@effect/platform-node-shared": "4.0.0",
     "@effect/vitest": "4.0.0",
     "@repo/config-typescript": "workspace:*",
-    "effect": "4.0.0"
+    "effect": "4.0.0",
+    "@types/node": "26.6.3"
   },
   "exports": {
     ".": {
@@ -87,6 +89,10 @@
       "types": "./dist/Snapshot.d.ts",
       "import": "./dist/Snapshot.js"
     },
+    "./Search": {
+      "types": "./dist/Search.d.ts",
+      "import": "./dist/Search.js"
+    },
     "./SnapshotDelta": {
       "types": "./dist/SnapshotDelta.d.ts",
       "import": "./dist/SnapshotDelta.js"