@jamesaphoenix/tx-test-utils 0.4.2

package/dist/mocks/ast-grep.mock.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Mock AstGrepService for testing.
+ *
+ * Provides configurable mock AstGrepService with symbol fixtures,
+ * import fixtures, pattern match fixtures, and failure injection
+ * for testing services that depend on ast-grep code intelligence.
+ *
+ * Note: Uses inline types until AstGrepService is exported from @tx/core (tx-cf0f3c40).
+ *
+ * @module @tx/test-utils/mocks/ast-grep
+ */
+import { Context, Effect, Layer } from "effect";
+/**
+ * Symbol kind - one of the valid code construct types.
+ */
+export type MockSymbolKind = "function" | "class" | "interface" | "type" | "const" | "variable" | "method" | "struct" | "enum" | "trait" | "module";
+/**
+ * Information about an extracted symbol.
+ */
+export interface MockSymbolInfo {
+    /** Symbol name (e.g., function name, class name) */
+    readonly name: string;
+    /** Kind of symbol */
+    readonly kind: MockSymbolKind;
+    /** Line number where the symbol is defined (1-indexed) */
+    readonly line: number;
+    /** Whether the symbol is exported */
+    readonly exported: boolean;
+    /** File path where the symbol is defined (optional, for convenience) */
+    readonly filePath?: string;
+}
+/**
+ * Import kind - static (import/require) or dynamic (import()).
+ */
+export type MockImportKind = "static" | "dynamic";
+/**
+ * Information about an import statement.
+ */
+export interface MockImportInfo {
+    /** Source module path or package name */
+    readonly source: string;
+    /** Imported specifiers (names) */
+    readonly specifiers: readonly string[];
+    /** Kind of import */
+    readonly kind: MockImportKind;
+}
+/**
+ * A match result from ast-grep pattern matching.
+ */
+export interface MockMatch {
+    /** File path where the match was found */
+    readonly file: string;
+    /** Line number (1-indexed) */
+    readonly line: number;
+    /** Column number (1-indexed) */
+    readonly column: number;
+    /** Matched text */
+    readonly text: string;
+    /** Named captures from the pattern (e.g., $NAME -> value) */
+    readonly captures: Readonly<Record<string, string>>;
+}
+declare const MockAstGrepError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "AstGrepError";
+} & Readonly<A>;
+/**
+ * Error type for ast-grep operations.
+ */
+export declare class MockAstGrepError extends MockAstGrepError_base<{
+    readonly reason: string;
+    readonly cause?: unknown;
+}> {
+    get message(): string;
+}
+declare const MockAstGrepServiceTag_base: Context.TagClass<MockAstGrepServiceTag, "AstGrepService", {
+    readonly findSymbols: (filePath: string) => Effect.Effect<readonly MockSymbolInfo[], MockAstGrepError>;
+    readonly getImports: (filePath: string) => Effect.Effect<readonly MockImportInfo[], MockAstGrepError>;
+    readonly matchPattern: (pattern: string, path: string) => Effect.Effect<readonly MockMatch[], MockAstGrepError>;
+}>;
+/**
+ * Mock AstGrepService tag for dependency injection.
+ */
+export declare class MockAstGrepServiceTag extends MockAstGrepServiceTag_base {
+}
+/**
+ * Configuration options for the MockAstGrepService.
+ */
+export interface MockAstGrepServiceConfig {
+    /**
+     * Map of file paths to symbols returned by findSymbols.
+     * If a file path is not in the map, returns an empty array.
+     */
+    symbols?: Map<string, readonly MockSymbolInfo[]>;
+    /**
+     * Default symbols returned for any file not in the symbols map.
+     * If not provided, returns an empty array.
+     */
+    defaultSymbols?: readonly MockSymbolInfo[];
+    /**
+     * Map of file paths to imports returned by getImports.
+     * If a file path is not in the map, returns an empty array.
+     */
+    imports?: Map<string, readonly MockImportInfo[]>;
+    /**
+     * Default imports returned for any file not in the imports map.
+     * If not provided, returns an empty array.
+     */
+    defaultImports?: readonly MockImportInfo[];
+    /**
+     * Map of patterns to matches returned by matchPattern.
+     * Key format: `${pattern}::${path}` for specific path matches,
+     * or just `${pattern}` for pattern-only matches.
+     */
+    matches?: Map<string, readonly MockMatch[]>;
+    /**
+     * Default matches returned for any pattern not in the matches map.
+     * If not provided, returns an empty array.
+     */
+    defaultMatches?: readonly MockMatch[];
+    /**
+     * When true, all operations will fail with an error.
+     */
+    shouldFail?: boolean;
+    /**
+     * Custom error message when shouldFail is true.
+     * Defaults to "Mock AstGrep error".
+     */
+    failureMessage?: string;
+    /**
+     * Map of specific operations to fail.
+     * Keys: "findSymbols", "getImports", "matchPattern"
+     * Values: error message for that operation
+     */
+    failuresByOperation?: Map<string, string>;
+}
+/**
+ * Result returned by MockAstGrepService factory.
+ */
+export interface MockAstGrepServiceResult {
+    /**
+     * Effect Layer providing the mock AstGrepService.
+     */
+    layer: Layer.Layer<MockAstGrepServiceTag>;
+    /**
+     * Array of all findSymbols calls made.
+     */
+    findSymbolsCalls: string[];
+    /**
+     * Array of all getImports calls made.
+     */
+    getImportsCalls: string[];
+    /**
+     * Array of all matchPattern calls made.
+     */
+    matchPatternCalls: Array<{
+        pattern: string;
+        path: string;
+    }>;
+    /**
+     * Reset all call tracking arrays.
+     */
+    reset: () => void;
+    /**
+     * Get total number of all calls made.
+     */
+    getCallCount: () => number;
+}
+/**
+ * Create a mock AstGrepService for testing.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - returns empty arrays
+ * const mock = MockAstGrepService()
+ * const program = Effect.gen(function* () {
+ *   const astGrep = yield* MockAstGrepServiceTag
+ *   return yield* astGrep.findSymbols("src/index.ts")
+ * })
+ * const result = await Effect.runPromise(Effect.provide(program, mock.layer))
+ * expect(result).toEqual([])
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With configured symbols
+ * const symbols = new Map([
+ *   ["src/index.ts", [
+ *     { name: "main", kind: "function", line: 1, exported: true },
+ *     { name: "Helper", kind: "class", line: 10, exported: false }
+ *   ]]
+ * ])
+ * const mock = MockAstGrepService({ symbols })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With failure injection
+ * const mock = MockAstGrepService({
+ *   shouldFail: true,
+ *   failureMessage: "ast-grep not installed"
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With operation-specific failures
+ * const mock = MockAstGrepService({
+ *   failuresByOperation: new Map([
+ *     ["findSymbols", "Failed to parse file"]
+ *   ])
+ * })
+ * // findSymbols will fail, but getImports and matchPattern will work
+ * ```
+ */
+export declare const MockAstGrepService: (config?: MockAstGrepServiceConfig) => MockAstGrepServiceResult;
+export {};
+//# sourceMappingURL=ast-grep.mock.d.ts.map

