@zintrust/core 0.4.14 → 0.4.16

package/package.json

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

package/src/boot/bootstrap.js

@@ -199,9 +199,11 @@ const BootstrapFunctions = Object.freeze({
             // (This is driven by src/zintrust.plugins.ts generated by `zin plugin install`.)
             try {
                 const { PluginAutoImports } = await import('../runtime/PluginAutoImports.js');
-                const officialImports = await PluginAutoImports.tryImportRuntimeAutoImports('base');
-                if (!officialImports.ok) {
-                    Logger.warn('Official plugin auto-imports failed:', ErrorFactory.createGeneralError('officialImports', officialImports.errorMessage));
+                if (appConfig.dockerWorker === true) {
+                    const officialImports = await PluginAutoImports.tryImportRuntimeAutoImports('base');
+                    if (!officialImports.ok) {
+                        Logger.warn('Official plugin auto-imports failed:', ErrorFactory.createGeneralError('officialImports', officialImports.errorMessage));
+                    }
                 }
                 const projectImports = await PluginAutoImports.tryImportProjectAutoImports();
                 if (!projectImports.ok && projectImports.reason !== 'not-found') {

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;AAiKF,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;AA2LF,eAAO,MAAM,oBAAoB,GAC/B,kBAAkB,MAAM,EACxB,QAAQ,OAAO,KACd,OAAO,CAAC,IAAI,CAqBd,CAAC"}

package/src/boot/registry/registerRoute.js

@@ -89,6 +89,8 @@ const resolveServicePrefix = (entry) => {
 const ensureManifestServiceEnvLoaded = async (entry) => {
     if (isCloudflare)
         return;
+    if (entry.loadEnv === false)
+        return;
     const { EnvFileLoader } = await import('../../cli/utils/EnvFileLoader.js');
     const projectRoot = getProjectRoot();
     const envPath = resolveManifestServiceEnvDir(projectRoot, entry);
@@ -98,6 +100,35 @@ const ensureManifestServiceEnvLoaded = async (entry) => {
         envPaths: [envPath],
     });
 };
+const shouldRegisterManifestEntry = (entry, activeService) => {
+    if (entry.monolithEnabled === false || typeof entry.loadRoutes !== 'function') {
+        return false;
+    }
+    if (activeService !== undefined && activeService.id !== entry.id) {
+        return false;
+    }
+    return true;
+};
+const loadRuntimeManifest = async () => {
+    if (isCloudflare) {
+        await ProjectRuntime.tryLoadWorkerRuntime();
+        return;
+    }
+    await ProjectRuntime.tryLoadNodeRuntime();
+};
+const registerManifestEntryRoutes = async (router, entry, activeService) => {
+    try {
+        await ensureManifestServiceEnvLoaded(entry);
+        const mod = await entry.loadRoutes?.();
+        const registerRoutes = isObject(mod) ? mod.registerRoutes : undefined;
+        if (typeof registerRoutes === 'function') {
+            registerLoadedRoutes(router, entry, registerRoutes, activeService);
+        }
+    }
+    catch (error) {
+        Logger.warn(`Failed to register manifest routes for ${entry.id}`, error);
+    }
+};
 const registerLoadedRoutes = (router, entry, registerRoutes, activeService) => {
     const servicePrefix = resolveServicePrefix(entry);
     if (activeService?.id === entry.id) {
@@ -109,7 +140,7 @@ const registerLoadedRoutes = (router, entry, registerRoutes, activeService) => {
     });
 };
 const registerManifestRoutes = async (router) => {
-    await ProjectRuntime.tryLoadNodeRuntime();
+    await loadRuntimeManifest();
     const serviceManifest = ProjectRuntime.getServiceManifest();
     if (serviceManifest.length === 0)
         return;
@@ -117,25 +148,10 @@ const registerManifestRoutes = async (router) => {
     if (activeService !== undefined && isCloudflare)
         return;
     for (const entry of serviceManifest) {
-        if (entry.monolithEnabled === false || typeof entry.loadRoutes !== 'function') {
+        if (!shouldRegisterManifestEntry(entry, activeService))
             continue;
-        }
-        if (activeService !== undefined && activeService.id !== entry.id) {
-            continue;
-        }
-        try {
-            // eslint-disable-next-line no-await-in-loop
-            await ensureManifestServiceEnvLoaded(entry);
-            // eslint-disable-next-line no-await-in-loop
-            const mod = await entry.loadRoutes();
-            const registerRoutes = isObject(mod) ? mod.registerRoutes : undefined;
-            if (typeof registerRoutes === 'function') {
-                registerLoadedRoutes(router, entry, registerRoutes, activeService);
-            }
-        }
-        catch (error) {
-            Logger.warn(`Failed to register manifest routes for ${entry.id}`, error);
-        }
+        // eslint-disable-next-line no-await-in-loop
+        await registerManifestEntryRoutes(router, entry, activeService);
     }
 };
 const registerFrameworkRoutes = async (resolvedBasePath, router) => {

package/src/cli/PromptHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PromptHelper.d.ts","sourceRoot":"","sources":["../../../src/cli/PromptHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;sBACqB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlE;;OAEG;8BAC6B,MAAM,gBAAe,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAuBrF;;OAEG;6BAEU,MAAM,gBACJ,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAuBlB;;OAEG;uBACqB,MAAM,gBAAsB,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAqBpF;;OAEG;uCAEkB,MAAM,EAAE,gBACd,OAAO,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;OAEG;qBAEQ,MAAM,mBACC,OAAO,gBACV,OAAO,GACnB,OAAO,CAAC,OAAO,CAAC;IAiBnB;;OAEG;wBAEQ,MAAM,WACN,MAAM,EAAE,kBACF,MAAM,gBACR,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;uBAEQ,MAAM,iBACD,MAAM,gBACP,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;EAgBlB,CAAC"}
+{"version":3,"file":"PromptHelper.d.ts","sourceRoot":"","sources":["../../../src/cli/PromptHelper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;sBACqB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlE;;OAEG;8BAC6B,MAAM,gBAAe,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAuBrF;;OAEG;6BAEU,MAAM,gBACJ,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAwBlB;;OAEG;uBACqB,MAAM,gBAAsB,OAAO,GAAU,OAAO,CAAC,MAAM,CAAC;IAqBpF;;OAEG;uCAEkB,MAAM,EAAE,gBACd,OAAO,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;OAEG;qBAEQ,MAAM,mBACC,OAAO,gBACV,OAAO,GACnB,OAAO,CAAC,OAAO,CAAC;IAiBnB;;OAEG;wBAEQ,MAAM,WACN,MAAM,EAAE,kBACF,MAAM,gBACR,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;uBAEQ,MAAM,iBACD,MAAM,gBACP,OAAO,GACnB,OAAO,CAAC,MAAM,CAAC;EAgBlB,CAAC"}

package/src/cli/PromptHelper.js

@@ -54,6 +54,7 @@ export const PromptHelper = Object.freeze({
                     { name: 'PostgreSQL — Production-ready relational DB', value: 'postgresql' },
                     { name: 'MySQL — Production-ready relational DB', value: 'mysql' },
                     { name: 'SQLite — Local dev (file-based)', value: 'sqlite' },
+                    { name: 'd1 — Cloudflare D1 database', value: 'd1' },
                     { name: 'd1-proxy — Cloudflare D1 via HTTPS proxy', value: 'd1-remote' },
                 ],
                 default: defaultDb,

package/src/cli/commands/AddCommand.d.ts

@@ -32,6 +32,9 @@ interface ControllerPromptAnswers {
 interface RoutesPromptAnswers {
     name: string;
 }
+interface MiddlewarePromptAnswers {
+    name: string;
+}
 interface FactoryPromptAnswers {
     name: string;
     model: string;
@@ -80,6 +83,7 @@ export declare const AddCommand: Readonly<{
         promptModelConfig: () => Promise<ModelPromptAnswers>;
         promptControllerConfig: () => Promise<ControllerPromptAnswers>;
         promptRoutesConfig: () => Promise<RoutesPromptAnswers>;
+        promptMiddlewareConfig: () => Promise<MiddlewarePromptAnswers>;
         promptFactoryConfig: () => Promise<FactoryPromptAnswers>;
         promptSeederConfig: () => Promise<SeederPromptAnswers>;
         promptRequestFactoryConfig: () => Promise<RequestFactoryPromptAnswers>;

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

@@ -1 +1 @@
-{"version":3,"file":"AddCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/AddCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarE,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,2CAA2C,CAAC;AAwCnD,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAAC;IAChC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC7C;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,2BAA2B;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,4BAA4B;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsmCD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,YAAY;IAWtB;;;OAGG;;2CAnlC2C,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAAC;mCA2EhD,OAAO,CAAC,oBAAoB,CAAC;qCA8D3B,OAAO,CAAC,sBAAsB,CAAC;iCAwGnC,OAAO,CAAC,kBAAkB,CAAC;sCA4DtB,OAAO,CAAC,uBAAuB,CAAC;kCAwDpC,OAAO,CAAC,mBAAmB,CAAC;mCAkE3B,OAAO,CAAC,oBAAoB,CAAC;kCA8I9B,OAAO,CAAC,mBAAmB,CAAC;0CAiHpB,OAAO,CAAC,2BAA2B,CAAC;yCAwFrC,OAAO,CAAC,MAAM,CAAC;2DAkBpC,MAAM,KAC1B,OAAO,CAAC,4BAA4B,CAAC;4CAoHzB,MAAM,KAClB,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAA;SAAE,CAAC;iDAlE5C,MAAM,KAAG,aAAa,EAAE;;EA+RtE,CAAC"}
+{"version":3,"file":"AddCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/AddCommand.ts"],"names":[],"mappings":"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"}

package/src/cli/commands/AddCommand.js

@@ -24,8 +24,8 @@ import { PluginManager } from '../../runtime/PluginManager.js';
 import inquirer from 'inquirer';
 const addOptions = (command) => {
     command
-        .argument('<type>', 'What to add: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, workflow, or governance')
-        .argument('[name]', 'Name of service/feature/migration/model/controller/factory/seeder/requestfactory/responsefactory/workflow (governance takes no name)')
+        .argument('<type>', 'What to add: service, feature, migration, model, controller, routes, middleware, factory, seeder, requestfactory, responsefactory, workflow, or governance')
+        .argument('[name]', 'Name of service/feature/migration/model/controller/middleware/factory/seeder/requestfactory/responsefactory/workflow (governance takes no name)')
         .option('--package-manager <pm>', 'Specify package manager to use when installing plugins (npm|yarn|pnpm)')
         .option('--domain <name>', 'Service domain (e.g., ecommerce, payments) - for services')
         .option('--database <type>', 'Database (shared|isolated) - for services')
@@ -369,6 +369,119 @@ const addRoutes = async (cmd, routeName, opts) => {
     cmd.info(`File: ${path.basename(result.routeFile)}`);
     cmd.info(`\nNext steps:\n  • Add route definitions\n  • Import controllers\n  • Register in main router`);
 };
+const promptMiddlewareConfig = async () => {
+    return inquirer.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Middleware name (PascalCase, e.g., AuthMiddleware):',
+            validate: (value) => {
+                return /^[A-Z][a-zA-Z\d]*Middleware$/.test(value)
+                    ? true
+                    : 'Must be PascalCase ending with "Middleware"';
+            },
+        },
+    ]);
+};
+const buildMiddlewareKey = (middlewareName) => {
+    const withoutSuffix = middlewareName.replace(/Middleware$/, '');
+    return `${CommonUtils.camelCase(withoutSuffix)}Middleware`;
+};
+const buildMiddlewareSource = (middlewareName) => {
+    return `import type { Middleware } from '../../index.js';
+
+export const ${middlewareName}: Middleware = async (_req, _res, next) => {
+  await next();
+};
+`;
+};
+const registerMiddlewareImport = (configSource, middlewareName) => {
+    const importLine = `import { ${middlewareName} } from '@app/Middleware/${middlewareName}';`;
+    if (configSource.includes(importLine))
+        return configSource;
+    const lines = configSource.split('\n');
+    let insertAt = -1;
+    for (let index = 0; index < lines.length; index += 1) {
+        if (lines[index]?.startsWith('import '))
+            insertAt = index;
+    }
+    if (insertAt === -1) {
+        return `${importLine}\n${configSource}`;
+    }
+    lines.splice(insertAt + 1, 0, importLine);
+    return lines.join('\n');
+};
+const registerMiddlewareRouteKey = (configSource, middlewareName, middlewareKey) => {
+    if (configSource.includes(`${middlewareKey}: ${middlewareName}`)) {
+        return { content: configSource, updated: true };
+    }
+    const routeBlockPattern = /route:\s*\{([\s\S]*?)\n\s*\},/;
+    if (routeBlockPattern.test(configSource)) {
+        return {
+            content: configSource.replace(routeBlockPattern, (_match, inner) => {
+                const prefix = inner.trim() === '' ? '' : inner.replace(/\s*$/, '');
+                const nextInner = prefix === ''
+                    ? `\n    ${middlewareKey}: ${middlewareName},`
+                    : `${prefix}\n    ${middlewareKey}: ${middlewareName},`;
+                return `route: {${nextInner}\n  },`;
+            }),
+            updated: true,
+        };
+    }
+    const closingPattern = /\n\} as MiddlewaresType;\s*$/;
+    if (!closingPattern.test(configSource)) {
+        return { content: configSource, updated: false };
+    }
+    const inserted = configSource.replace(closingPattern, `\n  global: [],\n  route: {\n    ${middlewareKey}: ${middlewareName},\n  },\n} as MiddlewaresType;\n`);
+    return { content: inserted, updated: true };
+};
+const printManualMiddlewareRegistrationSnippet = (cmd, middlewareName, middlewareKey) => {
+    cmd.warn('Could not update config/middleware.ts automatically. Add this manually:');
+    cmd.info(`import { ${middlewareName} } from '@app/Middleware/${middlewareName}';`);
+    cmd.info(`route: { ${middlewareKey}: ${middlewareName} }`);
+    cmd.info(`Route typing example: type AppMiddlewareKey = MiddlewareKey | '${middlewareKey}';`);
+};
+const addMiddleware = async (cmd, middlewareName, opts) => {
+    const projectRoot = process.cwd();
+    let name = middlewareName ?? '';
+    if (name === '' && opts.noInteractive !== true) {
+        const answers = await promptMiddlewareConfig();
+        name = answers.name;
+    }
+    else if (name === '') {
+        throw ErrorFactory.createValidationError('Middleware name is required');
+    }
+    if (!/^[A-Z][a-zA-Z\d]*Middleware$/.test(name)) {
+        throw ErrorFactory.createValidationError('Middleware name must be PascalCase ending with "Middleware"');
+    }
+    const middlewareDir = path.join(projectRoot, 'app', 'Middleware');
+    const middlewarePath = path.join(middlewareDir, `${name}.ts`);
+    const configPath = path.join(projectRoot, 'config', 'middleware.ts');
+    const middlewareKey = buildMiddlewareKey(name);
+    ensureDirectoryExists(middlewareDir);
+    const created = FileGenerator.writeFile(middlewarePath, buildMiddlewareSource(name), {
+        overwrite: false,
+    });
+    if (!FileGenerator.fileExists(configPath)) {
+        cmd.success(`Middleware '${name}' created successfully!`);
+        cmd.warn('config/middleware.ts was not found, so registration was skipped.');
+        printManualMiddlewareRegistrationSnippet(cmd, name, middlewareKey);
+        return;
+    }
+    const currentConfig = FileGenerator.readFile(configPath);
+    const withImport = registerMiddlewareImport(currentConfig, name);
+    const registered = registerMiddlewareRouteKey(withImport, name, middlewareKey);
+    if (!registered.updated) {
+        cmd.success(`Middleware '${name}' created successfully!`);
+        printManualMiddlewareRegistrationSnippet(cmd, name, middlewareKey);
+        return;
+    }
+    fs.writeFileSync(configPath, registered.content, 'utf-8');
+    cmd.success(`Middleware '${name}' ${created ? 'created' : 'updated'} successfully!`);
+    cmd.info(`File: ${path.basename(middlewarePath)}`);
+    cmd.info(`Registered route key: ${middlewareKey}`);
+    cmd.info(`\nNext steps:\n  • Use '${middlewareKey}' in route metadata\n  • If your route file uses MiddlewareKey, extend it locally: type AppMiddlewareKey = MiddlewareKey | '${middlewareKey}'`);
+};
 const getFactoryInitialConfig = (factoryName, opts) => {
     return {
         name: factoryName ?? '',
@@ -833,6 +946,7 @@ const TYPE_HANDLERS = {
     model: addModel,
     controller: addController,
     routes: addRoutes,
+    middleware: addMiddleware,
     factory: addFactory,
     seeder: addSeeder,
     requestfactory: addRequestFactory,
@@ -845,7 +959,7 @@ const TYPE_HANDLERS = {
 const handleType = async (cmd, type, name, opts) => {
     const handler = TYPE_HANDLERS[type];
     if (handler === undefined) {
-        throw ErrorFactory.createCliError(`Unknown type "${type}". Use: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, workflow, or governance`);
+        throw ErrorFactory.createCliError(`Unknown type "${type}". Use: service, feature, migration, model, controller, routes, middleware, factory, seeder, requestfactory, responsefactory, workflow, or governance`);
     }
     await handler(cmd, name, opts);
 };
@@ -874,7 +988,7 @@ const executeAdd = async (cmd, options) => {
     const addOpts = { ...options, ...commandOpts };
     try {
         if (type === undefined || type === '') {
-            throw ErrorFactory.createCliError('Please specify what to add: service, feature, migration, model, controller, routes, factory, or seeder');
+            throw ErrorFactory.createCliError('Please specify what to add: service, feature, migration, model, controller, routes, middleware, factory, or seeder');
         }
         // Planned modular adapter syntax: `zin add db:sqlite` (delegate to plugin installer)
         const normalizedType = type.toLowerCase();
@@ -921,6 +1035,7 @@ export const AddCommand = Object.freeze({
         promptModelConfig,
         promptControllerConfig,
         promptRoutesConfig,
+        promptMiddlewareConfig,
         promptFactoryConfig,
         promptSeederConfig,
         promptRequestFactoryConfig,

package/src/cli/commands/NewCommand.d.ts

@@ -4,7 +4,7 @@
  */
 import type { CommandOptions, IBaseCommand } from '../BaseCommand';
 type TemplateType = 'basic' | 'api' | 'microservice' | 'fullstack';
-type DatabaseType = 'sqlite' | 'mysql' | 'postgresql' | 'mongodb' | 'd1-remote';
+type DatabaseType = 'sqlite' | 'mysql' | 'postgresql' | 'mongodb' | 'd1' | 'd1-remote';
 interface NewProjectConfigResult {
     template: TemplateType;
     database: DatabaseType;

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

@@ -1 +1 @@
-{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAYhF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwPhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AA0RD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}
+{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AAYvF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0PhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AA8RD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}

package/src/cli/commands/NewCommand.js

@@ -54,6 +54,8 @@ const getProjectDefaults = (name, options) => {
         const v = value.trim();
         if (v === 'd1-proxy')
             return 'd1-remote';
+        if (v === 'd1')
+            return 'd1';
         if (v === 'd1-remote')
             return 'd1-remote';
         if (v === 'sqlite')
@@ -99,6 +101,7 @@ const getQuestions = (name, defaults) => {
                 { name: 'sqlite — Local dev (file-based)', value: 'sqlite' },
                 { name: 'postgresql — Production-ready relational DB', value: 'postgresql' },
                 { name: 'mysql — Production-ready relational DB', value: 'mysql' },
+                { name: 'd1 — Cloudflare D1 database', value: 'd1' },
                 { name: 'd1-proxy — Cloudflare D1 via HTTPS proxy', value: 'd1-remote' },
                 { name: 'mongodb — Document DB (may require additional setup)', value: 'mongodb' },
             ],
@@ -223,7 +226,7 @@ const installDependencies = async (projectPath, log, packageManager, force = fal
 const addOptions = (command) => {
     command.argument('<name>', 'Project name');
     command.option('--template <type>', 'Project template (basic, api, microservice, fullstack)', 'basic');
-    command.option('--database <type>', 'Database driver (sqlite, mysql, postgresql)', 'sqlite');
+    command.option('--database <type>', 'Database driver (sqlite, mysql, postgresql, d1, d1-remote, mongodb)', 'sqlite');
     command.option('--port <number>', 'Default port number', '7777');
     command.option('--author <name>', 'Project author');
     command.option('--description <text>', 'Project description');

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;AA21BvF,eAAO,MAAM,YAAY;cACb,YAAY;EAmCtB,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;AAs4BvF,eAAO,MAAM,YAAY;cACb,YAAY;EAmCtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -2,9 +2,9 @@ import { BaseCommand } from '../BaseCommand.js';
 import { createDenoRunnerSource, createLambdaRunnerSource } from '../commands/runner/index.js';
 import { EnvFileLoader } from '../utils/EnvFileLoader.js';
 import { SpawnUtil } from '../utils/spawn.js';
-import { generateUuid } from '../../common/utility.js';
 import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import * as Common from '../../common/index.js';
+import { generateUuid } from '../../common/utility.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { isNonEmptyString } from '../../helper/index.js';
 import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from '../../node-singletons/fs.js';
@@ -303,7 +303,7 @@ const preloadManifestServiceEnv = async (context, options) => {
     process.env['ZINTRUST_PROJECT_ROOT'] = context.projectRoot;
     ProjectRuntime.clear();
     await ProjectRuntime.tryLoadNodeRuntime();
-    const manifest = ProjectRuntime.getServiceManifest().filter((entry) => entry.monolithEnabled !== false);
+    const manifest = ProjectRuntime.getServiceManifest().filter((entry) => entry.monolithEnabled !== false && entry.loadEnv !== false);
     if (manifest.length === 0)
         return;
     const envPaths = manifest
@@ -418,6 +418,7 @@ const executeWranglerStart = async (cmd, context, port, runtime, envName, wrangl
     if (configPath === undefined && entry === undefined) {
         throw ErrorFactory.createCliError("Error: wrangler config not found (wrangler.toml/json). Run 'wrangler init' first.");
     }
+    warnOnUnsafeWranglerBootstrap(cmd, context.cwd, entry);
     const wranglerArgs = ['dev'];
     if (normalizedConfig !== '') {
         wranglerArgs.push('--config', normalizedConfig);
@@ -434,14 +435,42 @@ const executeWranglerStart = async (cmd, context, port, runtime, envName, wrangl
     logMySqlProxyHint(cmd);
     cmd.info('Starting in Wrangler dev mode...');
     const exitCode = await withWranglerEnvSnapshot(context.cwd, envName, async () => {
+        const startEnv = {
+            ...buildStartEnv(context.projectRoot),
+            WORKER_ENABLED: 'false',
+            CLOUDFLARE_WORKER: 'true',
+            DOCKER_WORKER: 'false',
+        };
         return SpawnUtil.spawnAndWait({
             command: 'wrangler',
             args: wranglerArgs,
-            env: buildStartEnv(context.projectRoot),
+            env: startEnv,
         });
     });
     process.exit(exitCode);
 };
+const isUnsafeWranglerBootstrapSource = (source) => {
+    const getKernelIndex = source.indexOf('getKernel(');
+    const cloudflareFetchIndex = source.indexOf('cloudflareWorker.fetch');
+    return (getKernelIndex !== -1 && cloudflareFetchIndex !== -1 && getKernelIndex < cloudflareFetchIndex);
+};
+const warnOnUnsafeWranglerBootstrap = (cmd, cwd, entry) => {
+    if (entry === undefined)
+        return;
+    const entryPath = path.join(cwd, entry);
+    if (!existsSync(entryPath))
+        return;
+    try {
+        const source = readFileSync(entryPath, 'utf-8');
+        if (!isUnsafeWranglerBootstrapSource(source))
+            return;
+        cmd.warn(`Unsafe Worker bootstrap detected in ${entry}: getKernel() runs before the core Cloudflare handler initializes Worker bindings.`);
+        cmd.warn('Use `export { default } from "../../start.js"` and keep custom middleware registration in config/middleware.ts or route metadata.');
+    }
+    catch {
+        // Best-effort warning only.
+    }
+};
 const ensureTmpRunnerFile = (cwd, filename, content) => {
     const tmpDir = path.join(cwd, 'tmp');
     try {

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AAodD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA4ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}
+{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AAodD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA6ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}

package/src/cli/scaffolding/ProjectScaffolder.js

@@ -480,6 +480,7 @@ dist/
 .env
 .env.*
 .env.local
+.dev*
 .DS_Store
 coverage/
 logs/

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;AAaD;;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;AAkcD,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;AAaD;;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;AAocD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -110,6 +110,7 @@ export const serviceManifest: ReadonlyArray<ServiceManifestEntry> = [
     name: '${options.name}',
     configRoot: '${getServiceConfigRoot(domain, options.name)}',
     prefix: '${serviceId}',
+    loadEnv: false,
     port: ${options.port ?? 3001},
     monolithEnabled: true,
     loadRoutes: async () => ${routeImportExpression},
@@ -152,6 +153,7 @@ function updateServiceManifest(projectRoot, options) {
     name: '${options.name}',
     configRoot: '${getServiceConfigRoot(domain, options.name)}',
     prefix: '${serviceId}',
+    loadEnv: false,
     port: ${options.port ?? 3001},
     monolithEnabled: true,
     loadRoutes: async () => ${routeImportExpression},

package/src/config/middleware.d.ts

@@ -1,4 +1,5 @@
 import type { MiddlewareConfigType } from './type';
+import type { Middleware } from '../middleware/MiddlewareStack';
 export declare const MiddlewareBody: {
     readonly email: "email";
     readonly password: "password";
@@ -6,7 +7,7 @@ export declare const MiddlewareBody: {
     readonly count: "count";
 };
 export type MiddlewaresType = {
-    skipPaths: string[];
+    skipPaths: ReadonlyArray<string>;
     fillRateLimit: {
         windowMs: number;
         max: number;
@@ -22,6 +23,8 @@ export type MiddlewaresType = {
         max: number;
         message: string;
     };
+    global?: ReadonlyArray<Middleware>;
+    route?: Record<string, Middleware>;
 };
 export declare const MiddlewareKeys: Readonly<{
     log: true;

package/src/config/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAiEzD,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAkBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AA2MxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CAkC7D;AAID;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,IAE7C,CAAC;AAwBF,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAUzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAwD9D,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,MAAM,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAkBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AAoOxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CAwC7D;AAID;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,IAE7C,CAAC;AAwBF,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/config/middleware.js

@@ -1,4 +1,5 @@
 import { Env } from './env.js';
+import { isArray, isObject } from '../helper/index.js';
 import { bodyParsingMiddleware } from '../http/middleware/BodyParsingMiddleware.js';
 import { fileUploadMiddleware } from '../http/middleware/FileUploadMiddleware.js';
 import { AuthMiddleware } from '../middleware/AuthMiddleware.js';
@@ -157,6 +158,22 @@ function createSharedMiddlewares(loadMiddlewareConfig) {
         ...validations,
     });
 }
+const resolveProjectGlobalMiddlewares = (loadMiddlewareConfig) => {
+    if (!isArray(loadMiddlewareConfig.global))
+        return [];
+    return loadMiddlewareConfig.global.filter((middleware) => {
+        return typeof middleware === 'function';
+    });
+};
+const resolveProjectRouteMiddlewares = (loadMiddlewareConfig) => {
+    if (!isObject(loadMiddlewareConfig.route))
+        return {};
+    const entries = Object.entries(loadMiddlewareConfig.route).filter((entry) => {
+        const [name, middleware] = entry;
+        return typeof name === 'string' && name.trim() !== '' && typeof middleware === 'function';
+    });
+    return Object.fromEntries(entries);
+};
 export function createMiddlewareConfig() {
     const loadMiddlewareConfig = StartupConfigFileRegistry.get(StartupConfigFile.Middleware) ?? {};
     const skipPathsFromEnv = Env.get('CSRF_SKIP_PATHS', '')
@@ -170,6 +187,8 @@ export function createMiddlewareConfig() {
             : skipPathsFromEnv,
     };
     const shared = createSharedMiddlewares(effectiveMiddlewareConfig);
+    const projectGlobal = resolveProjectGlobalMiddlewares(effectiveMiddlewareConfig);
+    const projectRoute = resolveProjectRouteMiddlewares(effectiveMiddlewareConfig);
     const middlewareConfigObj = {
         global: [
             shared.log,
@@ -180,8 +199,12 @@ export function createMiddlewareConfig() {
             bodyParsingMiddleware,
             shared.csrf,
             shared.sanitizeBody,
+            ...projectGlobal,
         ],
-        route: shared,
+        route: {
+            ...shared,
+            ...projectRoute,
+        },
     };
     return Object.freeze(middlewareConfigObj);
 }

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.14
+ * @zintrust/core v0.4.16
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-23T16:59:39.933Z
+ *   Built: 2026-03-24T13:49:16.905Z
  *   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-23T16:59:39.858Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-24T13:49:16.870Z'; // 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

@@ -5,6 +5,7 @@ export interface ServiceManifestEntry {
     name: string;
     prefix?: string;
     configRoot?: string;
+    loadEnv?: boolean;
     version?: string;
     description?: string;
     port?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"ServiceManifest.d.ts","sourceRoot":"","sources":["../../../src/microservices/ServiceManifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ServiceManifest.d.ts","sourceRoot":"","sources":["../../../src/microservices/ServiceManifest.ts"],"names":[],"mappings":"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"}

package/src/microservices/ServiceManifest.js

@@ -50,6 +50,10 @@ export const isServiceManifestEntry = (value) => {
     if (configRoot !== undefined && typeof configRoot !== 'string') {
         return false;
     }
+    const loadEnv = value['loadEnv'];
+    if (loadEnv !== undefined && typeof loadEnv !== 'boolean') {
+        return false;
+    }
     const loadRoutes = value['loadRoutes'];
     if (loadRoutes !== undefined && !isFunction(loadRoutes)) {
         return false;
@@ -64,6 +68,7 @@ export const normalizeServiceManifest = (value) => {
         id: toCanonicalServiceId(entry),
         prefix: getServicePrefix(entry),
         ...(isNonEmptyString(entry.configRoot) ? { configRoot: entry.configRoot } : {}),
+        loadEnv: entry.loadEnv !== false,
         monolithEnabled: entry.monolithEnabled !== false,
     }));
 };

package/src/middleware/CsrfMiddleware.d.ts

@@ -17,7 +17,7 @@ export interface CsrfOptions {
      * - `/api/*`
      * - `/api/v1/auth/login`
      */
-    skipPaths?: string[];
+    skipPaths?: ReadonlyArray<string>;
 }
 export declare const CsrfMiddleware: Readonly<{
     /**

package/src/middleware/CsrfMiddleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CsrfMiddleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/CsrfMiddleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAK9D,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAkDD,eAAO,MAAM,cAAc;IACzB;;OAEG;qBACa,WAAW,GAAQ,UAAU;EA6D7C,CAAC"}
+{"version":3,"file":"CsrfMiddleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/CsrfMiddleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAK9D,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAkDD,eAAO,MAAM,cAAc;IACzB;;OAEG;qBACa,WAAW,GAAQ,UAAU;EA6D7C,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectRuntime.d.ts","sourceRoot":"","sources":["../../../src/runtime/ProjectRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AA+ExC,eAAO,MAAM,cAAc;aAChB,IAAI;iBAIA,oBAAoB,GAAG,SAAS;gBAIjC,OAAO,GAAG,oBAAoB;oCAIV,OAAO,GAAG,oBAAoB,GAAG,SAAS;0BAM9C,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;4BAgBvC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;0BAejD,aAAa,CAAC,oBAAoB,CAAC;wBAIrC,oBAAoB,GAAG,SAAS;EAGpD,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"ProjectRuntime.d.ts","sourceRoot":"","sources":["../../../src/runtime/ProjectRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAoGxC,eAAO,MAAM,cAAc;aAChB,IAAI;iBAIA,oBAAoB,GAAG,SAAS;gBAIjC,OAAO,GAAG,oBAAoB;oCAIV,OAAO,GAAG,oBAAoB,GAAG,SAAS;0BAM9C,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;4BAgBvC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;0BAOjD,aAAa,CAAC,oBAAoB,CAAC;wBAIrC,oBAAoB,GAAG,SAAS;EAGpD,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/runtime/ProjectRuntime.js

@@ -52,10 +52,27 @@ const tryImportNodeRuntimeCandidate = async (candidate) => {
         return undefined;
     }
 };
-const tryImportWorkerRuntimeCandidate = async (moduleId) => {
+const tryImportWorkerRuntimeLiteralCandidates = async () => {
     try {
-        const runtimeModule = (await import(moduleId));
-        return cacheProjectRuntime(runtimeModule);
+        return cacheProjectRuntime((await import('../zintrust.runtime.wg.js')));
+    }
+    catch {
+        // continue
+    }
+    try {
+        return cacheProjectRuntime((await import('../zintrust.runtime.js')));
+    }
+    catch {
+        // continue
+    }
+    try {
+        return cacheProjectRuntime((await import('../index.js' + 'zintrust.runtime.wg.js')));
+    }
+    catch {
+        // continue
+    }
+    try {
+        return cacheProjectRuntime((await import('../index.js' + 'zintrust.runtime.js')));
     }
     catch {
         return undefined;
@@ -95,14 +112,7 @@ export const ProjectRuntime = Object.freeze({
         const cached = getCachedProjectRuntime();
         if (hasLoadedServiceManifest(cached))
             return cached;
-        const workerModuleIds = ['../' + 'zintrust.runtime.wg.js', '../' + 'zintrust.runtime.js'];
-        for (const moduleId of workerModuleIds) {
-            // eslint-disable-next-line no-await-in-loop
-            const loaded = await tryImportWorkerRuntimeCandidate(moduleId);
-            if (loaded !== undefined)
-                return loaded;
-        }
-        return undefined;
+        return tryImportWorkerRuntimeLiteralCandidates();
     },
     getServiceManifest() {
         return getCachedProjectRuntime()?.serviceManifest ?? [];

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

@@ -1 +1 @@
-{"version":3,"file":"WorkerAdapterImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkerAdapterImports.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,oBAAoB;;;EAG/B,CAAC"}
+{"version":3,"file":"WorkerAdapterImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkerAdapterImports.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,oBAAoB;;;EAG/B,CAAC"}

package/src/runtime/WorkerAdapterImports.js

@@ -1,8 +1,25 @@
 // Worker-only adapter auto-imports for bundler-based runtimes (e.g. Cloudflare Workers).
 // Keep this list limited to database adapters needed by runtime config.
+import { ProjectRuntime } from './ProjectRuntime.js';
+const tryImportProjectRuntime = async () => {
+    try {
+        ProjectRuntime.set(await import('../zintrust.runtime.wg.js'));
+        return;
+    }
+    catch {
+        // continue
+    }
+    try {
+        ProjectRuntime.set(await import('../zintrust.runtime.js'));
+    }
+    catch {
+        // Ignore missing runtime modules. Worker startup can still proceed without them.
+    }
+};
 // These imports resolve against the host project (developer working directory)
 // via the @/ alias configured by the ZinTrust app templates.
 const tryImportOptional = async () => {
+    await tryImportProjectRuntime();
     try {
         await import('../zintrust.plugins.wg.js');
     }

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

@@ -1 +1 @@
-{"version":3,"file":"WorkersModule.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkersModule.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,cAAc,mBAAmB,CAAC,CAAC;AACxD,KAAK,kBAAkB,GAAG,cAAc,yBAAyB,CAAC,CAAC;AA+TnE,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,aAAa,CAwB/D,CAAC;AA2CF,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,kBAAkB,CAiBzE,CAAC"}
+{"version":3,"file":"WorkersModule.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkersModule.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,cAAc,mBAAmB,CAAC,CAAC;AACxD,KAAK,kBAAkB,GAAG,cAAc,yBAAyB,CAAC,CAAC;AA4WnE,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,aAAa,CAwB/D,CAAC;AA4CF,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,kBAAkB,CAkBzE,CAAC"}

package/src/runtime/WorkersModule.js

@@ -194,6 +194,9 @@ const importLocalModule = async (packageDir, packageName) => {
 };
 const importLocalWorkersModule = async () => importLocalModule('workers', '@zintrust/workers');
 const importLocalQueueMonitorModule = async () => importLocalModule('queue-monitor', '@zintrust/queue-monitor');
+const importOptionalPackage = async (specifier) => {
+    return (await import(specifier));
+};
 let workersModulePromise;
 let patchAttempted = false;
 let patchAfterFailureAttempted = false;
@@ -234,12 +237,35 @@ const applyInitialPatches = () => {
         Logger.warn('Rewrote @zintrust/queue-monitor ESM specifiers before import', monitorPatch);
     }
 };
+const getErrorChain = (error) => {
+    const chain = [];
+    const seen = new Set();
+    let current = error;
+    while (current !== null && current !== undefined && !seen.has(current)) {
+        seen.add(current);
+        const entry = current;
+        chain.push({
+            message: typeof entry.message === 'string' && entry.message !== '' ? entry.message : String(current),
+            code: typeof entry.code === 'string' ? entry.code : undefined,
+        });
+        current = entry.cause;
+    }
+    return chain;
+};
 const shouldRetryAfterFailure = (error) => {
     if (patchAfterFailureAttempted)
         return false;
-    const message = error instanceof Error ? error.message : String(error);
-    const code = error?.code;
-    return code === 'ERR_MODULE_NOT_FOUND' && message.includes('@zintrust/workers');
+    return getErrorChain(error).some(({ message, code }) => code === 'ERR_MODULE_NOT_FOUND' && message.includes('@zintrust/workers'));
+};
+const isMissingOptionalWorkersModuleError = (error) => {
+    return getErrorChain(error).some(({ message, code }) => {
+        if (!message.includes('@zintrust/workers'))
+            return false;
+        return (code === 'ERR_MODULE_NOT_FOUND' ||
+            message.includes('ERR_MODULE_NOT_FOUND') ||
+            message.includes('Cannot find package') ||
+            message.includes('No such module'));
+    });
 };
 const handleImportFailure = async (error) => {
     if (shouldRetryAfterFailure(error)) {
@@ -250,8 +276,13 @@ const handleImportFailure = async (error) => {
                 filesChanged,
                 replacements,
             });
-            workersModulePromise = import('@zintrust/workers');
-            return workersModulePromise;
+            workersModulePromise = importOptionalPackage('@zintrust/workers');
+            try {
+                return await workersModulePromise;
+            }
+            catch (retryError) {
+                error = retryError;
+            }
         }
     }
     const localFallback = await importLocalWorkersModule();
@@ -259,6 +290,11 @@ const handleImportFailure = async (error) => {
         workersModulePromise = Promise.resolve(localFallback);
         return localFallback;
     }
+    if (isMissingOptionalWorkersModuleError(error)) {
+        Logger.info('Optional @zintrust/workers package is unavailable; worker routes are disabled.');
+        workersModulePromise = Promise.resolve(createDisabledWorkersModule());
+        return workersModulePromise;
+    }
     throw error;
 };
 const tryLocalFallback = async () => {
@@ -283,7 +319,7 @@ export const loadWorkersModule = async () => {
         }
     }
     logWorkersResolverDiagnostics();
-    workersModulePromise ??= import('@zintrust/workers');
+    workersModulePromise ??= importOptionalPackage('@zintrust/workers');
     try {
         return await workersModulePromise;
     }
@@ -307,7 +343,8 @@ const handleQueueMonitorImportFailure = async (error) => {
                 filesChanged,
                 replacements,
             });
-            queueMonitorModulePromise = import('@zintrust/queue-monitor');
+            queueMonitorModulePromise =
+                importOptionalPackage('@zintrust/queue-monitor');
             return queueMonitorModulePromise;
         }
     }
@@ -334,7 +371,8 @@ export const loadQueueMonitorModule = async () => {
             return localFallback;
         }
     }
-    queueMonitorModulePromise ??= import('@zintrust/queue-monitor');
+    queueMonitorModulePromise ??=
+        importOptionalPackage('@zintrust/queue-monitor');
     try {
         return await queueMonitorModulePromise;
     }

package/src/templates/project/basic/config/middleware.ts.tpl

@@ -1,14 +1,21 @@
 // @ts-ignore - config templates are excluded from the main TS project in this repo
+import { Env } from '@zintrust/core';
+import type { MiddlewaresType } from '@zintrust/core';
 /**
  * Middleware Configuration (template)
  *
- * Keep this file declarative:
- * - Core owns middleware construction / any runtime behavior.
- * - Projects can override by editing `middlewareConfigObj`.
+ * Full project middleware flow:
+ * 1. Create `app/Middleware/YourMiddleware.ts` and export a `Middleware` function.
+ * 2. Import it below.
+ * 3. Register route middleware under `route` or append global middleware under `global`.
+ * 4. Use the route key in `routes/*.ts`.
+ *
+ * For custom route keys, extend the framework type locally in your route file:
+ * `type AppMiddlewareKey = MiddlewareKey | 'yourMiddleware';`
  */
 
-import { Env } from '@zintrust/core';
-import type { MiddlewaresType } from '@zintrust/core';
+// Example custom middleware import:
+// import { AuthMiddleware } from '@app/Middleware/AuthMiddleware';
 
 export default {
   skipPaths: Env.get('CSRF_SKIP_PATHS', '')
@@ -30,4 +37,10 @@ export default {
     max: 20,
     message: 'Too many user mutation requests, please try again later.',
   },
+  global: [
+    // AuthMiddleware,
+  ],
+  route: {
+    // authMiddleware: AuthMiddleware,
+  },
 } as MiddlewaresType;

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

@@ -6,3 +6,8 @@
  */
 
 // Intentionally empty by default.
+
+import { ProjectRuntime } from '@zintrust/core';
+import serviceManifest from './bootstrap/service-manifest';
+
+ProjectRuntime.set({ serviceManifest });