@effect-vfs/core 0.8.0 → 0.10.0

package/dist/internal/tokenRegistry.d.ts

@@ -1,77 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Scope from "effect/Scope";
-import type { FsFailure } from "../VfsError.js";
-import type { DirectoryHandle, FileHandle, ObjectReference } from "../VirtualFileSystem.js";
-import type { OpContext } from "./errors.js";
-import type { Ino, Node } from "./volumeState.js";
-/** @internal */
-export type HandleLifecycle = {
-    readonly kind: "acquiring";
-} | {
-    readonly kind: "open";
-    readonly ino: Ino;
-} | {
-    readonly kind: "releasedPendingCommit";
-    readonly ino: Ino | undefined;
-} | {
-    readonly kind: "closed";
-};
-/** @internal */
-export interface HandleReference {
-    readonly volume: symbol;
-    lifecycle: HandleLifecycle;
-    scope: Scope.Closeable | undefined;
-}
-/** @internal */
-export interface FileReference extends HandleReference {
-    offset: bigint;
-    readonly access: "read" | "write" | "readWrite";
-    readonly append: boolean;
-}
-/** @internal */
-export type DirectoryReference = HandleReference;
-/** @internal */
-export type Token = ObjectReference | FileHandle | DirectoryHandle;
-/** @internal */
-export type Resolution = {
-    readonly kind: "unknown";
-} | {
-    readonly kind: "foreign";
-} | {
-    readonly kind: "stale";
-} | {
-    readonly kind: "live";
-    readonly node: Node;
-};
-/** @internal */
-export declare const inode: (reference: HandleReference) => Ino | undefined;
-/** @internal */
-export declare const isOpen: (reference: HandleReference) => boolean;
-/** @internal */
-export declare const publish: (reference: HandleReference, ino: Ino) => void;
-/** @internal */
-export declare const released: (reference: HandleReference) => void;
-/** @internal */
-export declare const release: <E, R>(reference: HandleReference, releaseInode: (ino: Ino) => Effect.Effect<void, E, R>, afterRelease: (action: () => void) => Effect.Effect<void, never, R>) => Effect.Effect<void, E, R>;
-/** @internal */
-export declare const closeReleasedScope: (reference: HandleReference) => Effect.Effect<void, never, never>;
-/** @internal */
-export declare const finalize: (reference: HandleReference, close: Effect.Effect<unknown, FsFailure>, fallback: Effect.Effect<void>) => Effect.Effect<void, never, never>;
-/** @internal */
-export declare const acquire: <A, E, R, ReleaseR, CoordinateR>(reference: HandleReference, coordinate: (acquire: Effect.Effect<A, E, R | ReleaseR>) => Effect.Effect<A, E | FsFailure, CoordinateR>, acquisition: Effect.Effect<A, E, R>, releaseAcquired: () => Effect.Effect<void, never, ReleaseR>, finalizer: Effect.Effect<void, never, never>) => Effect.Effect<A, E | FsFailure, CoordinateR | Scope.Scope>;
-/** @internal */
-export declare const nodeOrFail: (result: Resolution, addressing: "reference" | "handle", op: OpContext) => Effect.Effect<never, FsFailure, never> | Effect.Effect<Node, never, never>;
-/** @internal */
-export declare const make: (volume: symbol, get: (ino: Ino) => Effect.Effect<Node | undefined>) => {
-    resolve: (token: Token, addressing: "reference" | "handle" | "directory") => Effect.Effect<Resolution, never, never>;
-    resolveInode: (ino: Ino) => Effect.Effect<Resolution>;
-    referenceFor: (ino: Ino) => ObjectReference;
-    forget: (ino: Ino) => boolean;
-    file: (access: FileReference["access"], append: boolean) => FileReference;
-    directory: (ino?: Ino) => DirectoryReference;
-    registerFile: (handle: FileHandle, reference: FileReference) => WeakMap<object, FileReference>;
-    registerDirectory: (handle: DirectoryHandle, reference: DirectoryReference) => WeakMap<object, HandleReference>;
-};
-/** @internal */
-export type TokenRegistry = ReturnType<typeof make>;
-//# sourceMappingURL=tokenRegistry.d.ts.map

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

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

package/dist/internal/tokenRegistry.js

