spoonfeeder 0.1.0

package/templates/base/tests/unit/shared/interceptors/response.interceptor.spec.ts

@@ -0,0 +1,54 @@
+import { ExecutionContext, CallHandler } from '@nestjs/common';
+import { of } from 'rxjs';
+import { ResponseInterceptor } from '@/shared/interceptors/response.interceptor';
+
+const createMockCallHandler = <T>(value: T): CallHandler<T> =>
+  ({ handle: () => of(value) }) as CallHandler<T>;
+
+const mockContext = {} as ExecutionContext;
+
+describe('ResponseInterceptor', () => {
+  let interceptor: ResponseInterceptor<unknown>;
+
+  beforeEach(() => {
+    interceptor = new ResponseInterceptor();
+  });
+
+  describe('intercept', () => {
+    it('should wrap data in a data envelope', (done) => {
+      const handler = createMockCallHandler({ id: 1, name: 'John' });
+
+      interceptor.intercept(mockContext, handler).subscribe((result) => {
+        expect(result).toStrictEqual({ data: { id: 1, name: 'John' } });
+        done();
+      });
+    });
+
+    it('should pass through undefined without wrapping', (done) => {
+      const handler = createMockCallHandler(undefined);
+
+      interceptor.intercept(mockContext, handler).subscribe((result) => {
+        expect(result).toBeUndefined();
+        done();
+      });
+    });
+
+    it('should pass through null without wrapping', (done) => {
+      const handler = createMockCallHandler(null);
+
+      interceptor.intercept(mockContext, handler).subscribe((result) => {
+        expect(result).toBeUndefined();
+        done();
+      });
+    });
+
+    it('should wrap array responses', (done) => {
+      const handler = createMockCallHandler([{ id: 1 }, { id: 2 }]);
+
+      interceptor.intercept(mockContext, handler).subscribe((result) => {
+        expect(result).toStrictEqual({ data: [{ id: 1 }, { id: 2 }] });
+        done();
+      });
+    });
+  });
+});

package/templates/base/tests/unit/shared/pipes/parse-uuid.pipe.spec.ts

@@ -0,0 +1,14 @@
+import { BadRequestException } from '@nestjs/common';
+import { ParseUuidPipe } from '@/shared/pipes/parse-uuid.pipe';
+
+describe('ParseUuidPipe', () => {
+  const pipe = new ParseUuidPipe();
+
+  it('should accept valid UUID', () => {
+    expect(pipe.transform('550e8400-e29b-41d4-a716-446655440000')).toBeDefined();
+  });
+
+  it('should reject invalid string', () => {
+    expect(() => pipe.transform('not-a-uuid')).toThrow(BadRequestException);
+  });
+});

package/templates/base/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "tests", "dist", "**/*spec.ts"]
+}

