@veloxts/router 0.1.0 → 0.2.0

package/dist/trpc/adapter.js

@@ -1,313 +0,0 @@
-/**
- * tRPC adapter for procedure collections
- *
- * Converts VeloxTS procedure definitions into tRPC routers, enabling type-safe
- * API calls between frontend and backend.
- *
- * @module trpc/adapter
- */
-import { initTRPC, TRPCError } from '@trpc/server';
-// ============================================================================
-// tRPC Initialization
-// ============================================================================
-// Create a base tRPC instance for type inference
-// Note: No custom errorFormatter here to keep the type simple and portable
-const baseTRPC = initTRPC.context().create();
-/**
- * Create a tRPC instance with VeloxTS context
- *
- * This initializes tRPC with the BaseContext type, allowing procedures
- * to access request context and plugin-provided features.
- *
- * @returns tRPC instance with context
- *
- * @example
- * ```typescript
- * const t = createTRPC();
- *
- * const router = t.router({
- *   hello: t.procedure.query(() => 'Hello World'),
- * });
- * ```
- */
-export function createTRPC() {
-    // Create with default options - custom error formatting removed for type compatibility
-    // with tRPC v11.7+. Use veloxErrorToTRPCError() for custom error handling instead.
-    return initTRPC.context().create();
-}
-// ============================================================================
-// Router Building
-// ============================================================================
-/**
- * Build a tRPC router from a single procedure collection
- *
- * Converts all procedures in a collection to tRPC procedures,
- * preserving type information for client inference.
- *
- * @param t - tRPC instance
- * @param collection - Procedure collection to convert
- * @returns tRPC router
- *
- * @example
- * ```typescript
- * const t = createTRPC();
- * const userRouter = buildTRPCRouter(t, userProcedures);
- *
- * // Router has typed procedures:
- * // userRouter.getUser({ id: '123' })
- * ```
- */
-export function buildTRPCRouter(t, collection) {
-    // Build procedures object with explicit types
-    const routerConfig = {};
-    for (const [name, procedure] of Object.entries(collection.procedures)) {
-        routerConfig[name] = buildTRPCProcedure(t, procedure);
-    }
-    // Use type assertion for dynamic router creation
-    // This is safe because we're building from validated procedures
-    return t.router(routerConfig);
-}
-/**
- * Build a single tRPC procedure from a compiled VeloxTS procedure
- *
- * @internal
- */
-function buildTRPCProcedure(t, procedure) {
-    // Start with base procedure builder
-    const baseProcedure = t.procedure;
-    // Build the procedure chain based on configuration
-    if (procedure.inputSchema && procedure.outputSchema) {
-        // Both input and output schemas
-        const withInput = baseProcedure.input(procedure.inputSchema);
-        const withOutput = withInput.output(procedure.outputSchema);
-        const handler = createHandler(procedure);
-        return procedure.type === 'query' ? withOutput.query(handler) : withOutput.mutation(handler);
-    }
-    if (procedure.inputSchema) {
-        // Only input schema
-        const withInput = baseProcedure.input(procedure.inputSchema);
-        const handler = createHandler(procedure);
-        return procedure.type === 'query' ? withInput.query(handler) : withInput.mutation(handler);
-    }
-    if (procedure.outputSchema) {
-        // Only output schema
-        const withOutput = baseProcedure.output(procedure.outputSchema);
-        const handler = createNoInputHandler(procedure);
-        return procedure.type === 'query' ? withOutput.query(handler) : withOutput.mutation(handler);
-    }
-    // No schemas - use base procedure
-    const handler = createNoInputHandler(procedure);
-    return procedure.type === 'query'
-        ? baseProcedure.query(handler)
-        : baseProcedure.mutation(handler);
-}
-/**
- * Create a handler function for a procedure with input
- *
- * @internal
- */
-function createHandler(procedure) {
-    return async (opts) => {
-        const { input, ctx } = opts;
-        // Execute middleware chain if any
-        if (procedure.middlewares.length > 0) {
-            return executeWithMiddleware(procedure, input, ctx);
-        }
-        // Direct handler execution
-        return procedure.handler({ input, ctx });
-    };
-}
-/**
- * Create a handler function for a procedure without input
- *
- * @internal
- */
-function createNoInputHandler(procedure) {
-    return async (opts) => {
-        const { ctx } = opts;
-        const input = undefined;
-        // Execute middleware chain if any
-        if (procedure.middlewares.length > 0) {
-            return executeWithMiddleware(procedure, input, ctx);
-        }
-        // Direct handler execution
-        return procedure.handler({ input, ctx });
-    };
-}
-/**
- * Execute procedure with middleware chain
- *
- * @internal
- */
-async function executeWithMiddleware(procedure, input, ctx) {
-    // Build middleware chain from end to start
-    let next = async () => {
-        const output = await procedure.handler({ input, ctx });
-        return { output };
-    };
-    // Wrap each middleware from last to first
-    for (let i = procedure.middlewares.length - 1; i >= 0; i--) {
-        const middleware = procedure.middlewares[i];
-        const currentNext = next;
-        next = async () => {
-            return middleware({
-                input,
-                ctx,
-                next: async (opts) => {
-                    // Allow middleware to extend context
-                    if (opts?.ctx) {
-                        Object.assign(ctx, opts.ctx);
-                    }
-                    return currentNext();
-                },
-            });
-        };
-    }
-    const result = await next();
-    return result.output;
-}
-// ============================================================================
-// App Router Creation
-// ============================================================================
-/**
- * Create a namespaced app router from multiple procedure collections
- *
- * Each collection becomes a nested router under its namespace.
- *
- * @param t - tRPC instance
- * @param collections - Array of procedure collections
- * @returns Merged app router
- *
- * @example
- * ```typescript
- * const t = createTRPC();
- * const appRouter = createAppRouter(t, [
- *   userProcedures,    // namespace: 'users'
- *   postProcedures,    // namespace: 'posts'
- * ]);
- *
- * // Usage:
- * // appRouter.users.getUser({ id: '123' })
- * // appRouter.posts.listPosts({ page: 1 })
- *
- * // Export type for client
- * export type AppRouter = typeof appRouter;
- * ```
- */
-export function createAppRouter(t, collections) {
-    const routerConfig = {};
-    for (const collection of collections) {
-        routerConfig[collection.namespace] = buildTRPCRouter(t, collection);
-    }
-    return t.router(routerConfig);
-}
-// ============================================================================
-// Context Utilities
-// ============================================================================
-/**
- * Create a tRPC context factory for Fastify
- *
- * This factory creates the context for each tRPC request,
- * pulling from the Fastify request's decorated context.
- *
- * @template TContext - Context type
- * @returns Context factory function
- *
- * @example
- * ```typescript
- * import { fastifyTRPCPlugin } from '@trpc/server/adapters/fastify';
- *
- * await server.register(fastifyTRPCPlugin, {
- *   prefix: '/trpc',
- *   trpcOptions: {
- *     router: appRouter,
- *     createContext: createTRPCContextFactory(),
- *   },
- * });
- * ```
- */
-export function createTRPCContextFactory() {
-    return ({ req }) => {
-        if (!req.context) {
-            throw new TRPCError({
-                code: 'INTERNAL_SERVER_ERROR',
-                message: 'Request context not found. Ensure @veloxts/core is properly initialized ' +
-                    'and the VeloxApp is started before registering tRPC routes.',
-            });
-        }
-        return req.context;
-    };
-}
-// ============================================================================
-// Error Utilities
-// ============================================================================
-/**
- * Convert a VeloxTS error to a tRPC error
- *
- * Maps VeloxTS error codes to appropriate tRPC error codes.
- *
- * @param error - Error to convert
- * @param defaultCode - Default tRPC code if mapping not found
- * @returns TRPCError
- */
-export function veloxErrorToTRPCError(error, defaultCode = 'INTERNAL_SERVER_ERROR') {
-    // Map HTTP status codes to tRPC codes
-    const statusToTRPC = {
-        400: 'BAD_REQUEST',
-        401: 'UNAUTHORIZED',
-        403: 'FORBIDDEN',
-        404: 'NOT_FOUND',
-        408: 'TIMEOUT',
-        409: 'CONFLICT',
-        422: 'UNPROCESSABLE_CONTENT',
-        429: 'TOO_MANY_REQUESTS',
-        500: 'INTERNAL_SERVER_ERROR',
-    };
-    const trpcCode = error.statusCode ? (statusToTRPC[error.statusCode] ?? defaultCode) : defaultCode;
-    return new TRPCError({
-        code: trpcCode,
-        message: error.message,
-        cause: error.code,
-    });
-}
-/**
- * Type guard for tRPC errors with VeloxTS cause
- *
- * Use this when handling errors that may have been converted from VeloxTS errors
- * using veloxErrorToTRPCError().
- */
-export function isVeloxTRPCError(error) {
-    return typeof error.cause === 'string';
-}
-/**
- * Register tRPC plugin with Fastify server
- *
- * This is a convenience wrapper around fastifyTRPCPlugin that handles
- * the context factory automatically.
- *
- * @param server - Fastify server instance
- * @param options - tRPC plugin options
- *
- * @example
- * ```typescript
- * const app = await createVeloxApp({ port: 3000 });
- * const appRouter = createAppRouter(t, [userProcedures]);
- *
- * await registerTRPCPlugin(app.server, {
- *   prefix: '/trpc',
- *   router: appRouter,
- * });
- * ```
- */
-export async function registerTRPCPlugin(server, options) {
-    // Dynamic import to avoid pulling in complex types at compile time
-    const { fastifyTRPCPlugin } = await import('@trpc/server/adapters/fastify');
-    await server.register(fastifyTRPCPlugin, {
-        prefix: options.prefix ?? '/trpc',
-        trpcOptions: {
-            router: options.router,
-            createContext: createTRPCContextFactory(),
-        },
-    });
-}
-//# sourceMappingURL=adapter.js.map

