domain-driver 0.0.4 → 0.1.0

package/README.md

@@ -13,47 +13,182 @@ npm install -g domain-driver
 Or use without installing:
 
 ```bash
-npx domain-driver make:feature <name>
+npx domain-driver make:feature <n>
 ```
 
 ---
 
-## Usage
+## Commands
+
+### `make:feature`
+
+Scaffold a full feature folder structure.
+
+```bash
+domain-driver make:feature <n>
+domain-driver make:feature <n> -a
+```
+
+The `-a` flag scaffolds all files inside each folder automatically.
+
+```bash
+domain-driver make:feature coffee-type        # folders + .gitkeep only
+domain-driver make:feature coffee-type  -a    # folders + all files
+```
+
+---
+
+### `make:component`
+
+Scaffold a component inside an existing feature. Defaults to `client` if no type is specified.
+
+```bash
+domain-driver make:component <feature> <n>
+domain-driver make:component <feature> <n> client
+domain-driver make:component <feature> <n> server
+```
+
+```bash
+domain-driver make:component coffee-type CoffeeTypeList
+domain-driver make:component coffee-type CoffeeTypeForm client
+domain-driver make:component coffee-type CoffeeTypeCard server
+```
+
+---
+
+### `make:container`
+
+Scaffold a smart container component inside an existing feature.
+
+```bash
+domain-driver make:container <feature> <n>
+```
+
+```bash
+domain-driver make:container coffee-type CoffeeTypeContainer
+```
+
+---
+
+### `make:hook`
+
+Scaffold a custom hook inside an existing feature.
+
+```bash
+domain-driver make:hook <feature> <n>
+```
+
+```bash
+domain-driver make:hook coffee-type useCoffeeType
+```
+
+---
+
+### `make:service`
+
+Scaffold a set of single-responsibility service files inside an existing feature.
+
+```bash
+domain-driver make:service <feature> <n>
+```
 
 ```bash
-domain-driver make:feature <feature-name>
+domain-driver make:service coffee-type CoffeeType
+```
+
+Generates:
+
 ```
+app/coffee-type/services/
+├── ListCoffeeType.service.ts
+├── ShowCoffeeType.service.ts
+├── CreateCoffeeType.service.ts
+├── UpdateCoffeeType.service.ts
+└── DeleteCoffeeType.service.ts
+```
+
+---
+
+### `make:repository`
+
+Scaffold a set of single-responsibility repository files inside an existing feature.
 
-### Examples
+```bash
+domain-driver make:repository <feature> <n>
+```
 
 ```bash
-domain-driver make:feature api-key
-domain-driver make:feature user-profile
-domain-driver make:feature payment
+domain-driver make:repository coffee-type CoffeeType
+```
+
+Generates:
+
+```
+app/coffee-type/repositories/
+├── ListCoffeeType.repository.ts
+├── ShowCoffeeType.repository.ts
+├── CreateCoffeeType.repository.ts
+├── UpdateCoffeeType.repository.ts
+└── DeleteCoffeeType.repository.ts
 ```
 
 ---
 
-## What it generates
+### `make:schema`
+
+Scaffold Zod schemas for create and update operations inside an existing feature.
+
+```bash
+domain-driver make:schema <feature> <n>
+```
+
+```bash
+domain-driver make:schema coffee-type CoffeeType
+```
 