package/dist/mocks/ast-grep.mock.d.ts.map

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

package/dist/mocks/ast-grep.mock.js

@@ -0,0 +1,164 @@
+/**
+ * Mock AstGrepService for testing.
+ *
+ * Provides configurable mock AstGrepService with symbol fixtures,
+ * import fixtures, pattern match fixtures, and failure injection
+ * for testing services that depend on ast-grep code intelligence.
+ *
+ * Note: Uses inline types until AstGrepService is exported from @tx/core (tx-cf0f3c40).
+ *
+ * @module @tx/test-utils/mocks/ast-grep
+ */
+import { Context, Effect, Layer } from "effect";
+import { Data } from "effect";
+/**
+ * Error type for ast-grep operations.
+ */
+export class MockAstGrepError extends Data.TaggedError("AstGrepError") {
+    get message() {
+        return `AST grep error: ${this.reason}`;
+    }
+}
+// ============================================================================
+// Service Tag (mirrors AstGrepService from @tx/core)
+// ============================================================================
+/**
+ * Mock AstGrepService tag for dependency injection.
+ */
+export class MockAstGrepServiceTag extends Context.Tag("AstGrepService")() {
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a mock AstGrepService for testing.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - returns empty arrays
+ * const mock = MockAstGrepService()
+ * const program = Effect.gen(function* () {
+ *   const astGrep = yield* MockAstGrepServiceTag
+ *   return yield* astGrep.findSymbols("src/index.ts")
+ * })
+ * const result = await Effect.runPromise(Effect.provide(program, mock.layer))
+ * expect(result).toEqual([])
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With configured symbols
+ * const symbols = new Map([
+ *   ["src/index.ts", [
+ *     { name: "main", kind: "function", line: 1, exported: true },
+ *     { name: "Helper", kind: "class", line: 10, exported: false }
+ *   ]]
+ * ])
+ * const mock = MockAstGrepService({ symbols })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With failure injection
+ * const mock = MockAstGrepService({
+ *   shouldFail: true,
+ *   failureMessage: "ast-grep not installed"
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With operation-specific failures
+ * const mock = MockAstGrepService({
+ *   failuresByOperation: new Map([
+ *     ["findSymbols", "Failed to parse file"]
+ *   ])
+ * })
+ * // findSymbols will fail, but getImports and matchPattern will work
+ * ```
+ */
+export const MockAstGrepService = (config = {}) => {
+    const findSymbolsCalls = [];
+    const getImportsCalls = [];
+    const matchPatternCalls = [];
+    const layer = Layer.succeed(MockAstGrepServiceTag, {
+        findSymbols: (filePath) => Effect.gen(function* () {
+            // Track the call
+            findSymbolsCalls.push(filePath);
+            // Check for global failure
+            if (config.shouldFail) {
+                return yield* Effect.fail(new MockAstGrepError({
+                    reason: config.failureMessage || "Mock AstGrep error"
+                }));
+            }
+            // Check for operation-specific failure
+            const opFailure = config.failuresByOperation?.get("findSymbols");
+            if (opFailure) {
+                return yield* Effect.fail(new MockAstGrepError({ reason: opFailure }));
+            }
+            // Return configured symbols or default
+            if (config.symbols?.has(filePath)) {
+                return config.symbols.get(filePath);
+            }
+            return config.defaultSymbols || [];
+        }),
+        getImports: (filePath) => Effect.gen(function* () {
+            // Track the call
+            getImportsCalls.push(filePath);
+            // Check for global failure
+            if (config.shouldFail) {
+                return yield* Effect.fail(new MockAstGrepError({
+                    reason: config.failureMessage || "Mock AstGrep error"
+                }));
+            }
+            // Check for operation-specific failure
+            const opFailure = config.failuresByOperation?.get("getImports");
+            if (opFailure) {
+                return yield* Effect.fail(new MockAstGrepError({ reason: opFailure }));
+            }
+            // Return configured imports or default
+            if (config.imports?.has(filePath)) {
+                return config.imports.get(filePath);
+            }
+            return config.defaultImports || [];
+        }),
+        matchPattern: (pattern, path) => Effect.gen(function* () {
+            // Track the call
+            matchPatternCalls.push({ pattern, path });
+            // Check for global failure
+            if (config.shouldFail) {
+                return yield* Effect.fail(new MockAstGrepError({
+                    reason: config.failureMessage || "Mock AstGrep error"
+                }));
+            }
+            // Check for operation-specific failure
+            const opFailure = config.failuresByOperation?.get("matchPattern");
+            if (opFailure) {
+                return yield* Effect.fail(new MockAstGrepError({ reason: opFailure }));
+            }
+            // Try specific pattern+path key first
+            const specificKey = `${pattern}::${path}`;
+            if (config.matches?.has(specificKey)) {
+                return config.matches.get(specificKey);
+            }
+            // Try pattern-only key
+            if (config.matches?.has(pattern)) {
+                return config.matches.get(pattern);
+            }
+            return config.defaultMatches || [];
+        })
+    });
+    return {
+        layer,
+        findSymbolsCalls,
+        getImportsCalls,
+        matchPatternCalls,
+        reset: () => {
+            findSymbolsCalls.length = 0;
+            getImportsCalls.length = 0;
+            matchPatternCalls.length = 0;
+        },
+        getCallCount: () => findSymbolsCalls.length + getImportsCalls.length + matchPatternCalls.length
+    };
+};
+//# sourceMappingURL=ast-grep.mock.js.map

package/dist/mocks/ast-grep.mock.js.map

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

package/dist/mocks/file-system.mock.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Mock FileSystemService for testing.
+ *
+ * Provides configurable mock FileSystemService with in-memory storage,
+ * initial file fixtures, and failure injection for testing services
+ * that depend on file system operations.
+ *
+ * Note: Uses inline types until FileSystemService is exported from @tx/core.
+ *
+ * @module @tx/test-utils/mocks/file-system
+ */
+import { Context, Effect, Layer } from "effect";
+declare const MockFileSystemError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FileSystemError";
+} & Readonly<A>;
+/**
+ * Error type for file system operations.
+ */
+export declare class MockFileSystemError extends MockFileSystemError_base<{
+    readonly reason: string;
+    readonly path?: string;
+    readonly cause?: unknown;
+}> {
+    get message(): string;
+}
+declare const MockFileSystemServiceTag_base: Context.TagClass<MockFileSystemServiceTag, "FileSystemService", {
+    readonly readFile: (path: string) => Effect.Effect<string, MockFileSystemError>;
+    readonly writeFile: (path: string, content: string) => Effect.Effect<void, MockFileSystemError>;
+    readonly exists: (path: string) => Effect.Effect<boolean, MockFileSystemError>;
+    readonly mkdir: (path: string) => Effect.Effect<void, MockFileSystemError>;
+    readonly readdir: (path: string) => Effect.Effect<readonly string[], MockFileSystemError>;
+}>;
+/**
+ * Mock FileSystemService tag for dependency injection.
+ */
+export declare class MockFileSystemServiceTag extends MockFileSystemServiceTag_base {
+}
+/**
+ * Configuration options for the MockFileSystem.
+ */
+export interface MockFileSystemConfig {
+    /**
+     * Initial files to populate the in-memory file system.
+     * Keys are file paths, values are file contents.
+     */
+    initialFiles?: Map<string, string>;
+    /**
+     * Initial directories to create.
+     * Set of directory paths. If not provided, directories are auto-created
+     * based on file paths in initialFiles.
+     */
+    initialDirectories?: Set<string>;
+    /**
+     * When true, all operations will fail with an error.
+     */
+    shouldFail?: boolean;
+    /**
+     * Custom error message when shouldFail is true.
+     * Defaults to "Mock FileSystem error".
+     */
+    failureMessage?: string;
+    /**
+     * Map of specific operations to fail.
+     * Keys: "readFile", "writeFile", "exists", "mkdir", "readdir"
+     * Values: error message for that operation
+     */
+    failuresByOperation?: Map<string, string>;
+    /**
+     * Map of specific paths to fail on.
+     * Keys: file/directory paths
+     * Values: error message when accessing that path
+     */
+    failuresByPath?: Map<string, string>;
+}
+/**
+ * Result returned by MockFileSystem factory.
+ */
+export interface MockFileSystemResult {
+    /**
+     * Effect Layer providing the mock FileSystemService.
+     */
+    layer: Layer.Layer<MockFileSystemServiceTag>;
+    /**
+     * Array of all readFile calls made (paths).
+     */
+    readFileCalls: string[];
+    /**
+     * Array of all writeFile calls made.
+     */
+    writeFileCalls: Array<{
+        path: string;
+        content: string;
+    }>;
+    /**
+     * Array of all exists calls made (paths).
+     */
+    existsCalls: string[];
+    /**
+     * Array of all mkdir calls made (paths).
+     */
+    mkdirCalls: string[];
+    /**
+     * Array of all readdir calls made (paths).
+     */
+    readdirCalls: string[];
+    /**
+     * Get the current in-memory file contents.
+     */
+    getFiles: () => Map<string, string>;
+    /**
+     * Get the current in-memory directories.
+     */
+    getDirectories: () => Set<string>;
+    /**
+     * Reset all call tracking arrays and restore initial state.
+     */
+    reset: () => void;
+    /**
+     * Get total number of all calls made.
+     */
+    getCallCount: () => number;
+}
+/**
+ * Create a mock FileSystemService for testing.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - empty file system
+ * const mock = MockFileSystem()
+ * const program = Effect.gen(function* () {
+ *   const fs = yield* MockFileSystemServiceTag
+ *   yield* fs.writeFile("/tmp/test.txt", "hello")
+ *   return yield* fs.readFile("/tmp/test.txt")
+ * })
+ * const result = await Effect.runPromise(Effect.provide(program, mock.layer))
+ * expect(result).toBe("hello")
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With initial files
+ * const mock = MockFileSystem({
+ *   initialFiles: new Map([
+ *     ["/app/config.json", '{"debug": true}'],
+ *     ["/app/data.txt", "Hello World"]
+ *   ])
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With failure injection
+ * const mock = MockFileSystem({
+ *   shouldFail: true,
+ *   failureMessage: "Disk full"
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With path-specific failures
+ * const mock = MockFileSystem({
+ *   failuresByPath: new Map([
+ *     ["/protected/secret.txt", "Permission denied"]
+ *   ])
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With operation-specific failures
+ * const mock = MockFileSystem({
+ *   failuresByOperation: new Map([
+ *     ["writeFile", "Read-only file system"]
+ *   ])
+ * })
+ * ```
+ */
+export declare const MockFileSystem: (config?: MockFileSystemConfig) => MockFileSystemResult;
+export {};
+//# sourceMappingURL=file-system.mock.d.ts.map

package/dist/mocks/file-system.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.mock.d.ts","sourceRoot":"","sources":["../../src/mocks/file-system.mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;;;;AAO/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,yBAAoC;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,CAAC;IACA,IAAI,OAAO,WAIV;CACF;;uBAYsB,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;wBAC3D,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC;qBAC9E,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC;oBAC9D,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC;sBACxD,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,mBAAmB,CAAC;;AAV7F;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,6BAS3C;CAAG;AAMN;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAChC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC;;;;OAIG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAC5C;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB;;OAEG;IACH,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD;;OAEG;IACH,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAA;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,MAAM,CAAA;CAC3B;AA0CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,cAAc,GAAI,SAAQ,oBAAyB,KAAG,oBAkMlE,CAAA"}