@veloxts/router 0.6.84 → 0.6.86

package/dist/trpc/adapter.js

@@ -8,6 +8,7 @@
  */
 import { initTRPC, TRPCError } from '@trpc/server';
 import { isGuardError } from '../errors.js';
+import { executeMiddlewareChain } from '../middleware/chain.js';
 // ============================================================================
 // tRPC Initialization
 // ============================================================================
@@ -74,33 +75,23 @@ export function buildTRPCRouter(t, collection) {
  * @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);
-    }
+    // Build the procedure chain incrementally
+    // biome-ignore lint/suspicious/noExplicitAny: tRPC procedure builder has complex types that vary by chain state
+    let builder = t.procedure;
+    // Add input schema if present
     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);
+        builder = builder.input(procedure.inputSchema);
     }
+    // Add output schema if present
     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);
+        builder = builder.output(procedure.outputSchema);
     }
-    // No schemas - use base procedure
-    const handler = createNoInputHandler(procedure);
-    return procedure.type === 'query'
-        ? baseProcedure.query(handler)
-        : baseProcedure.mutation(handler);
+    // Select handler based on whether input is expected
+    const handler = procedure.inputSchema
+        ? createHandler(procedure)
+        : createNoInputHandler(procedure);
+    // Finalize as query or mutation
+    return procedure.type === 'query' ? builder.query(handler) : builder.mutation(handler);
 }
 /**
  * Create a handler function for a procedure with input
@@ -141,31 +132,7 @@ function createNoInputHandler(procedure) {
  * @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;
+    return executeMiddlewareChain(procedure.middlewares, input, ctx, async () => procedure.handler({ input, ctx }));
 }
 // ============================================================================
 // App Router Creation
@@ -174,10 +141,11 @@ async function executeWithMiddleware(procedure, input, ctx) {
  * Create a namespaced app router from multiple procedure collections
  *
  * Each collection becomes a nested router under its namespace.
+ * Use `as const` on the collections array to preserve literal types.
  *
  * @param t - tRPC instance
- * @param collections - Array of procedure collections
- * @returns Merged app router
+ * @param collections - Array of procedure collections (use `as const` for best type inference)
+ * @returns Merged app router with preserved types
  *
  * @example
  * ```typescript
@@ -185,13 +153,13 @@ async function executeWithMiddleware(procedure, input, ctx) {
  * const router = appRouter(t, [
  *   userProcedures,    // namespace: 'users'
  *   postProcedures,    // namespace: 'posts'
- * ]);
+ * ] as const);
  *
  * // Usage:
  * // router.users.getUser({ id: '123' })
  * // router.posts.listPosts({ page: 1 })
  *
- * // Export type for client
+ * // Export type for client - fully typed!
  * export type AppRouter = typeof router;
  * ```
  */
@@ -239,9 +207,6 @@ export function createTRPCContextFactory() {
         return req.context;
     };
 }
-// ============================================================================
-// Error Utilities
-// ============================================================================
 /**
  * Convert a VeloxTS error to a tRPC error
  *
@@ -268,19 +233,25 @@ export function veloxErrorToTRPCError(error, defaultCode = 'INTERNAL_SERVER_ERRO
     const trpcCode = error.statusCode ? (statusToTRPC[error.statusCode] ?? defaultCode) : defaultCode;
     // Handle GuardError specifically to preserve guard metadata
     if (isGuardError(error)) {
+        const cause = {
+            source: 'velox',
+            code: error.code,
+            guardName: error.guardName,
+        };
         return new TRPCError({
             code: trpcCode,
             message: error.message,
-            cause: {
-                code: error.code,
-                guardName: error.guardName,
-            },
+            cause,
         });
     }
+    const cause = {
+        source: 'velox',
+        code: error.code,
+    };
     return new TRPCError({
         code: trpcCode,
         message: error.message,
-        cause: error.code,
+        cause,
     });
 }
 /**
@@ -290,7 +261,8 @@ export function veloxErrorToTRPCError(error, defaultCode = 'INTERNAL_SERVER_ERRO
  * using veloxErrorToTRPCError().
  */
 export function isVeloxTRPCError(error) {
-    return typeof error.cause === 'string';
+    const cause = error.cause;
+    return (cause != null && typeof cause === 'object' && 'source' in cause && cause.source === 'velox');
 }
 /**
  * Register tRPC plugin with Fastify server

package/dist/trpc/index.d.ts

@@ -3,5 +3,7 @@
  *
  * @module trpc
  */