-Running `domain-driver make:feature api-key` creates the following structure inside your Next.js `app/` directory:
+Generates:
+
+```
+app/coffee-type/schemas/
+├── CreateCoffeeType.schema.ts
+└── UpdateCoffeeType.schema.ts
+```
+
+---
+
+## What `make:feature -a` generates
+
+Running `domain-driver make:feature coffee-type -a` creates the full structure:
 
 ```
 app/
-└── api-key/
+└── coffee-type/
     ├── components/
-    │   ├── server/        # React Server Components
-    │   └── client/        # Client components ('use client')
-    ├── containers/        # Smart components — wire hooks → UI
-    ├── hooks/             # Feature-specific hooks (useApiKey, etc.)
-    ├── services/          # Business logic and transformations
-    ├── repositories/      # Data access layer (fetch/axios calls)
-    ├── schemas/           # Zod schemas for forms and API validation
-    └── page.tsx           # Next.js page entry point
+    │   ├── server/
+    │   └── client/
+    │       └── CoffeeType.tsx
+    ├── containers/
+    │   └── CoffeeTypeContainer.tsx
+    ├── hooks/
+    │   └── useCoffeeType.ts
+    ├── services/
+    │   ├── ListCoffeeType.service.ts
+    │   ├── ShowCoffeeType.service.ts
+    │   ├── CreateCoffeeType.service.ts
+    │   ├── UpdateCoffeeType.service.ts
+    │   └── DeleteCoffeeType.service.ts
+    ├── repositories/
+    │   ├── ListCoffeeType.repository.ts
+    │   ├── ShowCoffeeType.repository.ts
+    │   ├── CreateCoffeeType.repository.ts
+    │   ├── UpdateCoffeeType.repository.ts
+    │   └── DeleteCoffeeType.repository.ts
+    ├── schemas/
+    │   ├── CreateCoffeeType.schema.ts
+    │   └── UpdateCoffeeType.schema.ts
+    └── page.tsx
 ```
 
-Each folder includes a `.gitkeep` file so empty directories are tracked in Git.
-
 ---
 
 ## Philosophy
@@ -67,22 +202,27 @@ The layer responsibilities are:
 - **hooks** — React state and side effects, calls services
 - **containers** — wire hooks into UI, no direct data fetching
 - **components** — pure presentational UI, no data dependencies
-- **schemas** — Zod validation for both forms and API responses
+- **schemas** — Zod validation for create and update operations
 
 ---
 
 ## Requirements
 
 - Node.js 18+
-- A Next.js project with an `app/` directory (App Router)
 
 ---
 
+## Framework Support
+
+This tool is optimised for **Next.js App Router** projects. All files are scaffolded into the `app/` directory following Next.js conventions (`page.tsx`, server/client component separation, etc.).
+
+If no `app/` directory exists, it will be created automatically. This means the tool can also be used in any project where an `app/<feature>` folder structure makes sense.
+
 ## Local Development
 
 ```bash
 # Clone the repo
-git clone https://github.com/yourname/domain-driver
+git clone https://github.com/IsaacHatilima/domain-driver
 cd domain-driver
 
 # Install dependencies
@@ -96,17 +236,22 @@ npm link
 
 # Test it
 domain-driver make:feature test-feature
+domain-driver make:feature test-feature -a
 ```
 
 ---
 
 ## Roadmap
 
-- [ ] `make:component` — scaffold a single component
-- [ ] `make:hook` — scaffold a custom hook
-- [ ] `make:service` — scaffold a service
-- [ ] Framework detection — auto-adapt structure for Laravel, Go, etc.
-- [ ] Interactive mode — prompt for feature name if not provided
+- [x] `make:feature` — scaffold feature folder structure
+- [x] `make:feature -a` — scaffold feature with all files
+- [x] `make:component` — scaffold a component
+- [x] `make:container` — scaffold a container
+- [x] `make:hook` — scaffold a custom hook
+- [x] `make:service` — scaffold single-responsibility services
+- [x] `make:repository` — scaffold single-responsibility repositories
+- [x] `make:schema` — scaffold Zod schemas
+- [ ] Interactive mode — prompt for name if not provided
 - [ ] Config file — customize folder structure per project
 
 ---

