@effect-vfs/core 0.9.0 → 0.10.0

package/dist/internal/tree.js

@@ -13,8 +13,10 @@ import { ENCODING_CHECK, imageFailure, isEncodingIssue, issueSite } from "./erro
 import { KeySecret, VolumeEpoch } from "./hex128.js";
 import { byteLimit, encodeLine, frame } from "./lines.js";
 import { StoredMetadata } from "./metadata.js";
-import { isNameBytes, MAX_NAME_BYTES, nameBytes, NUL_BYTE } from "./path.js";
-import { byIno, Ino, MAX_INO, reachableNodes, ROOT_INO, storedMetadata, WALK_YIELD_INTERVAL } from "./volumeState.js";
+import { Paths, State } from "./engine.js";
+import { reachableNodes, storedMetadata } from "./volumeState.js";
+const { isNameBytes, MAX_NAME_BYTES, nameBytes, NUL_BYTE } = Paths;
+const { byIno, Ino, MAX_INO, ROOT_INO, WALK_YIELD_INTERVAL } = State;
 const TreeIno = Schema.Int.check(Schema.isBetween({ minimum: ROOT_INO, maximum: MAX_INO }));
 const NaturalBigInt = Schema.String.check(Schema.isPattern(/^(0|[1-9][0-9]{0,127})$/, { [ENCODING_CHECK]: true })).pipe(Schema.decodeTo(Schema.BigInt, SchemaTransformation.bigintFromString));
 const TreeLink = Schema.Struct({ parent: TreeIno, name: CanonicalBase64.Encoded });

package/dist/internal/virtualFileSystem.d.ts

@@ -1,25 +1,25 @@
+/**
+ * Community volume assembly over the shared private filesystem engine.
+ * IDs, authenticated keys, snapshots, overlays, storage encoders and watch delivery stay here.
+ * @internal
+ */
 import * as ByteSize from "effect/ByteSize";
 import * as Crypto from "effect/Crypto";
 import * as Data from "effect/Data";
 import * as Effect from "effect/Effect";
 import type { CommitOutcome } from "../LiveVolume.js";
 import type { Snapshot } from "../Snapshot.js";
-import { type FsFailure } from "../VfsError.js";
-import type { OverlayVolume, Volume } from "../VirtualFileSystem.js";
-import { VfsError } from "./errors.js";
+import { VfsError } from "../VfsError.js";
+import type { FsFailure, OverlayVolume, Volume } from "../VirtualFileSystem.js";
+import * as Engine from "./engine.js";
 import * as LiveImage from "./liveImage.js";
 import { type ObservationEntry } from "./overlayDiff.js";
-import { type VolumeState } from "./volumeState.js";
+import { State } from "./engine.js";
+type VolumeState = State.VolumeState;
 /** @internal */
-export interface CommitProvider<State> {
-    readonly mode: "memory" | "durable";
-    readonly commit: (candidate: State) => Effect.Effect<CommitOutcome, FsFailure & {
-        readonly code: "StorageRejected";
-    }>;
-    readonly shutdown: Effect.Effect<void>;
-}
+export type CommitProvider<State> = Engine.CommitProvider<State>;
 /** @internal */
