@projitect/test-kit 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kapil Easwar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { Effect, Layer } from "effect";
+import { BlueprintFileSystem } from "@projitect/core";
+/**
+ * Build a fresh in-memory `BlueprintFileSystem` Layer seeded with the given files.
+ * Use it inside `it.effect(...)` tests:
+ *
+ *   it.effect("creates a region", () =>
+ *     myBlueprint.plan.pipe(
+ *       Effect.provide(makeInMemoryLayer({ ".gitignore": "" }))
+ *     )
+ *   )
+ *
+ * Reads outside the seeded set return `FsReadFailed`; permission checks are skipped (this is a
+ * unit-test fixture, not the production permission gate).
+ */
+export declare const makeInMemoryLayer: (initial?: Readonly<Record<string, string>>) => Layer.Layer<BlueprintFileSystem>;
+/**
+ * Inspect helper for tests: read all paths currently held by an in-memory layer. Useful for
+ * snapshot-style assertions about what a blueprint wrote.
+ */
+export declare const dumpFs: (layer: Layer.Layer<BlueprintFileSystem>) => Effect.Effect<Readonly<Record<string, string>>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,mBAAmB,EAAU,MAAM,iBAAiB,CAAA;AAG7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,KAC7C,KAAK,CAAC,KAAK,CAAC,mBAAmB,CA2DjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,GACjB,OAAO,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,KACtC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAc9C,CAAA"}

package/dist/index.js

