@zintrust/core 0.1.1 → 0.1.3

package/README.md

@@ -16,7 +16,7 @@ cd my-app
 npm run dev
 ```
 
-Your API is now running at `http://localhost:3000`
+Your API is now running at `http://localhost:7777`
 
 ## What is Zintrust?
 
@@ -159,10 +159,10 @@ Test it:
 
 ```bash
 # Get all users
-curl http://localhost:3000/api/users
+curl http://localhost:7777/api/users
 
 # Create a user
-curl -X POST http://localhost:3000/api/users \
+curl -X POST http://localhost:7777/api/users \
   -H "Content-Type: application/json" \
   -d '{"name":"John","email":"john@example.com"}'
 ```

package/bin/zintrust.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust.d.ts","sourceRoot":"","sources":["../../bin/zintrust.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AA8CH,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust.d.ts","sourceRoot":"","sources":["../../bin/zintrust.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAmEH,OAAO,EAAE,CAAC"}

package/bin/zintrust.js

@@ -11,7 +11,24 @@ async function main() {
         EnvFileLoader.ensureLoaded();
         const { CLI } = await import('../src/cli/CLI');
         const cli = CLI.create();
-        await cli.run(process.argv.slice(2));
+        // When executing via tsx (e.g. `npx tsx bin/zin.ts ...`), the script path can
+        // appear as the first element of `process.argv.slice(2)`. Commander expects
+        // args to start at the command name, so we strip a leading script path if present.
+        const rawArgs = process.argv.slice(2);
+        if (process.env['ZINTRUST_CLI_DEBUG_ARGS'] === '1') {
+            try {
+                process.stderr.write(`[zintrust-cli] process.argv=${JSON.stringify(process.argv)}\n`);
+                process.stderr.write(`[zintrust-cli] rawArgs=${JSON.stringify(rawArgs)}\n`);
+            }
+            catch {
+                // ignore
+            }
+        }
+        const args = rawArgs.length > 0 &&
+            (rawArgs[0]?.endsWith('.ts') === true || rawArgs[0]?.endsWith('.js') === true)
+            ? rawArgs.slice(1)
+            : rawArgs;
+        await cli.run(args);
     }
     catch (error) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -13,6 +13,20 @@
   "type": "module",
   "main": "src/index.js",
   "types": "src/index.d.ts",
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "better-sqlite3": "^12.5.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "inquirer": "^13.1.0",
+    "jsonwebtoken": "^9.0.3",
+    "tsx": "^4.21.0"
+  },
+  "overrides": {
+    "node-forge": "1.3.3",
+    "cross-spawn": "^7.0.5",
+    "glob": "^11.1.0"
+  },
   "bin": {
     "zintrust": "bin/zintrust.js",
     "zin": "bin/zin.js",

package/src/boot/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAmB,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,kBAAkB,CAAC;AAMxD,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,OAAO,CAAC;IACpB,aAAa,IAAI,OAAO,CAAC;IACzB,YAAY,IAAI,OAAO,CAAC;IACxB,SAAS,IAAI,OAAO,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,WAAW,IAAI,MAAM,CAAC;CACvB;AAqJD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EAwCvC,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAmB,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,kBAAkB,CAAC;AAOxD,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,OAAO,CAAC;IACpB,aAAa,IAAI,OAAO,CAAC;IACzB,YAAY,IAAI,OAAO,CAAC;IACxB,SAAS,IAAI,OAAO,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,WAAW,IAAI,MAAM,CAAC;CACvB;AA2LD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EAmDvC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/src/boot/Application.js

@@ -2,11 +2,14 @@
  * Application - Framework core entry point
  * Handles application lifecycle, booting, and environment
  */
+import { appConfig } from '../config';
 import { ServiceContainer } from '../container/ServiceContainer';
+import { StartupHealthChecks } from '../health/StartupHealthChecks';
 import { MiddlewareStack } from '../middleware/MiddlewareStack';
 import { Router } from '../routing/Router';
-import { Env } from '../config/env';
+import { FeatureFlags } from '../config/features';
 import { Logger } from '../config/logger';
+import { StartupConfigValidator } from '../config/StartupConfigValidator';
 import * as path from '../node-singletons/path';
 import { pathToFileURL } from '../node-singletons/url';
 const ShutdownManager = Object.freeze({
@@ -89,11 +92,41 @@ const registerRoutes = async (resolvedBasePath, router) => {
         Logger.error('Failed to register routes:', error);
     }
 };
+const initializeArtifactDirectories = async (resolvedBasePath) => {
+    if (resolvedBasePath === '')
+        return;
+    if (typeof process === 'undefined')
+        return;
+    let nodeFs;
+    try {
+        nodeFs = await import('../node-singletons/fs');
+    }
+    catch {
+        return;
+    }
+    const dirs = ['logs', 'storage', 'tmp'];
+    for (const dir of dirs) {
+        const fullPath = path.join(resolvedBasePath, dir);
+        try {
+            if (!nodeFs.existsSync(fullPath)) {
+                nodeFs.mkdirSync(fullPath, { recursive: true });
+                Logger.info(`✓ Created directory: ${dir}`);
+            }
+        }
+        catch (error) {
+            Logger.warn(`Failed to create ${dir} directory`, error);
+        }
+    }
+};
 const createLifecycle = (params) => {
     const boot = async () => {
         if (params.getBooted())
             return;
         Logger.info(`🚀 Booting Zintrust Application in ${params.environment} mode...`);
+        StartupConfigValidator.assertValid();
+        FeatureFlags.initialize();
+        await StartupHealthChecks.assertHealthy();
+        await initializeArtifactDirectories(params.resolvedBasePath);
         await registerRoutes(params.resolvedBasePath, params.router);
         // Register service providers
         // Bootstrap services
@@ -123,7 +156,7 @@ export const Application = Object.freeze({
     create(basePath) {
         const resolvedBasePath = resolveBasePath(basePath);
         const joinFromBase = makeJoinFromBase(resolvedBasePath);
-        const environment = Env.get('NODE_ENV', 'development');
+        const environment = appConfig.environment;
         const container = ServiceContainer.create();
         const router = Router.createRouter();
         const middlewareStack = MiddlewareStack.create();
@@ -131,6 +164,16 @@ export const Application = Object.freeze({
         let booted = false;
         registerCorePaths(container, resolvedBasePath, joinFromBase);
         registerCoreInstances({ container, environment, router, middlewareStack, shutdownManager });
+        // Register framework-level shutdown hooks for long-lived resources
+        // ConnectionManager may not be initialized; shutdownIfInitialized is safe
+        // Use dynamic import without top-level await to avoid transforming the module into an async module
+        import('../orm/ConnectionManager')
+            .then(({ ConnectionManager }) => {
+            shutdownManager.add(async () => ConnectionManager.shutdownIfInitialized());
+        })
+            .catch(() => {
+            /* ignore import failures in restrictive runtimes */
+        });
         const { boot, shutdown } = createLifecycle({
             environment,
             resolvedBasePath,
@@ -147,7 +190,7 @@ export const Application = Object.freeze({
             isBooted: () => booted,
             isDevelopment: () => environment === 'development',
             isProduction: () => environment === 'production',
-            isTesting: () => environment === 'testing' || environment === 'test',
+            isTesting: () => environment === 'testing',
             getEnvironment: () => environment,
             getRouter: () => router,
             getContainer: () => container,

package/src/boot/Server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../../src/boot/Server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAQjD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAK9C,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;CAC9B;AA4ND;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;gBACS,YAAY,SAAS,MAAM,SAAS,MAAM,GAAG,OAAO;EA8BhE,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Server.d.ts","sourceRoot":"","sources":["../../../src/boot/Server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAI9C,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;CAC9B;AA2ND;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;gBACS,YAAY,SAAS,MAAM,SAAS,MAAM,GAAG,OAAO;EA8BhE,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/src/boot/Server.js

@@ -2,6 +2,7 @@
  * Server - HTTP Server implementation
  * Uses Node.js built-in HTTP server with no external dependencies
  */
+import { esmDirname } from '../common/index';
 import { appConfig } from '../config/app';
 import { HTTP_HEADERS, MIME_TYPES } from '../config/constants';
 import { Logger } from '../config/logger';
@@ -11,7 +12,6 @@ import { Response } from '../http/Response';
 import * as fs from '../node-singletons/fs';
 import * as http from '../node-singletons/http';
 import * as path from '../node-singletons/path';
-import { fileURLToPath } from '../node-singletons/url';
 import { Router } from '../routing/Router';
 const MIME_TYPES_MAP = {
     '.html': MIME_TYPES.HTML,
@@ -43,8 +43,7 @@ const findPackageRoot = (startDir) => {
     return startDir;
 };
 const getFrameworkPublicRoots = () => {
-    const thisFile = fileURLToPath(import.meta.url);
-    const thisDir = path.dirname(thisFile);
+    const thisDir = esmDirname(import.meta.url);
     const packageRoot = findPackageRoot(thisDir);
     return [
         path.join(packageRoot, 'dist/public'),
@@ -53,7 +52,7 @@ const getFrameworkPublicRoots = () => {
     ];
 };
 const getDocsPublicRoot = () => {
-    const isProduction = process.env.NODE_ENV === 'production';
+    const isProduction = appConfig.isProduction();
     // First try app-local roots (developer app override), then fall back to framework-shipped assets.
     const appRoots = isProduction
         ? [path.join(process.cwd(), 'public')]

package/src/boot/bootstrap.js

@@ -8,6 +8,48 @@ import { Server } from './Server';
 import { Env } from '../config/env';
 import { Logger } from '../config/logger';
 import { ErrorFactory } from '../exceptions/ZintrustError';
+let appInstance;
+let serverInstance;
+let isShuttingDown = false;
+const withTimeout = async (promise, timeoutMs, label) => {
+    if (timeoutMs <= 0)
+        return promise;
+    let timeoutId;
+    try {
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = globalThis.setTimeout(() => {
+                reject(ErrorFactory.createGeneralError(label, { timeoutMs }));
+            }, timeoutMs);
+        });
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        if (timeoutId !== undefined)
+            globalThis.clearTimeout(timeoutId);
+    }
+};
+const gracefulShutdown = async (signal) => {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    const timeoutMs = Number(Env.SHUTDOWN_TIMEOUT);
+    Logger.info(`${signal} received, shutting down gracefully...`);
+    try {
+        await withTimeout((async () => {
+            if (serverInstance !== undefined) {
+                await serverInstance.close();
+            }
+            if (appInstance !== undefined) {
+                await appInstance.shutdown();
+            }
+        })(), timeoutMs, 'Graceful shutdown timed out');
+        process.exit(0);
+    }
+    catch (error) {
+        Logger.error('Graceful shutdown failed:', error);
+        process.exit(1);
+    }
+};
 /**
  * Bootstrap implementation
  */
@@ -19,6 +61,7 @@ const BootstrapFunctions = Object.freeze({
         try {
             // Create application instance
             const app = Application.create();
+            appInstance = app;
             // Boot application
             await app.boot();
             // Get port and host from environment
@@ -26,9 +69,39 @@ const BootstrapFunctions = Object.freeze({
             const host = Env.get('HOST', 'localhost');
             // Create and start server
             const server = Server.create(app, port, host);
+            serverInstance = server;
             // Start listening
             await server.listen();
             Logger.info(`Server running at http://${host}:${port}`);
+            // Start schedules for long-running runtimes (Node.js / Fargate)
+            try {
+                const runtime = (await import('../runtime/RuntimeDetector')).RuntimeDetector.detectRuntime();
+                if (runtime === 'nodejs' || runtime === 'fargate') {
+                    const { create: createScheduleRunner } = await import('../scheduler/ScheduleRunner');
+                    const schedules = await import('../schedules');
+                    const runner = createScheduleRunner();
+                    for (const schedule of Object.values(schedules)) {
+                        // Each schedule is expected to export a default ISchedule
+                        // @ts-ignore
+                        runner.register(schedule);
+                    }
+                    runner.start();
+                    // Add shutdown hook to stop schedules gracefully
+                    const shutdownManager = app.getContainer().get('shutdownManager');
+                    if ((typeof shutdownManager === 'object' || typeof shutdownManager === 'function') &&
+                        shutdownManager !== null &&
+                        'add' in shutdownManager &&
+                        typeof shutdownManager.add === 'function') {
+                        shutdownManager.add(async () => {
+                            const scheduleTimeoutMs = Env.getInt('SCHEDULE_SHUTDOWN_TIMEOUT_MS', 30000);
+                            await runner.stop(scheduleTimeoutMs);
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                Logger.warn('Failed to start schedules:', err);
+            }
         }
         catch (error) {
             Logger.error('Failed to bootstrap application:', error);
@@ -40,13 +113,11 @@ const BootstrapFunctions = Object.freeze({
      * Handle graceful shutdown
      */
     setupShutdownHandler() {
-        process.on('SIGTERM', () => {
-            Logger.info('SIGTERM received, shutting down gracefully...');
-            process.exit(0);
+        process.on('SIGTERM', async () => {
+            await gracefulShutdown('SIGTERM');
         });
-        process.on('SIGINT', () => {
-            Logger.info('SIGINT received, shutting down gracefully...');
-            process.exit(0);
+        process.on('SIGINT', async () => {
+            await gracefulShutdown('SIGINT');
         });
     },
 });

package/src/builder/BundleOptimizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BundleOptimizer.d.ts","sourceRoot":"","sources":["../../../src/builder/BundleOptimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;oBACa,mBAAmB,GAAG,gBAAgB;EA0CtD,CAAC;AAyXH;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAclD"}
+{"version":3,"file":"BundleOptimizer.d.ts","sourceRoot":"","sources":["../../../src/builder/BundleOptimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;oBACa,mBAAmB,GAAG,gBAAgB;EA0CtD,CAAC;AA4XH;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAclD"}

package/src/builder/BundleOptimizer.js

@@ -8,7 +8,7 @@
  */
 import { Logger } from '../config/logger';
 import fs from '../node-singletons/fs';
-import * as path from 'node:path';
+import * as path from '../node-singletons/path';
 /**
  * Bundle optimizer - reduces deployed package size
  * Sealed namespace for immutability
@@ -125,17 +125,19 @@ function printAnalysis(analysis) {
  */
 async function analyze(distDir, options) {
     const files = await getFilesRecursive(distDir);
-    let totalSize = 0;
+    // Collect sizes concurrently but avoid shared mutable state by computing sizes
+    // and then reducing the total afterwards to avoid race conditions.
     const fileAnalysis = await Promise.all(files.map(async (file) => {
         const stats = await fs.promises.stat(file);
         const size = stats.size;
-        totalSize += size;
         return {
             path: path.relative(distDir, file),
             size,
             percentage: 0,
         };
     }));
+    // Compute total size in a single pass (no shared mutation)
+    const totalSize = fileAnalysis.reduce((acc, f) => acc + f.size, 0);
     // Calculate percentages
     fileAnalysis.forEach((f) => {
         f.percentage = totalSize > 0 ? (f.size / totalSize) * 100 : 0;
@@ -198,12 +200,12 @@ async function removeDevDependencies(distDir, options) {
 /**
  * Minify JavaScript files
  */
+// eslint-disable-next-line @typescript-eslint/require-await
 async function minifyJavaScript(_aggressive = false) {
     Logger.info('  → Minifying JavaScript...');
     // In production, would use esbuild or terser
     // This is a placeholder showing the pattern
     Logger.info('  ✓ JavaScript minified');
-    return Promise.resolve();
 }
 /**
  * Remove a specific module

package/src/cache/drivers/KVDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KVDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiEjD;;GAEG;AACH,eAAO,MAAM,QAAQ;kBAjDF,WAAW;EAmD5B,CAAC"}
+{"version":3,"file":"KVDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoDjD;;GAEG;AACH,eAAO,MAAM,QAAQ;kBAhDF,WAAW;EAkD5B,CAAC"}

package/src/cache/drivers/KVDriver.js

@@ -2,23 +2,23 @@
  * Cloudflare KV Cache Driver
  * Interfaces with the native KV binding in Cloudflare Workers
  */
+import { Cloudflare } from '../../config/cloudflare';
 import { Logger } from '../../config/logger';
 /**
  * Create a new KV driver instance
  */
 const create = () => {
     // In Cloudflare Workers, the KV namespace is usually bound to a variable in the environment
-    const env = globalThis['env'];
-    const kv = env === undefined ? undefined : env['CACHE'];
+    const kv = Cloudflare.getKVBinding('CACHE');
     return {
         async get(key) {
-            if (kv === undefined)
+            if (kv === null)
                 return null;
             const value = await kv.get(key, { type: 'json' });
             return value ?? null;
         },
         async set(key, value, ttl) {
-            if (kv === undefined) {
+            if (kv === null) {
                 Logger.warn('KV binding "CACHE" not found. Cache set ignored.');
                 return;
             }
@@ -30,7 +30,7 @@ const create = () => {
             await kv.put(key, JSON.stringify(value), options);
         },
         async delete(key) {
-            if (kv === undefined)
+            if (kv === null)
                 return;
             await kv.delete(key);
         },
@@ -40,7 +40,7 @@ const create = () => {
             await Promise.resolve();
         },
         async has(key) {
-            if (kv === undefined)
+            if (kv === null)
                 return false;
             const value = await kv.get(key);
             return value !== null;

package/src/cache/drivers/RedisDriver.js

@@ -4,7 +4,7 @@
  */
 import { Env } from '../../config/env';
 import { Logger } from '../../config/logger';
-import * as net from 'node:net';
+import * as net from '../../node-singletons/net';
 /**
  * Create a new Redis driver instance
  */

package/src/cli/BaseCommand.d.ts

@@ -29,11 +29,11 @@ export declare const BaseCommand: Readonly<{
     /**
      * Create a command instance with common logic
      */
-    create(config: {
+    create<T extends IBaseCommand = IBaseCommand>(config: {
         name: string;
         description: string;
         addOptions?: (command: Command) => void;
         execute: (options: CommandOptions) => void | Promise<void>;
-    }): IBaseCommand;
+    }): T;
 }>;
 //# sourceMappingURL=BaseCommand.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;mBACY;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,YAAY;EA+ChB,CAAC"}
+{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;WACI,CAAC,SAAS,YAAY,yBAAyB;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,CAAC;EAiDL,CAAC"}

package/src/cli/BaseCommand.js

@@ -42,7 +42,7 @@ export const BaseCommand = Object.freeze({
             });
             return command;
         };
-        return {
+        const base = {
             name: config.name,
             description: config.description,
             verbose: false,
@@ -54,5 +54,6 @@ export const BaseCommand = Object.freeze({
             warn: (msg) => ErrorHandler.warn(msg),
             debug: (msg) => ErrorHandler.debug(msg, true),
         };
+        return base;
     },
 });

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

@@ -1 +1 @@
-{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAiLD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAqLD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}

package/src/cli/CLI.js

@@ -8,22 +8,25 @@ import { D1MigrateCommand } from './commands/D1MigrateCommand';
 import { DebugCommand } from './commands/DebugCommand';
 import { FixCommand } from './commands/FixCommand';
 import { KeyGenerateCommand } from './commands/KeyGenerateCommand';
+import { MakeMailTemplateCommand } from './commands/MakeMailTemplateCommand';
+import { MakeNotificationTemplateCommand } from './commands/MakeNotificationTemplateCommand';
 import { MigrateCommand } from './commands/MigrateCommand';
 import { NewCommand } from './commands/NewCommand';
 import { PluginCommand } from './commands/PluginCommand';
 import { PrepareCommand } from './commands/PrepareCommand';
 import { QACommand } from './commands/QACommand';
+import { SecretsCommand } from './commands/SecretsCommand';
 import { SimulateCommand } from './commands/SimulateCommand';
 import { StartCommand } from './commands/StartCommand';
+import { TemplatesCommand } from './commands/TemplatesCommand';
 import { ErrorHandler } from './ErrorHandler';
+import { esmDirname } from '../common/index';
 import { Logger } from '../config/logger';
 import { ErrorFactory } from '../exceptions/ZintrustError';
 import { readFileSync } from '../node-singletons/fs';
-import { dirname, join } from '../node-singletons/path';
-import { fileURLToPath } from '../node-singletons/url';
+import { join } from '../node-singletons/path';
 import { Command } from 'commander';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+const __dirname = esmDirname(import.meta.url);
 /**
  * CLI - Main CLI Class
  * Orchestrates all CLI commands using Commander
@@ -68,12 +71,16 @@ const registerCommands = (program) => {
         MigrateCommand.create(),
         D1MigrateCommand.create(),
         DebugCommand.create(),
+        SecretsCommand.create(),
         ConfigCommand.create(),
         PluginCommand.create(),
         QACommand(),
         FixCommand.create(),
         KeyGenerateCommand.create(),
         SimulateCommand,
+        TemplatesCommand,
+        MakeMailTemplateCommand.create(),
+        MakeNotificationTemplateCommand.create(),
     ];
     for (const command of commands) {
         program.addCommand(command.getCommand());

package/src/cli/commands/AddCommand.js

@@ -16,8 +16,8 @@ import { ServiceScaffolder } from '../scaffolding/ServiceScaffolder';
 import { WorkflowGenerator } from '../scaffolding/WorkflowGenerator';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import fs from '../../node-singletons/fs';
+import * as path from '../../node-singletons/path';
 import inquirer from 'inquirer';
-import * as path from 'node:path';
 const addOptions = (command) => {
     command
         .argument('<type>', 'What to add: service, feature, migration, model, controller, routes, factory, seeder, requestfactory, responsefactory, or workflow')

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

@@ -1 +1 @@
-{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4T7E;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EAsEtB,CAAC"}
+{"version":3,"file":"ConfigCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ConfigCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiV7E;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EAsEtB,CAAC"}

package/src/cli/commands/ConfigCommand.js

@@ -19,6 +19,26 @@ const addOptions = (command) => {
 };
 const getGlobalConfigManager = async () => ConfigManager.getGlobalConfig();
 const getProjectConfigManager = async () => ConfigManager.getProjectConfig();
+const toDisplayString = (value) => {
+    if (value === undefined || value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'bigint')
+        return value.toString();
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'symbol')
+        return value.toString();
+    if (typeof value === 'function')
+        return '[Function]';
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return '[Unserializable]';
+    }
+};
 const formatConfigValue = (value) => {
     if (value === undefined || value === null)
         return chalk.gray('null');
@@ -28,7 +48,15 @@ const formatConfigValue = (value) => {
         return value ? chalk.green('true') : chalk.red('false');
     if (typeof value === 'number')
         return chalk.yellow(value.toString());
-    return String(value);
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'bigint')
+        return chalk.yellow(value.toString());
+    if (typeof value === 'symbol')
+        return chalk.gray(value.toString());
+    if (typeof value === 'function')
+        return chalk.gray('[Function]');
+    return chalk.gray(toDisplayString(value));
 };
 const parseConfigValue = (value) => {
     if (value === undefined)
@@ -67,8 +95,8 @@ const displayValidationStatus = (cmd, config) => {
     cmd.info(chalk.red(`  ❌ Configuration has ${errors.length} errors:`));
     for (const error of errors) {
         const message = error !== null && typeof error === 'object' && 'message' in error
-            ? String(error.message)
-            : String(error);
+            ? toDisplayString(error.message)
+            : toDisplayString(error);
         cmd.info(chalk.red(`     - ${message}`));
     }
 };
@@ -151,7 +179,9 @@ const editSingleConfig = async (cmd, manager, selectedKey) => {
     let defaultValue = '';
     if (currentValue !== undefined) {
         defaultValue =
-            typeof currentValue === 'object' ? JSON.stringify(currentValue) : String(currentValue);
+            typeof currentValue === 'object'
+                ? JSON.stringify(currentValue)
+                : toDisplayString(currentValue);
     }
     const newValue = await PromptHelper.textInput(`Enter new value for "${selectedKey}":`, defaultValue);
     if (newValue === undefined)

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

@@ -1,3 +1,7 @@
+/**
+ * D1 Migrate Command
+ * Run Cloudflare D1 migrations using Wrangler
+ */
 import { IBaseCommand } from '../BaseCommand';
 /**
  * D1 Migrate Command

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

@@ -1 +1 @@
-{"version":3,"file":"D1MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1MigrateCommand.ts"],"names":[],"mappings":"AAMA,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmD7E;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,YAAY;EAqBtB,CAAC"}
+{"version":3,"file":"D1MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsD7E;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;cACO,YAAY;EAqBtB,CAAC"}