@emeryld/rrroutes-contract 2.3.9 → 2.4.1

package/README.md

@@ -32,8 +32,8 @@ import {
   InferParams,
   InferQuery,
   resource,
-} from '@emeryld/rrroutes-contract';
-import { z } from 'zod';
+} from '@emeryld/rrroutes-contract'
+import { z } from 'zod'
 
 // 1) Describe your API
 const leaves = resource('/v1')
@@ -44,7 +44,9 @@ const leaves = resource('/v1')
           search: z.string().optional(),
           limit: z.coerce.number().min(1).max(50).default(20),
         }),
-        outputSchema: z.array(z.object({ id: z.string().uuid(), email: z.string().email() })),
+        outputSchema: z.array(
+          z.object({ id: z.string().uuid(), email: z.string().email() }),
+        ),
         description: 'Find users',
       })
       .routeParameter('userId', z.string().uuid(), (user) =>
@@ -55,20 +57,25 @@ const leaves = resource('/v1')
       )
       .done(),
   )
-  .done();
+  .done()
 
 // 2) Freeze it into a registry for typed lookups
-export const registry = finalize(leaves);
+export const registry = finalize(leaves)
 
 // 3) Consume a leaf with full types
-const leaf = registry.byKey['PATCH /v1/users/:userId'];
-type Params = InferParams<typeof leaf>; // { userId: string }
-type Query = InferQuery<typeof leaf>;   // never (no query)
-type Output = InferOutput<typeof leaf>; // { ok: true }
+const leaf = registry.byKey['PATCH /v1/users/:userId']
+type Params = InferParams<typeof leaf> // { userId: string }
+type Query = InferQuery<typeof leaf> // never (no query)
+type Output = InferOutput<typeof leaf> // { ok: true }
 
 // 4) Build URLs + cache keys (React Query friendly)
-const url = compilePath(leaf.path, { userId: 'f2b2e72a-7f6d-4c3f-9c6f-7f0d8f3ac9e2' });
-const key = buildCacheKey({ leaf, params: { userId: 'f2b2e72a-7f6d-4c3f-9c6f-7f0d8f3ac9e2' } });
+const url = compilePath(leaf.path, {
+  userId: 'f2b2e72a-7f6d-4c3f-9c6f-7f0d8f3ac9e2',
+})
+const key = buildCacheKey({
+  leaf,
+  params: { userId: 'f2b2e72a-7f6d-4c3f-9c6f-7f0d8f3ac9e2' },
+})
 // key => ['patch', 'v1', 'users', 'f2b2e72a-7f6d-4c3f-9c6f-7f0d8f3ac9e2', { userId: 'f2b2e72a-7f6d-4c3f-9c6f-7f0d8f3ac9e2' }]
 ```
 
@@ -77,8 +84,8 @@ const key = buildCacheKey({ leaf, params: { userId: 'f2b2e72a-7f6d-4c3f-9c6f-7f0
 ### Fluent route builder
 
 ```ts
-import { resource } from '@emeryld/rrroutes-contract';
-import { z } from 'zod';
+import { resource } from '@emeryld/rrroutes-contract'
+import { z } from 'zod'
 
 const leaves = resource('/api') // base path, optional inherited cfg
   .with({ feed: false }) // merges flags into descendants (extend NodeCfg via declaration merging if you add your own)
