@zintrust/core 0.1.1 → 0.1.3

package/src/cli/commands/SecretsCommand.js

@@ -0,0 +1,91 @@
+/**
+ * Secrets Command
+ *
+ * CLI-first secrets sync using the core internal toolkit.
+ *
+ * Usage:
+ *   zin secrets pull   --provider aws|cloudflare [--manifest secrets.manifest.json] [--out .env.pull] [--dry-run]
+ *   zin secrets push   --provider aws|cloudflare [--manifest secrets.manifest.json] [--in .env] [--dry-run]
+ *   zin secrets doctor --provider aws|cloudflare
+ */
+import { BaseCommand } from '../BaseCommand';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { SecretsToolkit } from '../../toolkit/Secrets';
+const isUnknownArray = (value) => Array.isArray(value);
+const getArg = (args, index) => {
+    if (!isUnknownArray(args))
+        return undefined;
+    const v = args[index];
+    return typeof v === 'string' ? v : undefined;
+};
+const coerceProvider = (provider) => provider === 'aws' || provider === 'cloudflare' ? provider : undefined;
+const parseOptions = (options) => {
+    const cwd = process.cwd();
+    const action = getArg(options.args, 0) ?? 'pull';
+    const provider = typeof options.provider === 'string' ? coerceProvider(options.provider) : undefined;
+    const manifestPath = typeof options.manifest === 'string' ? options.manifest : undefined;
+    const outFile = typeof options.out === 'string' ? options.out : undefined;
+    const inFile = typeof options.in === 'string' ? options.in : undefined;
+    const dryRun = options.dryRun === true;
+    return { cwd, action, provider, manifestPath, outFile, inFile, dryRun };
+};
+const addOptions = (command) => {
+    command
+        .argument('[action]', 'pull | push | doctor', 'pull')
+        .option('--provider <provider>', 'aws | cloudflare')
+        .option('--manifest <path>', 'Manifest path (default: secrets.manifest.json)', 'secrets.manifest.json')
+        .option('--out <path>', 'Output env file for pull (default: .env.pull)', '.env.pull')
+        .option('--in <path>', 'Input env file for push (default: .env)', '.env')
+        .option('--dry-run', 'Do not write/upload, just show what would change');
+};
+const execute = async (cmd, options) => {
+    const parsed = parseOptions(options);
+    switch (parsed.action) {
+        case 'pull': {
+            const result = await SecretsToolkit.pull({
+                cwd: parsed.cwd,
+                provider: parsed.provider,
+                manifestPath: parsed.manifestPath,
+                outFile: parsed.outFile,
+                dryRun: parsed.dryRun,
+            });
+            cmd.success(`Pulled ${result.keys.length} keys to ${result.outFile}${parsed.dryRun ? ' (dry-run)' : ''}`);
+            return;
+        }
+        case 'push': {
+            const result = await SecretsToolkit.push({
+                cwd: parsed.cwd,
+                provider: parsed.provider,
+                manifestPath: parsed.manifestPath,
+                inFile: parsed.inFile,
+                dryRun: parsed.dryRun,
+            });
+            cmd.success(`Pushed ${result.keys.length} keys from ${result.inFile}${parsed.dryRun ? ' (dry-run)' : ''}`);
+            return;
+        }
+        case 'doctor': {
+            const result = SecretsToolkit.doctor({ provider: parsed.provider });
+            if (result.ok) {
+                cmd.success(`Secrets doctor OK (${result.provider})`);
+            }
+            else {
+                cmd.warn(`Secrets doctor failed (${result.provider}). Missing: ${result.missing.join(', ')}`);
+            }
+            return;
+        }
+        default:
+            throw ErrorFactory.createCliError(`Unknown secrets action: ${parsed.action}`);
+    }
+};
+export const SecretsCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'secrets',
+            description: 'Pull/push secrets to local .env.pull via core toolkit',
+            addOptions,
+            execute: async (options) => execute(cmd, options),
+        });
+        return cmd;
+    },
+});
+export default SecretsCommand;

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":"AACA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkSvF,eAAO,MAAM,YAAY;cACb,YAAY;EAsBtB,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;AAmSvF,eAAO,MAAM,YAAY;cACb,YAAY;EAsBtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -1,10 +1,10 @@
-import { resolveNpmPath } from '../../common';
 import { BaseCommand } from '../BaseCommand';
 import { EnvFileLoader } from '../utils/EnvFileLoader';
 import { SpawnUtil } from '../utils/spawn';
+import { resolveNpmPath } from '../../common/index';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { existsSync, readFileSync } from '../../node-singletons/fs';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 const isValidModeInput = (value) => value === 'development' ||
     value === 'dev' ||
     value === 'production' ||

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