package/templates/base/tsconfig.json.ejs

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": { "@/*": ["src/*"] },
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "resolvePackageJsonExports": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2023",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "forceConsistentCasingInFileNames": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "noFallthroughCasesInSwitch": false
+  }
+}

package/templates/project-types/aws-lambda/package-fragment.json

@@ -0,0 +1,8 @@
+{
+  "dependencies": {
+    "@fastify/aws-lambda": "5.1.4"
+  },
+  "devDependencies": {
+    "@types/aws-lambda": "8.10.147"
+  }
+}

package/templates/project-types/aws-lambda/src/app.module.ts.ejs

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+  ],
+})
+export class AppModule {}

package/templates/project-types/aws-lambda/src/main.ts.ejs

@@ -0,0 +1,32 @@
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify';
+import type { Context } from 'aws-lambda';
+import awsLambdaFastify from '@fastify/aws-lambda';
+import { AppModule } from './app.module';
+
+let cachedProxy: (event: unknown, context: Context) => Promise<unknown>;
+
+async function bootstrap() {
+  const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
+
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      forbidNonWhitelisted: true,
+      transform: true,
+    }),
+  );
+
+  await app.init();
+
+  const fastifyInstance = app.getHttpAdapter().getInstance();
+  return awsLambdaFastify(fastifyInstance);
+}
+
+export const handler = async (event: unknown, context: Context) => {
+  if (!cachedProxy) {
+    cachedProxy = await bootstrap();
+  }
+  return cachedProxy(event, context);
+};

package/templates/project-types/aws-lambda/tests/unit/handler.spec.ts

@@ -0,0 +1,7 @@
+describe('Lambda Handler', () => {
+  it('should export a handler function', async () => {
+    // The handler is the default export from main.ts
+    // In a real test, you'd invoke it with a mock API Gateway event
+    expect(true).toBe(true); // Placeholder — replace with actual handler test
+  });
+});

package/templates/project-types/cli-app/package-fragment.json

@@ -0,0 +1,8 @@
+{
+  "dependencies": {
+    "nest-commander": "3.17.0"
+  },
+  "devDependencies": {
+    "nest-commander-testing": "3.5.0"
+  }
+}

package/templates/project-types/cli-app/src/app.module.ts.ejs

@@ -0,0 +1,11 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { HelloCommand } from './commands/hello.command';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+  ],
+  providers: [HelloCommand],
+})
+export class AppModule {}

package/templates/project-types/cli-app/src/commands/hello.command.ts.ejs

@@ -0,0 +1,8 @@
+import { Command, CommandRunner } from 'nest-commander';
+
+@Command({ name: 'hello', description: 'Say hello' })
+export class HelloCommand extends CommandRunner {
+  async run(): Promise<void> {
+    process.stdout.write('Hello from <%= name %>!\n');
+  }
+}

package/templates/project-types/cli-app/src/main.ts.ejs

@@ -0,0 +1,8 @@
+import { CommandFactory } from 'nest-commander';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  await CommandFactory.run(AppModule, ['warn', 'error']);
+}
+
+void bootstrap();

package/templates/project-types/cli-app/tests/unit/commands/hello.command.spec.ts

@@ -0,0 +1,17 @@
+import { TestingModule, Test } from '@nestjs/testing';
+import { CommandTestFactory } from 'nest-commander-testing';
+import { AppModule } from '@/app.module';
+
+describe('HelloCommand', () => {
+  let commandInstance: TestingModule;
+
+  beforeEach(async () => {
+    commandInstance = await CommandTestFactory.createTestingCommand({
+      imports: [AppModule],
+    }).compile();
+  });
+
+  it('should be defined', () => {
+    expect(commandInstance).toBeDefined();
+  });
+});

package/templates/project-types/full-stack/apps/api/src/app.module.ts.ejs

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+  ],
+})
+export class AppModule {}

package/templates/project-types/full-stack/apps/api/src/main.ts.ejs

@@ -0,0 +1,32 @@
+import { NestFactory } from '@nestjs/core';
+import { Logger, ValidationPipe } from '@nestjs/common';
+import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify';
+import fastifyEtag from '@fastify/etag';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create<NestFastifyApplication>(AppModule, new FastifyAdapter());
+
+  await app.register(fastifyEtag);
+
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      forbidNonWhitelisted: true,
+      transform: true,
+      transformOptions: { enableImplicitConversion: true },
+    }),
+  );
+
+  app.enableCors({ origin: process.env.CORS_ORIGIN?.split(',') ?? false });
+
+  app.enableShutdownHooks();
+
+  const port = process.env.PORT ?? 3000;
+  await app.listen(port, '0.0.0.0');
+
+  const url = await app.getUrl();
+  new Logger('Bootstrap').log(`Application is running on ${url}`);
+}
+
+void bootstrap();

package/templates/project-types/full-stack/frontend/nextjs/.cursor/rules/nextjs.mdc

@@ -0,0 +1,12 @@
+# Next.js Rules
+
+- Use App Router (app/) not Pages Router (pages/)
+- Server Components by default — add 'use client' only when needed (state, effects, browser APIs)
+- Use Server Actions for form submissions and mutations
+- Fetch data in Server Components with async/await, not useEffect
+- Use next/image for images, next/link for navigation, next/font for fonts
+- Route handlers go in app/api/route.ts files
+- Loading states via loading.tsx, error boundaries via error.tsx
+- Use generateMetadata for SEO
+- Environment variables: NEXT_PUBLIC_ prefix for client-side, no prefix for server-only
+- CSS: Tailwind CSS or CSS Modules, no global styles in components

package/templates/project-types/full-stack/frontend/nextjs/.github/copilot-instructions.md

@@ -0,0 +1,23 @@
+# Next.js Copilot Instructions
+
+## Framework
+
+Next.js with App Router and TypeScript.
+
+## Rules
+
+- Use App Router (app/) not Pages Router (pages/).
+- Server Components by default — add 'use client' only when needed (state, effects, browser APIs).
+- Use Server Actions for form submissions and mutations.
+- Fetch data in Server Components with async/await, not useEffect.
+- Use next/image for images, next/link for navigation, next/font for fonts.
+- Route handlers go in app/api/route.ts files.
+- Loading states via loading.tsx, error boundaries via error.tsx.
+- Use generateMetadata for SEO.
+- Environment variables: NEXT*PUBLIC* prefix for client-side, no prefix for server-only.
+- CSS: Tailwind CSS or CSS Modules, no global styles in components.
+
+## API Integration
+
+The API backend runs on port 3000. Proxy configured in next.config.ts.
+Use relative URLs for API calls: `fetch('/api/users')`.

package/templates/project-types/full-stack/frontend/nextjs/CLAUDE.md

@@ -0,0 +1,25 @@
+# CLAUDE.md
+
+## Framework
+
+Next.js with App Router and TypeScript.
+
+## Key Patterns
+
+- Server Components by default, 'use client' only when needed
+- Server Actions for mutations (form submissions, data changes)
+- Fetch data in Server Components, not useEffect
+- Use next/image, next/link, next/font
+
+## API Integration
+
+The API backend runs on port 3000. Proxy configured in next.config.ts.
+Use relative URLs for API calls: `fetch('/api/users')`.
+
+## Commands
+
+| Command      | Description             |
+| ------------ | ----------------------- |
+| `pnpm dev`   | Start dev server        |
+| `pnpm build` | Production build        |
+| `pnpm start` | Start production server |

package/templates/project-types/full-stack/frontend/nextjs/next.config.ts

@@ -0,0 +1,9 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  async rewrites() {
+    return [{ source: '/api/:path*', destination: 'http://localhost:3000/api/:path*' }];
+  },
+};
+
+export default nextConfig;

package/templates/project-types/full-stack/frontend/nextjs/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "web",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "15.3.3",
+    "react": "19.1.0",
+    "react-dom": "19.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "19.1.8",
+    "@types/react-dom": "19.1.6",
+    "typescript": "5.9.3"
+  }
+}

package/templates/project-types/full-stack/frontend/nextjs/src/app/layout.tsx

@@ -0,0 +1,9 @@
+export const metadata = { title: 'App', description: 'Generated with spoonfeeder' };
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/project-types/full-stack/frontend/nextjs/src/app/page.tsx

@@ -0,0 +1,8 @@
+export default function Home() {
+  return (
+    <main>
+      <h1>Welcome</h1>
+      <p>Edit src/app/page.tsx to get started.</p>
+    </main>
+  );
+}

package/templates/project-types/full-stack/frontend/nextjs/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}

package/templates/project-types/full-stack/frontend/nuxt/.cursor/rules/nuxt.mdc

@@ -0,0 +1,14 @@
+# Nuxt 3 Rules
+
+- Use Composition API with <script setup>, not Options API
+- Auto-imports enabled — no need to import ref, computed, onMounted, etc.
+- File-based routing in pages/ directory
+- Server routes in server/api/ for BFF patterns
+- Use useFetch/useAsyncData for data fetching (SSR-aware)
+- Pinia for state management
+- Components auto-imported from components/ directory
+- Layouts in layouts/ directory
+- Middleware in middleware/ for route guards
+- Runtime config via useRuntimeConfig() for env vars
+- Use NuxtLink for navigation, not <a> tags
+- Composables in composables/ directory for shared logic

package/templates/project-types/full-stack/frontend/nuxt/.github/copilot-instructions.md

@@ -0,0 +1,25 @@
+# Nuxt 3 Copilot Instructions
+
+## Framework
+
+Nuxt 3 with Vue 3 Composition API and TypeScript.
+
+## Rules
+
+- Use Composition API with `<script setup>`, not Options API.
+- Auto-imports enabled — no need to import ref, computed, onMounted, etc.
+- File-based routing in pages/ directory.
+- Server routes in server/api/ for BFF patterns.
+- Use useFetch/useAsyncData for data fetching (SSR-aware).
+- Pinia for state management.
+- Components auto-imported from components/ directory.
+- Layouts in layouts/ directory.
+- Middleware in middleware/ for route guards.
+- Runtime config via useRuntimeConfig() for env vars.
+- Use NuxtLink for navigation, not `<a>` tags.
+- Composables in composables/ directory for shared logic.
+
+## API Integration
+
+Proxy configured in nuxt.config.ts via nitro.devProxy.
+Use relative URLs: `useFetch('/api/users')`.

package/templates/project-types/full-stack/frontend/nuxt/CLAUDE.md

@@ -0,0 +1,25 @@
+# CLAUDE.md
+
+## Framework
+
+Nuxt 3 with Vue 3 Composition API and TypeScript.
+
+## Key Patterns
+
+- <script setup> with Composition API
+- Auto-imports (ref, computed, useFetch, etc.)
+- File-based routing in pages/
+- useFetch for SSR-aware data fetching
+
+## API Integration
+
+Proxy configured in nuxt.config.ts via nitro.devProxy.
+Use relative URLs: `useFetch('/api/users')`.
+
+## Commands
+
+| Command        | Description              |
+| -------------- | ------------------------ |
+| `pnpm dev`     | Start dev server         |
+| `pnpm build`   | Production build         |
+| `pnpm preview` | Preview production build |

package/templates/project-types/full-stack/frontend/nuxt/app.vue

@@ -0,0 +1,5 @@
+<template>
+  <div>
+    <NuxtPage />
+  </div>
+</template>

package/templates/project-types/full-stack/frontend/nuxt/nuxt.config.ts

@@ -0,0 +1,6 @@
+export default defineNuxtConfig({
+  devtools: { enabled: true },
+  nitro: {
+    devProxy: { '/api': 'http://localhost:3000' },
+  },
+});

package/templates/project-types/full-stack/frontend/nuxt/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "web",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "nuxt dev",
+    "build": "nuxt build",
+    "preview": "nuxt preview"
+  },
+  "dependencies": {
+    "nuxt": "3.17.5",
+    "vue": "3.5.17"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3"
+  }
+}

package/templates/project-types/full-stack/frontend/nuxt/pages/index.vue

@@ -0,0 +1,3 @@
+<template>
+  <main><h1>Welcome</h1><p>Edit pages/index.vue to get started.</p></main>
+</template>

package/templates/project-types/full-stack/frontend/nuxt/tsconfig.json

@@ -0,0 +1 @@
+{ "extends": "./.nuxt/tsconfig.json" }

package/templates/project-types/full-stack/frontend/sveltekit/.cursor/rules/sveltekit.mdc

@@ -0,0 +1,13 @@
+# SvelteKit Rules
+
+- Use Svelte 5 runes ($state, $derived, $effect) not legacy reactive declarations
+- File-based routing in src/routes/
+- +page.svelte for pages, +layout.svelte for layouts
+- +page.server.ts for server-side load functions and form actions
+- +page.ts for universal load functions
+- Use form actions for mutations, not API routes
+- Stores for shared state ($app/stores)
+- Error handling via +error.svelte
+- Loading states via +page.ts load function
+- Environment variables: $env/static/private and $env/static/public
+- Use enhance for progressive enhancement of forms

package/templates/project-types/full-stack/frontend/sveltekit/.github/copilot-instructions.md

@@ -0,0 +1,24 @@
+# SvelteKit Copilot Instructions
+
+## Framework
+
+SvelteKit with Svelte 5 and TypeScript.
+
+## Rules
+
+- Use Svelte 5 runes ($state, $derived, $effect) not legacy reactive declarations.
+- File-based routing in src/routes/.
+- +page.svelte for pages, +layout.svelte for layouts.
+- +page.server.ts for server-side load functions and form actions.
+- +page.ts for universal load functions.
+- Use form actions for mutations, not API routes.
+- Stores for shared state ($app/stores).
+- Error handling via +error.svelte.
+- Loading states via +page.ts load function.
+- Environment variables: $env/static/private and $env/static/public.
+- Use enhance for progressive enhancement of forms.
+
+## API Integration
+
+Proxy configured in vite.config.ts.
+Use relative URLs in load functions: `fetch('/api/users')`.

package/templates/project-types/full-stack/frontend/sveltekit/CLAUDE.md

@@ -0,0 +1,25 @@
+# CLAUDE.md
+
+## Framework
+
+SvelteKit with Svelte 5 and TypeScript.
+
+## Key Patterns
+
+- Svelte 5 runes ($state, $derived, $effect)
+- File-based routing in src/routes/
+- +page.server.ts for server load and form actions
+- Progressive enhancement with enhance
+
+## API Integration
+
+Proxy configured in vite.config.ts.
+Use relative URLs in load functions: `fetch('/api/users')`.
+
+## Commands
+
+| Command        | Description              |
+| -------------- | ------------------------ |
+| `pnpm dev`     | Start dev server         |
+| `pnpm build`   | Production build         |
+| `pnpm preview` | Preview production build |

package/templates/project-types/full-stack/frontend/sveltekit/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "web",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "@sveltejs/adapter-auto": "6.0.1",
+    "@sveltejs/kit": "2.21.1",
+    "svelte": "5.35.5",
+    "typescript": "5.9.3",
+    "vite": "6.3.5"
+  }
+}

package/templates/project-types/full-stack/frontend/sveltekit/src/app.html

@@ -0,0 +1,5 @@
+<!doctype html>
+<html lang="en">
+  <head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />%sveltekit.head%</head>
+  <body>%sveltekit.body%</body>
+</html>

package/templates/project-types/full-stack/frontend/sveltekit/src/routes/+page.svelte

@@ -0,0 +1 @@
+<main><h1>Welcome</h1><p>Edit src/routes/+page.svelte to get started.</p></main>

package/templates/project-types/full-stack/frontend/sveltekit/svelte.config.js

@@ -0,0 +1,5 @@
+import adapter from '@sveltejs/adapter-auto';
+
+export default {
+  kit: { adapter: adapter() },
+};

package/templates/project-types/full-stack/frontend/sveltekit/vite.config.ts

@@ -0,0 +1,9 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [sveltekit()],
+  server: {
+    proxy: { '/api': 'http://localhost:3000' },
+  },
+});

package/templates/project-types/full-stack/frontend/vite-react/.cursor/rules/react.mdc

@@ -0,0 +1,12 @@
+# React (Vite) Rules
+
+- Functional components only, no class components
+- Use TypeScript strict mode
+- Custom hooks for reusable logic — prefix with use (useAuth, useFetch)
+- State management: React Context for simple, Zustand/Jotai for complex
+- Side effects in useEffect with proper cleanup
+- Memoize expensive computations with useMemo, callbacks with useCallback
+- Avoid prop drilling — use Context or composition
+- Error boundaries for component-level error handling
+- Lazy load routes with React.lazy + Suspense
+- Forms: react-hook-form for complex, controlled components for simple