domain-driver 0.0.5 → 0.2.0

package/dist/templates/service.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderService = renderService;
+const injectable_1 = require("./nest/injectable");
+const signatures_1 = require("./signatures");
+function renderService(ctx, spec, entity, fromFile, side) {
+    const repositoryClass = `${spec.name}Repository`;
+    const serviceClass = `${spec.name}Service`;
+    const repositoryLayer = side === 'client' ? 'clientRepository' : 'serverRepository';
+    const repositoryPath = ctx.importLayer(fromFile, repositoryLayer, `${spec.name}.repository`);
+    const injectable = side === 'server' && ctx.profile.name === 'nest';
+    const imports = [
+        ...(injectable ? [injectable_1.INJECTABLE_IMPORT] : []),
+        ...(0, signatures_1.domainImports)(ctx, fromFile, spec, entity),
+        `import { ${repositoryClass} } from '${repositoryPath}';`,
+    ].join('\n');
+    if (injectable) {
+        return `${imports}
+
+@Injectable()
+export class ${serviceClass} {
+  constructor(private readonly repository: ${repositoryClass}) {}
+
+  async handle(${spec.params}): ${spec.returns} {
+    return this.repository.handle(${spec.args});
+  }
+}
+`;
+    }
+    return `${imports}
+
+const repository = new ${repositoryClass}();
+
+export class ${serviceClass} {
+  async handle(${spec.params}): ${spec.returns} {
+    return repository.handle(${spec.args});
+  }
+}
+`;
+}

package/dist/templates/shared/schema.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSchema = renderSchema;
+function renderSchema(name, label) {
+    return `import { z } from 'zod';
+
+export const ${name}Schema = z.object({
+  // add ${label} fields here
+});
+
+export type ${name} = z.infer<typeof ${name}Schema>;
+`;
+}

package/dist/templates/shared/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTypes = renderTypes;
+function renderTypes(entity) {
+    return `export interface ${entity} {
+  id: string;
+  // add ${entity} fields here
+  createdAt: string;
+  updatedAt: string;
+}
+`;
+}

package/dist/templates/signatures.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.domainImports = domainImports;
+function domainImports(ctx, fromFile, spec, entity) {
+    const lines = [];
+    if (spec.usesEntityType) {
+        const typePath = ctx.importLayer(fromFile, 'types', `${entity}.types`);
+        lines.push(`import { ${entity} } from '${typePath}';`);
+    }
+    if (spec.schema !== null) {
+        const schemaPath = ctx.importLayer(fromFile, 'schema', `${spec.schema}.schema`);
+        lines.push(`import { ${spec.schema} } from '${schemaPath}';`);
+    }
+    return lines;
+}

package/dist/utils/alias.js

@@ -0,0 +1,80 @@
+"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.resetAliasCache = resetAliasCache;
+exports.detectAlias = detectAlias;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const WILDCARD_TARGET = /^(?:\.\/)?(.*?)\/?\*$/;
+let cached;
+function resetAliasCache() {
+    cached = undefined;
+}
+function detectAlias() {
+    if (cached !== undefined)
+        return cached;
+    cached = readAlias(path.join(process.cwd(), 'tsconfig.json'));
+    return cached;
+}
+function readAlias(tsconfigPath) {
+    if (!fs.existsSync(tsconfigPath))
+        return null;
+    try {
+        const raw = fs.readFileSync(tsconfigPath, 'utf-8');
+        const stripped = raw.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+        const tsconfig = JSON.parse(stripped);
+        return findWildcardAlias(tsconfig.compilerOptions?.paths ?? {});
+    }
+    catch {
+        return null;
+    }
+}
+function findWildcardAlias(paths) {
+    for (const [key, targets] of Object.entries(paths)) {
+        if (!key.endsWith('/*'))
+            continue;
+        const root = targets.map(aliasRoot).find((candidate) => candidate !== null);
+        if (root !== undefined && root !== null) {
+            return Object.freeze({ prefix: key.slice(0, -1), root });
+        }
+    }
+    return null;
+}
+function aliasRoot(target) {
+    const match = WILDCARD_TARGET.exec(target);
+    if (!match)
+        return null;
+    return match[1] === '' ? '.' : match[1];
+}

package/dist/utils/fs.js

@@ -0,0 +1,70 @@
+"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.writeFileSafe = writeFileSafe;
+exports.mkdirSafe = mkdirSafe;
+exports.fileExists = fileExists;
+exports.isDirectory = isDirectory;
+exports.readTextFile = readTextFile;
+const fs = __importStar(require("fs"));
+function writeFileSafe(filePath, content) {
+    try {
+        fs.writeFileSync(filePath, content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to write ${filePath}: ${message}`);
+    }
+}
+function mkdirSafe(dirPath) {
+    try {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to create directory ${dirPath}: ${message}`);
+    }
+}
+function fileExists(filePath) {
+    return fs.existsSync(filePath);
+}
+function isDirectory(target) {
+    return fs.existsSync(target) && fs.statSync(target).isDirectory();
+}
+function readTextFile(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    return fs.readFileSync(filePath, 'utf-8');
+}