@@ -0,0 +1,3 @@
+export declare const TemplatesCommand: import("../BaseCommand").IBaseCommand;
+export default TemplatesCommand;
+//# sourceMappingURL=TemplatesCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplatesCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/TemplatesCommand.ts"],"names":[],"mappings":"AAgCA,eAAO,MAAM,gBAAgB,yCAqC3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/cli/commands/TemplatesCommand.js

@@ -0,0 +1,65 @@
+import { BaseCommand } from '../BaseCommand';
+import { ErrorHandler } from '../ErrorHandler';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { listTemplates as listMail, renderTemplate as renderMail } from '../../tools/mail/templates/markdown';
+import { listTemplates as listNotification, renderTemplate as renderNotification, } from '../../tools/notification/templates/markdown';
+const listForScope = (scope) => {
+    let items = [];
+    if (scope === 'mail' || scope === 'all')
+        items = items.concat(listMail());
+    if (scope === 'notification' || scope === 'all')
+        items = items.concat(listNotification());
+    items.sort((a, b) => a.localeCompare(b));
+    return items;
+};
+const renderByScope = (name, scope) => {
+    if (scope === 'mail')
+        return renderMail(name);
+    if (scope === 'notification')
+        return renderNotification(name);
+    try {
+        return renderMail(name);
+    }
+    catch {
+        try {
+            return renderNotification(name);
+        }
+        catch (error_) {
+            throw ErrorFactory.createTryCatchError('Template render failed', error_);
+        }
+    }
+};
+export const TemplatesCommand = BaseCommand.create({
+    name: 'templates',
+    description: 'Manage and render markdown templates (mail & notification)',
+    addOptions: (command) => {
+        command.argument('<action>', 'Action: list|render');
+        command.argument('[scope]', 'Scope: mail|notification|all', 'all');
+        command.argument('[name]', 'Template name when action=render');
+    },
+    execute: (options) => {
+        const action = options.args?.[0];
+        const scope = options.args?.[1] ?? 'all';
+        const name = options.args?.[2];
+        const handleList = (sc) => {
+            const items = listForScope(sc);
+            items.forEach((it) => ErrorHandler.info(it));
+        };
+        const handleRender = (nm, sc) => {
+            if (nm === null || nm === undefined || nm === '')
+                throw ErrorFactory.createValidationError('Template name required');
+            const out = renderByScope(nm, sc);
+            ErrorHandler.info(out.html);
+        };
+        if (action === 'list') {
+            handleList(scope);
+            return;
+        }
+        if (action === 'render') {
+            handleRender(name, scope);
+            return;
+        }
+        throw ErrorFactory.createValidationError(`Unknown action: ${String(action)}`);
+    },
+});
+export default TemplatesCommand;

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

@@ -4,8 +4,13 @@
 export { AddCommand } from '../commands/AddCommand';
 export { ConfigCommand } from '../commands/ConfigCommand';
 export { DebugCommand } from '../commands/DebugCommand';
+export { LogsCleanupCommand } from '../commands/LogsCleanupCommand';
+export { MakeMailTemplateCommand } from '../commands/MakeMailTemplateCommand';
+export { MakeNotificationTemplateCommand } from '../commands/MakeNotificationTemplateCommand';
 export { MigrateCommand } from '../commands/MigrateCommand';
 export { NewCommand } from '../commands/NewCommand';
 export { PrepareCommand } from '../commands/PrepareCommand';
+export { SecretsCommand } from '../commands/SecretsCommand';
 export { StartCommand } from '../commands/StartCommand';
+export { TemplatesCommand } from '../commands/TemplatesCommand';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/src/cli/commands/index.js

@@ -4,7 +4,12 @@
 export { AddCommand } from '../commands/AddCommand';
 export { ConfigCommand } from '../commands/ConfigCommand';
 export { DebugCommand } from '../commands/DebugCommand';
+export { LogsCleanupCommand } from '../commands/LogsCleanupCommand';
+export { MakeMailTemplateCommand } from '../commands/MakeMailTemplateCommand';
+export { MakeNotificationTemplateCommand } from '../commands/MakeNotificationTemplateCommand';
 export { MigrateCommand } from '../commands/MigrateCommand';
 export { NewCommand } from '../commands/NewCommand';
 export { PrepareCommand } from '../commands/PrepareCommand';
+export { SecretsCommand } from '../commands/SecretsCommand';
 export { StartCommand } from '../commands/StartCommand';
+export { TemplatesCommand } from '../commands/TemplatesCommand';

