@effect-vfs/core 0.5.0 → 0.7.0

package/dist/VirtualFileSystemError.js

@@ -1,49 +0,0 @@
-/**
- * Tagged errors shared by the public filesystem API and its implementation.
- *
- * @since 0.1.0
- */
-import * as Data from "effect/Data";
-/**
- * An expected filesystem operation failure.
- *
- * The `code` distinguishes portable failures while `operation` names the action.
- * Byte paths are intentionally omitted from the formatted message.
- *
- * @example
- * ```ts
- * import { VirtualFileSystemError } from "@effect-vfs/core"
- *
- * const error = new VirtualFileSystemError.FsError({ code: "NotFound", operation: "readFile" })
- * console.log(error.code, error.message)
- * // NotFound readFile failed with NotFound
- * ```
- *
- * @category errors
- * @since 0.1.0
- */
-export class FsError extends Data.TaggedError("FsError") {
-    get message() {
-        return `${this.operation} failed with ${this.code}`;
-    }
-}
-/**
- * An invalid volume or caller option, identified by its field name.
- *
- * @example
- * ```ts
- * import { VirtualFileSystemError } from "@effect-vfs/core"
- *
- * const error = new VirtualFileSystemError.ConfigurationError({ field: "maxEntries" })
- * console.log(error.field, error.message)
- * // maxEntries Invalid option: maxEntries
- * ```
- *
- * @category errors
- * @since 0.1.0
- */
-export class ConfigurationError extends Data.TaggedError("ConfigurationError") {
-    get message() {
-        return `Invalid option: ${this.field}`;
-    }
-}

package/dist/internal/overlayContent.d.ts

@@ -1,15 +0,0 @@
-import type { Snapshot } from "../Snapshot.js";
-import * as Image from "./image.js";
-/** @internal */
-export interface Content {
-    readonly bytes: Uint8Array;
-}
-/** @internal */
-export declare const hasOverlayContents: (snapshot: Snapshot) => boolean;
-/** @internal */
-export declare const make: (bytes: Uint8Array) => Content;
-/** @internal */
-export declare const empty: () => Content;
-/** @internal */
-export declare const forOverlay: (snapshot: Snapshot, image: Image.Document) => ReadonlyMap<string, Content>;
-//# sourceMappingURL=overlayContent.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"overlayContent.d.ts","sourceRoot":"","sources":["../../src/internal/overlayContent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC,gBAAgB;AAChB,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B;AAID,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,KAAG,OAAwC,CAAA;AAEhG,gBAAgB;AAChB,eAAO,MAAM,IAAI,UAAW,UAAU,KAAG,OAAsB,CAAA;AAE/D,gBAAgB;AAChB,eAAO,MAAM,KAAK,QAAO,OAAkC,CAAA;AAG3D,gBAAgB;AAChB,eAAO,MAAM,UAAU,aAAc,QAAQ,SAAS,KAAK,CAAC,QAAQ,KAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAiBjG,CAAA"}

package/dist/internal/overlayContent.js

@@ -1,29 +0,0 @@
-// Immutable regular-file payloads shared by overlay workspaces.
-import * as Result from "effect/Result";
-import * as Schema from "effect/Schema";
-import { CanonicalBase64 } from "./canonicalBase64.js";
-import * as Image from "./image.js";
-const overlayContents = new WeakMap();
-/** @internal */
-export const hasOverlayContents = (snapshot) => overlayContents.has(snapshot);
-/** @internal */
-export const make = (bytes) => ({ bytes });
-/** @internal */
-export const empty = () => make(new Uint8Array(0));
-// The weak cache shares immutable payloads without extending the snapshot's lifetime.
-/** @internal */
-export const forOverlay = (snapshot, image) => {
-    const cached = overlayContents.get(snapshot);
-    if (cached !== undefined)
-        return cached;
-    const decoded = new Map();
-    for (const record of image.records) {
-        if (Image.Record.guards.file(record)) {
-            const bytes = Schema.decodeResult(CanonicalBase64.Bytes)(record.data);
-            if (Result.isSuccess(bytes))
-                decoded.set(record.id, make(bytes.success));
-        }
-    }
-    overlayContents.set(snapshot, decoded);
-    return decoded;
-};