-export declare const memoryCommitProvider: CommitProvider<VolumeState>;
+export declare const memoryCommitProvider: Engine.CommitProvider<State.VolumeState>;
 type VolumeSource = {
     readonly _tag: "Empty";
 } | {
@@ -30,44 +30,10 @@ type VolumeSource = {
     readonly value: VolumeState;
 };
 /** @internal */
-export declare const VolumeSource: {
-    readonly $is: <Tag extends "Empty" | "Live" | "Restored">(tag: Tag) => (u: unknown) => u is Extract<{
-        readonly _tag: "Empty";
-    }, {
-        readonly _tag: Tag;
-    }> | Extract<{
-        readonly _tag: "Live";
-        readonly restored: LiveImage.Restored;
-    }, {
-        readonly _tag: Tag;
-    }> | Extract<{
-        readonly _tag: "Restored";
-        readonly value: VolumeState;
-    }, {
-        readonly _tag: Tag;
-    }>;
-    readonly $match: {
-        <Cases extends { readonly [Tag in "Empty" | "Live" | "Restored"]: (args: Extract<VolumeSource, {
-            readonly _tag: Tag;
-        }>) => any; }>(cases: Cases): (value: VolumeSource) => import("effect/Unify").Unify<ReturnType<Cases["Empty" | "Live" | "Restored"]>>;
-        <Cases extends { readonly [Tag in "Empty" | "Live" | "Restored"]: (args: Extract<VolumeSource, {
-            readonly _tag: Tag;
-        }>) => any; }>(value: VolumeSource, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Empty" | "Live" | "Restored"]>>;
-    };
-    readonly Empty: Data.TaggedEnum.ConstructorFrom<{
-        readonly _tag: "Empty";
-    }, "_tag">;
-    readonly Live: Data.TaggedEnum.ConstructorFrom<{
-        readonly _tag: "Live";
-        readonly restored: LiveImage.Restored;
-    }, "_tag">;
-    readonly Restored: Data.TaggedEnum.ConstructorFrom<{
-        readonly _tag: "Restored";
-        readonly value: VolumeState;
-    }, "_tag">;
-};
+export declare const VolumeSource: Data.TaggedEnum.Constructor<VolumeSource>;
 /** @internal */
-export declare const makeVolume: (source: VolumeSource, commitProvider: CommitProvider<VolumeState>, options?: {
+export declare const makeVolume: (source: VolumeSource, commitProvider: CommitProvider<State.VolumeState>, options?: {
+    readonly execution?: "cooperative" | "sync";
     readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
     readonly maxEntries?: number;
     readonly maxPendingOperations?: number;
@@ -88,6 +54,7 @@ export declare const makeVolume: (source: VolumeSource, commitProvider: CommitPr
 }>, import("../VfsError.js").ArgumentFailure | import("../VfsError.js").ImageFailure, Crypto.Crypto>;
 /** @internal */
 export declare const make: (options?: {
+    readonly execution?: "cooperative" | "sync";
     readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
     readonly maxEntries?: number;
     readonly maxPendingOperations?: number;
@@ -98,6 +65,7 @@ export declare const make: (options?: {
 } | undefined) => Effect.Effect<Volume, import("../VfsError.js").ArgumentFailure, Crypto.Crypto>;
 /** @internal */
 export declare const prepareEmptyLiveImage: (options?: {
+    readonly execution?: "cooperative" | "sync";
     readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
     readonly maxEntries?: number;
     readonly maxPendingOperations?: number;
@@ -110,6 +78,7 @@ export declare const prepareEmptyLiveImage: (options?: {
 }), Crypto.Crypto>;
 /** @internal */
 export declare const openImageVolume: (image: Uint8Array<ArrayBufferLike>, maxImageBytes: ByteSize.ByteSize, commit: (image: Uint8Array) => Effect.Effect<CommitOutcome>, durability?: "memory-only" | "survives-operating-system-crash" | "survives-power-loss" | "survives-process-crash" | undefined, options?: {
+    readonly execution?: "cooperative" | "sync";
     readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
     readonly maxEntries?: number;
     readonly maxPendingOperations?: number;
@@ -123,6 +92,7 @@ export declare const openImageVolume: (image: Uint8Array<ArrayBufferLike>, maxIm
 }>, import("../VfsError.js").ArgumentFailure | import("../VfsError.js").ImageFailure, Crypto.Crypto>;
 /** @internal */
 export declare const fromSnapshot: (snapshot: Snapshot, options?: {
+    readonly execution?: "cooperative" | "sync";
     readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
     readonly maxEntries?: number;
     readonly maxPendingOperations?: number;
@@ -133,6 +103,7 @@ export declare const fromSnapshot: (snapshot: Snapshot, options?: {
 } | undefined) => Effect.Effect<Volume, import("../VfsError.js").ArgumentFailure | import("../VfsError.js").ImageFailure, Crypto.Crypto>;
 /** @internal */
 export declare const makeOverlay: (base: Snapshot, options?: {
+    readonly execution?: "cooperative" | "sync";
     readonly identity?: string & import("effect/Brand").Brand<"@effect-vfs/core/VolumeIdentity">;
     readonly maxEntries?: number;
     readonly maxPendingOperations?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"virtualFileSystem.d.ts","sourceRoot":"","sources":["../../src/internal/virtualFileSystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAI3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AA2BvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,gBAAgB,CAAA;AAClE,OAAO,KAAK,EAQV,aAAa,EAEb,MAAM,EAIP,MAAM,yBAAyB,CAAA;AAiBhC,OAAO,EAQL,QAAQ,EACT,MAAM,aAAa,CAAA;AAKpB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C,OAAO,EAAkB,KAAK,gBAAgB,EAAyB,MAAM,kBAAkB,CAAA;AAmB/F,OAAO,EAeL,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAA;AAWzB,gBAAgB;AAChB,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,CAAC,CAAA;IACrH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACvC;AAED,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,WAAW,CAI3D,CAAA;AAsVF,KAAK,YAAY,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAE9D,gBAAgB;AAChB,eAAO,MAAM,YAAY;;uBALJ,OAAO;;;;uBACP,MAAM;2BAAqB,SAAS,CAAC,QAAQ;;;;uBAC7C,UAAU;wBAAkB,WAAW;;;;;;;;;;;;;uBAFvC,OAAO;;;uBACP,MAAM;2BAAqB,SAAS,CAAC,QAAQ;;;uBAC7C,UAAU;wBAAkB,WAAW;;CAGD,CAAA;AA2C3D,gBAAgB;AAChB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;oGAy3FtB,CAAA;AAED,gBAAgB;AAChB,eAAO,MAAM,IAAI;;;;;;;;gGAIf,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,qBAAqB;;;;;;;;;;kBAahC,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,eAAe,yFAGV,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;;;;;;;;;;;oGAyB3D,CAAA;AAeF,gBAAgB;AAChB,eAAO,MAAM,YAAY;;;;;;;;wIASxB,CAAA;AAED,gBAAgB;AAChB,eAAO,MAAM,WAAW;;;;;;;;+IAkCvB,CAAA"}
+{"version":3,"file":"virtualFileSystem.d.ts","sourceRoot":"","sources":["../../src/internal/virtualFileSystem.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAQvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAqB,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAU,SAAS,EAAmB,aAAa,EAAE,MAAM,EAAiB,MAAM,yBAAyB,CAAA;AAevH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAKrC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAE3C,OAAO,EAAkB,KAAK,gBAAgB,EAAyB,MAAM,kBAAkB,CAAA;AAE/F,OAAO,EAAiB,KAAK,EAAmB,MAAM,aAAa,CAAA;AAanE,KAAK,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;AAEpC,gBAAgB;AAChB,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;AAEhE,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,0CAA8B,CAAA;AAI/D,KAAK,YAAY,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAE9D,gBAAgB;AAChB,eAAO,MAAM,YAAY,2CAAkC,CAAA;AA0C3D,gBAAgB;AAChB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;oGAwQrB,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,IAAI;;;;;;;;;gGAIf,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,qBAAqB;;;;;;;;;;;kBAahC,CAAA;AAEF,gBAAgB;AAChB,eAAO,MAAM,eAAe,yFAGV,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;;;;;;;;;;;;oGA4B3D,CAAA;AAeF,gBAAgB;AAChB,eAAO,MAAM,YAAY;;;;;;;;;wIASxB,CAAA;AAED,gBAAgB;AAChB,eAAO,MAAM,WAAW;;;;;;;;;+IAoCvB,CAAA"}