@zintrust/core 0.1.28 → 0.1.29

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.js';
+import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import * as path from '../../node-singletons/path.js';
+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/WorkflowGenerator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Workflow Generator
+ * Generates GitHub Actions workflows for deployment and CI/CD
+ */
+export interface WorkflowOptions {
+    name: string;
+    platform: 'lambda' | 'fargate' | 'cloudflare' | 'deno' | 'all';
+    branch?: string;
+    nodeVersion?: string;
+    projectRoot: string;
+}
+/**
+ * Generate a deployment workflow
+ */
+export declare function generateWorkflow(options: WorkflowOptions): Promise<{
+    success: boolean;
+    filePath: string;
+    message: string;
+}>;
+/**
+ * Get workflow template based on platform
+ */
+export declare function getWorkflowTemplate(platform: string, branch: string, nodeVersion: string): string;
+/**
+ * WorkflowGenerator object for backward compatibility
+ */
+export declare const WorkflowGenerator: Readonly<{
+    generate: typeof generateWorkflow;
+    getTemplate: typeof getWorkflowTemplate;
+}>;
+//# sourceMappingURL=WorkflowGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/WorkflowGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA0BjG;AAmID;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;EAG5B,CAAC"}

package/src/cli/scaffolding/WorkflowGenerator.js

@@ -0,0 +1,193 @@
+/**
+ * Workflow Generator
+ * Generates GitHub Actions workflows for deployment and CI/CD
+ */
+import { FileGenerator } from '../scaffolding/FileGenerator.js';
+import { Logger } from '../../config/logger.js';
+import { fsPromises as fs } from '../../node-singletons/fs.js';
+import * as path from '../../node-singletons/path.js';
+/**
+ * Generate a deployment workflow
+ */
+export async function generateWorkflow(options) {
+    const workflowDir = path.join(options.projectRoot, '.github', 'workflows');
+    const filePath = path.join(workflowDir, 'deploy-cloud.yml');
+    const branch = options.branch ?? 'master';
+    const nodeVersion = options.nodeVersion ?? '20.x';
+    try {
+        // Ensure directory exists
+        await fs.mkdir(workflowDir, { recursive: true });
+        const content = getWorkflowTemplate(options.platform, branch, nodeVersion);
+        FileGenerator.writeFile(filePath, content, {
+            overwrite: true,
+        });
+        return {
+            success: true,
+            filePath,
+            message: `Workflow generated successfully at ${filePath}`,
+        };
+    }
+    catch (error) {
+        Logger.error('Workflow generation failed', error);
+        return {
+            success: false,
+            filePath,
+            message: `Failed to generate workflow: ${error.message}`,
+        };
+    }
+}
+/**
+ * Get workflow template based on platform
+ */
+export function getWorkflowTemplate(platform, branch, nodeVersion) {
+    const isAll = platform === 'all';
+    const isLambda = isAll || platform === 'lambda';
+    const isFargate = isAll || platform === 'fargate';
+    const isCloudflare = isAll || platform === 'cloudflare';
+    const isDeno = isAll || platform === 'deno';
+    let content = buildWorkflowHeader(platform, branch, nodeVersion);
+    if (isLambda) {
+        content += buildLambdaJob();
+    }
+    if (isFargate) {
+        content += buildFargateJob();
+    }
+    if (isCloudflare) {
+        content += buildCloudflareJob();
+    }
+    if (isDeno) {
+        content += buildDenoJob();
+    }
+    return content;
+}
+/**
+ * Build workflow header and build job
+ */
+function buildWorkflowHeader(platform, branch, nodeVersion) {
+    return `name: Deploy Cloud
+
+on:
+  push:
+    branches:
+      - ${branch}
+      - production
+      - staging
+  pull_request:
+    branches:
+      - ${branch}
+  workflow_dispatch:
+    inputs:
+      platform:
+        description: 'Platform to deploy (lambda,fargate,cloudflare,deno,all)'
+        required: true
+        default: '${platform}'
+
+env:
+  REGISTRY: ghcr.io
+  AWS_REGION: us-east-1
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${nodeVersion}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Type check
+        run: npm run type-check
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+`;
+}
+/**
+ * Build Lambda job
+ */
+function buildLambdaJob() {
+    return `
+  deploy-lambda:
+    needs: build
+    runs-on: ubuntu-latest
+    if: contains(github.event.inputs.platform || 'all', 'lambda') || github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Deploy to AWS Lambda
+        run: echo "Deploying to Lambda..."
+`;
+}
+/**
+ * Build Fargate job
+ */
+function buildFargateJob() {
+    return `
+  deploy-fargate:
+    needs: build
+    runs-on: ubuntu-latest
+    if: contains(github.event.inputs.platform || 'all', 'fargate') || github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build and Push Docker Image
+        run: echo "Pushing to GHCR..."
+`;
+}
+/**
+ * Build Cloudflare job
+ */
+function buildCloudflareJob() {
+    return `
+  deploy-cloudflare:
+    needs: build
+    runs-on: ubuntu-latest
+    if: contains(github.event.inputs.platform || 'all', 'cloudflare') || github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy to Cloudflare Workers
+        run: npm run deploy
+        env:
+          CLOUDFLARE_API_TOKEN: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+`;
+}
+/**
+ * Build Deno job
+ */
+function buildDenoJob() {
+    return `
+  deploy-deno:
+    needs: build
+    runs-on: ubuntu-latest
+    if: contains(github.event.inputs.platform || 'all', 'deno') || github.event_name == 'push'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy to Deno Deploy
+        run: echo "Deploying to Deno..."
+`;
+}
+/**
+ * WorkflowGenerator object for backward compatibility
+ */
+export const WorkflowGenerator = Object.freeze({
+    generate: generateWorkflow,
+    getTemplate: getWorkflowTemplate,
+});

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

