@azure-net/cli 2.3.63 → 4.0.0-1

package/bin/azure-net.ts

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { addLint } from '../src/plugins/index.js';
+
+const program = new Command();
+
+program.name('azure-net').description('Azure-Net CLI generator').version('4.0.0');
+
+const addCommand = program.command('add').description('Add project integrations and plugins');
+const createCommand = program.command('create').description('Create project boilerplate artifacts');
+const initCommand = program.command('init').description('Initialize project scaffolding');
+const installCommand = program.command('install').description('Install project presets and flows');
+const generateCommand = program.command('generate').description('Generate UI artifacts');
+const checkCommand = program.command('check').description('Run project checks');
+
+addCommand
+	.command('commit-tools')
+	.description('Setup linting and commit tools')
+	.option('-m, --manager <manager>', 'Package manager: bun | pnpm | npm | yarn')
+	.action(addLint);
+
+createCommand
+	.command('schema-factory')
+	.description('Create base schema in src/core/schema')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createCoreSchema.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('middleware-manager')
+	.description('Create middleware manager in src/core/middleware-manager')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createCoreMiddleware.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('translation-manager')
+	.description('Create translation manager in src/core/translation')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createTranslationManager.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('presenter-factory')
+	.description('Create presenter factory in src/core/presenter')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createPresenterFactory.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('schema-rule')
+	.description('Create schema rule in src/core/schema/custom-rules')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createSchemaRule.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('middleware')
+	.description('Create middleware in src/core/middleware-manager/middlewares')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createMiddleware.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('response')
+	.description('Create response in src/core/response')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createResponse.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('datasource')
+	.description('Create datasource in core or context infrastructure')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createDatasource.js')).default;
+		await handler();
+	});
+
+createCommand
+	.command('datasource-provider')
+	.description('Create datasource provider in core or context infrastructure')
+	.action(async () => {
+		const handler = (await import('../src/scaffolds/createDatasourceProvider.js')).default;
+		await handler();
+	});
+
+initCommand
+	.command('edges')
+	.description('Initialize edges plugin in vite config')
+	.action(async () => {
+		const handler = (await import('../src/init/initEdges.js')).default;
+		await handler();
+	});
+
+initCommand
+	.command('folders-structure')
+	.description('Generate base folders structure')
+	.action(async () => {
+		const handler = (await import('../src/init/initStructure.js')).default;
+		await handler();
+	});
+
+initCommand.action(async () => {
+	const initStructure = (await import('../src/init/initStructure.js')).default;
+	await initStructure();
+});
+
+installCommand
+	.command('fresh')
+	.description('Run full fresh install flow (structure + optional generators)')
+	.action(async () => {
+		const handler = (await import('../src/install/installFresh.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('component')
+	.description('Generate UI component')
+	.action(async () => {
+		const handler = (await import('../src/generate/ui/generateComponent.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('widget')
+	.description('Generate UI widget')
+	.action(async () => {
+		const handler = (await import('../src/generate/ui/generateWidget.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('design-component')
+	.description('Generate UI design component')
+	.action(async () => {
+		const handler = (await import('../src/generate/ui/generateDesignComponent.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('repository')
+	.description('Generate infrastructure repository')
+	.action(async () => {
+		const handler = (await import('../src/generate/layers/generateRepository.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('repo')
+	.description('Generate infrastructure repository (module flow)')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateRepository.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('repository-method')
+	.description('Generate method for an existing repository')
+	.action(async () => {
+		const handler = (await import('../src/generate/layers/generateRepositoryMethod.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('use-cases')
+	.description('Generate use-cases for an existing repository')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateUseCases.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('domain')
+	.description('Generate domain module (model/ports)')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateDomain.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('presenter')
+	.description('Generate presentation layer presenter from UseCases')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generatePresenter.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('types-json')
+	.description('Fill model interface keys from JSON')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateTypesJson.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('schema-from-type')
+	.description('Fill schema rules keys from schema generic type')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateSchemaFromType.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('module')
+	.description('Generate domain + repository + presenter flow')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateModule.js')).default;
+		await handler();
+	});
+
+generateCommand
+	.command('module-preset')
+	.description('Generate preset CRUD-like module flow')
+	.action(async () => {
+		const handler = (await import('../src/generate/module/generateModulePreset.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('presenter-names')
+	.description('Check duplicate presenter names in src')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkPresenterNames.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('provider-names')
+	.description('Check duplicate provider names in src')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkProviderNames.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('domain')
+	.description('Check domain naming and structure rules in all contexts')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkDomain.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('layer-boundaries')
+	.description('Check layer boundaries between contexts by aliases')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkLayerBoundaries.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('folders-structure')
+	.description('Check allowed folders structure in context layers/ui/components')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkFoldersStructure.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('internal')
+	.description('Run all internal azure-net checks')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkInternal.js')).default;
+		await handler();
+	});
+
+checkCommand
+	.command('project')
+	.description('Run full project checks: format, internal, lint, typecheck')
+	.action(async () => {
+		const handler = (await import('../src/checks/checkProject.js')).default;
+		await handler();
+	});
+
+program.parse();

package/eslint.config.js

@@ -0,0 +1,34 @@
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+	{
+		ignores: ['dist/**', 'node_modules/**']
+	},
+	js.configs.recommended,
+	...tseslint.configs.recommended,
+	{
+		files: ['bin/**/*.ts', 'src/plugins/**/*.ts'],
+		languageOptions: {
+			globals: {
+				console: 'readonly',
+				process: 'readonly'
+			}
+		}
+	},
+	{
+		files: [
+			'src/generate/module/repositoryModuleShared.ts',
+			'src/generate/layers/repositoryShared.ts',
+			'src/generate/layers/generateUseCases.ts',
+			'src/generate/layers/generateRepositoryMethod.ts',
+			'src/generate/layers/generateRepository.ts',
+			'src/utils/contextUtils.ts',
+			'src/utils/loadConfig.ts',
+			'src/utils/fileUtils.ts'
+		],
+		rules: {
+			'@typescript-eslint/ban-ts-comment': 'off'
+		}
+	}
+);

package/package.json

@@ -1,23 +1,30 @@
 {
   "name": "@azure-net/cli",
-  "version": "2.3.63",
+  "version": "4.0.0-1",
   "type": "module",
   "bin": {
     "azure-net": "bin/azure-net.js"
   },
   "peerDependencies": {
-    "@azure-net/kit": "^2.1.5"
+    "@azure-net/kit": "^4.0.0"
   },
   "dependencies": {
-    "@azure-net/kit": "^2.1.5",
     "commander": "^11",
     "prompts": "^2"
   },
   "devDependencies": {
+    "@eslint/js": "^9.31.0",
     "@types/node": "^24.0.3",
-    "typescript": "^5"
+    "@types/prompts": "^2.4.9",
+    "eslint": "^9.31.0",
+    "prettier": "^3.6.2",
+    "typescript": "^5",
+    "typescript-eslint": "^8.36.0"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint \"bin/**/*.ts\" \"src/**/*.ts\"",
+    "format": "prettier --write ."
   }
 }

package/src/checks/checkDomain.js

@@ -0,0 +1,201 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { loadUserConfig } from '../utils/loadConfig.js';
+import { normalizeContexts } from '../init/initAliases.js';
+
+const DOMAIN_FILE_EXTENSIONS = new Set(['.ts']);
+const IGNORED_DIRS = new Set(['node_modules', 'dist', '.svelte-kit', '.git']);
+
+const INTERFACE_DECLARATION_PATTERN = /(?:^|\n)\s*(?:export\s+)?interface\s+([A-Za-z_$][A-Za-z0-9_$]*)\b/g;
+const TYPE_DECLARATION_PATTERN = /(?:^|\n)\s*(?:export\s+)?type\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=/g;
+
+const EXPORT_STAR_PATTERN = /export\s+\*\s+from\s*['"][^'"]+['"]\s*;?/g;
+const EXPORT_FROM_PATTERN = /export\s+(?:type\s+)?\{[\s\S]*?\}\s+from\s*['"][^'"]+['"]\s*;?/g;
+const EXPORT_LOCAL_PATTERN = /export\s+(?:type\s+)?\{[\s\S]*?\}\s*;?/g;
+
+const toPosixPath = (value) => value.split(path.sep).join('/');
+
+const stripComments = (content) => content.replace(/\/\*[\s\S]*?\*\//g, '').replace(/(^|[^\\])\/\/.*$/gm, '$1');
+
+const stripExportStatements = (content) =>
+	content.replace(EXPORT_STAR_PATTERN, '').replace(EXPORT_FROM_PATTERN, '').replace(EXPORT_LOCAL_PATTERN, '');
+
+const findLineByIndex = (content, index) => {
+	let line = 1;
+	for (let i = 0; i < index; i += 1) {
+		if (content[i] === '\n') line += 1;
+	}
+	return line;
+};
+
+const getRelativeFilePath = (filePath) => toPosixPath(path.relative(process.cwd(), filePath));
+
+const isEnumsPath = (filePath) => {
+	const normalized = toPosixPath(filePath);
+	return normalized.includes('/enums/');
+};
+
+const isIndexFile = (filePath) => path.basename(filePath) === 'index.ts';
+
+const isExportOnlyIndex = (content) => {
+	const withoutComments = stripComments(content);
+	const withoutExports = stripExportStatements(withoutComments);
+	return withoutExports.trim().length === 0;
+};
+
+const validateName = (declaration) => {
+	if (declaration.kind === 'interface') {
+		return /^I[A-Z]/.test(declaration.name) ? null : `Interface "${declaration.name}" must start with "I" and have uppercase second letter`;
+	}
+
+	return /^[IT][A-Z]/.test(declaration.name)
+		? null
+		: `Type "${declaration.name}" must start with "I" or "T" and have uppercase second letter`;
+};
+
+const extractDeclarations = (content) => {
+	const cleaned = stripComments(content);
+	const declarations = [];
+
+	const interfaceRegex = new RegExp(INTERFACE_DECLARATION_PATTERN.source, 'g');
+	let interfaceMatch;
+	while ((interfaceMatch = interfaceRegex.exec(cleaned)) !== null) {
+		const name = interfaceMatch[1];
+		if (!name) continue;
+		declarations.push({
+			kind: 'interface',
+			name,
+			line: findLineByIndex(cleaned, interfaceMatch.index)
+		});
+	}
+
+	const typeRegex = new RegExp(TYPE_DECLARATION_PATTERN.source, 'g');
+	let typeMatch;
+	while ((typeMatch = typeRegex.exec(cleaned)) !== null) {
+		const name = typeMatch[1];
+		if (!name) continue;
+		declarations.push({
+			kind: 'type',
+			name,
+			line: findLineByIndex(cleaned, typeMatch.index)
+		});
+	}
+
+	return declarations.sort((a, b) => a.line - b.line);
+};
+
+const listDomainFiles = async (domainRoot) => {
+	const files = [];
+	const stack = [domainRoot];
+
+	while (stack.length) {
+		const current = stack.pop();
+		if (!current) continue;
+
+		let entries = [];
+		try {
+			entries = await fs.readdir(current, { withFileTypes: true });
+		} catch {
+			continue;
+		}
+
+		for (const entry of entries) {
+			if (entry.isDirectory()) {
+				if (!IGNORED_DIRS.has(entry.name)) {
+					stack.push(path.join(current, entry.name));
+				}
+				continue;
+			}
+
+			if (!entry.isFile()) continue;
+			const filePath = path.join(current, entry.name);
+			if (!DOMAIN_FILE_EXTENSIONS.has(path.extname(filePath))) continue;
+			files.push(filePath);
+		}
+	}
+
+	return files;
+};
+
+const collectIssuesForFile = (filePath, content) => {
+	const issues = [];
+
+	if (isIndexFile(filePath) && !isExportOnlyIndex(content)) {
+		issues.push({
+			file: filePath,
+			line: 1,
+			message: 'index.ts must contain only exports. Move declarations to separate files'
+		});
+	}
+
+	if (isEnumsPath(filePath)) {
+		return issues;
+	}
+
+	const declarations = extractDeclarations(content);
+	if (declarations.length > 5) {
+		issues.push({
+			file: filePath,
+			line: declarations[5]?.line ?? 1,
+			message: `Too many declarations in one file (${declarations.length}). Maximum is 5`
+		});
+	}
+
+	for (const declaration of declarations) {
+		const validationError = validateName(declaration);
+		if (!validationError) continue;
+		issues.push({
+			file: filePath,
+			line: declaration.line,
+			message: validationError
+		});
+	}
+
+	return issues;
+};
+
+export default async function checkDomain() {
+	const config = await loadUserConfig();
+	const contexts = normalizeContexts(config.contexts);
+
+	if (!contexts.length) {
+		console.error('❌ No contexts found in azure-net.config.ts/js. Fill `contexts` first.');
+		process.exitCode = 1;
+		return;
+	}
+
+	const issues = [];
+
+	for (const context of contexts) {
+		const domainRoot = path.join(process.cwd(), 'src', 'app', context.name, 'layers', 'domain');
+
+		try {
+			await fs.access(domainRoot);
+		} catch {
+			issues.push({
+				file: domainRoot,
+				line: 1,
+				message: `Domain folder not found for context "${context.name}"`
+			});
+			continue;
+		}
+
+		const files = await listDomainFiles(domainRoot);
+		for (const filePath of files) {
+			const content = await fs.readFile(filePath, 'utf-8');
+			issues.push(...collectIssuesForFile(filePath, content));
+		}
+	}
+
+	if (!issues.length) {
+		console.log('✅ Domain check passed: naming, per-file limits and index exports are valid.');
+		return;
+	}
+
+	console.error('❌ Domain check failed:');
+	for (const issue of issues) {
+		console.error(`• ${getRelativeFilePath(issue.file)}:${issue.line} — ${issue.message}`);
+	}
+
+	process.exitCode = 1;
+}