package/dist/trpc/adapter.js.map

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

package/dist/trpc/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * tRPC adapter exports
- *
- * @module trpc
- */
-export type { AnyRouter, InferAppRouter, TRPCInstance, TRPCPluginOptions } from './adapter.js';
-export { buildTRPCRouter, createAppRouter, createTRPC, createTRPCContextFactory, isVeloxTRPCError, registerTRPCPlugin, veloxErrorToTRPCError, } from './adapter.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/trpc/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/trpc/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/trpc/index.js

@@ -1,7 +0,0 @@
-/**
- * tRPC adapter exports
- *
- * @module trpc
- */
-export { buildTRPCRouter, createAppRouter, createTRPC, createTRPCContextFactory, isVeloxTRPCError, registerTRPCPlugin, veloxErrorToTRPCError, } from './adapter.js';
-//# sourceMappingURL=index.js.map

package/dist/trpc/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/trpc/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,eAAe,EACf,eAAe,EACf,UAAU,EACV,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -1,240 +0,0 @@
-/**
- * Core type definitions for @veloxts/router
- *
- * Provides foundational types for the procedure system, context handling,
- * and router configuration.
- *
- * @module types
- */
-import type { BaseContext } from '@veloxts/core';
-/**
- * Procedure operation types
- *
- * - query: Read-only operations (maps to GET in REST)
- * - mutation: Write operations (maps to POST/PUT/DELETE in REST)
- */
-export type ProcedureType = 'query' | 'mutation';
-/**
- * HTTP methods supported by the REST adapter
- *
- * MVP (v0.1.0): GET and POST only
- * v1.1+: Full REST (GET, POST, PUT, PATCH, DELETE)
- */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-/**
- * Maps procedure naming conventions to HTTP methods
- *
- * @example
- * - getUser -> GET
- * - listUsers -> GET
- * - createUser -> POST
- * - updateUser -> PUT (v1.1+)
- * - deleteUser -> DELETE (v1.1+)
- */
-export declare const PROCEDURE_METHOD_MAP: Record<string, HttpMethod>;
-/**
- * Extended context type that can be augmented by middleware
- *
- * Starts with BaseContext and can be extended through the middleware chain.
- *
- * @template TExtensions - Additional context properties added by middleware
- */
-export type ExtendedContext<TExtensions extends object = object> = BaseContext & TExtensions;
-/**
- * Context factory function type
- *
- * Creates the initial context for a request. Can be customized to add
- * application-specific context properties.
- */
-export type ContextFactory<TContext extends BaseContext = BaseContext> = (baseContext: BaseContext) => TContext | Promise<TContext>;
-/**
- * Arguments passed to procedure handlers
- *
- * @template TInput - The validated input type
- * @template TContext - The context type available in the handler
- */
-export interface ProcedureHandlerArgs<TInput, TContext extends BaseContext = BaseContext> {
-    /** Validated input data (from request body/params/query) */
-    readonly input: TInput;
-    /** Request context with framework and plugin-provided properties */
-    readonly ctx: TContext;
-}
-/**
- * Procedure handler function signature
- *
- * @template TInput - The validated input type
- * @template TOutput - The handler return type
- * @template TContext - The context type
- */
-export type ProcedureHandler<TInput, TOutput, TContext extends BaseContext = BaseContext> = (args: ProcedureHandlerArgs<TInput, TContext>) => TOutput | Promise<TOutput>;
-/**
- * Result returned by the next() function in middleware
- *
- * @template TOutput - The output type from the handler
- */
-export interface MiddlewareResult<TOutput> {
-    /** The output from the handler or subsequent middleware */
-    readonly output: TOutput;
-}
-/**
- * Computes the context extensions added by middleware
- *
- * This utility type extracts properties that exist in TNewContext but not in TContext.
- * It enables type-safe context extension in middleware.
- *
- * @template TContext - The current context type
- * @template TNewContext - The extended context type after middleware
- */
-export type ContextExtensions<TContext extends BaseContext, TNewContext extends BaseContext> = Omit<TNewContext, keyof TContext>;
-/**
- * Next function passed to middleware
- *
- * The next function accepts optional context extensions that will be merged
- * into the request context. The extensions are typed based on the difference
- * between the input context (TContext) and output context (TNewContext).
- *
- * @template TContext - The current context type before middleware
- * @template TNewContext - The context type after middleware modifications
- * @template TOutput - Expected output type
- */
-export type MiddlewareNext<TContext extends BaseContext = BaseContext, TNewContext extends BaseContext = TContext, TOutput = unknown> = (opts?: {
-    /**
-     * Context extensions to merge into the request context.
-     *
-     * When TNewContext extends TContext with additional properties,
-     * this parameter accepts either:
-     * - The new properties (type-safe extension)
-     * - A partial of the new context (for flexibility)
-     */
-    ctx?: ContextExtensions<TContext, TNewContext> | Partial<TNewContext>;
-}) => Promise<MiddlewareResult<TOutput>>;
-/**
- * Arguments passed to middleware functions
- *
- * @template TInput - The input type
- * @template TContext - The current context type before middleware
- * @template TNewContext - The context type after middleware modifications
- * @template TOutput - The expected output type
- */
-export interface MiddlewareArgs<TInput, TContext extends BaseContext = BaseContext, TNewContext extends BaseContext = TContext, TOutput = unknown> {
-    /** Input data (may not be validated yet depending on middleware position) */
-    readonly input: TInput;
-    /** Current request context */
-    readonly ctx: TContext;
-    /**
-     * Function to call the next middleware or handler
-     *
-     * The next function accepts context extensions that transform TContext into TNewContext.
-     * This enables type-safe context extension through the middleware chain.
-     */
-    readonly next: MiddlewareNext<TContext, TNewContext, TOutput>;
-}
-/**
- * Middleware function signature
- *
- * Middleware can:
- * - Modify context before passing to handler
- * - Modify output after handler execution
- * - Short-circuit the chain by not calling next()
- * - Throw errors to abort processing
- *
- * The TNewContext parameter tracks context extensions for type safety.
- * When using .use<TNewContext>(), the builder captures this type and ensures
- * subsequent middleware and handlers see the extended context.
- *
- * @template TInput - The input type
- * @template TContext - The current context type before middleware
- * @template TNewContext - Context type after middleware modifications
- * @template TOutput - The output type
- */
-export type MiddlewareFunction<TInput, TContext extends BaseContext = BaseContext, TNewContext extends BaseContext = TContext, TOutput = unknown> = (args: MiddlewareArgs<TInput, TContext, TNewContext, TOutput>) => Promise<MiddlewareResult<TOutput>>;
-/**
- * REST route override configuration
- *
- * Allows manual override of auto-generated REST routes.
- */
-export interface RestRouteOverride {
-    /** HTTP method to use */
-    method?: HttpMethod;
-    /** Custom path pattern (e.g., '/users/:id/activate') */
-    path?: string;
-}
-/**
- * Compiled procedure with all metadata and handlers
- *
- * This is the final output of the procedure builder, ready for registration
- * with both tRPC and REST adapters.
- *
- * @template TInput - The validated input type
- * @template TOutput - The handler output type
- * @template TContext - The context type
- */
-export interface CompiledProcedure<TInput = unknown, TOutput = unknown, TContext extends BaseContext = BaseContext> {
-    /** Whether this is a query or mutation */
-    readonly type: ProcedureType;
-    /** The procedure handler function */
-    readonly handler: ProcedureHandler<TInput, TOutput, TContext>;
-    /** Input validation schema (if specified) */
-    readonly inputSchema?: {
-        parse: (input: unknown) => TInput;
-    };
-    /** Output validation schema (if specified) */
-    readonly outputSchema?: {
-        parse: (output: unknown) => TOutput;
-    };
-    /** Middleware chain to execute before handler */
-    readonly middlewares: ReadonlyArray<MiddlewareFunction<TInput, TContext, TContext, TOutput>>;
-    /** REST route override (if specified) */
-    readonly restOverride?: RestRouteOverride;
-    /**
-     * Pre-compiled middleware chain executor
-     *
-     * PERFORMANCE: This function is created once during procedure compilation
-     * and reused for every request, avoiding the overhead of building the
-     * middleware chain dynamically on each invocation.
-     *
-     * @internal
-     */
-    readonly _precompiledExecutor?: (input: TInput, ctx: TContext) => Promise<TOutput>;
-}
-/**
- * Record of named procedures
- *
- * NOTE: Uses `any` for variance compatibility - see ProcedureDefinitions for explanation.
- */
-export type ProcedureRecord = Record<string, CompiledProcedure<any, any, any>>;
-/**
- * Procedure collection with namespace
- *
- * Groups related procedures under a common namespace for routing.
- *
- * @template TProcedures - The record of named procedures
- */
-export interface ProcedureCollection<TProcedures extends ProcedureRecord = ProcedureRecord> {
-    /** Resource namespace (e.g., 'users', 'posts') */
-    readonly namespace: string;
-    /** Named procedures in this collection */
-    readonly procedures: TProcedures;
-}
-/**
- * Extracts the input type from a compiled procedure
- */
-export type InferProcedureInput<T> = T extends CompiledProcedure<infer I, unknown, BaseContext> ? I : never;
-/**
- * Extracts the output type from a compiled procedure
- */
-export type InferProcedureOutput<T> = T extends CompiledProcedure<unknown, infer O, BaseContext> ? O : never;
-/**
- * Extracts the context type from a compiled procedure
- */
-export type InferProcedureContext<T> = T extends CompiledProcedure<unknown, unknown, infer C> ? C : never;
-/**
- * Extracts procedure types from a collection
- */
-export type InferProcedureTypes<T extends ProcedureCollection> = {
-    [K in keyof T['procedures']]: {
-        input: InferProcedureInput<T['procedures'][K]>;
-        output: InferProcedureOutput<T['procedures'][K]>;
-    };
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,31 +0,0 @@
-/**
- * Core type definitions for @veloxts/router
- *
- * Provides foundational types for the procedure system, context handling,
- * and router configuration.
- *
- * @module types
- */
-/**
- * Maps procedure naming conventions to HTTP methods
- *
- * @example
- * - getUser -> GET
- * - listUsers -> GET
- * - createUser -> POST
- * - updateUser -> PUT (v1.1+)
- * - deleteUser -> DELETE (v1.1+)
- */
-export const PROCEDURE_METHOD_MAP = {
-    get: 'GET',
-    list: 'GET',
-    find: 'GET',
-    create: 'POST',
-    add: 'POST',
-    update: 'PUT',
-    edit: 'PUT',
-    patch: 'PATCH',
-    delete: 'DELETE',
-    remove: 'DELETE',
-};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwBH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B;IAC9D,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,MAAM;IACX,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC"}