@zintrust/core 0.4.10 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

package/src/boot/registry/registerRoute.d.ts

@@ -1,4 +1,4 @@
-import type { IRouter } from '../../routes/Router';
+import { type IRouter } from '../../routes/Router';
 export declare const isCompiledJsModule: () => boolean;
 export declare const tryImportOptional: <T>(modulePath: string) => Promise<T | undefined>;
 export declare const tryImportOptionalR: <T>(modulePath: string) => Promise<T | undefined>;

package/src/boot/registry/registerRoute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerRoute.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/registerRoute.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAUnD,eAAO,MAAM,kBAAkB,QAAO,OAKrC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,CAAC,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAMpF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,CAAC,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAOrF,CAAC;AAuFF,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,MAAM,EACxB,QAAQ,OAAO,KACd,OAAO,CAAC,IAAI,CAoBd,CAAC"}
+{"version":3,"file":"registerRoute.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/registerRoute.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAW3D,eAAO,MAAM,kBAAkB,QAAO,OAKrC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAU,CAAC,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAMpF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,CAAC,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAOrF,CAAC;AA4FF,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,MAAM,EACxB,QAAQ,OAAO,KACd,OAAO,CAAC,IAAI,CAoBd,CAAC"}

package/src/boot/registry/registerRoute.js

@@ -1,6 +1,8 @@
 import { appConfig } from '../../config/index.js';
 import Logger from '../../config/logger.js';
+import { Router } from '../../routes/Router.js';
 import { isObject } from '../../helper/index.js';
+import { getServicePrefix } from '../../microservices/ServiceManifest.js';
 import * as path from '../../node-singletons/path.js';
 import { pathToFileURL } from '../../node-singletons/url.js';
 import { detectRuntime } from '../../runtime/detectRuntime.js';