package/dist/commands/component.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeComponent = makeComponent;
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+function renderComponent(name, type) {
+    const directive = type === 'client' ? "'use client';\n\n" : '';
+    return `${directive}interface ${name}Props {
+  id: string;
+}
+
+export default function ${name}({ id }: ${name}Props) {
+  return (
+    <div>
+      <h1>${name}</h1>
+    </div>
+  );
+}
+`;
+}
+function makeComponent(feature, name, type = 'client') {
+    const base = (0, utils_1.ensureFeatureExists)(feature, `components/${type}`);
+    const filePath = path.join(base, `${name}.tsx`);
+    if ((0, utils_1.fileExists)(filePath)) {
+        throw new Error(`Component "${name}" already exists at ${filePath}`);
+    }
+    (0, utils_1.writeFileSafe)(filePath, renderComponent(name, type));
+    console.log(`✅ Component "${name}" created at ${filePath}`);
+}

package/dist/commands/container.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeContainer = makeContainer;
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+function renderContainer(containerName, name, feature) {
+    const hookName = `use${name}`;
+    const hookPath = (0, utils_1.resolveImport)(feature, `hooks/${hookName}`);
+    const componentPath = (0, utils_1.resolveImport)(feature, `components/client/${name}`);
+    return `'use client';
+
+import { ${hookName} } from '${hookPath}';
+import ${name} from '${componentPath}';
+
+export default function ${containerName}() {
+  const { items, loading, error } = ${hookName}();
+
+  if (loading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error}</div>;
+
+  return (
+    <div>
+      {items.map((item) => (
+        <${name} key={item.id} {...item} />
+      ))}
+    </div>
+  );
+}
+`;
+}
+function makeContainer(feature, name, pascalName) {
+    const base = (0, utils_1.ensureFeatureExists)(feature, 'containers');
+    const filePath = path.join(base, `${name}.tsx`);
+    if ((0, utils_1.fileExists)(filePath)) {
+        throw new Error(`Container "${name}" already exists at ${filePath}`);
+    }
+    const entityName = pascalName ?? name.replace(/Container$/, '');
+    (0, utils_1.writeFileSafe)(filePath, renderContainer(name, entityName, feature));
+    console.log(`✅ Container "${name}" created at ${filePath}`);
+}

package/dist/commands/feature.js

