@zintrust/core 0.1.0 → 0.1.2

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

@@ -1 +1 @@
-{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AA4SD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}
+{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA+ChC;AA4SD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -40,49 +40,50 @@ export function getServicePath(projectRoot, options) {
 /**
  * Generate service structure
  */
-export async function scaffold(projectRoot, options) {
+// eslint-disable-next-line @typescript-eslint/promise-function-async
+export function scaffold(projectRoot, options) {
     try {
         // Validate options
         const validation = validateOptions(options);
         if (!validation.valid) {
-            return {
+            return Promise.resolve({
                 success: false,
                 serviceName: options.name,
                 servicePath: '',
                 filesCreated: [],
                 message: `Validation failed: ${validation.errors.join(', ')}`,
-            };
+            });
         }
         const servicePath = getServicePath(projectRoot, options);
         // Check if service already exists
         if (FileGenerator.directoryExists(servicePath)) {
-            return {
+            return Promise.resolve({
                 success: false,
                 serviceName: options.name,
                 servicePath,
                 filesCreated: [],
                 message: `Service '${options.name}' already exists at ${servicePath}`,
-            };
+            });
         }
         createServiceDirectories(servicePath);
         const filesCreated = createServiceFiles(servicePath, options);
-        return {
+        return Promise.resolve({
             success: true,
             serviceName: options.name,
             servicePath,
             filesCreated,
             message: `Service '${options.name}' scaffolded successfully`,
-        };
+        });
     }
     catch (error) {
         Logger.error('Service scaffolding failed', error);
-        return {
+        return Promise.resolve({
             success: false,
             serviceName: options.name,
             servicePath: '',
             filesCreated: [],
             message: error.message,
-        };
+        });
     }
 }
 /**
@@ -164,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});
 
@@ -289,7 +290,7 @@ DATABASE_CONNECTION=${options.database === 'isolated' ? 'postgresql' : 'shared'}
 ${options.database === 'isolated' ? `${options.name?.toUpperCase()}_DB_HOST=localhost\n${options.name?.toUpperCase()}_DB_DATABASE=${options.name}\n${options.name?.toUpperCase()}_DB_USER=postgres\n${options.name?.toUpperCase()}_DB_PASSWORD=postgres` : ''}
 
 # Authentication
-SERVICE_AUTH_STRATEGY=${options.auth || 'api-key'}
+SERVICE_AUTH_STRATEGY=${options.auth ?? 'api-key'}
 SERVICE_AUTH_KEY=your-auth-key-here
 
 # Tracing

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

@@ -12,9 +12,14 @@ export interface Template {
     files: TemplateFile[];
     directories: string[];
 }
+/**
+ * A file that will be copied from a template source into the generated project.
+ * `path`   -> destination path in the generated project
+ * `source` -> template file path (relative to the template root directory)
+ */
 export interface TemplateFile {
     path: string;
-    content: string;
+    source: string;
     isTemplate?: boolean;
 }
 /**
@@ -22,14 +27,16 @@ export interface TemplateFile {
  */
 export declare const TemplateEngine: Readonly<{
     render: (content: string, variables: TemplateVariables) => string;
-    renderPath: (path: string, variables: TemplateVariables) => string;
     renderContent: (content: string, variables: TemplateVariables) => string;
+    renderPath: (content: string, variables: TemplateVariables) => string;
     mergeVariables: (custom: TemplateVariables, defaults: TemplateVariables) => TemplateVariables;
     hasVariables: (content: string) => boolean;
     extractVariables: (content: string) => string[];
 }>;
 /**
- * Built-in template definitions
+ * Built-in template definitions (file-based; no inline contents)
+ *
+ * `source` paths are relative to your template root directory (wherever the CLI loader reads from).
  */
 export declare const BUILT_IN_TEMPLATES: Record<string, Template>;
 //# sourceMappingURL=TemplateEngine.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/TemplateEngine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAiED;;GAEG;AACH,eAAO,MAAM,cAAc;sBA/DM,MAAM,aAAa,iBAAiB,KAAG,MAAM;uBAgB5C,MAAM,aAAa,iBAAiB,KAAG,MAAM;6BAOvC,MAAM,aAAa,iBAAiB,KAAG,MAAM;6BAQ3E,iBAAiB,YACf,iBAAiB,KAC1B,iBAAiB;4BASmB,MAAM,KAAG,OAAO;gCASZ,MAAM,KAAG,MAAM,EAAE;EAmB1D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAmTvD,CAAC"}
+{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/TemplateEngine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAmDD;;GAEG;AACH,eAAO,MAAM,cAAc;sBAjDM,MAAM,aAAa,iBAAiB,KAAG,MAAM;6BAA7C,MAAM,aAAa,iBAAiB,KAAG,MAAM;0BAA7C,MAAM,aAAa,iBAAiB,KAAG,MAAM;6BAiBpE,iBAAiB,YACf,iBAAiB,KAC1B,iBAAiB;4BASmB,MAAM,KAAG,OAAO;gCASZ,MAAM,KAAG,MAAM,EAAE;EAmB1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAgDvD,CAAC"}

package/src/cli/scaffolding/TemplateEngine.js

@@ -16,18 +16,6 @@ const renderTemplate = (content, variables) => {
     }
     return result;
 };
-/**
- * Render file path with variables
- */
-const renderTemplatePath = (path, variables) => {
-    return renderTemplate(path, variables);
-};
-/**
- * Replace template variables in content
- */
-const renderTemplateContent = (content, variables) => {
-    return renderTemplate(content, variables);
-};
 /**
  * Get template variables with default values
  */
@@ -60,14 +48,16 @@ const extractTemplateVariables = (content) => {
  */
 export const TemplateEngine = Object.freeze({
     render: renderTemplate,
-    renderPath: renderTemplatePath,
-    renderContent: renderTemplateContent,
+    renderContent: renderTemplate,
+    renderPath: renderTemplate,
     mergeVariables: mergeTemplateVariables,
     hasVariables: hasTemplateVariables,
     extractVariables: extractTemplateVariables,
 });
 /**
- * Built-in template definitions
+ * Built-in template definitions (file-based; no inline contents)
+ *
+ * `source` paths are relative to your template root directory (wherever the CLI loader reads from).
  */
 export const BUILT_IN_TEMPLATES = {
     basic: {
@@ -85,154 +75,13 @@ export const BUILT_IN_TEMPLATES = {
             'database/seeders',
         ],
         files: [
-            {
-                path: 'package.json',
-                isTemplate: true,
-                content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "description": "{{projectDescription}}",
-  "main": "dist/index.js",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "test": "vitest",
-    "build": "tsc",
-    "start": "node dist/index.js"
-  },
-  "keywords": [],
-  "author": "{{author}}",
-  "license": "MIT",
-  "dependencies": {
-    "@zintrust/framework": "*"
-  },
-  "devDependencies": {
-    "typescript": "^5.3.3",
-    "tsx": "^4.6.2",
-    "vitest": "^1.1.0"
-  }
-}`,
-            },
-            {
-                path: '.env.example',
-                isTemplate: true,
-                content: `NODE_ENV=development
-APP_NAME={{projectName}}
-APP_PORT={{port}}
-APP_DEBUG=true
-DB_CONNECTION=sqlite
-DB_DATABASE=./database.sqlite`,
-            },
-            {
-                path: 'tsconfig.json',
-                content: `{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "lib": ["ES2022"],
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./",
-    "baseUrl": "./",
-    "strict": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "moduleResolution": "node"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}`,
-            },
-            {
-                path: '.gitignore',
-                content: `# Node
-node_modules/
-npm-debug.log
-
-# Build
-dist/
-build/
-*.tsbuildinfo
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-.DS_Store
-
-# Tests
-coverage/
-.nyc_output/
-
-# Logs
-logs/
-*.log
-
-# Database
-*.sqlite
-*.sqlite3
-
-# OS
-.DS_Store
-Thumbs.db`,
-            },
-            {
-                path: 'README.md',
-                isTemplate: true,
-                content: `# {{projectName}}
-
-{{projectDescription}}
-
-## Getting Started
-
-\`\`\`bash
-npm install
-npm run dev
-\`\`\`
-
-## Development
-
-\`\`\`bash
-npm run dev          # Start development server
-npm test             # Run tests
-npm run build        # Build for production
-npm start            # Start production server
-\`\`\`
-
-## License
-
-MIT`,
-            },
-            {
-                path: 'src/index.ts',
-                content: `import { Application } from '@zintrust/framework';
-
-const app = new Application(__dirname);
-
-app.boot();
-
-export default app;`,
-            },
-            {
-                path: 'routes/api.ts',
-                content: `import { Router } from '@zintrust/routing';
-
-const registerRoutes = (router: Router): void => {
-  router.get('/', async (req, res) => {
-    res.json({ message: 'Welcome to {{projectName}}!' });
-  });
-
-  router.get('/health', async (req, res) => {
-    res.json({ status: 'healthy', timestamp: new Date().toISOString() });
-  });
-}`,
-            },
+            { path: 'package.json', source: 'basic/package.json', isTemplate: true },
+            { path: '.env.example', source: 'basic/.env.example', isTemplate: true },
+            { path: 'tsconfig.json', source: 'basic/tsconfig.json' },
+            { path: '.gitignore', source: 'basic/.gitignore' },
+            { path: 'README.md', source: 'basic/README.md', isTemplate: true },
+            { path: 'src/index.ts', source: 'basic/src/index.ts' },
+            { path: 'routes/api.ts', source: 'basic/routes/api.ts', isTemplate: true },
         ],
     },
     api: {
@@ -252,128 +101,9 @@ const registerRoutes = (router: Router): void => {
             'services',
         ],
         files: [
-            {
-                path: 'package.json',
-                isTemplate: true,
-                content: `{
-  "name": "{{projectName}}",
-  "version": "1.0.0",
-  "description": "RESTful API {{projectDescription}}",
-  "main": "dist/index.js",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "test": "vitest",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "microservices:generate": "zintrust microservices:generate"
-  },
-  "keywords": ["api", "rest"],
-  "author": "{{author}}",
-  "license": "MIT",
-  "dependencies": {
-    "@zintrust/framework": "*"
-  },
-  "devDependencies": {
-    "typescript": "^5.3.3",
-    "tsx": "^4.6.2",
-    "vitest": "^1.1.0"
-  }
-}`,
-            },
-            {
-                path: '.env.example',
-                isTemplate: true,
-                content: `NODE_ENV=development
-APP_NAME={{projectName}}
-APP_PORT={{port}}
-APP_DEBUG=true
-DB_CONNECTION=postgres
-DB_HOST=localhost
-DB_PORT=5432
-DB_DATABASE={{projectName}}_db
-DB_USERNAME=postgres
-DB_PASSWORD=password`,
-            },
-            {
-                path: 'README.md',
-                isTemplate: true,
-                content: `# {{projectName}} API
-
-{{projectDescription}}
-
-REST API built with Zintrust framework.
-
-## Features
-
-- Full REST API support
-- PostgreSQL database
-- User authentication
-- Comprehensive testing
-- Microservices ready
-
-## Getting Started
-
-\`\`\`bash
-npm install
-npm run dev
-\`\`\`
-
-API will be available at http://localhost:{{port}}
-
-## API Documentation
-
-### Health Check
-\`GET /health\`
-
-### Users
-\`GET /api/users\` - List all users
-\`POST /api/users\` - Create user
-\`GET /api/users/:id\` - Get user
-\`PUT /api/users/:id\` - Update user
-\`DELETE /api/users/:id\` - Delete user
-
-## Development
-
-\`\`\`bash
-npm run dev          # Start development server
-npm test             # Run tests
-npm run build        # Build for production
-npm start            # Start production server
-\`\`\`
-
-## License
-
-MIT`,
-            },
-            {
-                path: 'src/index.ts',
-                content: `import { Application } from '@zintrust/framework';
-
-const app = new Application(__dirname);
-
-// Load middleware, routes, etc.
-app.boot();
-
-export default app;`,
-            },
-            {
-                path: 'routes/api.ts',
-                content: `import { Router } from '@zintrust/routing';
-
-const registerApiRoutes = (router: Router): void => {
-  router.group({ prefix: '/api/v1' }, (r) => {
-    // Health check
-    r.get('/health', async (req, res) => {
-      res.json({ status: 'healthy', timestamp: new Date().toISOString() });
-    });
-
-    // User routes would go here
-    r.get('/users', async (req, res) => {
-      res.json({ users: [] });
-    });
-  });
-}`,
-            },
+            { path: 'package.json', source: 'api/package.json', isTemplate: true },
+            { path: '.env.example', source: 'api/.env.example', isTemplate: true },
+            { path: 'README.md', source: 'api/README.md', isTemplate: true },
         ],
     },
 };

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"}

package/src/cli/scaffolding/TemplateGenerator.js

@@ -0,0 +1,172 @@
+/**
+ * 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
+ */
+import { FileGenerator } from '../scaffolding/FileGenerator';
+import { Logger } from '../../config/logger';
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import * as path from '../../node-singletons/path';
+const normalizeList = (items) => {
+    const out = [];
+    for (const raw of items) {
+        const v = raw.trim();
+        if (v === '')
+            continue;
+        if (!out.includes(v))
+            out.push(v);
+    }
+    return out;
+};
+export const TemplateGenerator = Object.freeze({
+    validateTemplateName(name) {
+        const trimmed = name.trim();
+        if (trimmed === '') {
+            throw ErrorFactory.createValidationError('Template name cannot be empty');
+        }
+        // Alphanumeric + hyphens only (case-insensitive)
+        const re = /^[a-z0-9-]+$/i;
+        if (re.exec(trimmed) === null) {
+            throw ErrorFactory.createValidationError('Template name must be alphanumeric and may include hyphens only');
+        }
+    },
+    parseVariablesCsv(csv) {
+        if (csv === undefined || csv.trim() === '')
+            return [];
+        return normalizeList(csv.split(','));
+    },
+    scaffoldMailMarkdownTemplate(options) {
+        this.validateTemplateName(options.name);
+        const variables = normalizeList(options.variables);
+        const relPath = path.join('src', 'mail', 'markdown', options.category, `${options.name}.md`);
+        const filePath = path.join(options.projectRoot, relPath);
+        const content = buildMailTemplateContent({
+            name: options.name,
+            category: options.category,
+            variables,
+            copyright: options.copyright,
+        });
+        const wrote = FileGenerator.writeFile(filePath, content, {
+            overwrite: options.overwrite === true,
+            createDirs: true,
+        });
+        if (!wrote) {
+            return {
+                success: false,
+                filePath,
+                message: `Template already exists (skipped): ${relPath}`,
+            };
+        }
+        return {
+            success: true,
+            filePath,
+            message: `Mail template created: ${relPath}`,
+        };
+    },
+    scaffoldNotificationMarkdownTemplate(options) {
+        this.validateTemplateName(options.name);
+        const variables = normalizeList(options.variables);
+        const channels = normalizeList(options.channels);
+        const relPath = path.join('src', 'notification', 'markdown', `${options.name}.md`);
+        const filePath = path.join(options.projectRoot, relPath);
+        const content = buildNotificationTemplateContent({
+            name: options.name,
+            channels,
+            variables,
+            smsVariant: options.smsVariant ?? 'none',
+            copyright: options.copyright,
+        });
+        const wrote = FileGenerator.writeFile(filePath, content, {
+            overwrite: options.overwrite === true,
+            createDirs: true,
+        });
+        if (!wrote) {
+            return {
+                success: false,
+                filePath,
+                message: `Template already exists (skipped): ${relPath}`,
+            };
+        }
+        return {
+            success: true,
+            filePath,
+            message: `Notification template created: ${relPath}`,
+        };
+    },
+    ensureDirectories(projectRoot) {
+        try {
+            // These are app-side directories, created on-demand.
+            FileGenerator.createDirectories(['src/mail/markdown', 'src/notification/markdown'], projectRoot);
+        }
+        catch (error) {
+            Logger.error('Failed to ensure template directories', error);
+            throw ErrorFactory.createTryCatchError('Failed to ensure template directories', error);
+        }
+    },
+});
+const buildMailTemplateContent = (input) => {
+    const variablesLine = input.variables.length > 0 ? input.variables.join(', ') : '';
+    const varHint = input.variables.length > 0 ? `<!-- Variables: ${variablesLine} -->\n` : '<!-- Variables: -->\n';
+    const normalizedVars = normalizeList(input.variables);
+    const hasName = normalizedVars.includes('name');
+    const nonNameVars = normalizedVars.filter((v) => v !== 'name');
+    const dataRows = normalizedVars.map((v) => `- **${v}:** {{${v}}}`).join('\n');
+    const dataSection = normalizedVars.length > 0 ? `## Template Data\n\n${dataRows}\n\n` : '';
+    const introLine = hasName ? 'Welcome, {{name}}!' : 'Welcome!';
+    const exampleLinkVar = nonNameVars.find((v) => v.toLowerCase().includes('link'));
+    const exampleExpiryVar = nonNameVars.find((v) => v.toLowerCase().includes('expiry'));
+    const actionLine = exampleLinkVar === undefined
+        ? 'Action link: (add your link here)'
+        : `Action link: {{${exampleLinkVar}}}`;
+    const expiryLine = exampleExpiryVar === undefined ? '' : `_This link expires in {{${exampleExpiryVar}}}._\n\n`;
+    // Keep content intentionally minimal and copy-paste ready.
+    // Developers can adjust links/layout and remove sections as needed.
+    return `<!-- Mail Template: ${input.name} -->
+<!-- Category: ${input.category} -->
+<!-- Copyright: ${input.copyright} -->
+${varHint}
+# ${introLine}
+
+Thanks for reaching out. This is a scaffolded markdown template.
+
+${dataSection}## Next Steps
+
+- ${actionLine}
+- Customize the sections for your product
+
+${expiryLine}---
+
+Questions? Contact support.
+`;
+};
+const buildNotificationTemplateContent = (input) => {
+    const channelsLine = input.channels.length > 0 ? input.channels.join(', ') : '';
+    const variablesLine = input.variables.length > 0 ? input.variables.join(', ') : '';
+    const smsLine = input.smsVariant === 'short' ? '<!-- SMS Variant: short -->\n' : '';
+    const normalizedVars = normalizeList(input.variables);
+    const dataRows = normalizedVars.map((v) => `- **${v}:** {{${v}}}`).join('\n');
+    const dataSection = normalizedVars.length > 0 ? `## Template Data\n\n${dataRows}\n\n` : '';
+    const smsPreviewVars = normalizedVars.slice(0, 2);
+    const smsPreview = smsPreviewVars.length > 0
+        ? smsPreviewVars.map((v) => `${v}: {{${v}}}`).join(', ')
+        : 'add variables as needed';
+    const smsVariantBlock = input.smsVariant === 'short'
+        ? `\n<!-- SMS Variant Start -->\n\n${input.name}: ${smsPreview}\n\n<!-- SMS Variant End -->\n`
+        : '';
+    return `<!-- Notification Template: ${input.name} -->
+<!-- Copyright: ${input.copyright} -->
+<!-- Channels: ${channelsLine} -->
+<!-- Variables: ${variablesLine} -->
+${smsLine}
+# Notification: ${input.name}
+
+This is a scaffolded notification template.
+
+${dataSection}---
+
+Add your message content here.
+${smsVariantBlock}`;
+};

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

@@ -31,4 +31,5 @@ export { ServiceScaffolder } from '../scaffolding/ServiceScaffolder';
 export type { ServiceOptions, ServiceScaffoldResult } from '../scaffolding/ServiceScaffolder';
 export { BUILT_IN_TEMPLATES, TemplateEngine } from '../scaffolding/TemplateEngine';
 export type { Template, TemplateFile, TemplateVariables } from '../scaffolding/TemplateEngine';
+export { TemplateGenerator } from '../scaffolding/TemplateGenerator';
 //# sourceMappingURL=index.d.ts.map