-export type { AnyRouter, InferAppRouter, TRPCInstance, TRPCPluginOptions } from './adapter.js';
+export type { AnyRouter, 
+/** @deprecated Use `TRPCRouter` instead */
+AsTRPCRouter, CollectionsToRouterRecord, ExtractNamespace, ExtractProcedures, InferAppRouter, InferRouterFromCollections, MapProcedureRecordToTRPC, MapProcedureToTRPC, TRPCInstance, TRPCPluginOptions, TRPCRouter, } from './adapter.js';
 export { appRouter, buildTRPCRouter, createTRPCContextFactory, isVeloxTRPCError, registerTRPCPlugin, trpc, veloxErrorToTRPCError, } from './adapter.js';

package/dist/types.d.ts

@@ -193,7 +193,7 @@ export interface RestRouteOverride {
 /**
  * Parent resource configuration for nested routes
  *
- * Defines the parent resource relationship for generating nested REST routes
+ * Defines a single parent resource relationship for generating nested REST routes
  * like `/posts/:postId/comments/:id`.
  *
  * @example
@@ -207,16 +207,39 @@ export interface RestRouteOverride {
  */
 export interface ParentResourceConfig {
     /**
-     * Parent resource namespace (e.g., 'posts', 'users')
-     * Used to build the parent path segment: `/${namespace}/:${paramName}`
+     * Parent resource name (e.g., 'posts', 'users')
+     * Used to build the parent path segment: `/${resource}/:${param}`
      */
-    readonly namespace: string;
+    readonly resource: string;
     /**
      * Parent resource parameter name in the path
-     * Defaults to `${singularNamespace}Id` if not specified
+     * Defaults to `${singularResource}Id` if not specified
      * (e.g., 'posts' -> 'postId', 'users' -> 'userId')
      */
-    readonly paramName: string;
+    readonly param: string;
+}
+/**
+ * Multi-level parent resource configuration for deeply nested routes
+ *
+ * Defines multiple parent resources for generating deeply nested REST routes
+ * like `/organizations/:orgId/projects/:projectId/tasks/:id`.
+ *
+ * @example
+ * ```typescript
+ * // Multi-level nesting
+ * procedure().parents([
+ *   { resource: 'organizations', param: 'orgId' },
+ *   { resource: 'projects', param: 'projectId' },
+ * ])
+ * // Generates: /organizations/:orgId/projects/:projectId/tasks/:id
+ * ```
+ */
+export interface ParentResourceChain {
+    /**
+     * Array of parent resources from outermost to innermost
+     * E.g., [organizations, projects] for /organizations/:orgId/projects/:projectId/tasks
+     */
+    readonly parents: readonly ParentResourceConfig[];
 }
 /**
  * Compiled procedure with all metadata and handlers
@@ -248,8 +271,12 @@ export interface CompiledProcedure<TInput = unknown, TOutput = unknown, TContext
     readonly guards: ReadonlyArray<GuardLike<TContext>>;
     /** REST route override (if specified) */
     readonly restOverride?: RestRouteOverride;
+    /** Whether this procedure is deprecated */
+    readonly deprecated?: boolean;
+    /** Deprecation message explaining why and what to use instead */
+    readonly deprecationMessage?: string;
     /**
-     * Parent resource configuration for nested routes
+     * Parent resource configuration for nested routes (single level)
      *
      * When specified, the REST path will be prefixed with the parent resource:
      * `/${parent.namespace}/:${parent.paramName}/${childNamespace}/:id`
@@ -262,6 +289,23 @@ export interface CompiledProcedure<TInput = unknown, TOutput = unknown, TContext
      * ```
      */
     readonly parentResource?: ParentResourceConfig;
+    /**
+     * Multi-level parent resource configuration for deeply nested routes
+     *
+     * When specified, the REST path will be prefixed with all parent resources:
+     * `/${parent1.namespace}/:${parent1.paramName}/${parent2.namespace}/:${parent2.paramName}/...`
+     *
+     * @example
+     * ```typescript
+     * // With parentResources: [
+     * //   { namespace: 'organizations', paramName: 'orgId' },
+     * //   { namespace: 'projects', paramName: 'projectId' }
+     * // ]
+     * // and namespace: 'tasks'
+     * // Generates: /organizations/:orgId/projects/:projectId/tasks/:id
+     * ```
+     */
+    readonly parentResources?: readonly ParentResourceConfig[];
     /**
      * Pre-compiled middleware chain executor
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/router",
-  "version": "0.6.84",
+  "version": "0.6.86",
   "description": "Procedure definitions with tRPC and REST routing for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -40,8 +40,8 @@
     "@trpc/server": "11.8.0",
     "fastify": "5.6.2",
     "zod-to-json-schema": "3.24.5",
-    "@veloxts/core": "0.6.84",
-    "@veloxts/validation": "0.6.84"
+    "@veloxts/validation": "0.6.86",
+    "@veloxts/core": "0.6.86"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.16",