@zintrust/core 0.4.55 → 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.55",
+  "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/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;AAggCvF,eAAO,MAAM,YAAY;cACb,YAAY;;mCAp8BU,MAAM,KAAG,OAAO;4CAaP,MAAM,KAAG,MAAM;4CA4Bf,MAAM,KAAG,OAAO;sCAetB,MAAM,WAAW,MAAM,KAAG,OAAO;oCAmBnC,MAAM,KAAG,OAAO;;EAo6BjD,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

@@ -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';

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.55
+ * @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:47:44.856Z
+ *   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:47:44.824Z'; // 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/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;AAyBxC,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,CAW1C,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,11 +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 { ensureNodeStartupEnvLoaded } from './runtime/NodeStartup.js';
-import { ProjectRuntime } from './runtime/ProjectRuntime.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))
@@ -34,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)) {
@@ -104,16 +128,35 @@ export const start = async () => {
     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",