@eggjs/typings 4.1.2-beta.11 → 4.1.2-beta.12

package/dist/global.d.ts

@@ -1,6 +1,7 @@
-import { BundleModuleLoader } from "./index.js";
+import { BundleModuleLoader, ModuleImporter } from "./index.js";
 
 //#region src/global.d.ts
 declare global {
   var __EGG_BUNDLE_MODULE_LOADER__: BundleModuleLoader | undefined;
+  var __EGG_MODULE_IMPORTER__: ModuleImporter | undefined;
 }

package/dist/index.d.ts

@@ -5,5 +5,21 @@
 * standard import path.
 */
 type BundleModuleLoader = (filepath: string) => unknown;
+/**
+* Async module importer override for the tegg loader's file loading.
+*
+* When set, the loader delegates module loading to this importer instead of the
+* built-in `await import(filePath)`. Its main use is testing with a bundler-based
+* test runner (e.g. Vitest): when an app's egg modules are loaded by the loader
+* via the native `import()` while the test file imports the same source through
+* the runner's module graph, the two resolve to *different* module instances —
+* so a class decorated as an egg proto by the loader is not the same class the
+* test references, and `ctx.getEggObject(ClassRef)` fails with "can not get proto".
+*
+* A test runner can inject an importer that routes loading through its own module
+* graph (e.g. `filePath => import(filePath)` evaluated inside the runner context),
+* keeping a single module instance. Return value mirrors `await import()`.
+*/
+type ModuleImporter = (filePath: string) => Promise<unknown>;
 //#endregion
-export { BundleModuleLoader };
+export { BundleModuleLoader, ModuleImporter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/typings",
-  "version": "4.1.2-beta.11",
+  "version": "4.1.2-beta.12",
   "description": "Shared typings for egg projects",
   "keywords": [
     "egg",
@@ -36,7 +36,7 @@
   "dependencies": {},
   "devDependencies": {
     "typescript": "^5.9.3",
-    "@eggjs/tsconfig": "3.1.2-beta.11"
+    "@eggjs/tsconfig": "3.1.2-beta.12"
   },
   "engines": {
     "node": ">=22.18.0"