@@ -0,0 +1,73 @@
+import { Effect, Layer } from "effect";
+import { BlueprintFileSystem, Errors } from "@projitect/core";
+/**
+ * Build a fresh in-memory `BlueprintFileSystem` Layer seeded with the given files.
+ * Use it inside `it.effect(...)` tests:
+ *
+ *   it.effect("creates a region", () =>
+ *     myBlueprint.plan.pipe(
+ *       Effect.provide(makeInMemoryLayer({ ".gitignore": "" }))
+ *     )
+ *   )
+ *
+ * Reads outside the seeded set return `FsReadFailed`; permission checks are skipped (this is a
+ * unit-test fixture, not the production permission gate).
+ */
+export const makeInMemoryLayer = (initial = {}) => {
+    const state = new Map(Object.entries(initial));
+    const shape = {
+        readFile: (path) => Effect.suspend(() => {
+            const v = state.get(path);
+            return v === undefined
+                ? Effect.fail(new Errors.FsReadFailed({
+                    id: "pjt.fs.read-failed",
+                    path,
+                    cause: "ENOENT",
+                    message: `In-memory FS: no file at ${path}`,
+                }))
+                : Effect.succeed(v);
+        }),
+        writeFile: (path, content) => Effect.sync(() => {
+            state.set(path, content);
+        }),
+        exists: (path) => Effect.sync(() => state.has(path)),
+        remove: (path) => Effect.suspend(() => {
+            const prefix = `${path}/`;
+            return !state.has(path) && Array.from(state.keys()).some((k) => k.startsWith(prefix))
+                ? Effect.fail(new Errors.FsWriteFailed({
+                    id: "pjt.fs.write-failed",
+                    path,
+                    cause: "EISDIR",
+                    message: `In-memory FS: ${path} is a directory`,
+                }))
+                : Effect.sync(() => {
+                    state.delete(path);
+                });
+        }),
+        removeEmptyDir: (path) => Effect.suspend(() => {
+            const prefix = `${path}/`;
+            return Array.from(state.keys()).some((k) => k.startsWith(prefix))
+                ? Effect.fail(new Errors.FsWriteFailed({
+                    id: "pjt.fs.write-failed",
+                    path,
+                    cause: "ENOTEMPTY",
+                    message: `In-memory FS: ${path} is not empty`,
+                }))
+                : Effect.void;
+        }),
+        mkdir: (_path) => Effect.void,
+        listDir: (prefix) => Effect.sync(() => Array.from(state.keys()).filter((k) => k.startsWith(prefix))),
+    };
+    return Layer.succeed(BlueprintFileSystem, shape);
+};
+/**
+ * Inspect helper for tests: read all paths currently held by an in-memory layer. Useful for
+ * snapshot-style assertions about what a blueprint wrote.
+ */
+export const dumpFs = (layer) => Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem;
+    const keys = yield* fs.listDir("");
+    const entries = yield* Effect.forEach(keys, (k) => fs.readFile(k).pipe(Effect.map((v) => [k, v]), Effect.orElseSucceed(() => [k, ""])));
+    return Object.fromEntries(entries);
+}).pipe(Effect.provide(layer), Effect.orElseSucceed(() => ({})));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@projitect/test-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.1",
+  "description": "Testing helpers for blueprint authors — in-memory BlueprintFileSystem Layer, ChangeSet snapshot helpers.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/projitect/projitect.git",
+    "directory": "packages/test-kit"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/*.tsbuildinfo"
+  ],
+  "devDependencies": {
+    "effect": "4.0.0-rc.111",
+    "typescript": "5.9.3",
+    "@projitect/core": "1.0.1"
+  },
+  "peerDependencies": {
+    "effect": "4.0.0-rc.111",
+    "@projitect/core": "1.0.1"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "build:clean": "tsc --build --clean",
+    "tc": "tsc --build"
+  }
 }

package/src/index.ts

@@ -0,0 +1,101 @@
+import { Effect, Layer } from "effect"
+import { BlueprintFileSystem, Errors } from "@projitect/core"
+import type { BlueprintFileSystemShape } from "@projitect/core"
+
+/**
+ * Build a fresh in-memory `BlueprintFileSystem` Layer seeded with the given files.
+ * Use it inside `it.effect(...)` tests:
+ *
+ *   it.effect("creates a region", () =>
+ *     myBlueprint.plan.pipe(
+ *       Effect.provide(makeInMemoryLayer({ ".gitignore": "" }))
+ *     )
+ *   )
+ *
+ * Reads outside the seeded set return `FsReadFailed`; permission checks are skipped (this is a
+ * unit-test fixture, not the production permission gate).
+ */
+export const makeInMemoryLayer = (
+  initial: Readonly<Record<string, string>> = {},
+): Layer.Layer<BlueprintFileSystem> => {
+  const state = new Map<string, string>(Object.entries(initial))
+
+  const shape: BlueprintFileSystemShape = {
+    readFile: (path) =>
+      Effect.suspend(() => {
+        const v = state.get(path)
+        return v === undefined
+          ? Effect.fail(
+              new Errors.FsReadFailed({
+                id: "pjt.fs.read-failed",
+                path,
+                cause: "ENOENT",
+                message: `In-memory FS: no file at ${path}`,
+              }),
+            )
+          : Effect.succeed(v)
+      }),
+    writeFile: (path, content) =>
+      Effect.sync(() => {
+        state.set(path, content)
+      }),
+    exists: (path) => Effect.sync(() => state.has(path)),
+    remove: (path) =>
+      Effect.suspend(() => {
+        const prefix = `${path}/`
+        return !state.has(path) && Array.from(state.keys()).some((k) => k.startsWith(prefix))
+          ? Effect.fail(
+              new Errors.FsWriteFailed({
+                id: "pjt.fs.write-failed",
+                path,
+                cause: "EISDIR",
+                message: `In-memory FS: ${path} is a directory`,
+              }),
+            )
+          : Effect.sync(() => {
+              state.delete(path)
+            })
+      }),
+    removeEmptyDir: (path) =>
+      Effect.suspend(() => {
+        const prefix = `${path}/`
+        return Array.from(state.keys()).some((k) => k.startsWith(prefix))
+          ? Effect.fail(
+              new Errors.FsWriteFailed({
+                id: "pjt.fs.write-failed",
+                path,
+                cause: "ENOTEMPTY",
+                message: `In-memory FS: ${path} is not empty`,
+              }),
+            )
+          : Effect.void
+      }),
+    mkdir: (_path) => Effect.void,
+    listDir: (prefix) =>
+      Effect.sync(() => Array.from(state.keys()).filter((k) => k.startsWith(prefix))),
+  }
+
+  return Layer.succeed(BlueprintFileSystem, shape)
+}
+
+/**
+ * Inspect helper for tests: read all paths currently held by an in-memory layer. Useful for
+ * snapshot-style assertions about what a blueprint wrote.
+ */
+export const dumpFs = (
+  layer: Layer.Layer<BlueprintFileSystem>,
+): Effect.Effect<Readonly<Record<string, string>>> =>
+  Effect.gen(function* () {
+    const fs = yield* BlueprintFileSystem
+    const keys = yield* fs.listDir("")
+    const entries = yield* Effect.forEach(keys, (k) =>
+      fs.readFile(k).pipe(
+        Effect.map((v) => [k, v] as const),
+        Effect.orElseSucceed(() => [k, ""] as const),
+      ),
+    )
+    return Object.fromEntries(entries)
+  }).pipe(
+    Effect.provide(layer),
+    Effect.orElseSucceed(() => ({})),
+  )

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.