@@ -86,7 +93,10 @@ const leaves = resource('/api') // base path, optional inherited cfg
     projects
       .get({
         feed: true, // infinite/feed for clients
-        querySchema: z.object({ cursor: z.string().optional(), limit: z.coerce.number().default(25) }),
+        querySchema: z.object({
+          cursor: z.string().optional(),
+          limit: z.coerce.number().default(25),
+        }),
         outputSchema: z.object({
           items: z.array(z.object({ id: z.string(), name: z.string() })),
           nextCursor: z.string().optional(),
@@ -117,7 +127,7 @@ const leaves = resource('/api') // base path, optional inherited cfg
       )
       .done(),
   )
-  .done();
+  .done()
 ```
 
 - `sub(name, [cfg], builder?)` nests paths (`/api/projects`).
@@ -135,21 +145,21 @@ import {
   InferBody,
   InferOutput,
   SubsetRoutes,
-} from '@emeryld/rrroutes-contract';
+} from '@emeryld/rrroutes-contract'
 
-const registry = finalize(leaves);
-const leaf = registry.byKey['PATCH /api/projects/:projectId'];
+const registry = finalize(leaves)
+const leaf = registry.byKey['PATCH /api/projects/:projectId']
 
 // TypeScript helpers
-type Body = InferBody<typeof leaf>;     // { name: string }
-type Output = InferOutput<typeof leaf>; // { id: string; name: string }
+type Body = InferBody<typeof leaf> // { name: string }
+type Output = InferOutput<typeof leaf> // { id: string; name: string }
 
 // Runtime helpers
-const url = compilePath(leaf.path, { projectId: '123' }); // "/api/projects/123"
-const cacheKey = buildCacheKey({ leaf, params: { projectId: '123' } });
+const url = compilePath(leaf.path, { projectId: '123' }) // "/api/projects/123"
+const cacheKey = buildCacheKey({ leaf, params: { projectId: '123' } })
 
 // Typed subsets for routers/microfrontends
-type ProjectRoutes = SubsetRoutes<typeof registry.all, '/api/projects'>;
+type ProjectRoutes = SubsetRoutes<typeof registry.all, '/api/projects'>
 ```
 
 - `finalize(leaves)` freezes the tuple and provides `byKey['METHOD /path']`, `all`, and `log(logger)`.
@@ -159,20 +169,34 @@ type ProjectRoutes = SubsetRoutes<typeof registry.all, '/api/projects'>;
 ### CRUD helper (`withCrud` / `resourceWithCrud`)
 
 ```ts
-import { CrudDefaultPagination, finalize, resource, withCrud } from '@emeryld/rrroutes-contract';
-import { z } from 'zod';
+import {
+  CrudDefaultPagination,
+  finalize,
+  resource,
+  withCrud,
+} from '@emeryld/rrroutes-contract'
+import { z } from 'zod'
 
-const r = withCrud(resource('/v1'));
+const r = withCrud(resource('/v1'))
 
 const leaves = r
   .crud(
     'articles',
     {
       paramSchema: z.string().uuid(), // value schema; becomes :articlesId
-      itemOutputSchema: z.object({ id: z.string().uuid(), title: z.string(), body: z.string() }),
+      itemOutputSchema: z.object({
+        id: z.string().uuid(),
+        title: z.string(),
+        body: z.string(),
+      }),
       list: { querySchema: CrudDefaultPagination },
       create: { bodySchema: z.object({ title: z.string(), body: z.string() }) },
-      update: { bodySchema: z.object({ title: z.string().optional(), body: z.string().optional() }) },
+      update: {
+        bodySchema: z.object({
+          title: z.string().optional(),
+          body: z.string().optional(),
+        }),
+      },
       enable: { remove: false }, // opt out of DELETE
     },
     ({ collection }) =>
@@ -187,9 +211,9 @@ const leaves = r
         )
         .done(),
   )
-  .done();
+  .done()
 
-const registry = finalize(leaves);
+const registry = finalize(leaves)
 // registry.byKey now includes the CRUD + extras routes with full types
 ```
 
@@ -203,29 +227,44 @@ const registry = finalize(leaves);
 Share a typed event map between client and server.
 
 ```ts
-import { defineSocketEvents, Payload } from '@emeryld/rrroutes-contract';
-import { z } from 'zod';
+import { defineSocketEvents, Payload } from '@emeryld/rrroutes-contract'
+import { z } from 'zod'
 
 const { config, events } = defineSocketEvents(
   {
     joinMetaMessage: z.object({ room: z.string() }),
     leaveMetaMessage: z.object({ room: z.string() }),
     pingPayload: z.object({ clientEcho: z.object({ sentAt: z.string() }) }),
-    pongPayload: z.object({ clientEcho: z.object({ sentAt: z.string() }).optional(), sinceMs: z.number().optional() }),
+    pongPayload: z.object({
+      clientEcho: z.object({ sentAt: z.string() }).optional(),
+      sinceMs: z.number().optional(),
+    }),
   },
   {
-    'chat:message': { message: z.object({ roomId: z.string(), text: z.string(), userId: z.string() }) },
-    'typing:update': { message: z.object({ roomId: z.string(), userId: z.string(), typing: z.boolean() }) },
+    'chat:message': {
+      message: z.object({
+        roomId: z.string(),
+        text: z.string(),
+        userId: z.string(),
+      }),
+    },
+    'typing:update': {
+      message: z.object({
+        roomId: z.string(),
+        userId: z.string(),
+        typing: z.boolean(),
+      }),
+    },
   },
-);
+)
 
 // Typed payload extraction
-type ChatPayload = Payload<typeof events, 'chat:message'>;
+type ChatPayload = Payload<typeof events, 'chat:message'>
 // ChatPayload -> { roomId: string; text: string; userId: string }
 
 // Server-side guard example
 function onChatMessage(raw: unknown) {
-  const parsed = events['chat:message'].message.parse(raw);
+  const parsed = events['chat:message'].message.parse(raw)
   // parsed is strongly typed; safe to broadcast
 }
 ```

package/dist/core/routesV3.builder.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { AnyLeafLowProfile, Append, HttpMethod, Leaf, Merge, MergeArray, MethodCfg, NodeCfg, Prettify, RouteSchema } from './routesV3.core';
+import { AnyLeafLowProfile, Append, AugmentLeaves, HttpMethod, Leaf, LowProfileCfg, Merge, MergeArray, MethodCfg, NodeCfg, Prettify } from './routesV3.core';
 declare const paginationQueryShape: {
     pagination_cursor: z.ZodOptional<z.ZodString>;
     pagination_limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -53,71 +53,56 @@ type ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny
 };
 type EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS> : FeedField<C> & NonFeedQueryField<C> & NonFeedOutputField<C> & ParamsField<C, PS>;
 type EffectiveCfg<C extends MethodCfg, PS> = Prettify<Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>>;
-type ToRouteSchema<S> = S extends ZodTypeAny ? RouteSchema<z.output<S>> : S;
-type LowProfileCfg<Cfg extends MethodCfg> = Prettify<Omit<Cfg, 'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'> & {
-    bodySchema: ToRouteSchema<Cfg['bodySchema']>;
-    querySchema: ToRouteSchema<Cfg['querySchema']>;
-    paramsSchema: ToRouteSchema<Cfg['paramsSchema']>;
-    outputSchema: ToRouteSchema<Cfg['outputSchema']>;
-}>;
 type BuiltLeaf<M extends HttpMethod, Base extends string, I extends NodeCfg, C extends MethodCfg, PS> = Leaf<M, Base, Merge<I, LowProfileCfg<EffectiveCfg<C, PS>>>>;
-/** Builder surface used by `resource(...)` to accumulate leaves. */
-export interface Branch<Base extends string, Acc extends readonly AnyLeafLowProfile[], I extends NodeCfg, PS extends ZodTypeAny | undefined> {
-    /**
-     * Enter or define a static child segment.
-     * Optionally accepts extra config and/or a builder to populate nested routes.
-     * @param name Child segment literal (no leading slash).
-     * @param cfg Optional node configuration to merge for descendants.
-     * @param builder Callback to produce leaves for the child branch.
-     */
-    sub<Name extends string, J extends NodeCfg>(name: Name, cfg?: J): Branch<`${Base}/${Name}`, Acc, Merge<I, NonNullable<J>>, PS>;
-    sub<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeafLowProfile[]>(name: Name, cfg: J, builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;
-    sub<Name extends string, R extends readonly AnyLeafLowProfile[]>(name: Name, builder: (r: Branch<`${Base}/${Name}`, readonly [], I, PS>) => R): Branch<Base, MergeArray<Acc, R>, I, PS>;
-    /**
-     * Introduce a `:param` segment and merge its schema into downstream leaves.
-     * @param name Parameter key (without leading colon).
-     * @param paramsSchema Zod schema for the parameter value.
-     * @param builder Callback that produces leaves beneath the parameterized segment.
-     */
-    routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeafLowProfile[]>(name: Name, paramsSchema: P, builder: (r: Branch<`${Base}/:${Name}`, readonly [], I, MergedParamsResult<PS, Name, P>>) => R): Branch<Base, MergeArray<Acc, R>, I, MergedParamsResult<PS, Name, P>>;
-    /**
-     * Merge additional node configuration that subsequent leaves will inherit.
-     * @param cfg Partial node configuration.
-     */
-    with<J extends NodeCfg>(cfg: J): Branch<Base, Acc, Merge<I, J>, PS>;
+type MethodFns<Base extends string, Acc extends readonly AnyLeafLowProfile[], I extends NodeCfg, PS extends ZodTypeAny | undefined, Used extends HttpMethod> = {
     /**
      * Register a GET leaf at the current path.
-     * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    get<C extends MethodCfg>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>, I, PS>;
+    get: 'get' extends Used ? never : <C extends MethodCfg>(cfg: C) => Branch<Base, Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>, I, PS, Used | 'get'>;
     /**
      * Register a POST leaf at the current path.
-     * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    post<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'post', Base, I, Merge<C, {
+    post: 'post' extends Used ? never : <C extends Omit<MethodCfg, 'feed'>>(cfg: C) => Branch<Base, Append<Acc, Prettify<BuiltLeaf<'post', Base, I, Merge<C, {
         feed: false;
-    }>, PS>>>, I, PS>;
+    }>, PS>>>, I, PS, Used | 'post'>;
     /**
      * Register a PUT leaf at the current path.
-     * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    put<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'put', Base, I, Merge<C, {
+    put: 'put' extends Used ? never : <C extends Omit<MethodCfg, 'feed'>>(cfg: C) => Branch<Base, Append<Acc, Prettify<BuiltLeaf<'put', Base, I, Merge<C, {
         feed: false;
-    }>, PS>>>, I, PS>;
+    }>, PS>>>, I, PS, Used | 'put'>;
     /**
      * Register a PATCH leaf at the current path.
-     * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'patch', Base, I, Merge<C, {
+    patch: 'patch' extends Used ? never : <C extends Omit<MethodCfg, 'feed'>>(cfg: C) => Branch<Base, Append<Acc, Prettify<BuiltLeaf<'patch', Base, I, Merge<C, {
         feed: false;
-    }>, PS>>>, I, PS>;
+    }>, PS>>>, I, PS, Used | 'patch'>;
     /**
      * Register a DELETE leaf at the current path.
-     * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'delete', Base, I, Merge<C, {
+    delete: 'delete' extends Used ? never : <C extends Omit<MethodCfg, 'feed'>>(cfg: C) => Branch<Base, Append<Acc, Prettify<BuiltLeaf<'delete', Base, I, Merge<C, {
         feed: false;
-    }>, PS>>>, I, PS>;
+    }>, PS>>>, I, PS, Used | 'delete'>;
+};
+/** Builder surface used by `resource(...)` to accumulate leaves. */
+export interface Branch<Base extends string, Acc extends readonly AnyLeafLowProfile[], I extends NodeCfg, PS extends ZodTypeAny | undefined, Used extends HttpMethod = never> extends MethodFns<Base, Acc, I, PS, Used> {
+    /**
+     * Mount a static subtree under `name`.
+     * The `leaves` are built externally via `resource(...)` and will be
+     * rebased so that their paths become `${Base}/${name}${leaf.path}` and their
+     * paramsSchemas are merged with the parameters already accumulated on this branch.
+     */
+    sub<Name extends string, R extends readonly AnyLeafLowProfile[]>(name: Name, leaves: R): Branch<Base, MergeArray<Acc, AugmentLeaves<`${Base}/${Name}`, PS, R>>, I, PS, Used>;
+    /**
+     * Mount a static subtree under `name` and merge extra node-level config.
+     */
+    sub<Name extends string, J extends NodeCfg, R extends readonly AnyLeafLowProfile[]>(name: Name, cfg: J, leaves: R): Branch<Base, MergeArray<Acc, AugmentLeaves<`${Base}/${Name}`, PS, R>>, Merge<I, J>, PS, Used>;
+    /**
+     * Introduce a `:param` segment and mount a pre-built subtree beneath it.
+     * The subtree paths are rebased to `${Base}/:${Name}${leaf.path}` and
+     * their paramsSchemas are intersected with the accumulated params plus this new param.
+     */
+    routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeafLowProfile[]>(name: Name, paramsSchema: P, leaves: R): Branch<Base, MergeArray<Acc, AugmentLeaves<`${Base}/:${Name}`, MergedParamsResult<PS, Name, P>, R>>, I, PS, Used>;
     /**
      * Finish the branch and return the collected leaves.
      * @returns Readonly tuple of accumulated leaves.
@@ -130,7 +115,7 @@ export interface Branch<Base extends string, Acc extends readonly AnyLeafLowProf
  * @param inherited Optional node configuration applied to all descendants.
  * @returns Root `Branch` instance used to compose the route tree.
  */
-export declare function resource<Base extends string, I extends NodeCfg = {}>(base: Base, inherited?: I): Branch<Base, readonly [], I, undefined>;
+export declare function resource<Base extends string = '', I extends NodeCfg = {}>(base?: Base, inherited?: I): Branch<Base, readonly [], I, undefined>;
 /**
  * Merge two readonly tuples (preserves literal tuple information).
  * @param arr1 First tuple.

package/dist/core/routesV3.core.d.ts

@@ -20,13 +20,20 @@ export type RouteSchemaOutput<Schema extends ZodType> = Schema extends {
     __out: infer Out;
 } ? Out : z.output<Schema>;
 export declare const lowProfileParse: <T extends RouteSchema>(schema: T, data: unknown) => RouteSchemaOutput<T>;
+export type ToRouteSchema<S> = S extends ZodType ? RouteSchema<z.output<S>> : S;
+export type LowProfileCfg<Cfg extends MethodCfg> = Prettify<Omit<Cfg, 'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'> & {
+    bodySchema: ToRouteSchema<Cfg['bodySchema']>;
+    querySchema: ToRouteSchema<Cfg['querySchema']>;
+    paramsSchema: ToRouteSchema<Cfg['paramsSchema']>;
+    outputSchema: ToRouteSchema<Cfg['outputSchema']>;
+}>;
 /** Per-method configuration merged with inherited node config. */
 export type MethodCfg = {
     /** Zod schema describing the request body. */
     bodySchema?: ZodType;
     /** Zod schema describing the query string. */
     querySchema?: ZodType;
-    /** Zod schema describing path params (overrides inferred params). */
+    /** Zod schema describing path params (Internal only, set through sub and routeParameter). */
     paramsSchema?: ZodType;
     /** Zod schema describing the response payload. */
     outputSchema?: ZodType;
@@ -88,6 +95,13 @@ export type Merge<A, B> = Prettify<Omit<A, keyof B> & B>;
 export type Append<T extends readonly unknown[], X> = [...T, X];
 /** Concatenate two readonly tuple types. */
 export type MergeArray<A extends readonly unknown[], B extends readonly unknown[]> = [...A, ...B];
+export type IntersectZod<A extends ZodType | undefined, B extends ZodType | undefined> = B extends ZodType ? A extends ZodType ? z.ZodIntersection<A, B> : B : A extends ZodType ? A : undefined;
+type RouteSchemaFromZod<T extends ZodType | undefined> = T extends ZodType ? RouteSchema<z.output<T>> : undefined;
+type MergeRouteSchemas<Existing extends RouteSchema | undefined, Parent extends ZodType | undefined> = Existing extends RouteSchema<infer ExistingOut> ? Parent extends ZodType ? RouteSchema<ExistingOut & z.output<Parent>> : Existing : Parent extends ZodType ? RouteSchemaFromZod<Parent> : undefined;
+type AugmentedCfg<Cfg extends MethodCfgLowProfile, Param extends ZodType | undefined> = Prettify<Omit<Cfg, 'paramsSchema'> & {
+    paramsSchema: MergeRouteSchemas<Cfg['paramsSchema'], Param>;
+}>;
+export type AugmentLeaves<P extends string, Param extends ZodType | undefined, R extends readonly LeafLowProfile[], Acc extends readonly LeafLowProfile[] = []> = R extends readonly [infer First, ...infer Rest] ? First extends LeafLowProfile ? AugmentLeaves<P, Param, Rest extends readonly LeafLowProfile[] ? Rest : [], Append<Acc, LeafLowProfile<First['method'], `${P}${First['path']}`, AugmentedCfg<First['cfg'], Param>>>> : never : Acc;
 type SegmentParams<S extends string> = S extends `:${infer P}` ? P : never;
 type Split<S extends string> = S extends '' ? [] : S extends `${infer A}/${infer B}` ? [A, ...Split<B>] : [S];
 type ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>;
@@ -132,7 +146,7 @@ export declare function buildLowProfileLeaf<const M extends HttpMethod, const Pa
     paramsSchema: P extends ZodType ? RouteSchema<z.infer<P>> : undefined;
     outputSchema: O extends ZodType ? RouteSchema<z.infer<O>> : undefined;
 }>>;
-export type LeafLowProfile<M extends HttpMethod, P extends string, C extends MethodCfgLowProfile> = {
+export type LeafLowProfile<M extends HttpMethod = HttpMethod, P extends string = string, C extends MethodCfgLowProfile = MethodCfgLowProfile> = {
     /** Lowercase HTTP method (get/post/...). */
     readonly method: M;
     /** Concrete path for the route (e.g. `/v1/users/:userId`). */

package/dist/index.cjs

@@ -114,7 +114,7 @@ function mergeSchemas(a, b) {
   return a ?? b;
 }
 function resource(base, inherited) {
-  const rootBase = base;
+  const rootBase = base ?? "";
   const rootInherited = { ...inherited };
   function makeBranch(base2, inherited2, mergedParamsSchema) {
     const stack = [];
@@ -146,47 +146,90 @@ function resource(base, inherited) {
       return api;
     }
     const api = {
-      // compose a plain subpath (optional cfg) with optional builder
-      sub(name, cfgOrBuilder, maybeBuilder) {
+      /**
+       * Mount a subtree built elsewhere.
+       *
+       * Usage:
+       *   const users = resource('').get(...).done()
+       *   resource('/api').sub('users', users).done()
+       */
+      sub(name, cfgOrLeaves, maybeLeaves) {
         let cfg;
-        let builder;
-        if (typeof cfgOrBuilder === "function") {
-          builder = cfgOrBuilder;
+        let leaves;
+        if (Array.isArray(cfgOrLeaves)) {
+          leaves = cfgOrLeaves;
         } else {
-          cfg = cfgOrBuilder;
-          builder = maybeBuilder;
+          cfg = cfgOrLeaves;
+          leaves = maybeLeaves;
         }
-        const childBase = `${currentBase}/${name}`;
-        const childInherited = { ...inheritedCfg, ...cfg ?? {} };
-        if (builder) {
-          const child = makeBranch(
-            childBase,
-            childInherited,
-            currentParamsSchema
+        if (!leaves) {
+          throw new Error("sub() expects a leaves array as the last argument");
+        }
+        const childInherited = {
+          ...inheritedCfg,
+          ...cfg ?? {}
+        };
+        const baseForChildren = `${currentBase}/${name}`;
+        for (const leafLow of leaves) {
+          const leaf = leafLow;
+          const leafCfg = leaf.cfg;
+          const leafParams = leafCfg.paramsSchema;
+          const effectiveParams = mergeSchemas(
+            currentParamsSchema,
+            leafParams
           );
-          const leaves = builder(child);
-          for (const l of leaves) stack.push(l);
-          return api;
-        } else {
-          currentBase = childBase;
-          inheritedCfg = childInherited;
-          return api;
+          const newCfg = {
+            ...childInherited,
+            ...leafCfg
+          };
+          if (effectiveParams) {
+            newCfg.paramsSchema = effectiveParams;
+          } else if ("paramsSchema" in newCfg) {
+            delete newCfg.paramsSchema;
+          }
+          const newLeaf = {
+            method: leaf.method,
+            path: `${baseForChildren}${leaf.path}`,
+            cfg: newCfg
+          };
+          stack.push(newLeaf);
         }
+        return api;
       },
-      // the single param function: name + schema + builder
-      routeParameter(name, paramsSchema, builder) {
-        const childBase = `${currentBase}/:${name}`;
+      /**
+       * Introduce a :param segment and mount a subtree under it.
+       *
+       * The subtree is built independently (e.g. resource('').get(...).done())
+       * and its paths become `${currentBase}/:${name}${leaf.path}`.
+       * Params schemas are intersected with the accumulated params plus the new param.
+       */
+      routeParameter(name, paramsSchema, leaves) {
         const paramObj = import_zod.z.object({
           [name]: paramsSchema
         });
-        const childParams = currentParamsSchema ? mergeSchemas(currentParamsSchema, paramObj) : paramObj;
-        const child = makeBranch(childBase, inheritedCfg, childParams);
-        const leaves = builder(child);
-        for (const l of leaves) stack.push(l);
-        return api;
-      },
-      with(cfg) {
-        inheritedCfg = { ...inheritedCfg, ...cfg };
+        const mergedParams = currentParamsSchema ? mergeSchemas(currentParamsSchema, paramObj) : paramObj;
+        const baseForChildren = `${currentBase}/:${name}`;
+        for (const leafLow of leaves) {
+          const leaf = leafLow;
+          const leafCfg = leaf.cfg;
+          const leafParams = leafCfg.paramsSchema;
+          const effectiveParams = mergeSchemas(mergedParams, leafParams);
+          const newCfg = {
+            ...inheritedCfg,
+            ...leafCfg
+          };
+          if (effectiveParams) {
+            newCfg.paramsSchema = effectiveParams;
+          } else if ("paramsSchema" in newCfg) {
+            delete newCfg.paramsSchema;
+          }
+          const newLeaf = {
+            method: leaf.method,
+            path: `${baseForChildren}${leaf.path}`,
+            cfg: newCfg
+          };
+          stack.push(newLeaf);
+        }
         return api;
       },
       // methods (inject current params schema if missing)

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/sockets/socket.index.ts"],"sourcesContent":["export * from './core/routesV3.builder'\nexport * from './core/routesV3.core'\nexport * from './core/routesV3.finalize'\nexport * from './sockets/socket.index'\n","import { z } from 'zod'\nimport {\n  AnyLeaf,\n  AnyLeafLowProfile,\n  Append,\n  HttpMethod,\n  Leaf,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n  RouteSchema,\n} from './routesV3.core'\n\nconst paginationQueryShape = {\n  pagination_cursor: z.string().optional(),\n  pagination_limit: z.coerce.number().min(1).max(100).default(20),\n}\n\nconst defaultFeedQuerySchema = z.object(paginationQueryShape)\ntype PaginationShape = typeof paginationQueryShape\n\ntype ZodTypeAny = z.ZodTypeAny\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{\n  [K in Name]: S\n}>\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>\ntype ZodObjectAny = z.ZodObject<any>\ntype AnyZodObject = z.ZodObject<any>\ntype MergedParamsResult<\n  PS,\n  Name extends string,\n  P extends ZodTypeAny,\n> = PS extends ZodTypeAny\n  ? z.ZodIntersection<PS, ParamZod<Name, P>>\n  : ParamZod<Name, P>\n\nfunction getZodShape(schema: ZodObjectAny) {\n  const shapeOrGetter = (schema as any).shape\n    ? (schema as any).shape\n    : (schema as any)._def?.shape?.()\n  if (!shapeOrGetter) return {}\n  return typeof shapeOrGetter === 'function'\n    ? shapeOrGetter.call(schema)\n    : shapeOrGetter\n}\n\nfunction collectNestedFieldSuggestions(\n  shape: Record<string, ZodTypeAny> | undefined,\n  prefix: string[] = [],\n): string[] {\n  if (!shape) return []\n  const suggestions: string[] = []\n  for (const [key, value] of Object.entries(shape)) {\n    if (value instanceof z.ZodObject) {\n      const nestedShape = getZodShape(value as ZodObjectAny)\n      const nestedSuggestions = collectNestedFieldSuggestions(nestedShape, [\n        ...prefix,\n        key,\n      ])\n      suggestions.push(\n        ...(nestedSuggestions.length\n          ? nestedSuggestions\n          : [[...prefix, key].join('_')]),\n      )\n    } else if (prefix.length > 0) {\n      suggestions.push([...prefix, key].join('_'))\n    }\n  }\n  return suggestions\n}\n\nconst defaultFeedOutputSchema = z.object({\n  items: z.array(z.unknown()),\n  nextCursor: z.string().optional(),\n})\n\nfunction augmentFeedQuerySchema<Q extends ZodTypeAny | undefined>(schema: Q) {\n  if (schema && !(schema instanceof z.ZodObject)) {\n    console.warn(\n      'Feed queries must be a ZodObject; default pagination applied.',\n    )\n    return defaultFeedQuerySchema\n  }\n\n  const base = (schema as ZodObjectAny) ?? z.object({})\n  const shape = getZodShape(base)\n  const nestedSuggestions = collectNestedFieldSuggestions(shape)\n  if (nestedSuggestions.length) {\n    console.warn(\n      `Feed query schemas should avoid nested objects; consider flattening fields like: ${nestedSuggestions.join(\n        ', ',\n      )}`,\n    )\n  }\n  return base.extend(paginationQueryShape)\n}\n\nfunction augmentFeedOutputSchema<O extends ZodTypeAny | undefined>(schema: O) {\n  if (!schema) return defaultFeedOutputSchema\n  if (schema instanceof z.ZodArray) {\n    return z.object({\n      items: schema,\n      nextCursor: z.string().optional(),\n    })\n  }\n  if (schema instanceof z.ZodObject) {\n    const shape = (schema as any).shape\n      ? (schema as any).shape\n      : (schema as any)._def?.shape?.()\n    const hasItems = Boolean(shape?.items)\n    if (hasItems) {\n      return schema.extend({ nextCursor: z.string().optional() })\n    }\n    return z.object({\n      items: z.array(schema as ZodTypeAny),\n      nextCursor: z.string().optional(),\n    })\n  }\n  return z.object({\n    items: z.array(schema as ZodTypeAny),\n    nextCursor: z.string().optional(),\n  })\n}\n\n/**\n * Runtime helper that mirrors the typed merge used by the builder.\n * @param a Previously merged params schema inherited from parent segments.\n * @param b Newly introduced params schema.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nfunction mergeSchemas<A extends ZodTypeAny, B extends ZodTypeAny>(\n  a: A,\n  b: B,\n): ZodTypeAny\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B\nfunction mergeSchemas(\n  a: ZodTypeAny | undefined,\n  b: ZodTypeAny | undefined,\n): ZodTypeAny | undefined\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined) {\n  if (a && b) return z.intersection(a as any, b as any)\n  return (a ?? b) as ZodTypeAny | undefined\n}\n\ntype FeedOutputSchema<C extends MethodCfg> =\n  C['outputSchema'] extends ZodArrayAny\n    ? z.ZodObject<{\n        items: C['outputSchema']\n        nextCursor: z.ZodOptional<z.ZodString>\n      }>\n    : C['outputSchema'] extends ZodTypeAny\n    ? z.ZodObject<{\n        items: z.ZodArray<C['outputSchema']>\n        nextCursor: z.ZodOptional<z.ZodString>\n      }>\n    : typeof defaultFeedOutputSchema\n\ntype BaseMethodCfg<C extends MethodCfg> = Merge<\n  Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>,\n  Omit<C, 'querySchema' | 'outputSchema' | 'feed'>\n>\n\ntype FeedField<C extends MethodCfg> = C['feed'] extends true\n  ? { feed: true }\n  : { feed?: boolean }\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> =\n  Q extends z.ZodObject<infer Shape>\n    ? z.ZodObject<Shape & PaginationShape>\n    : z.ZodObject<PaginationShape>\n\ntype FeedQueryField<C extends MethodCfg> = {\n  querySchema: AddPaginationToQuery<\n    C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined\n  >\n}\n\ntype NonFeedQueryField<C extends MethodCfg> =\n  C['querySchema'] extends ZodTypeAny\n    ? { querySchema: C['querySchema'] }\n    : { querySchema?: undefined }\n\ntype FeedOutputField<C extends MethodCfg> = {\n  outputSchema: FeedOutputSchema<C>\n}\n\ntype NonFeedOutputField<C extends MethodCfg> =\n  C['outputSchema'] extends ZodTypeAny\n    ? { outputSchema: C['outputSchema'] }\n    : { outputSchema?: undefined }\n\ntype ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny\n  ? { paramsSchema: C['paramsSchema'] }\n  : { paramsSchema: PS }\n\ntype EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true\n  ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS>\n  : FeedField<C> &\n      NonFeedQueryField<C> &\n      NonFeedOutputField<C> &\n      ParamsField<C, PS>\n\ntype EffectiveCfg<C extends MethodCfg, PS> = Prettify<\n  Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>\n>\n\ntype ToRouteSchema<S> = S extends ZodTypeAny ? RouteSchema<z.output<S>> : S\n\ntype LowProfileCfg<Cfg extends MethodCfg> = Prettify<\n  Omit<Cfg, 'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'> & {\n    bodySchema: ToRouteSchema<Cfg['bodySchema']>\n    querySchema: ToRouteSchema<Cfg['querySchema']>\n    paramsSchema: ToRouteSchema<Cfg['paramsSchema']>\n    outputSchema: ToRouteSchema<Cfg['outputSchema']>\n  }\n>\n\ntype BuiltLeaf<\n  M extends HttpMethod,\n  Base extends string,\n  I extends NodeCfg,\n  C extends MethodCfg,\n  PS,\n> = Leaf<M, Base, Merge<I, LowProfileCfg<EffectiveCfg<C, PS>>>>\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeafLowProfile[],\n  I extends NodeCfg,\n  PS extends ZodTypeAny | undefined,\n> {\n  // --- structure ---\n  /**\n   * Enter or define a static child segment.\n   * Optionally accepts extra config and/or a builder to populate nested routes.\n   * @param name Child segment literal (no leading slash).\n   * @param cfg Optional node configuration to merge for descendants.\n   * @param builder Callback to produce leaves for the child branch.\n   */\n  sub<Name extends string, J extends NodeCfg>(\n    name: Name,\n    cfg?: J,\n  ): Branch<`${Base}/${Name}`, Acc, Merge<I, NonNullable<J>>, PS>\n\n  sub<\n    Name extends string,\n    J extends NodeCfg | undefined,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    cfg: J,\n    builder: (\n      r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>,\n    ) => R,\n  ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>\n\n  sub<Name extends string, R extends readonly AnyLeafLowProfile[]>(\n    name: Name,\n    builder: (r: Branch<`${Base}/${Name}`, readonly [], I, PS>) => R,\n  ): Branch<Base, MergeArray<Acc, R>, I, PS>\n\n  // --- parameterized segment (single signature) ---\n  /**\n   * Introduce a `:param` segment and merge its schema into downstream leaves.\n   * @param name Parameter key (without leading colon).\n   * @param paramsSchema Zod schema for the parameter value.\n   * @param builder Callback that produces leaves beneath the parameterized segment.\n   */\n  routeParameter<\n    Name extends string,\n    P extends ZodTypeAny,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    paramsSchema: P,\n    builder: (\n      r: Branch<\n        `${Base}/:${Name}`,\n        readonly [],\n        I,\n        MergedParamsResult<PS, Name, P>\n      >,\n    ) => R,\n  ): Branch<Base, MergeArray<Acc, R>, I, MergedParamsResult<PS, Name, P>>\n\n  // --- flags inheritance ---\n  /**\n   * Merge additional node configuration that subsequent leaves will inherit.\n   * @param cfg Partial node configuration.\n   */\n  with<J extends NodeCfg>(cfg: J): Branch<Base, Acc, Merge<I, J>, PS>\n\n  // --- methods (return Branch to keep chaining) ---\n  /**\n   * Register a GET leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  get<C extends MethodCfg>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>,\n    I,\n    PS\n  >\n\n  /**\n   * Register a POST leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  post<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'post', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  /**\n   * Register a PUT leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  put<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'put', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  /**\n   * Register a PATCH leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  patch<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'patch', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  /**\n   * Register a DELETE leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  delete<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'delete', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  // --- finalize this subtree ---\n  /**\n   * Finish the branch and return the collected leaves.\n   * @returns Readonly tuple of accumulated leaves.\n   */\n  done(): Readonly<Acc>\n}\n\n/**\n * Start building a resource at the given base path.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Optional node configuration applied to all descendants.\n * @returns Root `Branch` instance used to compose the route tree.\n */\nexport function resource<Base extends string, I extends NodeCfg = {}>(\n  base: Base,\n  inherited?: I,\n): Branch<Base, readonly [], I, undefined> {\n  const rootBase = base\n  const rootInherited: NodeCfg = { ...(inherited as NodeCfg) }\n\n  function makeBranch<\n    Base2 extends string,\n    I2 extends NodeCfg,\n    PS2 extends ZodTypeAny | undefined,\n  >(base2: Base2, inherited2: I2, mergedParamsSchema?: PS2) {\n    const stack: AnyLeaf[] = []\n    let currentBase: string = base2\n    let inheritedCfg: NodeCfg = { ...(inherited2 as NodeCfg) }\n    let currentParamsSchema: PS2 = mergedParamsSchema as PS2\n\n    function add<M extends HttpMethod, C extends MethodCfg>(method: M, cfg: C) {\n      // If the method didn’t provide a paramsSchema, inject the active merged one.\n      const effectiveParamsSchema = (cfg.paramsSchema ??\n        currentParamsSchema) as PS2 | undefined\n      const effectiveQuerySchema =\n        cfg.feed === true\n          ? augmentFeedQuerySchema(cfg.querySchema)\n          : cfg.querySchema\n      const effectiveOutputSchema =\n        cfg.feed === true\n          ? augmentFeedOutputSchema(cfg.outputSchema)\n          : cfg.outputSchema\n\n      const fullCfg = (\n        effectiveParamsSchema\n          ? {\n              ...inheritedCfg,\n              ...cfg,\n              paramsSchema: effectiveParamsSchema,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n          : {\n              ...inheritedCfg,\n              ...cfg,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n      ) as any\n\n      const leaf = {\n        method,\n        path: currentBase as Base2,\n        cfg: fullCfg,\n      } as const\n\n      stack.push(leaf as unknown as AnyLeaf)\n\n      // Return same runtime obj, but with Acc including this new leaf\n      return api as unknown as Branch<\n        Base2,\n        Append<readonly [], typeof leaf>,\n        I2,\n        PS2\n      >\n    }\n\n    const api: any = {\n      // compose a plain subpath (optional cfg) with optional builder\n      sub<Name extends string, J extends NodeCfg | undefined = undefined>(\n        name: Name,\n        cfgOrBuilder?: J | ((r: any) => readonly AnyLeafLowProfile[]),\n        maybeBuilder?: (r: any) => readonly AnyLeafLowProfile[],\n      ) {\n        let cfg: NodeCfg | undefined\n        let builder: ((r: any) => readonly AnyLeafLowProfile[]) | undefined\n\n        if (typeof cfgOrBuilder === 'function') {\n          builder = cfgOrBuilder as any\n        } else {\n          cfg = cfgOrBuilder as NodeCfg | undefined\n          builder = maybeBuilder\n        }\n\n        const childBase = `${currentBase}/${name}` as const\n        const childInherited = { ...inheritedCfg, ...(cfg ?? {}) } as Merge<\n          I2,\n          NonNullable<J>\n        >\n\n        if (builder) {\n          // params schema PS2 flows through unchanged on plain sub\n          const child = makeBranch(\n            childBase,\n            childInherited,\n            currentParamsSchema,\n          )\n          const leaves = builder(child) //as readonly AnyLeafLowProfile[]\n          for (const l of leaves) stack.push(l)\n          return api as Branch<\n            Base2,\n            Append<readonly [], (typeof leaves)[number]>,\n            typeof childInherited,\n            PS2\n          >\n        } else {\n          currentBase = childBase\n          inheritedCfg = childInherited\n          return api as Branch<\n            `${Base2}/${Name}`,\n            readonly [],\n            typeof childInherited,\n            PS2\n          >\n        }\n      },\n\n      // the single param function: name + schema + builder\n      routeParameter<\n        Name extends string,\n        P extends ZodTypeAny,\n        R extends readonly AnyLeafLowProfile[],\n      >(\n        name: Name,\n        paramsSchema: P,\n        builder: (\n          r: Branch<\n            `${Base2}/:${Name}`,\n            readonly [],\n            I2,\n            MergedParamsResult<PS2, Name, P>\n          >,\n        ) => R,\n      ) {\n        const childBase = `${currentBase}/:${name}` as const\n        // Wrap the value schema under the param name before merging with inherited params schema\n        const paramObj: ParamZod<Name, P> = z.object({\n          [name]: paramsSchema,\n        } as Record<Name, P>)\n        const childParams = (\n          currentParamsSchema\n            ? mergeSchemas(currentParamsSchema, paramObj)\n            : paramObj\n        ) as MergedParamsResult<PS2, Name, P>\n        const child = makeBranch(childBase, inheritedCfg as I2, childParams)\n        const leaves = builder(child)\n        for (const l of leaves) stack.push(l)\n        return api as Branch<\n          Base2,\n          Append<readonly [], (typeof leaves)[number]>,\n          I2,\n          MergedParamsResult<PS2, Name, P>\n        >\n      },\n\n      with<J extends NodeCfg>(cfg: J) {\n        inheritedCfg = { ...inheritedCfg, ...cfg }\n        return api as Branch<Base2, readonly [], Merge<I2, J>, PS2>\n      },\n\n      // methods (inject current params schema if missing)\n      get<C extends MethodCfg>(cfg: C) {\n        return add('get', cfg)\n      },\n      post<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('post', { ...cfg, feed: false })\n      },\n      put<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('put', { ...cfg, feed: false })\n      },\n      patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('patch', { ...cfg, feed: false })\n      },\n      delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('delete', { ...cfg, feed: false })\n      },\n\n      done() {\n        return stack\n      },\n    }\n\n    return api as Branch<Base2, readonly [], I2, PS2>\n  }\n\n  // Root branch starts with no params schema (PS = undefined)\n  return makeBranch(rootBase, rootInherited, undefined)\n}\n\n/**\n * Merge two readonly tuples (preserves literal tuple information).\n * @param arr1 First tuple.\n * @param arr2 Second tuple.\n * @returns New tuple containing values from both inputs.\n */\nexport const mergeArrays = <T extends readonly any[], S extends readonly any[]>(\n  arr1: T,\n  arr2: S,\n) => {\n  return [...arr1, ...arr2] as [...T, ...S]\n}\n","import { z, ZodType } from 'zod'\n\n/** Supported HTTP verbs for the routes DSL. */\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete'\n\n/** Declarative description of a multipart upload field. */\nexport type FileField = {\n  /** Form field name used for uploads. */\n  name: string\n  /** Maximum number of files accepted for this field. */\n  maxCount: number\n}\n\n/** Configuration that applies to an entire branch of the route tree. */\nexport type NodeCfg = {\n  /** @deprecated. Does nothing. */\n  authenticated?: boolean\n}\n\nexport type RouteSchema<Output = unknown> = ZodType & {\n  __out: Output\n}\n\nexport type RouteSchemaOutput<Schema extends ZodType> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport const lowProfileParse = <T extends RouteSchema>(\n  schema: T,\n  data: unknown,\n): RouteSchemaOutput<T> => {\n  return schema.parse(data) as RouteSchemaOutput<T>\n}\n\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg = {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodType\n  /** Zod schema describing the query string. */\n  querySchema?: ZodType\n  /** Zod schema describing path params (overrides inferred params). */\n  paramsSchema?: ZodType\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodType\n  /** Multipart upload definitions for the route. */\n  bodyFiles?: FileField[]\n  /** Marks the route as an infinite feed (enables cursor helpers). */\n  feed?: boolean\n\n  /** Optional human-readable description for docs/debugging. */\n  description?: string\n  /**\n   * Short one-line summary for docs list views.\n   * Shown in navigation / tables instead of the full description.\n   */\n  summary?: string\n  /**\n   * Group name used for navigation sections in docs UIs.\n   * e.g. \"Users\", \"Billing\", \"Auth\".\n   */\n  docsGroup?: string\n  /**\n   * Tags that can be used to filter / facet in interactive docs.\n   * e.g. [\"users\", \"admin\", \"internal\"].\n   */\n  tags?: string[]\n  /**\n   * Mark the route as deprecated in docs.\n   * Renderers can badge this and/or hide by default.\n   */\n  deprecated?: boolean\n  /**\n   * Optional stability information for the route.\n   * Renderers can surface this prominently.\n   */\n  stability?: 'experimental' | 'beta' | 'stable' | 'deprecated'\n  /**\n   * Hide this route from public docs while keeping it usable in code.\n   */\n  docsHidden?: boolean\n  /**\n   * Arbitrary extra metadata for docs renderers.\n   * Can be used for auth requirements, rate limits, feature flags, etc.\n   */\n  docsMeta?: Record<string, unknown>\n}\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<\n  M extends HttpMethod,\n  P extends string,\n  C extends MethodCfg,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n\n/** Convenience union covering all generated leaves. */\nexport type AnyLeaf = Leaf<HttpMethod, string, MethodCfg>\n\n/** Merge two object types while keeping nice IntelliSense output. */\nexport type Merge<A, B> = Prettify<Omit<A, keyof B> & B>\n\n/** Append a new element to a readonly tuple type. */\nexport type Append<T extends readonly unknown[], X> = [...T, X]\n\n/** Concatenate two readonly tuple types. */\nexport type MergeArray<\n  A extends readonly unknown[],\n  B extends readonly unknown[],\n> = [...A, ...B]\n\n// helpers (optional)\ntype SegmentParams<S extends string> = S extends `:${infer P}` ? P : never\ntype Split<S extends string> = S extends ''\n  ? []\n  : S extends `${infer A}/${infer B}`\n  ? [A, ...Split<B>]\n  : [S]\ntype ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>\n\n/** Derive a params object type from a literal route string. */\nexport type ExtractParamsFromPath<Path extends string> =\n  ExtractParamNames<Path> extends never\n    ? never\n    : Record<ExtractParamNames<Path>, string | number>\n\n/**\n * Interpolate `:params` in a path using the given values.\n * @param path Literal route string containing `:param` segments.\n * @param params Object of parameter values to interpolate.\n * @returns Path string with parameters substituted.\n */\nexport function compilePath<Path extends string>(\n  path: Path,\n  params: ExtractParamsFromPath<Path>,\n) {\n  if (!params) return path\n  return path.replace(/:([A-Za-z0-9_]+)/g, (_, k) => {\n    const v = (params as any)[k]\n    if (v === undefined || v === null) throw new Error(`Missing param :${k}`)\n    return String(v)\n  })\n}\n\n/**\n * Build a deterministic cache key for the given leaf.\n * The key matches the shape consumed by React Query helpers.\n * @param args.leaf Leaf describing the endpoint.\n * @param args.params Optional params used to build the path.\n * @param args.query Optional query payload.\n * @returns Tuple suitable for React Query cache keys.\n */\ntype SplitPath<P extends string> = P extends ''\n  ? []\n  : P extends `${infer A}/${infer B}`\n  ? [A, ...SplitPath<B>]\n  : [P]\nexport function buildCacheKey<L extends AnyLeaf>(args: {\n  leaf: L\n  params?: ExtractParamsFromPath<L['path']>\n  query?: InferQuery<L>\n}) {\n  let p = args.leaf.path\n  if (args.params) {\n    p = compilePath<L['path']>(p, args.params)\n  }\n  return [\n    args.leaf.method,\n    ...(p.split('/').filter(Boolean) as SplitPath<typeof p>),\n    args.query ?? {},\n  ] as const\n}\n\n/** Definition-time method config (for clarity). */\nexport type MethodCfgDef = MethodCfg\n\n/** Low-profile method config where schemas carry a phantom __out like SocketSchema. */\nexport type MethodCfgLowProfile = Omit<\n  MethodCfg,\n  'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n> & {\n  bodySchema?: RouteSchema\n  querySchema?: RouteSchema\n  paramsSchema?: RouteSchema\n  outputSchema?: RouteSchema\n}\nexport type AnyLeafLowProfile = LeafLowProfile<\n  HttpMethod,\n  string,\n  MethodCfgLowProfile\n>\n\nexport function buildLowProfileLeaf<\n  const M extends HttpMethod,\n  const Path extends string,\n  const O extends ZodType | undefined = undefined,\n  const P extends ZodType | undefined = undefined,\n  const Q extends ZodType | undefined = undefined,\n  const B extends ZodType | undefined = undefined,\n  const Feed extends boolean = false,\n>(leaf: {\n  method: M\n  path: Path\n  cfg: Omit<\n    MethodCfg,\n    'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n  > & {\n    feed?: Feed\n    bodySchema?: B\n    querySchema?: Q\n    paramsSchema?: P\n    outputSchema?: O\n  }\n}): LeafLowProfile<\n  M,\n  Path,\n  Prettify<\n    Omit<\n      MethodCfg,\n      'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema' | 'feed'\n    > & {\n      feed: Feed\n      bodySchema: B extends ZodType ? RouteSchema<z.infer<B>> : undefined\n      querySchema: Q extends ZodType ? RouteSchema<z.infer<Q>> : undefined\n      paramsSchema: P extends ZodType ? RouteSchema<z.infer<P>> : undefined\n      outputSchema: O extends ZodType ? RouteSchema<z.infer<O>> : undefined\n    }\n  >\n>\nexport function buildLowProfileLeaf(leaf: any): any {\n  return {\n    ...leaf,\n    cfg: {\n      ...leaf.cfg,\n      bodySchema: leaf.cfg.bodySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.bodySchema>\n      >,\n      querySchema: leaf.cfg.querySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.querySchema>\n      >,\n      paramsSchema: leaf.cfg.paramsSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.paramsSchema>\n      >,\n      outputSchema: leaf.cfg.outputSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.outputSchema>\n      >,\n    },\n  }\n}\n\nexport type LeafLowProfile<\n  M extends HttpMethod,\n  P extends string,\n  C extends MethodCfgLowProfile,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<\n  L extends AnyLeafLowProfile,\n  Fallback = never,\n> = L['cfg']['paramsSchema'] extends RouteSchema<infer P> ? P : Fallback\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<\n  L extends AnyLeaf,\n  Fallback = never,\n> = L['cfg']['querySchema'] extends RouteSchema<infer Q> ? Q : Fallback\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<\n  L extends AnyLeaf,\n  Fallback = never,\n> = L['cfg']['bodySchema'] extends RouteSchema<infer B> ? B : Fallback\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<\n  L extends AnyLeaf,\n  Fallback = never,\n> = L['cfg']['outputSchema'] extends RouteSchema<infer O> ? O : Fallback\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {}\n","// TODO:\n// * use this as a transform that infers the types from Zod, to only pass the types around instead of the full schemas -> make converters that go both ways (data to schema, schema to data)\n// * consider moving to core package\n// * update server and client side to use this type instead of raw zod schemas\nimport { AnyLeafLowProfile, HttpMethod, Prettify } from './routesV3.core'\n\n/** Build the key type for a leaf — distributive so method/path stay paired. */\nexport type KeyOf<L extends AnyLeafLowProfile> = L extends AnyLeafLowProfile\n  ? `${Uppercase<L['method']>} ${L['path']}`\n  : never\n\n// From a tuple of leaves, get the union of keys (pairwise, no cartesian blow-up)\ntype KeysOf<Leaves extends readonly AnyLeafLowProfile[]> = KeyOf<Leaves[number]>\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n  ? Lowercase<M>\n  : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n  ? P\n  : never\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<\n  Leaves extends readonly AnyLeafLowProfile[],\n  K extends string,\n> = Extract<\n  Leaves[number],\n  { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/**\n * Freeze a leaf tuple into a registry with typed key lookups.\n * @param leaves Readonly tuple of leaves produced by the builder DSL.\n * @returns Registry containing the leaves array and a `byKey` lookup map.\n */\nexport function finalize<const L extends readonly AnyLeafLowProfile[]>(\n  leaves: L,\n) {\n  type Keys = KeysOf<L>\n  type MapByKey = { [K in Keys]: Prettify<LeafForKey<L, K>> }\n\n  const byKey = Object.fromEntries(\n    leaves.map((l) => [`${l.method.toUpperCase()} ${l.path}`, l] as const),\n  ) as unknown as MapByKey\n\n  const log = (logger: { system: (...args: unknown[]) => void }) => {\n    logger.system('Finalized routes:')\n    ;(Object.keys(byKey) as Keys[]).forEach((k) => {\n      const leaf = byKey[k]\n      logger.system(`- ${k}`)\n    })\n  }\n\n  return { all: leaves, byKey, log }\n}\n\n/** Nominal type alias for a finalized registry. */\nexport type Registry<R extends ReturnType<typeof finalize>> = R\n\ntype FilterRoute<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n  Acc extends readonly AnyLeafLowProfile[] = [],\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? First extends { path: `${string}${F}${string}` }\n    ? FilterRoute<Rest, F, [...Acc, First]>\n    : FilterRoute<Rest, F, Acc>\n  : Acc\n\ntype UpperCase<S extends string> = S extends `${infer First}${infer Rest}`\n  ? `${Uppercase<First>}${UpperCase<Rest>}`\n  : S\n\ntype Routes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = FilterRoute<T, F>\ntype ByKey<\n  T extends readonly AnyLeafLowProfile[],\n  Acc extends Record<string, AnyLeafLowProfile> = {},\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? ByKey<\n      Rest,\n      Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }\n    >\n  : Acc\n\n/**\n * Convenience helper for extracting a subset of routes by path fragment.\n * @param T Tuple of leaves produced by the DSL.\n * @param F String fragment to match against the route path.\n */\nexport type SubsetRoutes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = {\n  byKey: ByKey<Routes<T, F>>\n  all: Routes<T, F>\n}\n","// socket.index.ts (shared client/server)\n\nimport { z } from 'zod'\n\nexport type SocketSchema<Output = unknown> = z.ZodType & {\n  __out: Output\n}\n\nexport type SocketSchemaOutput<Schema extends z.ZodTypeAny> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport type SocketEvent<Out = unknown> = {\n  message: z.ZodTypeAny\n  /** phantom field, only for typing; not meant to be used at runtime */\n  __out: Out\n}\n\nexport type EventMap = Record<string, SocketEvent<any>>\n\n/**\n * System event names – shared so server and client\n * don't drift on naming.\n */\nexport type SysEventName =\n  | 'sys:connect'\n  | 'sys:disconnect'\n  | 'sys:reconnect'\n  | 'sys:connect_error'\n  | 'sys:ping'\n  | 'sys:pong'\n  | 'sys:room_join'\n  | 'sys:room_leave'\nexport function defineSocketEvents<\n  const C extends SocketConnectionConfig,\n  const Schemas extends Record<\n    string,\n    {\n      message: z.ZodTypeAny\n    }\n  >,\n>(\n  config: C,\n  events: Schemas,\n): {\n  config: {\n    [K in keyof C]: SocketSchema<z.output<C[K]>>\n  }\n  events: {\n    [K in keyof Schemas]: SocketEvent<z.output<Schemas[K]['message']>>\n  }\n}\n\nexport function defineSocketEvents(config: any, events: any) {\n  return { config, events }\n}\n\nexport type Payload<\n  T extends EventMap,\n  K extends keyof T,\n> = T[K] extends SocketEvent<infer Out> ? Out : never\nexport type SocketConnectionConfig = {\n  joinMetaMessage: z.ZodTypeAny\n  leaveMetaMessage: z.ZodTypeAny\n  pingPayload: z.ZodTypeAny\n  pongPayload: z.ZodTypeAny\n}\n\nexport type SocketConnectionConfigOutput = {\n  joinMetaMessage: SocketSchema<any>\n  leaveMetaMessage: SocketSchema<any>\n  pingPayload: SocketSchema<any>\n  pongPayload: SocketSchema<any>\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/sockets/socket.index.ts"],"sourcesContent":["export * from './core/routesV3.builder'\nexport * from './core/routesV3.core'\nexport * from './core/routesV3.finalize'\nexport * from './sockets/socket.index'\n","import { z } from 'zod'\nimport {\n  AnyLeaf,\n  AnyLeafLowProfile,\n  Append,\n  AugmentLeaves,\n  HttpMethod,\n  Leaf,\n  LowProfileCfg,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n} from './routesV3.core'\n\nconst paginationQueryShape = {\n  pagination_cursor: z.string().optional(),\n  pagination_limit: z.coerce.number().min(1).max(100).default(20),\n}\n\nconst defaultFeedQuerySchema = z.object(paginationQueryShape)\ntype PaginationShape = typeof paginationQueryShape\n\ntype ZodTypeAny = z.ZodTypeAny\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{\n  [K in Name]: S\n}>\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>\ntype ZodObjectAny = z.ZodObject<any>\ntype AnyZodObject = z.ZodObject<any>\ntype MergedParamsResult<\n  PS,\n  Name extends string,\n  P extends ZodTypeAny,\n> = PS extends ZodTypeAny\n  ? z.ZodIntersection<PS, ParamZod<Name, P>>\n  : ParamZod<Name, P>\n\nfunction getZodShape(schema: ZodObjectAny) {\n  const shapeOrGetter = (schema as any).shape\n    ? (schema as any).shape\n    : (schema as any)._def?.shape?.()\n  if (!shapeOrGetter) return {}\n  return typeof shapeOrGetter === 'function'\n    ? shapeOrGetter.call(schema)\n    : shapeOrGetter\n}\n\nfunction collectNestedFieldSuggestions(\n  shape: Record<string, ZodTypeAny> | undefined,\n  prefix: string[] = [],\n): string[] {\n  if (!shape) return []\n  const suggestions: string[] = []\n  for (const [key, value] of Object.entries(shape)) {\n    if (value instanceof z.ZodObject) {\n      const nestedShape = getZodShape(value as ZodObjectAny)\n      const nestedSuggestions = collectNestedFieldSuggestions(nestedShape, [\n        ...prefix,\n        key,\n      ])\n      suggestions.push(\n        ...(nestedSuggestions.length\n          ? nestedSuggestions\n          : [[...prefix, key].join('_')]),\n      )\n    } else if (prefix.length > 0) {\n      suggestions.push([...prefix, key].join('_'))\n    }\n  }\n  return suggestions\n}\n\nconst defaultFeedOutputSchema = z.object({\n  items: z.array(z.unknown()),\n  nextCursor: z.string().optional(),\n})\n\nfunction augmentFeedQuerySchema<Q extends ZodTypeAny | undefined>(schema: Q) {\n  if (schema && !(schema instanceof z.ZodObject)) {\n    console.warn(\n      'Feed queries must be a ZodObject; default pagination applied.',\n    )\n    return defaultFeedQuerySchema\n  }\n\n  const base = (schema as ZodObjectAny) ?? z.object({})\n  const shape = getZodShape(base)\n  const nestedSuggestions = collectNestedFieldSuggestions(shape)\n  if (nestedSuggestions.length) {\n    console.warn(\n      `Feed query schemas should avoid nested objects; consider flattening fields like: ${nestedSuggestions.join(\n        ', ',\n      )}`,\n    )\n  }\n  return base.extend(paginationQueryShape)\n}\n\nfunction augmentFeedOutputSchema<O extends ZodTypeAny | undefined>(schema: O) {\n  if (!schema) return defaultFeedOutputSchema\n  if (schema instanceof z.ZodArray) {\n    return z.object({\n      items: schema,\n      nextCursor: z.string().optional(),\n    })\n  }\n  if (schema instanceof z.ZodObject) {\n    const shape = (schema as any).shape\n      ? (schema as any).shape\n      : (schema as any)._def?.shape?.()\n    const hasItems = Boolean(shape?.items)\n    if (hasItems) {\n      return schema.extend({ nextCursor: z.string().optional() })\n    }\n    return z.object({\n      items: z.array(schema as ZodTypeAny),\n      nextCursor: z.string().optional(),\n    })\n  }\n  return z.object({\n    items: z.array(schema as ZodTypeAny),\n    nextCursor: z.string().optional(),\n  })\n}\n\n/**\n * Runtime helper that mirrors the typed merge used by the builder.\n * @param a Previously merged params schema inherited from parent segments.\n * @param b Newly introduced params schema.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nfunction mergeSchemas<A extends ZodTypeAny, B extends ZodTypeAny>(\n  a: A,\n  b: B,\n): ZodTypeAny\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B\nfunction mergeSchemas(\n  a: ZodTypeAny | undefined,\n  b: ZodTypeAny | undefined,\n): ZodTypeAny | undefined\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined) {\n  if (a && b) return z.intersection(a as any, b as any)\n  return (a ?? b) as ZodTypeAny | undefined\n}\n\ntype FeedOutputSchema<C extends MethodCfg> =\n  C['outputSchema'] extends ZodArrayAny\n    ? z.ZodObject<{\n        items: C['outputSchema']\n        nextCursor: z.ZodOptional<z.ZodString>\n      }>\n    : C['outputSchema'] extends ZodTypeAny\n      ? z.ZodObject<{\n          items: z.ZodArray<C['outputSchema']>\n          nextCursor: z.ZodOptional<z.ZodString>\n        }>\n      : typeof defaultFeedOutputSchema\n\ntype BaseMethodCfg<C extends MethodCfg> = Merge<\n  Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>,\n  Omit<C, 'querySchema' | 'outputSchema' | 'feed'>\n>\n\ntype FeedField<C extends MethodCfg> = C['feed'] extends true\n  ? { feed: true }\n  : { feed?: boolean }\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> =\n  Q extends z.ZodObject<infer Shape>\n    ? z.ZodObject<Shape & PaginationShape>\n    : z.ZodObject<PaginationShape>\n\ntype FeedQueryField<C extends MethodCfg> = {\n  querySchema: AddPaginationToQuery<\n    C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined\n  >\n}\n\ntype NonFeedQueryField<C extends MethodCfg> =\n  C['querySchema'] extends ZodTypeAny\n    ? { querySchema: C['querySchema'] }\n    : { querySchema?: undefined }\n\ntype FeedOutputField<C extends MethodCfg> = {\n  outputSchema: FeedOutputSchema<C>\n}\n\ntype NonFeedOutputField<C extends MethodCfg> =\n  C['outputSchema'] extends ZodTypeAny\n    ? { outputSchema: C['outputSchema'] }\n    : { outputSchema?: undefined }\n\ntype ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny\n  ? { paramsSchema: C['paramsSchema'] }\n  : { paramsSchema: PS }\n\ntype EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true\n  ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS>\n  : FeedField<C> &\n      NonFeedQueryField<C> &\n      NonFeedOutputField<C> &\n      ParamsField<C, PS>\n\ntype EffectiveCfg<C extends MethodCfg, PS> = Prettify<\n  Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>\n>\n\ntype BuiltLeaf<\n  M extends HttpMethod,\n  Base extends string,\n  I extends NodeCfg,\n  C extends MethodCfg,\n  PS,\n> = Leaf<M, Base, Merge<I, LowProfileCfg<EffectiveCfg<C, PS>>>>\n\ntype MethodFns<\n  Base extends string,\n  Acc extends readonly AnyLeafLowProfile[],\n  I extends NodeCfg,\n  PS extends ZodTypeAny | undefined,\n  Used extends HttpMethod,\n> = {\n  /**\n   * Register a GET leaf at the current path.\n   */\n  get: 'get' extends Used\n    ? never\n    : <C extends MethodCfg>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>,\n        I,\n        PS,\n        Used | 'get'\n      >\n\n  /**\n   * Register a POST leaf at the current path.\n   */\n  post: 'post' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'post', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'post'\n      >\n\n  /**\n   * Register a PUT leaf at the current path.\n   */\n  put: 'put' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'put', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'put'\n      >\n\n  /**\n   * Register a PATCH leaf at the current path.\n   */\n  patch: 'patch' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'patch', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'patch'\n      >\n\n  /**\n   * Register a DELETE leaf at the current path.\n   */\n  delete: 'delete' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'delete', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'delete'\n      >\n}\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeafLowProfile[],\n  I extends NodeCfg,\n  PS extends ZodTypeAny | undefined,\n  Used extends HttpMethod = never,\n> extends MethodFns<Base, Acc, I, PS, Used> {\n  /**\n   * Mount a static subtree under `name`.\n   * The `leaves` are built externally via `resource(...)` and will be\n   * rebased so that their paths become `${Base}/${name}${leaf.path}` and their\n   * paramsSchemas are merged with the parameters already accumulated on this branch.\n   */\n  sub<Name extends string, R extends readonly AnyLeafLowProfile[]>(\n    name: Name,\n    leaves: R,\n  ): Branch<\n    Base,\n    MergeArray<Acc, AugmentLeaves<`${Base}/${Name}`, PS, R>>,\n    I,\n    PS,\n    Used\n  >\n\n  /**\n   * Mount a static subtree under `name` and merge extra node-level config.\n   */\n  sub<\n    Name extends string,\n    J extends NodeCfg,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    cfg: J,\n    leaves: R,\n  ): Branch<\n    Base,\n    MergeArray<Acc, AugmentLeaves<`${Base}/${Name}`, PS, R>>,\n    Merge<I, J>,\n    PS,\n    Used\n  >\n\n  /**\n   * Introduce a `:param` segment and mount a pre-built subtree beneath it.\n   * The subtree paths are rebased to `${Base}/:${Name}${leaf.path}` and\n   * their paramsSchemas are intersected with the accumulated params plus this new param.\n   */\n  routeParameter<\n    Name extends string,\n    P extends ZodTypeAny,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    paramsSchema: P,\n    leaves: R,\n  ): Branch<\n    Base,\n    MergeArray<\n      Acc,\n      AugmentLeaves<`${Base}/:${Name}`, MergedParamsResult<PS, Name, P>, R>\n    >,\n    I,\n    PS,\n    Used\n  >\n\n  /**\n   * Finish the branch and return the collected leaves.\n   * @returns Readonly tuple of accumulated leaves.\n   */\n  done(): Readonly<Acc>\n}\n\n/**\n * Start building a resource at the given base path.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Optional node configuration applied to all descendants.\n * @returns Root `Branch` instance used to compose the route tree.\n */\nexport function resource<Base extends string = '', I extends NodeCfg = {}>(\n  base?: Base,\n  inherited?: I,\n): Branch<Base, readonly [], I, undefined> {\n  const rootBase = (base ?? '') as Base\n  const rootInherited: NodeCfg = { ...(inherited as NodeCfg) }\n\n  function makeBranch<\n    Base2 extends string,\n    I2 extends NodeCfg,\n    PS2 extends ZodTypeAny | undefined,\n  >(base2: Base2, inherited2: I2, mergedParamsSchema?: PS2) {\n    const stack: AnyLeaf[] = []\n    let currentBase: string = base2\n    let inheritedCfg: NodeCfg = { ...(inherited2 as NodeCfg) }\n    let currentParamsSchema: PS2 = mergedParamsSchema as PS2\n\n    function add<M extends HttpMethod, C extends MethodCfg>(method: M, cfg: C) {\n      const effectiveParamsSchema = (cfg.paramsSchema ??\n        currentParamsSchema) as PS2 | undefined\n      const effectiveQuerySchema =\n        cfg.feed === true\n          ? augmentFeedQuerySchema(cfg.querySchema)\n          : cfg.querySchema\n      const effectiveOutputSchema =\n        cfg.feed === true\n          ? augmentFeedOutputSchema(cfg.outputSchema)\n          : cfg.outputSchema\n\n      const fullCfg = (\n        effectiveParamsSchema\n          ? {\n              ...inheritedCfg,\n              ...cfg,\n              paramsSchema: effectiveParamsSchema,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n          : {\n              ...inheritedCfg,\n              ...cfg,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n      ) as any\n\n      const leaf = {\n        method,\n        path: currentBase as Base2,\n        cfg: fullCfg,\n      } as const\n\n      stack.push(leaf as unknown as AnyLeaf)\n\n      return api\n    }\n\n    const api: any = {\n      /**\n       * Mount a subtree built elsewhere.\n       *\n       * Usage:\n       *   const users = resource('').get(...).done()\n       *   resource('/api').sub('users', users).done()\n       */\n      sub<Name extends string>(\n        name: Name,\n        cfgOrLeaves?: NodeCfg | readonly AnyLeafLowProfile[],\n        maybeLeaves?: readonly AnyLeafLowProfile[],\n      ) {\n        let cfg: NodeCfg | undefined\n        let leaves: readonly AnyLeafLowProfile[] | undefined\n\n        if (Array.isArray(cfgOrLeaves)) {\n          leaves = cfgOrLeaves\n        } else {\n          cfg = cfgOrLeaves as NodeCfg | undefined\n          leaves = maybeLeaves\n        }\n\n        if (!leaves) {\n          throw new Error('sub() expects a leaves array as the last argument')\n        }\n\n        const childInherited: NodeCfg = {\n          ...inheritedCfg,\n          ...(cfg ?? {}),\n        }\n\n        const baseForChildren = `${currentBase}/${name}`\n\n        for (const leafLow of leaves) {\n          const leaf = leafLow as unknown as AnyLeaf\n          const leafCfg = leaf.cfg as MethodCfg\n          const leafParams = leafCfg.paramsSchema as ZodTypeAny | undefined\n\n          const effectiveParams = mergeSchemas(\n            currentParamsSchema as any,\n            leafParams,\n          )\n\n          const newCfg: MethodCfg = {\n            ...childInherited,\n            ...leafCfg,\n          }\n\n          if (effectiveParams) {\n            newCfg.paramsSchema = effectiveParams\n          } else if ('paramsSchema' in newCfg) {\n            delete newCfg.paramsSchema\n          }\n\n          const newLeaf: AnyLeaf = {\n            method: leaf.method,\n            path: `${baseForChildren}${leaf.path}` as string,\n            cfg: newCfg,\n          }\n\n          stack.push(newLeaf)\n        }\n\n        return api\n      },\n\n      /**\n       * Introduce a :param segment and mount a subtree under it.\n       *\n       * The subtree is built independently (e.g. resource('').get(...).done())\n       * and its paths become `${currentBase}/:${name}${leaf.path}`.\n       * Params schemas are intersected with the accumulated params plus the new param.\n       */\n      routeParameter<Name extends string, P extends ZodTypeAny>(\n        name: Name,\n        paramsSchema: P,\n        leaves: readonly AnyLeafLowProfile[],\n      ) {\n        const paramObj: ParamZod<Name, P> = z.object({\n          [name]: paramsSchema,\n        } as Record<Name, P>)\n\n        const mergedParams = (\n          currentParamsSchema\n            ? mergeSchemas(currentParamsSchema as any, paramObj)\n            : paramObj\n        ) as PS2\n\n        const baseForChildren = `${currentBase}/:${name}`\n\n        for (const leafLow of leaves) {\n          const leaf = leafLow as unknown as AnyLeaf\n          const leafCfg = leaf.cfg as MethodCfg\n          const leafParams = leafCfg.paramsSchema as ZodTypeAny | undefined\n\n          const effectiveParams = mergeSchemas(mergedParams as any, leafParams)\n\n          const newCfg: MethodCfg = {\n            ...inheritedCfg,\n            ...leafCfg,\n          }\n\n          if (effectiveParams) {\n            newCfg.paramsSchema = effectiveParams\n          } else if ('paramsSchema' in newCfg) {\n            delete newCfg.paramsSchema\n          }\n\n          const newLeaf: AnyLeaf = {\n            method: leaf.method,\n            path: `${baseForChildren}${leaf.path}` as string,\n            cfg: newCfg,\n          }\n\n          stack.push(newLeaf)\n        }\n\n        return api\n      },\n\n      // methods (inject current params schema if missing)\n      get<C extends MethodCfg>(cfg: C) {\n        return add('get', cfg)\n      },\n      post<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('post', { ...cfg, feed: false })\n      },\n      put<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('put', { ...cfg, feed: false })\n      },\n      patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('patch', { ...cfg, feed: false })\n      },\n      delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('delete', { ...cfg, feed: false })\n      },\n\n      done() {\n        return stack as readonly AnyLeafLowProfile[]\n      },\n    }\n\n    return api as Branch<Base2, readonly [], I2, PS2>\n  }\n\n  // Root branch starts with no params schema (PS = undefined)\n  return makeBranch(rootBase, rootInherited, undefined)\n}\n\n/**\n * Merge two readonly tuples (preserves literal tuple information).\n * @param arr1 First tuple.\n * @param arr2 Second tuple.\n * @returns New tuple containing values from both inputs.\n */\nexport const mergeArrays = <T extends readonly any[], S extends readonly any[]>(\n  arr1: T,\n  arr2: S,\n) => {\n  return [...arr1, ...arr2] as [...T, ...S]\n}\n","import { z, ZodType } from 'zod'\n\n/** Supported HTTP verbs for the routes DSL. */\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete'\n\n/** Declarative description of a multipart upload field. */\nexport type FileField = {\n  /** Form field name used for uploads. */\n  name: string\n  /** Maximum number of files accepted for this field. */\n  maxCount: number\n}\n\n/** Configuration that applies to an entire branch of the route tree. */\nexport type NodeCfg = {\n  /** @deprecated. Does nothing. */\n  authenticated?: boolean\n}\n\nexport type RouteSchema<Output = unknown> = ZodType & {\n  __out: Output\n}\n\nexport type RouteSchemaOutput<Schema extends ZodType> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport const lowProfileParse = <T extends RouteSchema>(\n  schema: T,\n  data: unknown,\n): RouteSchemaOutput<T> => {\n  return schema.parse(data) as RouteSchemaOutput<T>\n}\n\nexport type ToRouteSchema<S> = S extends ZodType ? RouteSchema<z.output<S>> : S\n\nexport type LowProfileCfg<Cfg extends MethodCfg> = Prettify<\n  Omit<Cfg, 'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'> & {\n    bodySchema: ToRouteSchema<Cfg['bodySchema']>\n    querySchema: ToRouteSchema<Cfg['querySchema']>\n    paramsSchema: ToRouteSchema<Cfg['paramsSchema']>\n    outputSchema: ToRouteSchema<Cfg['outputSchema']>\n  }\n>\n\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg = {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodType\n  /** Zod schema describing the query string. */\n  querySchema?: ZodType\n  /** Zod schema describing path params (Internal only, set through sub and routeParameter). */\n  paramsSchema?: ZodType\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodType\n  /** Multipart upload definitions for the route. */\n  bodyFiles?: FileField[]\n  /** Marks the route as an infinite feed (enables cursor helpers). */\n  feed?: boolean\n\n  /** Optional human-readable description for docs/debugging. */\n  description?: string\n  /**\n   * Short one-line summary for docs list views.\n   * Shown in navigation / tables instead of the full description.\n   */\n  summary?: string\n  /**\n   * Group name used for navigation sections in docs UIs.\n   * e.g. \"Users\", \"Billing\", \"Auth\".\n   */\n  docsGroup?: string\n  /**\n   * Tags that can be used to filter / facet in interactive docs.\n   * e.g. [\"users\", \"admin\", \"internal\"].\n   */\n  tags?: string[]\n  /**\n   * Mark the route as deprecated in docs.\n   * Renderers can badge this and/or hide by default.\n   */\n  deprecated?: boolean\n  /**\n   * Optional stability information for the route.\n   * Renderers can surface this prominently.\n   */\n  stability?: 'experimental' | 'beta' | 'stable' | 'deprecated'\n  /**\n   * Hide this route from public docs while keeping it usable in code.\n   */\n  docsHidden?: boolean\n  /**\n   * Arbitrary extra metadata for docs renderers.\n   * Can be used for auth requirements, rate limits, feature flags, etc.\n   */\n  docsMeta?: Record<string, unknown>\n}\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<\n  M extends HttpMethod,\n  P extends string,\n  C extends MethodCfg,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n\n/** Convenience union covering all generated leaves. */\nexport type AnyLeaf = Leaf<HttpMethod, string, MethodCfg>\n\n/** Merge two object types while keeping nice IntelliSense output. */\nexport type Merge<A, B> = Prettify<Omit<A, keyof B> & B>\n\n/** Append a new element to a readonly tuple type. */\nexport type Append<T extends readonly unknown[], X> = [...T, X]\n\n/** Concatenate two readonly tuple types. */\nexport type MergeArray<\n  A extends readonly unknown[],\n  B extends readonly unknown[],\n> = [...A, ...B]\nexport type IntersectZod<\n  A extends ZodType | undefined,\n  B extends ZodType | undefined,\n> = B extends ZodType\n  ? A extends ZodType\n    ? z.ZodIntersection<A, B>\n    : B\n  : A extends ZodType\n    ? A\n    : undefined\n\ntype RouteSchemaFromZod<T extends ZodType | undefined> = T extends ZodType\n  ? RouteSchema<z.output<T>>\n  : undefined\n\ntype MergeRouteSchemas<\n  Existing extends RouteSchema | undefined,\n  Parent extends ZodType | undefined,\n> =\n  Existing extends RouteSchema<infer ExistingOut>\n    ? Parent extends ZodType\n      ? RouteSchema<ExistingOut & z.output<Parent>>\n      : Existing\n    : Parent extends ZodType\n      ? RouteSchemaFromZod<Parent>\n      : undefined\n\ntype AugmentedCfg<\n  Cfg extends MethodCfgLowProfile,\n  Param extends ZodType | undefined,\n> = Prettify<\n  Omit<Cfg, 'paramsSchema'> & {\n    paramsSchema: MergeRouteSchemas<Cfg['paramsSchema'], Param>\n  }\n>\n\nexport type AugmentLeaves<\n  P extends string,\n  Param extends ZodType | undefined,\n  R extends readonly LeafLowProfile[],\n  Acc extends readonly LeafLowProfile[] = [],\n> = R extends readonly [infer First, ...infer Rest]\n  ? First extends LeafLowProfile\n    ? AugmentLeaves<\n        P,\n        Param,\n        Rest extends readonly LeafLowProfile[] ? Rest : [],\n        Append<\n          Acc,\n          LeafLowProfile<\n            First['method'],\n            `${P}${First['path']}`,\n            AugmentedCfg<First['cfg'], Param>\n          >\n        >\n      >\n    : never\n  : Acc\n// helpers (optional)\ntype SegmentParams<S extends string> = S extends `:${infer P}` ? P : never\ntype Split<S extends string> = S extends ''\n  ? []\n  : S extends `${infer A}/${infer B}`\n    ? [A, ...Split<B>]\n    : [S]\ntype ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>\n\n/** Derive a params object type from a literal route string. */\nexport type ExtractParamsFromPath<Path extends string> =\n  ExtractParamNames<Path> extends never\n    ? never\n    : Record<ExtractParamNames<Path>, string | number>\n\n/**\n * Interpolate `:params` in a path using the given values.\n * @param path Literal route string containing `:param` segments.\n * @param params Object of parameter values to interpolate.\n * @returns Path string with parameters substituted.\n */\nexport function compilePath<Path extends string>(\n  path: Path,\n  params: ExtractParamsFromPath<Path>,\n) {\n  if (!params) return path\n  return path.replace(/:([A-Za-z0-9_]+)/g, (_, k) => {\n    const v = (params as any)[k]\n    if (v === undefined || v === null) throw new Error(`Missing param :${k}`)\n    return String(v)\n  })\n}\n\n/**\n * Build a deterministic cache key for the given leaf.\n * The key matches the shape consumed by React Query helpers.\n * @param args.leaf Leaf describing the endpoint.\n * @param args.params Optional params used to build the path.\n * @param args.query Optional query payload.\n * @returns Tuple suitable for React Query cache keys.\n */\ntype SplitPath<P extends string> = P extends ''\n  ? []\n  : P extends `${infer A}/${infer B}`\n    ? [A, ...SplitPath<B>]\n    : [P]\nexport function buildCacheKey<L extends AnyLeaf>(args: {\n  leaf: L\n  params?: ExtractParamsFromPath<L['path']>\n  query?: InferQuery<L>\n}) {\n  let p = args.leaf.path\n  if (args.params) {\n    p = compilePath<L['path']>(p, args.params)\n  }\n  return [\n    args.leaf.method,\n    ...(p.split('/').filter(Boolean) as SplitPath<typeof p>),\n    args.query ?? {},\n  ] as const\n}\n\n/** Definition-time method config (for clarity). */\nexport type MethodCfgDef = MethodCfg\n\n/** Low-profile method config where schemas carry a phantom __out like SocketSchema. */\nexport type MethodCfgLowProfile = Omit<\n  MethodCfg,\n  'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n> & {\n  bodySchema?: RouteSchema\n  querySchema?: RouteSchema\n  paramsSchema?: RouteSchema\n  outputSchema?: RouteSchema\n}\nexport type AnyLeafLowProfile = LeafLowProfile<\n  HttpMethod,\n  string,\n  MethodCfgLowProfile\n>\n\nexport function buildLowProfileLeaf<\n  const M extends HttpMethod,\n  const Path extends string,\n  const O extends ZodType | undefined = undefined,\n  const P extends ZodType | undefined = undefined,\n  const Q extends ZodType | undefined = undefined,\n  const B extends ZodType | undefined = undefined,\n  const Feed extends boolean = false,\n>(leaf: {\n  method: M\n  path: Path\n  cfg: Omit<\n    MethodCfg,\n    'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n  > & {\n    feed?: Feed\n    bodySchema?: B\n    querySchema?: Q\n    paramsSchema?: P\n    outputSchema?: O\n  }\n}): LeafLowProfile<\n  M,\n  Path,\n  Prettify<\n    Omit<\n      MethodCfg,\n      'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema' | 'feed'\n    > & {\n      feed: Feed\n      bodySchema: B extends ZodType ? RouteSchema<z.infer<B>> : undefined\n      querySchema: Q extends ZodType ? RouteSchema<z.infer<Q>> : undefined\n      paramsSchema: P extends ZodType ? RouteSchema<z.infer<P>> : undefined\n      outputSchema: O extends ZodType ? RouteSchema<z.infer<O>> : undefined\n    }\n  >\n>\nexport function buildLowProfileLeaf(leaf: any): any {\n  return {\n    ...leaf,\n    cfg: {\n      ...leaf.cfg,\n      bodySchema: leaf.cfg.bodySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.bodySchema>\n      >,\n      querySchema: leaf.cfg.querySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.querySchema>\n      >,\n      paramsSchema: leaf.cfg.paramsSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.paramsSchema>\n      >,\n      outputSchema: leaf.cfg.outputSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.outputSchema>\n      >,\n    },\n  }\n}\n\nexport type LeafLowProfile<\n  M extends HttpMethod = HttpMethod,\n  P extends string = string,\n  C extends MethodCfgLowProfile = MethodCfgLowProfile,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeafLowProfile, Fallback = never> =\n  L['cfg']['paramsSchema'] extends RouteSchema<infer P> ? P : Fallback\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf, Fallback = never> =\n  L['cfg']['querySchema'] extends RouteSchema<infer Q> ? Q : Fallback\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf, Fallback = never> =\n  L['cfg']['bodySchema'] extends RouteSchema<infer B> ? B : Fallback\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf, Fallback = never> =\n  L['cfg']['outputSchema'] extends RouteSchema<infer O> ? O : Fallback\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {}\n","// TODO:\n// * use this as a transform that infers the types from Zod, to only pass the types around instead of the full schemas -> make converters that go both ways (data to schema, schema to data)\n// * consider moving to core package\n// * update server and client side to use this type instead of raw zod schemas\nimport { AnyLeafLowProfile, HttpMethod, Prettify } from './routesV3.core'\n\n/** Build the key type for a leaf — distributive so method/path stay paired. */\nexport type KeyOf<L extends AnyLeafLowProfile> = L extends AnyLeafLowProfile\n  ? `${Uppercase<L['method']>} ${L['path']}`\n  : never\n\n// From a tuple of leaves, get the union of keys (pairwise, no cartesian blow-up)\ntype KeysOf<Leaves extends readonly AnyLeafLowProfile[]> = KeyOf<Leaves[number]>\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n  ? Lowercase<M>\n  : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n  ? P\n  : never\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<\n  Leaves extends readonly AnyLeafLowProfile[],\n  K extends string,\n> = Extract<\n  Leaves[number],\n  { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/**\n * Freeze a leaf tuple into a registry with typed key lookups.\n * @param leaves Readonly tuple of leaves produced by the builder DSL.\n * @returns Registry containing the leaves array and a `byKey` lookup map.\n */\nexport function finalize<const L extends readonly AnyLeafLowProfile[]>(\n  leaves: L,\n) {\n  type Keys = KeysOf<L>\n  type MapByKey = { [K in Keys]: Prettify<LeafForKey<L, K>> }\n\n  const byKey = Object.fromEntries(\n    leaves.map((l) => [`${l.method.toUpperCase()} ${l.path}`, l] as const),\n  ) as unknown as MapByKey\n\n  const log = (logger: { system: (...args: unknown[]) => void }) => {\n    logger.system('Finalized routes:')\n    ;(Object.keys(byKey) as Keys[]).forEach((k) => {\n      const leaf = byKey[k]\n      logger.system(`- ${k}`)\n    })\n  }\n\n  return { all: leaves, byKey, log }\n}\n\n/** Nominal type alias for a finalized registry. */\nexport type Registry<R extends ReturnType<typeof finalize>> = R\n\ntype FilterRoute<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n  Acc extends readonly AnyLeafLowProfile[] = [],\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? First extends { path: `${string}${F}${string}` }\n    ? FilterRoute<Rest, F, [...Acc, First]>\n    : FilterRoute<Rest, F, Acc>\n  : Acc\n\ntype UpperCase<S extends string> = S extends `${infer First}${infer Rest}`\n  ? `${Uppercase<First>}${UpperCase<Rest>}`\n  : S\n\ntype Routes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = FilterRoute<T, F>\ntype ByKey<\n  T extends readonly AnyLeafLowProfile[],\n  Acc extends Record<string, AnyLeafLowProfile> = {},\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? ByKey<\n      Rest,\n      Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }\n    >\n  : Acc\n\n/**\n * Convenience helper for extracting a subset of routes by path fragment.\n * @param T Tuple of leaves produced by the DSL.\n * @param F String fragment to match against the route path.\n */\nexport type SubsetRoutes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = {\n  byKey: ByKey<Routes<T, F>>\n  all: Routes<T, F>\n}\n","// socket.index.ts (shared client/server)\n\nimport { z } from 'zod'\n\nexport type SocketSchema<Output = unknown> = z.ZodType & {\n  __out: Output\n}\n\nexport type SocketSchemaOutput<Schema extends z.ZodTypeAny> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport type SocketEvent<Out = unknown> = {\n  message: z.ZodTypeAny\n  /** phantom field, only for typing; not meant to be used at runtime */\n  __out: Out\n}\n\nexport type EventMap = Record<string, SocketEvent<any>>\n\n/**\n * System event names – shared so server and client\n * don't drift on naming.\n */\nexport type SysEventName =\n  | 'sys:connect'\n  | 'sys:disconnect'\n  | 'sys:reconnect'\n  | 'sys:connect_error'\n  | 'sys:ping'\n  | 'sys:pong'\n  | 'sys:room_join'\n  | 'sys:room_leave'\nexport function defineSocketEvents<\n  const C extends SocketConnectionConfig,\n  const Schemas extends Record<\n    string,\n    {\n      message: z.ZodTypeAny\n    }\n  >,\n>(\n  config: C,\n  events: Schemas,\n): {\n  config: {\n    [K in keyof C]: SocketSchema<z.output<C[K]>>\n  }\n  events: {\n    [K in keyof Schemas]: SocketEvent<z.output<Schemas[K]['message']>>\n  }\n}\n\nexport function defineSocketEvents(config: any, events: any) {\n  return { config, events }\n}\n\nexport type Payload<T extends EventMap, K extends keyof T> =\n  T[K] extends SocketEvent<infer Out> ? Out : never\nexport type SocketConnectionConfig = {\n  joinMetaMessage: z.ZodTypeAny\n  leaveMetaMessage: z.ZodTypeAny\n  pingPayload: z.ZodTypeAny\n  pongPayload: z.ZodTypeAny\n}\n\nexport type SocketConnectionConfigOutput = {\n  joinMetaMessage: SocketSchema<any>\n  leaveMetaMessage: SocketSchema<any>\n  pingPayload: SocketSchema<any>\n  pongPayload: SocketSchema<any>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAkB;AAgBlB,IAAM,uBAAuB;AAAA,EAC3B,mBAAmB,aAAE,OAAO,EAAE,SAAS;AAAA,EACvC,kBAAkB,aAAE,OAAO,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AAChE;AAEA,IAAM,yBAAyB,aAAE,OAAO,oBAAoB;AAkB5D,SAAS,YAAY,QAAsB;AACzC,QAAM,gBAAiB,OAAe,QACjC,OAAe,QACf,OAAe,MAAM,QAAQ;AAClC,MAAI,CAAC,cAAe,QAAO,CAAC;AAC5B,SAAO,OAAO,kBAAkB,aAC5B,cAAc,KAAK,MAAM,IACzB;AACN;AAEA,SAAS,8BACP,OACA,SAAmB,CAAC,GACV;AACV,MAAI,CAAC,MAAO,QAAO,CAAC;AACpB,QAAM,cAAwB,CAAC;AAC/B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,iBAAiB,aAAE,WAAW;AAChC,YAAM,cAAc,YAAY,KAAqB;AACrD,YAAM,oBAAoB,8BAA8B,aAAa;AAAA,QACnE,GAAG;AAAA,QACH;AAAA,MACF,CAAC;AACD,kBAAY;AAAA,QACV,GAAI,kBAAkB,SAClB,oBACA,CAAC,CAAC,GAAG,QAAQ,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,MACjC;AAAA,IACF,WAAW,OAAO,SAAS,GAAG;AAC5B,kBAAY,KAAK,CAAC,GAAG,QAAQ,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,IAC7C;AAAA,EACF;AACA,SAAO;AACT;AAEA,IAAM,0BAA0B,aAAE,OAAO;AAAA,EACvC,OAAO,aAAE,MAAM,aAAE,QAAQ,CAAC;AAAA,EAC1B,YAAY,aAAE,OAAO,EAAE,SAAS;AAClC,CAAC;AAED,SAAS,uBAAyD,QAAW;AAC3E,MAAI,UAAU,EAAE,kBAAkB,aAAE,YAAY;AAC9C,YAAQ;AAAA,MACN;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,OAAQ,UAA2B,aAAE,OAAO,CAAC,CAAC;AACpD,QAAM,QAAQ,YAAY,IAAI;AAC9B,QAAM,oBAAoB,8BAA8B,KAAK;AAC7D,MAAI,kBAAkB,QAAQ;AAC5B,YAAQ;AAAA,MACN,oFAAoF,kBAAkB;AAAA,QACpG;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO,KAAK,OAAO,oBAAoB;AACzC;AAEA,SAAS,wBAA0D,QAAW;AAC5E,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI,kBAAkB,aAAE,UAAU;AAChC,WAAO,aAAE,OAAO;AAAA,MACd,OAAO;AAAA,MACP,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,IAClC,CAAC;AAAA,EACH;AACA,MAAI,kBAAkB,aAAE,WAAW;AACjC,UAAM,QAAS,OAAe,QACzB,OAAe,QACf,OAAe,MAAM,QAAQ;AAClC,UAAM,WAAW,QAAQ,OAAO,KAAK;AACrC,QAAI,UAAU;AACZ,aAAO,OAAO,OAAO,EAAE,YAAY,aAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,IAC5D;AACA,WAAO,aAAE,OAAO;AAAA,MACd,OAAO,aAAE,MAAM,MAAoB;AAAA,MACnC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,IAClC,CAAC;AAAA,EACH;AACA,SAAO,aAAE,OAAO;AAAA,IACd,OAAO,aAAE,MAAM,MAAoB;AAAA,IACnC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAClC,CAAC;AACH;AAkBA,SAAS,aAAa,GAA2B,GAA2B;AAC1E,MAAI,KAAK,EAAG,QAAO,aAAE,aAAa,GAAU,CAAQ;AACpD,SAAQ,KAAK;AACf;AAwPO,SAAS,SACd,MACA,WACyC;AACzC,QAAM,WAAY,QAAQ;AAC1B,QAAM,gBAAyB,EAAE,GAAI,UAAsB;AAE3D,WAAS,WAIP,OAAc,YAAgB,oBAA0B;AACxD,UAAM,QAAmB,CAAC;AAC1B,QAAI,cAAsB;AAC1B,QAAI,eAAwB,EAAE,GAAI,WAAuB;AACzD,QAAI,sBAA2B;AAE/B,aAAS,IAA+C,QAAW,KAAQ;AACzE,YAAM,wBAAyB,IAAI,gBACjC;AACF,YAAM,uBACJ,IAAI,SAAS,OACT,uBAAuB,IAAI,WAAW,IACtC,IAAI;AACV,YAAM,wBACJ,IAAI,SAAS,OACT,wBAAwB,IAAI,YAAY,IACxC,IAAI;AAEV,YAAM,UACJ,wBACI;AAAA,QACE,GAAG;AAAA,QACH,GAAG;AAAA,QACH,cAAc;AAAA,QACd,GAAI,uBACA,EAAE,aAAa,qBAAqB,IACpC,CAAC;AAAA,QACL,GAAI,wBACA,EAAE,cAAc,sBAAsB,IACtC,CAAC;AAAA,MACP,IACA;AAAA,QACE,GAAG;AAAA,QACH,GAAG;AAAA,QACH,GAAI,uBACA,EAAE,aAAa,qBAAqB,IACpC,CAAC;AAAA,QACL,GAAI,wBACA,EAAE,cAAc,sBAAsB,IACtC,CAAC;AAAA,MACP;AAGN,YAAM,OAAO;AAAA,QACX;AAAA,QACA,MAAM;AAAA,QACN,KAAK;AAAA,MACP;AAEA,YAAM,KAAK,IAA0B;AAErC,aAAO;AAAA,IACT;AAEA,UAAM,MAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQf,IACE,MACA,aACA,aACA;AACA,YAAI;AACJ,YAAI;AAEJ,YAAI,MAAM,QAAQ,WAAW,GAAG;AAC9B,mBAAS;AAAA,QACX,OAAO;AACL,gBAAM;AACN,mBAAS;AAAA,QACX;AAEA,YAAI,CAAC,QAAQ;AACX,gBAAM,IAAI,MAAM,mDAAmD;AAAA,QACrE;AAEA,cAAM,iBAA0B;AAAA,UAC9B,GAAG;AAAA,UACH,GAAI,OAAO,CAAC;AAAA,QACd;AAEA,cAAM,kBAAkB,GAAG,WAAW,IAAI,IAAI;AAE9C,mBAAW,WAAW,QAAQ;AAC5B,gBAAM,OAAO;AACb,gBAAM,UAAU,KAAK;AACrB,gBAAM,aAAa,QAAQ;AAE3B,gBAAM,kBAAkB;AAAA,YACtB;AAAA,YACA;AAAA,UACF;AAEA,gBAAM,SAAoB;AAAA,YACxB,GAAG;AAAA,YACH,GAAG;AAAA,UACL;AAEA,cAAI,iBAAiB;AACnB,mBAAO,eAAe;AAAA,UACxB,WAAW,kBAAkB,QAAQ;AACnC,mBAAO,OAAO;AAAA,UAChB;AAEA,gBAAM,UAAmB;AAAA,YACvB,QAAQ,KAAK;AAAA,YACb,MAAM,GAAG,eAAe,GAAG,KAAK,IAAI;AAAA,YACpC,KAAK;AAAA,UACP;AAEA,gBAAM,KAAK,OAAO;AAAA,QACpB;AAEA,eAAO;AAAA,MACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MASA,eACE,MACA,cACA,QACA;AACA,cAAM,WAA8B,aAAE,OAAO;AAAA,UAC3C,CAAC,IAAI,GAAG;AAAA,QACV,CAAoB;AAEpB,cAAM,eACJ,sBACI,aAAa,qBAA4B,QAAQ,IACjD;AAGN,cAAM,kBAAkB,GAAG,WAAW,KAAK,IAAI;AAE/C,mBAAW,WAAW,QAAQ;AAC5B,gBAAM,OAAO;AACb,gBAAM,UAAU,KAAK;AACrB,gBAAM,aAAa,QAAQ;AAE3B,gBAAM,kBAAkB,aAAa,cAAqB,UAAU;AAEpE,gBAAM,SAAoB;AAAA,YACxB,GAAG;AAAA,YACH,GAAG;AAAA,UACL;AAEA,cAAI,iBAAiB;AACnB,mBAAO,eAAe;AAAA,UACxB,WAAW,kBAAkB,QAAQ;AACnC,mBAAO,OAAO;AAAA,UAChB;AAEA,gBAAM,UAAmB;AAAA,YACvB,QAAQ,KAAK;AAAA,YACb,MAAM,GAAG,eAAe,GAAG,KAAK,IAAI;AAAA,YACpC,KAAK;AAAA,UACP;AAEA,gBAAM,KAAK,OAAO;AAAA,QACpB;AAEA,eAAO;AAAA,MACT;AAAA;AAAA,MAGA,IAAyB,KAAQ;AAC/B,eAAO,IAAI,OAAO,GAAG;AAAA,MACvB;AAAA,MACA,KAAwC,KAAQ;AAC9C,eAAO,IAAI,QAAQ,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC5C;AAAA,MACA,IAAuC,KAAQ;AAC7C,eAAO,IAAI,OAAO,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC3C;AAAA,MACA,MAAyC,KAAQ;AAC/C,eAAO,IAAI,SAAS,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC7C;AAAA,MACA,OAA0C,KAAQ;AAChD,eAAO,IAAI,UAAU,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC9C;AAAA,MAEA,OAAO;AACL,eAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAGA,SAAO,WAAW,UAAU,eAAe,MAAS;AACtD;AAQO,IAAM,cAAc,CACzB,MACA,SACG;AACH,SAAO,CAAC,GAAG,MAAM,GAAG,IAAI;AAC1B;;;AC/kBO,IAAM,kBAAkB,CAC7B,QACA,SACyB;AACzB,SAAO,OAAO,MAAM,IAAI;AAC1B;AA6KO,SAAS,YACd,MACA,QACA;AACA,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,qBAAqB,CAAC,GAAG,MAAM;AACjD,UAAM,IAAK,OAAe,CAAC;AAC3B,QAAI,MAAM,UAAa,MAAM,KAAM,OAAM,IAAI,MAAM,kBAAkB,CAAC,EAAE;AACxE,WAAO,OAAO,CAAC;AAAA,EACjB,CAAC;AACH;AAeO,SAAS,cAAiC,MAI9C;AACD,MAAI,IAAI,KAAK,KAAK;AAClB,MAAI,KAAK,QAAQ;AACf,QAAI,YAAuB,GAAG,KAAK,MAAM;AAAA,EAC3C;AACA,SAAO;AAAA,IACL,KAAK,KAAK;AAAA,IACV,GAAI,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,IAC/B,KAAK,SAAS,CAAC;AAAA,EACjB;AACF;AA0DO,SAAS,oBAAoB,MAAgB;AAClD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,KAAK;AAAA,MACH,GAAG,KAAK;AAAA,MACR,YAAY,KAAK,IAAI;AAAA,MAGrB,aAAa,KAAK,IAAI;AAAA,MAGtB,cAAc,KAAK,IAAI;AAAA,MAGvB,cAAc,KAAK,IAAI;AAAA,IAGzB;AAAA,EACF;AACF;;;AC/RO,SAAS,SACd,QACA;AAIA,QAAM,QAAQ,OAAO;AAAA,IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAU;AAAA,EACvE;AAEA,QAAM,MAAM,CAAC,WAAqD;AAChE,WAAO,OAAO,mBAAmB;AAChC,IAAC,OAAO,KAAK,KAAK,EAAa,QAAQ,CAAC,MAAM;AAC7C,YAAM,OAAO,MAAM,CAAC;AACpB,aAAO,OAAO,KAAK,CAAC,EAAE;AAAA,IACxB,CAAC;AAAA,EACH;AAEA,SAAO,EAAE,KAAK,QAAQ,OAAO,IAAI;AACnC;;;ACAO,SAAS,mBAAmB,QAAa,QAAa;AAC3D,SAAO,EAAE,QAAQ,OAAO;AAC1B;","names":[]}

package/dist/index.mjs

@@ -81,7 +81,7 @@ function mergeSchemas(a, b) {
   return a ?? b;
 }
 function resource(base, inherited) {
-  const rootBase = base;
+  const rootBase = base ?? "";
   const rootInherited = { ...inherited };
   function makeBranch(base2, inherited2, mergedParamsSchema) {
     const stack = [];
@@ -113,47 +113,90 @@ function resource(base, inherited) {
       return api;
     }
     const api = {
-      // compose a plain subpath (optional cfg) with optional builder
-      sub(name, cfgOrBuilder, maybeBuilder) {
+      /**
+       * Mount a subtree built elsewhere.
+       *
+       * Usage:
+       *   const users = resource('').get(...).done()
+       *   resource('/api').sub('users', users).done()
+       */
+      sub(name, cfgOrLeaves, maybeLeaves) {
         let cfg;
-        let builder;
-        if (typeof cfgOrBuilder === "function") {
-          builder = cfgOrBuilder;
+        let leaves;
+        if (Array.isArray(cfgOrLeaves)) {
+          leaves = cfgOrLeaves;
         } else {
-          cfg = cfgOrBuilder;
-          builder = maybeBuilder;
+          cfg = cfgOrLeaves;
+          leaves = maybeLeaves;
         }
-        const childBase = `${currentBase}/${name}`;
-        const childInherited = { ...inheritedCfg, ...cfg ?? {} };
-        if (builder) {
-          const child = makeBranch(
-            childBase,
-            childInherited,
-            currentParamsSchema
+        if (!leaves) {
+          throw new Error("sub() expects a leaves array as the last argument");
+        }
+        const childInherited = {
+          ...inheritedCfg,
+          ...cfg ?? {}
+        };
+        const baseForChildren = `${currentBase}/${name}`;
+        for (const leafLow of leaves) {
+          const leaf = leafLow;
+          const leafCfg = leaf.cfg;
+          const leafParams = leafCfg.paramsSchema;
+          const effectiveParams = mergeSchemas(
+            currentParamsSchema,
+            leafParams
           );
-          const leaves = builder(child);
-          for (const l of leaves) stack.push(l);
-          return api;
-        } else {
-          currentBase = childBase;
-          inheritedCfg = childInherited;
-          return api;
+          const newCfg = {
+            ...childInherited,
+            ...leafCfg
+          };
+          if (effectiveParams) {
+            newCfg.paramsSchema = effectiveParams;
+          } else if ("paramsSchema" in newCfg) {
+            delete newCfg.paramsSchema;
+          }
+          const newLeaf = {
+            method: leaf.method,
+            path: `${baseForChildren}${leaf.path}`,
+            cfg: newCfg
+          };
+          stack.push(newLeaf);
         }
+        return api;
       },
-      // the single param function: name + schema + builder
-      routeParameter(name, paramsSchema, builder) {
-        const childBase = `${currentBase}/:${name}`;
+      /**
+       * Introduce a :param segment and mount a subtree under it.
+       *
+       * The subtree is built independently (e.g. resource('').get(...).done())
+       * and its paths become `${currentBase}/:${name}${leaf.path}`.
+       * Params schemas are intersected with the accumulated params plus the new param.
+       */
+      routeParameter(name, paramsSchema, leaves) {
         const paramObj = z.object({
           [name]: paramsSchema
         });
-        const childParams = currentParamsSchema ? mergeSchemas(currentParamsSchema, paramObj) : paramObj;
-        const child = makeBranch(childBase, inheritedCfg, childParams);
-        const leaves = builder(child);
-        for (const l of leaves) stack.push(l);
-        return api;
-      },
-      with(cfg) {
-        inheritedCfg = { ...inheritedCfg, ...cfg };
+        const mergedParams = currentParamsSchema ? mergeSchemas(currentParamsSchema, paramObj) : paramObj;
+        const baseForChildren = `${currentBase}/:${name}`;
+        for (const leafLow of leaves) {
+          const leaf = leafLow;
+          const leafCfg = leaf.cfg;
+          const leafParams = leafCfg.paramsSchema;
+          const effectiveParams = mergeSchemas(mergedParams, leafParams);
+          const newCfg = {
+            ...inheritedCfg,
+            ...leafCfg
+          };
+          if (effectiveParams) {
+            newCfg.paramsSchema = effectiveParams;
+          } else if ("paramsSchema" in newCfg) {
+            delete newCfg.paramsSchema;
+          }
+          const newLeaf = {
+            method: leaf.method,
+            path: `${baseForChildren}${leaf.path}`,
+            cfg: newCfg
+          };
+          stack.push(newLeaf);
+        }
         return api;
       },
       // methods (inject current params schema if missing)

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/sockets/socket.index.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  AnyLeaf,\n  AnyLeafLowProfile,\n  Append,\n  HttpMethod,\n  Leaf,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n  RouteSchema,\n} from './routesV3.core'\n\nconst paginationQueryShape = {\n  pagination_cursor: z.string().optional(),\n  pagination_limit: z.coerce.number().min(1).max(100).default(20),\n}\n\nconst defaultFeedQuerySchema = z.object(paginationQueryShape)\ntype PaginationShape = typeof paginationQueryShape\n\ntype ZodTypeAny = z.ZodTypeAny\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{\n  [K in Name]: S\n}>\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>\ntype ZodObjectAny = z.ZodObject<any>\ntype AnyZodObject = z.ZodObject<any>\ntype MergedParamsResult<\n  PS,\n  Name extends string,\n  P extends ZodTypeAny,\n> = PS extends ZodTypeAny\n  ? z.ZodIntersection<PS, ParamZod<Name, P>>\n  : ParamZod<Name, P>\n\nfunction getZodShape(schema: ZodObjectAny) {\n  const shapeOrGetter = (schema as any).shape\n    ? (schema as any).shape\n    : (schema as any)._def?.shape?.()\n  if (!shapeOrGetter) return {}\n  return typeof shapeOrGetter === 'function'\n    ? shapeOrGetter.call(schema)\n    : shapeOrGetter\n}\n\nfunction collectNestedFieldSuggestions(\n  shape: Record<string, ZodTypeAny> | undefined,\n  prefix: string[] = [],\n): string[] {\n  if (!shape) return []\n  const suggestions: string[] = []\n  for (const [key, value] of Object.entries(shape)) {\n    if (value instanceof z.ZodObject) {\n      const nestedShape = getZodShape(value as ZodObjectAny)\n      const nestedSuggestions = collectNestedFieldSuggestions(nestedShape, [\n        ...prefix,\n        key,\n      ])\n      suggestions.push(\n        ...(nestedSuggestions.length\n          ? nestedSuggestions\n          : [[...prefix, key].join('_')]),\n      )\n    } else if (prefix.length > 0) {\n      suggestions.push([...prefix, key].join('_'))\n    }\n  }\n  return suggestions\n}\n\nconst defaultFeedOutputSchema = z.object({\n  items: z.array(z.unknown()),\n  nextCursor: z.string().optional(),\n})\n\nfunction augmentFeedQuerySchema<Q extends ZodTypeAny | undefined>(schema: Q) {\n  if (schema && !(schema instanceof z.ZodObject)) {\n    console.warn(\n      'Feed queries must be a ZodObject; default pagination applied.',\n    )\n    return defaultFeedQuerySchema\n  }\n\n  const base = (schema as ZodObjectAny) ?? z.object({})\n  const shape = getZodShape(base)\n  const nestedSuggestions = collectNestedFieldSuggestions(shape)\n  if (nestedSuggestions.length) {\n    console.warn(\n      `Feed query schemas should avoid nested objects; consider flattening fields like: ${nestedSuggestions.join(\n        ', ',\n      )}`,\n    )\n  }\n  return base.extend(paginationQueryShape)\n}\n\nfunction augmentFeedOutputSchema<O extends ZodTypeAny | undefined>(schema: O) {\n  if (!schema) return defaultFeedOutputSchema\n  if (schema instanceof z.ZodArray) {\n    return z.object({\n      items: schema,\n      nextCursor: z.string().optional(),\n    })\n  }\n  if (schema instanceof z.ZodObject) {\n    const shape = (schema as any).shape\n      ? (schema as any).shape\n      : (schema as any)._def?.shape?.()\n    const hasItems = Boolean(shape?.items)\n    if (hasItems) {\n      return schema.extend({ nextCursor: z.string().optional() })\n    }\n    return z.object({\n      items: z.array(schema as ZodTypeAny),\n      nextCursor: z.string().optional(),\n    })\n  }\n  return z.object({\n    items: z.array(schema as ZodTypeAny),\n    nextCursor: z.string().optional(),\n  })\n}\n\n/**\n * Runtime helper that mirrors the typed merge used by the builder.\n * @param a Previously merged params schema inherited from parent segments.\n * @param b Newly introduced params schema.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nfunction mergeSchemas<A extends ZodTypeAny, B extends ZodTypeAny>(\n  a: A,\n  b: B,\n): ZodTypeAny\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B\nfunction mergeSchemas(\n  a: ZodTypeAny | undefined,\n  b: ZodTypeAny | undefined,\n): ZodTypeAny | undefined\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined) {\n  if (a && b) return z.intersection(a as any, b as any)\n  return (a ?? b) as ZodTypeAny | undefined\n}\n\ntype FeedOutputSchema<C extends MethodCfg> =\n  C['outputSchema'] extends ZodArrayAny\n    ? z.ZodObject<{\n        items: C['outputSchema']\n        nextCursor: z.ZodOptional<z.ZodString>\n      }>\n    : C['outputSchema'] extends ZodTypeAny\n    ? z.ZodObject<{\n        items: z.ZodArray<C['outputSchema']>\n        nextCursor: z.ZodOptional<z.ZodString>\n      }>\n    : typeof defaultFeedOutputSchema\n\ntype BaseMethodCfg<C extends MethodCfg> = Merge<\n  Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>,\n  Omit<C, 'querySchema' | 'outputSchema' | 'feed'>\n>\n\ntype FeedField<C extends MethodCfg> = C['feed'] extends true\n  ? { feed: true }\n  : { feed?: boolean }\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> =\n  Q extends z.ZodObject<infer Shape>\n    ? z.ZodObject<Shape & PaginationShape>\n    : z.ZodObject<PaginationShape>\n\ntype FeedQueryField<C extends MethodCfg> = {\n  querySchema: AddPaginationToQuery<\n    C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined\n  >\n}\n\ntype NonFeedQueryField<C extends MethodCfg> =\n  C['querySchema'] extends ZodTypeAny\n    ? { querySchema: C['querySchema'] }\n    : { querySchema?: undefined }\n\ntype FeedOutputField<C extends MethodCfg> = {\n  outputSchema: FeedOutputSchema<C>\n}\n\ntype NonFeedOutputField<C extends MethodCfg> =\n  C['outputSchema'] extends ZodTypeAny\n    ? { outputSchema: C['outputSchema'] }\n    : { outputSchema?: undefined }\n\ntype ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny\n  ? { paramsSchema: C['paramsSchema'] }\n  : { paramsSchema: PS }\n\ntype EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true\n  ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS>\n  : FeedField<C> &\n      NonFeedQueryField<C> &\n      NonFeedOutputField<C> &\n      ParamsField<C, PS>\n\ntype EffectiveCfg<C extends MethodCfg, PS> = Prettify<\n  Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>\n>\n\ntype ToRouteSchema<S> = S extends ZodTypeAny ? RouteSchema<z.output<S>> : S\n\ntype LowProfileCfg<Cfg extends MethodCfg> = Prettify<\n  Omit<Cfg, 'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'> & {\n    bodySchema: ToRouteSchema<Cfg['bodySchema']>\n    querySchema: ToRouteSchema<Cfg['querySchema']>\n    paramsSchema: ToRouteSchema<Cfg['paramsSchema']>\n    outputSchema: ToRouteSchema<Cfg['outputSchema']>\n  }\n>\n\ntype BuiltLeaf<\n  M extends HttpMethod,\n  Base extends string,\n  I extends NodeCfg,\n  C extends MethodCfg,\n  PS,\n> = Leaf<M, Base, Merge<I, LowProfileCfg<EffectiveCfg<C, PS>>>>\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeafLowProfile[],\n  I extends NodeCfg,\n  PS extends ZodTypeAny | undefined,\n> {\n  // --- structure ---\n  /**\n   * Enter or define a static child segment.\n   * Optionally accepts extra config and/or a builder to populate nested routes.\n   * @param name Child segment literal (no leading slash).\n   * @param cfg Optional node configuration to merge for descendants.\n   * @param builder Callback to produce leaves for the child branch.\n   */\n  sub<Name extends string, J extends NodeCfg>(\n    name: Name,\n    cfg?: J,\n  ): Branch<`${Base}/${Name}`, Acc, Merge<I, NonNullable<J>>, PS>\n\n  sub<\n    Name extends string,\n    J extends NodeCfg | undefined,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    cfg: J,\n    builder: (\n      r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>,\n    ) => R,\n  ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>\n\n  sub<Name extends string, R extends readonly AnyLeafLowProfile[]>(\n    name: Name,\n    builder: (r: Branch<`${Base}/${Name}`, readonly [], I, PS>) => R,\n  ): Branch<Base, MergeArray<Acc, R>, I, PS>\n\n  // --- parameterized segment (single signature) ---\n  /**\n   * Introduce a `:param` segment and merge its schema into downstream leaves.\n   * @param name Parameter key (without leading colon).\n   * @param paramsSchema Zod schema for the parameter value.\n   * @param builder Callback that produces leaves beneath the parameterized segment.\n   */\n  routeParameter<\n    Name extends string,\n    P extends ZodTypeAny,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    paramsSchema: P,\n    builder: (\n      r: Branch<\n        `${Base}/:${Name}`,\n        readonly [],\n        I,\n        MergedParamsResult<PS, Name, P>\n      >,\n    ) => R,\n  ): Branch<Base, MergeArray<Acc, R>, I, MergedParamsResult<PS, Name, P>>\n\n  // --- flags inheritance ---\n  /**\n   * Merge additional node configuration that subsequent leaves will inherit.\n   * @param cfg Partial node configuration.\n   */\n  with<J extends NodeCfg>(cfg: J): Branch<Base, Acc, Merge<I, J>, PS>\n\n  // --- methods (return Branch to keep chaining) ---\n  /**\n   * Register a GET leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  get<C extends MethodCfg>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>,\n    I,\n    PS\n  >\n\n  /**\n   * Register a POST leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  post<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'post', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  /**\n   * Register a PUT leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  put<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'put', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  /**\n   * Register a PATCH leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  patch<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'patch', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  /**\n   * Register a DELETE leaf at the current path.\n   * @param cfg Method configuration (schemas, flags, descriptions, etc).\n   */\n  delete<C extends Omit<MethodCfg, 'feed'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<\n      Acc,\n      Prettify<BuiltLeaf<'delete', Base, I, Merge<C, { feed: false }>, PS>>\n    >,\n    I,\n    PS\n  >\n\n  // --- finalize this subtree ---\n  /**\n   * Finish the branch and return the collected leaves.\n   * @returns Readonly tuple of accumulated leaves.\n   */\n  done(): Readonly<Acc>\n}\n\n/**\n * Start building a resource at the given base path.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Optional node configuration applied to all descendants.\n * @returns Root `Branch` instance used to compose the route tree.\n */\nexport function resource<Base extends string, I extends NodeCfg = {}>(\n  base: Base,\n  inherited?: I,\n): Branch<Base, readonly [], I, undefined> {\n  const rootBase = base\n  const rootInherited: NodeCfg = { ...(inherited as NodeCfg) }\n\n  function makeBranch<\n    Base2 extends string,\n    I2 extends NodeCfg,\n    PS2 extends ZodTypeAny | undefined,\n  >(base2: Base2, inherited2: I2, mergedParamsSchema?: PS2) {\n    const stack: AnyLeaf[] = []\n    let currentBase: string = base2\n    let inheritedCfg: NodeCfg = { ...(inherited2 as NodeCfg) }\n    let currentParamsSchema: PS2 = mergedParamsSchema as PS2\n\n    function add<M extends HttpMethod, C extends MethodCfg>(method: M, cfg: C) {\n      // If the method didn’t provide a paramsSchema, inject the active merged one.\n      const effectiveParamsSchema = (cfg.paramsSchema ??\n        currentParamsSchema) as PS2 | undefined\n      const effectiveQuerySchema =\n        cfg.feed === true\n          ? augmentFeedQuerySchema(cfg.querySchema)\n          : cfg.querySchema\n      const effectiveOutputSchema =\n        cfg.feed === true\n          ? augmentFeedOutputSchema(cfg.outputSchema)\n          : cfg.outputSchema\n\n      const fullCfg = (\n        effectiveParamsSchema\n          ? {\n              ...inheritedCfg,\n              ...cfg,\n              paramsSchema: effectiveParamsSchema,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n          : {\n              ...inheritedCfg,\n              ...cfg,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n      ) as any\n\n      const leaf = {\n        method,\n        path: currentBase as Base2,\n        cfg: fullCfg,\n      } as const\n\n      stack.push(leaf as unknown as AnyLeaf)\n\n      // Return same runtime obj, but with Acc including this new leaf\n      return api as unknown as Branch<\n        Base2,\n        Append<readonly [], typeof leaf>,\n        I2,\n        PS2\n      >\n    }\n\n    const api: any = {\n      // compose a plain subpath (optional cfg) with optional builder\n      sub<Name extends string, J extends NodeCfg | undefined = undefined>(\n        name: Name,\n        cfgOrBuilder?: J | ((r: any) => readonly AnyLeafLowProfile[]),\n        maybeBuilder?: (r: any) => readonly AnyLeafLowProfile[],\n      ) {\n        let cfg: NodeCfg | undefined\n        let builder: ((r: any) => readonly AnyLeafLowProfile[]) | undefined\n\n        if (typeof cfgOrBuilder === 'function') {\n          builder = cfgOrBuilder as any\n        } else {\n          cfg = cfgOrBuilder as NodeCfg | undefined\n          builder = maybeBuilder\n        }\n\n        const childBase = `${currentBase}/${name}` as const\n        const childInherited = { ...inheritedCfg, ...(cfg ?? {}) } as Merge<\n          I2,\n          NonNullable<J>\n        >\n\n        if (builder) {\n          // params schema PS2 flows through unchanged on plain sub\n          const child = makeBranch(\n            childBase,\n            childInherited,\n            currentParamsSchema,\n          )\n          const leaves = builder(child) //as readonly AnyLeafLowProfile[]\n          for (const l of leaves) stack.push(l)\n          return api as Branch<\n            Base2,\n            Append<readonly [], (typeof leaves)[number]>,\n            typeof childInherited,\n            PS2\n          >\n        } else {\n          currentBase = childBase\n          inheritedCfg = childInherited\n          return api as Branch<\n            `${Base2}/${Name}`,\n            readonly [],\n            typeof childInherited,\n            PS2\n          >\n        }\n      },\n\n      // the single param function: name + schema + builder\n      routeParameter<\n        Name extends string,\n        P extends ZodTypeAny,\n        R extends readonly AnyLeafLowProfile[],\n      >(\n        name: Name,\n        paramsSchema: P,\n        builder: (\n          r: Branch<\n            `${Base2}/:${Name}`,\n            readonly [],\n            I2,\n            MergedParamsResult<PS2, Name, P>\n          >,\n        ) => R,\n      ) {\n        const childBase = `${currentBase}/:${name}` as const\n        // Wrap the value schema under the param name before merging with inherited params schema\n        const paramObj: ParamZod<Name, P> = z.object({\n          [name]: paramsSchema,\n        } as Record<Name, P>)\n        const childParams = (\n          currentParamsSchema\n            ? mergeSchemas(currentParamsSchema, paramObj)\n            : paramObj\n        ) as MergedParamsResult<PS2, Name, P>\n        const child = makeBranch(childBase, inheritedCfg as I2, childParams)\n        const leaves = builder(child)\n        for (const l of leaves) stack.push(l)\n        return api as Branch<\n          Base2,\n          Append<readonly [], (typeof leaves)[number]>,\n          I2,\n          MergedParamsResult<PS2, Name, P>\n        >\n      },\n\n      with<J extends NodeCfg>(cfg: J) {\n        inheritedCfg = { ...inheritedCfg, ...cfg }\n        return api as Branch<Base2, readonly [], Merge<I2, J>, PS2>\n      },\n\n      // methods (inject current params schema if missing)\n      get<C extends MethodCfg>(cfg: C) {\n        return add('get', cfg)\n      },\n      post<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('post', { ...cfg, feed: false })\n      },\n      put<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('put', { ...cfg, feed: false })\n      },\n      patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('patch', { ...cfg, feed: false })\n      },\n      delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('delete', { ...cfg, feed: false })\n      },\n\n      done() {\n        return stack\n      },\n    }\n\n    return api as Branch<Base2, readonly [], I2, PS2>\n  }\n\n  // Root branch starts with no params schema (PS = undefined)\n  return makeBranch(rootBase, rootInherited, undefined)\n}\n\n/**\n * Merge two readonly tuples (preserves literal tuple information).\n * @param arr1 First tuple.\n * @param arr2 Second tuple.\n * @returns New tuple containing values from both inputs.\n */\nexport const mergeArrays = <T extends readonly any[], S extends readonly any[]>(\n  arr1: T,\n  arr2: S,\n) => {\n  return [...arr1, ...arr2] as [...T, ...S]\n}\n","import { z, ZodType } from 'zod'\n\n/** Supported HTTP verbs for the routes DSL. */\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete'\n\n/** Declarative description of a multipart upload field. */\nexport type FileField = {\n  /** Form field name used for uploads. */\n  name: string\n  /** Maximum number of files accepted for this field. */\n  maxCount: number\n}\n\n/** Configuration that applies to an entire branch of the route tree. */\nexport type NodeCfg = {\n  /** @deprecated. Does nothing. */\n  authenticated?: boolean\n}\n\nexport type RouteSchema<Output = unknown> = ZodType & {\n  __out: Output\n}\n\nexport type RouteSchemaOutput<Schema extends ZodType> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport const lowProfileParse = <T extends RouteSchema>(\n  schema: T,\n  data: unknown,\n): RouteSchemaOutput<T> => {\n  return schema.parse(data) as RouteSchemaOutput<T>\n}\n\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg = {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodType\n  /** Zod schema describing the query string. */\n  querySchema?: ZodType\n  /** Zod schema describing path params (overrides inferred params). */\n  paramsSchema?: ZodType\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodType\n  /** Multipart upload definitions for the route. */\n  bodyFiles?: FileField[]\n  /** Marks the route as an infinite feed (enables cursor helpers). */\n  feed?: boolean\n\n  /** Optional human-readable description for docs/debugging. */\n  description?: string\n  /**\n   * Short one-line summary for docs list views.\n   * Shown in navigation / tables instead of the full description.\n   */\n  summary?: string\n  /**\n   * Group name used for navigation sections in docs UIs.\n   * e.g. \"Users\", \"Billing\", \"Auth\".\n   */\n  docsGroup?: string\n  /**\n   * Tags that can be used to filter / facet in interactive docs.\n   * e.g. [\"users\", \"admin\", \"internal\"].\n   */\n  tags?: string[]\n  /**\n   * Mark the route as deprecated in docs.\n   * Renderers can badge this and/or hide by default.\n   */\n  deprecated?: boolean\n  /**\n   * Optional stability information for the route.\n   * Renderers can surface this prominently.\n   */\n  stability?: 'experimental' | 'beta' | 'stable' | 'deprecated'\n  /**\n   * Hide this route from public docs while keeping it usable in code.\n   */\n  docsHidden?: boolean\n  /**\n   * Arbitrary extra metadata for docs renderers.\n   * Can be used for auth requirements, rate limits, feature flags, etc.\n   */\n  docsMeta?: Record<string, unknown>\n}\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<\n  M extends HttpMethod,\n  P extends string,\n  C extends MethodCfg,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n\n/** Convenience union covering all generated leaves. */\nexport type AnyLeaf = Leaf<HttpMethod, string, MethodCfg>\n\n/** Merge two object types while keeping nice IntelliSense output. */\nexport type Merge<A, B> = Prettify<Omit<A, keyof B> & B>\n\n/** Append a new element to a readonly tuple type. */\nexport type Append<T extends readonly unknown[], X> = [...T, X]\n\n/** Concatenate two readonly tuple types. */\nexport type MergeArray<\n  A extends readonly unknown[],\n  B extends readonly unknown[],\n> = [...A, ...B]\n\n// helpers (optional)\ntype SegmentParams<S extends string> = S extends `:${infer P}` ? P : never\ntype Split<S extends string> = S extends ''\n  ? []\n  : S extends `${infer A}/${infer B}`\n  ? [A, ...Split<B>]\n  : [S]\ntype ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>\n\n/** Derive a params object type from a literal route string. */\nexport type ExtractParamsFromPath<Path extends string> =\n  ExtractParamNames<Path> extends never\n    ? never\n    : Record<ExtractParamNames<Path>, string | number>\n\n/**\n * Interpolate `:params` in a path using the given values.\n * @param path Literal route string containing `:param` segments.\n * @param params Object of parameter values to interpolate.\n * @returns Path string with parameters substituted.\n */\nexport function compilePath<Path extends string>(\n  path: Path,\n  params: ExtractParamsFromPath<Path>,\n) {\n  if (!params) return path\n  return path.replace(/:([A-Za-z0-9_]+)/g, (_, k) => {\n    const v = (params as any)[k]\n    if (v === undefined || v === null) throw new Error(`Missing param :${k}`)\n    return String(v)\n  })\n}\n\n/**\n * Build a deterministic cache key for the given leaf.\n * The key matches the shape consumed by React Query helpers.\n * @param args.leaf Leaf describing the endpoint.\n * @param args.params Optional params used to build the path.\n * @param args.query Optional query payload.\n * @returns Tuple suitable for React Query cache keys.\n */\ntype SplitPath<P extends string> = P extends ''\n  ? []\n  : P extends `${infer A}/${infer B}`\n  ? [A, ...SplitPath<B>]\n  : [P]\nexport function buildCacheKey<L extends AnyLeaf>(args: {\n  leaf: L\n  params?: ExtractParamsFromPath<L['path']>\n  query?: InferQuery<L>\n}) {\n  let p = args.leaf.path\n  if (args.params) {\n    p = compilePath<L['path']>(p, args.params)\n  }\n  return [\n    args.leaf.method,\n    ...(p.split('/').filter(Boolean) as SplitPath<typeof p>),\n    args.query ?? {},\n  ] as const\n}\n\n/** Definition-time method config (for clarity). */\nexport type MethodCfgDef = MethodCfg\n\n/** Low-profile method config where schemas carry a phantom __out like SocketSchema. */\nexport type MethodCfgLowProfile = Omit<\n  MethodCfg,\n  'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n> & {\n  bodySchema?: RouteSchema\n  querySchema?: RouteSchema\n  paramsSchema?: RouteSchema\n  outputSchema?: RouteSchema\n}\nexport type AnyLeafLowProfile = LeafLowProfile<\n  HttpMethod,\n  string,\n  MethodCfgLowProfile\n>\n\nexport function buildLowProfileLeaf<\n  const M extends HttpMethod,\n  const Path extends string,\n  const O extends ZodType | undefined = undefined,\n  const P extends ZodType | undefined = undefined,\n  const Q extends ZodType | undefined = undefined,\n  const B extends ZodType | undefined = undefined,\n  const Feed extends boolean = false,\n>(leaf: {\n  method: M\n  path: Path\n  cfg: Omit<\n    MethodCfg,\n    'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n  > & {\n    feed?: Feed\n    bodySchema?: B\n    querySchema?: Q\n    paramsSchema?: P\n    outputSchema?: O\n  }\n}): LeafLowProfile<\n  M,\n  Path,\n  Prettify<\n    Omit<\n      MethodCfg,\n      'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema' | 'feed'\n    > & {\n      feed: Feed\n      bodySchema: B extends ZodType ? RouteSchema<z.infer<B>> : undefined\n      querySchema: Q extends ZodType ? RouteSchema<z.infer<Q>> : undefined\n      paramsSchema: P extends ZodType ? RouteSchema<z.infer<P>> : undefined\n      outputSchema: O extends ZodType ? RouteSchema<z.infer<O>> : undefined\n    }\n  >\n>\nexport function buildLowProfileLeaf(leaf: any): any {\n  return {\n    ...leaf,\n    cfg: {\n      ...leaf.cfg,\n      bodySchema: leaf.cfg.bodySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.bodySchema>\n      >,\n      querySchema: leaf.cfg.querySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.querySchema>\n      >,\n      paramsSchema: leaf.cfg.paramsSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.paramsSchema>\n      >,\n      outputSchema: leaf.cfg.outputSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.outputSchema>\n      >,\n    },\n  }\n}\n\nexport type LeafLowProfile<\n  M extends HttpMethod,\n  P extends string,\n  C extends MethodCfgLowProfile,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<\n  L extends AnyLeafLowProfile,\n  Fallback = never,\n> = L['cfg']['paramsSchema'] extends RouteSchema<infer P> ? P : Fallback\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<\n  L extends AnyLeaf,\n  Fallback = never,\n> = L['cfg']['querySchema'] extends RouteSchema<infer Q> ? Q : Fallback\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<\n  L extends AnyLeaf,\n  Fallback = never,\n> = L['cfg']['bodySchema'] extends RouteSchema<infer B> ? B : Fallback\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<\n  L extends AnyLeaf,\n  Fallback = never,\n> = L['cfg']['outputSchema'] extends RouteSchema<infer O> ? O : Fallback\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {}\n","// TODO:\n// * use this as a transform that infers the types from Zod, to only pass the types around instead of the full schemas -> make converters that go both ways (data to schema, schema to data)\n// * consider moving to core package\n// * update server and client side to use this type instead of raw zod schemas\nimport { AnyLeafLowProfile, HttpMethod, Prettify } from './routesV3.core'\n\n/** Build the key type for a leaf — distributive so method/path stay paired. */\nexport type KeyOf<L extends AnyLeafLowProfile> = L extends AnyLeafLowProfile\n  ? `${Uppercase<L['method']>} ${L['path']}`\n  : never\n\n// From a tuple of leaves, get the union of keys (pairwise, no cartesian blow-up)\ntype KeysOf<Leaves extends readonly AnyLeafLowProfile[]> = KeyOf<Leaves[number]>\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n  ? Lowercase<M>\n  : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n  ? P\n  : never\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<\n  Leaves extends readonly AnyLeafLowProfile[],\n  K extends string,\n> = Extract<\n  Leaves[number],\n  { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/**\n * Freeze a leaf tuple into a registry with typed key lookups.\n * @param leaves Readonly tuple of leaves produced by the builder DSL.\n * @returns Registry containing the leaves array and a `byKey` lookup map.\n */\nexport function finalize<const L extends readonly AnyLeafLowProfile[]>(\n  leaves: L,\n) {\n  type Keys = KeysOf<L>\n  type MapByKey = { [K in Keys]: Prettify<LeafForKey<L, K>> }\n\n  const byKey = Object.fromEntries(\n    leaves.map((l) => [`${l.method.toUpperCase()} ${l.path}`, l] as const),\n  ) as unknown as MapByKey\n\n  const log = (logger: { system: (...args: unknown[]) => void }) => {\n    logger.system('Finalized routes:')\n    ;(Object.keys(byKey) as Keys[]).forEach((k) => {\n      const leaf = byKey[k]\n      logger.system(`- ${k}`)\n    })\n  }\n\n  return { all: leaves, byKey, log }\n}\n\n/** Nominal type alias for a finalized registry. */\nexport type Registry<R extends ReturnType<typeof finalize>> = R\n\ntype FilterRoute<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n  Acc extends readonly AnyLeafLowProfile[] = [],\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? First extends { path: `${string}${F}${string}` }\n    ? FilterRoute<Rest, F, [...Acc, First]>\n    : FilterRoute<Rest, F, Acc>\n  : Acc\n\ntype UpperCase<S extends string> = S extends `${infer First}${infer Rest}`\n  ? `${Uppercase<First>}${UpperCase<Rest>}`\n  : S\n\ntype Routes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = FilterRoute<T, F>\ntype ByKey<\n  T extends readonly AnyLeafLowProfile[],\n  Acc extends Record<string, AnyLeafLowProfile> = {},\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? ByKey<\n      Rest,\n      Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }\n    >\n  : Acc\n\n/**\n * Convenience helper for extracting a subset of routes by path fragment.\n * @param T Tuple of leaves produced by the DSL.\n * @param F String fragment to match against the route path.\n */\nexport type SubsetRoutes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = {\n  byKey: ByKey<Routes<T, F>>\n  all: Routes<T, F>\n}\n","// socket.index.ts (shared client/server)\n\nimport { z } from 'zod'\n\nexport type SocketSchema<Output = unknown> = z.ZodType & {\n  __out: Output\n}\n\nexport type SocketSchemaOutput<Schema extends z.ZodTypeAny> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport type SocketEvent<Out = unknown> = {\n  message: z.ZodTypeAny\n  /** phantom field, only for typing; not meant to be used at runtime */\n  __out: Out\n}\n\nexport type EventMap = Record<string, SocketEvent<any>>\n\n/**\n * System event names – shared so server and client\n * don't drift on naming.\n */\nexport type SysEventName =\n  | 'sys:connect'\n  | 'sys:disconnect'\n  | 'sys:reconnect'\n  | 'sys:connect_error'\n  | 'sys:ping'\n  | 'sys:pong'\n  | 'sys:room_join'\n  | 'sys:room_leave'\nexport function defineSocketEvents<\n  const C extends SocketConnectionConfig,\n  const Schemas extends Record<\n    string,\n    {\n      message: z.ZodTypeAny\n    }\n  >,\n>(\n  config: C,\n  events: Schemas,\n): {\n  config: {\n    [K in keyof C]: SocketSchema<z.output<C[K]>>\n  }\n  events: {\n    [K in keyof Schemas]: SocketEvent<z.output<Schemas[K]['message']>>\n  }\n}\n\nexport function defineSocketEvents(config: any, events: any) {\n  return { config, events }\n}\n\nexport type Payload<\n  T extends EventMap,\n  K extends keyof T,\n> = T[K] extends SocketEvent<infer Out> ? Out : never\nexport type SocketConnectionConfig = {\n  joinMetaMessage: z.ZodTypeAny\n  leaveMetaMessage: z.ZodTypeAny\n  pingPayload: z.ZodTypeAny\n  pongPayload: z.ZodTypeAny\n}\n\nexport type SocketConnectionConfigOutput = {\n  joinMetaMessage: SocketSchema<any>\n  leaveMetaMessage: SocketSchema<any>\n  pingPayload: SocketSchema<any>\n  pongPayload: SocketSchema<any>\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/sockets/socket.index.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  AnyLeaf,\n  AnyLeafLowProfile,\n  Append,\n  AugmentLeaves,\n  HttpMethod,\n  Leaf,\n  LowProfileCfg,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n} from './routesV3.core'\n\nconst paginationQueryShape = {\n  pagination_cursor: z.string().optional(),\n  pagination_limit: z.coerce.number().min(1).max(100).default(20),\n}\n\nconst defaultFeedQuerySchema = z.object(paginationQueryShape)\ntype PaginationShape = typeof paginationQueryShape\n\ntype ZodTypeAny = z.ZodTypeAny\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{\n  [K in Name]: S\n}>\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>\ntype ZodObjectAny = z.ZodObject<any>\ntype AnyZodObject = z.ZodObject<any>\ntype MergedParamsResult<\n  PS,\n  Name extends string,\n  P extends ZodTypeAny,\n> = PS extends ZodTypeAny\n  ? z.ZodIntersection<PS, ParamZod<Name, P>>\n  : ParamZod<Name, P>\n\nfunction getZodShape(schema: ZodObjectAny) {\n  const shapeOrGetter = (schema as any).shape\n    ? (schema as any).shape\n    : (schema as any)._def?.shape?.()\n  if (!shapeOrGetter) return {}\n  return typeof shapeOrGetter === 'function'\n    ? shapeOrGetter.call(schema)\n    : shapeOrGetter\n}\n\nfunction collectNestedFieldSuggestions(\n  shape: Record<string, ZodTypeAny> | undefined,\n  prefix: string[] = [],\n): string[] {\n  if (!shape) return []\n  const suggestions: string[] = []\n  for (const [key, value] of Object.entries(shape)) {\n    if (value instanceof z.ZodObject) {\n      const nestedShape = getZodShape(value as ZodObjectAny)\n      const nestedSuggestions = collectNestedFieldSuggestions(nestedShape, [\n        ...prefix,\n        key,\n      ])\n      suggestions.push(\n        ...(nestedSuggestions.length\n          ? nestedSuggestions\n          : [[...prefix, key].join('_')]),\n      )\n    } else if (prefix.length > 0) {\n      suggestions.push([...prefix, key].join('_'))\n    }\n  }\n  return suggestions\n}\n\nconst defaultFeedOutputSchema = z.object({\n  items: z.array(z.unknown()),\n  nextCursor: z.string().optional(),\n})\n\nfunction augmentFeedQuerySchema<Q extends ZodTypeAny | undefined>(schema: Q) {\n  if (schema && !(schema instanceof z.ZodObject)) {\n    console.warn(\n      'Feed queries must be a ZodObject; default pagination applied.',\n    )\n    return defaultFeedQuerySchema\n  }\n\n  const base = (schema as ZodObjectAny) ?? z.object({})\n  const shape = getZodShape(base)\n  const nestedSuggestions = collectNestedFieldSuggestions(shape)\n  if (nestedSuggestions.length) {\n    console.warn(\n      `Feed query schemas should avoid nested objects; consider flattening fields like: ${nestedSuggestions.join(\n        ', ',\n      )}`,\n    )\n  }\n  return base.extend(paginationQueryShape)\n}\n\nfunction augmentFeedOutputSchema<O extends ZodTypeAny | undefined>(schema: O) {\n  if (!schema) return defaultFeedOutputSchema\n  if (schema instanceof z.ZodArray) {\n    return z.object({\n      items: schema,\n      nextCursor: z.string().optional(),\n    })\n  }\n  if (schema instanceof z.ZodObject) {\n    const shape = (schema as any).shape\n      ? (schema as any).shape\n      : (schema as any)._def?.shape?.()\n    const hasItems = Boolean(shape?.items)\n    if (hasItems) {\n      return schema.extend({ nextCursor: z.string().optional() })\n    }\n    return z.object({\n      items: z.array(schema as ZodTypeAny),\n      nextCursor: z.string().optional(),\n    })\n  }\n  return z.object({\n    items: z.array(schema as ZodTypeAny),\n    nextCursor: z.string().optional(),\n  })\n}\n\n/**\n * Runtime helper that mirrors the typed merge used by the builder.\n * @param a Previously merged params schema inherited from parent segments.\n * @param b Newly introduced params schema.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nfunction mergeSchemas<A extends ZodTypeAny, B extends ZodTypeAny>(\n  a: A,\n  b: B,\n): ZodTypeAny\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B\nfunction mergeSchemas(\n  a: ZodTypeAny | undefined,\n  b: ZodTypeAny | undefined,\n): ZodTypeAny | undefined\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined) {\n  if (a && b) return z.intersection(a as any, b as any)\n  return (a ?? b) as ZodTypeAny | undefined\n}\n\ntype FeedOutputSchema<C extends MethodCfg> =\n  C['outputSchema'] extends ZodArrayAny\n    ? z.ZodObject<{\n        items: C['outputSchema']\n        nextCursor: z.ZodOptional<z.ZodString>\n      }>\n    : C['outputSchema'] extends ZodTypeAny\n      ? z.ZodObject<{\n          items: z.ZodArray<C['outputSchema']>\n          nextCursor: z.ZodOptional<z.ZodString>\n        }>\n      : typeof defaultFeedOutputSchema\n\ntype BaseMethodCfg<C extends MethodCfg> = Merge<\n  Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>,\n  Omit<C, 'querySchema' | 'outputSchema' | 'feed'>\n>\n\ntype FeedField<C extends MethodCfg> = C['feed'] extends true\n  ? { feed: true }\n  : { feed?: boolean }\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> =\n  Q extends z.ZodObject<infer Shape>\n    ? z.ZodObject<Shape & PaginationShape>\n    : z.ZodObject<PaginationShape>\n\ntype FeedQueryField<C extends MethodCfg> = {\n  querySchema: AddPaginationToQuery<\n    C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined\n  >\n}\n\ntype NonFeedQueryField<C extends MethodCfg> =\n  C['querySchema'] extends ZodTypeAny\n    ? { querySchema: C['querySchema'] }\n    : { querySchema?: undefined }\n\ntype FeedOutputField<C extends MethodCfg> = {\n  outputSchema: FeedOutputSchema<C>\n}\n\ntype NonFeedOutputField<C extends MethodCfg> =\n  C['outputSchema'] extends ZodTypeAny\n    ? { outputSchema: C['outputSchema'] }\n    : { outputSchema?: undefined }\n\ntype ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny\n  ? { paramsSchema: C['paramsSchema'] }\n  : { paramsSchema: PS }\n\ntype EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true\n  ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS>\n  : FeedField<C> &\n      NonFeedQueryField<C> &\n      NonFeedOutputField<C> &\n      ParamsField<C, PS>\n\ntype EffectiveCfg<C extends MethodCfg, PS> = Prettify<\n  Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>\n>\n\ntype BuiltLeaf<\n  M extends HttpMethod,\n  Base extends string,\n  I extends NodeCfg,\n  C extends MethodCfg,\n  PS,\n> = Leaf<M, Base, Merge<I, LowProfileCfg<EffectiveCfg<C, PS>>>>\n\ntype MethodFns<\n  Base extends string,\n  Acc extends readonly AnyLeafLowProfile[],\n  I extends NodeCfg,\n  PS extends ZodTypeAny | undefined,\n  Used extends HttpMethod,\n> = {\n  /**\n   * Register a GET leaf at the current path.\n   */\n  get: 'get' extends Used\n    ? never\n    : <C extends MethodCfg>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>,\n        I,\n        PS,\n        Used | 'get'\n      >\n\n  /**\n   * Register a POST leaf at the current path.\n   */\n  post: 'post' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'post', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'post'\n      >\n\n  /**\n   * Register a PUT leaf at the current path.\n   */\n  put: 'put' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'put', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'put'\n      >\n\n  /**\n   * Register a PATCH leaf at the current path.\n   */\n  patch: 'patch' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'patch', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'patch'\n      >\n\n  /**\n   * Register a DELETE leaf at the current path.\n   */\n  delete: 'delete' extends Used\n    ? never\n    : <C extends Omit<MethodCfg, 'feed'>>(\n        cfg: C,\n      ) => Branch<\n        Base,\n        Append<\n          Acc,\n          Prettify<BuiltLeaf<'delete', Base, I, Merge<C, { feed: false }>, PS>>\n        >,\n        I,\n        PS,\n        Used | 'delete'\n      >\n}\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeafLowProfile[],\n  I extends NodeCfg,\n  PS extends ZodTypeAny | undefined,\n  Used extends HttpMethod = never,\n> extends MethodFns<Base, Acc, I, PS, Used> {\n  /**\n   * Mount a static subtree under `name`.\n   * The `leaves` are built externally via `resource(...)` and will be\n   * rebased so that their paths become `${Base}/${name}${leaf.path}` and their\n   * paramsSchemas are merged with the parameters already accumulated on this branch.\n   */\n  sub<Name extends string, R extends readonly AnyLeafLowProfile[]>(\n    name: Name,\n    leaves: R,\n  ): Branch<\n    Base,\n    MergeArray<Acc, AugmentLeaves<`${Base}/${Name}`, PS, R>>,\n    I,\n    PS,\n    Used\n  >\n\n  /**\n   * Mount a static subtree under `name` and merge extra node-level config.\n   */\n  sub<\n    Name extends string,\n    J extends NodeCfg,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    cfg: J,\n    leaves: R,\n  ): Branch<\n    Base,\n    MergeArray<Acc, AugmentLeaves<`${Base}/${Name}`, PS, R>>,\n    Merge<I, J>,\n    PS,\n    Used\n  >\n\n  /**\n   * Introduce a `:param` segment and mount a pre-built subtree beneath it.\n   * The subtree paths are rebased to `${Base}/:${Name}${leaf.path}` and\n   * their paramsSchemas are intersected with the accumulated params plus this new param.\n   */\n  routeParameter<\n    Name extends string,\n    P extends ZodTypeAny,\n    R extends readonly AnyLeafLowProfile[],\n  >(\n    name: Name,\n    paramsSchema: P,\n    leaves: R,\n  ): Branch<\n    Base,\n    MergeArray<\n      Acc,\n      AugmentLeaves<`${Base}/:${Name}`, MergedParamsResult<PS, Name, P>, R>\n    >,\n    I,\n    PS,\n    Used\n  >\n\n  /**\n   * Finish the branch and return the collected leaves.\n   * @returns Readonly tuple of accumulated leaves.\n   */\n  done(): Readonly<Acc>\n}\n\n/**\n * Start building a resource at the given base path.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Optional node configuration applied to all descendants.\n * @returns Root `Branch` instance used to compose the route tree.\n */\nexport function resource<Base extends string = '', I extends NodeCfg = {}>(\n  base?: Base,\n  inherited?: I,\n): Branch<Base, readonly [], I, undefined> {\n  const rootBase = (base ?? '') as Base\n  const rootInherited: NodeCfg = { ...(inherited as NodeCfg) }\n\n  function makeBranch<\n    Base2 extends string,\n    I2 extends NodeCfg,\n    PS2 extends ZodTypeAny | undefined,\n  >(base2: Base2, inherited2: I2, mergedParamsSchema?: PS2) {\n    const stack: AnyLeaf[] = []\n    let currentBase: string = base2\n    let inheritedCfg: NodeCfg = { ...(inherited2 as NodeCfg) }\n    let currentParamsSchema: PS2 = mergedParamsSchema as PS2\n\n    function add<M extends HttpMethod, C extends MethodCfg>(method: M, cfg: C) {\n      const effectiveParamsSchema = (cfg.paramsSchema ??\n        currentParamsSchema) as PS2 | undefined\n      const effectiveQuerySchema =\n        cfg.feed === true\n          ? augmentFeedQuerySchema(cfg.querySchema)\n          : cfg.querySchema\n      const effectiveOutputSchema =\n        cfg.feed === true\n          ? augmentFeedOutputSchema(cfg.outputSchema)\n          : cfg.outputSchema\n\n      const fullCfg = (\n        effectiveParamsSchema\n          ? {\n              ...inheritedCfg,\n              ...cfg,\n              paramsSchema: effectiveParamsSchema,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n          : {\n              ...inheritedCfg,\n              ...cfg,\n              ...(effectiveQuerySchema\n                ? { querySchema: effectiveQuerySchema }\n                : {}),\n              ...(effectiveOutputSchema\n                ? { outputSchema: effectiveOutputSchema }\n                : {}),\n            }\n      ) as any\n\n      const leaf = {\n        method,\n        path: currentBase as Base2,\n        cfg: fullCfg,\n      } as const\n\n      stack.push(leaf as unknown as AnyLeaf)\n\n      return api\n    }\n\n    const api: any = {\n      /**\n       * Mount a subtree built elsewhere.\n       *\n       * Usage:\n       *   const users = resource('').get(...).done()\n       *   resource('/api').sub('users', users).done()\n       */\n      sub<Name extends string>(\n        name: Name,\n        cfgOrLeaves?: NodeCfg | readonly AnyLeafLowProfile[],\n        maybeLeaves?: readonly AnyLeafLowProfile[],\n      ) {\n        let cfg: NodeCfg | undefined\n        let leaves: readonly AnyLeafLowProfile[] | undefined\n\n        if (Array.isArray(cfgOrLeaves)) {\n          leaves = cfgOrLeaves\n        } else {\n          cfg = cfgOrLeaves as NodeCfg | undefined\n          leaves = maybeLeaves\n        }\n\n        if (!leaves) {\n          throw new Error('sub() expects a leaves array as the last argument')\n        }\n\n        const childInherited: NodeCfg = {\n          ...inheritedCfg,\n          ...(cfg ?? {}),\n        }\n\n        const baseForChildren = `${currentBase}/${name}`\n\n        for (const leafLow of leaves) {\n          const leaf = leafLow as unknown as AnyLeaf\n          const leafCfg = leaf.cfg as MethodCfg\n          const leafParams = leafCfg.paramsSchema as ZodTypeAny | undefined\n\n          const effectiveParams = mergeSchemas(\n            currentParamsSchema as any,\n            leafParams,\n          )\n\n          const newCfg: MethodCfg = {\n            ...childInherited,\n            ...leafCfg,\n          }\n\n          if (effectiveParams) {\n            newCfg.paramsSchema = effectiveParams\n          } else if ('paramsSchema' in newCfg) {\n            delete newCfg.paramsSchema\n          }\n\n          const newLeaf: AnyLeaf = {\n            method: leaf.method,\n            path: `${baseForChildren}${leaf.path}` as string,\n            cfg: newCfg,\n          }\n\n          stack.push(newLeaf)\n        }\n\n        return api\n      },\n\n      /**\n       * Introduce a :param segment and mount a subtree under it.\n       *\n       * The subtree is built independently (e.g. resource('').get(...).done())\n       * and its paths become `${currentBase}/:${name}${leaf.path}`.\n       * Params schemas are intersected with the accumulated params plus the new param.\n       */\n      routeParameter<Name extends string, P extends ZodTypeAny>(\n        name: Name,\n        paramsSchema: P,\n        leaves: readonly AnyLeafLowProfile[],\n      ) {\n        const paramObj: ParamZod<Name, P> = z.object({\n          [name]: paramsSchema,\n        } as Record<Name, P>)\n\n        const mergedParams = (\n          currentParamsSchema\n            ? mergeSchemas(currentParamsSchema as any, paramObj)\n            : paramObj\n        ) as PS2\n\n        const baseForChildren = `${currentBase}/:${name}`\n\n        for (const leafLow of leaves) {\n          const leaf = leafLow as unknown as AnyLeaf\n          const leafCfg = leaf.cfg as MethodCfg\n          const leafParams = leafCfg.paramsSchema as ZodTypeAny | undefined\n\n          const effectiveParams = mergeSchemas(mergedParams as any, leafParams)\n\n          const newCfg: MethodCfg = {\n            ...inheritedCfg,\n            ...leafCfg,\n          }\n\n          if (effectiveParams) {\n            newCfg.paramsSchema = effectiveParams\n          } else if ('paramsSchema' in newCfg) {\n            delete newCfg.paramsSchema\n          }\n\n          const newLeaf: AnyLeaf = {\n            method: leaf.method,\n            path: `${baseForChildren}${leaf.path}` as string,\n            cfg: newCfg,\n          }\n\n          stack.push(newLeaf)\n        }\n\n        return api\n      },\n\n      // methods (inject current params schema if missing)\n      get<C extends MethodCfg>(cfg: C) {\n        return add('get', cfg)\n      },\n      post<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('post', { ...cfg, feed: false })\n      },\n      put<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('put', { ...cfg, feed: false })\n      },\n      patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('patch', { ...cfg, feed: false })\n      },\n      delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n        return add('delete', { ...cfg, feed: false })\n      },\n\n      done() {\n        return stack as readonly AnyLeafLowProfile[]\n      },\n    }\n\n    return api as Branch<Base2, readonly [], I2, PS2>\n  }\n\n  // Root branch starts with no params schema (PS = undefined)\n  return makeBranch(rootBase, rootInherited, undefined)\n}\n\n/**\n * Merge two readonly tuples (preserves literal tuple information).\n * @param arr1 First tuple.\n * @param arr2 Second tuple.\n * @returns New tuple containing values from both inputs.\n */\nexport const mergeArrays = <T extends readonly any[], S extends readonly any[]>(\n  arr1: T,\n  arr2: S,\n) => {\n  return [...arr1, ...arr2] as [...T, ...S]\n}\n","import { z, ZodType } from 'zod'\n\n/** Supported HTTP verbs for the routes DSL. */\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete'\n\n/** Declarative description of a multipart upload field. */\nexport type FileField = {\n  /** Form field name used for uploads. */\n  name: string\n  /** Maximum number of files accepted for this field. */\n  maxCount: number\n}\n\n/** Configuration that applies to an entire branch of the route tree. */\nexport type NodeCfg = {\n  /** @deprecated. Does nothing. */\n  authenticated?: boolean\n}\n\nexport type RouteSchema<Output = unknown> = ZodType & {\n  __out: Output\n}\n\nexport type RouteSchemaOutput<Schema extends ZodType> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport const lowProfileParse = <T extends RouteSchema>(\n  schema: T,\n  data: unknown,\n): RouteSchemaOutput<T> => {\n  return schema.parse(data) as RouteSchemaOutput<T>\n}\n\nexport type ToRouteSchema<S> = S extends ZodType ? RouteSchema<z.output<S>> : S\n\nexport type LowProfileCfg<Cfg extends MethodCfg> = Prettify<\n  Omit<Cfg, 'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'> & {\n    bodySchema: ToRouteSchema<Cfg['bodySchema']>\n    querySchema: ToRouteSchema<Cfg['querySchema']>\n    paramsSchema: ToRouteSchema<Cfg['paramsSchema']>\n    outputSchema: ToRouteSchema<Cfg['outputSchema']>\n  }\n>\n\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg = {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodType\n  /** Zod schema describing the query string. */\n  querySchema?: ZodType\n  /** Zod schema describing path params (Internal only, set through sub and routeParameter). */\n  paramsSchema?: ZodType\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodType\n  /** Multipart upload definitions for the route. */\n  bodyFiles?: FileField[]\n  /** Marks the route as an infinite feed (enables cursor helpers). */\n  feed?: boolean\n\n  /** Optional human-readable description for docs/debugging. */\n  description?: string\n  /**\n   * Short one-line summary for docs list views.\n   * Shown in navigation / tables instead of the full description.\n   */\n  summary?: string\n  /**\n   * Group name used for navigation sections in docs UIs.\n   * e.g. \"Users\", \"Billing\", \"Auth\".\n   */\n  docsGroup?: string\n  /**\n   * Tags that can be used to filter / facet in interactive docs.\n   * e.g. [\"users\", \"admin\", \"internal\"].\n   */\n  tags?: string[]\n  /**\n   * Mark the route as deprecated in docs.\n   * Renderers can badge this and/or hide by default.\n   */\n  deprecated?: boolean\n  /**\n   * Optional stability information for the route.\n   * Renderers can surface this prominently.\n   */\n  stability?: 'experimental' | 'beta' | 'stable' | 'deprecated'\n  /**\n   * Hide this route from public docs while keeping it usable in code.\n   */\n  docsHidden?: boolean\n  /**\n   * Arbitrary extra metadata for docs renderers.\n   * Can be used for auth requirements, rate limits, feature flags, etc.\n   */\n  docsMeta?: Record<string, unknown>\n}\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<\n  M extends HttpMethod,\n  P extends string,\n  C extends MethodCfg,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n\n/** Convenience union covering all generated leaves. */\nexport type AnyLeaf = Leaf<HttpMethod, string, MethodCfg>\n\n/** Merge two object types while keeping nice IntelliSense output. */\nexport type Merge<A, B> = Prettify<Omit<A, keyof B> & B>\n\n/** Append a new element to a readonly tuple type. */\nexport type Append<T extends readonly unknown[], X> = [...T, X]\n\n/** Concatenate two readonly tuple types. */\nexport type MergeArray<\n  A extends readonly unknown[],\n  B extends readonly unknown[],\n> = [...A, ...B]\nexport type IntersectZod<\n  A extends ZodType | undefined,\n  B extends ZodType | undefined,\n> = B extends ZodType\n  ? A extends ZodType\n    ? z.ZodIntersection<A, B>\n    : B\n  : A extends ZodType\n    ? A\n    : undefined\n\ntype RouteSchemaFromZod<T extends ZodType | undefined> = T extends ZodType\n  ? RouteSchema<z.output<T>>\n  : undefined\n\ntype MergeRouteSchemas<\n  Existing extends RouteSchema | undefined,\n  Parent extends ZodType | undefined,\n> =\n  Existing extends RouteSchema<infer ExistingOut>\n    ? Parent extends ZodType\n      ? RouteSchema<ExistingOut & z.output<Parent>>\n      : Existing\n    : Parent extends ZodType\n      ? RouteSchemaFromZod<Parent>\n      : undefined\n\ntype AugmentedCfg<\n  Cfg extends MethodCfgLowProfile,\n  Param extends ZodType | undefined,\n> = Prettify<\n  Omit<Cfg, 'paramsSchema'> & {\n    paramsSchema: MergeRouteSchemas<Cfg['paramsSchema'], Param>\n  }\n>\n\nexport type AugmentLeaves<\n  P extends string,\n  Param extends ZodType | undefined,\n  R extends readonly LeafLowProfile[],\n  Acc extends readonly LeafLowProfile[] = [],\n> = R extends readonly [infer First, ...infer Rest]\n  ? First extends LeafLowProfile\n    ? AugmentLeaves<\n        P,\n        Param,\n        Rest extends readonly LeafLowProfile[] ? Rest : [],\n        Append<\n          Acc,\n          LeafLowProfile<\n            First['method'],\n            `${P}${First['path']}`,\n            AugmentedCfg<First['cfg'], Param>\n          >\n        >\n      >\n    : never\n  : Acc\n// helpers (optional)\ntype SegmentParams<S extends string> = S extends `:${infer P}` ? P : never\ntype Split<S extends string> = S extends ''\n  ? []\n  : S extends `${infer A}/${infer B}`\n    ? [A, ...Split<B>]\n    : [S]\ntype ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>\n\n/** Derive a params object type from a literal route string. */\nexport type ExtractParamsFromPath<Path extends string> =\n  ExtractParamNames<Path> extends never\n    ? never\n    : Record<ExtractParamNames<Path>, string | number>\n\n/**\n * Interpolate `:params` in a path using the given values.\n * @param path Literal route string containing `:param` segments.\n * @param params Object of parameter values to interpolate.\n * @returns Path string with parameters substituted.\n */\nexport function compilePath<Path extends string>(\n  path: Path,\n  params: ExtractParamsFromPath<Path>,\n) {\n  if (!params) return path\n  return path.replace(/:([A-Za-z0-9_]+)/g, (_, k) => {\n    const v = (params as any)[k]\n    if (v === undefined || v === null) throw new Error(`Missing param :${k}`)\n    return String(v)\n  })\n}\n\n/**\n * Build a deterministic cache key for the given leaf.\n * The key matches the shape consumed by React Query helpers.\n * @param args.leaf Leaf describing the endpoint.\n * @param args.params Optional params used to build the path.\n * @param args.query Optional query payload.\n * @returns Tuple suitable for React Query cache keys.\n */\ntype SplitPath<P extends string> = P extends ''\n  ? []\n  : P extends `${infer A}/${infer B}`\n    ? [A, ...SplitPath<B>]\n    : [P]\nexport function buildCacheKey<L extends AnyLeaf>(args: {\n  leaf: L\n  params?: ExtractParamsFromPath<L['path']>\n  query?: InferQuery<L>\n}) {\n  let p = args.leaf.path\n  if (args.params) {\n    p = compilePath<L['path']>(p, args.params)\n  }\n  return [\n    args.leaf.method,\n    ...(p.split('/').filter(Boolean) as SplitPath<typeof p>),\n    args.query ?? {},\n  ] as const\n}\n\n/** Definition-time method config (for clarity). */\nexport type MethodCfgDef = MethodCfg\n\n/** Low-profile method config where schemas carry a phantom __out like SocketSchema. */\nexport type MethodCfgLowProfile = Omit<\n  MethodCfg,\n  'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n> & {\n  bodySchema?: RouteSchema\n  querySchema?: RouteSchema\n  paramsSchema?: RouteSchema\n  outputSchema?: RouteSchema\n}\nexport type AnyLeafLowProfile = LeafLowProfile<\n  HttpMethod,\n  string,\n  MethodCfgLowProfile\n>\n\nexport function buildLowProfileLeaf<\n  const M extends HttpMethod,\n  const Path extends string,\n  const O extends ZodType | undefined = undefined,\n  const P extends ZodType | undefined = undefined,\n  const Q extends ZodType | undefined = undefined,\n  const B extends ZodType | undefined = undefined,\n  const Feed extends boolean = false,\n>(leaf: {\n  method: M\n  path: Path\n  cfg: Omit<\n    MethodCfg,\n    'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema'\n  > & {\n    feed?: Feed\n    bodySchema?: B\n    querySchema?: Q\n    paramsSchema?: P\n    outputSchema?: O\n  }\n}): LeafLowProfile<\n  M,\n  Path,\n  Prettify<\n    Omit<\n      MethodCfg,\n      'bodySchema' | 'querySchema' | 'paramsSchema' | 'outputSchema' | 'feed'\n    > & {\n      feed: Feed\n      bodySchema: B extends ZodType ? RouteSchema<z.infer<B>> : undefined\n      querySchema: Q extends ZodType ? RouteSchema<z.infer<Q>> : undefined\n      paramsSchema: P extends ZodType ? RouteSchema<z.infer<P>> : undefined\n      outputSchema: O extends ZodType ? RouteSchema<z.infer<O>> : undefined\n    }\n  >\n>\nexport function buildLowProfileLeaf(leaf: any): any {\n  return {\n    ...leaf,\n    cfg: {\n      ...leaf.cfg,\n      bodySchema: leaf.cfg.bodySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.bodySchema>\n      >,\n      querySchema: leaf.cfg.querySchema as RouteSchema<\n        z.infer<typeof leaf.cfg.querySchema>\n      >,\n      paramsSchema: leaf.cfg.paramsSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.paramsSchema>\n      >,\n      outputSchema: leaf.cfg.outputSchema as RouteSchema<\n        z.infer<typeof leaf.cfg.outputSchema>\n      >,\n    },\n  }\n}\n\nexport type LeafLowProfile<\n  M extends HttpMethod = HttpMethod,\n  P extends string = string,\n  C extends MethodCfgLowProfile = MethodCfgLowProfile,\n> = {\n  /** Lowercase HTTP method (get/post/...). */\n  readonly method: M\n  /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n  readonly path: P\n  /** Readonly snapshot of route configuration. */\n  readonly cfg: Readonly<C>\n}\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeafLowProfile, Fallback = never> =\n  L['cfg']['paramsSchema'] extends RouteSchema<infer P> ? P : Fallback\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf, Fallback = never> =\n  L['cfg']['querySchema'] extends RouteSchema<infer Q> ? Q : Fallback\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf, Fallback = never> =\n  L['cfg']['bodySchema'] extends RouteSchema<infer B> ? B : Fallback\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf, Fallback = never> =\n  L['cfg']['outputSchema'] extends RouteSchema<infer O> ? O : Fallback\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {}\n","// TODO:\n// * use this as a transform that infers the types from Zod, to only pass the types around instead of the full schemas -> make converters that go both ways (data to schema, schema to data)\n// * consider moving to core package\n// * update server and client side to use this type instead of raw zod schemas\nimport { AnyLeafLowProfile, HttpMethod, Prettify } from './routesV3.core'\n\n/** Build the key type for a leaf — distributive so method/path stay paired. */\nexport type KeyOf<L extends AnyLeafLowProfile> = L extends AnyLeafLowProfile\n  ? `${Uppercase<L['method']>} ${L['path']}`\n  : never\n\n// From a tuple of leaves, get the union of keys (pairwise, no cartesian blow-up)\ntype KeysOf<Leaves extends readonly AnyLeafLowProfile[]> = KeyOf<Leaves[number]>\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}`\n  ? Lowercase<M>\n  : never\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}`\n  ? P\n  : never\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<\n  Leaves extends readonly AnyLeafLowProfile[],\n  K extends string,\n> = Extract<\n  Leaves[number],\n  { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>\n\n/**\n * Freeze a leaf tuple into a registry with typed key lookups.\n * @param leaves Readonly tuple of leaves produced by the builder DSL.\n * @returns Registry containing the leaves array and a `byKey` lookup map.\n */\nexport function finalize<const L extends readonly AnyLeafLowProfile[]>(\n  leaves: L,\n) {\n  type Keys = KeysOf<L>\n  type MapByKey = { [K in Keys]: Prettify<LeafForKey<L, K>> }\n\n  const byKey = Object.fromEntries(\n    leaves.map((l) => [`${l.method.toUpperCase()} ${l.path}`, l] as const),\n  ) as unknown as MapByKey\n\n  const log = (logger: { system: (...args: unknown[]) => void }) => {\n    logger.system('Finalized routes:')\n    ;(Object.keys(byKey) as Keys[]).forEach((k) => {\n      const leaf = byKey[k]\n      logger.system(`- ${k}`)\n    })\n  }\n\n  return { all: leaves, byKey, log }\n}\n\n/** Nominal type alias for a finalized registry. */\nexport type Registry<R extends ReturnType<typeof finalize>> = R\n\ntype FilterRoute<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n  Acc extends readonly AnyLeafLowProfile[] = [],\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? First extends { path: `${string}${F}${string}` }\n    ? FilterRoute<Rest, F, [...Acc, First]>\n    : FilterRoute<Rest, F, Acc>\n  : Acc\n\ntype UpperCase<S extends string> = S extends `${infer First}${infer Rest}`\n  ? `${Uppercase<First>}${UpperCase<Rest>}`\n  : S\n\ntype Routes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = FilterRoute<T, F>\ntype ByKey<\n  T extends readonly AnyLeafLowProfile[],\n  Acc extends Record<string, AnyLeafLowProfile> = {},\n> = T extends readonly [\n  infer First extends AnyLeafLowProfile,\n  ...infer Rest extends AnyLeafLowProfile[],\n]\n  ? ByKey<\n      Rest,\n      Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }\n    >\n  : Acc\n\n/**\n * Convenience helper for extracting a subset of routes by path fragment.\n * @param T Tuple of leaves produced by the DSL.\n * @param F String fragment to match against the route path.\n */\nexport type SubsetRoutes<\n  T extends readonly AnyLeafLowProfile[],\n  F extends string,\n> = {\n  byKey: ByKey<Routes<T, F>>\n  all: Routes<T, F>\n}\n","// socket.index.ts (shared client/server)\n\nimport { z } from 'zod'\n\nexport type SocketSchema<Output = unknown> = z.ZodType & {\n  __out: Output\n}\n\nexport type SocketSchemaOutput<Schema extends z.ZodTypeAny> = Schema extends {\n  __out: infer Out\n}\n  ? Out\n  : z.output<Schema>\n\nexport type SocketEvent<Out = unknown> = {\n  message: z.ZodTypeAny\n  /** phantom field, only for typing; not meant to be used at runtime */\n  __out: Out\n}\n\nexport type EventMap = Record<string, SocketEvent<any>>\n\n/**\n * System event names – shared so server and client\n * don't drift on naming.\n */\nexport type SysEventName =\n  | 'sys:connect'\n  | 'sys:disconnect'\n  | 'sys:reconnect'\n  | 'sys:connect_error'\n  | 'sys:ping'\n  | 'sys:pong'\n  | 'sys:room_join'\n  | 'sys:room_leave'\nexport function defineSocketEvents<\n  const C extends SocketConnectionConfig,\n  const Schemas extends Record<\n    string,\n    {\n      message: z.ZodTypeAny\n    }\n  >,\n>(\n  config: C,\n  events: Schemas,\n): {\n  config: {\n    [K in keyof C]: SocketSchema<z.output<C[K]>>\n  }\n  events: {\n    [K in keyof Schemas]: SocketEvent<z.output<Schemas[K]['message']>>\n  }\n}\n\nexport function defineSocketEvents(config: any, events: any) {\n  return { config, events }\n}\n\nexport type Payload<T extends EventMap, K extends keyof T> =\n  T[K] extends SocketEvent<infer Out> ? Out : never\nexport type SocketConnectionConfig = {\n  joinMetaMessage: z.ZodTypeAny\n  leaveMetaMessage: z.ZodTypeAny\n  pingPayload: z.ZodTypeAny\n  pongPayload: z.ZodTypeAny\n}\n\nexport type SocketConnectionConfigOutput = {\n  joinMetaMessage: SocketSchema<any>\n  leaveMetaMessage: SocketSchema<any>\n  pingPayload: SocketSchema<any>\n  pongPayload: SocketSchema<any>\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emeryld/rrroutes-contract",
   "description": "TypeScript contract definitions for RRRoutes",
-  "version": "2.3.9",
+  "version": "2.4.1",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",