package/dist/internal/stagedState.d.ts

@@ -1,22 +0,0 @@
-import * as Effect from "effect/Effect";
-import { FsError } from "./errors.js";
-/** @internal */
-export type CommitOutcome = "committed" | "rejected" | "unknown";
-/** @internal */
-export interface CommitProvider<State> {
-    /** Provides a gate-coordinated shutdown effect once staging is ready. */
-    readonly onReady?: (shutdown: Effect.Effect<void>) => void;
-    /** Checks and encodes a candidate before the commit boundary. Failure leaves the volume available. */
-    readonly prepare?: (candidate: State) => Effect.Effect<void, FsError>;
-    /** Classifies a candidate as committed, definitely rejected, or uncertain. */
-    readonly commit: (candidate: State) => Effect.Effect<CommitOutcome>;
-}
-/** @internal */
-export declare const makeStagedState: <State, Event = never>(initial: State, copy: (current: State) => Effect.Effect<State>, rawProvider: CommitProvider<State>, publish?: (candidate: State, events: ReadonlyArray<Event>) => void) => {
-    read: <A, E, R>(operation: string, inspect: (state: Readonly<State>) => Effect.Effect<A, E, R>) => Effect.Effect<A, E | FsError, R>;
-    mutate: <A, E, R>(operation: string, change: (candidate: State, emit: (event: Event) => void) => Effect.Effect<A, E, R>, onStorageFailure?: () => void) => Effect.Effect<A, E | FsError, R>;
-    coordinate: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
-    checkAvailable: (operation: string) => Effect.Effect<void, FsError, never>;
-    shutdown: Effect.Effect<void, never, never>;
-};
-//# sourceMappingURL=stagedState.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"stagedState.d.ts","sourceRoot":"","sources":["../../src/internal/stagedState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC,gBAAgB;AAChB,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAA;AAEhE,gBAAgB;AAChB,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;IAC1D,sGAAsG;IACtG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACrE,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;CACpE;AAED,gBAAgB;AAChB,eAAO,MAAM,eAAe,GAAI,KAAK,EAAE,KAAK,mBACjC,KAAK,QAER,CAAC,OAAO,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,eACjC,cAAc,CAAC,KAAK,CAAC,YACxB,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI;WAyBpD,CAAC,EAAE,CAAC,EAAE,CAAC,aAAa,MAAM,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAOrF,CAAC,EAAE,CAAC,EAAE,CAAC,aACV,MAAM,UACT,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,qBAC/D,MAAM,IAAI;iBAhBX,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gCAPxB,MAAM;;CA0E1C,CAAA"}

package/dist/internal/stagedState.js

