raffel 0.1.2

package/dist/server/fs-routes/types.d.ts

@@ -0,0 +1,437 @@
+/**
+ * File-System Discovery Types
+ *
+ * Type definitions for Next.js-style auto-discovery of handlers.
+ */
+import type { z } from 'zod';
+import type { Context, Interceptor, RetryPolicy, StreamDirection, HttpMethod, JsonRpcMeta, GrpcMeta } from '../../types/index.js';
+/**
+ * Auto-discovery configuration for loading handlers from file system.
+ *
+ * Each property specifies a directory to scan for handlers.
+ * Set to `true` to use default path, or a string for custom path.
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * discovery: true
+ *
+ * // Custom paths
+ * discovery: {
+ *   http: './src/api',
+ *   channels: './src/realtime',
+ *   rest: './src/rest',
+ * }
+ * ```
+ */
+export interface DiscoveryConfig {
+    /**
+     * HTTP procedures directory.
+     * Individual handler files with full control.
+     * @default './src/http'
+     */
+    http?: string | boolean;
+    /**
+     * WebSocket channels directory.
+     * Pusher-like pub/sub channels.
+     * @default './src/channels'
+     */
+    channels?: string | boolean;
+    /**
+     * RPC procedures directory (JSON-RPC, gRPC).
+     * @default './src/rpc'
+     */
+    rpc?: string | boolean;
+    /**
+     * Streaming handlers directory.
+     * @default './src/streams'
+     */
+    streams?: string | boolean;
+    /**
+     * REST auto-CRUD directory.
+     * Schema-first API generation - one schema file = all CRUD operations.
+     * Lowest boilerplate, highest convention.
+     * @default './src/rest'
+     */
+    rest?: string | boolean;
+    /**
+     * Resource handlers directory.
+     * Middle-level abstraction: 1 file = 1 resource with explicit handlers.
+     * Balance between boilerplate and control.
+     * @default './src/resources'
+     */
+    resources?: string | boolean;
+    /**
+     * TCP custom handlers directory.
+     * Full control over TCP connections, framing, and binary data.
+     * @default './src/tcp'
+     */
+    tcp?: string | boolean;
+    /**
+     * UDP custom handlers directory.
+     * Full control over UDP packets, multicast support.
+     * @default './src/udp'
+     */
+    udp?: string | boolean;
+}
+export interface DiscoveryLoaderOptions {
+    /** Base directory (default: process.cwd()) */
+    baseDir?: string;
+    /** Discovery configuration */
+    discovery: DiscoveryConfig | boolean;
+    /** Enable hot reload in development */
+    hotReload?: boolean;
+    /** File extensions to load (default: ['.ts', '.js']) */
+    extensions?: string[];
+    /** Called when handlers are loaded/reloaded */
+    onLoad?: (stats: DiscoveryStats) => void;
+    /** Called on hot reload error */
+    onError?: (error: Error) => void;
+}
+export interface DiscoveryStats {
+    http: number;
+    channels: number;
+    rpc: number;
+    streams: number;
+    rest: number;
+    resources: number;
+    tcp: number;
+    udp: number;
+    middlewares: number;
+    total: number;
+    duration: number;
+}
+/**
+ * Handler file exports.
+ *
+ * @example
+ * ```typescript
+ * // src/http/users/get.ts
+ * import { z } from 'zod'
+ *
+ * export const input = z.object({ id: z.string() })
+ * export const output = z.object({ name: z.string() })
+ *
+ * export const meta = {
+ *   description: 'Get user by ID',
+ *   auth: 'required',
+ *   roles: ['admin', 'user'],
+ * }
+ *
+ * export default async function handler(input, ctx) {
+ *   return { name: 'John' }
+ * }
+ * ```
+ */
+export interface HandlerExports {
+    /** Default export: the handler function */
+    default: HandlerFunction;
+    /** Input schema (Zod) */
+    input?: z.ZodType;
+    /** Output schema (Zod) */
+    output?: z.ZodType;
+    /** Handler metadata */
+    meta?: HandlerMeta;
+}
+export type HandlerFunction = (input: unknown, ctx: Context, ack?: () => void) => unknown | Promise<unknown>;
+export interface HandlerMeta {
+    /** Short summary for OpenAPI (one-liner, shown in endpoint cards) */
+    summary?: string;
+    /**
+     * Description for OpenAPI/docs (supports markdown).
+     * Can also be loaded from a sibling .md file automatically.
+     */
+    description?: string;
+    /**
+     * Tags for OpenAPI grouping.
+     * Can also be set via _meta.ts in the directory.
+     */
+    tags?: string[];
+    /** Content type shorthand for this handler */
+    contentType?: string;
+    /** Content type configuration for this handler */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    /**
+     * Authentication requirement.
+     * - 'required': Must be authenticated
+     * - 'optional': Auth checked but not required
+     * - 'none': No auth check (default)
+     */
+    auth?: 'required' | 'optional' | 'none';
+    /** Required roles (when auth is 'required' or 'optional') */
+    roles?: string[];
+    /** Rate limiting config */
+    rateLimit?: {
+        limit: number;
+        window: number;
+    };
+    /** Custom interceptors for this handler */
+    interceptors?: Interceptor[];
+    /** Event delivery guarantee (for events) */
+    delivery?: 'best-effort' | 'at-least-once' | 'at-most-once';
+    /** Retry policy (for at-least-once events) */
+    retryPolicy?: RetryPolicy;
+    /** Deduplication window in ms (for at-most-once events) */
+    deduplicationWindow?: number;
+    /** Stream direction (for streams) */
+    direction?: StreamDirection;
+    /** GraphQL mapping metadata (procedures only) */
+    graphql?: {
+        type: 'query' | 'mutation';
+    };
+    /** HTTP path override for procedures */
+    httpPath?: string;
+    /** HTTP method override for procedures */
+    httpMethod?: HttpMethod;
+    /** JSON-RPC metadata (for USD generation) */
+    jsonrpc?: JsonRpcMeta;
+    /** gRPC metadata (for USD generation) */
+    grpc?: GrpcMeta;
+}
+/**
+ * Directory-level metadata for grouping and documenting endpoints.
+ * Loaded from `_meta.ts` or `_meta.md` files.
+ *
+ * @example
+ * ```typescript
+ * // src/http/users/_meta.ts
+ * export default {
+ *   tag: 'Users',
+ *   summary: 'User management',
+ *   description: `
+ * ## User Management API
+ *
+ * CRUD operations for user accounts, profiles, and settings.
+ *   `,
+ * }
+ * ```
+ */
+export interface DirectoryMeta {
+    /**
+     * Tag name for grouping endpoints in documentation.
+     * Defaults to directory name if not specified.
+     */
+    tag?: string;
+    /** Short summary for the tag (one-liner) */
+    summary?: string;
+    /**
+     * Description for the tag (supports markdown).
+     * Can also be loaded from `_meta.md` file.
+     */
+    description?: string;
+    /**
+     * External documentation link.
+     */
+    externalDocs?: {
+        url: string;
+        description?: string;
+    };
+    /**
+     * Order hint for sorting tags in documentation.
+     * Lower numbers appear first.
+     */
+    order?: number;
+}
+/**
+ * Middleware file exports (_middleware.ts).
+ *
+ * @example
+ * ```typescript
+ * // src/http/_middleware.ts
+ * export default async function middleware(ctx, next) {
+ *   console.log('Before handler')
+ *   const result = await next()
+ *   console.log('After handler')
+ *   return result
+ * }
+ *
+ * export const config = {
+ *   matcher: ['users/*', 'orders/*'],
+ * }
+ * ```
+ */
+export interface MiddlewareExports {
+    /** Default export: middleware function */
+    default: MiddlewareFunction;
+    /** Middleware configuration */
+    config?: MiddlewareConfig;
+}
+export type MiddlewareFunction = (ctx: Context, next: () => Promise<unknown>) => unknown | Promise<unknown>;
+export interface MiddlewareConfig {
+    /** Glob patterns to match (default: all routes in directory) */
+    matcher?: string[];
+    /** Glob patterns to exclude */
+    exclude?: string[];
+}
+/**
+ * Auth config file exports (_auth.ts).
+ *
+ * @example
+ * ```typescript
+ * // src/http/_auth.ts
+ * export default {
+ *   strategy: 'bearer',
+ *   verify: async (token) => {
+ *     const payload = await jwt.verify(token, SECRET)
+ *     return { principal: payload.sub, roles: payload.roles }
+ *   },
+ * }
+ * ```
+ */
+export interface AuthConfigExports {
+    default: AuthConfig;
+}
+export interface AuthConfig {
+    /** Auth strategy name or custom verify function */
+    strategy?: 'bearer' | 'api-key' | AuthVerifyFunction;
+    /** Token verification (for built-in strategies) */
+    verify?: AuthVerifyFunction;
+    /** Anonymous user config (when auth is 'optional' and no token) */
+    anonymous?: {
+        principal: string;
+        roles?: string[];
+        claims?: Record<string, unknown>;
+    };
+}
+export type AuthVerifyFunction = (credential: string, ctx: Context) => AuthResult | Promise<AuthResult>;
+export interface AuthResult {
+    principal: string;
+    roles?: string[];
+    claims?: Record<string, unknown>;
+}
+/**
+ * Channel handler exports.
+ *
+ * @example
+ * ```typescript
+ * // src/channels/presence-lobby.ts
+ * export const auth = 'required'
+ *
+ * export function presenceData(ctx) {
+ *   return { id: ctx.auth.principal, name: ctx.auth.claims.name }
+ * }
+ *
+ * export const events = {
+ *   message: { input: z.object({ text: z.string() }) },
+ * }
+ *
+ * export function onJoin(member, ctx) {
+ *   console.log(`${member.id} joined`)
+ * }
+ * ```
+ */
+export interface ChannelExports {
+    /** Auth requirement for this channel */
+    auth?: 'required' | 'optional' | 'none';
+    /** Presence data generator (for presence channels) */
+    presenceData?: (ctx: Context) => Record<string, unknown>;
+    /** Events this channel accepts */
+    events?: Record<string, ChannelEventConfig>;
+    /** Called when a member joins */
+    onJoin?: (member: ChannelMember, ctx: Context) => void | Promise<void>;
+    /** Called when a member leaves */
+    onLeave?: (member: ChannelMember, ctx: Context) => void | Promise<void>;
+    /** Custom publish authorization */
+    canPublish?: (event: string, data: unknown, ctx: Context) => boolean | Promise<boolean>;
+}
+export interface ChannelEventConfig {
+    /** Input schema for this event */
+    input?: z.ZodType;
+    /** Who can publish this event */
+    canPublish?: (ctx: Context) => boolean | Promise<boolean>;
+}
+export interface ChannelMember {
+    id: string;
+    userId?: string;
+    info: Record<string, unknown>;
+    joinedAt: number;
+}
+/**
+ * Stream handler exports.
+ *
+ * @example
+ * ```typescript
+ * // src/streams/logs/tail.ts
+ * export const input = z.object({ service: z.string() })
+ * export const output = z.object({ line: z.string(), ts: z.number() })
+ *
+ * export const meta = {
+ *   direction: 'server',  // server-to-client
+ *   auth: 'required',
+ * }
+ *
+ * export default async function* handler(input, ctx) {
+ *   for await (const line of tailLogs(input.service)) {
+ *     yield { line, ts: Date.now() }
+ *   }
+ * }
+ * ```
+ */
+export interface StreamExports extends HandlerExports {
+    default: StreamHandlerFunction;
+}
+export type StreamHandlerFunction = (input: unknown, ctx: Context) => AsyncIterable<unknown>;
+export interface LoadedRoute {
+    /** Route type */
+    kind: 'procedure' | 'event' | 'stream' | 'channel';
+    /** Route name (e.g., 'users/:id/get') */
+    name: string;
+    /**
+     * Dynamic parameters defined in the route path.
+     * Key is param name, value is the pattern (e.g., ':id', ':id?', ':path*')
+     *
+     * @example
+     * ```
+     * // File: users/[id]/get.ts → name: 'users/:id/get'
+     * params: { id: ':id' }
+     *
+     * // File: posts/[[slug]].ts → name: 'posts/:slug?'
+     * params: { slug: ':slug?' }
+     *
+     * // File: files/[...path].ts → name: 'files/:path*'
+     * params: { path: ':path*' }
+     * ```
+     */
+    params: Record<string, string>;
+    /** File path */
+    filePath: string;
+    /** Handler function */
+    handler: HandlerFunction | StreamHandlerFunction;
+    /** Input schema */
+    inputSchema?: z.ZodType;
+    /** Output schema */
+    outputSchema?: z.ZodType;
+    /** Handler metadata */
+    meta?: HandlerMeta;
+    /** Middleware chain for this route */
+    middlewares: MiddlewareFunction[];
+    /** Auth config for this route */
+    authConfig?: AuthConfig;
+    /**
+     * Directory metadata for documentation grouping.
+     * Loaded from _meta.ts or _meta.md in the handler's directory.
+     */
+    directoryMeta?: DirectoryMeta;
+}
+export interface LoadedChannel {
+    /** Channel name pattern (e.g., 'presence-lobby' or 'private-:userId') */
+    name: string;
+    /** File path */
+    filePath: string;
+    /** Channel exports */
+    config: ChannelExports;
+    /** Auth config */
+    authConfig?: AuthConfig;
+}
+export interface ParsedRoute {
+    /** Route segments (e.g., ['users', ':id', 'get']) */
+    segments: string[];
+    /** Dynamic params (e.g., { id: ':id' }) */
+    params: Record<string, string>;
+    /** Final route name */
+    name: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/fs-routes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/fs-routes/types.ts"],"names":[],"mappings":"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"}

package/dist/server/fs-routes/types.js

@@ -0,0 +1,7 @@
+/**
+ * File-System Discovery Types
+ *
+ * Type definitions for Next.js-style auto-discovery of handlers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/fs-routes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/fs-routes/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/server/fs-routes/udp/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * UDP Custom Handlers
+ *
+ * Full control UDP server handlers.
+ */
+export * from './types.js';
+export * from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/fs-routes/udp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/fs-routes/udp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/server/fs-routes/udp/index.js

@@ -0,0 +1,8 @@
+/**
+ * UDP Custom Handlers
+ *
+ * Full control UDP server handlers.
+ */
+export * from './types.js';
+export * from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/server/fs-routes/udp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/fs-routes/udp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/server/fs-routes/udp/loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * UDP Custom Handler Loader
+ *
+ * Loads custom UDP handlers from file system and creates servers.
+ */
+import type { UdpLoaderOptions, UdpLoaderResult, LoadedUdpHandler, UdpServerInstance } from './types.js';
+/**
+ * Load UDP handlers from directory.
+ */
+export declare function loadUdpHandlers(options: UdpLoaderOptions): Promise<UdpLoaderResult>;
+/**
+ * Create a UDP server instance from a loaded handler.
+ */
+export declare function createUdpServer(handler: LoadedUdpHandler): UdpServerInstance;
+//# sourceMappingURL=loader.d.ts.map

package/dist/server/fs-routes/udp/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/server/fs-routes/udp/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAIV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAEhB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAoBnB;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuDzF;AAiBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAmN5E"}