@@ -0,0 +1,37 @@
+/**
+ * Scaffolding Module Exports
+ */
+export { ControllerGenerator } from '../scaffolding/ControllerGenerator';
+export type { ControllerGeneratorResult, ControllerOptions, ControllerType, } from '../scaffolding/ControllerGenerator';
+export { FactoryGenerator } from '../scaffolding/FactoryGenerator';
+export type { FactoryField, FactoryGeneratorResult, FactoryOptions, } from '../scaffolding/FactoryGenerator';
+export { FeatureScaffolder } from '../scaffolding/FeatureScaffolder';
+export type { FeatureOptions, FeatureScaffoldResult, FeatureType, } from '../scaffolding/FeatureScaffolder';
+export { FileGenerator } from '../scaffolding/FileGenerator';
+export type { FileCreationOptions } from '../scaffolding/FileGenerator';
+export { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder';
+export type { GovernanceScaffoldOptions, GovernanceScaffoldResult, } from '../scaffolding/GovernanceScaffolder';
+export { MigrationGenerator } from '../scaffolding/MigrationGenerator';
+export type { MigrationOptions, MigrationScaffoldResult, } from '../scaffolding/MigrationGenerator';
+export { ModelGenerator } from '../scaffolding/ModelGenerator';
+export type { FieldType, ModelField, ModelGeneratorResult, ModelOptions, ModelRelationship, } from '../scaffolding/ModelGenerator';
+export { ProjectScaffolder } from '../scaffolding/ProjectScaffolder';
+export type { ProjectScaffoldOptions, ProjectScaffoldResult, } from '../scaffolding/ProjectScaffolder';
+export { RequestFactoryGenerator } from '../scaffolding/RequestFactoryGenerator';
+export type { RequestFactoryGeneratorResult, RequestFactoryOptions, RequestField, } from '../scaffolding/RequestFactoryGenerator';
+export { ResponseFactoryGenerator } from '../scaffolding/ResponseFactoryGenerator';
+export type { ResponseFactoryGeneratorResult, ResponseFactoryOptions, ResponseField, } from '../scaffolding/ResponseFactoryGenerator';
+export { RouteGenerator } from '../scaffolding/RouteGenerator';
+export type { RouteDefinition, RouteGeneratorResult, RouteMethod, RouteOptions, } from '../scaffolding/RouteGenerator';
+export { SeederGenerator } from '../scaffolding/SeederGenerator';
+export type { SeederField, SeederGeneratorResult, SeederOptions, } from '../scaffolding/SeederGenerator';
+export { ServiceIntegrationTestGenerator } from '../scaffolding/ServiceIntegrationTestGenerator';
+export type { ServiceEndpoint, ServiceIntegrationTestOptions, ServiceIntegrationTestResult, } from '../scaffolding/ServiceIntegrationTestGenerator';
+export { ServiceRequestFactoryGenerator } from '../scaffolding/ServiceRequestFactoryGenerator';
+export type { ServiceRequestFactoryResult, ServiceRequestField, ServiceRequestOptions, } from '../scaffolding/ServiceRequestFactoryGenerator';
+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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,GACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,GACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,WAAW,GACZ,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,YAAY,EACV,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,YAAY,EACV,6BAA6B,EAC7B,qBAAqB,EACrB,YAAY,GACb,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,YAAY,EACV,8BAA8B,EAC9B,sBAAsB,EACtB,aAAa,GACd,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,YAAY,GACb,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,aAAa,GACd,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AACnG,YAAY,EACV,eAAe,EACf,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,iDAAiD,CAAC;AACjG,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACrF,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}

package/src/cli/scaffolding/index.js

