@launch77-shared/plugin-graphql-api 0.0.1

package/README.md

@@ -0,0 +1,49 @@
+# GraphqlApi Plugin
+
+Launch77 plugin for graphql-api
+
+## Installation
+
+```bash
+launch77 plugin:install graphql-api
+```
+
+## Usage
+
+After installation, the plugin will:
+
+- TODO: Describe what the plugin does
+- TODO: List any files created or modified
+- TODO: Explain configuration options
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Testing
+
+```bash
+npm run typecheck
+```
+
+## Template Files
+
+The `templates/` directory contains files that will be copied to the target application when this plugin is installed. Add any template files your plugin needs here.
+
+## Showcase Page (Optional)
+
+To create an examples/documentation page for your plugin:
+
+1. Add `"showcaseUrl": "/plugins/"` to `plugin.json`
+2. Create a page at `templates/src/app/plugins//page.tsx`
+3. The page will appear on the `/plugins` discovery page when installed
+
+See the [Plugin Development Guide](https://github.com/launch77/docs/plugin-development.md) for details.
+
+## License
+
+UNLICENSED

package/dist/generator.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+// src/generator.ts
+import chalk from "chalk";
+import { StandardGenerator } from "@launch77/plugin-runtime";
+var GraphqlApiGenerator = class extends StandardGenerator {
+  constructor(context) {
+    super(context);
+  }
+  async injectCode() {
+    console.log(chalk.cyan("\u{1F527} Setting up graphql-api plugin...\n"));
+    console.log(chalk.green("   \u2713 Plugin setup complete\n"));
+  }
+  showNextSteps() {
+    console.log(chalk.white("\n" + "\u2500".repeat(60) + "\n"));
+    console.log(chalk.cyan("\u{1F4CB} GraphqlApi Plugin Installed!\n"));
+    console.log(chalk.white("Next Steps:\n"));
+    console.log(chalk.gray("1. TODO: Add your first step"));
+    console.log(chalk.cyan("   npm run <command>\n"));
+    console.log(chalk.gray("2. TODO: Add your second step"));
+    console.log(chalk.cyan("   npm run <command>\n"));
+    console.log(chalk.white("Documentation:\n"));
+    console.log(chalk.gray("See README.md for detailed instructions.\n"));
+  }
+};
+async function main() {
+  const args = process.argv.slice(2);
+  const appPath = args.find((arg) => arg.startsWith("--appPath="))?.split("=")[1];
+  const appName = args.find((arg) => arg.startsWith("--appName="))?.split("=")[1];
+  const workspaceName = args.find((arg) => arg.startsWith("--workspaceName="))?.split("=")[1];
+  const pluginPath = args.find((arg) => arg.startsWith("--pluginPath="))?.split("=")[1];
+  if (!appPath || !appName || !workspaceName || !pluginPath) {
+    console.error(chalk.red("Error: Missing required arguments"));
+    console.error(chalk.gray("Usage: --appPath=<path> --appName=<name> --workspaceName=<name> --pluginPath=<path>"));
+    process.exit(1);
+  }
+  const generator = new GraphqlApiGenerator({ appPath, appName, workspaceName, pluginPath });
+  await generator.run();
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch((error) => {
+    console.error(chalk.red("\n\u274C Error during plugin setup:"));
+    console.error(error);
+    process.exit(1);
+  });
+}
+export {
+  GraphqlApiGenerator
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@launch77-shared/plugin-graphql-api",
+  "version": "0.0.1",
+  "description": "Launch77 plugin for graphql-api",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "dist/generator.js",
+  "bin": {
+    "generate": "./dist/generator.js"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "plugin.json"
+  ],
+  "scripts": {
+    "prebuild": "node scripts/validate-plugin-json.js",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "release:connect": "launch77-release-connect",
+    "release:verify": "launch77-release-verify"
+  },
+  "dependencies": {
+    "@launch77/plugin-runtime": "^0.3.2",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "launch77": {
+    "installedPlugins": {
+      "release": {
+        "package": "release",
+        "version": "1.1.1",
+        "installedAt": "2026-02-06T07:36:14.984Z",
+        "source": "local"
+      }
+    }
+  }
+}

package/plugin.json

@@ -0,0 +1,14 @@
+{
+  "targets": ["app"],
+  "showcaseUrl": "/plugins/graphql-api",
+  "pluginDependencies": {},
+  "libraryDependencies": {
+    "@apollo/server": "^4.11.0",
+    "graphql": "^16.9.0",
+    "@as-integrations/next": "^3.2.0",
+    "type-graphql": "^2.0.0-rc.2",
+    "class-validator": "^0.14.1",
+    "class-transformer": "^0.5.1",
+    "reflect-metadata": "^0.2.2"
+  }
+}

package/templates/src/app/api/graphql/route.ts

@@ -0,0 +1,17 @@
+import { startServerAndCreateNextHandler } from '@as-integrations/next'
+import { NextRequest } from 'next/server'
+import { getServerSingleton } from '@/modules/graphql/services/server-svc'
+
+export const runtime = 'nodejs'
+
+const handlerPromise = getServerSingleton().then((server) => startServerAndCreateNextHandler<NextRequest>(server))
+
+export async function GET(req: NextRequest) {
+  const handler = await handlerPromise
+  return handler(req)
+}
+
+export async function POST(req: NextRequest) {
+  const handler = await handlerPromise
+  return handler(req)
+}

package/templates/src/app/plugins/graphql-api/page.tsx

@@ -0,0 +1,296 @@
+'use client'
+
+import React from 'react'
+import { ExternalLink, Copy, Check } from 'lucide-react'
+import { useState } from 'react'
+
+// Simple CodeBlock component
+function CodeBlock({ code, language }: { code: string; language: string }) {
+  const [copied, setCopied] = useState(false)
+
+  const handleCopy = () => {
+    navigator.clipboard.writeText(code)
+    setCopied(true)
+    setTimeout(() => setCopied(false), 2000)
+  }
+
+  return (
+    <div className="relative group">
+      <pre className="bg-gray-100 dark:bg-gray-800 rounded-lg p-4 overflow-x-auto text-sm">
+        <code className={`language-${language}`}>{code}</code>
+      </pre>
+      <button onClick={handleCopy} className="absolute top-2 right-2 p-2 bg-white dark:bg-gray-700 rounded-md shadow-sm opacity-0 group-hover:opacity-100 transition-opacity" title="Copy to clipboard">
+        {copied ? <Check className="w-4 h-4 text-green-600" /> : <Copy className="w-4 h-4 text-gray-600" />}
+      </button>
+    </div>
+  )
+}
+
+// Simple InlineCode component
+function InlineCode({ children }: { children: React.ReactNode }) {
+  return <code className="px-1.5 py-0.5 bg-gray-100 dark:bg-gray-800 rounded text-sm font-mono">{children}</code>
+}
+
+export default function GraphQLAPIShowcasePage() {
+  return (
+    <div className="container mx-auto max-w-6xl py-12 px-4">
+      {/* Header */}
+      <div className="mb-12">
+        <h1 className="text-4xl font-bold mb-4">GraphQL API Plugin</h1>
+        <p className="text-gray-600 dark:text-gray-400 text-lg">Type-safe GraphQL API with Apollo Server and TypeGraphQL</p>
+      </div>
+
+      <div className="space-y-12">
+        {/* Apollo Sandbox - Hero Section */}
+        <section className="mb-12">
+          <h2 className="text-2xl font-bold mb-4">Apollo Sandbox</h2>
+          <div className="bg-gradient-to-r from-blue-50 to-indigo-50 dark:from-blue-900/20 dark:to-indigo-900/20 border border-blue-200 dark:border-blue-800 rounded-lg p-6 mb-6">
+            <p className="text-gray-700 dark:text-gray-300 mb-4">Test and explore your GraphQL API interactively with Apollo Sandbox. It provides a powerful IDE with autocomplete, query history, and schema documentation.</p>
+            <a href="/api/graphql" target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 bg-blue-600 text-white px-6 py-3 rounded-lg hover:bg-blue-700 transition-colors font-semibold">
+              Open Apollo Sandbox
+              <ExternalLink className="w-4 h-4" />
+            </a>
+          </div>
+          <div className="bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg p-4">
+            <p className="text-sm text-yellow-800 dark:text-yellow-200">
+              <strong>Note:</strong> Apollo Sandbox opens at <InlineCode>/api/graphql</InlineCode> and requires the development server to be running.
+            </p>
+          </div>
+        </section>
+
+        {/* Overview Section */}
+        <section>
+          <h2 className="text-2xl font-bold mb-4">Overview</h2>
+          <p className="text-gray-600 dark:text-gray-400 mb-6">This plugin provides a fully-featured GraphQL API using:</p>
+          <ul className="list-disc list-inside space-y-2 text-gray-700 dark:text-gray-300 mb-6">
+            <li>
+              <strong>Apollo Server</strong> - Industry-standard GraphQL server
+            </li>
+            <li>
+              <strong>TypeGraphQL</strong> - Build type-safe GraphQL APIs with TypeScript decorators
+            </li>
+            <li>
+              <strong>Next.js Integration</strong> - Seamlessly integrated with Next.js App Router
+            </li>
+            <li>
+              <strong>Class Validator</strong> - Automatic input validation
+            </li>
+            <li>
+              <strong>Example Book API</strong> - Ready-to-use CRUD operations
+            </li>
+          </ul>
+        </section>
+
+        {/* Example Queries Section */}
+        <section>
+          <h2 className="text-2xl font-bold mb-4">Example Queries</h2>
+          <p className="text-gray-600 dark:text-gray-400 mb-6">Copy these queries and run them in Apollo Sandbox to test the API:</p>
+
+          {/* List Books */}
+          <div className="mb-8">
+            <h3 className="text-xl font-semibold mb-3">List Books</h3>
+            <p className="text-gray-600 dark:text-gray-400 mb-3">Fetch all books with optional search and sorting:</p>
+            <CodeBlock
+              language="graphql"
+              code={`query ListBooks {
+  books {
+    id
+    title
+    author
+    description
+    createdAt
+    updatedAt
+  }
+}
+
+# With search
+query SearchBooks {
+  books(search: "Clean") {
+    id
+    title
+    author
+  }
+}
+
+# With sorting
+query SortedBooks {
+  books(sort: { field: TITLE, direction: ASC }) {
+    id
+    title
+    author
+  }
+}`}
+            />
+          </div>
+
+          {/* Get Single Book */}
+          <div className="mb-8">
+            <h3 className="text-xl font-semibold mb-3">Get Single Book</h3>
+            <p className="text-gray-600 dark:text-gray-400 mb-3">Fetch a specific book by ID:</p>
+            <CodeBlock
+              language="graphql"
+              code={`query GetBook {
+  book(id: "1") {
+    id
+    title
+    author
+    description
+    createdAt
+    updatedAt
+  }
+}`}
+            />
+          </div>
+
+          {/* Create Book */}
+          <div className="mb-8">
+            <h3 className="text-xl font-semibold mb-3">Create Book</h3>
+            <p className="text-gray-600 dark:text-gray-400 mb-3">Create a new book with validation:</p>
+            <CodeBlock
+              language="graphql"
+              code={`mutation CreateBook {
+  createBook(input: {
+    title: "Design Patterns"
+    author: "Gang of Four"
+    description: "Elements of Reusable Object-Oriented Software"
+  }) {
+    id
+    title
+    author
+    description
+    createdAt
+  }
+}`}
+            />
+          </div>
+
+          {/* Update Book */}
+          <div className="mb-8">
+            <h3 className="text-xl font-semibold mb-3">Update Book</h3>
+            <p className="text-gray-600 dark:text-gray-400 mb-3">Update an existing book (all fields optional):</p>
+            <CodeBlock
+              language="graphql"
+              code={`mutation UpdateBook {
+  updateBook(id: "1", input: {
+    description: "Updated description for the book"
+  }) {
+    id
+    title
+    author
+    description
+    updatedAt
+  }
+}`}
+            />
+          </div>
+
+          {/* Delete Book */}
+          <div className="mb-8">
+            <h3 className="text-xl font-semibold mb-3">Delete Book</h3>
+            <p className="text-gray-600 dark:text-gray-400 mb-3">Delete a book by ID:</p>
+            <CodeBlock
+              language="graphql"
+              code={`mutation DeleteBook {
+  deleteBook(id: "1")
+}`}
+            />
+          </div>
+        </section>
+
+        {/* Extending the API */}
+        <section>
+          <h2 className="text-2xl font-bold mb-4">Extending the API</h2>
+          <p className="text-gray-600 dark:text-gray-400 mb-6">Add your own GraphQL resolvers to extend the API:</p>
+
+          <div className="mb-6">
+            <h3 className="text-lg font-semibold mb-3">1. Create a DTO (Data Transfer Object)</h3>
+            <CodeBlock
+              language="typescript"
+              code={`import { ObjectType, Field, ID, InputType } from 'type-graphql'
+import { IsString, MinLength, MaxLength } from 'class-validator'
+
+@ObjectType()
+export class ProductDTO {
+  @Field(() => ID)
+  id!: string
+
+  @Field(() => String)
+  name!: string
+
+  @Field(() => Number)
+  price!: number
+}
+
+@InputType()
+export class CreateProductInput {
+  @Field(() => String)
+  @IsString()
+  @MinLength(1)
+  @MaxLength(100)
+  name!: string
+
+  @Field(() => Number)
+  price!: number
+}`}
+            />
+          </div>
+
+          <div className="mb-6">
+            <h3 className="text-lg font-semibold mb-3">2. Create a Resolver</h3>
+            <CodeBlock
+              language="typescript"
+              code={`import { Resolver, Query, Mutation, Arg, Ctx } from 'type-graphql'
+import { ProductDTO, CreateProductInput } from '../dtos/product-dto'
+import type { Context } from '@/modules/graphql/types/Context'
+
+@Resolver(() => ProductDTO)
+export class ProductResolver {
+  @Query(() => [ProductDTO])
+  async products(@Ctx() ctx: Context): Promise<ProductDTO[]> {
+    // Your logic here
+    return []
+  }
+
+  @Mutation(() => ProductDTO)
+  async createProduct(
+    @Arg('input') input: CreateProductInput,
+    @Ctx() ctx: Context
+  ): Promise<ProductDTO> {
+    // Your logic here
+    return {
+      id: '1',
+      name: input.name,
+      price: input.price
+    }
+  }
+}`}
+            />
+          </div>
+
+          <div className="mb-6">
+            <h3 className="text-lg font-semibold mb-3">3. Register Your Resolver</h3>
+            <p className="text-gray-600 dark:text-gray-400 mb-3">
+              Add your resolver to the resolvers array in <InlineCode>src/modules/graphql/services/schema-svc.ts</InlineCode>:
+            </p>
+            <CodeBlock
+              language="typescript"
+              code={`import { BookResolver } from '@/modules/graphql-example'
+import { ProductResolver } from '@/modules/products' // Your new resolver
+
+const resolverClasses = [
+  BookResolver,
+  ProductResolver, // Add your resolver here
+] as const`}
+            />
+          </div>
+
+          <div className="bg-green-50 dark:bg-green-900/20 border border-green-200 dark:border-green-800 rounded-lg p-4 mt-6">
+            <p className="text-sm text-green-800 dark:text-green-200">
+              <strong>TypeScript Configuration:</strong> This plugin requires <InlineCode>experimentalDecorators</InlineCode>, <InlineCode>emitDecoratorMetadata</InlineCode>, and <InlineCode>useDefineForClassFields: false</InlineCode> in your tsconfig.json.
+            </p>
+          </div>
+        </section>
+      </div>
+    </div>
+  )
+}

package/templates/src/modules/graphql/bootstrap.ts

@@ -0,0 +1 @@
+import 'reflect-metadata'

package/templates/src/modules/graphql/services/schema-svc.ts

@@ -0,0 +1,22 @@
+import '@/modules/graphql/bootstrap' // imports reflect-metadata once
+
+import { buildSchema } from 'type-graphql'
+import type { GraphQLSchema } from 'graphql'
+
+import { graphqlResolvers as exampleResolvers } from '@/modules/graphql-example'
+
+const resolverClasses = [...exampleResolvers] as const
+
+const schemaPromise: Promise<GraphQLSchema> = buildSchema({
+  resolvers: resolverClasses,
+  validate: {
+    whitelist: true,
+    forbidNonWhitelisted: true,
+    skipMissingProperties: false,
+  },
+  emitSchemaFile: false,
+})
+
+export function getSchema(): Promise<GraphQLSchema> {
+  return schemaPromise
+}

package/templates/src/modules/graphql/services/server-svc.ts

@@ -0,0 +1,24 @@
+import '@/modules/graphql/bootstrap'
+import { ApolloServer } from '@apollo/server'
+import { ApolloServerPluginLandingPageLocalDefault } from '@apollo/server/plugin/landingPage/default'
+import type { Context } from '../types/Context'
+import { getSchema } from './schema-svc'
+
+let serverInstance: ApolloServer<Context> | null = null
+const isProd = process.env.VERCEL_ENV === 'production'
+
+export async function getServerSingleton() {
+  if (!serverInstance) serverInstance = await createServerInstance()
+  return serverInstance
+}
+
+async function createServerInstance() {
+  const plugins = []
+  if (!isProd) plugins.push(ApolloServerPluginLandingPageLocalDefault({ embed: true, footer: false }))
+  const schema = await getSchema()
+  return new ApolloServer<Context>({
+    introspection: !isProd,
+    plugins,
+    schema,
+  })
+}

package/templates/src/modules/graphql/types/Context.ts

@@ -0,0 +1,7 @@
+/**
+ * GraphQL Context type definition.
+ * This file defines the structure of the context object that will be passed to all GraphQL resolvers.
+ * The context can include things like authentication information, database connections, data loaders, etc.
+ *
+ */
+export interface Context {}

package/templates/src/modules/graphql-example/api/dtos/book-dto.ts

@@ -0,0 +1,80 @@
+import { Field, ID, InputType, ObjectType } from 'type-graphql'
+import { IsIn, IsOptional, IsString, MaxLength, MinLength } from 'class-validator'
+
+@ObjectType({ description: 'A book in the in-memory example catalog' })
+export class BookDTO {
+  @Field(() => ID)
+  id!: string
+
+  @Field(() => String)
+  title!: string
+
+  @Field(() => String)
+  author!: string
+
+  @Field(() => String, { nullable: true })
+  description?: string
+
+  @Field(() => String)
+  createdAt!: string
+
+  @Field(() => String)
+  updatedAt!: string
+}
+
+@InputType({ description: 'Input for creating a book' })
+export class CreateBookInput {
+  @Field(() => String)
+  @IsString()
+  @MinLength(1)
+  @MaxLength(120)
+  title!: string
+
+  @Field(() => String)
+  @IsString()
+  @MinLength(1)
+  @MaxLength(80)
+  author!: string
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  description?: string
+}
+
+@InputType({ description: 'Input for updating a book' })
+export class UpdateBookInput {
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(120)
+  title?: string
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(80)
+  author?: string
+
+  @Field(() => String, { nullable: true })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  description?: string
+}
+
+@InputType({ description: 'Sort order for listing books' })
+export class BookSortInput {
+  @Field(() => String, { nullable: true, description: 'Sort field: title|author|createdAt|updatedAt' })
+  @IsOptional()
+  @IsIn(['title', 'author', 'createdAt', 'updatedAt'])
+  field?: 'title' | 'author' | 'createdAt' | 'updatedAt'
+
+  @Field(() => String, { nullable: true, description: 'Sort direction: asc|desc' })
+  @IsOptional()
+  @IsIn(['asc', 'desc'])
+  direction?: 'asc' | 'desc'
+}

package/templates/src/modules/graphql-example/api/resolvers/book-resolver.ts

@@ -0,0 +1,39 @@
+import { Arg, Ctx, ID, Mutation, Query, Resolver } from 'type-graphql'
+import type { Context } from '@/modules/graphql/types/Context'
+
+import { BookDTO, BookSortInput, CreateBookInput, UpdateBookInput } from '../dtos/book-dto'
+import { bookService } from '../../services/book-svc'
+
+@Resolver(() => BookDTO)
+export class BookResolver {
+  @Query(() => [BookDTO], { description: 'List books (optionally search & sort)' })
+  async books(@Arg('search', () => String, { nullable: true }) search: string | null, @Arg('sort', () => BookSortInput, { nullable: true }) sort: BookSortInput | null, @Ctx() _ctx: Context): Promise<BookDTO[]> {
+    return bookService.list({
+      search: search ?? undefined,
+      sortField: sort?.field,
+      sortDirection: sort?.direction ?? undefined,
+    })
+  }
+
+  @Query(() => BookDTO, { nullable: true, description: 'Get a book by id' })
+  async book(@Arg('id', () => ID) id: string, @Ctx() _ctx: Context): Promise<BookDTO | null> {
+    return bookService.getById(id)
+  }
+
+  @Mutation(() => BookDTO, { description: 'Create a new book' })
+  async createBook(@Arg('input', () => CreateBookInput) input: CreateBookInput, @Ctx() _ctx: Context): Promise<BookDTO> {
+    return bookService.create(input)
+  }
+
+  @Mutation(() => BookDTO, { description: 'Update an existing book' })
+  async updateBook(@Arg('id', () => ID) id: string, @Arg('input', () => UpdateBookInput) input: UpdateBookInput, @Ctx() _ctx: Context): Promise<BookDTO> {
+    // for the simple demo, we throw a generic error if missing
+    // later you can swap to your NotFoundError / BusinessError types
+    return bookService.update(id, input)
+  }
+
+  @Mutation(() => Boolean, { description: 'Delete a book by id' })
+  async deleteBook(@Arg('id', () => ID) id: string, @Ctx() _ctx: Context): Promise<boolean> {
+    return bookService.delete(id)
+  }
+}

package/templates/src/modules/graphql-example/index.ts

@@ -0,0 +1,2 @@
+import { BookResolver } from './api/resolvers/book-resolver'
+export const graphqlResolvers = [BookResolver] as const

package/templates/src/modules/graphql-example/services/book-svc.ts

@@ -0,0 +1,110 @@
+import type { CreateBookInput, UpdateBookInput } from '../api/dtos/book-dto'
+
+export type Book = {
+  id: string
+  title: string
+  author: string
+  description?: string
+  createdAt: string
+  updatedAt: string
+  [key: string]: string | undefined
+}
+
+function nowIso(): string {
+  return new Date().toISOString()
+}
+
+function randomId(): string {
+  // good enough for demo; replace with uuid later
+  return Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2)
+}
+
+class BookService {
+  private books: Book[] = [
+    {
+      id: 'b1',
+      title: 'The Pragmatic Programmer',
+      author: 'Andrew Hunt & David Thomas',
+      description: 'A classic book on pragmatic software craftsmanship.',
+      createdAt: nowIso(),
+      updatedAt: nowIso(),
+    },
+    {
+      id: 'b2',
+      title: 'Clean Code',
+      author: 'Robert C. Martin',
+      description: 'Guidance on writing clean, maintainable code.',
+      createdAt: nowIso(),
+      updatedAt: nowIso(),
+    },
+  ]
+
+  list(args?: { search?: string; sortField?: string; sortDirection?: 'asc' | 'desc' }): Book[] {
+    const search = args?.search?.trim().toLowerCase()
+    let result = [...this.books]
+
+    if (search) {
+      result = result.filter((b) => {
+        return b.title.toLowerCase().includes(search) || b.author.toLowerCase().includes(search) || (b.description ?? '').toLowerCase().includes(search)
+      })
+    }
+
+    const sortField = args?.sortField ?? 'updatedAt'
+    const sortDirection = args?.sortDirection ?? 'desc'
+
+    result.sort((a: Book, b: Book) => {
+      const av = a[sortField] ?? ''
+      const bv = b[sortField] ?? ''
+      if (av === bv) return 0
+      const cmp = av > bv ? 1 : -1
+      return sortDirection === 'asc' ? cmp : -cmp
+    })
+
+    return result
+  }
+
+  getById(id: string): Book | null {
+    return this.books.find((b) => b.id === id) ?? null
+  }
+
+  create(input: CreateBookInput): Book {
+    const ts = nowIso()
+    const book: Book = {
+      id: randomId(),
+      title: input.title.trim(),
+      author: input.author.trim(),
+      description: input.description?.trim() || undefined,
+      createdAt: ts,
+      updatedAt: ts,
+    }
+    this.books.unshift(book)
+    return book
+  }
+
+  update(id: string, input: UpdateBookInput): Book {
+    const idx = this.books.findIndex((b) => b.id === id)
+    if (idx === -1) {
+      throw new Error(`Book not found: ${id}`)
+    }
+
+    const existing = this.books[idx]
+    const updated: Book = {
+      ...existing,
+      title: input.title?.trim() ?? existing.title,
+      author: input.author?.trim() ?? existing.author,
+      description: input.description === undefined ? existing.description : input.description?.trim() || undefined,
+      updatedAt: nowIso(),
+    }
+
+    this.books[idx] = updated
+    return updated
+  }
+
+  delete(id: string): boolean {
+    const before = this.books.length
+    this.books = this.books.filter((b) => b.id !== id)
+    return this.books.length !== before
+  }
+}
+
+export const bookService = new BookService()