@zintrust/core 0.4.9 → 0.4.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.9",
+  "version": "0.4.11",
   "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;AA0FF,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';
@@ -72,8 +74,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;AAsSvF,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

@@ -6,6 +6,9 @@ import { BaseCommand } from '../BaseCommand.js';
 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() : '';
     if (raw === '' || raw === 'group')
@@ -157,6 +160,40 @@ const renderTable = (rows) => {
     console.log(bottom);
     /* eslint-enable no-console */
 };
+const annotateManifestRoutes = (router, beforeCount, serviceId) => {
+    const routes = Router.getRoutes(router);
+    for (const route of routes.slice(beforeCount)) {
+        route.__zintrustServiceId = serviceId;
+    }
+};
+const getRouteServiceId = (route) => {
+    return route.__zintrustServiceId ?? '';
+};
+const registerManifestRoutes = async (router) => {
+    await ProjectRuntime.tryLoadNodeRuntime();
+    const serviceManifest = ProjectRuntime.getServiceManifest();
+    if (serviceManifest.length === 0)
+        return;
+    for (const entry of serviceManifest) {
+        if (entry.monolithEnabled === false || typeof entry.loadRoutes !== 'function')
+            continue;
+        try {
+            const beforeCount = Router.getRoutes(router).length;
+            // eslint-disable-next-line no-await-in-loop
+            const mod = await entry.loadRoutes();
+            const registerRoutes = isObject(mod) ? mod.registerRoutes : undefined;
+            if (typeof registerRoutes === 'function') {
+                Router.group(router, getServicePrefix(entry), (scopedRouter) => {
+                    registerRoutes(scopedRouter);
+                });
+                annotateManifestRoutes(router, beforeCount, entry.id);
+            }
+        }
+        catch {
+            // Ignore broken optional service routes and keep listing what is available.
+        }
+    }
+};
 const buildRows = async (options) => {
     const groupBy = parseGroupBy(options.groupBy);
     const filterText = typeof options.filter === 'string' ? options.filter.trim().toLowerCase() : '';
@@ -174,12 +211,14 @@ const buildRows = async (options) => {
     catch {
         // routes/api.ts not found, continue with just core routes
     }
+    await registerManifestRoutes(router);
     const routes = Router.getRoutes(router);
     const rows = routes.map((route) => {
         const path = normalizePath(route.path);
+        const serviceId = getRouteServiceId(route);
         let group = '';
         if (groupBy === 'service') {
-            group = deriveService(path);
+            group = serviceId === '' ? deriveService(path) : serviceId;
         }
         else if (groupBy === 'group') {
             group = deriveGroup(path);

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;AAspBvF,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

@@ -168,8 +168,19 @@ const resolveCacheEnabledPreference = (options) => {
         return options.cache;
     return undefined;
 };
-const readPackageJson = (cwd) => {
-    const packagePath = path.join(cwd, 'package.json');
+const findNearestPackageJsonDir = (cwd) => {
+    let current = path.resolve(cwd);
+    while (true) {
+        if (existsSync(path.join(current, 'package.json')))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+};
+const readPackageJsonFromDir = (dir) => {
+    const packagePath = path.join(dir, 'package.json');
     if (!existsSync(packagePath)) {
         throw ErrorFactory.createCliError("Error: No ZinTrust app found. Run 'zin new <project>' or ensure package.json exists.");
     }
@@ -181,6 +192,28 @@ const readPackageJson = (cwd) => {
         throw ErrorFactory.createTryCatchError('Failed to read package.json', error);
     }
 };
+const resolveStartContext = (cwd) => {
+    const projectRoot = findNearestPackageJsonDir(cwd) ?? cwd;
+    const packageDir = findNearestPackageJsonDir(cwd);
+    return {
+        cwd,
+        projectRoot,
+        ...(packageDir === undefined ? {} : { packageJson: readPackageJsonFromDir(packageDir) }),
+    };
+};
+const requirePackageJson = (context) => {
+    if (context.packageJson !== undefined)
+        return context.packageJson;
+    throw ErrorFactory.createCliError("Error: No ZinTrust app found. Run 'zin new <project>' or ensure package.json exists.");
+};
+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;
@@ -263,14 +296,14 @@ const resolveNodeProdCommand = (cwd) => {
     }
     return { command: 'node', args: [compiled] };
 };
-const executeWranglerStart = async (cmd, cwd, port, runtime, envName, wranglerConfig) => {
+const executeWranglerStart = async (cmd, context, port, runtime, envName, wranglerConfig) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime is not supported with --wrangler (Wrangler controls Workers runtime).');
     }
     const normalizedConfig = typeof wranglerConfig === 'string' ? wranglerConfig.trim() : '';
-    const explicitConfigFullPath = normalizedConfig.length > 0 ? path.join(cwd, normalizedConfig) : undefined;
-    const configPath = explicitConfigFullPath ?? findWranglerConfig(cwd);
-    const entry = resolveWranglerEntry(cwd);
+    const explicitConfigFullPath = normalizedConfig.length > 0 ? path.join(context.cwd, normalizedConfig) : undefined;
+    const configPath = explicitConfigFullPath ?? findWranglerConfig(context.cwd);
+    const entry = resolveWranglerEntry(context.cwd);
     if (explicitConfigFullPath !== undefined) {
         if (existsSync(explicitConfigFullPath)) {
             // ok
@@ -300,7 +333,7 @@ const executeWranglerStart = async (cmd, cwd, port, runtime, envName, wranglerCo
     const exitCode = await SpawnUtil.spawnAndWait({
         command: 'wrangler',
         args: wranglerArgs,
-        env: process.env,
+        env: buildStartEnv(context.projectRoot),
     });
     process.exit(exitCode);
 };
@@ -321,92 +354,98 @@ const ensureTmpRunnerFile = (cwd, filename, content) => {
     }
     return fullPath;
 };
-const executeDenoStart = async (cmd, cwd, mode, watchEnabled, _port, runtime) => {
+const executeDenoStart = async (cmd, context, mode, watchEnabled, _port, runtime) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime cannot be used with --deno.');
     }
     if (mode === 'testing') {
         throw ErrorFactory.createCliError('Error: Cannot start server in testing mode. Use development or production.');
     }
-    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(cwd);
-    const denoRunner = ensureTmpRunnerFile(cwd, 'zin-start-deno.ts', createDenoRunnerSource(startModuleSpecifier));
+    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(context.cwd);
+    const denoRunner = ensureTmpRunnerFile(context.cwd, 'zin-start-deno.ts', createDenoRunnerSource(startModuleSpecifier));
     const args = [];
     if (mode === 'development' && watchEnabled)
         args.push('watch');
     args.push(denoRunner);
     cmd.info('Starting in Deno adapter mode...');
-    const exitCode = await SpawnUtil.spawnAndWait({ command: 'tsx', args, env: process.env });
+    const exitCode = await SpawnUtil.spawnAndWait({
+        command: 'tsx',
+        args,
+        env: buildStartEnv(context.projectRoot),
+    });
     process.exit(exitCode);
 };
-const executeLambdaStart = async (cmd, cwd, mode, watchEnabled, _port, runtime) => {
+const executeLambdaStart = async (cmd, context, mode, watchEnabled, _port, runtime) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime cannot be used with --lambda.');
     }
     if (mode === 'testing') {
         throw ErrorFactory.createCliError('Error: Cannot start server in testing mode. Use development or production.');
     }
-    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(cwd);
-    const lambdaRunner = ensureTmpRunnerFile(cwd, 'zin-start-lambda.ts', createLambdaRunnerSource(startModuleSpecifier));
+    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(context.cwd);
+    const lambdaRunner = ensureTmpRunnerFile(context.cwd, 'zin-start-lambda.ts', createLambdaRunnerSource(startModuleSpecifier));
     const args = [];
     if (mode === 'development' && watchEnabled)
         args.push('watch');
     args.push(lambdaRunner);
     cmd.info('Starting in Lambda adapter mode...');
-    const exitCode = await SpawnUtil.spawnAndWait({ command: 'tsx', args, env: process.env });
+    const exitCode = await SpawnUtil.spawnAndWait({
+        command: 'tsx',
+        args,
+        env: buildStartEnv(context.projectRoot),
+    });
     process.exit(exitCode);
 };
-const executeNodeStart = async (cmd, cwd, mode, watchEnabled, _port) => {
+const executeNodeStart = async (cmd, context, mode, watchEnabled, _port) => {
     if (mode === 'testing') {
         throw ErrorFactory.createCliError('Error: Cannot start server in testing mode. Use --force to override (not supported).');
     }
     if (mode === 'development') {
         if (!watchEnabled) {
             cmd.warn('Watch mode disabled; starting once.');
-            const bootstrap = resolveBootstrapEntryTs(cwd);
+            const bootstrap = resolveBootstrapEntryTs(context.cwd);
             const args = bootstrap === undefined ? ['src/index.ts'] : [bootstrap];
             const exitCode = await SpawnUtil.spawnAndWait({
                 command: 'tsx',
                 args,
                 forwardSignals: false,
-                env: process.env,
+                env: buildStartEnv(context.projectRoot),
             });
             process.exit(exitCode);
         }
-        const packageJson = readPackageJson(cwd);
-        const dev = resolveNodeDevCommand(cwd, packageJson);
+        const dev = resolveNodeDevCommand(context.cwd, requirePackageJson(context));
         cmd.info('Starting in development mode (watch enabled)...');
         const exitCode = await SpawnUtil.spawnAndWait({
             command: dev.command,
             args: dev.args,
             forwardSignals: false,
-            env: process.env,
+            env: buildStartEnv(context.projectRoot),
         });
         process.exit(exitCode);
     }
-    const prod = resolveNodeProdCommand(cwd);
+    const prod = resolveNodeProdCommand(context.cwd);
     cmd.info('Starting in production mode...');
     const exitCode = await SpawnUtil.spawnAndWait({
         command: prod.command,
         args: prod.args,
         forwardSignals: false,
-        env: process.env,
+        env: buildStartEnv(context.projectRoot),
     });
     process.exit(exitCode);
 };
-const executeSplitStart = async (cmd, cwd, _options) => {
+const executeSplitStart = async (cmd, context, _options) => {
     cmd.info('🚀 Starting in split mode (Producer + Consumer)...');
-    const packageJson = readPackageJson(cwd);
-    const webDev = resolveNodeDevCommand(cwd, packageJson);
+    const webDev = resolveNodeDevCommand(context.cwd, requirePackageJson(context));
     // Producer Environment
     const producerEnv = {
-        ...process.env,
+        ...buildStartEnv(context.projectRoot),
         WORKER_ENABLED: 'false',
         QUEUE_ENABLED: 'true',
         RUNTIME_MODE: 'node-server',
     };
     // Consumer Environment
     const consumerEnv = {
-        ...process.env,
+        ...buildStartEnv(context.projectRoot),
         WORKER_ENABLED: 'true',
         QUEUE_ENABLED: 'true',
         RUNTIME_MODE: 'containers',
@@ -417,10 +456,10 @@ const executeSplitStart = async (cmd, cwd, _options) => {
     };
     // Resolve Consumer Command (zintrust worker:start-all)
     // We try to use tsx against the source bin if possible
-    const workerArgs = existsSync(path.join(cwd, 'bin/zin.ts'))
+    const workerArgs = existsSync(path.join(context.projectRoot, 'bin/zin.ts'))
         ? ['bin/zin.ts', 'worker:start-all']
         : ['dist/bin/zin.js', 'worker:start-all'];
-    const workerCommand = existsSync(path.join(cwd, 'bin/zin.ts')) ? 'tsx' : 'node';
+    const workerCommand = existsSync(path.join(context.projectRoot, 'bin/zin.ts')) ? 'tsx' : 'node';
     cmd.info('-------------------------------------------');
     cmd.info('🔹 [Producer] Web Server starting...');
     cmd.info('🔸 [Consumer] Worker Process starting...');
@@ -428,12 +467,14 @@ const executeSplitStart = async (cmd, cwd, _options) => {
     const pProducer = SpawnUtil.spawnAndWait({
         command: webDev.command,
         args: webDev.args,
+        cwd: context.cwd,
         env: producerEnv,
         forwardSignals: true,
     });
     const pConsumer = SpawnUtil.spawnAndWait({
         command: workerCommand,
         args: workerArgs,
+        cwd: context.projectRoot,
         env: consumerEnv,
         forwardSignals: true,
     });
@@ -441,7 +482,8 @@ const executeSplitStart = async (cmd, cwd, _options) => {
 };
 const executeStart = async (options, cmd) => {
     const cwd = process.cwd();
-    EnvFileLoader.ensureLoaded();
+    const context = resolveStartContext(cwd);
+    ensureStartEnvLoaded(context);
     const mode = resolveMode(options);
     const port = resolvePort(options);
     const runtime = resolveRuntime(options);
@@ -454,7 +496,7 @@ const executeStart = async (options, cmd) => {
     if (variant === 'lambda')
         effectiveRuntime = 'lambda';
     if (mode === 'split') {
-        await executeSplitStart(cmd, cwd, options);
+        await executeSplitStart(cmd, context, options);
         return;
     }
     assertCompatibleStartVariant(variant, configuredRuntime);
@@ -469,7 +511,7 @@ const executeStart = async (options, cmd) => {
         const wranglerConfig = typeof options.wranglerConfig === 'string' && options.wranglerConfig.trim() !== ''
             ? options.wranglerConfig.trim()
             : undefined;
-        await executeWranglerStart(cmd, cwd, port, runtime, envName === '' ? undefined : envName, wranglerConfig);
+        await executeWranglerStart(cmd, context, port, runtime, envName === '' ? undefined : envName, wranglerConfig);
         return;
     }
     if (envName !== '') {
@@ -477,14 +519,14 @@ const executeStart = async (options, cmd) => {
     }
     const watchEnabled = resolveWatchPreference(options, mode);
     if (variant === 'deno') {
-        await executeDenoStart(cmd, cwd, mode, watchEnabled, port, runtime);
+        await executeDenoStart(cmd, context, mode, watchEnabled, port, runtime);
         return;
     }
     if (variant === 'lambda') {
-        await executeLambdaStart(cmd, cwd, mode, watchEnabled, port, runtime);
+        await executeLambdaStart(cmd, context, mode, watchEnabled, port, runtime);
         return;
     }
-    await executeNodeStart(cmd, cwd, mode, watchEnabled, port);
+    await executeNodeStart(cmd, context, mode, watchEnabled, port);
 };
 export const StartCommand = Object.freeze({
     create() {

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;AAED;;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;AAobD,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

@@ -5,6 +5,10 @@
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
 import { Logger } from '../../config/logger.js';
 import * as path from '../../node-singletons/path.js';
+const coreModuleSpecifier = ['@zintrust', 'core'].join('/');
+const coreStartModuleSpecifier = `${coreModuleSpecifier}/start`;
+const serviceManifestImportExpression = "import('./bootstrap/service-manifest.ts').catch(() => import('./bootstrap/service-manifest.js'))";
+const buildRouteImportExpression = (domain, serviceName) => `import('../services/${domain}/${serviceName}/routes/api.ts').catch(() => import('../services/${domain}/${serviceName}/routes/api.js'))`;
 /**
  * ServiceScaffolder generates microservices with all necessary files
  */
@@ -91,20 +95,22 @@ export function scaffold(projectRoot, options) {
 function ensureProjectRuntimeFiles(projectRoot, options) {
     const domain = options.domain ?? 'default';
     const serviceId = `${domain}/${options.name}`;
+    const routeImportExpression = buildRouteImportExpression(domain, options.name);
     const bootstrapDir = path.join(projectRoot, 'src', 'bootstrap');
     FileGenerator.createDirectory(bootstrapDir);
     const manifestPath = path.join(bootstrapDir, 'service-manifest.ts');
     if (!FileGenerator.fileExists(manifestPath)) {
-        const initialManifest = `import type { ServiceManifestEntry } from '../../index.js';
+        const initialManifest = `import type { ServiceManifestEntry } from '${coreModuleSpecifier}';
 
 export const serviceManifest: ReadonlyArray<ServiceManifestEntry> = [
   {
     id: '${serviceId}',
     domain: '${domain}',
     name: '${options.name}',
+    prefix: '${serviceId}',
     port: ${options.port ?? 3001},
     monolithEnabled: true,
-    loadRoutes: async () => import('../services/${domain}/${options.name}/routes/api'),
+    loadRoutes: async () => ${routeImportExpression},
   },
 ];
 
@@ -112,7 +118,9 @@ export default serviceManifest;
 `;
         FileGenerator.writeFile(manifestPath, initialManifest);
     }
-    const runtimeModule = `import serviceManifest from './bootstrap/service-manifest';
+    const runtimeModule = `const serviceManifestModule = await ${serviceManifestImportExpression};
+
+const serviceManifest = serviceManifestModule.default ?? serviceManifestModule.serviceManifest ?? [];
 
 export { serviceManifest };
 
@@ -128,6 +136,7 @@ export default Object.freeze({ serviceManifest });
 function updateServiceManifest(projectRoot, options) {
     const domain = options.domain ?? 'default';
     const serviceId = `${domain}/${options.name}`;
+    const routeImportExpression = buildRouteImportExpression(domain, options.name);
     const manifestPath = path.join(projectRoot, 'src', 'bootstrap', 'service-manifest.ts');
     if (!FileGenerator.fileExists(manifestPath))
         return;
@@ -139,9 +148,10 @@ function updateServiceManifest(projectRoot, options) {
     id: '${serviceId}',
     domain: '${domain}',
     name: '${options.name}',
+    prefix: '${serviceId}',
     port: ${options.port ?? 3001},
     monolithEnabled: true,
-    loadRoutes: async () => import('../services/${domain}/${options.name}/routes/api'),
+    loadRoutes: async () => ${routeImportExpression},
   },
 `;
     const marker = '];';
@@ -234,7 +244,7 @@ function generateServiceIndex(options) {
  * Auth: ${options.auth ?? 'api-key'}
  */
 
-import { bootStandaloneService } from '../../start.js';
+import { bootStandaloneService } from '${coreStartModuleSpecifier}';
 
 await bootStandaloneService(import.meta.url, {
   id: '${serviceId}',
@@ -244,7 +254,7 @@ await bootStandaloneService(import.meta.url, {
 });
 
 // Cloudflare Workers entry.
-export { default } from '../../start.js';
+export { default } from '${coreStartModuleSpecifier}';
 `;
 }
 /**
@@ -255,7 +265,7 @@ function generateServiceRoutes(options) {
  * ${options.name} Service Routes
  */
 
-import { Router, type IRequest, type IResponse, type IRouter } from '../../index.js';
+import { Router, type IRequest, type IResponse, type IRouter } from '${coreModuleSpecifier}';
 
 export function registerRoutes(router: IRouter): void {
   // Example route
@@ -326,8 +336,7 @@ function generateExampleController(options) {
  * Example Controller for ${options.name} Service
  */
 
-import { type IRequest, type IResponse, Controller } from '../../index.js';
-
+import { type IRequest, type IResponse, Controller } from '${coreModuleSpecifier}';
 const controller = Object.freeze({
   ...Controller,
 
@@ -389,7 +398,7 @@ function generateExampleModel(options) {
  * Example Model for ${options.name} Service
  */
 
-import { Model } from '../../index.js';
+import { Model } from '${coreModuleSpecifier}';
 
 export const Example = Model.define({
   table: '${options.name}',
@@ -447,6 +456,8 @@ function getServiceConfig(options) {
  */
 function generateServiceReadme(options) {
     const config = getServiceConfig(options);
+    const serviceDir = `src/services/${config.domain}/${options.name}`;
+    const serviceId = `${config.domain}/${options.name}`;
     return `# ${options.name} Service
 
 Microservice for ${config.domain} domain.
@@ -460,14 +471,19 @@ Microservice for ${config.domain} domain.
 ## Getting Started
 
 \`\`\`bash
-# Start service
-npm start
+# Start this service from its service directory (Node)
+cd ${serviceDir}
+zin s
+
+# Start this service with Cloudflare Workers dev
+cd ${serviceDir}
+zin s --wg
+
+# List this service routes from the project root
+MICROSERVICES=true SERVICES=${serviceId} zin routes
 
 # Run tests
 npm test
-
-# Run migrations
-npm run migrate
 \`\`\`
 
 ## Environment Variables

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.9
+ * @zintrust/core v0.4.11
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-23T11:19:34.232Z
+ *   Built: 2026-03-23T13:29:47.237Z
  *   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-23T11:19:34.198Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-23T13:29:47.153Z'; // 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/OverrideValueMerge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverrideValueMerge.d.ts","sourceRoot":"","sources":["../../../src/runtime/OverrideValueMerge.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAI,MAAM,OAAO,EAAE,UAAU,OAAO,KAAG,OAYtE,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"OverrideValueMerge.d.ts","sourceRoot":"","sources":["../../../src/runtime/OverrideValueMerge.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAI,MAAM,OAAO,EAAE,UAAU,OAAO,KAAG,OAatE,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/src/runtime/OverrideValueMerge.js

@@ -6,7 +6,8 @@ export const mergeOverrideValues = (base, override) => {
     const merged = { ...base };
     for (const [key, value] of Object.entries(override)) {
         const current = merged[key];
-        merged[key] = isObject(current) && isObject(value) ? mergeOverrideValues(current, value) : value;
+        merged[key] =
+            isObject(current) && isObject(value) ? mergeOverrideValues(current, value) : value;
     }
     return merged;
 };

package/src/templates/project/basic/src/zintrust.runtime.ts.tpl

@@ -1,4 +1,8 @@
-import serviceManifest from './bootstrap/service-manifest';
+const serviceManifestModule = await import('./bootstrap/service-manifest.ts').catch(() =>
+	import('./bootstrap/service-manifest.js')
+);
+
+const serviceManifest = serviceManifestModule.default ?? serviceManifestModule.serviceManifest ?? [];
 
 export { serviceManifest };
 

package/src/templates/project/basic/src/zintrust.runtime.wg.ts.tpl

@@ -1,4 +1,8 @@
-import serviceManifest from './bootstrap/service-manifest';
+const serviceManifestModule = await import('./bootstrap/service-manifest.ts').catch(() =>
+	import('./bootstrap/service-manifest.js')
+);
+
+const serviceManifest = serviceManifestModule.default ?? serviceManifestModule.serviceManifest ?? [];
 
 export { serviceManifest };