@effect-vfs/core 0.8.0 → 0.9.0

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.8.0",
+  "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": {
     ".": {