ai-factory 2.0.0 → 2.2.0

package/dist/cli/wizard/detector.js

@@ -1,231 +0,0 @@
-import path from 'path';
-import { readJsonFile, readTextFile, fileExists } from '../../utils/fs.js';
-export async function detectStack(projectDir) {
-    const packageJsonPath = path.join(projectDir, 'package.json');
-    const composerJsonPath = path.join(projectDir, 'composer.json');
-    const requirementsPath = path.join(projectDir, 'requirements.txt');
-    const pyprojectPath = path.join(projectDir, 'pyproject.toml');
-    const goModPath = path.join(projectDir, 'go.mod');
-    const cargoTomlPath = path.join(projectDir, 'Cargo.toml');
-    if (await fileExists(packageJsonPath)) {
-        const packageJson = await readJsonFile(packageJsonPath);
-        if (packageJson) {
-            return detectJavaScriptStack(packageJson, projectDir);
-        }
-    }
-    if (await fileExists(composerJsonPath)) {
-        const composerJson = await readJsonFile(composerJsonPath);
-        if (composerJson) {
-            return detectPhpStack(composerJson);
-        }
-    }
-    if (await fileExists(requirementsPath) || await fileExists(pyprojectPath)) {
-        return detectPythonStack(projectDir);
-    }
-    if (await fileExists(goModPath)) {
-        return {
-            name: 'go',
-            confidence: 'high',
-            frameworks: [],
-            languages: ['go'],
-        };
-    }
-    if (await fileExists(cargoTomlPath)) {
-        return {
-            name: 'rust',
-            confidence: 'high',
-            frameworks: [],
-            languages: ['rust'],
-        };
-    }
-    return null;
-}
-async function detectJavaScriptStack(packageJson, projectDir) {
-    const allDeps = {
-        ...packageJson.dependencies,
-        ...packageJson.devDependencies,
-    };
-    const frameworks = [];
-    const languages = ['javascript'];
-    if (allDeps['typescript']) {
-        languages.push('typescript');
-    }
-    if (allDeps['next']) {
-        frameworks.push('next.js');
-        const hasAppDir = await fileExists(path.join(projectDir, 'app'));
-        const hasPagesDir = await fileExists(path.join(projectDir, 'pages'));
-        return {
-            name: 'nextjs',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    if (allDeps['react']) {
-        frameworks.push('react');
-        if (allDeps['vite']) {
-            frameworks.push('vite');
-        }
-        return {
-            name: 'react',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    if (allDeps['vue']) {
-        frameworks.push('vue');
-        return {
-            name: 'vue',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    if (allDeps['express'] || allDeps['fastify'] || allDeps['koa'] || allDeps['hono']) {
-        if (allDeps['express'])
-            frameworks.push('express');
-        if (allDeps['fastify'])
-            frameworks.push('fastify');
-        if (allDeps['koa'])
-            frameworks.push('koa');
-        if (allDeps['hono'])
-            frameworks.push('hono');
-        return {
-            name: 'node-api',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    return {
-        name: 'node',
-        confidence: 'medium',
-        frameworks,
-        languages,
-    };
-}
-function detectPhpStack(composerJson) {
-    const allDeps = {
-        ...composerJson.require,
-        ...composerJson['require-dev'],
-    };
-    const frameworks = [];
-    const languages = ['php'];
-    if (allDeps['laravel/framework']) {
-        frameworks.push('laravel');
-        return {
-            name: 'laravel',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    if (allDeps['symfony/framework-bundle'] || allDeps['symfony/symfony']) {
-        frameworks.push('symfony');
-        return {
-            name: 'symfony',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    if (allDeps['slim/slim']) {
-        frameworks.push('slim');
-        return {
-            name: 'slim',
-            confidence: 'high',
-            frameworks,
-            languages,
-        };
-    }
-    return {
-        name: 'php',
-        confidence: 'medium',
-        frameworks,
-        languages,
-    };
-}
-async function detectPythonStack(projectDir) {
-    const frameworks = [];
-    const languages = ['python'];
-    const requirementsPath = path.join(projectDir, 'requirements.txt');
-    const requirements = await readTextFile(requirementsPath);
-    if (requirements) {
-        const lowerReqs = requirements.toLowerCase();
-        if (lowerReqs.includes('django')) {
-            frameworks.push('django');
-            return {
-                name: 'django',
-                confidence: 'high',
-                frameworks,
-                languages,
-            };
-        }
-        if (lowerReqs.includes('fastapi')) {
-            frameworks.push('fastapi');
-            return {
-                name: 'fastapi',
-                confidence: 'high',
-                frameworks,
-                languages,
-            };
-        }
-        if (lowerReqs.includes('flask')) {
-            frameworks.push('flask');
-            return {
-                name: 'flask',
-                confidence: 'high',
-                frameworks,
-                languages,
-            };
-        }
-    }
-    return {
-        name: 'python',
-        confidence: 'medium',
-        frameworks,
-        languages,
-    };
-}
-export function getRecommendedSkills(stack) {
-    const baseSkills = [
-        'aif',
-        'aif-skill-generator',
-        'aif-plan',
-        'aif-implement',
-        'aif-commit',
-        'aif-review',
-        'aif-best-practices',
-        'aif-architecture',
-        'aif-security-checklist',
-    ];
-    if (!stack) {
-        return baseSkills;
-    }
-    const skills = [...baseSkills];
-    if (['nextjs', 'react', 'vue', 'node-api', 'fastapi', 'django', 'flask', 'laravel', 'symfony'].includes(stack.name)) {
-        skills.push('aif-deploy');
-    }
-    return skills;
-}
-export function getRecommendedTemplate(stack) {
-    if (!stack)
-        return null;
-    const templateMap = {
-        'nextjs': 'nextjs',
-        'react': 'react',
-        'node-api': 'node-api',
-        'node': 'node-api',
-        'python': 'python',
-        'django': 'python',
-        'fastapi': 'python',
-        'flask': 'python',
-        'php': 'php',
-        'laravel': 'php',
-        'symfony': 'php',
-        'slim': 'php',
-    };
-    return templateMap[stack.name] || null;
-}
-//# sourceMappingURL=detector.js.map

package/dist/cli/wizard/detector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/cli/wizard/detector.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAmB3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE1D,IAAI,MAAM,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,YAAY,CAAc,eAAe,CAAC,CAAC;QACrE,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,qBAAqB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAe,gBAAgB,CAAC,CAAC;QACxE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,gBAAgB,CAAC,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC1E,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,IAAI,CAAC;SAClB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,CAAC,MAAM,CAAC;SACpB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,WAAwB,EAAE,UAAkB;IAC/E,MAAM,OAAO,GAAG;QACd,GAAG,WAAW,CAAC,YAAY;QAC3B,GAAG,WAAW,CAAC,eAAe;KAC/B,CAAC;IAEF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAa,CAAC,YAAY,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAErE,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzB,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClF,IAAI,OAAO,CAAC,SAAS,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,SAAS,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,MAAM,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7C,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,UAAU,EAAE,QAAQ;QACpB,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,YAA0B;IAChD,MAAM,OAAO,GAAG;QACd,GAAG,YAAY,CAAC,OAAO;QACvB,GAAG,YAAY,CAAC,aAAa,CAAC;KAC/B,CAAC;IAEF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAa,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACjC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,0BAA0B,CAAC,IAAI,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,MAAM;YAClB,UAAU;YACV,SAAS;SACV,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,QAAQ;QACpB,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACjD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAa,CAAC,QAAQ,CAAC,CAAC;IAEvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAE1D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAE7C,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,MAAM;gBAClB,UAAU;gBACV,SAAS;aACV,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,UAAU,EAAE,MAAM;gBAClB,UAAU;gBACV,SAAS;aACV,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,MAAM;gBAClB,UAAU;gBACV,SAAS;aACV,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,QAAQ;QACpB,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,MAAM,UAAU,GAAG;QACjB,KAAK;QACL,qBAAqB;QACrB,UAAU;QACV,eAAe;QACf,YAAY;QACZ,YAAY;QACZ,oBAAoB;QACpB,kBAAkB;QAClB,wBAAwB;KACzB,CAAC;IAEF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAE/B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpH,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAChE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,WAAW,GAA2B;QAC1C,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACzC,CAAC"}

package/skills/_templates/nextjs/nextjs-patterns/SKILL.md

@@ -1,146 +0,0 @@
----
-name: nextjs-patterns
-description: Next.js development patterns and best practices. Helps with App Router, Server Components, API routes, and data fetching.
-argument-hint: "[topic: routing|data|api|auth|forms]"
----
-
-# Next.js Patterns Guide
-
-Expert guidance on Next.js patterns using the App Router and React Server Components.
-
-## Topics
-
-### Routing (`/nextjs-patterns routing`)
-
-**App Router Structure:**
-```
-app/
-├── layout.tsx          # Root layout
-├── page.tsx            # Home page
-├── loading.tsx         # Loading UI
-├── error.tsx           # Error boundary
-├── not-found.tsx       # 404 page
-├── dashboard/
-│   ├── layout.tsx      # Nested layout
-│   ├── page.tsx        # /dashboard
-│   └── [id]/
-│       └── page.tsx    # /dashboard/[id]
-└── api/
-    └── route.ts        # API route
-```
-
-**Key Patterns:**
-- Use `layout.tsx` for shared UI and data fetching
-- Use `loading.tsx` with Suspense for streaming
-- Dynamic routes with `[param]` folders
-- Route groups with `(group)` folders
-- Parallel routes with `@slot` folders
-
-### Data Fetching (`/nextjs-patterns data`)
-
-**Server Components (default):**
-```typescript
-// Fetch directly in component - no useEffect needed
-async function Page() {
-  const data = await fetch('https://api.example.com/data');
-  return <div>{data}</div>;
-}
-```
-
-**Caching:**
-```typescript
-// Cache options
-fetch(url, { cache: 'force-cache' });  // Default - cached
-fetch(url, { cache: 'no-store' });     // Never cache
-fetch(url, { next: { revalidate: 60 } }); // Revalidate every 60s
-```
-
-**Server Actions:**
-```typescript
-'use server';
-
-export async function createItem(formData: FormData) {
-  const name = formData.get('name');
-  await db.items.create({ name });
-  revalidatePath('/items');
-}
-```
-
-### API Routes (`/nextjs-patterns api`)
-
-**Route Handlers:**
-```typescript
-// app/api/users/route.ts
-import { NextRequest, NextResponse } from 'next/server';
-
-export async function GET(request: NextRequest) {
-  const users = await db.users.findMany();
-  return NextResponse.json(users);
-}
-
-export async function POST(request: NextRequest) {
-  const body = await request.json();
-  const user = await db.users.create(body);
-  return NextResponse.json(user, { status: 201 });
-}
-```
-
-### Authentication (`/nextjs-patterns auth`)
-
-**Middleware Protection:**
-```typescript
-// middleware.ts
-import { NextResponse } from 'next/server';
-import type { NextRequest } from 'next/server';
-
-export function middleware(request: NextRequest) {
-  const token = request.cookies.get('token');
-  if (!token && request.nextUrl.pathname.startsWith('/dashboard')) {
-    return NextResponse.redirect(new URL('/login', request.url));
-  }
-  return NextResponse.next();
-}
-
-export const config = {
-  matcher: '/dashboard/:path*',
-};
-```
-
-### Forms (`/nextjs-patterns forms`)
-
-**Server Action Forms:**
-```typescript
-// Using server actions
-export default function Form() {
-  async function handleSubmit(formData: FormData) {
-    'use server';
-    await saveData(formData);
-    redirect('/success');
-  }
-
-  return (
-    <form action={handleSubmit}>
-      <input name="email" type="email" required />
-      <button type="submit">Submit</button>
-    </form>
-  );
-}
-```
-
-## Best Practices
-
-1. **Default to Server Components** - Only use `'use client'` when needed
-2. **Colocate data fetching** - Fetch data where it's used
-3. **Use streaming** - Add `loading.tsx` for better UX
-4. **Validate on server** - Never trust client input
-5. **Use TypeScript** - Full type safety with Next.js
-6. **Image optimization** - Always use `next/image`
-7. **Font optimization** - Use `next/font`
-
-## Common Mistakes
-
-- Adding `'use client'` unnecessarily
-- Fetching data in client components when server would work
-- Not using proper error boundaries
-- Missing loading states
-- Over-fetching with multiple small requests

package/skills/_templates/node-api/api-patterns/SKILL.md

@@ -1,245 +0,0 @@
----
-name: api-patterns
-description: Node.js API development patterns. Covers REST design, validation, error handling, authentication, and database access.
-argument-hint: "[topic: rest|validation|errors|auth|database]"
----
-
-# Node.js API Patterns Guide
-
-Best practices for building robust Node.js APIs.
-
-## Topics
-
-### REST Design (`/api-patterns rest`)
-
-**Resource Naming:**
-```
-GET    /users           # List users
-GET    /users/:id       # Get single user
-POST   /users           # Create user
-PUT    /users/:id       # Replace user
-PATCH  /users/:id       # Update user partially
-DELETE /users/:id       # Delete user
-
-# Nested resources
-GET    /users/:id/posts # User's posts
-POST   /users/:id/posts # Create post for user
-
-# Filtering, sorting, pagination
-GET    /users?role=admin&sort=-createdAt&page=2&limit=20
-```
-
-**Response Format:**
-```typescript
-// Success response
-{
-  "data": { ... },
-  "meta": {
-    "page": 1,
-    "limit": 20,
-    "total": 100
-  }
-}
-
-// Error response
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Invalid input",
-    "details": [
-      { "field": "email", "message": "Invalid email format" }
-    ]
-  }
-}
-```
-
-### Validation (`/api-patterns validation`)
-
-**Zod Schema Validation:**
-```typescript
-import { z } from 'zod';
-
-const createUserSchema = z.object({
-  email: z.string().email(),
-  password: z.string().min(8),
-  name: z.string().min(1).max(100),
-  role: z.enum(['user', 'admin']).default('user'),
-});
-
-// Middleware
-function validate(schema: z.ZodSchema) {
-  return (req, res, next) => {
-    const result = schema.safeParse(req.body);
-    if (!result.success) {
-      return res.status(400).json({
-        error: {
-          code: 'VALIDATION_ERROR',
-          details: result.error.flatten(),
-        },
-      });
-    }
-    req.body = result.data;
-    next();
-  };
-}
-
-// Usage
-app.post('/users', validate(createUserSchema), createUser);
-```
-
-### Error Handling (`/api-patterns errors`)
-
-**Custom Error Classes:**
-```typescript
-class AppError extends Error {
-  constructor(
-    public statusCode: number,
-    public code: string,
-    message: string,
-    public details?: unknown
-  ) {
-    super(message);
-  }
-}
-
-class NotFoundError extends AppError {
-  constructor(resource: string) {
-    super(404, 'NOT_FOUND', `${resource} not found`);
-  }
-}
-
-class ValidationError extends AppError {
-  constructor(details: unknown) {
-    super(400, 'VALIDATION_ERROR', 'Invalid input', details);
-  }
-}
-```
-
-**Global Error Handler:**
-```typescript
-function errorHandler(err: Error, req: Request, res: Response, next: NextFunction) {
-  console.error(err);
-
-  if (err instanceof AppError) {
-    return res.status(err.statusCode).json({
-      error: {
-        code: err.code,
-        message: err.message,
-        details: err.details,
-      },
-    });
-  }
-
-  // Unexpected error
-  res.status(500).json({
-    error: {
-      code: 'INTERNAL_ERROR',
-      message: 'Something went wrong',
-    },
-  });
-}
-
-app.use(errorHandler);
-```
-
-### Authentication (`/api-patterns auth`)
-
-**JWT Authentication:**
-```typescript
-import jwt from 'jsonwebtoken';
-
-// Generate token
-function generateToken(user: User) {
-  return jwt.sign(
-    { id: user.id, role: user.role },
-    process.env.JWT_SECRET!,
-    { expiresIn: '7d' }
-  );
-}
-
-// Auth middleware
-function authenticate(req: Request, res: Response, next: NextFunction) {
-  const token = req.headers.authorization?.replace('Bearer ', '');
-
-  if (!token) {
-    throw new AppError(401, 'UNAUTHORIZED', 'No token provided');
-  }
-
-  try {
-    const payload = jwt.verify(token, process.env.JWT_SECRET!);
-    req.user = payload;
-    next();
-  } catch {
-    throw new AppError(401, 'UNAUTHORIZED', 'Invalid token');
-  }
-}
-
-// Role-based access
-function authorize(...roles: string[]) {
-  return (req: Request, res: Response, next: NextFunction) => {
-    if (!roles.includes(req.user.role)) {
-      throw new AppError(403, 'FORBIDDEN', 'Insufficient permissions');
-    }
-    next();
-  };
-}
-```
-
-### Database (`/api-patterns database`)
-
-**Repository Pattern:**
-```typescript
-// Abstract database operations
-class UserRepository {
-  async findById(id: string): Promise<User | null> {
-    return db.user.findUnique({ where: { id } });
-  }
-
-  async findByEmail(email: string): Promise<User | null> {
-    return db.user.findUnique({ where: { email } });
-  }
-
-  async create(data: CreateUserInput): Promise<User> {
-    return db.user.create({ data });
-  }
-
-  async update(id: string, data: UpdateUserInput): Promise<User> {
-    return db.user.update({ where: { id }, data });
-  }
-
-  async delete(id: string): Promise<void> {
-    await db.user.delete({ where: { id } });
-  }
-}
-```
-
-**Transaction Pattern:**
-```typescript
-async function transferFunds(fromId: string, toId: string, amount: number) {
-  return db.$transaction(async (tx) => {
-    const from = await tx.account.update({
-      where: { id: fromId },
-      data: { balance: { decrement: amount } },
-    });
-
-    if (from.balance < 0) {
-      throw new AppError(400, 'INSUFFICIENT_FUNDS', 'Not enough balance');
-    }
-
-    await tx.account.update({
-      where: { id: toId },
-      data: { balance: { increment: amount } },
-    });
-  });
-}
-```
-
-## Best Practices
-
-1. **Validate all input** - Never trust client data
-2. **Use async/await** - Avoid callback hell
-3. **Handle errors centrally** - Single error handler
-4. **Log appropriately** - Structured logging
-5. **Rate limit** - Protect against abuse
-6. **Use CORS properly** - Restrict origins
-7. **Keep secrets safe** - Use environment variables