@zintrust/core 0.4.54 → 0.4.56

package/README.md

@@ -21,6 +21,8 @@ zin start
 
 Your API is now running at `http://localhost:7777`
 
+Fresh projects also include a default flat ESLint setup through `@zintrust/governance/eslint`, so `npm run lint` works immediately after scaffolding.
+
 If you’re targeting a different runtime:
 
 - Cloudflare Workers (Wrangler): `zin start --wg`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.54",
+  "version": "0.4.56",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -57,6 +57,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
+    "@cloudflare/containers": "^0.2.0",
+    "@zintrust/workers": "0.4.50",
     "bcryptjs": "^3.0.3",
     "bullmq": "^5.71.1",
     "chalk": "^5.6.2",

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,EAAU,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAc3D,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;AA2LF,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,MAAM,EACxB,QAAQ,OAAO,KACd,OAAO,CAAC,IAAI,CAqBd,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;AAc3D,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;AAoMF,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,MAAM,EACxB,QAAQ,OAAO,KACd,OAAO,CAAC,IAAI,CAqBd,CAAC"}

package/src/boot/registry/registerRoute.js

@@ -86,6 +86,13 @@ const resolveServicePrefix = (entry) => {
     }
     return `/${entry.domain}/${entry.name}`;
 };
+const shouldPreferRootEnvInMonolith = () => {
+    if (typeof process === 'undefined' || process.env === undefined)
+        return false;
+    const raw = process.env['RUN_AS_MONOLITH'] ?? '';
+    const normalized = raw.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+};
 const ensureManifestServiceEnvLoaded = async (entry) => {
     if (isCloudflare)
         return;
@@ -98,6 +105,7 @@ const ensureManifestServiceEnvLoaded = async (entry) => {
         cwd: projectRoot,
         includeCwd: true,
         envPaths: [envPath],
+        envPathsOverrideExisting: !shouldPreferRootEnvInMonolith(),
     });
 };
 const shouldRegisterManifestEntry = (entry, activeService) => {

package/src/boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/boot.ts"],"names":[],"mappings":"AAoCA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/boot.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC"}

package/src/boot.js

@@ -1,30 +1,6 @@
-import { isNodeRuntime } from './runtime/detectRuntime.js';
-import { resolveNodeProjectRoot } from './runtime/resolveNodeProjectRoot.js';
-const ensureNodeBootstrapEnv = async () => {
-    if (!isNodeRuntime())
-        return;
-    const projectRoot = await resolveNodeProjectRoot();
-    if ((process.env?.['ZINTRUST_PROJECT_ROOT'] ?? '').trim() === '') {
-        process.env['ZINTRUST_PROJECT_ROOT'] = projectRoot;
-    }
-    const [{ EnvFileLoader }, { Logger }, { existsSync }, path] = await Promise.all([
-        import('./cli/utils/EnvFileLoader.js'),
-        import('./config/logger.js'),
-        import('./node-singletons/fs.js'),
-        import('./node-singletons/path.js'),
-    ]);
-    const state = EnvFileLoader.ensureLoaded({
-        cwd: projectRoot,
-        includeCwd: true,
-    });
-    if (state.loadedFiles.length > 0)
-        return;
-    const resolvedDotEnv = path.join(projectRoot, '.env');
-    Logger.warn('Node bootstrap started without loaded env files.', {
-        projectRoot,
-        resolvedDotEnv: existsSync(resolvedDotEnv) ? resolvedDotEnv : 'missing',
-        entry: '@zintrust/core/boot',
-    });
-};
-await ensureNodeBootstrapEnv();
+import { ensureNodeStartupEnvLoaded } from './runtime/NodeStartup.js';
+await ensureNodeStartupEnvLoaded({
+    entry: '@zintrust/core/boot',
+    warnOnMissingEnv: true,
+});
 await import('./boot/bootstrap.js');

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;AA2+BvF,eAAO,MAAM,YAAY;cACb,YAAY;;mCAn7BU,MAAM,KAAG,OAAO;4CAaP,MAAM,KAAG,MAAM;4CA4Bf,MAAM,KAAG,OAAO;sCAetB,MAAM,WAAW,MAAM,KAAG,OAAO;oCAmBnC,MAAM,KAAG,OAAO;;EAm5BjD,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;AAsgCvF,eAAO,MAAM,YAAY;cACb,YAAY;;mCA18BU,MAAM,KAAG,OAAO;4CAaP,MAAM,KAAG,MAAM;4CA4Bf,MAAM,KAAG,OAAO;sCAetB,MAAM,WAAW,MAAM,KAAG,OAAO;oCAmBnC,MAAM,KAAG,OAAO;;EA06BjD,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../BaseCommand.js';
 import { withWranglerDevVarsSnapshot } from '../cloudflare/CloudflareWranglerDevEnv.js';
-import { createDenoRunnerSource, createLambdaRunnerSource } from '../commands/runner/index.js';
+import { createDenoRunnerSource, createLambdaRunnerSource, createNodeRunnerSource, } from '../commands/runner/index.js';
 import { EnvFileLoader } from '../utils/EnvFileLoader.js';
 import { SpawnUtil } from '../utils/spawn.js';
 import { readEnvString } from '../../common/ExternalServiceUtils.js';
@@ -337,6 +337,10 @@ const buildStartEnv = (projectRoot) => ({
     ...process.env,
     ZINTRUST_PROJECT_ROOT: projectRoot,
 });
+const shouldPreferRootEnvInMonolith = () => {
+    const raw = readEnvString('RUN_AS_MONOLITH').trim().toLowerCase();
+    return raw === '1' || raw === 'true' || raw === 'yes' || raw === 'on';
+};
 const resolveManifestServiceEnvDir = (projectRoot, entry) => {
     const configRoot = entry.configRoot;
     if (isNonEmptyString(configRoot)) {
@@ -375,6 +379,7 @@ const preloadManifestServiceEnv = async (context, options) => {
         cwd: context.projectRoot,
         includeCwd: resolveRootEnvPreference(options),
         envPaths,
+        envPathsOverrideExisting: !shouldPreferRootEnvInMonolith(),
     });
 };
 const isFrameworkRepo = (packageJson) => packageJson.name === '@zintrust/core';
@@ -415,17 +420,25 @@ const resolveRuntimeStartModuleSpecifier = (cwd) => {
     }
     return '@zintrust/core/start';
 };