package/src/cli/config/ConfigManager.js

@@ -6,7 +6,7 @@ import { ConfigPaths, DEFAULT_CONFIG, getConfigValue, setConfigValue, } from '..
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { fsPromises as fs } from '../../node-singletons/fs';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * Deep merge helper
  */

package/src/cli/index.d.ts

@@ -4,11 +4,12 @@
  */
 export { BaseCommand, type CommandOptions } from './BaseCommand';
 export { CLI } from './CLI';
-export { EXIT_CODES, ErrorHandler } from './ErrorHandler';
+export { ErrorHandler, EXIT_CODES } from './ErrorHandler';
 export { PromptHelper, type PromptOptions } from './PromptHelper';
 export { AddCommand } from './commands/AddCommand';
 export { ConfigCommand } from './commands/ConfigCommand';
 export { DebugCommand } from './commands/DebugCommand';
 export { MigrateCommand } from './commands/MigrateCommand';
 export { NewCommand } from './commands/NewCommand';
+export { SecretsCommand } from './commands/SecretsCommand';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/src/cli/index.js

@@ -4,7 +4,7 @@
  */
 export { BaseCommand } from './BaseCommand';
 export { CLI } from './CLI';
-export { EXIT_CODES, ErrorHandler } from './ErrorHandler';
+export { ErrorHandler, EXIT_CODES } from './ErrorHandler';
 export { PromptHelper } from './PromptHelper';
 // Export commands
 export { AddCommand } from './commands/AddCommand';
@@ -12,3 +12,4 @@ export { ConfigCommand } from './commands/ConfigCommand';
 export { DebugCommand } from './commands/DebugCommand';
 export { MigrateCommand } from './commands/MigrateCommand';
 export { NewCommand } from './commands/NewCommand';
+export { SecretsCommand } from './commands/SecretsCommand';

package/src/cli/scaffolding/ControllerGenerator.js

@@ -4,7 +4,7 @@
  */
 import { FileGenerator } from '../scaffolding/FileGenerator';
 import { Logger } from '../../config/logger';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * ControllerGenerator creates HTTP request handlers
  */

package/src/cli/scaffolding/FeatureScaffolder.js

@@ -4,7 +4,7 @@
  */
 import { FileGenerator } from '../scaffolding/FileGenerator';
 import { Logger } from '../../config/logger';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * FeatureScaffolder adds features to services
  */
@@ -208,7 +208,7 @@ const PAYMENTS_TEMPLATE = `/**
  * Handles payment processing and transactions
  */
 
-import { randomBytes } from 'node:crypto';
+import { randomBytes } from '../../node-singletons/crypto';
 
 export interface PaymentConfig {
   provider: 'stripe' | 'paypal' | 'square';
@@ -429,7 +429,7 @@ const EMAIL_TEMPLATE = `/**
  * Handles email sending
  */
 
