@emeryld/rrroutes-contract 2.1.7 → 2.1.9

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

@@ -1,16 +1,63 @@
 import { z } from 'zod';
-import { AnyLeaf, Append, Leaf, Merge, MergeArray, MethodCfg, NodeCfg, Prettify } from './routesV3.core';
+import { AnyLeaf, Append, HttpMethod, Leaf, Merge, MergeArray, MethodCfg, NodeCfg, Prettify } from './routesV3.core';
+declare const paginationField: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>>>;
+type PaginationField = typeof paginationField;
 type ZodTypeAny = z.ZodTypeAny;
 type ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{
     [K in Name]: S;
 }>;
-/**
- * Runtime helper that mirrors the typed merge used by the builder.
- * @param a Previously merged params schema inherited from parent segments.
- * @param b Newly introduced params schema.
- * @returns Intersection of schemas when both exist, otherwise whichever is defined.
- */
-declare function mergeSchemas<A extends ZodTypeAny | undefined, B extends ZodTypeAny | undefined>(a: A, b: B): A extends ZodTypeAny ? (B extends ZodTypeAny ? ReturnType<typeof z.intersection<A, B>> : A) : B;
+type ZodArrayAny = z.ZodArray<ZodTypeAny>;
+type AnyZodObject = z.ZodObject<any>;
+type MergedParamsResult<PS, Name extends string, P extends ZodTypeAny> = PS extends ZodTypeAny ? z.ZodIntersection<PS, ParamZod<Name, P>> : ParamZod<Name, P>;
+declare const defaultFeedOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodUnknown>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type FeedOutputSchema<C extends MethodCfg> = C['outputSchema'] extends ZodArrayAny ? z.ZodObject<{
+    items: C['outputSchema'];
+    nextCursor: z.ZodOptional<z.ZodString>;
+}> : C['outputSchema'] extends ZodTypeAny ? z.ZodObject<{
+    items: z.ZodArray<C['outputSchema']>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}> : typeof defaultFeedOutputSchema;
+type BaseMethodCfg<C extends MethodCfg> = Merge<Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>, Omit<C, 'querySchema' | 'outputSchema' | 'feed'>>;
+type FeedField<C extends MethodCfg> = C['feed'] extends true ? {
+    feed: true;
+} : {
+    feed?: boolean;
+};
+type AddPaginationToQuery<Q extends AnyZodObject | undefined> = Q extends z.ZodObject<infer Shape> ? z.ZodObject<Shape & {
+    pagination: PaginationField;
+}> : z.ZodObject<{
+    pagination: PaginationField;
+}>;
+type FeedQueryField<C extends MethodCfg> = {
+    querySchema: AddPaginationToQuery<C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined>;
+};
+type NonFeedQueryField<C extends MethodCfg> = C['querySchema'] extends ZodTypeAny ? {
+    querySchema: C['querySchema'];
+} : {
+    querySchema?: undefined;
+};
+type FeedOutputField<C extends MethodCfg> = {
+    outputSchema: FeedOutputSchema<C>;
+};
+type NonFeedOutputField<C extends MethodCfg> = C['outputSchema'] extends ZodTypeAny ? {
+    outputSchema: C['outputSchema'];
+} : {
+    outputSchema?: undefined;
+};
+type ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny ? {
+    paramsSchema: C['paramsSchema'];
+} : {
+    paramsSchema: PS;
+};
+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 BuiltLeaf<M extends HttpMethod, Base extends string, I extends NodeCfg, C extends MethodCfg, PS> = Leaf<M, Base, Merge<I, EffectiveCfg<C, PS>>>;
 /** Builder surface used by `resource(...)` to accumulate leaves. */
 export interface Branch<Base extends string, Acc extends readonly AnyLeaf[], I extends NodeCfg, PS extends ZodTypeAny | undefined> {
     /**
@@ -29,7 +76,7 @@ export interface Branch<Base extends string, Acc extends readonly AnyLeaf[], I e
      * @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 AnyLeaf[]>(name: Name, paramsSchema: P, builder: (r: Branch<`${Base}/:${Name}`, readonly [], I, ReturnType<typeof mergeSchemas<PS, ParamZod<Name, P>>>>) => R): Branch<Base, MergeArray<Acc, R>, I, ReturnType<typeof mergeSchemas<PS, ParamZod<Name, P>>>>;
+    routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(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.
@@ -39,37 +86,35 @@ export interface Branch<Base extends string, Acc extends readonly AnyLeaf[], I e
      * Register a GET leaf at the current path.
      * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    get<C extends Omit<MethodCfg, 'paramsSchema'>>(cfg: C): Branch<Base, Append<Acc, Prettify<Leaf<'get', Base, Merge<Merge<I, C>, {
-        paramsSchema: PS;
-    }>>>>, I, PS>;
+    get<C extends MethodCfg>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>, I, PS>;
     /**
      * Register a POST leaf at the current path.
      * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    post<C extends Omit<MethodCfg, 'paramsSchema'>>(cfg: C): Branch<Base, Append<Acc, Leaf<'post', Base, Merge<Merge<I, C>, {
-        paramsSchema: PS;
-    }>>>, I, PS>;
+    post<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'post', Base, I, Merge<C, {
+        feed: false;
+    }>, PS>>>, I, PS>;
     /**
      * Register a PUT leaf at the current path.
      * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    put<C extends Omit<MethodCfg, 'paramsSchema'>>(cfg: C): Branch<Base, Append<Acc, Leaf<'put', Base, Merge<Merge<I, C>, {
-        paramsSchema: PS;
-    }>>>, I, PS>;
+    put<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'put', Base, I, Merge<C, {
+        feed: false;
+    }>, PS>>>, I, PS>;
     /**
      * Register a PATCH leaf at the current path.
      * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    patch<C extends Omit<MethodCfg, 'paramsSchema'>>(cfg: C): Branch<Base, Append<Acc, Leaf<'patch', Base, Merge<Merge<I, C>, {
-        paramsSchema: PS;
-    }>>>, I, PS>;
+    patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'patch', Base, I, Merge<C, {
+        feed: false;
+    }>, PS>>>, I, PS>;
     /**
      * Register a DELETE leaf at the current path.
      * @param cfg Method configuration (schemas, flags, descriptions, etc).
      */
-    delete<C extends Omit<MethodCfg, 'paramsSchema'>>(cfg: C): Branch<Base, Append<Acc, Leaf<'delete', Base, Merge<Merge<I, C>, {
-        paramsSchema: PS;
-    }>>>, I, PS>;
+    delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C): Branch<Base, Append<Acc, Prettify<BuiltLeaf<'delete', Base, I, Merge<C, {
+        feed: false;
+    }>, PS>>>, I, PS>;
     /**
      * Finish the branch and return the collected leaves.
      * @returns Readonly tuple of accumulated leaves.

package/dist/crud/routesV3.crud.d.ts

@@ -6,6 +6,17 @@ export declare const CrudDefaultPagination: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     cursor: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+declare const CrudPaginationField: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>>;
+type CrudPaginationField = typeof CrudPaginationField;
+type AnyCrudZodObject = z.ZodObject<any>;
+type AddCrudPagination<Q extends AnyCrudZodObject | undefined> = Q extends z.ZodObject<infer Shape> ? z.ZodObject<Shape & {
+    pagination: CrudPaginationField;
+}> : z.ZodObject<{
+    pagination: CrudPaginationField;
+}>;
 /**
  * Merge two Zod schemas at runtime; matches the typing pattern used in builder.
  * @param a Existing params schema inherited from parent branches.
@@ -103,7 +114,7 @@ type CrudLeavesTuple<Base extends string, I extends NodeCfg, PS extends ZodType
     ...(Flag<C['enable'] extends CrudEnable ? C['enable']['list'] : undefined, true> extends true ? [
         Leaf<'get', `${Base}/${Name}`, WithParams<Omit<I, never> & {
             feed: true;
-            querySchema: C['list'] extends CrudListCfg ? C['list']['querySchema'] : typeof CrudDefaultPagination;
+            querySchema: C['list'] extends CrudListCfg ? AddCrudPagination<C['list']['querySchema'] extends AnyCrudZodObject ? C['list']['querySchema'] : undefined> : AddCrudPagination<undefined>;
             outputSchema: C['list'] extends CrudListCfg ? C['list']['outputSchema'] extends ZodType ? C['list']['outputSchema'] : z.ZodObject<{
                 items: z.ZodArray<C['itemOutputSchema']>;
                 nextCursor: z.ZodOptional<z.ZodString>;

package/dist/docs/docs.d.ts

@@ -0,0 +1,2 @@
+import { AnyLeaf } from "../core/routesV3.core";
+export declare function renderLeafDocsMarkdown(leaves: AnyLeaf[]): string;

package/dist/index.cjs

@@ -27,6 +27,7 @@ __export(index_exports, {
   finalize: () => finalize,
   mergeArrays: () => mergeArrays,
   mergeSchemas: () => mergeSchemas2,
+  renderLeafDocsMarkdown: () => renderLeafDocsMarkdown,
   resource: () => resource,
   resourceWithCrud: () => resourceWithCrud,
   withCrud: () => withCrud
@@ -35,6 +36,51 @@ module.exports = __toCommonJS(index_exports);
 
 // src/core/routesV3.builder.ts
 var import_zod = require("zod");
+var defaultFeedQuerySchema = import_zod.z.object({
+  cursor: import_zod.z.string().optional(),
+  limit: import_zod.z.coerce.number().min(1).max(100).default(20)
+});
+var paginationField = defaultFeedQuerySchema.optional().default(defaultFeedQuerySchema.parse({}));
+var defaultFeedOutputSchema = import_zod.z.object({
+  items: import_zod.z.array(import_zod.z.unknown()),
+  nextCursor: import_zod.z.string().optional()
+});
+function augmentFeedQuerySchema(schema) {
+  if (schema && !(schema instanceof import_zod.z.ZodObject)) {
+    console.warn("Feed queries must be a ZodObject; default pagination applied.");
+    return import_zod.z.object({
+      pagination: paginationField
+    });
+  }
+  const base = schema ?? import_zod.z.object({});
+  return base.extend({
+    pagination: paginationField
+  });
+}
+function augmentFeedOutputSchema(schema) {
+  if (!schema) return defaultFeedOutputSchema;
+  if (schema instanceof import_zod.z.ZodArray) {
+    return import_zod.z.object({
+      items: schema,
+      nextCursor: import_zod.z.string().optional()
+    });
+  }
+  if (schema instanceof import_zod.z.ZodObject) {
+    const shape = schema.shape ? schema.shape : schema._def?.shape?.();
+    const hasItems = Boolean(shape?.items);
+    if (hasItems) {
+      return schema.extend({ nextCursor: import_zod.z.string().optional() });
+    }
+    return import_zod.z.object({
+      items: import_zod.z.array(schema),
+      nextCursor: import_zod.z.string().optional()
+    });
+  }
+  return import_zod.z.object({
+    items: import_zod.z.array(schema),
+    nextCursor: import_zod.z.string().optional()
+  });
+}
 function mergeSchemas(a, b) {
   if (a && b) return import_zod.z.intersection(a, b);
   return a ?? b;
@@ -49,7 +95,20 @@ function resource(base, inherited) {
     let currentParamsSchema = mergedParamsSchema;
     function add(method, cfg) {
       const effectiveParamsSchema = cfg.paramsSchema ?? currentParamsSchema;
-      const fullCfg = effectiveParamsSchema ? { ...inheritedCfg, ...cfg, paramsSchema: effectiveParamsSchema } : { ...inheritedCfg, ...cfg };
+      const effectiveQuerySchema = cfg.feed === true ? augmentFeedQuerySchema(cfg.querySchema) : cfg.querySchema;
+      const effectiveOutputSchema = cfg.feed === true ? augmentFeedOutputSchema(cfg.outputSchema) : cfg.outputSchema;
+      const fullCfg = effectiveParamsSchema ? {
+        ...inheritedCfg,
+        ...cfg,
+        paramsSchema: effectiveParamsSchema,
+        ...effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {},
+        ...effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}
+      } : {
+        ...inheritedCfg,
+        ...cfg,
+        ...effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {},
+        ...effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}
+      };
       const leaf = {
         method,
         path: currentBase,
@@ -86,7 +145,7 @@ function resource(base, inherited) {
       routeParameter(name, paramsSchema, builder) {
         const childBase = `${currentBase}/:${name}`;
         const paramObj = import_zod.z.object({ [name]: paramsSchema });
-        const childParams = mergeSchemas(currentParamsSchema, paramObj);
+        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);
@@ -162,6 +221,7 @@ var CrudDefaultPagination = import_zod2.z.object({
   limit: import_zod2.z.coerce.number().min(1).max(100).default(20),
   cursor: import_zod2.z.string().optional()
 });
+var CrudPaginationField = CrudDefaultPagination.optional().default(CrudDefaultPagination.parse({}));
 function mergeSchemas2(a, b) {
   if (a && b) return import_zod2.z.intersection(a, b);
   return a ?? b;
@@ -238,6 +298,93 @@ function resourceWithCrud(base, inherited) {
 function defineSocketEvents(config, events) {
   return { config, events };
 }
+
+// src/docs/docs.ts
+var import_zod3 = require("zod");
+function summarizeSchema(schema) {
+  if (!schema) return void 0;
+  if (schema instanceof import_zod3.ZodObject) {
+    const shape = schema.shape;
+    return {
+      type: "object",
+      fields: Object.fromEntries(
+        Object.entries(shape).map(([key, value]) => {
+          const def2 = value._def;
+          return [
+            key,
+            {
+              typeName: def2?.typeName,
+              description: def2?.description
+            }
+          ];
+        })
+      )
+    };
+  }
+  if (schema instanceof import_zod3.ZodArray) {
+    return {
+      type: "array",
+      // @ts-ignore
+      element: summarizeSchema(schema.unwrap())
+    };
+  }
+  const def = schema._def;
+  return { typeName: def?.typeName ?? "unknown" };
+}
+function leavesToDocs(leaves) {
+  return leaves.map((leaf) => {
+    const { method, path, cfg } = leaf;
+    return {
+      method,
+      path,
+      description: cfg.description,
+      feed: cfg.feed,
+      body: summarizeSchema(cfg.bodySchema),
+      query: summarizeSchema(cfg.querySchema),
+      params: summarizeSchema(cfg.paramsSchema),
+      output: summarizeSchema(cfg.outputSchema),
+      files: cfg.bodyFiles
+    };
+  });
+}
+function renderLeafDocsMarkdown(leaves) {
+  const docs = leavesToDocs(leaves);
+  docs.sort((a, b) => {
+    const p = a.path.localeCompare(b.path);
+    return p !== 0 ? p : a.method.localeCompare(b.method);
+  });
+  return docs.map((d) => {
+    const lines = [];
+    lines.push(`### \`${d.method.toUpperCase()} ${d.path}\``);
+    if (d.description) {
+      lines.push("", d.description);
+    }
+    if (d.feed) {
+      lines.push("", "_Feed endpoint_");
+    }
+    function pushJson(title, value) {
+      if (!value) return;
+      lines.push(
+        "",
+        `**${title}**`,
+        "```json",
+        JSON.stringify(value, null, 2),
+        "```"
+      );
+    }
+    pushJson("Query", d.query);
+    pushJson("Params", d.params);
+    pushJson("Body", d.body);
+    pushJson("Output", d.output);
+    if (d.files && d.files.length > 0) {
+      lines.push("", "**Multipart files**");
+      d.files.forEach((f) => {
+        lines.push(`- \`${f.name}\` (maxCount: ${f.maxCount})`);
+      });
+    }
+    return lines.join("\n");
+  }).join("\n\n");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CrudDefaultPagination,
@@ -247,6 +394,7 @@ function defineSocketEvents(config, events) {
   finalize,
   mergeArrays,
   mergeSchemas,
+  renderLeafDocsMarkdown,
   resource,
   resourceWithCrud,
   withCrud

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/crud/routesV3.crud.ts","../src/sockets/socket.index.ts"],"sourcesContent":["export * from './core/routesV3.builder';\nexport * from './core/routesV3.core';\nexport * from './core/routesV3.finalize';\nexport * from './crud/routesV3.crud';\nexport * from './sockets/socket.index';","import { z } from 'zod';\nimport {\n  AnyLeaf,\n  Append,\n  HttpMethod,\n  Leaf,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n} from './routesV3.core';\n\ntype ZodTypeAny = z.ZodTypeAny;\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{ [K in Name]: S }>;\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 | undefined, B extends ZodTypeAny | undefined>(\n  a: A,\n  b: B,\n): A extends ZodTypeAny ? (B extends ZodTypeAny ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n  if (a && b) return z.intersection(a as any, b as any) as any;\n  return (a ?? b) as any;\n}\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\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<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeaf[]>(\n    name: Name,\n    cfg: J,\n    builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R,\n  ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;\n\n  sub<Name extends string, R extends readonly AnyLeaf[]>(\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<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n    name: Name,\n    paramsSchema: P,\n    builder: (\n      r: Branch<\n        `${Base}/:${Name}`,\n        readonly [],\n        I,\n        ReturnType<typeof mergeSchemas<PS, ParamZod<Name, P>>>\n      >,\n    ) => R,\n  ): Branch<Base, MergeArray<Acc, R>, I, ReturnType<typeof mergeSchemas<PS, ParamZod<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 Omit<MethodCfg, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Prettify<Leaf<'get', Base, Merge<Merge<I, C>, { paramsSchema: 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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<Base, Append<Acc, Leaf<'post', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>, I, PS>;\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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<Base, Append<Acc, Leaf<'put', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>, I, PS>;\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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Leaf<'patch', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>,\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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Leaf<'delete', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>,\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<Base2 extends string, I2 extends NodeCfg, PS2 extends ZodTypeAny | undefined>(\n    base2: Base2,\n    inherited2: I2,\n    mergedParamsSchema?: PS2,\n  ) {\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 ?? currentParamsSchema) as PS2 | undefined;\n      const fullCfg = (\n        effectiveParamsSchema\n          ? { ...inheritedCfg, ...cfg, paramsSchema: effectiveParamsSchema }\n          : { ...inheritedCfg, ...cfg }\n      ) as Merge<I2, C>;\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<Base2, Append<readonly [], typeof leaf>, I2, PS2>;\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 AnyLeaf[]),\n        maybeBuilder?: (r: any) => readonly AnyLeaf[],\n      ) {\n        let cfg: NodeCfg | undefined;\n        let builder: ((r: any) => readonly AnyLeaf[]) | 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<I2, NonNullable<J>>;\n\n        if (builder) {\n          // params schema PS2 flows through unchanged on plain sub\n          const child = makeBranch(childBase, childInherited, currentParamsSchema);\n          const leaves = builder(child) as readonly AnyLeaf[];\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<`${Base2}/${Name}`, readonly [], typeof childInherited, PS2>;\n        }\n      },\n\n      // the single param function: name + schema + builder\n      routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n        name: Name,\n        paramsSchema: P,\n        builder: (\n          r: Branch<\n            `${Base2}/:${Name}`,\n            readonly [],\n            I2,\n            ReturnType<typeof mergeSchemas<PS2, ParamZod<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({ [name]: paramsSchema } as Record<Name, P>);\n        const childParams = mergeSchemas<PS2, ParamZod<Name, P>>(currentParamsSchema, paramObj);\n        const child = makeBranch(childBase, inheritedCfg as I2, childParams);\n        const leaves = builder(child) as readonly AnyLeaf[];\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          ReturnType<typeof mergeSchemas<PS2, ParamZod<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, ZodTypeAny } 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\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg =  {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodTypeAny;\n  /** Zod schema describing the query string. */\n  querySchema?: ZodTypeAny;\n  /** Zod schema describing path params (overrides inferred params). */\n  paramsSchema?: ZodTypeAny;\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodTypeAny;\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  /** Optional human-readable description for docs/debugging. */\n  description?: string;\n};\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<M extends HttpMethod, P extends string, C extends MethodCfg> = {\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<A extends readonly unknown[], B extends readonly unknown[]> = [\n  ...A,\n  ...B,\n];\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 ? never : 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>(path: Path, params: ExtractParamsFromPath<Path>) {\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 [args.leaf.method, ...(p.split('/').filter(Boolean) as SplitPath<typeof p>), args.query ?? {}] as const;\n}\n\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeaf> = L['cfg']['paramsSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['paramsSchema']>\n  : ExtractParamsFromPath<L['path']>;\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf> = L['cfg']['querySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['querySchema']>\n  : never;\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf> = L['cfg']['bodySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['bodySchema']>\n  : never;\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf> = L['cfg']['outputSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['outputSchema']>\n  : unknown;\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n","import { AnyLeaf, 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 AnyLeaf> = L extends AnyLeaf\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 AnyLeaf[]> = KeyOf<Leaves[number]>;\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}` ? Lowercase<M> : never;\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}` ? P : never;\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<Leaves extends readonly AnyLeaf[], K extends string> = 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 AnyLeaf[]>(leaves: L) {\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 AnyLeaf[],\n  F extends string,\n  Acc extends readonly AnyLeaf[] = [],\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\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<T extends readonly AnyLeaf[], F extends string> = FilterRoute<T, F>;\ntype ByKey<\n  T extends readonly AnyLeaf[],\n  Acc extends Record<string, AnyLeaf> = {},\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n  ? ByKey<Rest, Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }>\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<T extends readonly AnyLeaf[], F extends string> = {\n  byKey: ByKey<Routes<T, F>>;\n  all: Routes<T, F>;\n};\n","// routesV3.crud.ts\n// -----------------------------------------------------------------------------\n// Add a first-class .crud() helper to the routesV3 DSL, without touching the\n// core builder. This file:\n//   1) Declares types + module augmentation to extend Branch<...> with .crud\n//   2) Provides a runtime decorator `withCrud(...)` that installs the method\n//   3) Exports a convenience `resourceWithCrud(...)` wrapper (optional)\n// -----------------------------------------------------------------------------\n\nimport { z, ZodType } from 'zod';\nimport {\n  resource as baseResource,\n  type Branch as _Branch, // import type so we can augment it\n} from '../core/routesV3.builder';\nimport { type AnyLeaf, type Leaf, type NodeCfg } from '../core/routesV3.core';\n\n// -----------------------------------------------------------------------------\n// Small utilities (runtime + types)\n// -----------------------------------------------------------------------------\n/** Default cursor pagination used by list (GET collection). */\nexport const CrudDefaultPagination = z.object({\n  limit: z.coerce.number().min(1).max(100).default(20),\n  cursor: z.string().optional(),\n});\n\n/**\n * Merge two Zod schemas at runtime; matches the typing pattern used in builder.\n * @param a Existing params schema inherited from parent branches.\n * @param b Schema introduced at the current branch.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nexport function mergeSchemas<A extends ZodType | undefined, B extends ZodType | undefined>(\n  a: A,\n  b: B,\n): A extends ZodType ? (B extends ZodType ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n  if (a && b) return z.intersection(a as any, b as any) as any;\n  return (a ?? b) as any;\n}\n\n/** Build { [Name]: S } Zod object at the type-level. */\nexport type ParamSchema<Name extends string, S extends ZodType> = z.ZodObject<{\n  [K in Name]: S;\n}>;\n\n/** Inject active params schema into a leaf cfg (to match your Leaf typing). */\ntype WithParams<I, P> = P extends ZodType ? Omit<I, 'paramsSchema'> & { paramsSchema: P } : I;\n\n/** Resolve boolean flag: default D unless explicitly false. */\ntype Flag<E, D extends boolean> = E extends false ? false : D;\n\n// -----------------------------------------------------------------------------\n// CRUD config (few knobs, with DX comments)\n// -----------------------------------------------------------------------------\n\n/** Toggle individual CRUD methods; defaults enable all (create/update require body). */\nexport type CrudEnable = {\n  /** GET /collection (feed). Defaults to true. */ list?: boolean;\n  /** POST /collection. Defaults to true if `create` provided. */ create?: boolean;\n  /** GET /collection/:id. Defaults to true. */ read?: boolean;\n  /** PATCH /collection/:id. Defaults to true if `update` provided. */ update?: boolean;\n  /** DELETE /collection/:id. Defaults to true. */ remove?: boolean;\n};\n\n/** Collection GET config. */\nexport type CrudListCfg = {\n  /** Query schema (defaults to cursor pagination). */\n  querySchema?: ZodType;\n  /** Output schema (defaults to { items: Item[], nextCursor? }). */\n  outputSchema?: ZodType;\n  /** Optional description string. */\n  description?: string;\n};\n\n/** Collection POST config. */\nexport type CrudCreateCfg = {\n  /** Body schema for creating an item. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item GET config. */\nexport type CrudReadCfg = {\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item PATCH config. */\nexport type CrudUpdateCfg = {\n  /** Body schema for partial updates. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item DELETE config. */\nexport type CrudRemoveCfg = {\n  /** Output schema (defaults to { ok: true }). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/**\n * CRUD config for `.crud(\"resource\", cfg, extras?)`.\n *\n * It synthesizes `:[resourceName]Id` as the param key and uses `paramSchema` for the value.\n * Prefer passing a **value schema** (e.g. `z.string().uuid()`).\n * As a convenience, a ZodObject of shape `{ [resourceName]Id: schema }` is accepted at runtime too.\n */\nexport type CrudCfg<Name extends string = string> = {\n  /**\n   * Zod schema for the ID *value* (e.g. `z.string().uuid()`).\n   * The parameter key is always `:${name}Id`.\n   * (If you pass `z.object({ [name]Id: ... })`, it's accepted at runtime.)\n   */\n  paramSchema: ZodType;\n\n  /**\n   * The single-item output shape used by read/create/update by default.\n   * List defaults to `{ items: z.array(itemOutputSchema), nextCursor? }`.\n   */\n  itemOutputSchema: ZodType;\n\n  /** Per-method toggles (all enabled by default; create/update require bodies). */\n  enable?: CrudEnable;\n\n  /** GET /collection configuration. */ list?: CrudListCfg;\n  /** POST /collection configuration (enables create). */ create?: CrudCreateCfg;\n  /** GET /collection/:id configuration. */ read?: CrudReadCfg;\n  /** PATCH /collection/:id configuration (enables update). */ update?: CrudUpdateCfg;\n  /** DELETE /collection/:id configuration. */ remove?: CrudRemoveCfg;\n};\n\n// -----------------------------------------------------------------------------\n// Type plumbing to expose generated leaves (so finalize().byKey sees them)\n// -----------------------------------------------------------------------------\n\ntype CrudLeavesTuple<\n  Base extends string,\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n> = `${Name}Id` extends infer IdName extends string\n  ? ParamSchema<IdName, C['paramSchema']> extends infer IdParamZ extends ZodType\n    ? [\n        // GET /collection\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['list'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}`,\n                WithParams<\n                  Omit<I, never> & {\n                    feed: true;\n                    querySchema: C['list'] extends CrudListCfg\n                      ? C['list']['querySchema']\n                      : typeof CrudDefaultPagination;\n                    outputSchema: C['list'] extends CrudListCfg\n                      ? C['list']['outputSchema'] extends ZodType\n                        ? C['list']['outputSchema']\n                        : z.ZodObject<{\n                            items: z.ZodArray<C['itemOutputSchema']>;\n                            nextCursor: z.ZodOptional<z.ZodString>;\n                          }>\n                      : z.ZodObject<{\n                          items: z.ZodArray<C['itemOutputSchema']>;\n                          nextCursor: z.ZodOptional<z.ZodString>;\n                        }>;\n                    description?: string;\n                  },\n                  PS\n                >\n              >,\n            ]\n          : []),\n\n        // POST /collection\n        ...((C['create'] extends CrudCreateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['create'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'post',\n                  `${Base}/${Name}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['bodySchema']\n                        : never;\n                      outputSchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['outputSchema'] extends ZodType\n                          ? C['create']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    PS\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // GET /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['read'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['read'] extends CrudReadCfg\n                      ? C['read']['outputSchema'] extends ZodType\n                        ? C['read']['outputSchema']\n                        : C['itemOutputSchema']\n                      : C['itemOutputSchema'];\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n\n        // PATCH /collection/:id\n        ...((C['update'] extends CrudUpdateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['update'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'patch',\n                  `${Base}/${Name}/:${IdName}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['bodySchema']\n                        : never;\n                      outputSchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['outputSchema'] extends ZodType\n                          ? C['update']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // DELETE /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['remove'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'delete',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['remove'] extends CrudRemoveCfg\n                      ? C['remove']['outputSchema'] extends ZodType\n                        ? C['remove']['outputSchema']\n                        : z.ZodObject<{ ok: z.ZodLiteral<true> }>\n                      : z.ZodObject<{ ok: z.ZodLiteral<true> }>;\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n      ]\n    : never\n  : never;\n\n/** Merge generated leaves + extras into the branch accumulator. */\ntype CrudResultAcc<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n  Extras extends readonly AnyLeaf[],\n> = [...Acc, ...CrudLeavesTuple<Base, I, PS, Name, C>, ...Extras];\n\n// -----------------------------------------------------------------------------\n// Module augmentation: add the typed `.crud(...)` to Branch<...>\n// -----------------------------------------------------------------------------\n\ndeclare module './../core/routesV3.builder' {\n  interface Branch<\n    Base extends string,\n    Acc extends readonly AnyLeaf[],\n    I extends NodeCfg,\n    PS extends ZodType | undefined,\n  > {\n    /**\n     * Generate opinionated CRUD endpoints for a collection at `/.../<name>`\n     * with an item at `/.../<name>/:<name>Id`.\n     *\n     * Creates (subject to `enable` + presence of create/update bodies):\n     * - GET    /<name>                (feed list)\n     * - POST   /<name>                (create)\n     * - GET    /<name>/:<name>Id      (read item)\n     * - PATCH  /<name>/:<name>Id      (update item)\n     * - DELETE /<name>/:<name>Id      (remove item)\n     *\n     * The `extras` callback receives live builders at both collection and item\n     * levels so you can add custom subroutes; their leaves are included in the\n     * returned Branch type.\n     */\n    crud<\n      Name extends string,\n      C extends CrudCfg<Name>,\n      Extras extends readonly AnyLeaf[] = readonly [],\n    >(\n      name: Name,\n      cfg: C,\n      extras?: (ctx: {\n        /** Builder at `/.../<name>` (collection scope). */\n        collection: _Branch<`${Base}/${Name}`, readonly [], I, PS>;\n        /** Builder at `/.../<name>/:<name>Id` (item scope). */\n        item: _Branch<\n          `${Base}/${Name}/:${`${Name}Id`}`,\n          readonly [],\n          I,\n          ReturnType<typeof mergeSchemas<PS, ParamSchema<`${Name}Id`, C['paramSchema']>>>\n        >;\n      }) => Extras,\n    ): _Branch<Base, CrudResultAcc<Base, Acc, I, PS, Name, C, Extras>, I, PS>;\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Runtime: install .crud on any Branch via decorator\n// -----------------------------------------------------------------------------\n\n/**\n * Decorate a Branch instance so `.crud(...)` is available at runtime.\n * Tip: wrap the root: `withCrud(resource('/v1'))`.\n * @param branch Branch returned by `resource(...)`.\n * @returns Same branch with `.crud(...)` installed.\n */\nexport function withCrud<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n>(branch: _Branch<Base, Acc, I, PS>): _Branch<Base, Acc, I, PS> {\n  const b = branch as any;\n  if (typeof b.crud === 'function') return branch;\n\n  b.crud = function <\n    Name extends string,\n    C extends CrudCfg<Name>,\n    Extras extends readonly AnyLeaf[] = readonly [],\n  >(this: any, name: Name, cfg: C, extras?: (ctx: { collection: any; item: any }) => Extras) {\n    // Build inside a sub-branch at `/.../<name>` and harvest its leaves.\n    return this.sub(name, (collection: any) => {\n      const idKey = `${name}Id`;\n\n      // Accept a value schema (preferred); but if a z.object({[name]Id: ...}) is provided, use it.\n      const s = cfg.paramSchema;\n      const isObj =\n        s &&\n        typeof (s as any)._def === 'object' &&\n        (s as any)._def.typeName === 'ZodObject' &&\n        typeof (s as any).shape === 'function';\n\n      const paramValueSchema =\n        isObj && (s as any).shape()[idKey] ? ((s as any).shape()[idKey] as ZodType) : (s as ZodType);\n\n      const itemOut = cfg.itemOutputSchema;\n      const listOut =\n        cfg.list?.outputSchema ??\n        z.object({\n          items: z.array(itemOut),\n          nextCursor: z.string().optional(),\n        });\n\n      const want = {\n        list: cfg.enable?.list !== false,\n        create: cfg.enable?.create !== false && !!cfg.create?.bodySchema,\n        read: cfg.enable?.read !== false,\n        update: cfg.enable?.update !== false && !!cfg.update?.bodySchema,\n        remove: cfg.enable?.remove !== false,\n      } as const;\n\n      // Collection routes\n      if (want.list) {\n        collection.get({\n          feed: true,\n          querySchema: cfg.list?.querySchema ?? CrudDefaultPagination,\n          outputSchema: listOut,\n          description: cfg.list?.description ?? 'List',\n        });\n      }\n\n      if (want.create) {\n        collection.post({\n          bodySchema: cfg.create!.bodySchema,\n          outputSchema: cfg.create?.outputSchema ?? itemOut,\n          description: cfg.create?.description ?? 'Create',\n        });\n      }\n\n      // Item routes via :<name>Id\n      collection.routeParameter(idKey as any, paramValueSchema as any, (item: any) => {\n        if (want.read) {\n          item.get({\n            outputSchema: cfg.read?.outputSchema ?? itemOut,\n            description: cfg.read?.description ?? 'Read',\n          });\n        }\n        if (want.update) {\n          item.patch({\n            bodySchema: cfg.update!.bodySchema,\n            outputSchema: cfg.update?.outputSchema ?? itemOut,\n            description: cfg.update?.description ?? 'Update',\n          });\n        }\n        if (want.remove) {\n          item.delete({\n            outputSchema: cfg.remove?.outputSchema ?? z.object({ ok: z.literal(true) }),\n            description: cfg.remove?.description ?? 'Delete',\n          });\n        }\n\n        // Give extras fully-capable builders (decorate so extras can call .crud again)\n        if (extras) extras({ collection: withCrud(collection), item: withCrud(item) });\n\n        return item.done();\n      });\n\n      return collection.done();\n    });\n  };\n\n  return branch;\n}\n\n// -----------------------------------------------------------------------------\n// Optional convenience: re-export a resource() that already has .crud installed\n// -----------------------------------------------------------------------------\n\n/**\n * Drop-in replacement for `resource(...)` that returns a Branch with `.crud()` installed.\n * You can either use this or call `withCrud(resource(...))`.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Node configuration merged into every leaf.\n * @returns Branch builder that already includes the CRUD helper.\n */\nexport function resourceWithCrud<Base extends string, I extends NodeCfg = {}>(\n  base: Base,\n  inherited: I,\n) {\n  return withCrud(baseResource(base, inherited));\n}\n\n// Re-export the original in case you want both styles from this module\nexport { baseResource as resource };\n","// socket.index.ts (shared client/server)\n// TODO:\n// 1. Automatic feed handling:\n// * Expand onReceive to be like a middleware chain. This would allow for automatic feed handling middleware to be added that would handle:\n// - 1. updating maps/dictionaries based on feed messages\n// - 2. handling join/leave rooms\n// 2. General helpers: \n// - Easy combine of routes and sockets in the client: Room joining onReceive handlers, map helpers that build dictionaries of the data from feeds for easy access, lifecycle handling)\n// - Custom route structure definitions (feed + information routes, get/put/patch/delete based on few central schemas, )\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} ? Out : 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 = 'sys:connect' | 'sys:disconnect' | 'sys:reconnect' | 'sys:connect_error' | 'sys:ping' | 'sys:pong' | 'sys:room_join' | 'sys:room_leave';\nexport function defineSocketEvents<const C extends SocketConnectionConfig, const Schemas extends Record<string, {\n    message: z.ZodTypeAny;\n}>>(config: C, events: Schemas): {\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\n\n\nexport type Payload<T extends EventMap, K extends keyof T> = 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}"],"mappings":"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","names":["mergeSchemas","import_zod","mergeSchemas"]}
+{"version":3,"sources":["../src/index.ts","../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/crud/routesV3.crud.ts","../src/sockets/socket.index.ts","../src/docs/docs.ts"],"sourcesContent":["export * from './core/routesV3.builder';\nexport * from './core/routesV3.core';\nexport * from './core/routesV3.finalize';\nexport * from './crud/routesV3.crud';\nexport * from './sockets/socket.index';\nexport * from './docs/docs';","import { z } from 'zod';\nimport {\n  AnyLeaf,\n  Append,\n  HttpMethod,\n  Leaf,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n} from './routesV3.core';\n\nconst defaultFeedQuerySchema = z.object({\n  cursor: z.string().optional(),\n  limit: z.coerce.number().min(1).max(100).default(20),\n});\n\nconst paginationField = defaultFeedQuerySchema.optional().default(defaultFeedQuerySchema.parse({}));\ntype PaginationField = typeof paginationField;\n\ntype ZodTypeAny = z.ZodTypeAny;\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{ [K in Name]: S }>;\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>;\ntype ZodObjectAny = z.ZodObject<any>;\ntype AnyZodObject = z.ZodObject<any>;\ntype MergedParamsResult<PS, Name extends string, P extends ZodTypeAny> = PS extends ZodTypeAny\n  ? z.ZodIntersection<PS, ParamZod<Name, P>>\n  : ParamZod<Name, P>;\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('Feed queries must be a ZodObject; default pagination applied.');\n    return z.object({\n      pagination: paginationField,\n    });\n  }\n\n  const base = (schema as ZodObjectAny) ?? z.object({});\n  return base.extend({\n    pagination: paginationField,\n  });\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 ? (schema as any).shape : (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>(a: A, b: B): ZodTypeAny;\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A;\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B;\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined): 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 FeedQuerySchema<C extends MethodCfg> = z.ZodObject<any>;\n\ntype FeedOutputSchema<C extends MethodCfg> = 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 ? { feed: true } : { feed?: boolean };\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> = Q extends z.ZodObject<\n  infer Shape\n>\n  ? z.ZodObject<Shape & { pagination: PaginationField }>\n  : z.ZodObject<{ pagination: PaginationField }>;\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> = C['querySchema'] extends ZodTypeAny\n  ? { querySchema: C['querySchema'] }\n  : { querySchema?: undefined };\n\ntype FeedOutputField<C extends MethodCfg> = { outputSchema: FeedOutputSchema<C> };\n\ntype NonFeedOutputField<C extends MethodCfg> = 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> & NonFeedQueryField<C> & NonFeedOutputField<C> & 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, EffectiveCfg<C, PS>>>;\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\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<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeaf[]>(\n    name: Name,\n    cfg: J,\n    builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R,\n  ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;\n\n  sub<Name extends string, R extends readonly AnyLeaf[]>(\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<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\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<Base2 extends string, I2 extends NodeCfg, PS2 extends ZodTypeAny | undefined>(\n    base2: Base2,\n    inherited2: I2,\n    mergedParamsSchema?: PS2,\n  ) {\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 ?? currentParamsSchema) as PS2 | undefined;\n      const effectiveQuerySchema =\n        cfg.feed === true ? augmentFeedQuerySchema(cfg.querySchema) : cfg.querySchema;\n      const effectiveOutputSchema =\n        cfg.feed === true ? augmentFeedOutputSchema(cfg.outputSchema) : cfg.outputSchema;\n\n      const fullCfg = (\n        effectiveParamsSchema\n          ? {\n              ...inheritedCfg,\n              ...cfg,\n              paramsSchema: effectiveParamsSchema,\n              ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n              ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\n            }\n          : {\n              ...inheritedCfg,\n              ...cfg,\n              ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n              ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\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<Base2, Append<readonly [], typeof leaf>, I2, PS2>;\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 AnyLeaf[]),\n        maybeBuilder?: (r: any) => readonly AnyLeaf[],\n      ) {\n        let cfg: NodeCfg | undefined;\n        let builder: ((r: any) => readonly AnyLeaf[]) | 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<I2, NonNullable<J>>;\n\n        if (builder) {\n          // params schema PS2 flows through unchanged on plain sub\n          const child = makeBranch(childBase, childInherited, currentParamsSchema);\n          const leaves = builder(child) as readonly AnyLeaf[];\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<`${Base2}/${Name}`, readonly [], typeof childInherited, PS2>;\n        }\n      },\n\n      // the single param function: name + schema + builder\n      routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\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({ [name]: paramsSchema } as Record<Name, P>);\n        const childParams = (currentParamsSchema\n          ? mergeSchemas(currentParamsSchema, paramObj)\n          : paramObj) as MergedParamsResult<PS2, Name, P>;\n        const child = makeBranch(childBase, inheritedCfg as I2, childParams);\n        const leaves = builder(child) as readonly AnyLeaf[];\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, ZodTypeAny } 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\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg =  {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodTypeAny;\n  /** Zod schema describing the query string. */\n  querySchema?: ZodTypeAny;\n  /** Zod schema describing path params (overrides inferred params). */\n  paramsSchema?: ZodTypeAny;\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodTypeAny;\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  /** Optional human-readable description for docs/debugging. */\n  description?: string;\n};\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<M extends HttpMethod, P extends string, C extends MethodCfg> = {\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<A extends readonly unknown[], B extends readonly unknown[]> = [\n  ...A,\n  ...B,\n];\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 ? never : 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>(path: Path, params: ExtractParamsFromPath<Path>) {\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 [args.leaf.method, ...(p.split('/').filter(Boolean) as SplitPath<typeof p>), args.query ?? {}] as const;\n}\n\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeaf> = L['cfg']['paramsSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['paramsSchema']>\n  : ExtractParamsFromPath<L['path']>;\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf> = L['cfg']['querySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['querySchema']>\n  : never;\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf> = L['cfg']['bodySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['bodySchema']>\n  : never;\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf> = L['cfg']['outputSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['outputSchema']>\n  : unknown;\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 { AnyLeaf, 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 AnyLeaf> = L extends AnyLeaf\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 AnyLeaf[]> = KeyOf<Leaves[number]>;\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}` ? Lowercase<M> : never;\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}` ? P : never;\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<Leaves extends readonly AnyLeaf[], K extends string> = 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 AnyLeaf[]>(leaves: L) {\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 AnyLeaf[],\n  F extends string,\n  Acc extends readonly AnyLeaf[] = [],\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\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<T extends readonly AnyLeaf[], F extends string> = FilterRoute<T, F>;\ntype ByKey<\n  T extends readonly AnyLeaf[],\n  Acc extends Record<string, AnyLeaf> = {},\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n  ? ByKey<Rest, Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }>\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<T extends readonly AnyLeaf[], F extends string> = {\n  byKey: ByKey<Routes<T, F>>;\n  all: Routes<T, F>;\n};\n","// routesV3.crud.ts\n// -----------------------------------------------------------------------------\n// Add a first-class .crud() helper to the routesV3 DSL, without touching the\n// core builder. This file:\n//   1) Declares types + module augmentation to extend Branch<...> with .crud\n//   2) Provides a runtime decorator `withCrud(...)` that installs the method\n//   3) Exports a convenience `resourceWithCrud(...)` wrapper (optional)\n// -----------------------------------------------------------------------------\n\nimport { z, ZodType } from 'zod';\nimport {\n  resource as baseResource,\n  type Branch as _Branch, // import type so we can augment it\n} from '../core/routesV3.builder';\nimport { type AnyLeaf, type Leaf, type NodeCfg } from '../core/routesV3.core';\n\n// -----------------------------------------------------------------------------\n// Small utilities (runtime + types)\n// -----------------------------------------------------------------------------\n/** Default cursor pagination used by list (GET collection). */\nexport const CrudDefaultPagination = z.object({\n  limit: z.coerce.number().min(1).max(100).default(20),\n  cursor: z.string().optional(),\n});\nconst CrudPaginationField = CrudDefaultPagination.optional().default(CrudDefaultPagination.parse({}));\ntype CrudPaginationField = typeof CrudPaginationField;\ntype AnyCrudZodObject = z.ZodObject<any>;\ntype AddCrudPagination<Q extends AnyCrudZodObject | undefined> = Q extends z.ZodObject<infer Shape>\n  ? z.ZodObject<Shape & { pagination: CrudPaginationField }>\n  : z.ZodObject<{ pagination: CrudPaginationField }>;\n\n/**\n * Merge two Zod schemas at runtime; matches the typing pattern used in builder.\n * @param a Existing params schema inherited from parent branches.\n * @param b Schema introduced at the current branch.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nexport function mergeSchemas<A extends ZodType | undefined, B extends ZodType | undefined>(\n  a: A,\n  b: B,\n): A extends ZodType ? (B extends ZodType ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n  if (a && b) return z.intersection(a as any, b as any) as any;\n  return (a ?? b) as any;\n}\n\n/** Build { [Name]: S } Zod object at the type-level. */\nexport type ParamSchema<Name extends string, S extends ZodType> = z.ZodObject<{\n  [K in Name]: S;\n}>;\n\n/** Inject active params schema into a leaf cfg (to match your Leaf typing). */\ntype WithParams<I, P> = P extends ZodType ? Omit<I, 'paramsSchema'> & { paramsSchema: P } : I;\n\n/** Resolve boolean flag: default D unless explicitly false. */\ntype Flag<E, D extends boolean> = E extends false ? false : D;\n\n// -----------------------------------------------------------------------------\n// CRUD config (few knobs, with DX comments)\n// -----------------------------------------------------------------------------\n\n/** Toggle individual CRUD methods; defaults enable all (create/update require body). */\nexport type CrudEnable = {\n  /** GET /collection (feed). Defaults to true. */ list?: boolean;\n  /** POST /collection. Defaults to true if `create` provided. */ create?: boolean;\n  /** GET /collection/:id. Defaults to true. */ read?: boolean;\n  /** PATCH /collection/:id. Defaults to true if `update` provided. */ update?: boolean;\n  /** DELETE /collection/:id. Defaults to true. */ remove?: boolean;\n};\n\n/** Collection GET config. */\nexport type CrudListCfg = {\n  /** Query schema (defaults to cursor pagination). */\n  querySchema?: ZodType;\n  /** Output schema (defaults to { items: Item[], nextCursor? }). */\n  outputSchema?: ZodType;\n  /** Optional description string. */\n  description?: string;\n};\n\n/** Collection POST config. */\nexport type CrudCreateCfg = {\n  /** Body schema for creating an item. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item GET config. */\nexport type CrudReadCfg = {\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item PATCH config. */\nexport type CrudUpdateCfg = {\n  /** Body schema for partial updates. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item DELETE config. */\nexport type CrudRemoveCfg = {\n  /** Output schema (defaults to { ok: true }). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/**\n * CRUD config for `.crud(\"resource\", cfg, extras?)`.\n *\n * It synthesizes `:[resourceName]Id` as the param key and uses `paramSchema` for the value.\n * Prefer passing a **value schema** (e.g. `z.string().uuid()`).\n * As a convenience, a ZodObject of shape `{ [resourceName]Id: schema }` is accepted at runtime too.\n */\nexport type CrudCfg<Name extends string = string> = {\n  /**\n   * Zod schema for the ID *value* (e.g. `z.string().uuid()`).\n   * The parameter key is always `:${name}Id`.\n   * (If you pass `z.object({ [name]Id: ... })`, it's accepted at runtime.)\n   */\n  paramSchema: ZodType;\n\n  /**\n   * The single-item output shape used by read/create/update by default.\n   * List defaults to `{ items: z.array(itemOutputSchema), nextCursor? }`.\n   */\n  itemOutputSchema: ZodType;\n\n  /** Per-method toggles (all enabled by default; create/update require bodies). */\n  enable?: CrudEnable;\n\n  /** GET /collection configuration. */ list?: CrudListCfg;\n  /** POST /collection configuration (enables create). */ create?: CrudCreateCfg;\n  /** GET /collection/:id configuration. */ read?: CrudReadCfg;\n  /** PATCH /collection/:id configuration (enables update). */ update?: CrudUpdateCfg;\n  /** DELETE /collection/:id configuration. */ remove?: CrudRemoveCfg;\n};\n\n// -----------------------------------------------------------------------------\n// Type plumbing to expose generated leaves (so finalize().byKey sees them)\n// -----------------------------------------------------------------------------\n\ntype CrudLeavesTuple<\n  Base extends string,\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n> = `${Name}Id` extends infer IdName extends string\n  ? ParamSchema<IdName, C['paramSchema']> extends infer IdParamZ extends ZodType\n    ? [\n        // GET /collection\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['list'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}`,\n                WithParams<\n                  Omit<I, never> & {\n                    feed: true;\n                    querySchema: C['list'] extends CrudListCfg\n                      ? AddCrudPagination<\n                          C['list']['querySchema'] extends AnyCrudZodObject\n                            ? C['list']['querySchema']\n                            : undefined\n                        >\n                      : AddCrudPagination<undefined>;\n                    outputSchema: C['list'] extends CrudListCfg\n                      ? C['list']['outputSchema'] extends ZodType\n                        ? C['list']['outputSchema']\n                        : z.ZodObject<{\n                            items: z.ZodArray<C['itemOutputSchema']>;\n                            nextCursor: z.ZodOptional<z.ZodString>;\n                          }>\n                      : z.ZodObject<{\n                          items: z.ZodArray<C['itemOutputSchema']>;\n                          nextCursor: z.ZodOptional<z.ZodString>;\n                        }>;\n                    description?: string;\n                  },\n                  PS\n                >\n              >,\n            ]\n          : []),\n\n        // POST /collection\n        ...((C['create'] extends CrudCreateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['create'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'post',\n                  `${Base}/${Name}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['bodySchema']\n                        : never;\n                      outputSchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['outputSchema'] extends ZodType\n                          ? C['create']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    PS\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // GET /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['read'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['read'] extends CrudReadCfg\n                      ? C['read']['outputSchema'] extends ZodType\n                        ? C['read']['outputSchema']\n                        : C['itemOutputSchema']\n                      : C['itemOutputSchema'];\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n\n        // PATCH /collection/:id\n        ...((C['update'] extends CrudUpdateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['update'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'patch',\n                  `${Base}/${Name}/:${IdName}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['bodySchema']\n                        : never;\n                      outputSchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['outputSchema'] extends ZodType\n                          ? C['update']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // DELETE /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['remove'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'delete',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['remove'] extends CrudRemoveCfg\n                      ? C['remove']['outputSchema'] extends ZodType\n                        ? C['remove']['outputSchema']\n                        : z.ZodObject<{ ok: z.ZodLiteral<true> }>\n                      : z.ZodObject<{ ok: z.ZodLiteral<true> }>;\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n      ]\n    : never\n  : never;\n\n/** Merge generated leaves + extras into the branch accumulator. */\ntype CrudResultAcc<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n  Extras extends readonly AnyLeaf[],\n> = [...Acc, ...CrudLeavesTuple<Base, I, PS, Name, C>, ...Extras];\n\n// -----------------------------------------------------------------------------\n// Module augmentation: add the typed `.crud(...)` to Branch<...>\n// -----------------------------------------------------------------------------\n\ndeclare module './../core/routesV3.builder' {\n  interface Branch<\n    Base extends string,\n    Acc extends readonly AnyLeaf[],\n    I extends NodeCfg,\n    PS extends ZodType | undefined,\n  > {\n    /**\n     * Generate opinionated CRUD endpoints for a collection at `/.../<name>`\n     * with an item at `/.../<name>/:<name>Id`.\n     *\n     * Creates (subject to `enable` + presence of create/update bodies):\n     * - GET    /<name>                (feed list)\n     * - POST   /<name>                (create)\n     * - GET    /<name>/:<name>Id      (read item)\n     * - PATCH  /<name>/:<name>Id      (update item)\n     * - DELETE /<name>/:<name>Id      (remove item)\n     *\n     * The `extras` callback receives live builders at both collection and item\n     * levels so you can add custom subroutes; their leaves are included in the\n     * returned Branch type.\n     */\n    crud<\n      Name extends string,\n      C extends CrudCfg<Name>,\n      Extras extends readonly AnyLeaf[] = readonly [],\n    >(\n      name: Name,\n      cfg: C,\n      extras?: (ctx: {\n        /** Builder at `/.../<name>` (collection scope). */\n        collection: _Branch<`${Base}/${Name}`, readonly [], I, PS>;\n        /** Builder at `/.../<name>/:<name>Id` (item scope). */\n        item: _Branch<\n          `${Base}/${Name}/:${`${Name}Id`}`,\n          readonly [],\n          I,\n          ReturnType<typeof mergeSchemas<PS, ParamSchema<`${Name}Id`, C['paramSchema']>>>\n        >;\n      }) => Extras,\n    ): _Branch<Base, CrudResultAcc<Base, Acc, I, PS, Name, C, Extras>, I, PS>;\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Runtime: install .crud on any Branch via decorator\n// -----------------------------------------------------------------------------\n\n/**\n * Decorate a Branch instance so `.crud(...)` is available at runtime.\n * Tip: wrap the root: `withCrud(resource('/v1'))`.\n * @param branch Branch returned by `resource(...)`.\n * @returns Same branch with `.crud(...)` installed.\n */\nexport function withCrud<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n>(branch: _Branch<Base, Acc, I, PS>): _Branch<Base, Acc, I, PS> {\n  const b = branch as any;\n  if (typeof b.crud === 'function') return branch;\n\n  b.crud = function <\n    Name extends string,\n    C extends CrudCfg<Name>,\n    Extras extends readonly AnyLeaf[] = readonly [],\n  >(this: any, name: Name, cfg: C, extras?: (ctx: { collection: any; item: any }) => Extras) {\n    // Build inside a sub-branch at `/.../<name>` and harvest its leaves.\n    return this.sub(name, (collection: any) => {\n      const idKey = `${name}Id`;\n\n      // Accept a value schema (preferred); but if a z.object({[name]Id: ...}) is provided, use it.\n      const s = cfg.paramSchema;\n      const isObj =\n        s &&\n        typeof (s as any)._def === 'object' &&\n        (s as any)._def.typeName === 'ZodObject' &&\n        typeof (s as any).shape === 'function';\n\n      const paramValueSchema =\n        isObj && (s as any).shape()[idKey] ? ((s as any).shape()[idKey] as ZodType) : (s as ZodType);\n\n      const itemOut = cfg.itemOutputSchema;\n      const listOut =\n        cfg.list?.outputSchema ??\n        z.object({\n          items: z.array(itemOut),\n          nextCursor: z.string().optional(),\n        });\n\n      const want = {\n        list: cfg.enable?.list !== false,\n        create: cfg.enable?.create !== false && !!cfg.create?.bodySchema,\n        read: cfg.enable?.read !== false,\n        update: cfg.enable?.update !== false && !!cfg.update?.bodySchema,\n        remove: cfg.enable?.remove !== false,\n      } as const;\n\n      // Collection routes\n      if (want.list) {\n        collection.get({\n          feed: true,\n          querySchema: cfg.list?.querySchema ?? CrudDefaultPagination,\n          outputSchema: listOut,\n          description: cfg.list?.description ?? 'List',\n        });\n      }\n\n      if (want.create) {\n        collection.post({\n          bodySchema: cfg.create!.bodySchema,\n          outputSchema: cfg.create?.outputSchema ?? itemOut,\n          description: cfg.create?.description ?? 'Create',\n        });\n      }\n\n      // Item routes via :<name>Id\n      collection.routeParameter(idKey as any, paramValueSchema as any, (item: any) => {\n        if (want.read) {\n          item.get({\n            outputSchema: cfg.read?.outputSchema ?? itemOut,\n            description: cfg.read?.description ?? 'Read',\n          });\n        }\n        if (want.update) {\n          item.patch({\n            bodySchema: cfg.update!.bodySchema,\n            outputSchema: cfg.update?.outputSchema ?? itemOut,\n            description: cfg.update?.description ?? 'Update',\n          });\n        }\n        if (want.remove) {\n          item.delete({\n            outputSchema: cfg.remove?.outputSchema ?? z.object({ ok: z.literal(true) }),\n            description: cfg.remove?.description ?? 'Delete',\n          });\n        }\n\n        // Give extras fully-capable builders (decorate so extras can call .crud again)\n        if (extras) extras({ collection: withCrud(collection), item: withCrud(item) });\n\n        return item.done();\n      });\n\n      return collection.done();\n    });\n  };\n\n  return branch;\n}\n\n// -----------------------------------------------------------------------------\n// Optional convenience: re-export a resource() that already has .crud installed\n// -----------------------------------------------------------------------------\n\n/**\n * Drop-in replacement for `resource(...)` that returns a Branch with `.crud()` installed.\n * You can either use this or call `withCrud(resource(...))`.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Node configuration merged into every leaf.\n * @returns Branch builder that already includes the CRUD helper.\n */\nexport function resourceWithCrud<Base extends string, I extends NodeCfg = {}>(\n  base: Base,\n  inherited: I,\n) {\n  return withCrud(baseResource(base, inherited));\n}\n\n// Re-export the original in case you want both styles from this module\nexport { baseResource as resource };\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} ? Out : 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 = 'sys:connect' | 'sys:disconnect' | 'sys:reconnect' | 'sys:connect_error' | 'sys:ping' | 'sys:pong' | 'sys:room_join' | 'sys:room_leave';\nexport function defineSocketEvents<const C extends SocketConnectionConfig, const Schemas extends Record<string, {\n    message: z.ZodTypeAny;\n}>>(config: C, events: Schemas): {\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\n\n\nexport type Payload<T extends EventMap, K extends keyof T> = 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}","// docs-generator.ts\nimport { z, ZodType, ZodObject, ZodArray } from \"zod\";\nimport { AnyLeaf, FileField } from \"../core/routesV3.core\";\n\n\n// ------------------------------------------------------------\n// Schema summarizer (lightweight introspection for Zod v4)\n// ------------------------------------------------------------\nfunction summarizeSchema(schema?: ZodType): unknown {\n  if (!schema) return undefined;\n\n  // ZodObject\n  if (schema instanceof ZodObject) {\n    const shape = schema.shape;\n    return {\n      type: \"object\",\n      fields: Object.fromEntries(\n        Object.entries(shape).map(([key, value]) => {\n          const def: any = (value as any)._def;\n          return [\n            key,\n            {\n              typeName: def?.typeName,\n              description: def?.description\n            }\n          ];\n        })\n      )\n    };\n  }\n\n  // ZodArray\n  if (schema instanceof ZodArray) {\n    return {\n      type: \"array\",\n      // @ts-ignore\n      element: summarizeSchema(schema.unwrap())\n    };\n  }\n\n  // fallback for primitives and complex types\n  const def: any = (schema as any)._def;\n  return { typeName: def?.typeName ?? \"unknown\" };\n}\n\n// ------------------------------------------------------------\n// Build a structured doc model from AnyLeaf[]\n// ------------------------------------------------------------\ntype RouteDoc = {\n  method: string;\n  path: string;\n  description?: string;\n  feed?: boolean;\n  body?: unknown;\n  query?: unknown;\n  params?: unknown;\n  output?: unknown;\n  files?: FileField[];\n};\n\nfunction leavesToDocs(leaves: AnyLeaf[]): RouteDoc[] {\n  return leaves.map((leaf) => {\n    const { method, path, cfg } = leaf;\n\n    return {\n      method,\n      path,\n      description: cfg.description,\n      feed: cfg.feed,\n      body: summarizeSchema(cfg.bodySchema),\n      query: summarizeSchema(cfg.querySchema),\n      params: summarizeSchema(cfg.paramsSchema),\n      output: summarizeSchema(cfg.outputSchema),\n      files: cfg.bodyFiles\n    };\n  });\n}\n\n// ------------------------------------------------------------\n// Markdown renderer for the docs\n// ------------------------------------------------------------\nexport function renderLeafDocsMarkdown(leaves: AnyLeaf[]): string {\n  const docs = leavesToDocs(leaves);\n\n  docs.sort((a, b) => {\n    const p = a.path.localeCompare(b.path);\n    return p !== 0 ? p : a.method.localeCompare(b.method);\n  });\n\n  return docs\n    .map((d) => {\n      const lines: string[] = [];\n\n      lines.push(`### \\`${d.method.toUpperCase()} ${d.path}\\``);\n\n      if (d.description) {\n        lines.push(\"\", d.description);\n      }\n\n      if (d.feed) {\n        lines.push(\"\", \"_Feed endpoint_\");\n      }\n\n      function pushJson(title: string, value: unknown | undefined) {\n        if (!value) return;\n        lines.push(\n          \"\",\n          `**${title}**`,\n          \"```json\",\n          JSON.stringify(value, null, 2),\n          \"```\"\n        );\n      }\n\n      pushJson(\"Query\", d.query);\n      pushJson(\"Params\", d.params);\n      pushJson(\"Body\", d.body);\n      pushJson(\"Output\", d.output);\n\n      if (d.files && d.files.length > 0) {\n        lines.push(\"\", \"**Multipart files**\");\n        d.files.forEach((f) => {\n          lines.push(`- \\`${f.name}\\` (maxCount: ${f.maxCount})`);\n        });\n      }\n\n      return lines.join(\"\\n\");\n    })\n    .join(\"\\n\\n\");\n}"],"mappings":"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","names":["mergeSchemas","import_zod","mergeSchemas","import_zod","def"]}

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export * from './core/routesV3.core';
 export * from './core/routesV3.finalize';
 export * from './crud/routesV3.crud';
 export * from './sockets/socket.index';
+export * from './docs/docs';

package/dist/index.mjs

@@ -1,5 +1,50 @@
 // src/core/routesV3.builder.ts
 import { z } from "zod";
+var defaultFeedQuerySchema = z.object({
+  cursor: z.string().optional(),
+  limit: z.coerce.number().min(1).max(100).default(20)
+});
+var paginationField = defaultFeedQuerySchema.optional().default(defaultFeedQuerySchema.parse({}));
+var defaultFeedOutputSchema = z.object({
+  items: z.array(z.unknown()),
+  nextCursor: z.string().optional()
+});
+function augmentFeedQuerySchema(schema) {
+  if (schema && !(schema instanceof z.ZodObject)) {
+    console.warn("Feed queries must be a ZodObject; default pagination applied.");
+    return z.object({
+      pagination: paginationField
+    });
+  }
+  const base = schema ?? z.object({});
+  return base.extend({
+    pagination: paginationField
+  });
+}
+function augmentFeedOutputSchema(schema) {
+  if (!schema) return defaultFeedOutputSchema;
+  if (schema instanceof z.ZodArray) {
+    return z.object({
+      items: schema,
+      nextCursor: z.string().optional()
+    });
+  }
+  if (schema instanceof z.ZodObject) {
+    const shape = schema.shape ? schema.shape : schema._def?.shape?.();
+    const hasItems = Boolean(shape?.items);
+    if (hasItems) {
+      return schema.extend({ nextCursor: z.string().optional() });
+    }
+    return z.object({
+      items: z.array(schema),
+      nextCursor: z.string().optional()
+    });
+  }
+  return z.object({
+    items: z.array(schema),
+    nextCursor: z.string().optional()
+  });
+}
 function mergeSchemas(a, b) {
   if (a && b) return z.intersection(a, b);
   return a ?? b;
@@ -14,7 +59,20 @@ function resource(base, inherited) {
     let currentParamsSchema = mergedParamsSchema;
     function add(method, cfg) {
       const effectiveParamsSchema = cfg.paramsSchema ?? currentParamsSchema;
-      const fullCfg = effectiveParamsSchema ? { ...inheritedCfg, ...cfg, paramsSchema: effectiveParamsSchema } : { ...inheritedCfg, ...cfg };
+      const effectiveQuerySchema = cfg.feed === true ? augmentFeedQuerySchema(cfg.querySchema) : cfg.querySchema;
+      const effectiveOutputSchema = cfg.feed === true ? augmentFeedOutputSchema(cfg.outputSchema) : cfg.outputSchema;
+      const fullCfg = effectiveParamsSchema ? {
+        ...inheritedCfg,
+        ...cfg,
+        paramsSchema: effectiveParamsSchema,
+        ...effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {},
+        ...effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}
+      } : {
+        ...inheritedCfg,
+        ...cfg,
+        ...effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {},
+        ...effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}
+      };
       const leaf = {
         method,
         path: currentBase,
@@ -51,7 +109,7 @@ function resource(base, inherited) {
       routeParameter(name, paramsSchema, builder) {
         const childBase = `${currentBase}/:${name}`;
         const paramObj = z.object({ [name]: paramsSchema });
-        const childParams = mergeSchemas(currentParamsSchema, paramObj);
+        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);
@@ -127,6 +185,7 @@ var CrudDefaultPagination = z2.object({
   limit: z2.coerce.number().min(1).max(100).default(20),
   cursor: z2.string().optional()
 });
+var CrudPaginationField = CrudDefaultPagination.optional().default(CrudDefaultPagination.parse({}));
 function mergeSchemas2(a, b) {
   if (a && b) return z2.intersection(a, b);
   return a ?? b;
@@ -203,6 +262,93 @@ function resourceWithCrud(base, inherited) {
 function defineSocketEvents(config, events) {
   return { config, events };
 }
+
+// src/docs/docs.ts
+import { ZodObject, ZodArray } from "zod";
+function summarizeSchema(schema) {
+  if (!schema) return void 0;
+  if (schema instanceof ZodObject) {
+    const shape = schema.shape;
+    return {
+      type: "object",
+      fields: Object.fromEntries(
+        Object.entries(shape).map(([key, value]) => {
+          const def2 = value._def;
+          return [
+            key,
+            {
+              typeName: def2?.typeName,
+              description: def2?.description
+            }
+          ];
+        })
+      )
+    };
+  }
+  if (schema instanceof ZodArray) {
+    return {
+      type: "array",
+      // @ts-ignore
+      element: summarizeSchema(schema.unwrap())
+    };
+  }
+  const def = schema._def;
+  return { typeName: def?.typeName ?? "unknown" };
+}
+function leavesToDocs(leaves) {
+  return leaves.map((leaf) => {
+    const { method, path, cfg } = leaf;
+    return {
+      method,
+      path,
+      description: cfg.description,
+      feed: cfg.feed,
+      body: summarizeSchema(cfg.bodySchema),
+      query: summarizeSchema(cfg.querySchema),
+      params: summarizeSchema(cfg.paramsSchema),
+      output: summarizeSchema(cfg.outputSchema),
+      files: cfg.bodyFiles
+    };
+  });
+}
+function renderLeafDocsMarkdown(leaves) {
+  const docs = leavesToDocs(leaves);
+  docs.sort((a, b) => {
+    const p = a.path.localeCompare(b.path);
+    return p !== 0 ? p : a.method.localeCompare(b.method);
+  });
+  return docs.map((d) => {
+    const lines = [];
+    lines.push(`### \`${d.method.toUpperCase()} ${d.path}\``);
+    if (d.description) {
+      lines.push("", d.description);
+    }
+    if (d.feed) {
+      lines.push("", "_Feed endpoint_");
+    }
+    function pushJson(title, value) {
+      if (!value) return;
+      lines.push(
+        "",
+        `**${title}**`,
+        "```json",
+        JSON.stringify(value, null, 2),
+        "```"
+      );
+    }
+    pushJson("Query", d.query);
+    pushJson("Params", d.params);
+    pushJson("Body", d.body);
+    pushJson("Output", d.output);
+    if (d.files && d.files.length > 0) {
+      lines.push("", "**Multipart files**");
+      d.files.forEach((f) => {
+        lines.push(`- \`${f.name}\` (maxCount: ${f.maxCount})`);
+      });
+    }
+    return lines.join("\n");
+  }).join("\n\n");
+}
 export {
   CrudDefaultPagination,
   buildCacheKey,
@@ -211,6 +357,7 @@ export {
   finalize,
   mergeArrays,
   mergeSchemas2 as mergeSchemas,
+  renderLeafDocsMarkdown,
   resource,
   resourceWithCrud,
   withCrud

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/crud/routesV3.crud.ts","../src/sockets/socket.index.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  AnyLeaf,\n  Append,\n  HttpMethod,\n  Leaf,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n} from './routesV3.core';\n\ntype ZodTypeAny = z.ZodTypeAny;\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{ [K in Name]: S }>;\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 | undefined, B extends ZodTypeAny | undefined>(\n  a: A,\n  b: B,\n): A extends ZodTypeAny ? (B extends ZodTypeAny ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n  if (a && b) return z.intersection(a as any, b as any) as any;\n  return (a ?? b) as any;\n}\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\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<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeaf[]>(\n    name: Name,\n    cfg: J,\n    builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R,\n  ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;\n\n  sub<Name extends string, R extends readonly AnyLeaf[]>(\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<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n    name: Name,\n    paramsSchema: P,\n    builder: (\n      r: Branch<\n        `${Base}/:${Name}`,\n        readonly [],\n        I,\n        ReturnType<typeof mergeSchemas<PS, ParamZod<Name, P>>>\n      >,\n    ) => R,\n  ): Branch<Base, MergeArray<Acc, R>, I, ReturnType<typeof mergeSchemas<PS, ParamZod<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 Omit<MethodCfg, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Prettify<Leaf<'get', Base, Merge<Merge<I, C>, { paramsSchema: 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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<Base, Append<Acc, Leaf<'post', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>, I, PS>;\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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<Base, Append<Acc, Leaf<'put', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>, I, PS>;\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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Leaf<'patch', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>,\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, 'paramsSchema'>>(\n    cfg: C,\n  ): Branch<\n    Base,\n    Append<Acc, Leaf<'delete', Base, Merge<Merge<I, C>, { paramsSchema: PS }>>>,\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<Base2 extends string, I2 extends NodeCfg, PS2 extends ZodTypeAny | undefined>(\n    base2: Base2,\n    inherited2: I2,\n    mergedParamsSchema?: PS2,\n  ) {\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 ?? currentParamsSchema) as PS2 | undefined;\n      const fullCfg = (\n        effectiveParamsSchema\n          ? { ...inheritedCfg, ...cfg, paramsSchema: effectiveParamsSchema }\n          : { ...inheritedCfg, ...cfg }\n      ) as Merge<I2, C>;\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<Base2, Append<readonly [], typeof leaf>, I2, PS2>;\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 AnyLeaf[]),\n        maybeBuilder?: (r: any) => readonly AnyLeaf[],\n      ) {\n        let cfg: NodeCfg | undefined;\n        let builder: ((r: any) => readonly AnyLeaf[]) | 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<I2, NonNullable<J>>;\n\n        if (builder) {\n          // params schema PS2 flows through unchanged on plain sub\n          const child = makeBranch(childBase, childInherited, currentParamsSchema);\n          const leaves = builder(child) as readonly AnyLeaf[];\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<`${Base2}/${Name}`, readonly [], typeof childInherited, PS2>;\n        }\n      },\n\n      // the single param function: name + schema + builder\n      routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n        name: Name,\n        paramsSchema: P,\n        builder: (\n          r: Branch<\n            `${Base2}/:${Name}`,\n            readonly [],\n            I2,\n            ReturnType<typeof mergeSchemas<PS2, ParamZod<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({ [name]: paramsSchema } as Record<Name, P>);\n        const childParams = mergeSchemas<PS2, ParamZod<Name, P>>(currentParamsSchema, paramObj);\n        const child = makeBranch(childBase, inheritedCfg as I2, childParams);\n        const leaves = builder(child) as readonly AnyLeaf[];\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          ReturnType<typeof mergeSchemas<PS2, ParamZod<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, ZodTypeAny } 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\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg =  {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodTypeAny;\n  /** Zod schema describing the query string. */\n  querySchema?: ZodTypeAny;\n  /** Zod schema describing path params (overrides inferred params). */\n  paramsSchema?: ZodTypeAny;\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodTypeAny;\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  /** Optional human-readable description for docs/debugging. */\n  description?: string;\n};\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<M extends HttpMethod, P extends string, C extends MethodCfg> = {\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<A extends readonly unknown[], B extends readonly unknown[]> = [\n  ...A,\n  ...B,\n];\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 ? never : 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>(path: Path, params: ExtractParamsFromPath<Path>) {\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 [args.leaf.method, ...(p.split('/').filter(Boolean) as SplitPath<typeof p>), args.query ?? {}] as const;\n}\n\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeaf> = L['cfg']['paramsSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['paramsSchema']>\n  : ExtractParamsFromPath<L['path']>;\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf> = L['cfg']['querySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['querySchema']>\n  : never;\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf> = L['cfg']['bodySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['bodySchema']>\n  : never;\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf> = L['cfg']['outputSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['outputSchema']>\n  : unknown;\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n","import { AnyLeaf, 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 AnyLeaf> = L extends AnyLeaf\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 AnyLeaf[]> = KeyOf<Leaves[number]>;\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}` ? Lowercase<M> : never;\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}` ? P : never;\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<Leaves extends readonly AnyLeaf[], K extends string> = 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 AnyLeaf[]>(leaves: L) {\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 AnyLeaf[],\n  F extends string,\n  Acc extends readonly AnyLeaf[] = [],\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\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<T extends readonly AnyLeaf[], F extends string> = FilterRoute<T, F>;\ntype ByKey<\n  T extends readonly AnyLeaf[],\n  Acc extends Record<string, AnyLeaf> = {},\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n  ? ByKey<Rest, Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }>\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<T extends readonly AnyLeaf[], F extends string> = {\n  byKey: ByKey<Routes<T, F>>;\n  all: Routes<T, F>;\n};\n","// routesV3.crud.ts\n// -----------------------------------------------------------------------------\n// Add a first-class .crud() helper to the routesV3 DSL, without touching the\n// core builder. This file:\n//   1) Declares types + module augmentation to extend Branch<...> with .crud\n//   2) Provides a runtime decorator `withCrud(...)` that installs the method\n//   3) Exports a convenience `resourceWithCrud(...)` wrapper (optional)\n// -----------------------------------------------------------------------------\n\nimport { z, ZodType } from 'zod';\nimport {\n  resource as baseResource,\n  type Branch as _Branch, // import type so we can augment it\n} from '../core/routesV3.builder';\nimport { type AnyLeaf, type Leaf, type NodeCfg } from '../core/routesV3.core';\n\n// -----------------------------------------------------------------------------\n// Small utilities (runtime + types)\n// -----------------------------------------------------------------------------\n/** Default cursor pagination used by list (GET collection). */\nexport const CrudDefaultPagination = z.object({\n  limit: z.coerce.number().min(1).max(100).default(20),\n  cursor: z.string().optional(),\n});\n\n/**\n * Merge two Zod schemas at runtime; matches the typing pattern used in builder.\n * @param a Existing params schema inherited from parent branches.\n * @param b Schema introduced at the current branch.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nexport function mergeSchemas<A extends ZodType | undefined, B extends ZodType | undefined>(\n  a: A,\n  b: B,\n): A extends ZodType ? (B extends ZodType ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n  if (a && b) return z.intersection(a as any, b as any) as any;\n  return (a ?? b) as any;\n}\n\n/** Build { [Name]: S } Zod object at the type-level. */\nexport type ParamSchema<Name extends string, S extends ZodType> = z.ZodObject<{\n  [K in Name]: S;\n}>;\n\n/** Inject active params schema into a leaf cfg (to match your Leaf typing). */\ntype WithParams<I, P> = P extends ZodType ? Omit<I, 'paramsSchema'> & { paramsSchema: P } : I;\n\n/** Resolve boolean flag: default D unless explicitly false. */\ntype Flag<E, D extends boolean> = E extends false ? false : D;\n\n// -----------------------------------------------------------------------------\n// CRUD config (few knobs, with DX comments)\n// -----------------------------------------------------------------------------\n\n/** Toggle individual CRUD methods; defaults enable all (create/update require body). */\nexport type CrudEnable = {\n  /** GET /collection (feed). Defaults to true. */ list?: boolean;\n  /** POST /collection. Defaults to true if `create` provided. */ create?: boolean;\n  /** GET /collection/:id. Defaults to true. */ read?: boolean;\n  /** PATCH /collection/:id. Defaults to true if `update` provided. */ update?: boolean;\n  /** DELETE /collection/:id. Defaults to true. */ remove?: boolean;\n};\n\n/** Collection GET config. */\nexport type CrudListCfg = {\n  /** Query schema (defaults to cursor pagination). */\n  querySchema?: ZodType;\n  /** Output schema (defaults to { items: Item[], nextCursor? }). */\n  outputSchema?: ZodType;\n  /** Optional description string. */\n  description?: string;\n};\n\n/** Collection POST config. */\nexport type CrudCreateCfg = {\n  /** Body schema for creating an item. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item GET config. */\nexport type CrudReadCfg = {\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item PATCH config. */\nexport type CrudUpdateCfg = {\n  /** Body schema for partial updates. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item DELETE config. */\nexport type CrudRemoveCfg = {\n  /** Output schema (defaults to { ok: true }). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/**\n * CRUD config for `.crud(\"resource\", cfg, extras?)`.\n *\n * It synthesizes `:[resourceName]Id` as the param key and uses `paramSchema` for the value.\n * Prefer passing a **value schema** (e.g. `z.string().uuid()`).\n * As a convenience, a ZodObject of shape `{ [resourceName]Id: schema }` is accepted at runtime too.\n */\nexport type CrudCfg<Name extends string = string> = {\n  /**\n   * Zod schema for the ID *value* (e.g. `z.string().uuid()`).\n   * The parameter key is always `:${name}Id`.\n   * (If you pass `z.object({ [name]Id: ... })`, it's accepted at runtime.)\n   */\n  paramSchema: ZodType;\n\n  /**\n   * The single-item output shape used by read/create/update by default.\n   * List defaults to `{ items: z.array(itemOutputSchema), nextCursor? }`.\n   */\n  itemOutputSchema: ZodType;\n\n  /** Per-method toggles (all enabled by default; create/update require bodies). */\n  enable?: CrudEnable;\n\n  /** GET /collection configuration. */ list?: CrudListCfg;\n  /** POST /collection configuration (enables create). */ create?: CrudCreateCfg;\n  /** GET /collection/:id configuration. */ read?: CrudReadCfg;\n  /** PATCH /collection/:id configuration (enables update). */ update?: CrudUpdateCfg;\n  /** DELETE /collection/:id configuration. */ remove?: CrudRemoveCfg;\n};\n\n// -----------------------------------------------------------------------------\n// Type plumbing to expose generated leaves (so finalize().byKey sees them)\n// -----------------------------------------------------------------------------\n\ntype CrudLeavesTuple<\n  Base extends string,\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n> = `${Name}Id` extends infer IdName extends string\n  ? ParamSchema<IdName, C['paramSchema']> extends infer IdParamZ extends ZodType\n    ? [\n        // GET /collection\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['list'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}`,\n                WithParams<\n                  Omit<I, never> & {\n                    feed: true;\n                    querySchema: C['list'] extends CrudListCfg\n                      ? C['list']['querySchema']\n                      : typeof CrudDefaultPagination;\n                    outputSchema: C['list'] extends CrudListCfg\n                      ? C['list']['outputSchema'] extends ZodType\n                        ? C['list']['outputSchema']\n                        : z.ZodObject<{\n                            items: z.ZodArray<C['itemOutputSchema']>;\n                            nextCursor: z.ZodOptional<z.ZodString>;\n                          }>\n                      : z.ZodObject<{\n                          items: z.ZodArray<C['itemOutputSchema']>;\n                          nextCursor: z.ZodOptional<z.ZodString>;\n                        }>;\n                    description?: string;\n                  },\n                  PS\n                >\n              >,\n            ]\n          : []),\n\n        // POST /collection\n        ...((C['create'] extends CrudCreateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['create'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'post',\n                  `${Base}/${Name}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['bodySchema']\n                        : never;\n                      outputSchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['outputSchema'] extends ZodType\n                          ? C['create']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    PS\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // GET /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['read'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['read'] extends CrudReadCfg\n                      ? C['read']['outputSchema'] extends ZodType\n                        ? C['read']['outputSchema']\n                        : C['itemOutputSchema']\n                      : C['itemOutputSchema'];\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n\n        // PATCH /collection/:id\n        ...((C['update'] extends CrudUpdateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['update'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'patch',\n                  `${Base}/${Name}/:${IdName}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['bodySchema']\n                        : never;\n                      outputSchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['outputSchema'] extends ZodType\n                          ? C['update']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // DELETE /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['remove'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'delete',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['remove'] extends CrudRemoveCfg\n                      ? C['remove']['outputSchema'] extends ZodType\n                        ? C['remove']['outputSchema']\n                        : z.ZodObject<{ ok: z.ZodLiteral<true> }>\n                      : z.ZodObject<{ ok: z.ZodLiteral<true> }>;\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n      ]\n    : never\n  : never;\n\n/** Merge generated leaves + extras into the branch accumulator. */\ntype CrudResultAcc<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n  Extras extends readonly AnyLeaf[],\n> = [...Acc, ...CrudLeavesTuple<Base, I, PS, Name, C>, ...Extras];\n\n// -----------------------------------------------------------------------------\n// Module augmentation: add the typed `.crud(...)` to Branch<...>\n// -----------------------------------------------------------------------------\n\ndeclare module './../core/routesV3.builder' {\n  interface Branch<\n    Base extends string,\n    Acc extends readonly AnyLeaf[],\n    I extends NodeCfg,\n    PS extends ZodType | undefined,\n  > {\n    /**\n     * Generate opinionated CRUD endpoints for a collection at `/.../<name>`\n     * with an item at `/.../<name>/:<name>Id`.\n     *\n     * Creates (subject to `enable` + presence of create/update bodies):\n     * - GET    /<name>                (feed list)\n     * - POST   /<name>                (create)\n     * - GET    /<name>/:<name>Id      (read item)\n     * - PATCH  /<name>/:<name>Id      (update item)\n     * - DELETE /<name>/:<name>Id      (remove item)\n     *\n     * The `extras` callback receives live builders at both collection and item\n     * levels so you can add custom subroutes; their leaves are included in the\n     * returned Branch type.\n     */\n    crud<\n      Name extends string,\n      C extends CrudCfg<Name>,\n      Extras extends readonly AnyLeaf[] = readonly [],\n    >(\n      name: Name,\n      cfg: C,\n      extras?: (ctx: {\n        /** Builder at `/.../<name>` (collection scope). */\n        collection: _Branch<`${Base}/${Name}`, readonly [], I, PS>;\n        /** Builder at `/.../<name>/:<name>Id` (item scope). */\n        item: _Branch<\n          `${Base}/${Name}/:${`${Name}Id`}`,\n          readonly [],\n          I,\n          ReturnType<typeof mergeSchemas<PS, ParamSchema<`${Name}Id`, C['paramSchema']>>>\n        >;\n      }) => Extras,\n    ): _Branch<Base, CrudResultAcc<Base, Acc, I, PS, Name, C, Extras>, I, PS>;\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Runtime: install .crud on any Branch via decorator\n// -----------------------------------------------------------------------------\n\n/**\n * Decorate a Branch instance so `.crud(...)` is available at runtime.\n * Tip: wrap the root: `withCrud(resource('/v1'))`.\n * @param branch Branch returned by `resource(...)`.\n * @returns Same branch with `.crud(...)` installed.\n */\nexport function withCrud<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n>(branch: _Branch<Base, Acc, I, PS>): _Branch<Base, Acc, I, PS> {\n  const b = branch as any;\n  if (typeof b.crud === 'function') return branch;\n\n  b.crud = function <\n    Name extends string,\n    C extends CrudCfg<Name>,\n    Extras extends readonly AnyLeaf[] = readonly [],\n  >(this: any, name: Name, cfg: C, extras?: (ctx: { collection: any; item: any }) => Extras) {\n    // Build inside a sub-branch at `/.../<name>` and harvest its leaves.\n    return this.sub(name, (collection: any) => {\n      const idKey = `${name}Id`;\n\n      // Accept a value schema (preferred); but if a z.object({[name]Id: ...}) is provided, use it.\n      const s = cfg.paramSchema;\n      const isObj =\n        s &&\n        typeof (s as any)._def === 'object' &&\n        (s as any)._def.typeName === 'ZodObject' &&\n        typeof (s as any).shape === 'function';\n\n      const paramValueSchema =\n        isObj && (s as any).shape()[idKey] ? ((s as any).shape()[idKey] as ZodType) : (s as ZodType);\n\n      const itemOut = cfg.itemOutputSchema;\n      const listOut =\n        cfg.list?.outputSchema ??\n        z.object({\n          items: z.array(itemOut),\n          nextCursor: z.string().optional(),\n        });\n\n      const want = {\n        list: cfg.enable?.list !== false,\n        create: cfg.enable?.create !== false && !!cfg.create?.bodySchema,\n        read: cfg.enable?.read !== false,\n        update: cfg.enable?.update !== false && !!cfg.update?.bodySchema,\n        remove: cfg.enable?.remove !== false,\n      } as const;\n\n      // Collection routes\n      if (want.list) {\n        collection.get({\n          feed: true,\n          querySchema: cfg.list?.querySchema ?? CrudDefaultPagination,\n          outputSchema: listOut,\n          description: cfg.list?.description ?? 'List',\n        });\n      }\n\n      if (want.create) {\n        collection.post({\n          bodySchema: cfg.create!.bodySchema,\n          outputSchema: cfg.create?.outputSchema ?? itemOut,\n          description: cfg.create?.description ?? 'Create',\n        });\n      }\n\n      // Item routes via :<name>Id\n      collection.routeParameter(idKey as any, paramValueSchema as any, (item: any) => {\n        if (want.read) {\n          item.get({\n            outputSchema: cfg.read?.outputSchema ?? itemOut,\n            description: cfg.read?.description ?? 'Read',\n          });\n        }\n        if (want.update) {\n          item.patch({\n            bodySchema: cfg.update!.bodySchema,\n            outputSchema: cfg.update?.outputSchema ?? itemOut,\n            description: cfg.update?.description ?? 'Update',\n          });\n        }\n        if (want.remove) {\n          item.delete({\n            outputSchema: cfg.remove?.outputSchema ?? z.object({ ok: z.literal(true) }),\n            description: cfg.remove?.description ?? 'Delete',\n          });\n        }\n\n        // Give extras fully-capable builders (decorate so extras can call .crud again)\n        if (extras) extras({ collection: withCrud(collection), item: withCrud(item) });\n\n        return item.done();\n      });\n\n      return collection.done();\n    });\n  };\n\n  return branch;\n}\n\n// -----------------------------------------------------------------------------\n// Optional convenience: re-export a resource() that already has .crud installed\n// -----------------------------------------------------------------------------\n\n/**\n * Drop-in replacement for `resource(...)` that returns a Branch with `.crud()` installed.\n * You can either use this or call `withCrud(resource(...))`.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Node configuration merged into every leaf.\n * @returns Branch builder that already includes the CRUD helper.\n */\nexport function resourceWithCrud<Base extends string, I extends NodeCfg = {}>(\n  base: Base,\n  inherited: I,\n) {\n  return withCrud(baseResource(base, inherited));\n}\n\n// Re-export the original in case you want both styles from this module\nexport { baseResource as resource };\n","// socket.index.ts (shared client/server)\n// TODO:\n// 1. Automatic feed handling:\n// * Expand onReceive to be like a middleware chain. This would allow for automatic feed handling middleware to be added that would handle:\n// - 1. updating maps/dictionaries based on feed messages\n// - 2. handling join/leave rooms\n// 2. General helpers: \n// - Easy combine of routes and sockets in the client: Room joining onReceive handlers, map helpers that build dictionaries of the data from feeds for easy access, lifecycle handling)\n// - Custom route structure definitions (feed + information routes, get/put/patch/delete based on few central schemas, )\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} ? Out : 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 = 'sys:connect' | 'sys:disconnect' | 'sys:reconnect' | 'sys:connect_error' | 'sys:ping' | 'sys:pong' | 'sys:room_join' | 'sys:room_leave';\nexport function defineSocketEvents<const C extends SocketConnectionConfig, const Schemas extends Record<string, {\n    message: z.ZodTypeAny;\n}>>(config: C, events: Schemas): {\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\n\n\nexport type Payload<T extends EventMap, K extends keyof T> = 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}"],"mappings":"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","names":["z","z","mergeSchemas"]}
+{"version":3,"sources":["../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/crud/routesV3.crud.ts","../src/sockets/socket.index.ts","../src/docs/docs.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  AnyLeaf,\n  Append,\n  HttpMethod,\n  Leaf,\n  Merge,\n  MergeArray,\n  MethodCfg,\n  NodeCfg,\n  Prettify,\n} from './routesV3.core';\n\nconst defaultFeedQuerySchema = z.object({\n  cursor: z.string().optional(),\n  limit: z.coerce.number().min(1).max(100).default(20),\n});\n\nconst paginationField = defaultFeedQuerySchema.optional().default(defaultFeedQuerySchema.parse({}));\ntype PaginationField = typeof paginationField;\n\ntype ZodTypeAny = z.ZodTypeAny;\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{ [K in Name]: S }>;\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>;\ntype ZodObjectAny = z.ZodObject<any>;\ntype AnyZodObject = z.ZodObject<any>;\ntype MergedParamsResult<PS, Name extends string, P extends ZodTypeAny> = PS extends ZodTypeAny\n  ? z.ZodIntersection<PS, ParamZod<Name, P>>\n  : ParamZod<Name, P>;\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('Feed queries must be a ZodObject; default pagination applied.');\n    return z.object({\n      pagination: paginationField,\n    });\n  }\n\n  const base = (schema as ZodObjectAny) ?? z.object({});\n  return base.extend({\n    pagination: paginationField,\n  });\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 ? (schema as any).shape : (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>(a: A, b: B): ZodTypeAny;\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A;\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B;\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined): 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 FeedQuerySchema<C extends MethodCfg> = z.ZodObject<any>;\n\ntype FeedOutputSchema<C extends MethodCfg> = 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 ? { feed: true } : { feed?: boolean };\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> = Q extends z.ZodObject<\n  infer Shape\n>\n  ? z.ZodObject<Shape & { pagination: PaginationField }>\n  : z.ZodObject<{ pagination: PaginationField }>;\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> = C['querySchema'] extends ZodTypeAny\n  ? { querySchema: C['querySchema'] }\n  : { querySchema?: undefined };\n\ntype FeedOutputField<C extends MethodCfg> = { outputSchema: FeedOutputSchema<C> };\n\ntype NonFeedOutputField<C extends MethodCfg> = 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> & NonFeedQueryField<C> & NonFeedOutputField<C> & 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, EffectiveCfg<C, PS>>>;\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\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<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeaf[]>(\n    name: Name,\n    cfg: J,\n    builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R,\n  ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;\n\n  sub<Name extends string, R extends readonly AnyLeaf[]>(\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<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\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<Base2 extends string, I2 extends NodeCfg, PS2 extends ZodTypeAny | undefined>(\n    base2: Base2,\n    inherited2: I2,\n    mergedParamsSchema?: PS2,\n  ) {\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 ?? currentParamsSchema) as PS2 | undefined;\n      const effectiveQuerySchema =\n        cfg.feed === true ? augmentFeedQuerySchema(cfg.querySchema) : cfg.querySchema;\n      const effectiveOutputSchema =\n        cfg.feed === true ? augmentFeedOutputSchema(cfg.outputSchema) : cfg.outputSchema;\n\n      const fullCfg = (\n        effectiveParamsSchema\n          ? {\n              ...inheritedCfg,\n              ...cfg,\n              paramsSchema: effectiveParamsSchema,\n              ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n              ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\n            }\n          : {\n              ...inheritedCfg,\n              ...cfg,\n              ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n              ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\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<Base2, Append<readonly [], typeof leaf>, I2, PS2>;\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 AnyLeaf[]),\n        maybeBuilder?: (r: any) => readonly AnyLeaf[],\n      ) {\n        let cfg: NodeCfg | undefined;\n        let builder: ((r: any) => readonly AnyLeaf[]) | 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<I2, NonNullable<J>>;\n\n        if (builder) {\n          // params schema PS2 flows through unchanged on plain sub\n          const child = makeBranch(childBase, childInherited, currentParamsSchema);\n          const leaves = builder(child) as readonly AnyLeaf[];\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<`${Base2}/${Name}`, readonly [], typeof childInherited, PS2>;\n        }\n      },\n\n      // the single param function: name + schema + builder\n      routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\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({ [name]: paramsSchema } as Record<Name, P>);\n        const childParams = (currentParamsSchema\n          ? mergeSchemas(currentParamsSchema, paramObj)\n          : paramObj) as MergedParamsResult<PS2, Name, P>;\n        const child = makeBranch(childBase, inheritedCfg as I2, childParams);\n        const leaves = builder(child) as readonly AnyLeaf[];\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, ZodTypeAny } 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\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg =  {\n  /** Zod schema describing the request body. */\n  bodySchema?: ZodTypeAny;\n  /** Zod schema describing the query string. */\n  querySchema?: ZodTypeAny;\n  /** Zod schema describing path params (overrides inferred params). */\n  paramsSchema?: ZodTypeAny;\n  /** Zod schema describing the response payload. */\n  outputSchema?: ZodTypeAny;\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  /** Optional human-readable description for docs/debugging. */\n  description?: string;\n};\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<M extends HttpMethod, P extends string, C extends MethodCfg> = {\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<A extends readonly unknown[], B extends readonly unknown[]> = [\n  ...A,\n  ...B,\n];\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 ? never : 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>(path: Path, params: ExtractParamsFromPath<Path>) {\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 [args.leaf.method, ...(p.split('/').filter(Boolean) as SplitPath<typeof p>), args.query ?? {}] as const;\n}\n\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeaf> = L['cfg']['paramsSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['paramsSchema']>\n  : ExtractParamsFromPath<L['path']>;\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf> = L['cfg']['querySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['querySchema']>\n  : never;\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf> = L['cfg']['bodySchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['bodySchema']>\n  : never;\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf> = L['cfg']['outputSchema'] extends ZodTypeAny\n  ? z.infer<L['cfg']['outputSchema']>\n  : unknown;\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 { AnyLeaf, 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 AnyLeaf> = L extends AnyLeaf\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 AnyLeaf[]> = KeyOf<Leaves[number]>;\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}` ? Lowercase<M> : never;\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}` ? P : never;\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<Leaves extends readonly AnyLeaf[], K extends string> = 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 AnyLeaf[]>(leaves: L) {\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 AnyLeaf[],\n  F extends string,\n  Acc extends readonly AnyLeaf[] = [],\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\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<T extends readonly AnyLeaf[], F extends string> = FilterRoute<T, F>;\ntype ByKey<\n  T extends readonly AnyLeaf[],\n  Acc extends Record<string, AnyLeaf> = {},\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n  ? ByKey<Rest, Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }>\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<T extends readonly AnyLeaf[], F extends string> = {\n  byKey: ByKey<Routes<T, F>>;\n  all: Routes<T, F>;\n};\n","// routesV3.crud.ts\n// -----------------------------------------------------------------------------\n// Add a first-class .crud() helper to the routesV3 DSL, without touching the\n// core builder. This file:\n//   1) Declares types + module augmentation to extend Branch<...> with .crud\n//   2) Provides a runtime decorator `withCrud(...)` that installs the method\n//   3) Exports a convenience `resourceWithCrud(...)` wrapper (optional)\n// -----------------------------------------------------------------------------\n\nimport { z, ZodType } from 'zod';\nimport {\n  resource as baseResource,\n  type Branch as _Branch, // import type so we can augment it\n} from '../core/routesV3.builder';\nimport { type AnyLeaf, type Leaf, type NodeCfg } from '../core/routesV3.core';\n\n// -----------------------------------------------------------------------------\n// Small utilities (runtime + types)\n// -----------------------------------------------------------------------------\n/** Default cursor pagination used by list (GET collection). */\nexport const CrudDefaultPagination = z.object({\n  limit: z.coerce.number().min(1).max(100).default(20),\n  cursor: z.string().optional(),\n});\nconst CrudPaginationField = CrudDefaultPagination.optional().default(CrudDefaultPagination.parse({}));\ntype CrudPaginationField = typeof CrudPaginationField;\ntype AnyCrudZodObject = z.ZodObject<any>;\ntype AddCrudPagination<Q extends AnyCrudZodObject | undefined> = Q extends z.ZodObject<infer Shape>\n  ? z.ZodObject<Shape & { pagination: CrudPaginationField }>\n  : z.ZodObject<{ pagination: CrudPaginationField }>;\n\n/**\n * Merge two Zod schemas at runtime; matches the typing pattern used in builder.\n * @param a Existing params schema inherited from parent branches.\n * @param b Schema introduced at the current branch.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nexport function mergeSchemas<A extends ZodType | undefined, B extends ZodType | undefined>(\n  a: A,\n  b: B,\n): A extends ZodType ? (B extends ZodType ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n  if (a && b) return z.intersection(a as any, b as any) as any;\n  return (a ?? b) as any;\n}\n\n/** Build { [Name]: S } Zod object at the type-level. */\nexport type ParamSchema<Name extends string, S extends ZodType> = z.ZodObject<{\n  [K in Name]: S;\n}>;\n\n/** Inject active params schema into a leaf cfg (to match your Leaf typing). */\ntype WithParams<I, P> = P extends ZodType ? Omit<I, 'paramsSchema'> & { paramsSchema: P } : I;\n\n/** Resolve boolean flag: default D unless explicitly false. */\ntype Flag<E, D extends boolean> = E extends false ? false : D;\n\n// -----------------------------------------------------------------------------\n// CRUD config (few knobs, with DX comments)\n// -----------------------------------------------------------------------------\n\n/** Toggle individual CRUD methods; defaults enable all (create/update require body). */\nexport type CrudEnable = {\n  /** GET /collection (feed). Defaults to true. */ list?: boolean;\n  /** POST /collection. Defaults to true if `create` provided. */ create?: boolean;\n  /** GET /collection/:id. Defaults to true. */ read?: boolean;\n  /** PATCH /collection/:id. Defaults to true if `update` provided. */ update?: boolean;\n  /** DELETE /collection/:id. Defaults to true. */ remove?: boolean;\n};\n\n/** Collection GET config. */\nexport type CrudListCfg = {\n  /** Query schema (defaults to cursor pagination). */\n  querySchema?: ZodType;\n  /** Output schema (defaults to { items: Item[], nextCursor? }). */\n  outputSchema?: ZodType;\n  /** Optional description string. */\n  description?: string;\n};\n\n/** Collection POST config. */\nexport type CrudCreateCfg = {\n  /** Body schema for creating an item. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item GET config. */\nexport type CrudReadCfg = {\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item PATCH config. */\nexport type CrudUpdateCfg = {\n  /** Body schema for partial updates. */\n  bodySchema: ZodType;\n  /** Output schema (defaults to itemOutputSchema). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/** Item DELETE config. */\nexport type CrudRemoveCfg = {\n  /** Output schema (defaults to { ok: true }). */\n  outputSchema?: ZodType;\n  /** Optional description. */\n  description?: string;\n};\n\n/**\n * CRUD config for `.crud(\"resource\", cfg, extras?)`.\n *\n * It synthesizes `:[resourceName]Id` as the param key and uses `paramSchema` for the value.\n * Prefer passing a **value schema** (e.g. `z.string().uuid()`).\n * As a convenience, a ZodObject of shape `{ [resourceName]Id: schema }` is accepted at runtime too.\n */\nexport type CrudCfg<Name extends string = string> = {\n  /**\n   * Zod schema for the ID *value* (e.g. `z.string().uuid()`).\n   * The parameter key is always `:${name}Id`.\n   * (If you pass `z.object({ [name]Id: ... })`, it's accepted at runtime.)\n   */\n  paramSchema: ZodType;\n\n  /**\n   * The single-item output shape used by read/create/update by default.\n   * List defaults to `{ items: z.array(itemOutputSchema), nextCursor? }`.\n   */\n  itemOutputSchema: ZodType;\n\n  /** Per-method toggles (all enabled by default; create/update require bodies). */\n  enable?: CrudEnable;\n\n  /** GET /collection configuration. */ list?: CrudListCfg;\n  /** POST /collection configuration (enables create). */ create?: CrudCreateCfg;\n  /** GET /collection/:id configuration. */ read?: CrudReadCfg;\n  /** PATCH /collection/:id configuration (enables update). */ update?: CrudUpdateCfg;\n  /** DELETE /collection/:id configuration. */ remove?: CrudRemoveCfg;\n};\n\n// -----------------------------------------------------------------------------\n// Type plumbing to expose generated leaves (so finalize().byKey sees them)\n// -----------------------------------------------------------------------------\n\ntype CrudLeavesTuple<\n  Base extends string,\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n> = `${Name}Id` extends infer IdName extends string\n  ? ParamSchema<IdName, C['paramSchema']> extends infer IdParamZ extends ZodType\n    ? [\n        // GET /collection\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['list'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}`,\n                WithParams<\n                  Omit<I, never> & {\n                    feed: true;\n                    querySchema: C['list'] extends CrudListCfg\n                      ? AddCrudPagination<\n                          C['list']['querySchema'] extends AnyCrudZodObject\n                            ? C['list']['querySchema']\n                            : undefined\n                        >\n                      : AddCrudPagination<undefined>;\n                    outputSchema: C['list'] extends CrudListCfg\n                      ? C['list']['outputSchema'] extends ZodType\n                        ? C['list']['outputSchema']\n                        : z.ZodObject<{\n                            items: z.ZodArray<C['itemOutputSchema']>;\n                            nextCursor: z.ZodOptional<z.ZodString>;\n                          }>\n                      : z.ZodObject<{\n                          items: z.ZodArray<C['itemOutputSchema']>;\n                          nextCursor: z.ZodOptional<z.ZodString>;\n                        }>;\n                    description?: string;\n                  },\n                  PS\n                >\n              >,\n            ]\n          : []),\n\n        // POST /collection\n        ...((C['create'] extends CrudCreateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['create'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'post',\n                  `${Base}/${Name}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['bodySchema']\n                        : never;\n                      outputSchema: C['create'] extends CrudCreateCfg\n                        ? C['create']['outputSchema'] extends ZodType\n                          ? C['create']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    PS\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // GET /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['read'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'get',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['read'] extends CrudReadCfg\n                      ? C['read']['outputSchema'] extends ZodType\n                        ? C['read']['outputSchema']\n                        : C['itemOutputSchema']\n                      : C['itemOutputSchema'];\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n\n        // PATCH /collection/:id\n        ...((C['update'] extends CrudUpdateCfg ? true : false) extends true\n          ? Flag<\n              C['enable'] extends CrudEnable ? C['enable']['update'] : undefined,\n              true\n            > extends true\n            ? [\n                Leaf<\n                  'patch',\n                  `${Base}/${Name}/:${IdName}`,\n                  WithParams<\n                    Omit<I, never> & {\n                      bodySchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['bodySchema']\n                        : never;\n                      outputSchema: C['update'] extends CrudUpdateCfg\n                        ? C['update']['outputSchema'] extends ZodType\n                          ? C['update']['outputSchema']\n                          : C['itemOutputSchema']\n                        : never;\n                      description?: string;\n                    },\n                    ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                  >\n                >,\n              ]\n            : []\n          : []),\n\n        // DELETE /collection/:id\n        ...(Flag<\n          C['enable'] extends CrudEnable ? C['enable']['remove'] : undefined,\n          true\n        > extends true\n          ? [\n              Leaf<\n                'delete',\n                `${Base}/${Name}/:${IdName}`,\n                WithParams<\n                  Omit<I, never> & {\n                    outputSchema: C['remove'] extends CrudRemoveCfg\n                      ? C['remove']['outputSchema'] extends ZodType\n                        ? C['remove']['outputSchema']\n                        : z.ZodObject<{ ok: z.ZodLiteral<true> }>\n                      : z.ZodObject<{ ok: z.ZodLiteral<true> }>;\n                    description?: string;\n                  },\n                  ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n                >\n              >,\n            ]\n          : []),\n      ]\n    : never\n  : never;\n\n/** Merge generated leaves + extras into the branch accumulator. */\ntype CrudResultAcc<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n  Name extends string,\n  C extends CrudCfg<Name>,\n  Extras extends readonly AnyLeaf[],\n> = [...Acc, ...CrudLeavesTuple<Base, I, PS, Name, C>, ...Extras];\n\n// -----------------------------------------------------------------------------\n// Module augmentation: add the typed `.crud(...)` to Branch<...>\n// -----------------------------------------------------------------------------\n\ndeclare module './../core/routesV3.builder' {\n  interface Branch<\n    Base extends string,\n    Acc extends readonly AnyLeaf[],\n    I extends NodeCfg,\n    PS extends ZodType | undefined,\n  > {\n    /**\n     * Generate opinionated CRUD endpoints for a collection at `/.../<name>`\n     * with an item at `/.../<name>/:<name>Id`.\n     *\n     * Creates (subject to `enable` + presence of create/update bodies):\n     * - GET    /<name>                (feed list)\n     * - POST   /<name>                (create)\n     * - GET    /<name>/:<name>Id      (read item)\n     * - PATCH  /<name>/:<name>Id      (update item)\n     * - DELETE /<name>/:<name>Id      (remove item)\n     *\n     * The `extras` callback receives live builders at both collection and item\n     * levels so you can add custom subroutes; their leaves are included in the\n     * returned Branch type.\n     */\n    crud<\n      Name extends string,\n      C extends CrudCfg<Name>,\n      Extras extends readonly AnyLeaf[] = readonly [],\n    >(\n      name: Name,\n      cfg: C,\n      extras?: (ctx: {\n        /** Builder at `/.../<name>` (collection scope). */\n        collection: _Branch<`${Base}/${Name}`, readonly [], I, PS>;\n        /** Builder at `/.../<name>/:<name>Id` (item scope). */\n        item: _Branch<\n          `${Base}/${Name}/:${`${Name}Id`}`,\n          readonly [],\n          I,\n          ReturnType<typeof mergeSchemas<PS, ParamSchema<`${Name}Id`, C['paramSchema']>>>\n        >;\n      }) => Extras,\n    ): _Branch<Base, CrudResultAcc<Base, Acc, I, PS, Name, C, Extras>, I, PS>;\n  }\n}\n\n// -----------------------------------------------------------------------------\n// Runtime: install .crud on any Branch via decorator\n// -----------------------------------------------------------------------------\n\n/**\n * Decorate a Branch instance so `.crud(...)` is available at runtime.\n * Tip: wrap the root: `withCrud(resource('/v1'))`.\n * @param branch Branch returned by `resource(...)`.\n * @returns Same branch with `.crud(...)` installed.\n */\nexport function withCrud<\n  Base extends string,\n  Acc extends readonly AnyLeaf[],\n  I extends NodeCfg,\n  PS extends ZodType | undefined,\n>(branch: _Branch<Base, Acc, I, PS>): _Branch<Base, Acc, I, PS> {\n  const b = branch as any;\n  if (typeof b.crud === 'function') return branch;\n\n  b.crud = function <\n    Name extends string,\n    C extends CrudCfg<Name>,\n    Extras extends readonly AnyLeaf[] = readonly [],\n  >(this: any, name: Name, cfg: C, extras?: (ctx: { collection: any; item: any }) => Extras) {\n    // Build inside a sub-branch at `/.../<name>` and harvest its leaves.\n    return this.sub(name, (collection: any) => {\n      const idKey = `${name}Id`;\n\n      // Accept a value schema (preferred); but if a z.object({[name]Id: ...}) is provided, use it.\n      const s = cfg.paramSchema;\n      const isObj =\n        s &&\n        typeof (s as any)._def === 'object' &&\n        (s as any)._def.typeName === 'ZodObject' &&\n        typeof (s as any).shape === 'function';\n\n      const paramValueSchema =\n        isObj && (s as any).shape()[idKey] ? ((s as any).shape()[idKey] as ZodType) : (s as ZodType);\n\n      const itemOut = cfg.itemOutputSchema;\n      const listOut =\n        cfg.list?.outputSchema ??\n        z.object({\n          items: z.array(itemOut),\n          nextCursor: z.string().optional(),\n        });\n\n      const want = {\n        list: cfg.enable?.list !== false,\n        create: cfg.enable?.create !== false && !!cfg.create?.bodySchema,\n        read: cfg.enable?.read !== false,\n        update: cfg.enable?.update !== false && !!cfg.update?.bodySchema,\n        remove: cfg.enable?.remove !== false,\n      } as const;\n\n      // Collection routes\n      if (want.list) {\n        collection.get({\n          feed: true,\n          querySchema: cfg.list?.querySchema ?? CrudDefaultPagination,\n          outputSchema: listOut,\n          description: cfg.list?.description ?? 'List',\n        });\n      }\n\n      if (want.create) {\n        collection.post({\n          bodySchema: cfg.create!.bodySchema,\n          outputSchema: cfg.create?.outputSchema ?? itemOut,\n          description: cfg.create?.description ?? 'Create',\n        });\n      }\n\n      // Item routes via :<name>Id\n      collection.routeParameter(idKey as any, paramValueSchema as any, (item: any) => {\n        if (want.read) {\n          item.get({\n            outputSchema: cfg.read?.outputSchema ?? itemOut,\n            description: cfg.read?.description ?? 'Read',\n          });\n        }\n        if (want.update) {\n          item.patch({\n            bodySchema: cfg.update!.bodySchema,\n            outputSchema: cfg.update?.outputSchema ?? itemOut,\n            description: cfg.update?.description ?? 'Update',\n          });\n        }\n        if (want.remove) {\n          item.delete({\n            outputSchema: cfg.remove?.outputSchema ?? z.object({ ok: z.literal(true) }),\n            description: cfg.remove?.description ?? 'Delete',\n          });\n        }\n\n        // Give extras fully-capable builders (decorate so extras can call .crud again)\n        if (extras) extras({ collection: withCrud(collection), item: withCrud(item) });\n\n        return item.done();\n      });\n\n      return collection.done();\n    });\n  };\n\n  return branch;\n}\n\n// -----------------------------------------------------------------------------\n// Optional convenience: re-export a resource() that already has .crud installed\n// -----------------------------------------------------------------------------\n\n/**\n * Drop-in replacement for `resource(...)` that returns a Branch with `.crud()` installed.\n * You can either use this or call `withCrud(resource(...))`.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Node configuration merged into every leaf.\n * @returns Branch builder that already includes the CRUD helper.\n */\nexport function resourceWithCrud<Base extends string, I extends NodeCfg = {}>(\n  base: Base,\n  inherited: I,\n) {\n  return withCrud(baseResource(base, inherited));\n}\n\n// Re-export the original in case you want both styles from this module\nexport { baseResource as resource };\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} ? Out : 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 = 'sys:connect' | 'sys:disconnect' | 'sys:reconnect' | 'sys:connect_error' | 'sys:ping' | 'sys:pong' | 'sys:room_join' | 'sys:room_leave';\nexport function defineSocketEvents<const C extends SocketConnectionConfig, const Schemas extends Record<string, {\n    message: z.ZodTypeAny;\n}>>(config: C, events: Schemas): {\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\n\n\nexport type Payload<T extends EventMap, K extends keyof T> = 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}","// docs-generator.ts\nimport { z, ZodType, ZodObject, ZodArray } from \"zod\";\nimport { AnyLeaf, FileField } from \"../core/routesV3.core\";\n\n\n// ------------------------------------------------------------\n// Schema summarizer (lightweight introspection for Zod v4)\n// ------------------------------------------------------------\nfunction summarizeSchema(schema?: ZodType): unknown {\n  if (!schema) return undefined;\n\n  // ZodObject\n  if (schema instanceof ZodObject) {\n    const shape = schema.shape;\n    return {\n      type: \"object\",\n      fields: Object.fromEntries(\n        Object.entries(shape).map(([key, value]) => {\n          const def: any = (value as any)._def;\n          return [\n            key,\n            {\n              typeName: def?.typeName,\n              description: def?.description\n            }\n          ];\n        })\n      )\n    };\n  }\n\n  // ZodArray\n  if (schema instanceof ZodArray) {\n    return {\n      type: \"array\",\n      // @ts-ignore\n      element: summarizeSchema(schema.unwrap())\n    };\n  }\n\n  // fallback for primitives and complex types\n  const def: any = (schema as any)._def;\n  return { typeName: def?.typeName ?? \"unknown\" };\n}\n\n// ------------------------------------------------------------\n// Build a structured doc model from AnyLeaf[]\n// ------------------------------------------------------------\ntype RouteDoc = {\n  method: string;\n  path: string;\n  description?: string;\n  feed?: boolean;\n  body?: unknown;\n  query?: unknown;\n  params?: unknown;\n  output?: unknown;\n  files?: FileField[];\n};\n\nfunction leavesToDocs(leaves: AnyLeaf[]): RouteDoc[] {\n  return leaves.map((leaf) => {\n    const { method, path, cfg } = leaf;\n\n    return {\n      method,\n      path,\n      description: cfg.description,\n      feed: cfg.feed,\n      body: summarizeSchema(cfg.bodySchema),\n      query: summarizeSchema(cfg.querySchema),\n      params: summarizeSchema(cfg.paramsSchema),\n      output: summarizeSchema(cfg.outputSchema),\n      files: cfg.bodyFiles\n    };\n  });\n}\n\n// ------------------------------------------------------------\n// Markdown renderer for the docs\n// ------------------------------------------------------------\nexport function renderLeafDocsMarkdown(leaves: AnyLeaf[]): string {\n  const docs = leavesToDocs(leaves);\n\n  docs.sort((a, b) => {\n    const p = a.path.localeCompare(b.path);\n    return p !== 0 ? p : a.method.localeCompare(b.method);\n  });\n\n  return docs\n    .map((d) => {\n      const lines: string[] = [];\n\n      lines.push(`### \\`${d.method.toUpperCase()} ${d.path}\\``);\n\n      if (d.description) {\n        lines.push(\"\", d.description);\n      }\n\n      if (d.feed) {\n        lines.push(\"\", \"_Feed endpoint_\");\n      }\n\n      function pushJson(title: string, value: unknown | undefined) {\n        if (!value) return;\n        lines.push(\n          \"\",\n          `**${title}**`,\n          \"```json\",\n          JSON.stringify(value, null, 2),\n          \"```\"\n        );\n      }\n\n      pushJson(\"Query\", d.query);\n      pushJson(\"Params\", d.params);\n      pushJson(\"Body\", d.body);\n      pushJson(\"Output\", d.output);\n\n      if (d.files && d.files.length > 0) {\n        lines.push(\"\", \"**Multipart files**\");\n        d.files.forEach((f) => {\n          lines.push(`- \\`${f.name}\\` (maxCount: ${f.maxCount})`);\n        });\n      }\n\n      return lines.join(\"\\n\");\n    })\n    .join(\"\\n\\n\");\n}"],"mappings":"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","names":["z","z","mergeSchemas","def"]}

package/package.json

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