-const resolveNodeDevCommand = (cwd, packageJson) => {
-    if (isFrameworkRepo(packageJson)) {
-        const bootstrap = resolveBootstrapEntryTs(cwd);
-        return { command: 'tsx', args: ['watch', bootstrap ?? 'src/index.ts'] };
+const resolveRuntimeCompiledStartModuleSpecifier = (cwd) => {
+    const localCompiledStart = path.join(cwd, 'dist', 'src', 'start.js');
+    if (existsSync(localCompiledStart)) {
+        return '../dist/src/start.js';
     }
-    const bootstrap = resolveBootstrapEntryTs(cwd);
-    if (bootstrap !== undefined) {
-        return { command: 'tsx', args: ['watch', bootstrap] };
-    }
-    if (existsSync(path.join(cwd, 'src/index.ts'))) {
-        return { command: 'tsx', args: ['watch', 'src/index.ts'] };
+    return '@zintrust/core/start';
+};
+const hasNodeSourceEntrypoint = (cwd) => {
+    return resolveBootstrapEntryTs(cwd) !== undefined || existsSync(path.join(cwd, 'src/index.ts'));
+};
+const ensureNodeSourceRunner = (cwd) => {
+    return ensureTmpRunnerFile(cwd, 'zin-start-node.ts', createNodeRunnerSource(resolveRuntimeStartModuleSpecifier(cwd)));
+};
+const ensureNodeCompiledRunner = (cwd) => {
+    return ensureTmpRunnerFile(cwd, 'zin-start-node.mjs', createNodeRunnerSource(resolveRuntimeCompiledStartModuleSpecifier(cwd)));
+};
+const resolveNodeDevCommand = (cwd, packageJson) => {
+    if (isFrameworkRepo(packageJson) || hasNodeSourceEntrypoint(cwd)) {
+        return { command: 'tsx', args: ['watch', ensureNodeSourceRunner(cwd)] };
     }
     // Fallback: if the app provides a dev script, run it.
     // IMPORTANT: avoid calling `npm run dev` when the dev script itself invokes `zin`/`zintrust`
@@ -440,24 +453,16 @@ const resolveNodeDevCommand = (cwd, packageJson) => {
 };
 const resolveNodeProdCommand = (cwd) => {
     const compiledBoot = path.join(cwd, 'dist/src/boot/bootstrap.js');
-    let compiled;
     if (existsSync(compiledBoot) && !runFromSource()) {
-        compiled = 'dist/src/boot/bootstrap.js';
+        return { command: 'node', args: [ensureNodeCompiledRunner(cwd)] };
     }
     // If compiled app isn't available (or the env forces running from source),
     // fall back to running the source entry with `tsx` so developers can test
     // core files with production semantics without building.
-    if (compiled === undefined) {
-        const bootstrap = resolveBootstrapEntryTs(cwd);
-        if (bootstrap !== undefined) {
-            return { command: 'tsx', args: [bootstrap] };
-        }
-        if (existsSync(path.join(cwd, 'src/index.ts'))) {
-            return { command: 'tsx', args: ['src/index.ts'] };
-        }
-        throw ErrorFactory.createCliError("Error: Compiled app not found at dist/src/boot/bootstrap.js. Run 'npm run build' first or set ZINTRUST_RUN_FROM_SOURCE=1 to run source in production.");
+    if (hasNodeSourceEntrypoint(cwd)) {
+        return { command: 'tsx', args: [ensureNodeSourceRunner(cwd)] };
     }
-    return { command: 'node', args: [compiled] };
+    throw ErrorFactory.createCliError("Error: Compiled app not found at dist/src/boot/bootstrap.js. Run 'npm run build' first or set ZINTRUST_RUN_FROM_SOURCE=1 to run source in production.");
 };
 const resolveWranglerDevConfig = (context, wranglerConfig) => {
     const normalizedConfig = typeof wranglerConfig === 'string' ? wranglerConfig.trim() : '';
@@ -612,13 +617,15 @@ const executeNodeStart = async (cmd, context, mode, watchEnabled, _port) => {
     if (mode === 'development') {
         if (!watchEnabled) {
             cmd.warn('Watch mode disabled; starting once.');
-            const bootstrap = resolveBootstrapEntryTs(context.cwd);
-            const args = bootstrap === undefined ? ['src/index.ts'] : [bootstrap];
+            const args = [ensureNodeSourceRunner(context.cwd)];
             const exitCode = await SpawnUtil.spawnAndWait({
                 command: 'tsx',
                 args,
                 forwardSignals: false,
-                env: buildStartEnv(context.projectRoot),
+                env: {
+                    ...buildStartEnv(context.projectRoot),
+                    ZINTRUST_BOOTSTRAP_PREFERENCE: 'source',
+                },
             });
             process.exit(exitCode);
         }
@@ -628,7 +635,10 @@ const executeNodeStart = async (cmd, context, mode, watchEnabled, _port) => {
             command: dev.command,
             args: dev.args,
             forwardSignals: false,
-            env: buildStartEnv(context.projectRoot),
+            env: {
+                ...buildStartEnv(context.projectRoot),
+                ZINTRUST_BOOTSTRAP_PREFERENCE: 'source',
+            },
         });
         process.exit(exitCode);
     }
@@ -638,7 +648,10 @@ const executeNodeStart = async (cmd, context, mode, watchEnabled, _port) => {
         command: prod.command,
         args: prod.args,
         forwardSignals: false,
-        env: buildStartEnv(context.projectRoot),
+        env: {
+            ...buildStartEnv(context.projectRoot),
+            ZINTRUST_BOOTSTRAP_PREFERENCE: runFromSource() ? 'source' : 'compiled',
+        },
     });
     process.exit(exitCode);
 };

package/src/cli/commands/runner/index.d.ts

@@ -1,3 +1,4 @@
 export declare const createDenoRunnerSource: (startModuleSpecifier: string) => string;
 export declare const createLambdaRunnerSource: (startModuleSpecifier: string) => string;
+export declare const createNodeRunnerSource: (startModuleSpecifier: string) => string;
 //# sourceMappingURL=index.d.ts.map

package/src/cli/commands/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/runner/index.ts"],"names":[],"mappings":"AAoJA,eAAO,MAAM,sBAAsB,GAAI,sBAAsB,MAAM,KAAG,MAErE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,sBAAsB,MAAM,KAAG,MAEvE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/runner/index.ts"],"names":[],"mappings":"AA2JA,eAAO,MAAM,sBAAsB,GAAI,sBAAsB,MAAM,KAAG,MAErE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,sBAAsB,MAAM,KAAG,MAEvE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,sBAAsB,MAAM,KAAG,MAErE,CAAC"}

package/src/cli/commands/runner/index.js

@@ -142,9 +142,18 @@ const lambdaRunnerTemplate = [
     '});',
     '',
 ].join('\n');
+const nodeRunnerTemplate = [
+    `import { start } from ${START_MODULE_PLACEHOLDER};`,
+    '',
+    'await start();',
+    '',
+].join('\n');
 export const createDenoRunnerSource = (startModuleSpecifier) => {
     return injectStartModuleSpecifier(denoRunnerTemplate, startModuleSpecifier);
 };
 export const createLambdaRunnerSource = (startModuleSpecifier) => {
     return injectStartModuleSpecifier(lambdaRunnerTemplate, startModuleSpecifier);
 };
+export const createNodeRunnerSource = (startModuleSpecifier) => {
+    return injectStartModuleSpecifier(nodeRunnerTemplate, startModuleSpecifier);
+};

package/src/cli/scaffolding/GovernanceScaffolder.js

@@ -65,7 +65,7 @@ const inferGovernanceVersion = (pkg) => {
 };
 const writeEslintConfig = (projectRoot) => {
     const eslintConfigPath = path.join(projectRoot, 'eslint.config.mjs');
-    const content = `import { zintrustAppEslintConfig } from '@zintrust/governance';
+    const content = `import { zintrustAppEslintConfig } from '@zintrust/governance/eslint';
 
 export default zintrustAppEslintConfig({
   tsconfigRootDir: import.meta.dirname,

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

@@ -4,6 +4,7 @@ type LoadOptions = {
     includeCwd?: boolean;
     extraCwds?: string[];
     envPaths?: string[];
+    envPathsOverrideExisting?: boolean;
     overrideExisting?: boolean;
 };
 type 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":"AASA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AA8IzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,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;AAaF,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;AAwMF,eAAO,MAAM,aAAa;qBAjDH,WAAW,KAAQ,SAAS;6BAapB,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,KAAQ,SAAS;mCAG/C,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}
+{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AASA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AA8IzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,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;AAaF,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;AAyMF,eAAO,MAAM,aAAa;qBAjDH,WAAW,KAAQ,SAAS;6BAapB,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,KAAQ,SAAS;mCAG/C,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}

package/src/cli/utils/EnvFileLoader.js

@@ -207,6 +207,7 @@ const createLoadPlan = (options) => {
     const extraCwds = normalizeCwdList(options.extraCwds);
     const envPaths = normalizeEnvPathList(options.envPaths);
     const overrideExisting = options.overrideExisting ?? true;
+    const envPathsOverrideExisting = options.envPathsOverrideExisting ?? true;
     const sources = [];
     if (includeCwd) {
         sources.push({
@@ -230,7 +231,7 @@ const createLoadPlan = (options) => {
             key: `${looksLikeFile ? 'file' : 'cwd'}:${envPath}`,
             path: envPath,
             kind: looksLikeFile ? 'file' : 'cwd',
-            overrideExisting: true,
+            overrideExisting: envPathsOverrideExisting,
         });
     }
     return sources.filter((source, index, items) => items.findIndex((item) => item.key === source.key) === index);

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.54
+ * @zintrust/core v0.4.56
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-04T15:24:52.580Z
+ *   Built: 2026-04-04T16:43:22.388Z
  *   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-04-04T15:24:52.546Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-04T16:43:22.354Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/runtime/NodeStartup.d.ts

@@ -0,0 +1,14 @@
+type NodeStartupLoadState = {
+    loadedFiles: string[];
+    mode?: string;
+};
+type EnsureNodeStartupEnvOptions = {
+    entry: string;
+    warnOnMissingEnv?: boolean;
+};
+export declare const ensureNodeStartupEnvLoaded: (options: EnsureNodeStartupEnvOptions) => Promise<NodeStartupLoadState | undefined>;
+declare const _default: Readonly<{
+    ensureNodeStartupEnvLoaded: (options: EnsureNodeStartupEnvOptions) => Promise<NodeStartupLoadState | undefined>;
+}>;
+export default _default;
+//# sourceMappingURL=NodeStartup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeStartup.d.ts","sourceRoot":"","sources":["../../../src/runtime/NodeStartup.ts"],"names":[],"mappings":"AAGA,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAmBF,eAAO,MAAM,0BAA0B,GACrC,SAAS,2BAA2B,KACnC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAuB1C,CAAC;;0CAxBS,2BAA2B,KACnC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;;AAyB5C,wBAEG"}

package/src/runtime/NodeStartup.js

@@ -0,0 +1,39 @@
+import { isNodeRuntime } from './detectRuntime.js';
+import { resolveNodeProjectRoot } from './resolveNodeProjectRoot.js';
+let pendingNodeStartupEnv;
+const warnOnMissingEnvFiles = async (projectRoot, entry) => {
+    const [{ Logger }, { existsSync }, path] = await Promise.all([
+        import('../config/logger.js'),
+        import('../node-singletons/fs.js'),
+        import('../node-singletons/path.js'),
+    ]);
+    const resolvedDotEnv = path.join(projectRoot, '.env');
+    Logger.warn('Node bootstrap started without loaded env files.', {
+        projectRoot,
+        resolvedDotEnv: existsSync(resolvedDotEnv) ? resolvedDotEnv : 'missing',
+        entry,
+    });
+};
+export const ensureNodeStartupEnvLoaded = async (options) => {
+    if (!isNodeRuntime())
+        return undefined;
+    pendingNodeStartupEnv ??= (async () => {
+        const projectRoot = await resolveNodeProjectRoot();
+        if ((process.env?.['ZINTRUST_PROJECT_ROOT'] ?? '').trim() === '') {
+            process.env['ZINTRUST_PROJECT_ROOT'] = projectRoot;
+        }
+        const { EnvFileLoader } = await import('../cli/utils/EnvFileLoader.js');
+        const state = EnvFileLoader.ensureLoaded({
+            cwd: projectRoot,
+            includeCwd: true,
+        });
+        if (options.warnOnMissingEnv === true && state.loadedFiles.length === 0) {
+            await warnOnMissingEnvFiles(projectRoot, options.entry);
+        }
+        return state;
+    })();
+    return pendingNodeStartupEnv;
+};
+export default Object.freeze({
+    ensureNodeStartupEnvLoaded,
+});

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectBootstrap.d.ts","sourceRoot":"","sources":["../../../src/runtime/ProjectBootstrap.ts"],"names":[],"mappings":"AAgCA,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU1D;;;;AAED,wBAEG"}
+{"version":3,"file":"ProjectBootstrap.d.ts","sourceRoot":"","sources":["../../../src/runtime/ProjectBootstrap.ts"],"names":[],"mappings":"AA2CA,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU1D;;;;AAED,wBAEG"}

package/src/runtime/ProjectBootstrap.js

@@ -8,11 +8,20 @@ const getProjectRoot = () => {
         return fromEnv.trim();
     return process.cwd();
 };
-const getBootstrapCandidates = (projectRoot) => [
-    path.join(projectRoot, 'src', 'boot', 'bootstrap.ts'),
-    path.join(projectRoot, 'dist', 'src', 'boot', 'bootstrap.js'),
-    path.join(projectRoot, 'src', 'boot', 'bootstrap.js'),
-];
+const getBootstrapPreference = () => {
+    const raw = process.env?.['ZINTRUST_BOOTSTRAP_PREFERENCE'] ?? '';
+    return raw.trim().toLowerCase() === 'compiled' ? 'compiled' : 'source';
+};
+const getBootstrapCandidates = (projectRoot) => {
+    const sourceCandidates = [
+        path.join(projectRoot, 'src', 'boot', 'bootstrap.ts'),
+        path.join(projectRoot, 'src', 'boot', 'bootstrap.js'),
+    ];
+    const compiledCandidate = path.join(projectRoot, 'dist', 'src', 'boot', 'bootstrap.js');
+    return getBootstrapPreference() === 'compiled'
+        ? [compiledCandidate, ...sourceCandidates]
+        : [sourceCandidates[0], compiledCandidate, sourceCandidates[1]];
+};
 const tryImportBootstrapCandidate = async (candidate) => {
     if (!existsSync(candidate))
         return false;

package/src/start.d.ts

@@ -8,17 +8,22 @@ export declare const bootStandaloneService: (importMetaUrl: string, activeServic
  * This uses a non-literal dynamic import so Worker bundlers don't pull Node-only modules.
  */
 export declare const start: () => Promise<void>;
+declare const cloudflareWorker: Readonly<{
+    fetch: (request: Request, env: unknown, ctx: unknown) => Promise<Response>;
+}>;
+declare const deno: (request: Request) => Promise<Response>;
+declare const handler: (event: unknown, context: unknown) => Promise<unknown>;
 /**
  * Cloudflare Workers entry (module worker style).
  */
-export { default } from './functions/cloudflare';
-export { default as cloudflareWorker } from './functions/cloudflare';
+export default cloudflareWorker;
+export { cloudflareWorker };
 /**
  * Deno fetch handler.
  */
-export { default as deno } from './functions/deno';
+export { deno };
 /**
  * AWS Lambda handler.
  */
-export { handler } from './functions/lambda';
+export { handler };
 //# sourceMappingURL=start.d.ts.map

package/src/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/start.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAwBxC,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,KAAG,OAYlD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,eAAe,OAAO,KAAG,oBASnE,CAAC;AAoEF,eAAO,MAAM,qBAAqB,GAChC,eAAe,MAAM,EACrB,eAAe,OAAO,KACrB,OAAO,CAAC,oBAAoB,CAS9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAO1C,CAAC;AAEF;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;GAEG;AACH,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAqExC,eAAO,MAAM,UAAU,GAAI,eAAe,MAAM,KAAG,OAYlD,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,eAAe,OAAO,KAAG,oBAOnE,CAAC;AAoEF,eAAO,MAAM,qBAAqB,GAChC,eAAe,MAAM,EACrB,eAAe,OAAO,KACrB,OAAO,CAAC,oBAAoB,CAS9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAW1C,CAAC;AAiBF,QAAA,MAAM,gBAAgB;qBAfkB,OAAO,OAAO,OAAO,OAAO,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;EAiB7F,CAAC;AAEH,QAAA,MAAM,IAAI,GAAU,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAKtD,CAAC;AAEF,QAAA,MAAM,OAAO,GAAU,OAAO,OAAO,EAAE,SAAS,OAAO,KAAG,OAAO,CAAC,OAAO,CAKxE,CAAC;AAEF;;GAEG;AACH,eAAe,gBAAgB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/src/start.js

@@ -1,10 +1,35 @@
-import { ErrorFactory } from './exceptions/ZintrustError.js';
 import { isArray, isNonEmptyString, isObject } from './helper/index.js';
 import { ZintrustLang } from './lang/lang.js';
 import { normalizeActiveServiceRuntime, } from './microservices/ServiceManifest.js';
-import { ProjectRuntime } from './runtime/ProjectRuntime.js';
+import { ensureNodeStartupEnvLoaded } from './runtime/NodeStartup.js';
 import { resolveNodeProjectRoot } from './runtime/resolveNodeProjectRoot.js';
 import { isNodeRuntime } from './runtime/detectRuntime.js';
+const getProjectRuntimeGlobal = () => globalThis;
+const getCachedProjectRuntime = () => {
+    return getProjectRuntimeGlobal().__zintrustProjectRuntime;
+};
+const setCachedProjectRuntime = (value) => {
+    const current = getCachedProjectRuntime();
+    const next = Object.freeze({
+        ...(current?.serviceManifest === undefined ? {} : { serviceManifest: current.serviceManifest }),
+        ...(current?.activeService === undefined ? {} : { activeService: current.activeService }),
+        ...(value.serviceManifest === undefined ? {} : { serviceManifest: value.serviceManifest }),
+        ...(value.activeService === undefined ? {} : { activeService: value.activeService }),
+    });
+    getProjectRuntimeGlobal().__zintrustProjectRuntime = next;
+    return next;
+};
+const createValidationError = (message) => {
+    // eslint-disable-next-line no-restricted-syntax
+    const error = new Error(message);
+    error.name = 'ValidationError';
+    error.statusCode = 400;
+    error.code = 'VALIDATION_ERROR';
+    return error;
+};
+const loadCloudflareWorker = async () => {
+    return (await import('./functions/cloudflare.js'));
+};
 const isAbsolutePath = (value) => value.startsWith('/') || /^[A-Za-z]:[\\/]/.test(value);
 const fileUrlToPathLike = (value) => {
     if (!value.startsWith(ZintrustLang.FILE_PROTOCOL))
@@ -33,9 +58,9 @@ export const isNodeMain = (importMetaUrl) => {
 export const configureStandaloneService = (activeService) => {
     const normalized = normalizeActiveServiceRuntime(activeService);
     if (normalized === undefined) {
-        throw ErrorFactory.createValidationError('Standalone service runtime requires at least domain and name.');
+        throw createValidationError('Standalone service runtime requires at least domain and name.');
     }
-    return ProjectRuntime.set({ activeService: normalized }).activeService ?? normalized;
+    return setCachedProjectRuntime({ activeService: normalized }).activeService ?? normalized;
 };
 const normalizeStandaloneEnvPaths = (value) => {
     if (isNonEmptyString(value)) {
@@ -97,19 +122,41 @@ export const bootStandaloneService = async (importMetaUrl, activeService) => {
 export const start = async () => {
     if (!isNodeRuntime())
         return;
+    await ensureNodeStartupEnvLoaded({
+        entry: '@zintrust/core/start',
+    });
     const projectBootstrapModule = (await import('./runtime/ProjectBootstrap.js'));
     await projectBootstrapModule.loadProjectBootstrap();
 };
+const cloudflareFetch = async (request, env, ctx) => {
+    const worker = await loadCloudflareWorker();
+    if (typeof worker.fetch === 'function') {
+        return worker.fetch(request, env, ctx);
+    }
+    const callable = worker;
+    return callable(request, env, ctx);
+};
+const cloudflareWorker = Object.freeze({
+    fetch: cloudflareFetch,
+});
+const deno = async (request) => {
+    const module = (await import('./functions/deno.js'));
+    return module.default(request);
+};
+const handler = async (event, context) => {
+    const module = (await import('./functions/lambda.js'));
+    return module.handler(event, context);
+};
 /**
  * Cloudflare Workers entry (module worker style).
  */
-export { default } from './functions/cloudflare.js';
-export { default as cloudflareWorker } from './functions/cloudflare.js';
+export default cloudflareWorker;
+export { cloudflareWorker };
 /**
  * Deno fetch handler.
  */
-export { default as deno } from './functions/deno.js';
+export { deno };
 /**
  * AWS Lambda handler.
  */
-export { handler } from './functions/lambda.js';
+export { handler };

package/src/templates/project/basic/eslint.config.mjs.tpl

@@ -0,0 +1,5 @@
+import { zintrustAppEslintConfig } from '@zintrust/governance/eslint';
+
+export default zintrustAppEslintConfig({
+  tsconfigRootDir: import.meta.dirname,
+});

package/src/templates/project/basic/package.json.tpl

@@ -6,17 +6,19 @@
   "scripts": {
     "dev": "zin s",
     "build": "tsc && tsc-alias",
+    "lint": "eslint .",
     "start": "zin s --mode production --no-watch",
     "test": "vitest run",
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
     "@zintrust/core": "^{{coreVersion}}",
-    "@zintrust/d1-migrator": "^0.4.6",
-    "@zintrust/governance": "{{governanceVersion}}"
+    "@zintrust/d1-migrator": "^0.4.6"
   },
   "devDependencies": {
+    "@zintrust/governance": "{{governanceVersion}}",
     "@types/node": "^25.0.3",
+    "eslint": "^10.0.0",
     "tsx": "^4.21.0",
     "tsc-alias": "^1.8.16",
     "typescript": "^5.9.3",