-import { randomBytes } from 'node:crypto';
+import { randomBytes } from '../../node-singletons/crypto';
 
 export interface EmailConfig {
   provider: 'sendgrid' | 'mailgun' | 'nodemailer';
@@ -547,7 +547,7 @@ const QUEUE_TEMPLATE = `/**
  * Job queue processing
  */
 
-import { randomBytes } from 'node:crypto';
+import { randomBytes } from '../../node-singletons/crypto';
 
 export interface Job {
   id: string;

package/src/cli/scaffolding/FileGenerator.js

@@ -6,7 +6,7 @@
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import fs from '../../node-singletons/fs';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * Create a directory recursively
  */

package/src/cli/scaffolding/ModelGenerator.js

@@ -5,7 +5,7 @@
 import { FileGenerator } from '../scaffolding/FileGenerator';
 import { CommonUtils } from '../../common/index';
 import { Logger } from '../../config/logger';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * Validate model options
  */

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;AAOH,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;AA4TD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAMrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AAsID;;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;AAOH,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;AAqWD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAMrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AAwID;;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

@@ -2,10 +2,10 @@
  * Project Scaffolder - New project generation
  * Handles directory structure and boilerplate file creation
  */
+import { esmDirname } from '../../common/index';
 import { Logger } from '../../config/logger';
 import fs from '../../node-singletons/fs';
-import { fileURLToPath } from '../../node-singletons/url';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 const createDirectories = (projectPath, directories) => {
     let count = 0;
     if (!fs.existsSync(projectPath)) {
@@ -22,11 +22,42 @@ const createDirectories = (projectPath, directories) => {
     return count;
 };
 const createFiles = (projectPath, files, variables) => {
+    const renderPathVar = (value) => {
+        if (value === undefined || value === null)
+            return '';
+        if (typeof value === 'string')
+            return value;
+        if (typeof value === 'number' || typeof value === 'bigint')
+            return value.toString();
+        if (typeof value === 'boolean')
+            return value ? 'true' : 'false';
+        return '';
+    };
+    const renderContentVar = (value) => {
+        if (value === undefined || value === null)
+            return '';
+        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);
+        }
+        catch {
+            return '';
+        }
+    };
     let count = 0;
     for (const [file, content] of Object.entries(files)) {
-        const renderedPath = file.replaceAll(/\{\{\s*(\w+)\s*\}\}/g, (_m, key) => String(variables[key] ?? ''));
+        const renderedPath = file.replaceAll(/\{\{\s*(\w+)\s*\}\}/g, (_m, key) => renderPathVar(variables[key]));
         const fullPath = path.join(projectPath, renderedPath);
-        const rendered = content.replaceAll(/\{\{\s*(\w+)\s*\}\}/g, (_m, key) => String(variables[key] ?? ''));
+        const rendered = content.replaceAll(/\{\{\s*(\w+)\s*\}\}/g, (_m, key) => renderContentVar(variables[key]));
         fs.mkdirSync(path.dirname(fullPath), { recursive: true });
         fs.writeFileSync(fullPath, rendered);
         count++;
@@ -65,9 +96,9 @@ const createEnvFile = (projectPath, variables) => {
         if (fs.existsSync(fullPath)) {
             return true;
         }
-        const name = String(variables['projectName'] ?? 'zintrust-app');
+        const name = typeof variables['projectName'] === 'string' ? variables['projectName'] : 'zintrust-app';
         const port = Number(variables['port'] ?? 3000);
-        const database = String(variables['database'] ?? 'sqlite');
+        const database = typeof variables['database'] === 'string' ? variables['database'] : 'sqlite';
         const baseLines = [
             'NODE_ENV=development',
             `APP_NAME=${name}`,
@@ -125,8 +156,7 @@ const createEnvFile = (projectPath, variables) => {
     }
 };
 const getProjectTemplatesRoot = () => {
-    const thisFile = fileURLToPath(import.meta.url);
-    const thisDir = path.dirname(thisFile);
+    const thisDir = esmDirname(import.meta.url);
     // src/cli/scaffolding/ -> src/templates/project/
     return path.resolve(thisDir, '..', '..', 'templates', 'project');
 };
@@ -209,6 +239,9 @@ const BASIC_TEMPLATE = {
         'config',
         'database/migrations',
         'database/seeders',
+        'logs',
+        'storage',
+        'tmp',
         'public',
         'routes',
         'src',
@@ -220,7 +253,16 @@ const BASIC_TEMPLATE = {
 const API_TEMPLATE = {
     name: 'api',
     description: 'API-focused Zintrust project structure',
-    directories: ['app/Controllers', 'app/Middleware', 'app/Models', 'routes', 'tests'],
+    directories: [
+        'app/Controllers',
+        'app/Middleware',
+        'app/Models',
+        'logs',
+        'storage',
+        'tmp',
+        'routes',
+        'tests',
+    ],
     files: {},
 };
 const MICROSERVICE_TEMPLATE = {
@@ -230,6 +272,9 @@ const MICROSERVICE_TEMPLATE = {
         'app/Controllers',
         'app/Middleware',
         'app/Models',
+        'logs',
+        'storage',
+        'tmp',
         'routes',
         'tests',
         'src/services',
@@ -247,6 +292,9 @@ const FULLSTACK_TEMPLATE = {
         'config',
         'database/migrations',
         'database/seeders',
+        'logs',
+        'storage',
+        'tmp',
         'public',
         'routes',
         'src',
@@ -318,7 +366,7 @@ const createFilesForState = (state) => {
         ? { ...templateFiles }
         : {};
     // Backward-compatible defaults for templates that don't ship these files yet.
-    if (!Object.prototype.hasOwnProperty.call(files, '.gitignore')) {
+    if (!Object.hasOwn(files, '.gitignore')) {
         files['.gitignore'] = `node_modules/
 dist/
 .env
@@ -326,10 +374,12 @@ dist/
 .DS_Store
 coverage/
 logs/
+storage/
+tmp/
 *.log
 `;
     }
-    if (!Object.prototype.hasOwnProperty.call(files, 'README.md')) {
+    if (!Object.hasOwn(files, 'README.md')) {
         files['README.md'] = `# {{projectName}}
 
 Starter Task API built with Zintrust.

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

@@ -1 +1 @@
-{"version":3,"file":"ResponseFactoryGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ResponseFactoryGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,yBAAyB,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,8BAA8B,CAAC,CAkCzC;AAmRD;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;EAGnC,CAAC"}
+{"version":3,"file":"ResponseFactoryGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ResponseFactoryGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,yBAAyB,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,8BAA8B,CAAC,CAkCzC;AAoRD;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;EAGnC,CAAC"}

package/src/cli/scaffolding/ResponseFactoryGenerator.js

@@ -6,7 +6,7 @@ import { FileGenerator } from '../scaffolding/FileGenerator';
 import { Logger } from '../../config/logger';
 import { ErrorFactory } from '../../exceptions/ZintrustError';
 import { fsPromises as fs } from '../../node-singletons/fs';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * Validate response factory options
  */
@@ -187,6 +187,7 @@ export default ${factoryName};
 /**
  * Generate response DTO code
  */
+// eslint-disable-next-line @typescript-eslint/require-await
 async function generateResponseDTO(options) {
     if (options.responsesPath === undefined) {
         throw ErrorFactory.createCliError('Responses path is required');
@@ -240,7 +241,7 @@ export default ${options.responseName};
 `;
     FileGenerator.writeFile(dtoPath, dtoCode);
     Logger.info(`✅ Generated response DTO: ${options.responseName}`);
-    return Promise.resolve(dtoPath);
+    return dtoPath;
 }
 /**
  * Generate field assignments for the factory

package/src/cli/scaffolding/RouteGenerator.js

@@ -4,7 +4,7 @@
  */
 import { FileGenerator } from '../scaffolding/FileGenerator';
 import { Logger } from '../../config/logger';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * Validate route options
  */

package/src/cli/scaffolding/ServiceIntegrationTestGenerator.js

@@ -5,7 +5,7 @@
 import { FileGenerator } from '../scaffolding/FileGenerator';
 import { CommonUtils } from '../../common/index';
 import { Logger } from '../../config/logger';
-import * as path from 'node:path';
+import * as path from '../../node-singletons/path';
 /**
  * Validate integration test options
  */

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -165,10 +165,10 @@ import { Application } from '../../boot/Application';
 import { Server } from '../../boot/Server';
 import { Logger } from '../../config/logger';
 import { Env } from '../../config/env';
+import { esmDirname } from '../../common/index';
 import * as path from '../../node-singletons/path';
-import { fileURLToPath } from '../../node-singletons/url';
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const __dirname = esmDirname(import.meta.url);
 const app = new Application(path.join(__dirname, '..'));
 const port = Env.getInt('${options.name?.toUpperCase()}_PORT', ${options.port ?? 3001});
 

package/src/cli/scaffolding/TemplateGenerator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Template Generator
+ * Scaffolds mail and notification markdown templates into the application source.
+ *
+ * Notes:
+ * - Generates into application folders (default: src/mail/markdown and src/notification/markdown)
+ * - Uses FileGenerator for consistent file I/O + logging
+ */
+export type MailTemplateCategory = 'auth' | 'transactional' | 'notifications';
+export type NotificationChannel = 'mail' | 'sms' | 'slack' | 'discord';
+export interface MailTemplateScaffoldOptions {
+    name: string;
+    category: MailTemplateCategory;
+    variables: string[];
+    copyright: string;
+    projectRoot: string;
+    overwrite?: boolean;
+}
+export interface NotificationTemplateScaffoldOptions {
+    name: string;
+    channels: NotificationChannel[];
+    variables: string[];
+    copyright: string;
+    projectRoot: string;
+    smsVariant?: 'short' | 'none';
+    overwrite?: boolean;
+}
+export interface TemplateScaffoldResult {
+    success: boolean;
+    filePath: string;
+    message: string;
+}
+export declare const TemplateGenerator: Readonly<{
+    validateTemplateName(name: string): void;
+    parseVariablesCsv(csv: string | undefined): string[];
+    scaffoldMailMarkdownTemplate(options: MailTemplateScaffoldOptions): TemplateScaffoldResult;
+    scaffoldNotificationMarkdownTemplate(options: NotificationTemplateScaffoldOptions): TemplateScaffoldResult;
+    ensureDirectories(projectRoot: string): void;
+}>;
+//# sourceMappingURL=TemplateGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/TemplateGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,CAAC;AAC9E,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,eAAO,MAAM,iBAAiB;+BACD,MAAM,GAAG,IAAI;2BAejB,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE;0CAKd,2BAA2B,GAAG,sBAAsB;kDAqC/E,mCAAmC,GAC3C,sBAAsB;mCAqCM,MAAM,GAAG,IAAI;EAY5C,CAAC"}