@zintrust/core 0.1.0 → 0.1.2

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')
@@ -143,7 +143,7 @@ const addFeature = async (cmd, featureName, opts) => {
         throw ErrorFactory.createValidationError('Service path is required');
     const fullServicePath = path.join(projectRoot, servicePath);
     cmd.info(`Adding feature: ${name}...`);
-    const result = await FeatureScaffolder.addFeature({
+    const result = FeatureScaffolder.addFeature({
         name: name,
         servicePath: fullServicePath,
         withTest: opts.withTest,
@@ -151,7 +151,7 @@ const addFeature = async (cmd, featureName, opts) => {
     if (result.success === false)
         throw ErrorFactory.createCliError(result.message);
     cmd.success(`Feature '${name}' added successfully!`);
-    cmd.info(`Files created: ${result.filesCreated.length}`);
+    cmd.info(`Files created: ${result.filesCreated?.length || 0}`);
     cmd.info(`\nNext steps:\n  • Integrate feature in service\n  • Update routes if needed\n  • Add to configuration`);
 };
 const promptMigrationConfig = async () => {
@@ -380,7 +380,7 @@ const addFactory = async (cmd, factoryName, opts) => {
     else if (config.name === '') {
         throw ErrorFactory.createValidationError('Factory name is required');
     }
-    if (config.modelName === '' && opts.noInteractive !== true) {
+    if (config.modelName === '') {
         throw ErrorFactory.createValidationError('Model name is required for factory generation');
     }
     const factoriesPath = path.join(projectRoot, 'database', 'factories');
@@ -485,7 +485,7 @@ const addSeeder = async (cmd, seederName, opts) => {
     else if (config.name === '') {
         throw ErrorFactory.createValidationError('Seeder name is required');
     }
-    if (config.modelName === '' && opts.noInteractive !== true) {
+    if (config.modelName === '') {
         throw ErrorFactory.createValidationError('Model name is required for seeder generation');
     }
     const seedersPath = path.join(projectRoot, 'database', 'seeders');
@@ -814,4 +814,23 @@ export const AddCommand = Object.freeze({
         });
         return cmd;
     },
+    /**
+     * Internal helpers for testing
+     * @internal
+     */
+    _helpers: {
+        promptServiceConfig,
+        promptFeatureConfig,
+        promptMigrationConfig,
+        promptModelConfig,
+        promptControllerConfig,
+        promptRoutesConfig,
+        promptFactoryConfig,
+        promptSeederConfig,
+        promptRequestFactoryConfig,
+        promptResponseFactoryName,
+        promptResponseFactoryConfig,
+        promptWorkflowConfig,
+        getDefaultResponseFields,
+    },
 });

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;AA2T7E;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;cACO,YAAY;EA4EtB,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)
@@ -66,7 +94,10 @@ const displayValidationStatus = (cmd, config) => {
     const errors = validation?.errors ?? [];
     cmd.info(chalk.red(`  ❌ Configuration has ${errors.length} errors:`));
     for (const error of errors) {
-        cmd.info(chalk.red(`     - ${error}`));
+        const message = error !== null && typeof error === 'object' && 'message' in error
+            ? toDisplayString(error.message)
+            : toDisplayString(error);
+        cmd.info(chalk.red(`     - ${message}`));
     }
 };
 const displayConfigurationKeys = (cmd, keys) => {
@@ -83,23 +114,22 @@ const displayConfigurationValues = (cmd, config) => {
         cmd.info(`${chalk.cyan(key)}: ${formatConfigValue(value)}`);
     }
 };
-const handleGet = async (cmd, manager, key) => {
+const handleGet = (cmd, manager, key) => {
     if (key === undefined) {
         ErrorHandler.usageError('Configuration key is required for "get"');
-        return;
     }
     if (typeof manager.get !== 'function') {
         cmd.warn('Configuration manager does not support "get"');
-        return;
     }
-    const value = manager.get(key);
-    if (value === undefined) {
-        cmd.warn(`Configuration key "${key}" not found`);
-        return;
+    if (typeof manager.get === 'function' && key !== undefined) {
+        const value = manager.get(key);
+        if (value === undefined) {
+            cmd.warn(`Configuration key "${key}" not found`);
+        }
+        cmd.info(formatConfigValue(value));
     }
-    cmd.info(formatConfigValue(value));
 };
-const handleSet = async (cmd, manager, key, value) => {
+const handleSet = (cmd, manager, key, value) => {
     if (key === undefined || value === undefined) {
         ErrorHandler.usageError('Both key and value are required for "set"');
         return;
@@ -111,19 +141,18 @@ const handleSet = async (cmd, manager, key, value) => {
     const parsedValue = parseConfigValue(value);
     const validationError = ConfigValidator.validateValue(key, parsedValue);
     if (validationError) {
-        cmd.warn(`Validation error for "${key}": ${validationError}`);
+        cmd.warn(`Validation error for "${key}": ${validationError.message}`);
         return;
     }
     manager.set(key, parsedValue);
     if (typeof manager.save === 'function') {
-        await manager.save();
+        manager.save();
     }
     cmd.success(`Configuration updated: ${key} = ${value}`);
 };
-const handleList = async (cmd, manager, options) => {
+const handleList = (cmd, manager, options) => {
     if (options['json'] === true && typeof manager.export === 'function') {
         cmd.info(manager.export());
-        return;
     }
     const config = typeof manager.getConfig === 'function' ? manager.getConfig() : {};
     cmd.info(chalk.bold('\n🛠️  Current Configuration:\n'));
@@ -141,7 +170,7 @@ const handleReset = async (cmd, manager) => {
         return;
     }
     if (typeof manager.reset === 'function') {
-        await manager.reset();
+        manager.reset();
     }
     cmd.success('Configuration reset to defaults');
 };
@@ -150,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)
@@ -158,14 +189,14 @@ const editSingleConfig = async (cmd, manager, selectedKey) => {
     const parsedValue = parseConfigValue(newValue);
     const validationError = ConfigValidator.validateValue(selectedKey, parsedValue);
     if (validationError) {
-        cmd.warn(`Validation error: ${validationError}`);
+        cmd.warn(`Validation error: ${validationError.message}`);
         return;
     }
     if (typeof manager.set === 'function') {
         manager.set(selectedKey, parsedValue);
     }
     if (typeof manager.save === 'function') {
-        await manager.save();
+        manager.save();
     }
     cmd.success(`Updated ${selectedKey}`);
 };
@@ -180,12 +211,15 @@ const handleEdit = async (cmd, manager) => {
         return;
     }
     const menuKeys = [...availableKeys].sort((a, b) => a.localeCompare(b)).concat(['(Done)']);
+    // Interactive prompt loop must be sequential.
+    /* eslint-disable no-await-in-loop */
     while (true) {
         const selectedKey = await PromptHelper.chooseFrom('Select configuration key to edit:', menuKeys);
         if (selectedKey === '' || selectedKey === '(Done)')
             break;
         await editSingleConfig(cmd, manager, selectedKey);
     }
+    /* eslint-enable no-await-in-loop */
     cmd.success('Configuration editing complete');
 };
 const handleExport = (cmd, manager) => {
@@ -232,22 +266,22 @@ export const ConfigCommand = Object.freeze({
             execute: async (options) => executeConfig(cmd, options),
         });
         cmd.getConfigManager = async (isGlobal) => isGlobal ? getGlobalConfigManager() : getProjectConfigManager();
-        cmd.handleGet = async (manager, key, value) => handleGet(cmd, manager, key ?? value);
-        cmd.handleSet = async (manager, key, value) => handleSet(cmd, manager, key, value);
-        cmd.handleList = async (manager, options) => handleList(cmd, manager, options);
+        cmd.handleGet = (manager, key, value) => handleGet(cmd, manager, key ?? value);
+        cmd.handleSet = (manager, key, value) => handleSet(cmd, manager, key, value);
+        cmd.handleList = (manager, options) => handleList(cmd, manager, options);
         cmd.handleReset = async (manager) => handleReset(cmd, manager);
         cmd.handleEdit = async (manager) => handleEdit(cmd, manager);
         cmd.handleExport = (manager) => handleExport(cmd, manager);
         cmd.handleAction = async (action, manager, key, value, options) => {
             switch (action.toLowerCase()) {
                 case 'get':
-                    await cmd.handleGet(manager, key, value);
+                    cmd.handleGet(manager, key, value);
                     return;
                 case 'set':
-                    await cmd.handleSet(manager, key, value, options);
+                    cmd.handleSet(manager, key, value, options);
                     return;
                 case 'list':
-                    await cmd.handleList(manager, options ?? {});
+                    cmd.handleList(manager, options ?? {});
                     return;
                 case 'reset':
                     await cmd.handleReset(manager);

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":"AAQA,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiD7E;;;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"}

package/src/cli/commands/D1MigrateCommand.js

@@ -1,21 +1,23 @@
-import { appConfig } from '../../config/app';
 /**
  * D1 Migrate Command
  * Run Cloudflare D1 migrations using Wrangler
  */
-import { resolveNpmPath } from '../../common';
-import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { BaseCommand } from '../BaseCommand';
+import { resolveNpmPath } from '../../common/index';
+import { appConfig } from '../../config/app';
 import { Logger } from '../../config/logger';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { execFileSync } from '../../node-singletons/child-process';
+// eslint-disable-next-line @typescript-eslint/require-await
 const runWrangler = async (cmd, args) => {
     const npmPath = resolveNpmPath();
     cmd.debug(`Executing: npm exec --yes -- wrangler ${args.join(' ')}`);
-    return execFileSync(npmPath, ['exec', '--yes', '--', 'wrangler', ...args], {
+    const result = execFileSync(npmPath, ['exec', '--yes', '--', 'wrangler', ...args], {
         stdio: 'pipe',
         encoding: 'utf8',
         env: appConfig.getSafeEnv(),
     });
+    return result;
 };
 const executeD1Migrate = async (cmd, options) => {
     const isLocal = options['local'] === true || options['remote'] !== true;

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

@@ -1 +1 @@
-{"version":3,"file":"FixCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/FixCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqE7E;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,YAAY;EAkBtB,CAAC"}
+{"version":3,"file":"FixCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/FixCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmD7E;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,YAAY;EAkBtB,CAAC"}

package/src/cli/commands/FixCommand.js

@@ -4,21 +4,9 @@
  */
 import { appConfig } from '../../config';
 import { BaseCommand } from '../BaseCommand';
+import { resolveNpmPath } from '../../common/index';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { execFileSync } from '../../node-singletons/child-process';
-import fs from '../../node-singletons/fs';
-import * as path from '../../node-singletons/path';
-const resolveNpmPath = () => {
-    const nodeBinDir = path.dirname(process.execPath);
-    const candidates = process.platform === 'win32'
-        ? [path.join(nodeBinDir, 'npm.cmd'), path.join(nodeBinDir, 'npm.exe')]
-        : [path.join(nodeBinDir, 'npm')];
-    for (const candidate of candidates) {
-        if (fs.existsSync(candidate))
-            return candidate;
-    }
-    throw ErrorFactory.createCliError('Unable to locate npm executable. Ensure Node.js (with npm) is installed in the standard location.');
-};
 const runNpmScript = (cmd, args) => {
     const npmPath = resolveNpmPath();
     cmd.debug(`Executing: npm run ${args.join(' ')}`);
@@ -28,7 +16,7 @@ const runNpmScript = (cmd, args) => {
         env: appConfig.getSafeEnv(),
     });
 };
-const executeFix = async (cmd, options) => {
+const executeFix = (cmd, options) => {
     cmd.info('Starting automated code fixes...');
     try {
         const isDryRun = options['dryRun'] === true;
@@ -70,7 +58,7 @@ export const FixCommand = Object.freeze({
             name: 'fix',
             description: 'Run automated code fixes',
             addOptions,
-            execute: async (options) => executeFix(cmd, options),
+            execute: (options) => executeFix(cmd, options),
         });
         cmd.resolveNpmPath = () => resolveNpmPath();
         cmd.getSafeEnv = () => appConfig.getSafeEnv();

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

@@ -0,0 +1,6 @@
+import { type IBaseCommand } from '../BaseCommand';
+export declare const LogsCleanupCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default LogsCleanupCommand;
+//# sourceMappingURL=LogsCleanupCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LogsCleanupCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/LogsCleanupCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGlE,eAAO,MAAM,kBAAkB;cACnB,YAAY;EAiBtB,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/src/cli/commands/LogsCleanupCommand.js

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../BaseCommand';
+import { cleanLogsOnce } from '../../config/logger';
+export const LogsCleanupCommand = Object.freeze({
+    create() {
+        // Create the command first, then assign the execute implementation so we can
+        // safely reference the instance (`cmd`) from inside the handler.
+        const cmd = BaseCommand.create({
+            name: 'logs:cleanup',
+            description: 'Run a one-off log cleanup based on configured retention',
+            execute: async () => { },
+        });
+        cmd.execute = async (_options) => {
+            cmd.info('Running log cleanup...');
+            const deleted = await cleanLogsOnce();
+            cmd.info(`Deleted ${deleted.length} log files`);
+        };
+        return cmd;
+    },
+});
+export default LogsCleanupCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"LogsCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/LogsCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAM7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8KpC,eAAO,MAAM,WAAW;IACtB;;OAEG;cACO,YAAY;IAwBtB;;;OAGG;sBACe,OAAO,GAAG,IAAI;EAchC,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"LogsCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/LogsCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAO7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2KpC,eAAO,MAAM,WAAW;IACtB;;OAEG;cACO,YAAY;IAwBtB;;;OAGG;sBACe,OAAO,GAAG,IAAI;EAchC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/src/cli/commands/LogsCommand.js

@@ -7,8 +7,8 @@ import { Logger as FileLogger } from '../logger/Logger';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import fs from '../../node-singletons/fs';
+import * as path from '../../node-singletons/path';
 import chalk from 'chalk';
-import * as path from 'node:path';
 const normalizeLogsOptions = (options) => {
     const level = typeof options['level'] === 'string' ? options['level'] : 'info';
     const clear = options['clear'] === true;
@@ -117,11 +117,6 @@ const followLogs = (category) => {
     });
 };
 const clearLogs = (loggerInstance, category) => {
-    const confirmed = true;
-    if (!confirmed) {
-        Logger.info(chalk.yellow('Clearing logs cancelled'));
-        return;
-    }
     const success = loggerInstance.clearLogs(category);
     if (success === true) {
         Logger.info(chalk.green(`✓ Cleared logs for category: ${category}`));
@@ -133,6 +128,9 @@ const clearLogs = (loggerInstance, category) => {
 const executeLogs = (options) => {
     const normalized = normalizeLogsOptions(options);
     const loggerInstance = FileLogger.getInstance();
+    if (options['lines'] !== undefined && Number.isNaN(Number(options['lines']))) {
+        throw ErrorFactory.createGeneralError('Lines must be a number');
+    }
     if (normalized.clear) {
         clearLogs(loggerInstance, normalized.category);
         return;

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

@@ -0,0 +1,10 @@
+/**
+ * make:mail-template
+ * Scaffolds a mail markdown template into the project.
+ */
+import { IBaseCommand } from '../BaseCommand';
+export declare const MakeMailTemplateCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default MakeMailTemplateCommand;
+//# sourceMappingURL=MakeMailTemplateCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MakeMailTemplateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MakeMailTemplateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgC7E,eAAO,MAAM,uBAAuB;cACxB,YAAY;EA4EtB,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/src/cli/commands/MakeMailTemplateCommand.js

@@ -0,0 +1,74 @@
+/**
+ * make:mail-template
+ * Scaffolds a mail markdown template into the project.
+ */
+import { BaseCommand } from '../BaseCommand';
+import { ErrorHandler } from '../ErrorHandler';
+import { PromptHelper } from '../PromptHelper';
+import { FileGenerator } from '../scaffolding/FileGenerator';
+import { TemplateGenerator } from '../scaffolding/TemplateGenerator';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import * as path from '../../node-singletons/path';
+const addOptions = (command) => {
+    command.argument('[name]', 'Template name (alphanumeric + hyphens only)');
+    command.option('--category <category>', 'auth|transactional|notifications');
+    command.option('--vars <csv>', 'Comma-separated variables (e.g., name,confirmLink,expiryMinutes)');
+    command.option('--overwrite', 'Overwrite existing file');
+    command.option('--no-interactive', 'Disable prompts (requires args/options)');
+};
+const defaultCopyright = () => process.env['TEMPLATE_COPYRIGHT'] ?? '© 2025 Zintrust Framework. All rights reserved.';
+export const MakeMailTemplateCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'make:mail-template',
+            description: 'Scaffold a mail markdown template into src/mail/markdown',
+            addOptions,
+            execute: async (options) => {
+                const interactive = options.noInteractive !== true;
+                const argName = options.args?.[0];
+                const name = argName ??
+                    (interactive ? await PromptHelper.textInput('Template name:', 'welcome', true) : '');
+                if (name.trim() === '') {
+                    throw ErrorFactory.createValidationError('Template name required');
+                }
+                const categoryInput = options.category ??
+                    (interactive
+                        ? await PromptHelper.chooseFrom('Category:', ['auth', 'transactional', 'notifications'], 'auth', true)
+                        : 'auth');
+                const category = categoryInput;
+                const varsCsv = options.vars ??
+                    (interactive
+                        ? await PromptHelper.textInput('Variables (comma-separated):', 'name,confirmLink,expiryMinutes', true)
+                        : '');
+                const variables = TemplateGenerator.parseVariablesCsv(varsCsv);
+                TemplateGenerator.ensureDirectories(process.cwd());
+                // If file exists and overwrite not specified, ask.
+                const desired = {
+                    name,
+                    category,
+                    variables,
+                    copyright: defaultCopyright(),
+                    projectRoot: process.cwd(),
+                    overwrite: options.overwrite === true,
+                };
+                if (options.overwrite !== true && interactive) {
+                    const relPath = path.join('src', 'mail', 'markdown', category, `${name}.md`);
+                    const fullPath = path.join(process.cwd(), relPath);
+                    if (FileGenerator.fileExists(fullPath)) {
+                        const confirm = await PromptHelper.confirm('File exists. Overwrite?', false, true);
+                        if (confirm) {
+                            desired.overwrite = true;
+                        }
+                    }
+                }
+                const result = TemplateGenerator.scaffoldMailMarkdownTemplate(desired);
+                if (result.success) {
+                    ErrorHandler.success(result.message);
+                    return;
+                }
+                ErrorHandler.warn(result.message);
+            },
+        });
+    },
+});
+export default MakeMailTemplateCommand;

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

@@ -0,0 +1,10 @@
+/**
+ * make:notification-template
+ * Scaffolds a notification markdown template into the project.
+ */
+import { IBaseCommand } from '../BaseCommand';
+export declare const MakeNotificationTemplateCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default MakeNotificationTemplateCommand;
+//# sourceMappingURL=MakeNotificationTemplateCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MakeNotificationTemplateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MakeNotificationTemplateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAoH7E,eAAO,MAAM,+BAA+B;cAChC,YAAY;EAqCtB,CAAC;AAEH,eAAe,+BAA+B,CAAC"}

package/src/cli/commands/MakeNotificationTemplateCommand.js

@@ -0,0 +1,113 @@
+/**
+ * make:notification-template
+ * Scaffolds a notification markdown template into the project.
+ */
+import { BaseCommand } from '../BaseCommand';
+import { ErrorHandler } from '../ErrorHandler';
+import { PromptHelper } from '../PromptHelper';
+import { FileGenerator } from '../scaffolding/FileGenerator';
+import { TemplateGenerator } from '../scaffolding/TemplateGenerator';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import * as path from '../../node-singletons/path';
+import inquirer from 'inquirer';
+const addOptions = (command) => {
+    command.argument('[name]', 'Template name (alphanumeric + hyphens only)');
+    command.option('--channels <csv>', 'Comma-separated channels: mail,sms,slack,discord');
+    command.option('--vars <csv>', 'Comma-separated variables');
+    command.option('--sms-variant <mode>', 'short|none', 'none');
+    command.option('--overwrite', 'Overwrite existing file');
+    command.option('--no-interactive', 'Disable prompts (requires args/options)');
+};
+const defaultCopyright = () => process.env['TEMPLATE_COPYRIGHT'] ?? '© 2025 Zintrust Framework. All rights reserved.';
+const parseChannelsCsv = (csv) => {
+    if (csv === undefined || csv.trim() === '')
+        return [];
+    const parts = csv
+        .split(',')
+        .map((p) => p.trim())
+        .filter((p) => p !== '');
+    const out = [];
+    for (const p of parts) {
+        const lower = p.toLowerCase();
+        if (lower === 'mail' || lower === 'sms' || lower === 'slack' || lower === 'discord') {
+            if (!out.includes(lower))
+                out.push(lower);
+        }
+    }
+    return out;
+};
+const resolveName = async (options, interactive) => {
+    const argName = options.args?.[0];
+    const name = argName ??
+        (interactive ? await PromptHelper.textInput('Template name:', 'security-alert', true) : '');
+    if (name.trim() === '') {
+        throw ErrorFactory.createValidationError('Template name required');
+    }
+    return name;
+};
+const resolveChannels = async (options, interactive) => {
+    let channels = parseChannelsCsv(options.channels);
+    if (channels.length > 0)
+        return channels;
+    if (!interactive)
+        return [];
+    const answer = await inquirer.prompt([
+        {
+            type: 'checkbox',
+            name: 'channels',
+            message: 'Channels:',
+            choices: ['mail', 'sms', 'slack', 'discord'],
+            default: ['mail'],
+        },
+    ]);
+    channels = answer.channels ?? ['mail'];
+    return channels;
+};
+const resolveVariables = async (options, interactive) => {
+    const varsCsv = options.vars ??
+        (interactive
+            ? await PromptHelper.textInput('Variables (comma-separated):', 'ipAddress,location,deviceName,reviewLink', true)
+            : '');
+    return TemplateGenerator.parseVariablesCsv(varsCsv);
+};
+const maybeEnableOverwrite = async (interactive, overwriteFlag, relPath) => {
+    if (!interactive || overwriteFlag)
+        return overwriteFlag;
+    const fullPath = path.join(process.cwd(), relPath);
+    if (!FileGenerator.fileExists(fullPath))
+        return false;
+    return PromptHelper.confirm('File exists. Overwrite?', false, true);
+};
+export const MakeNotificationTemplateCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'make:notification-template',
+            description: 'Scaffold a notification markdown template into src/notification/markdown',
+            addOptions,
+            execute: async (options) => {
+                const interactive = options.noInteractive !== true;
+                const name = await resolveName(options, interactive);
+                const channels = await resolveChannels(options, interactive);
+                const variables = await resolveVariables(options, interactive);
+                const smsVariant = (options.smsVariant ?? 'none');
+                TemplateGenerator.ensureDirectories(process.cwd());
+                const relPath = path.join('src', 'notification', 'markdown', `${name}.md`);
+                const overwrite = await maybeEnableOverwrite(interactive, options.overwrite === true, relPath);
+                const result = TemplateGenerator.scaffoldNotificationMarkdownTemplate({
+                    name,
+                    channels,
+                    variables,
+                    smsVariant,
+                    copyright: defaultCopyright(),
+                    projectRoot: process.cwd(),
+                    overwrite,
+                });
+                if (result.success)
+                    ErrorHandler.success(result.message);
+                else
+                    ErrorHandler.warn(result.message);
+            },
+        });
+    },
+});
+export default MakeNotificationTemplateCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI7E;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EA8CtB,CAAC"}
+{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAI7E;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EA2CtB,CAAC"}