@domain-first/project-structure 2.3.0 → 2.4.0

package/README.md

@@ -1,11 +1,54 @@
-# Domain-First Project Structure
+# @domain-first/project-structure
 
-Build and manage your Domain-First project structure with CLI.
+Stop hand-rolling folders. Scaffold a clean, consistent **Domain-First** architecture — bounded contexts, aggregates, use cases, commands/queries, ports, REST endpoints, React modules — with one command, every time.
 
-## Usage
+```bash
+npx df-ps
+```
+
+## Why
+
+- **Zero boilerplate** — aggregates, repositories, wiring and tests generated in seconds, correctly named and cross-linked
+- **One consistent architecture** — every bounded context, layer and file lands in the same place, no matter who on the team runs it
+- **Grows with your stack** — adapts output to whichever `@domain-first` packages (`types`, `errors`, `handlers`, `wire`, `handlers-rest`) you use, or stays framework-free if you don't
+- **Interactive, not magic** — a guided CLI menu, not a rigid template you fight against
+
+## Install
 
 ```bash
-npm i @domain-first/project-structure
+npm i -D @domain-first/project-structure
+```
+
+## Quick start
 
+```bash
 npx df-ps
 ```
+
+First run walks you through a short setup (source folder, packages, testing library) and writes a config file. Every run after that opens a menu to scaffold whatever you need next — a new aggregate, use case, endpoint, widget — into your existing structure.
+
+## What gets generated
+
+Pick a piece, get the whole slice — class, tests, infra implementation and wiring, all linked together:
+
+- **Domain** — aggregates, repositories, services, namespaced errors
+- **Application** — use cases, commands & queries (execution or orchestration), ports
+- **Infrastructure** — adapter implementations per port/repository (e.g. `prisma`, `in-memory`)
+- **Presentation** — REST endpoints, React pages/widgets
+
+Everything lands with consistent naming and imports. For example:
+
+```
+bounded-contexts/
+  order/
+    domain/aggregates/order/
+    application/use-cases/
+    application/commands/
+    infrastructure/repositories/
+    presentation/rest/
+    wiring/
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -481,6 +481,10 @@ const scaffoldNewCommand = async (boundedContextFolder)=>{
     const commandName = await (0, prompts_namespaceObject.input)({
         message: 'Name: '
     });
+    let scaffoldUnitTests;
+    if (ConfigFile.Instance.data.testingLibrary) scaffoldUnitTests = await (0, prompts_namespaceObject.confirm)({
+        message: 'Scaffold unit-tests'
+    });
     const naming = new UnknownFormatNaming(commandName);
     const commandType = await (0, prompts_namespaceObject.select)({
         choices: [
@@ -490,6 +494,25 @@ const scaffoldNewCommand = async (boundedContextFolder)=>{
         message: 'Command type'
     });
     const isOrchestrator = 'Orchestrator (no infrastructure implementation)' === commandType;
+    if (scaffoldUnitTests) commandsFolder.subitem([
+        isOrchestrator ? 'orchestration' : 'execution'
+    ]).createFile(`${naming.fileName}-command.spec.ts`, `
+import { describe, test, expect, beforeEach } from '${ConfigFile.Instance.data.testingLibrary}'
+import { type ${naming.ClassName}Command } from './${naming.fileName}-command'
+import { wire${naming.ClassName}Command } from '../../../wiring/commands/wire-${naming.fileName}-command'
+
+let ${naming.variableName}Command: ${naming.ClassName}Command
+
+beforeEach(() => {
+    ${naming.variableName}Command = wire${naming.ClassName}Command()
+})
+
+describe('${naming.withSpaces} command', () => {
+    test('can be wired', () => {
+        expect(${naming.variableName}Command).toBeDefined()
+    })
+})
+                `);
     if (!isOrchestrator) {
         const implementationType = await (0, prompts_namespaceObject.input)({
             message: 'Command infrastructure implementation type:',
@@ -603,11 +626,10 @@ export class ${naming.ClassName}Command {
 }`.trim());
     if (ConfigFile.Instance.data.domainFirstPackages.includes('@domain-first/wire')) boundedContextFolder.subitem([
         'wiring',
-        'application',
         'commands'
     ]).createFile(`wire-${naming.fileName}-command.ts`, `
 import { wireClass } from '@domain-first/wire'
-import { ${naming.ClassName}Command } from '../../../application/commands/orchestration/${naming.fileName}-command'
+import { ${naming.ClassName}Command } from '../../application/commands/orchestration/${naming.fileName}-command'
 
 export const wire${naming.ClassName}Command = wireClass(${naming.ClassName}Command, [])
 `.trim());

package/dist/index.js

@@ -451,6 +451,10 @@ const scaffoldNewCommand = async (boundedContextFolder)=>{
     const commandName = await input({
         message: 'Name: '
     });
+    let scaffoldUnitTests;
+    if (ConfigFile.Instance.data.testingLibrary) scaffoldUnitTests = await prompts_confirm({
+        message: 'Scaffold unit-tests'
+    });
     const naming = new UnknownFormatNaming(commandName);
     const commandType = await prompts_select({
         choices: [
@@ -460,6 +464,25 @@ const scaffoldNewCommand = async (boundedContextFolder)=>{
         message: 'Command type'
     });
     const isOrchestrator = 'Orchestrator (no infrastructure implementation)' === commandType;
+    if (scaffoldUnitTests) commandsFolder.subitem([
+        isOrchestrator ? 'orchestration' : 'execution'
+    ]).createFile(`${naming.fileName}-command.spec.ts`, `
+import { describe, test, expect, beforeEach } from '${ConfigFile.Instance.data.testingLibrary}'
+import { type ${naming.ClassName}Command } from './${naming.fileName}-command'
+import { wire${naming.ClassName}Command } from '../../../wiring/commands/wire-${naming.fileName}-command'
+
+let ${naming.variableName}Command: ${naming.ClassName}Command
+
+beforeEach(() => {
+    ${naming.variableName}Command = wire${naming.ClassName}Command()
+})
+
+describe('${naming.withSpaces} command', () => {
+    test('can be wired', () => {
+        expect(${naming.variableName}Command).toBeDefined()
+    })
+})
+                `);
     if (!isOrchestrator) {
         const implementationType = await input({
             message: 'Command infrastructure implementation type:',
@@ -573,11 +596,10 @@ export class ${naming.ClassName}Command {
 }`.trim());
     if (ConfigFile.Instance.data.domainFirstPackages.includes('@domain-first/wire')) boundedContextFolder.subitem([
         'wiring',
-        'application',
         'commands'
     ]).createFile(`wire-${naming.fileName}-command.ts`, `
 import { wireClass } from '@domain-first/wire'
-import { ${naming.ClassName}Command } from '../../../application/commands/orchestration/${naming.fileName}-command'
+import { ${naming.ClassName}Command } from '../../application/commands/orchestration/${naming.fileName}-command'
 
 export const wire${naming.ClassName}Command = wireClass(${naming.ClassName}Command, [])
 `.trim());

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@domain-first/project-structure",
     "description": "Build and manage your Domain-First project structure with CLI",
-    "version": "2.3.0",
+    "version": "2.4.0",
     "type": "module",
     "repository": {
         "type": "git",