package/dist/utils/imports.js

@@ -0,0 +1,61 @@
+"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.resolveImport = resolveImport;
+const path = __importStar(require("path"));
+const alias_1 = require("./alias");
+function resolveImport(fromFile, toFile) {
+    const target = stripExtension(toFile);
+    const aliased = aliasImport(target);
+    if (aliased !== null)
+        return aliased;
+    const relative = toPosix(path.relative(path.dirname(fromFile), target));
+    return relative.startsWith('.') ? relative : `./${relative}`;
+}
+function aliasImport(target) {
+    const alias = (0, alias_1.detectAlias)();
+    if (!alias)
+        return null;
+    const rootAbs = path.resolve(process.cwd(), alias.root);
+    const relative = path.relative(rootAbs, target);
+    const inside = relative !== '' && !relative.startsWith('..') && !path.isAbsolute(relative);
+    return inside ? `${alias.prefix}${toPosix(relative)}` : null;
+}
+function stripExtension(file) {
+    return file.replace(/\.tsx?$/, '');
+}
+function toPosix(target) {
+    return target.split(path.sep).join('/');
+}

package/dist/utils/naming.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPascalCase = toPascalCase;
+exports.lowerFirst = lowerFirst;
+exports.validateFeatureName = validateFeatureName;
+exports.upperFirst = upperFirst;
+exports.toKebabCase = toKebabCase;
+const FEATURE_NAME_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+function toPascalCase(name) {
+    return name
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+}
+function lowerFirst(name) {
+    return name.charAt(0).toLowerCase() + name.slice(1);
+}
+function validateFeatureName(name) {
+    if (!FEATURE_NAME_PATTERN.test(name)) {
+        throw new Error(`Feature name "${name}" must be kebab-case, for example coffee-type.`);
+    }
+}
+function upperFirst(name) {
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+function toKebabCase(name) {
+    return name
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}

package/dist/utils/paths.js

@@ -0,0 +1,44 @@
+"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.featureDir = featureDir;
+exports.apiRouteDir = apiRouteDir;
+const path = __importStar(require("path"));
+function featureDir(stack, feature) {
+    return path.join(process.cwd(), stack.featureRoot, feature);
+}
+function apiRouteDir(stack, feature) {
+    return path.join(process.cwd(), stack.featureRoot, 'api', feature);
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "domain-driver",
-  "version": "0.0.5",
-  "description": "",
-  "main": "index.js",
+  "version": "0.2.0",
+  "description": "CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, and NestJS projects, with per-action files, bespoke actions, and agent guidance",
+  "main": "dist/index.js",
   "bin": {
     "domain-driver": "./dist/index.js"
   },
@@ -10,18 +10,40 @@
     "type": "git",
     "url": "https://github.com/IsaacHatilima/domain-driver"
   },
+  "files": [
+    "dist",
+    "scripts/postinstall.js"
+  ],
   "scripts": {
-    "build": "npx tsc",
-    "dev": "ts-node src/index.ts",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "postinstall": "node ./scripts/postinstall.js"
+  },
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "domain-driven",
+    "nextjs",
+    "react",
+    "nestjs",
+    "node",
+    "express",
+    "fastify",
+    "hono"
+  ],
+  "author": "Isaac Hatilima",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
   "devDependencies": {
-    "@types/node": "^25.4.0"
+    "@types/node": "^25.4.0",
+    "@vitest/coverage-v8": "^4.1.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.2"
   },
   "dependencies": {
-    "typescript": "^5.9.3"
+    "commander": "^14.0.3"
   }
 }

package/scripts/postinstall.js

@@ -0,0 +1,7 @@
+// Runs after `npm install` in a consuming project. Never fails the install:
+// dist/ may be absent on a fresh clone, and init may throw for any reason.
+try {
+    require('../dist/postinstall.js').run();
+} catch (_error) {
+    // intentionally silent
+}

package/.github/workflows/publish.yml

@@ -1,28 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    branches:
-      - master
-    tags:
-      - 'v*'
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org'
-
-      - run: npm install
-      - run: npm run build
-      - run: npm publish --provenance --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/src/commands/component.ts