@@ -0,0 +1,20 @@
+/**
+ * Scaffolding Module Exports
+ */
+export { ControllerGenerator } from '../scaffolding/ControllerGenerator.js';
+export { FactoryGenerator } from '../scaffolding/FactoryGenerator.js';
+export { FeatureScaffolder } from '../scaffolding/FeatureScaffolder.js';
+export { FileGenerator } from '../scaffolding/FileGenerator.js';
+export { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder.js';
+export { MigrationGenerator } from '../scaffolding/MigrationGenerator.js';
+export { ModelGenerator } from '../scaffolding/ModelGenerator.js';
+export { ProjectScaffolder } from '../scaffolding/ProjectScaffolder.js';
+export { RequestFactoryGenerator } from '../scaffolding/RequestFactoryGenerator.js';
+export { ResponseFactoryGenerator } from '../scaffolding/ResponseFactoryGenerator.js';
+export { RouteGenerator } from '../scaffolding/RouteGenerator.js';
+export { SeederGenerator } from '../scaffolding/SeederGenerator.js';
+export { ServiceIntegrationTestGenerator } from '../scaffolding/ServiceIntegrationTestGenerator.js';
+export { ServiceRequestFactoryGenerator } from '../scaffolding/ServiceRequestFactoryGenerator.js';
+export { ServiceScaffolder } from '../scaffolding/ServiceScaffolder.js';
+export { BUILT_IN_TEMPLATES, TemplateEngine } from '../scaffolding/TemplateEngine.js';
+export { TemplateGenerator } from '../scaffolding/TemplateGenerator.js';

package/src/cli/services/VersionChecker.d.ts

@@ -0,0 +1,82 @@
+/**
+ * VersionChecker - CLI Version Update Notification Service
+ *
+ * Checks if the current CLI version is outdated and warns users
+ * when a newer version is available from npm registry.
+ */
+import { type IHttpResponse } from '../../tools/http/Http';
+interface VersionCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    isOutdated: boolean;
+    updateAvailable: boolean;
+}
+interface VersionCheckConfig {
+    enabled: boolean;
+    checkInterval: number;
+    skipVersionCheck: boolean;
+}
+export declare const VersionChecker: Readonly<{
+    /**
+     * Resolve the nearest package.json from a starting directory.
+     */
+    findNearestPackageJson(startDir: string): string | null;
+    /**
+     * Get current version from package.json
+     */
+    getCurrentVersion(): string;
+    /**
+     * Get version check configuration
+     */
+    getConfig(): VersionCheckConfig;
+    /**
+     * Check if version check should be performed
+     */
+    shouldCheckVersion(): boolean;
+    /**
+     * Fetch latest version from npm registry
+     */
+    fetchLatestVersion(): Promise<string>;
+    /**
+     * Make request to npm registry
+     */
+    fetchFromNpmRegistry(): Promise<IHttpResponse>;
+    /**
+     * Handle HTTP errors from npm registry
+     */
+    handleHttpError(): string;
+    /**
+     * Extract version from npm registry response
+     */
+    extractVersionFromResponse(data: unknown): string;
+    /**
+     * Check if response data is valid object
+     */
+    isValidResponseData(data: unknown): data is Record<string, unknown>;
+    /**
+     * Extract version from dist-tags
+     */
+    getVersionFromDistTags(dataRecord: Record<string, unknown>): string | null;
+    /**
+     * Extract version from version field
+     */
+    getVersionFromField(dataRecord: Record<string, unknown>): string | null;
+    /**
+     * Compare versions using semver-like comparison
+     */
+    compareVersions(current: string, latest: string): number;
+    /**
+     * Perform version check and return result
+     */
+    checkVersion(): Promise<VersionCheckResult | null>;
+    /**
+     * Display update notification to user
+     */
+    displayUpdateNotification(result: VersionCheckResult): void;
+    /**
+     * Run version check and display notification if needed
+     */
+    runVersionCheck(): Promise<void>;
+}>;
+export {};
+//# sourceMappingURL=VersionChecker.d.ts.map

package/src/cli/services/VersionChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionChecker.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/VersionChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKlE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc;IACzB;;OAEG;qCAC8B,MAAM,GAAG,MAAM,GAAG,IAAI;IAcvD;;OAEG;yBACkB,MAAM;IAkB3B;;OAEG;iBACU,kBAAkB;IAQ/B;;OAEG;0BACmB,OAAO;IA+B7B;;OAEG;0BACyB,OAAO,CAAC,MAAM,CAAC;IAgB3C;;OAEG;4BAC2B,OAAO,CAAC,aAAa,CAAC;IAQpD;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qCAC8B,OAAO,GAAG,MAAM;IAuBjD;;OAEG;8BACuB,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInE;;OAEG;uCACgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAY1E;;OAEG;oCAC6B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAQvE;;OAEG;6BACsB,MAAM,UAAU,MAAM,GAAG,MAAM;IAuBxD;;OAEG;oBACmB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA6BxD;;OAEG;sCAC+B,kBAAkB,GAAG,IAAI;IA4B3D;;OAEG;uBACsB,OAAO,CAAC,IAAI,CAAC;EAUtC,CAAC"}