@aigne/test-utils 0.5.69-beta.18 → 0.5.69-beta.19

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.5.69-beta.19](https://github.com/AIGNE-io/aigne-framework/compare/test-utils-v0.5.69-beta.18...test-utils-v0.5.69-beta.19) (2026-01-14)
+
+
+### Bug Fixes
+
+* improve test coverage tracking and reporting ([#903](https://github.com/AIGNE-io/aigne-framework/issues/903)) ([031144e](https://github.com/AIGNE-io/aigne-framework/commit/031144e74f29e882cffe52ffda8f7a18c76ace7f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @aigne/core bumped to 1.72.0-beta.19
+
 ## [0.5.69-beta.18](https://github.com/AIGNE-io/aigne-framework/compare/test-utils-v0.5.69-beta.17...test-utils-v0.5.69-beta.18) (2026-01-13)
 
 

package/lib/utils/import-all-modules.d.ts

@@ -0,0 +1,38 @@
+export interface ImportAllModulesOptions {
+    /**
+     * The root directory to scan for source files
+     */
+    sourceDir: string;
+    /**
+     * Patterns to exclude from import (default: test files, type definitions, build artifacts)
+     */
+    exclude?: string[];
+    /**
+     * File extensions to include (default: ts, tsx, js, jsx, mjs, cjs)
+     */
+    extensions?: string[];
+    /**
+     * Whether to show verbose logging (default: false)
+     */
+    verbose?: boolean;
+}
+/**
+ * Import all modules in a directory for coverage tracking.
+ *
+ * This utility dynamically imports all source files in a package to ensure
+ * Bun's coverage reporter includes them in coverage metrics, even if they
+ * aren't directly imported by any tests.
+ *
+ * @example
+ * ```typescript
+ * import { test } from 'bun:test';
+ * import { importAllModules } from '@aigne/test-utils/utils/import-all-modules';
+ *
+ * test('import all modules for coverage tracking', async () => {
+ *   await importAllModules({
+ *     sourceDir: '../src',
+ *   });
+ * });
+ * ```
+ */
+export declare function importAllModules(options: ImportAllModulesOptions): Promise<void>;

package/lib/utils/import-all-modules.js

@@ -0,0 +1,84 @@
+import { join, resolve } from "node:path";
+import { Glob } from "bun";
+/**
+ * Import all modules in a directory for coverage tracking.
+ *
+ * This utility dynamically imports all source files in a package to ensure
+ * Bun's coverage reporter includes them in coverage metrics, even if they
+ * aren't directly imported by any tests.
+ *
+ * @example
+ * ```typescript
+ * import { test } from 'bun:test';
+ * import { importAllModules } from '@aigne/test-utils/utils/import-all-modules';
+ *
+ * test('import all modules for coverage tracking', async () => {
+ *   await importAllModules({
+ *     sourceDir: '../src',
+ *   });
+ * });
+ * ```
+ */
+export async function importAllModules(options) {
+    const { sourceDir, exclude = [
+        "**/*.test.*",
+        "**/*.spec.*",
+        "**/__tests__/**",
+        "**/__mocks__/**",
+        "**/*.d.ts",
+        "**/node_modules/**",
+        "**/lib/**",
+        "**/dist/**",
+        "**/coverage/**",
+    ], extensions = ["ts", "tsx", "js", "jsx", "mjs", "cjs"], verbose = false, } = options;
+    // Resolve sourceDir to absolute path from current working directory
+    const absoluteSourceDir = resolve(sourceDir);
+    // Build the glob pattern for matching files
+    const pattern = extensions.length === 1 ? `**/*.${extensions[0]}` : `**/*.{${extensions.join(",")}}`;
+    const glob = new Glob(pattern);
+    // Scan for files
+    const files = [];
+    for await (const file of glob.scan({
+        cwd: absoluteSourceDir,
+        onlyFiles: true,
+    })) {
+        // Check if file should be excluded
+        const shouldExclude = exclude.some((pattern) => {
+            // Simple pattern matching (supports ** and * wildcards)
+            const regexPattern = pattern
+                .replace(/\*\*/g, ".*")
+                .replace(/\*/g, "[^/]*")
+                .replace(/\./g, "\\.");
+            return new RegExp(regexPattern).test(file);
+        });
+        if (!shouldExclude) {
+            files.push(file);
+        }
+    }
+    if (verbose) {
+        console.log(`[coverage] Found ${files.length} source files to import`);
+    }
+    // Import all files in parallel
+    const imports = files.map(async (file) => {
+        const absoluteFilePath = join(absoluteSourceDir, file);
+        try {
+            // Use file:// URL for reliable imports across different CWDs
+            const fileUrl = `file://${absoluteFilePath}`;
+            await import(fileUrl);
+            if (verbose) {
+                console.log(`[coverage] ✓ Imported: ${file}`);
+            }
+        }
+        catch (error) {
+            // Some files may fail to import (e.g., templates, type-only files)
+            // This is expected and should not fail the test
+            if (verbose) {
+                console.warn(`[coverage] ⚠ Failed to import ${file}:`, error);
+            }
+        }
+    });
+    await Promise.allSettled(imports);
+    if (verbose) {
+        console.log(`[coverage] Completed importing ${files.length} modules`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/test-utils",
-  "version": "0.5.69-beta.18",
+  "version": "0.5.69-beta.19",
   "description": "Test utils for AIGNE framework",
   "publishConfig": {
     "access": "public"
@@ -27,7 +27,7 @@
     }
   },
   "dependencies": {
-    "@aigne/core": "^1.72.0-beta.18"
+    "@aigne/core": "^1.72.0-beta.19"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",

package/src/utils/import-all-modules.ts

@@ -0,0 +1,121 @@
+import { join, resolve } from "node:path";
+import { Glob } from "bun";
+
+export interface ImportAllModulesOptions {
+  /**
+   * The root directory to scan for source files
+   */
+  sourceDir: string;
+
+  /**
+   * Patterns to exclude from import (default: test files, type definitions, build artifacts)
+   */
+  exclude?: string[];
+
+  /**
+   * File extensions to include (default: ts, tsx, js, jsx, mjs, cjs)
+   */
+  extensions?: string[];
+
+  /**
+   * Whether to show verbose logging (default: false)
+   */
+  verbose?: boolean;
+}
+
+/**
+ * Import all modules in a directory for coverage tracking.
+ *
+ * This utility dynamically imports all source files in a package to ensure
+ * Bun's coverage reporter includes them in coverage metrics, even if they
+ * aren't directly imported by any tests.
+ *
+ * @example
+ * ```typescript
+ * import { test } from 'bun:test';
+ * import { importAllModules } from '@aigne/test-utils/utils/import-all-modules';
+ *
+ * test('import all modules for coverage tracking', async () => {
+ *   await importAllModules({
+ *     sourceDir: '../src',
+ *   });
+ * });
+ * ```
+ */
+export async function importAllModules(options: ImportAllModulesOptions): Promise<void> {
+  const {
+    sourceDir,
+    exclude = [
+      "**/*.test.*",
+      "**/*.spec.*",
+      "**/__tests__/**",
+      "**/__mocks__/**",
+      "**/*.d.ts",
+      "**/node_modules/**",
+      "**/lib/**",
+      "**/dist/**",
+      "**/coverage/**",
+    ],
+    extensions = ["ts", "tsx", "js", "jsx", "mjs", "cjs"],
+    verbose = false,
+  } = options;
+
+  // Resolve sourceDir to absolute path from current working directory
+  const absoluteSourceDir = resolve(sourceDir);
+
+  // Build the glob pattern for matching files
+  const pattern =
+    extensions.length === 1 ? `**/*.${extensions[0]}` : `**/*.{${extensions.join(",")}}`;
+
+  const glob = new Glob(pattern);
+
+  // Scan for files
+  const files: string[] = [];
+  for await (const file of glob.scan({
+    cwd: absoluteSourceDir,
+    onlyFiles: true,
+  })) {
+    // Check if file should be excluded
+    const shouldExclude = exclude.some((pattern) => {
+      // Simple pattern matching (supports ** and * wildcards)
+      const regexPattern = pattern
+        .replace(/\*\*/g, ".*")
+        .replace(/\*/g, "[^/]*")
+        .replace(/\./g, "\\.");
+      return new RegExp(regexPattern).test(file);
+    });
+
+    if (!shouldExclude) {
+      files.push(file);
+    }
+  }
+
+  if (verbose) {
+    console.log(`[coverage] Found ${files.length} source files to import`);
+  }
+
+  // Import all files in parallel
+  const imports = files.map(async (file) => {
+    const absoluteFilePath = join(absoluteSourceDir, file);
+    try {
+      // Use file:// URL for reliable imports across different CWDs
+      const fileUrl = `file://${absoluteFilePath}`;
+      await import(fileUrl);
+      if (verbose) {
+        console.log(`[coverage] ✓ Imported: ${file}`);
+      }
+    } catch (error) {
+      // Some files may fail to import (e.g., templates, type-only files)
+      // This is expected and should not fail the test
+      if (verbose) {
+        console.warn(`[coverage] ⚠ Failed to import ${file}:`, error);
+      }
+    }
+  });
+
+  await Promise.allSettled(imports);
+
+  if (verbose) {
+    console.log(`[coverage] Completed importing ${files.length} modules`);
+  }
+}

package/tsconfig.build.json

@@ -4,6 +4,7 @@
     "rootDir": "./src",
     "outDir": "./lib",
     "noEmit": false,
+    "allowImportingTsExtensions": false,
     "declaration": true
   },
   "include": ["./src"]

package/tsconfig.build.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/run-example-test.ts","./src/utils/agent-response.ts","./src/utils/event-stream.ts","./src/utils/openai-like-utils.ts","./src/utils/with-env.ts"],"version":"5.9.2"}
+{"root":["./src/run-example-test.ts","./src/utils/agent-response.ts","./src/utils/event-stream.ts","./src/utils/import-all-modules.ts","./src/utils/openai-like-utils.ts","./src/utils/with-env.ts"],"version":"5.9.2"}