@@ -1,128 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Predicate from "effect/Predicate";
-import * as Scope from "effect/Scope";
-import { ObjectReferenceId } from "../Caller.js";
-// Shared across volumes so a genuine token from another registry is distinguishable from a forgery.
-const references = new WeakMap();
-const files = new WeakMap();
-const directories = new WeakMap();
-/** @internal */
-export const inode = (reference) => reference.lifecycle.kind === "open" || reference.lifecycle.kind === "releasedPendingCommit"
-    ? reference.lifecycle.ino
-    : undefined;
-/** @internal */
-export const isOpen = (reference) => reference.lifecycle.kind === "open";
-/** @internal */
-export const publish = (reference, ino) => {
-    reference.lifecycle = reference.lifecycle.kind === "releasedPendingCommit" || reference.lifecycle.kind === "closed"
-        ? { kind: "releasedPendingCommit", ino }
-        : { kind: "open", ino };
-};
-/** @internal */
-export const released = (reference) => {
-    reference.lifecycle = reference.lifecycle.kind === "acquiring" ||
-        (reference.lifecycle.kind === "releasedPendingCommit" && reference.lifecycle.ino === undefined)
-        ? { kind: "releasedPendingCommit", ino: undefined }
-        : { kind: "closed" };
-};
-// A release callback changes the engine's draft; publication may be immediate cleanup or after installation.
-/** @internal */
-export const release = Effect.fnUntraced(function* (reference, releaseInode, afterRelease) {
-    const ino = inode(reference);
-    yield* afterRelease(() => released(reference));
-    if (ino !== undefined)
-        yield* releaseInode(ino);
-});
-/** @internal */
-export const closeReleasedScope = (reference) => Effect.suspend(() => isOpen(reference) || reference.scope === undefined ? Effect.void : Scope.close(reference.scope, Exit.void));
-// The inode, rather than the open tag, decides whether a rerun must release a late publication.
-/** @internal */
-export const finalize = (reference, close, fallback) => Effect.uninterruptible(Effect.suspend(() => inode(reference) === undefined
-    ? Effect.sync(() => released(reference))
-    : Effect.ignore(close).pipe(Effect.andThen(Effect.suspend(() => inode(reference) === undefined ? Effect.void : fallback)))));
-// Register before waiting: a closed scope runs its finalizer immediately, and engine permits are not reentrant.
-/** @internal */
-export const acquire = Effect.fnUntraced(function* (reference, coordinate, acquisition, releaseAcquired, finalizer) {
-    const scope = yield* Scope.fork(yield* Effect.scope);
-    reference.scope = scope;
-    yield* Scope.addFinalizer(scope, finalizer);
-    const closed = () => Predicate.isTagged(scope.state, "Closed");
-    return yield* coordinate(Effect.suspend(() => closed() ? Effect.interrupt : acquisition).pipe(Effect.tap(() => Effect.suspend(() => closed() ? Effect.andThen(releaseAcquired(), Effect.interrupt) : Effect.void)))).pipe(Effect.tap(() => Effect.suspend(() => closed() ? Effect.interrupt : Effect.void)), Effect.onError(() => Effect.andThen(finalizer, Scope.close(scope, Exit.void))), Effect.onError(() => Effect.sync(() => {
-        if (reference.lifecycle.kind === "releasedPendingCommit" && reference.lifecycle.ino === undefined) {
-            reference.lifecycle = { kind: "closed" };
-        }
-    })));
-});
-/** @internal */
-export const nodeOrFail = (result, addressing, op) => {
-    switch (result.kind) {
-        case "live":
-            return Effect.succeed(result.node);
-        case "unknown":
-            return Effect.fail(op.fail(addressing === "reference" ? "InvalidReference" : "InvalidHandle"));
-        case "foreign":
-            return Effect.fail(op.fail(addressing === "reference" ? "ForeignReference" : "ForeignHandle"));
-        case "stale":
-            return Effect.fail(op.fail(addressing === "reference" ? "StaleReference" : "InvalidHandle"));
-    }
-};
-/** @internal */
-export const make = (volume, get) => {
-    const tokens = new Map();
-    const resolveInode = (ino) => Effect.map(get(ino), (node) => node === undefined || (node.kind === "directory" && node.metadata.nlink === 0)
-        ? { kind: "stale" }
-        : { kind: "live", node });
-    const resolveReference = (token) => Effect.suspend(() => {
-        const known = Predicate.isObject(token) ? references.get(token) : undefined;
-        if (known === undefined)
-            return Effect.succeed({ kind: "unknown" });
-        if (known.volume !== volume)
-            return Effect.succeed({ kind: "foreign" });
-        return resolveInode(known.ino);
-    });
-    const resolveHandle = (token, directoryOnly = false) => Effect.suspend(() => {
-        const known = Predicate.isObject(token)
-            ? directories.get(token) ?? (directoryOnly ? undefined : files.get(token))
-            : undefined;
-        if (known === undefined)
-            return Effect.succeed({ kind: "unknown" });
-        if (known.volume !== volume)
-            return Effect.succeed({ kind: "foreign" });
-        if (!isOpen(known))
-            return Effect.succeed({ kind: "stale" });
-        const ino = inode(known);
-        return ino === undefined
-            ? Effect.succeed({ kind: "stale" })
-            : Effect.map(get(ino), (node) => node === undefined ? { kind: "stale" } : { kind: "live", node });
-    });
-    return {
-        resolve: (token, addressing) => addressing === "reference" ? resolveReference(token) : resolveHandle(token, addressing === "directory"),
-        resolveInode,
-        referenceFor: (ino) => {
-            const existing = tokens.get(ino);
-            if (existing !== undefined)
-                return existing;
-            const reference = Object.freeze({ [ObjectReferenceId]: true });
-            references.set(reference, { volume, ino });
-            tokens.set(ino, reference);
-            return reference;
-        },
-        forget: (ino) => tokens.delete(ino),
-        file: (access, append) => ({
-            volume,
-            lifecycle: { kind: "acquiring" },
-            scope: undefined,
-            offset: 0n,
-            access,
-            append
-        }),
-        directory: (ino) => ({
-            volume,
-            lifecycle: ino === undefined ? { kind: "acquiring" } : { kind: "open", ino },
-            scope: undefined
-        }),
-        registerFile: (handle, reference) => files.set(handle, reference),
-        registerDirectory: (handle, reference) => directories.set(handle, reference)
-    };
-};