@@ -1,36 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-type ComponentType = 'client' | 'server';
-
-function renderComponent(name: string, type: ComponentType): string {
-    const directive = type === 'client' ? "'use client';\n\n" : '';
-
-    return `${directive}export default function ${name}() {
-  return (
-    <div>
-      <h1>${name}</h1>
-    </div>
-  );
-}
-`;
-}
-
-export function makeComponent(feature: string, name: string, type: ComponentType = 'client') {
-    const base = path.join(process.cwd(), 'app', feature, 'components', type);
-
-    if (!fs.existsSync(base)) {
-        console.error(`❌ Feature "${feature}" does not exist. Run make:feature ${feature} first.`);
-        process.exit(1);
-    }
-
-    const filePath = path.join(base, `${name}.tsx`);
-
-    if (fs.existsSync(filePath)) {
-        console.error(`❌ Component "${name}" already exists at ${filePath}`);
-        process.exit(1);
-    }
-
-    fs.writeFileSync(filePath, renderComponent(name, type));
-    console.log(`✅ Component "${name}" created at ${filePath}`);
-}

package/src/commands/container.ts

@@ -1,36 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-function renderContainer(name: string): string {
-    return `'use client';
-
-interface Props {}
-
-export default function ${name}({ }: Props) {
-  return (
-    <div>
-      <h1>${name}</h1>
-    </div>
-  );
-}
-`;
-}
-
-export function makeContainer(feature: string, name: string) {
-    const base = path.join(process.cwd(), 'app', feature, 'containers');
-
-    if (!fs.existsSync(base)) {
-        console.error(`❌ Feature "${feature}" does not exist. Run make:feature ${feature} first.`);
-        process.exit(1);
-    }
-
-    const filePath = path.join(base, `${name}.tsx`);
-
-    if (fs.existsSync(filePath)) {
-        console.error(`❌ Container "${name}" already exists at ${filePath}`);
-        process.exit(1);
-    }
-
-    fs.writeFileSync(filePath, renderContainer(name));
-    console.log(`✅ Container "${name}" created at ${filePath}`);
-}

package/src/commands/feature.ts

@@ -1,68 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { makeComponent } from './component';
-import { makeHook } from './hook';
-import { makeService } from './service';
-import { makeRepository } from './repository';
-import { makeSchema } from './schema';
-import { makeContainer } from './container';
-
-const FEATURE_DIRS = [
-    'components/server',
-    'components/client',
-    'containers',
-    'hooks',
-    'services',
-    'repositories',
-    'schemas',
-];
-
-function toPascalCase(name: string): string {
-    return name
-        .split('-')
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-        .join('');
-}
-
-function renderPage(name: string): string {
-    const componentName = toPascalCase(name);
-    return `export default function ${componentName}Page() {
-  return (
-    <div>
-      <h1>${componentName}</h1>
-    </div>
-  );
-}
-`;
-}
-
-export async function makeFeature(name: string, all: boolean = false) {
-    const base = path.join(process.cwd(), 'app', name);
-    const pascalName = toPascalCase(name);
-
-    if (fs.existsSync(base)) {
-        console.error(`❌ Feature "${name}" already exists at ${base}`);
-        process.exit(1);
-    }
-
-    for (const dir of FEATURE_DIRS) {
-        fs.mkdirSync(path.join(base, dir), { recursive: true });
-        if (!all) {
-            fs.writeFileSync(path.join(base, dir, '.gitkeep'), '');
-        }
-    }
-
-    fs.writeFileSync(path.join(base, 'page.tsx'), renderPage(name));
-    console.log(`✅ Feature "${name}" scaffolded at ${base}`);
-
-    if (all) {
-        makeComponent(name, pascalName, 'client');
-        makeContainer(name, `${pascalName}Container`);
-        makeHook(name, `use${pascalName}`);
-        makeService(name, pascalName);
-        makeRepository(name, `${pascalName}Repository`);
-        makeSchema(name, `${pascalName}Schema`);
-
-        console.log(`✅ All files scaffolded for "${name}"`);
-    }
-}

package/src/commands/hook.ts

@@ -1,32 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-
-function renderHook(name: string): string {
-    return `import { useState } from 'react';
-
-export function ${name}() {
-  const [data, setData] = useState(null);
-
-  return { data };
-}
-`;
-}
-
-export function makeHook(feature: string, name: string) {
-    const base = path.join(process.cwd(), 'app', feature, 'hooks');
-
-    if (!fs.existsSync(base)) {
-        console.error(`❌ Feature "${feature}" does not exist. Run make:feature ${feature} first.`);
-        process.exit(1);
-    }
-
-    const filePath = path.join(base, `${name}.ts`);
-
-    if (fs.existsSync(filePath)) {
-        console.error(`❌ Hook "${name}" already exists at ${filePath}`);
-        process.exit(1);
-    }
-
-    fs.writeFileSync(filePath, renderHook(name));
-    console.log(`✅ Hook "${name}" created at ${filePath}`);
-}