raffel 0.1.2

package/dist/mcp/docs/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../../src/mcp/docs/patterns.ts"],"names":[],"mappings":"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"}

package/dist/mcp/docs/quickstart.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Raffel MCP - Quickstart Guide
+ *
+ * Getting started with Raffel - from zero to production-ready API.
+ */
+export declare const quickstartGuide = "# Raffel Quickstart\n\n## Installation\n\n```bash\npnpm add raffel\n# or\nnpm install raffel\n```\n\n## Basic Server\n\n```typescript\nimport { createServer } from 'raffel'\n\nconst server = createServer({ port: 3000 })\n  .procedure('hello')\n    .handler(async (input, ctx) => {\n      return { message: `Hello, ${input.name || 'World'}!` }\n    })\n\nawait server.start()\nconsole.log('Server running on http://localhost:3000')\n```\n\n## Core Concepts\n\n### 1. Procedures (RPC Endpoints)\n\n```typescript\n// Unary RPC: Input \u2192 Output\nserver.procedure('users.create')\n  .handler(async (input, ctx) => {\n    return await db.users.create({ data: input })\n  })\n```\n\n### 2. Input/Output Validation\n\n```typescript\nimport { z } from 'zod'\nimport { registerValidator, createZodAdapter } from 'raffel'\n\nregisterValidator(createZodAdapter(z))\n\nserver.procedure('users.create')\n  .input(z.object({\n    name: z.string().min(2),\n    email: z.string().email()\n  }))\n  .output(z.object({\n    id: z.string(),\n    name: z.string(),\n    email: z.string()\n  }))\n  .handler(async (input, ctx) => {\n    // input is validated and typed\n    return await db.users.create({ data: input })\n  })\n```\n\n### 3. Context & Authentication\n\n```typescript\nimport { createAuthMiddleware, createBearerStrategy } from 'raffel'\n\nserver\n  .use(createAuthMiddleware({\n    strategy: createBearerStrategy({\n      validate: async (token) => {\n        const user = await verifyJwt(token)\n        return user ? { authenticated: true, principal: user } : { authenticated: false }\n      }\n    })\n  }))\n\n  .procedure('users.me')\n    .handler(async (input, ctx) => {\n      // ctx.auth contains auth info\n      if (!ctx.auth.authenticated) {\n        throw new RaffelError('UNAUTHENTICATED', 'Login required')\n      }\n      return ctx.auth.principal\n    })\n```\n\n### 4. Streaming\n\n```typescript\n// Server sends multiple responses\nserver.stream('logs.tail')\n  .handler(async function* (input, ctx) {\n    while (!ctx.signal.aborted) {\n      const logs = await getNewLogs(input.filter)\n      for (const log of logs) {\n        yield log\n      }\n      await sleep(1000)\n    }\n  })\n```\n\n### 5. Events\n\n```typescript\n// Fire-and-forget with retries\nserver.event('orders.notify')\n  .delivery('at-least-once')\n  .retryPolicy({ maxAttempts: 5 })\n  .handler(async (payload, ctx, ack) => {\n    await sendNotification(payload)\n    ack()  // Acknowledge success\n  })\n```\n\n### 6. Multiple Protocols\n\n```typescript\nconst server = createServer({ port: 3000 })\n  // HTTP is default\n  .enableWebSocket({ path: '/ws' })      // Add WebSocket\n  .enableJsonRpc({ path: '/jsonrpc' })   // Add JSON-RPC\n  .grpc({ port: 50051 })                 // Add gRPC\n  .enableGraphQL({ path: '/graphql' })   // Add GraphQL\n```\n\n## HTTP Mapping\n\n| Handler | HTTP | Path |\n|---------|------|------|\n| procedure | POST | /api/{name} |\n| stream | GET (SSE) | /api/streams/{name} |\n| event | POST | /api/events/{name} |\n\n## Complete Example\n\n```typescript\nimport { createServer, registerValidator, createZodAdapter, createAuthMiddleware, createBearerStrategy, RaffelError } from 'raffel'\nimport { z } from 'zod'\n\n// Setup validation\nregisterValidator(createZodAdapter(z))\n\nconst server = createServer({ port: 3000 })\n  // Providers (DI)\n  .provide('db', async () => {\n    const prisma = new PrismaClient()\n    await prisma.$connect()\n    return prisma\n  }, { onShutdown: (db) => db.$disconnect() })\n\n  // Global middleware\n  .use(createAuthMiddleware({\n    strategy: createBearerStrategy({ validate: verifyToken })\n  }))\n\n  // Procedures\n  .procedure('users.list')\n    .output(z.array(UserSchema))\n    .handler(async (input, ctx) => {\n      return await ctx.db.users.findMany()\n    })\n\n  .procedure('users.get')\n    .input(z.object({ id: z.string() }))\n    .output(UserSchema)\n    .handler(async ({ id }, ctx) => {\n      const user = await ctx.db.users.findUnique({ where: { id } })\n      if (!user) throw new RaffelError('NOT_FOUND', `User ${id} not found`)\n      return user\n    })\n\n  .procedure('users.create')\n    .input(CreateUserSchema)\n    .output(UserSchema)\n    .handler(async (input, ctx) => {\n      return await ctx.db.users.create({ data: input })\n    })\n\nawait server.start()\n```\n\n## Next Steps\n\n- **Interceptors**: Add rate limiting, caching, metrics\n- **Streaming**: Real-time data with generators\n- **Events**: Background processing with delivery guarantees\n- **Multi-protocol**: Same handlers on HTTP, WebSocket, gRPC\n- **Observability**: Metrics and distributed tracing\n";
+export declare const boilerplates: {
+    'basic-api': {
+        title: string;
+        description: string;
+        files: {
+            'src/server.ts': string;
+            'package.json': string;
+        };
+    };
+    'with-auth': {
+        title: string;
+        description: string;
+        files: {
+            'src/server.ts': string;
+        };
+    };
+    'with-prisma': {
+        title: string;
+        description: string;
+        files: {
+            'src/server.ts': string;
+            'prisma/schema.prisma': string;
+        };
+    };
+    'realtime-websocket': {
+        title: string;
+        description: string;
+        files: {
+            'src/server.ts': string;
+        };
+    };
+    'multi-protocol': {
+        title: string;
+        description: string;
+        files: {
+            'src/server.ts': string;
+        };
+    };
+};
+export declare function getBoilerplate(name: keyof typeof boilerplates): (typeof boilerplates)[keyof typeof boilerplates] | undefined;
+export declare function listBoilerplates(): Array<{
+    name: string;
+    title: string;
+    description: string;
+}>;
+//# sourceMappingURL=quickstart.d.ts.map

package/dist/mcp/docs/quickstart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../../src/mcp/docs/quickstart.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,eAAe,8jJA6L3B,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2dxB,CAAA;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,OAAO,YAAY,GAC9B,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,GAAG,SAAS,CAE9D;AAED,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9F"}