package/dist/internal/turnstile.d.ts

@@ -1,8 +0,0 @@
-import * as Effect from "effect/Effect";
-/** @internal */
-export interface Turnstile {
-    readonly withTurn: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
-}
-/** @internal */
-export declare const makeTurnstile: () => Turnstile;
-//# sourceMappingURL=turnstile.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"turnstile.d.ts","sourceRoot":"","sources":["../../src/internal/turnstile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAIvC,gBAAgB;AAChB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CACvF;AASD,gBAAgB;AAChB,eAAO,MAAM,aAAa,QAAO,SAkDhC,CAAA"}

package/dist/internal/turnstile.js

@@ -1,43 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-// A Semaphore can let a newcomer overtake a scheduled waiter. Transfer ownership before scheduling the oldest waiter.
-/** @internal */
-export const makeTurnstile = () => {
-    let held = false;
-    const waiting = [];
-    const release = () => {
-        const next = waiting.shift();
-        if (next === undefined) {
-            held = false;
-            return;
-        }
-        next.granted = true;
-        next.dispatcher.scheduleTask(() => next.wake?.(), 0);
-    };
-    const waitFor = (ticket) => Effect.callback((resume) => {
-        if (ticket.granted)
-            return resume(Effect.void);
-        ticket.wake = () => resume(Effect.void);
-    });
-    return {
-        // Check ticket ownership after interruption so a granted turn is released rather than stranded.
-        withTurn: (effect) => Effect.uninterruptibleMask((restore) => Effect.withFiber((fiber) => {
-            const run = Effect.ensuring(restore(effect), Effect.sync(release));
-            if (!held) {
-                held = true;
-                return run;
-            }
-            const ticket = { dispatcher: fiber.currentDispatcher, granted: false, wake: undefined };
-            waiting.push(ticket);
-            return Effect.flatMap(Effect.exit(restore(waitFor(ticket))), (waited) => {
-                if (Exit.isSuccess(waited))
-                    return run;
-                if (ticket.granted)
-                    release();
-                else
-                    waiting.splice(waiting.indexOf(ticket), 1);
-                return Effect.failCause(waited.cause);
-            });
-        }))
-    };
-};