@@ -34,8 +34,15 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeFeature = makeFeature;
-const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+const component_1 = require("./component");
+const hook_1 = require("./hook");
+const service_1 = require("./service");
+const repository_1 = require("./repository");
+const schema_1 = require("./schema");
+const container_1 = require("./container");
+const types_1 = require("./types");
 const FEATURE_DIRS = [
     'components/server',
     'components/client',
@@ -44,28 +51,48 @@ const FEATURE_DIRS = [
     'services',
     'repositories',
     'schemas',
+    'types',
 ];
-function renderTemplate(name) {
-    const componentName = name
-        .split('-')
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join('');
-    return `export default function ${componentName}Page() {
+function renderPage(name, pascalName) {
+    const containerPath = (0, utils_1.resolveImport)(name, `containers/${pascalName}Container`, true);
+    return `import ${pascalName}Container from '${containerPath}';
+
+export default function ${pascalName}Page() {
   return (
     <div>
-      <h1>${componentName}</h1>
+      <${pascalName}Container />
     </div>
   );
 }
 `;
 }
-async function makeFeature(name) {
-    const base = path.join(process.cwd(), 'app', name);
+async function makeFeature(name, all = false) {
+    const base = (0, utils_1.featureBasePath)(name);
+    const pascalName = (0, utils_1.toPascalCase)(name);
+    if ((0, utils_1.fileExists)(base)) {
+        throw new Error(`Feature "${name}" already exists at ${base}`);
+    }
     for (const dir of FEATURE_DIRS) {
-        fs.mkdirSync(path.join(base, dir), { recursive: true });
-        fs.writeFileSync(path.join(base, dir, '.gitkeep'), '');
+        (0, utils_1.mkdirSafe)(path.join(base, dir));
+        if (!all) {
+            (0, utils_1.writeFileSafe)(path.join(base, dir, '.gitkeep'), '');
+        }
+    }
+    if (all) {
+        (0, utils_1.writeFileSafe)(path.join(base, 'page.tsx'), renderPage(name, pascalName));
+    }
+    else {
+        (0, utils_1.writeFileSafe)(path.join(base, 'page.tsx'), `export default function ${pascalName}Page() {\n  return (\n    <div>\n      <h1>${pascalName}</h1>\n    </div>\n  );\n}\n`);
     }
-    const page = renderTemplate(name);
-    fs.writeFileSync(path.join(base, 'page.tsx'), page);
     console.log(`✅ Feature "${name}" scaffolded at ${base}`);
+    if (all) {
+        (0, types_1.makeTypes)(name, pascalName);
+        (0, schema_1.makeSchema)(name, pascalName);
+        (0, repository_1.makeRepository)(name, pascalName);
+        (0, service_1.makeService)(name, pascalName);
+        (0, hook_1.makeHook)(name, `use${pascalName}`, pascalName);
+        (0, component_1.makeComponent)(name, pascalName, 'client');
+        (0, container_1.makeContainer)(name, `${pascalName}Container`, pascalName);
+        console.log(`✅ All files scaffolded for "${name}"`);
+    }
 }

package/dist/commands/hook.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeHook = makeHook;
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+function renderHook(hookName, name, feature) {
+    const typePath = (0, utils_1.resolveImport)(feature, `types/${name}.types`);
+    const svcPath = (op) => (0, utils_1.resolveImport)(feature, `services/${op}${name}.service`);
+    const schemaPath = (op) => (0, utils_1.resolveImport)(feature, `schemas/${op}${name}.schema`);
+    return `'use client';
+
+import { useState, useEffect, useCallback } from 'react';
+import { ${name} } from '${typePath}';
+import { List${name}Service } from '${svcPath('List')}';
+import { Show${name}Service } from '${svcPath('Show')}';
+import { Create${name}Service } from '${svcPath('Create')}';
+import { Update${name}Service } from '${svcPath('Update')}';
+import { Delete${name}Service } from '${svcPath('Delete')}';
+import { Create${name} } from '${schemaPath('Create')}';
+import { Update${name} } from '${schemaPath('Update')}';
+
+const listService = new List${name}Service();
+const showService = new Show${name}Service();
+const createService = new Create${name}Service();
+const updateService = new Update${name}Service();
+const deleteService = new Delete${name}Service();
+
+export function ${hookName}() {
+  const [items, setItems] = useState<${name}[]>([]);
+  const [selected, setSelected] = useState<${name} | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  const fetchAll = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await listService.handle();
+      setItems(data);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to fetch');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const fetchOne = useCallback(async (id: string) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await showService.handle(id);
+      setSelected(data);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to fetch');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const create = useCallback(async (data: Create${name}) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const created = await createService.handle(data);
+      setItems((prev) => [...prev, created]);
+      return created;
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to create');
+      return null;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const update = useCallback(async (id: string, data: Update${name}) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const updated = await updateService.handle(id, data);
+      setItems((prev) => prev.map((item) => (item.id === id ? updated : item)));
+      return updated;
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to update');
+      return null;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const remove = useCallback(async (id: string) => {
+    setLoading(true);
+    setError(null);
+    try {
+      await deleteService.handle(id);
+      setItems((prev) => prev.filter((item) => item.id !== id));
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : 'Failed to delete');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    fetchAll();
+  }, [fetchAll]);
+
+  return { items, selected, loading, error, fetchAll, fetchOne, create, update, remove };
+}
+`;
+}
+function makeHook(feature, name, pascalName) {
+    const base = (0, utils_1.ensureFeatureExists)(feature, 'hooks');
+    const filePath = path.join(base, `${name}.ts`);
+    if ((0, utils_1.fileExists)(filePath)) {
+        throw new Error(`Hook "${name}" already exists at ${filePath}`);
+    }
+    const entityName = pascalName ?? name.replace(/^use/, '');
+    (0, utils_1.writeFileSafe)(filePath, renderHook(name, entityName, feature));
+    console.log(`✅ Hook "${name}" created at ${filePath}`);
+}