@decohere/testing 0.0.1-dev.126 → 0.0.1-dev.5

package/README.md

@@ -31,4 +31,4 @@ beforeEach(() => {
 });
 ```
 
-`vitest` and `memfs` are peer dependencies: install them in the project that runs the tests ([ADR 0017](../../docs/adr/0017-dependency-manifests-from-imports.md)).
+`vitest` and `memfs` should be peer dependencies; the dependency sync can't declare peers yet ([#683](https://github.com/typesmiths/decohere/issues/683)).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/testing",
-  "version": "0.0.1-dev.126",
+  "version": "0.0.1-dev.5",
   "description": "Test helpers for Decohere code under Vitest: memfs file systems, a mock logger, constructor spies that keep DI metadata.",
   "keywords": [
     "typescript",
@@ -9,15 +9,6 @@
     "memfs",
     "decohere"
   ],
-  "homepage": "https://github.com/typesmiths/decohere/tree/main/projects/testing#readme",
-  "bugs": {
-    "url": "https://github.com/typesmiths/decohere/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/typesmiths/decohere.git",
-    "directory": "projects/testing"
-  },
   "license": "ISC",
   "author": "Typesmiths",
   "type": "module",
@@ -33,10 +24,9 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/core": "0.0.1-dev.126"
+    "@decohere/core": "0.0.1-dev.5"
   },
-  "devDependencies": {},
-  "peerDependencies": {
+  "devDependencies": {
     "memfs": "^4.17.0",
     "vitest": "^3.2.6"
   }

package/{es6/src/flush-promises.js → src/flush-promises.ts}

@@ -1,6 +1,7 @@
 var scheduler = typeof setImmediate === "function" ? setImmediate : setTimeout;
+
 export function flushPromises() {
-    return new Promise((resolve)=>{
-        scheduler(resolve);
-    });
+	return new Promise((resolve) => {
+		scheduler(resolve);
+	});
 }

package/{es6/src/glob-with-memfs.js → src/glob-with-memfs.ts}

@@ -1,4 +1,5 @@
 import { fs } from "memfs";
+
 // Wraps a real `glob` module so all file-system access is routed through memfs.
 //
 // Why this exists:
@@ -7,14 +8,18 @@ import { fs } from "memfs";
 //   `glob` inside helper modules can trigger initialization-order issues.
 // - Passing the already-loaded `actual` module keeps the helper pure and
 //   hoist-safe while still allowing us to inject memfs.
-export function withMemfsFsForGlob(actual) {
-    // Preserve all module exports, overriding only `glob` to force `{ fs: memfs }`.
-    const glob = (pattern, options)=>actual.glob(pattern, {
-            ...options,
-            fs
-        });
-    return {
-        ...actual,
-        glob
-    };
+export function withMemfsFsForGlob<
+	TGlobModule extends { glob: (...args: unknown[]) => unknown },
+>(actual: TGlobModule): TGlobModule {
+	// Preserve all module exports, overriding only `glob` to force `{ fs: memfs }`.
+	const glob = ((pattern: string | string[], options?: unknown) =>
+		(actual.glob as (...args: unknown[]) => unknown)(pattern, {
+			...(options as Record<string, unknown> | undefined),
+			fs,
+		})) as TGlobModule["glob"];
+
+	return {
+		...actual,
+		glob,
+	};
 }

package/src/memfs.ts

@@ -0,0 +1,28 @@
+import { fs, vol } from "memfs";
+
+export function resetMemfs(): void {
+	vol.reset();
+}
+
+export function seedMemfs(files: Record<string, string>): void {
+	vol.fromJSON(files);
+}
+
+export function createTestFile(filePath: string, content: string | Buffer): void {
+	fs.mkdirSync(filePath.substring(0, filePath.lastIndexOf("/")), { recursive: true });
+	fs.writeFileSync(filePath, content);
+}
+
+export async function readFile(filePath: string): Promise<string> {
+	const response = (await fs.promises.readFile(filePath, "utf8")) as string;
+	return response;
+}
+
+export function fileExists(filePath: string): boolean {
+	try {
+		vol.statSync(filePath);
+		return true;
+	} catch {
+		return false;
+	}
+}

package/src/mock-logger.ts

@@ -0,0 +1,42 @@
+import { vi } from "vitest";
+
+export type LoggerMethod = (msg: string | number | object, ...args: unknown[]) => void;
+
+export type TestLogger = {
+	fatal: LoggerMethod;
+	error: LoggerMethod;
+	warn: LoggerMethod;
+	info: LoggerMethod;
+	debug: LoggerMethod;
+	trace: LoggerMethod;
+	isLevelEnabled(level: string): boolean;
+	readonly currentLevel: string;
+	readonly logLevels: Record<string, number>;
+};
+
+const DefaultLogLevels: Record<string, number> = {
+	fatal: 60,
+	error: 50,
+	warn: 40,
+	info: 30,
+	debug: 20,
+	trace: 10,
+};
+
+export function createMockLogger(): TestLogger {
+	return {
+		error: vi.fn(),
+		info: vi.fn(),
+		warn: vi.fn(),
+		debug: vi.fn(),
+		trace: vi.fn(),
+		fatal: vi.fn(),
+		isLevelEnabled: vi.fn().mockReturnValue(true),
+		get currentLevel() {
+			return "info";
+		},
+		get logLevels() {
+			return DefaultLogLevels;
+		},
+	};
+}

package/{types/src/spy-on-constructor.d.ts → src/spy-on-constructor.ts}

@@ -1,5 +1,6 @@
 import { vi } from "vitest";
 import type { Constructable } from "@decohere/core/reflection";
+
 /**
  * Creates a Proxy around a class constructor that intercepts `new` calls,
  * records arguments via a spy, and delegates to the real constructor.
@@ -15,7 +16,18 @@ import type { Constructable } from "@decohere/core/reflection";
  * // use SpiedService in place of MyService when wiring the container
  * expect(spy).toHaveBeenCalledWith(expect.any(ExpectedDependency));
  */
-export declare function spyOnConstructor<T extends Constructable>(Target: T): {
-    spy: ReturnType<typeof vi.fn>;
-    Proxy: T;
-};
+export function spyOnConstructor<T extends Constructable>(
+	Target: T,
+): { spy: ReturnType<typeof vi.fn>; Proxy: T } {
+	const spy = vi.fn();
+	const ProxiedTarget = new Proxy(Target, {
+		construct(Ctor, args) {
+			spy(...args);
+			return Reflect.construct(Ctor, args);
+		},
+	});
+	for (const key of Reflect.getMetadataKeys(Target)) {
+		Reflect.defineMetadata(key, Reflect.getMetadata(key, Target), ProxiedTarget);
+	}
+	return { spy, Proxy: ProxiedTarget as T };
+}

package/LICENSE

@@ -1,15 +0,0 @@
-ISC License
-
-Copyright (c) 2025-2026 Typesmiths
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/commonjs/src/flush-promises.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "flushPromises", {
-    enumerable: true,
-    get: function() {
-        return flushPromises;
-    }
-});
-var scheduler = typeof setImmediate === "function" ? setImmediate : setTimeout;
-function flushPromises() {
-    return new Promise((resolve)=>{
-        scheduler(resolve);
-    });
-}

package/commonjs/src/glob-with-memfs.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "withMemfsFsForGlob", {
-    enumerable: true,
-    get: function() {
-        return withMemfsFsForGlob;
-    }
-});
-const _memfs = require("memfs");
-function withMemfsFsForGlob(actual) {
-    // Preserve all module exports, overriding only `glob` to force `{ fs: memfs }`.
-    const glob = (pattern, options)=>actual.glob(pattern, {
-            ...options,
-            fs: _memfs.fs
-        });
-    return {
-        ...actual,
-        glob
-    };
-}

package/commonjs/src/index.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./flush-promises.js"), exports);
-_export_star(require("./glob-with-memfs.js"), exports);
-_export_star(require("./memfs.js"), exports);
-_export_star(require("./mock-logger.js"), exports);
-_export_star(require("./spy-on-constructor.js"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/commonjs/src/memfs.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get createTestFile () {
-        return createTestFile;
-    },
-    get fileExists () {
-        return fileExists;
-    },
-    get readFile () {
-        return readFile;
-    },
-    get resetMemfs () {
-        return resetMemfs;
-    },
-    get seedMemfs () {
-        return seedMemfs;
-    }
-});
-const _memfs = require("memfs");
-function resetMemfs() {
-    _memfs.vol.reset();
-}
-function seedMemfs(files) {
-    _memfs.vol.fromJSON(files);
-}
-function createTestFile(filePath, content) {
-    _memfs.fs.mkdirSync(filePath.substring(0, filePath.lastIndexOf("/")), {
-        recursive: true
-    });
-    _memfs.fs.writeFileSync(filePath, content);
-}
-async function readFile(filePath) {
-    const response = await _memfs.fs.promises.readFile(filePath, "utf8");
-    return response;
-}
-function fileExists(filePath) {
-    try {
-        _memfs.vol.statSync(filePath);
-        return true;
-    } catch  {
-        return false;
-    }
-}

package/commonjs/src/mock-logger.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "createMockLogger", {
-    enumerable: true,
-    get: function() {
-        return createMockLogger;
-    }
-});
-const _vitest = require("vitest");
-const DefaultLogLevels = {
-    fatal: 60,
-    error: 50,
-    warn: 40,
-    info: 30,
-    debug: 20,
-    trace: 10
-};
-function createMockLogger() {
-    const logger = {
-        error: _vitest.vi.fn(),
-        info: _vitest.vi.fn(),
-        warn: _vitest.vi.fn(),
-        debug: _vitest.vi.fn(),
-        trace: _vitest.vi.fn(),
-        fatal: _vitest.vi.fn(),
-        isLevelEnabled: _vitest.vi.fn().mockReturnValue(true),
-        child: _vitest.vi.fn(()=>logger),
-        get currentLevel () {
-            return "info";
-        },
-        get logLevels () {
-            return DefaultLogLevels;
-        }
-    };
-    return logger;
-}

package/commonjs/src/spy-on-constructor.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "spyOnConstructor", {
-    enumerable: true,
-    get: function() {
-        return spyOnConstructor;
-    }
-});
-const _vitest = require("vitest");
-function spyOnConstructor(Target) {
-    const spy = _vitest.vi.fn();
-    const ProxiedTarget = new Proxy(Target, {
-        construct (Ctor, args) {
-            spy(...args);
-            return Reflect.construct(Ctor, args);
-        }
-    });
-    for (const key of Reflect.getMetadataKeys(Target)){
-        Reflect.defineMetadata(key, Reflect.getMetadata(key, Target), ProxiedTarget);
-    }
-    return {
-        spy,
-        Proxy: ProxiedTarget
-    };
-}

package/es6/src/memfs.js

@@ -1,25 +0,0 @@
-import { fs, vol } from "memfs";
-export function resetMemfs() {
-    vol.reset();
-}
-export function seedMemfs(files) {
-    vol.fromJSON(files);
-}
-export function createTestFile(filePath, content) {
-    fs.mkdirSync(filePath.substring(0, filePath.lastIndexOf("/")), {
-        recursive: true
-    });
-    fs.writeFileSync(filePath, content);
-}
-export async function readFile(filePath) {
-    const response = await fs.promises.readFile(filePath, "utf8");
-    return response;
-}
-export function fileExists(filePath) {
-    try {
-        vol.statSync(filePath);
-        return true;
-    } catch  {
-        return false;
-    }
-}

package/es6/src/mock-logger.js

@@ -1,28 +0,0 @@
-import { vi } from "vitest";
-const DefaultLogLevels = {
-    fatal: 60,
-    error: 50,
-    warn: 40,
-    info: 30,
-    debug: 20,
-    trace: 10
-};
-/** `child` returns the same mock, so calls on a child are asserted on the parent. */ export function createMockLogger() {
-    const logger = {
-        error: vi.fn(),
-        info: vi.fn(),
-        warn: vi.fn(),
-        debug: vi.fn(),
-        trace: vi.fn(),
-        fatal: vi.fn(),
-        isLevelEnabled: vi.fn().mockReturnValue(true),
-        child: vi.fn(()=>logger),
-        get currentLevel () {
-            return "info";
-        },
-        get logLevels () {
-            return DefaultLogLevels;
-        }
-    };
-    return logger;
-}

package/es6/src/spy-on-constructor.js

@@ -1,31 +0,0 @@
-import { vi } from "vitest";
-/**
- * Creates a Proxy around a class constructor that intercepts `new` calls,
- * records arguments via a spy, and delegates to the real constructor.
- *
- * Use this to assert what was injected into a class by a DI container
- * (e.g. Container) without changing actual behavior.
- *
- * The proxy copies all `reflect-metadata` entries from the original class
- * so that DI metadata (`design:paramtypes`) remains intact.
- *
- * @example
- * const { spy, Proxy: SpiedService } = spyOnConstructor(MyService);
- * // use SpiedService in place of MyService when wiring the container
- * expect(spy).toHaveBeenCalledWith(expect.any(ExpectedDependency));
- */ export function spyOnConstructor(Target) {
-    const spy = vi.fn();
-    const ProxiedTarget = new Proxy(Target, {
-        construct (Ctor, args) {
-            spy(...args);
-            return Reflect.construct(Ctor, args);
-        }
-    });
-    for (const key of Reflect.getMetadataKeys(Target)){
-        Reflect.defineMetadata(key, Reflect.getMetadata(key, Target), ProxiedTarget);
-    }
-    return {
-        spy,
-        Proxy: ProxiedTarget
-    };
-}

package/types/src/flush-promises.d.ts

@@ -1 +0,0 @@
-export declare function flushPromises(): Promise<unknown>;

package/types/src/glob-with-memfs.d.ts

@@ -1,3 +0,0 @@
-export declare function withMemfsFsForGlob<TGlobModule extends {
-    glob: (...args: unknown[]) => unknown;
-}>(actual: TGlobModule): TGlobModule;

package/types/src/index.d.ts

@@ -1,5 +0,0 @@
-export * from "./flush-promises.js";
-export * from "./glob-with-memfs.js";
-export * from "./memfs.js";
-export * from "./mock-logger.js";
-export * from "./spy-on-constructor.js";

package/types/src/memfs.d.ts

@@ -1,5 +0,0 @@
-export declare function resetMemfs(): void;
-export declare function seedMemfs(files: Record<string, string>): void;
-export declare function createTestFile(filePath: string, content: string | Buffer): void;
-export declare function readFile(filePath: string): Promise<string>;
-export declare function fileExists(filePath: string): boolean;

package/types/src/mock-logger.d.ts

@@ -1,15 +0,0 @@
-export type LoggerMethod = (msg: string | number | object, ...args: unknown[]) => void;
-export type TestLogger = {
-    fatal: LoggerMethod;
-    error: LoggerMethod;
-    warn: LoggerMethod;
-    info: LoggerMethod;
-    debug: LoggerMethod;
-    trace: LoggerMethod;
-    isLevelEnabled(level: string): boolean;
-    child(fields: Record<string, unknown>): TestLogger;
-    readonly currentLevel: string;
-    readonly logLevels: Record<string, number>;
-};
-/** `child` returns the same mock, so calls on a child are asserted on the parent. */
-export declare function createMockLogger(): TestLogger;