@@ -62,6 +64,7 @@ const registerAppRoutes = async (resolvedBasePath, router) => {
     }
 };
 const registerManifestRoutes = async (router) => {
+    await ProjectRuntime.tryLoadNodeRuntime();
     const serviceManifest = ProjectRuntime.getServiceManifest();
     if (serviceManifest.length === 0)
         return;
@@ -72,8 +75,11 @@ const registerManifestRoutes = async (router) => {
         try {
             // eslint-disable-next-line no-await-in-loop
             const mod = await entry.loadRoutes();
-            if (isObject(mod) && typeof mod.registerRoutes === 'function') {
-                mod.registerRoutes(router);
+            const registerRoutes = isObject(mod) ? mod.registerRoutes : undefined;
+            if (typeof registerRoutes === 'function') {
+                Router.group(router, getServicePrefix(entry), (scopedRouter) => {
+                    registerRoutes(scopedRouter);
+                });
             }
         }
         catch (error) {

package/src/cli/commands/RoutesCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoutesCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/RoutesCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuVvF,eAAO,MAAM,aAAa;cACd,YAAY;EAatB,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"RoutesCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/RoutesCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2VvF,eAAO,MAAM,aAAa;cACd,YAAY;EAatB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/src/cli/commands/RoutesCommand.js

@@ -7,6 +7,7 @@ import { Env } from '../../config/env.js';
 import { Router } from '../../routes/Router.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { isObject } from '../../helper/index.js';
+import { getServicePrefix } from '../../microservices/ServiceManifest.js';
 import { ProjectRuntime } from '../../runtime/ProjectRuntime.js';
 const parseGroupBy = (value) => {
     const raw = typeof value === 'string' ? value.trim().toLowerCase() : '';
@@ -180,8 +181,11 @@ const registerManifestRoutes = async (router) => {
             const beforeCount = Router.getRoutes(router).length;
             // eslint-disable-next-line no-await-in-loop
             const mod = await entry.loadRoutes();
-            if (isObject(mod) && typeof mod.registerRoutes === 'function') {
-                mod.registerRoutes(router);
+            const registerRoutes = isObject(mod) ? mod.registerRoutes : undefined;
+            if (typeof registerRoutes === 'function') {
+                Router.group(router, getServicePrefix(entry), (scopedRouter) => {
+                    registerRoutes(scopedRouter);
+                });
                 annotateManifestRoutes(router, beforeCount, entry.id);
             }
         }

package/src/cli/commands/StartCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2sBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,CAAC"}
+{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgtBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -210,6 +210,10 @@ const buildStartEnv = (projectRoot) => ({
     ...process.env,
     ZINTRUST_PROJECT_ROOT: projectRoot,
 });
+const ensureStartEnvLoaded = (context) => {
+    const extraCwds = context.cwd === context.projectRoot ? [] : [context.cwd];
+    EnvFileLoader.ensureLoaded({ cwd: context.projectRoot, extraCwds });
+};
 const isFrameworkRepo = (packageJson) => packageJson.name === '@zintrust/core';
 const hasDevScript = (packageJson) => {
     const scripts = packageJson.scripts;
@@ -479,7 +483,7 @@ const executeSplitStart = async (cmd, context, _options) => {
 const executeStart = async (options, cmd) => {
     const cwd = process.cwd();
     const context = resolveStartContext(cwd);
-    EnvFileLoader.ensureLoaded();
+    ensureStartEnvLoaded(context);
     const mode = resolveMode(options);
     const port = resolvePort(options);
     const runtime = resolveRuntime(options);

package/src/cli/scaffolding/ServiceScaffolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAiDhC;AA8bD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}
+{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAiDhC;AAgcD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -107,6 +107,7 @@ export const serviceManifest: ReadonlyArray<ServiceManifestEntry> = [
     id: '${serviceId}',
     domain: '${domain}',
     name: '${options.name}',
+    prefix: '${serviceId}',
     port: ${options.port ?? 3001},
     monolithEnabled: true,
     loadRoutes: async () => ${routeImportExpression},
@@ -147,6 +148,7 @@ function updateServiceManifest(projectRoot, options) {
     id: '${serviceId}',
     domain: '${domain}',
     name: '${options.name}',
+    prefix: '${serviceId}',
     port: ${options.port ?? 3001},
     monolithEnabled: true,
     loadRoutes: async () => ${routeImportExpression},

package/src/cli/utils/EnvFileLoader.d.ts

@@ -1,6 +1,7 @@
 type node_env = 'development' | 'production' | 'testing';
 type LoadOptions = {
     cwd?: string;
+    extraCwds?: string[];
     overrideExisting?: boolean;
 };
 type LoadState = {
@@ -15,7 +16,7 @@ type CliOverrides = {
 };
 export declare const EnvFileLoader: Readonly<{
     load: (options?: LoadOptions) => LoadState;
-    ensureLoaded: () => LoadState;
+    ensureLoaded: (options?: Omit<LoadOptions, "overrideExisting">) => LoadState;
     applyCliOverrides: (overrides: CliOverrides) => void;
     getState: () => LoadState;
 }>;

package/src/cli/utils/EnvFileLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AAQA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAmIzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AA+FF,eAAO,MAAM,aAAa;qBAtEH,WAAW,KAAQ,SAAS;wBAmC1B,SAAS;mCAEI,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}
+{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AAQA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAmIzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAkHF,eAAO,MAAM,aAAa;qBA7DH,WAAW,KAAQ,SAAS;6BAyBpB,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,KAAQ,SAAS;mCAG/C,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}

package/src/cli/utils/EnvFileLoader.js

@@ -139,11 +139,7 @@ const filesLoader = (cwd, mode) => {
     return files;
 };
 let cached;
-const load = (options = {}) => {
-    if (cached !== undefined)
-        return cached;
-    const cwd = typeof options.cwd === 'string' && options.cwd !== '' ? options.cwd : process.cwd();
-    const overrideExisting = options.overrideExisting ?? true;
+const loadFromCwd = (cwd, overrideExisting) => {
     const mode = resolveAppMode(cwd);
     const files = filesLoader(cwd, mode);
     let baseApplied = false;
@@ -163,10 +159,30 @@ const load = (options = {}) => {
     if (mode !== undefined) {
         safeEnvSet('NODE_ENV', mode);
     }
-    cached = { loadedFiles: files, mode };
+    return { loadedFiles: files, mode };
+};
+const load = (options = {}) => {
+    if (cached !== undefined)
+        return cached;
+    const cwd = typeof options.cwd === 'string' && options.cwd !== '' ? options.cwd : process.cwd();
+    const extraCwds = Array.isArray(options.extraCwds)
+        ? options.extraCwds.filter((value) => typeof value === 'string' && value.trim() !== '')
+        : [];
+    const overrideExisting = options.overrideExisting ?? true;
+    const roots = [cwd, ...extraCwds].filter((value, index, items) => items.indexOf(value) === index);
+    let mergedMode;
+    const loadedFiles = [];
+    for (let index = 0; index < roots.length; index += 1) {
+        const root = roots[index];
+        const state = loadFromCwd(root, index === 0 ? overrideExisting : true);
+        if (mergedMode === undefined && state.mode !== undefined)
+            mergedMode = state.mode;
+        loadedFiles.push(...state.loadedFiles);
+    }
+    cached = { loadedFiles, mode: mergedMode };
     return cached;
 };
-const ensureLoaded = () => load({ overrideExisting: false });
+const ensureLoaded = (options = {}) => load({ ...options, overrideExisting: false });
 const applyCliOverrides = (overrides) => {
     // Ensure base env is loaded first.
     ensureLoaded();

package/src/cli/utils/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA8BD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EA+E7D,CAAC"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA0CD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EA+E7D,CAAC"}

package/src/cli/utils/spawn.js

@@ -29,6 +29,16 @@ const resolveLocalBin = (command, cwd) => {
     }
     return command;
 };
+const buildCommandNotFoundMessage = (command) => {
+    if (command === 'tsx') {
+        return [
+            "Error: 'tsx' not found on PATH.",
+            'Install it in the project with "npm install -D tsx".',
+            'If you want a machine-wide fallback, install it globally with "npm install -g tsx".',
+        ].join(' ');
+    }
+    return `Error: '${command}' not found on PATH.`;
+};
 export const SpawnUtil = Object.freeze({
     async spawnAndWait(input) {
         const cwd = input.cwd ?? process.cwd();
@@ -87,7 +97,7 @@ export const SpawnUtil = Object.freeze({
         catch (error) {
             const code = error?.code;
             if (code === 'ENOENT') {
-                throw ErrorFactory.createCliError(`Error: '${input.command}' not found on PATH.`);
+                throw ErrorFactory.createCliError(buildCommandNotFoundMessage(input.command));
             }
             throw ErrorFactory.createTryCatchError('Failed to spawn child process', error);
         }

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.10
+ * @zintrust/core v0.4.12
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-23T12:53:44.665Z
+ *   Built: 2026-03-23T13:57:31.438Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-03-23T12:53:44.591Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-23T13:57:31.366Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/microservices/ServiceManifest.d.ts

@@ -3,6 +3,7 @@ export interface ServiceManifestEntry {
     id: string;
     domain: string;
     name: string;
+    prefix?: string;
     version?: string;
     description?: string;
     port?: number;
@@ -21,6 +22,12 @@ export interface ProjectRuntimeModule {
     activeService?: ActiveServiceRuntime;
 }
 export declare const getServiceId: (domain: string, name: string) => string;
+export declare const getDefaultServicePrefix: (domain: string, name: string) => string;
+export declare const getServicePrefix: (args: {
+    prefix?: unknown;
+    domain?: unknown;
+    name?: unknown;
+}) => string;
 export declare const isCanonicalServiceId: (value: unknown) => value is string;
 export declare const toCanonicalServiceId: (args: {
     id?: unknown;
@@ -34,6 +41,12 @@ export declare const normalizeProjectRuntimeModule: (value: unknown) => ProjectR
 export declare const serviceMatchesAllowList: (serviceId: string, serviceName: string, allowList: ReadonlyArray<string>) => boolean;
 declare const _default: Readonly<{
     getServiceId: (domain: string, name: string) => string;
+    getDefaultServicePrefix: (domain: string, name: string) => string;
+    getServicePrefix: (args: {
+        prefix?: unknown;
+        domain?: unknown;
+        name?: unknown;
+    }) => string;
     isCanonicalServiceId: (value: unknown) => value is string;
     toCanonicalServiceId: (args: {
         id?: unknown;

package/src/microservices/ServiceManifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceManifest.d.ts","sourceRoot":"","sources":["../../../src/microservices/ServiceManifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACtD,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,MAA6B,CAAC;AAE1F,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAI9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,MAAM;IACzC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,KAAG,MAKH,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,oBAYhE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,aAAa,CAAC,oBAAoB,CAQ3F,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,OAAO,OAAO,KAAG,oBAAoB,GAAG,SAarF,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,OAAO,OAAO,KAAG,oBAa9D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,WAAW,aAAa,CAAC,MAAM,CAAC,KAC/B,OAGF,CAAC;;2BAhFmC,MAAM,QAAQ,MAAM,KAAG,MAAM;kCAEtB,OAAO,KAAG,KAAK,IAAI,MAAM;iCAM1B;QACzC,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,KAAG,MAAM;oCAOoC,OAAO,KAAG,KAAK,IAAI,oBAAoB;sCAcrC,OAAO,KAAG,aAAa,CAAC,oBAAoB,CAAC;2CAUxC,OAAO,KAAG,oBAAoB,GAAG,SAAS;2CAe1C,OAAO,KAAG,oBAAoB;yCAgBtE,MAAM,eACJ,MAAM,aACR,aAAa,CAAC,MAAM,CAAC,KAC/B,OAAO;;AAKV,wBASG"}
+{"version":3,"file":"ServiceManifest.d.ts","sourceRoot":"","sources":["../../../src/microservices/ServiceManifest.ts"],"names":[],"mappings":"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"}

package/src/microservices/ServiceManifest.js

@@ -1,5 +1,25 @@
 import { isArray, isFunction, isNonEmptyString, isObject } from '../helper/index.js';
 export const getServiceId = (domain, name) => `${domain}/${name}`;
+export const getDefaultServicePrefix = (domain, name) => `/${getServiceId(domain, name)}`;
+const normalizeServicePrefix = (value) => {
+    const trimmed = value.trim();
+    if (trimmed === '' || trimmed === '/')
+        return '/';
+    const segments = trimmed
+        .split('/')
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0);
+    if (segments.length === 0)
+        return '/';
+    return `/${segments.join('/')}`;
+};
+export const getServicePrefix = (args) => {
+    if (typeof args.prefix === 'string')
+        return normalizeServicePrefix(args.prefix);
+    const domain = isNonEmptyString(args.domain) ? args.domain : 'default';
+    const name = isNonEmptyString(args.name) ? args.name : 'unknown';
+    return getDefaultServicePrefix(domain, name);
+};
 export const isCanonicalServiceId = (value) => {
     if (!isNonEmptyString(value))
         return false;
@@ -22,6 +42,10 @@ export const isServiceManifestEntry = (value) => {
         return false;
     if (!isNonEmptyString(value['name']))
         return false;
+    const prefix = value['prefix'];
+    if (prefix !== undefined && typeof prefix !== 'string') {
+        return false;
+    }
     const loadRoutes = value['loadRoutes'];
     if (loadRoutes !== undefined && !isFunction(loadRoutes)) {
         return false;
@@ -34,6 +58,7 @@ export const normalizeServiceManifest = (value) => {
     return value.filter(isServiceManifestEntry).map((entry) => ({
         ...entry,
         id: toCanonicalServiceId(entry),
+        prefix: getServicePrefix(entry),
         monolithEnabled: entry.monolithEnabled !== false,
     }));
 };
@@ -72,6 +97,8 @@ export const serviceMatchesAllowList = (serviceId, serviceName, allowList) => {
 };
 export default Object.freeze({
     getServiceId,
+    getDefaultServicePrefix,
+    getServicePrefix,
     isCanonicalServiceId,
     toCanonicalServiceId,
     isServiceManifestEntry,

package/src/runtime/PluginAutoImports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginAutoImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginAutoImports.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,KAAK,YAAY,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAuJN,eAAO,MAAM,iBAAiB;uCACY,uBAAuB,GAAY,OAAO,CAAC,YAAY,CAAC;IAkBhG;;;;;;OAMG;mCACkC,OAAO,CAAC,YAAY,CAAC;qCAkEnB,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;EAavE,CAAC"}
+{"version":3,"file":"PluginAutoImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginAutoImports.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEzF,KAAK,YAAY,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA6MN,eAAO,MAAM,iBAAiB;uCACY,uBAAuB,GAAY,OAAO,CAAC,YAAY,CAAC;IAkBhG;;;;;;OAMG;mCACkC,OAAO,CAAC,YAAY,CAAC;qCAkEnB,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;EAavE,CAAC"}

package/src/runtime/PluginAutoImports.js

@@ -94,6 +94,47 @@ const resolveLocalPackageSpecifier = (specifier) => {
         return null;
     return pathToFileURL(resolved).href;
 };
+const isMissingPackageImport = (error, specifier) => {
+    if (specifier.startsWith('.'))
+        return false;
+    if (error === null || typeof error !== 'object')
+        return false;
+    const maybe = error;
+    const message = typeof maybe.message === 'string' ? maybe.message : '';
+    if (maybe.code === 'ERR_MODULE_NOT_FOUND' && message.length === 0)
+        return true;
+    if (maybe.code === 'ERR_MODULE_NOT_FOUND' && message.includes(specifier))
+        return true;
+    return (message.includes(`Cannot find package '${specifier}'`) ||
+        message.includes(`Cannot find module '${specifier}'`));
+};
+const getMissingPackageStatus = (error, specifier) => {
+    if (isMissingPackageImport(error, specifier)) {
+        Logger.debug('[plugins] Optional auto-import package not installed', {
+            specifier,
+        });
+        return 'missing';
+    }
+    return 'failed';
+};
+const importFromLocalFallback = async (specifier, fallback) => {
+    try {
+        await import(fallback);
+        Logger.debug('[plugins] Loaded auto-import specifier from local fallback', {
+            specifier,
+            fallback,
+        });
+        return 'loaded';
+    }
+    catch (fallbackError) {
+        Logger.debug('[plugins] Failed auto-import local fallback', {
+            specifier,
+            fallback,
+            error: fallbackError instanceof Error ? fallbackError.message : String(fallbackError),
+        });
+        return getMissingPackageStatus(fallbackError, specifier);
+    }
+};
 const importSingleSpecifier = async (entry) => {
     const target = entry.specifier.startsWith('.')
         ? resolveRelativeSpecifier(entry)
@@ -101,52 +142,48 @@ const importSingleSpecifier = async (entry) => {
     try {
         await import(target);
         Logger.debug('[plugins] Loaded auto-import specifier', { specifier: entry.specifier });
-        return true;
+        return 'loaded';
     }
-    catch {
+    catch (error) {
         const fallback = resolveLocalPackageSpecifier(entry.specifier);
-        if (fallback !== null) {
-            try {
-                await import(fallback);
-                Logger.debug('[plugins] Loaded auto-import specifier from local fallback', {
-                    specifier: entry.specifier,
-                    fallback,
-                });
-                return true;
-            }
-            catch (fallbackError) {
-                Logger.debug('[plugins] Failed auto-import local fallback', {
-                    specifier: entry.specifier,
-                    fallback,
-                    error: fallbackError instanceof Error ? fallbackError.message : String(fallbackError),
-                });
-            }
-        }
-        return false;
+        if (fallback !== null)
+            return importFromLocalFallback(entry.specifier, fallback);
+        return getMissingPackageStatus(error, entry.specifier);
     }
 };
 const importSpecifiers = async (specifiers) => {
     // Import all specifiers in parallel
     const importPromises = Array.from(specifiers).map(async (entry) => {
-        const success = await importSingleSpecifier(entry);
-        return { specifier: entry.specifier, success };
+        const status = await importSingleSpecifier(entry);
+        return { specifier: entry.specifier, status };
     });
     const results = await Promise.allSettled(importPromises);
-    // Count successful imports
-    return results.filter((result) => result.status === 'fulfilled' && result.value.success).length;
+    return results.reduce((summary, result) => {
+        if (result.status !== 'fulfilled') {
+            summary.failed += 1;
+            return summary;
+        }
+        if (result.value.status === 'loaded')
+            summary.loaded += 1;
+        else if (result.value.status === 'missing')
+            summary.missing += 1;
+        else
+            summary.failed += 1;
+        return summary;
+    }, { loaded: 0, missing: 0, failed: 0 });
 };
 export const PluginAutoImports = Object.freeze({
     async tryImportRuntimeAutoImports(mode = 'base') {
         const specifiers = OfficialPlugins.getAutoImports(mode);
-        const loaded = await importSpecifiers(specifiers.map((specifier) => ({ specifier, filePath: `official:${mode}` })));
-        if (loaded === specifiers.length) {
+        const summary = await importSpecifiers(specifiers.map((specifier) => ({ specifier, filePath: `official:${mode}` })));
+        if (summary.failed === 0) {
             return { ok: true, loadedPath: `official:${mode}` };
         }
         return {
             ok: false,
             loadedPath: `official:${mode}`,
             reason: 'import-failed',
-            errorMessage: `Loaded ${loaded}/${specifiers.length} official plugin imports`,
+            errorMessage: `Loaded ${summary.loaded}/${specifiers.length} official plugin imports`,
         };
     },
     /**
@@ -209,8 +246,8 @@ export const PluginAutoImports = Object.freeze({
         if (specifiers.length === 0) {
             return { ok: false, reason: 'import-failed', errorMessage: 'No import specifiers found' };
         }
-        const loaded = await importSpecifiers(specifiers);
-        if (loaded > 0) {
+        const summary = await importSpecifiers(specifiers);
+        if (summary.loaded > 0) {
             return { ok: true, loadedPath: 'manual-imports' };
         }
         return { ok: false, reason: 'import-failed', errorMessage: 'All specifier imports failed' };