@@ -1,62 +0,0 @@
-import * as Effect from "effect/Effect";
-import * as Exit from "effect/Exit";
-import * as Semaphore from "effect/Semaphore";
-import { FsError } from "./errors.js";
-/** @internal */
-export const makeStagedState = (initial, 
-// The copy must detach every mutable value that change can reach.
-copy, rawProvider, publish) => {
-    const gate = Semaphore.makeUnsafe(1);
-    const provider = {
-        ...rawProvider,
-        commit: (candidate) => Effect.suspend(() => rawProvider.commit(candidate))
-    };
-    let current = initial;
-    let available = true;
-    const checkAvailable = (operation) => Effect.suspend(() => available
-        ? Effect.void
-        : Effect.fail(new FsError({ code: "VolumeUnavailable", operation })));
-    const coordinate = (effect) => gate.withPermit(effect);
-    const shutdown = coordinate(Effect.sync(() => {
-        available = false;
-    }));
-    const read = (operation, inspect) => coordinate(Effect.gen(function* () {
-        yield* checkAvailable(operation);
-        return yield* inspect(current);
-    }));
-    const mutate = (operation, change, onStorageFailure) => coordinate(Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
-        yield* checkAvailable(operation);
-        const candidate = yield* restore(copy(current));
-        const events = [];
-        const value = yield* restore(change(candidate, (event) => events.push(event)));
-        if (provider.prepare !== undefined)
-            yield* restore(provider.prepare(candidate));
-        const committed = yield* Effect.exit(Effect.suspend(() => provider.commit(candidate)));
-        if (Exit.isFailure(committed)) {
-            available = false;
-            onStorageFailure?.();
-            return yield* new FsError({ code: "OutcomeUnknown", operation });
-        }
-        const outcome = committed.value;
-        if (outcome === "rejected") {
-            if (onStorageFailure !== undefined) {
-                available = false;
-                onStorageFailure();
-            }
-            return yield* new FsError({ code: "StorageRejected", operation });
-        }
-        if (outcome === "unknown") {
-            available = false;
-            onStorageFailure?.();
-            return yield* new FsError({ code: "OutcomeUnknown", operation });
-        }
-        current = candidate;
-        const published = yield* Effect.exit(Effect.sync(() => publish?.(candidate, events)));
-        if (Exit.isFailure(published)) {
-            available = false;
-            return yield* new FsError({ code: "OutcomeUnknown", operation });
-        }
-        return value;
-    })));
-    return { read, mutate, coordinate, checkAvailable, shutdown };
-};

package/dist/internal/testHooks.d.ts

@@ -1,20 +0,0 @@
-import type * as Effect from "effect/Effect";
-import type { Snapshot } from "../Snapshot.js";
-import type { Volume } from "../VirtualFileSystem.js";
-/** @internal */
-export interface ObservationHook {
-    readonly betweenSnapshotAndSummary: Effect.Effect<void>;
-}
-/** @internal */
-export declare const getObservationHook: (snapshot: Snapshot) => ObservationHook | undefined;
-/** @internal */
-export declare const setObservationHook: (snapshot: Snapshot, hook: ObservationHook) => () => void;
-/** @internal */
-export interface RegistrationHook {
-    readonly afterSubscribe: Effect.Effect<void>;
-}
-/** @internal */
-export declare const getRegistrationHook: (volume: Volume) => RegistrationHook | undefined;
-/** @internal */
-export declare const setRegistrationHook: (volume: Volume, hook: RegistrationHook) => () => void;
-//# sourceMappingURL=testHooks.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"testHooks.d.ts","sourceRoot":"","sources":["../../src/internal/testHooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErD,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACxD;AAID,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,KAAG,eAAe,GAAG,SAA2C,CAAA;AAErH,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,QAAQ,eAAe,KAAG,MAAM,IAMpF,CAAA;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC7C;AAID,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,WAAY,MAAM,KAAG,gBAAgB,GAAG,SAA0C,CAAA;AAElH,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,WAAY,MAAM,QAAQ,gBAAgB,KAAG,MAAM,IAMlF,CAAA"}

package/dist/internal/testHooks.js

@@ -1,23 +0,0 @@
-// Package-internal synchronization hooks for deterministic volume tests.
-const observationHooks = new WeakMap();
-/** @internal */
-export const getObservationHook = (snapshot) => observationHooks.get(snapshot);
-/** @internal */
-export const setObservationHook = (snapshot, hook) => {
-    observationHooks.set(snapshot, hook);
-    return () => {
-        if (observationHooks.get(snapshot) === hook)
-            observationHooks.delete(snapshot);
-    };
-};
-const registrationHooks = new WeakMap();
-/** @internal */
-export const getRegistrationHook = (volume) => registrationHooks.get(volume);
-/** @internal */
-export const setRegistrationHook = (volume, hook) => {
-    registrationHooks.set(volume, hook);
-    return () => {
-        if (registrationHooks.get(volume) === hook)
-            registrationHooks.delete(volume);
-    };
-};