@mionjs/router 0.13.0 → 0.14.0

package/.dist/esm/src/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","names":[],"sources":["../../../src/router.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport type {HostRequestHandler, Route, RouterOptions, Routes, RouterEntry} from './types/general.ts';\nimport type {\n  RemoteMethod,\n  MethodsExecutionChain,\n  RawMethod,\n  HeadersMethod,\n  MiddlewareMethod,\n  RouteMethod,\n} from './types/remoteMethods.ts';\nimport type {PublicApi, PrivateDef, MiddlewaresCollection} from './types/publicMethods.ts';\nimport type {HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef} from './types/definitions.ts';\nimport type {ResponseDefaults} from './types/context.ts';\nimport {DEFAULT_ROUTE_OPTIONS, JSON_CONTENT_TYPE, MAX_ROUTE_NESTING} from './constants.ts';\nimport {\n  isRawMiddlewareDef,\n  isHeadersMiddlewareDef,\n  isExecutable,\n  isMiddlewareDef,\n  isRoute,\n  isRoutes,\n  isAnyMiddlewareDef,\n  isPublicExecutable,\n} from './types/guards.ts';\nimport {\n  BUILD_VERSION_HEADER,\n  HandlerType,\n  isTestEnv,\n  resetRoutesCache,\n  getOrCreateGlobal,\n  resolveParser,\n  DEFAULT_MAX_BODY_SIZE,\n} from '@mionjs/core';\nimport {getRawMethodReflection, getHandlerReflection, assertCompiledParser} from './lib/reflection.ts';\nimport {resolveChainMaxBodySize} from './lib/bodyLimit.ts';\nimport {callerForType} from './dispatch.ts';\nimport {serializerMiddlewares} from './routes/serializer.routes.ts';\nimport {\n  getRouterItemId,\n  getRoutePath,\n  getENV,\n  MION_ROUTES,\n  MION_BATCH_KEY,\n  routesCache,\n  isUnsafePropertyName,\n} from '@mionjs/core';\nimport {setErrorOptions} from '@mionjs/core';\nimport {getPublicApi, resetRemoteMethodsMetadata} from './lib/remoteMethods.ts';\nimport {mionErrorsRoutes, notFoundMiddleware, batchNotFoundMiddleware} from './routes/errors.routes.ts';\nimport {capBatchBodySizes, clearBatches, getMaxBatchBodySize, refreshBatchChainBodyLimits} from './batches.ts';\nimport {\n  headersMiddleware,\n  isOnDemandMiddleware,\n  getOnEveryCall,\n  middleware,\n  mionInternalRouteIds,\n  mutation,\n  query,\n  rawMiddleware,\n  route,\n} from './lib/handlers.ts';\nimport type {CallContext} from './types/context.ts';\nimport type {\n  HeadersMiddlewareHelper,\n  MiddlewareHelper,\n  MionRouter,\n  RawMiddlewareHelper,\n  RouteHelper,\n  RouterOptionsInput,\n  RouterOptionsArg,\n} from './types/mionRouter.ts';\n\ntype RouterKeyEntryList = [string, RouterEntry][];\ntype RoutesWithId = {\n  pathPointer: string[];\n  routes: Routes;\n};\n\n// ############# PRIVATE STATE #############\n\nconst flatRouter = getOrCreateGlobal('mion.router.flatRouter', () => new Map<string, MethodsExecutionChain>()); // Main Router\n/** mion's two not-found chains (an unknown path, an unknown batch id) are NOT routes and not in the\n *  router above: each is the global middleware behind a first member that throws, and is rebuilt on\n *  every registration because that middleware is. */\nconst notFoundChains = getOrCreateGlobal('mion.router.notFoundChains', () => new Map<string, MethodsExecutionChain>());\nconst middlewaresById = getOrCreateGlobal(\n  'mion.router.middlewaresById',\n  () => new Map<string, MiddlewareMethod | HeadersMethod | RawMethod>()\n);\nconst routesById = getOrCreateGlobal('mion.router.routesById', () => new Map<string, RouteMethod>());\nconst rawMiddlewaresById = getOrCreateGlobal('mion.router.rawMiddlewaresById', () => new Map<string, RawMethod>());\nconst middlewareNames = getOrCreateGlobal('mion.router.middlewareNames', () => new Set<string>());\nconst routeNames = getOrCreateGlobal('mion.router.routeNames', () => new Set<string>());\nlet complexity = 0;\nlet routerOptions: RouterOptions = {...DEFAULT_ROUTE_OPTIONS};\nlet isRouterInitialized = false;\nlet isRouterCreated = false;\nlet allExecutablesIds: string[] | undefined;\nlet platformConfig: Record<string, unknown> | undefined;\n/** Merged by initRouter, read per request. */\nlet responseDefaults: ResponseDefaults = mergeResponseDefaults({});\n/** Sent by mionFetchMetadata; unset with `apiVersionCheck` off, a pinned header or no build version. */\nlet buildVersion: string | undefined;\n/** The adapter's `maxBodySize` under its `maxBodySizeCap`, settled by setPlatformConfig (the default with no adapter). */\nlet platformMaxBodySize = DEFAULT_MAX_BODY_SIZE;\n\n/** Run before and after every middleware or route set through `mion.initRoutes` */\nconst defaultStartMiddlewares = {\n  mionDeserializeRequest: serializerMiddlewares.mionDeserializeRequest,\n};\nconst defaultEndMiddlewares = {\n  mionSerializeResponse: serializerMiddlewares.mionSerializeResponse,\n};\nlet startMiddlewaresDef: MiddlewaresCollection = {...defaultStartMiddlewares};\nlet endMiddlewaresDef: MiddlewaresCollection = {...defaultEndMiddlewares};\nexport let startMiddlewares: RemoteMethod[] = [];\nexport let endMiddlewares: RemoteMethod[] = [];\n\n// ############# PUBLIC METHODS #############\n\nexport const getRouteExecutionChain = (path: string) => flatRouter.get(path);\n/** The chain that answers an unknown path or an unknown batch id, by its `MION_ROUTES` id. */\nexport const getNotFoundExecutionChain = (id: string) => notFoundChains.get(id);\nexport const getRouteEntries = () => flatRouter.entries();\nexport const geRoutesSize = () => flatRouter.size;\nexport const getRouteExecutable = (id: string) => routesById.get(id);\nexport const getMiddlewareExecutable = (id: string) => middlewaresById.get(id);\nexport const getMiddlewaresSize = () => middlewaresById.size;\nexport const getComplexity = () => complexity;\nexport const getRouterOptions = <Opts extends RouterOptions>(): Readonly<Opts> => routerOptions as Opts;\n/** The version mionFetchMetadata sends in `x-build-version`. */\nexport const getBuildVersion = (): string | undefined => buildVersion;\n/** The headers every response starts with: every adapter reads it per request. */\nexport const getResponseDefaults = (): ResponseDefaults => responseDefaults;\n\nexport const getAnyExecutable = (id: string) => routesById.get(id) || middlewaresById.get(id) || rawMiddlewaresById.get(id);\n\n/** Called automatically by platform adapters: the adapter's `maxBodySize` and `maxBodySizeCap` are\n *  settled here, once, so no request reads the config. */\nexport function setPlatformConfig(config: Record<string, unknown>): void {\n  platformConfig = config;\n  const published = config.maxBodySize;\n  platformMaxBodySize = Math.min(\n    typeof published === 'number' ? published : DEFAULT_MAX_BODY_SIZE,\n    readMaxBodySizeCap(config) ?? Infinity\n  );\n  if (isRouterInitialized) applyMaxBodySizeCap();\n  // Unconditional, and NOT inside applyMaxBodySizeCap: that returns early when the adapter published no\n  // cap, while platformMaxBodySize still changed under every chain that declared nothing of its own.\n  refreshChainBodyLimits();\n}\n\nexport const getPlatformConfig = (): Readonly<Record<string, unknown>> | undefined => platformConfig;\n\n// Survives resetRouter on purpose: a dev host reloads the entry after a reset and still owns the socket.\nconst devHost = getOrCreateGlobal('mion.router.devHost', () => ({\n  ownsSocket: false,\n  handler: undefined as HostRequestHandler | undefined,\n}));\n\n/** Set by a dev host that owns the socket (the mion vite plugin) BEFORE it loads the server entry, so whatever\n *  platform adapter the entry starts registers its routes and hands over its handler instead of listening. */\nexport function setHostOwnsSocket(ownsSocket: boolean): void {\n  devHost.ownsSocket = ownsSocket;\n  if (!ownsSocket) devHost.handler = undefined;\n}\n\nexport const hostOwnsSocket = (): boolean => devHost.ownsSocket;\n\n/** Every platform adapter calls it on start; true means a dev host owns the socket and the adapter must not listen. */\nexport function handOverToHost(handler: HostRequestHandler): boolean {\n  if (devHost.ownsSocket) devHost.handler = handler;\n  return devHost.ownsSocket;\n}\n\nexport const getHostRequestHandler = (): HostRequestHandler | undefined => devHost.handler;\n\nexport const resetRouter = () => {\n  flatRouter.clear();\n  notFoundChains.clear();\n  middlewaresById.clear();\n  routesById.clear();\n  rawMiddlewaresById.clear();\n  middlewareNames.clear();\n  routeNames.clear();\n  complexity = 0;\n  routerOptions = {...DEFAULT_ROUTE_OPTIONS};\n  startMiddlewaresDef = {...defaultStartMiddlewares};\n  endMiddlewaresDef = {...defaultEndMiddlewares};\n  startMiddlewares = [];\n  endMiddlewares = [];\n  isRouterInitialized = false;\n  isRouterCreated = false;\n  allExecutablesIds = undefined;\n  platformConfig = undefined;\n  responseDefaults = mergeResponseDefaults({});\n  buildVersion = undefined;\n  platformMaxBodySize = DEFAULT_MAX_BODY_SIZE;\n  resetRemoteMethodsMetadata();\n  resetRoutesCache();\n  clearBatches();\n  // resetJitFnCaches() is deliberately NOT called: the JIT caches are global, and the\n  // serializableClassRegistry it clears is needed to (de)serialize classes like RpcError.\n  // Only a test of AOT cache loading calls it.\n};\n\n/** The ONE way to initialize the router and to declare routes and middlewares: the options are written once\n *  and carried BY TYPE into every helper the factory returns, so a handler's `ctx.shared` is typed from\n *  `contextDataFactory` and router-wide defaults can be read at build time. The helpers are plain closures\n *  (no `this`), so destructuring them is fine. Create the router once per app: a second call throws until\n *  `resetRouter()` (tests) clears it. */\nexport function createMionRouter<const O extends RouterOptionsInput = RouterOptionsInput>(\n  opts?: RouterOptionsArg<O>\n): MionRouter<O> {\n  if (isRouterCreated)\n    throw new Error(\n      'createMionRouter has already been called: create the router once per app (resetRouter() clears it in tests)'\n    );\n  isRouterCreated = true;\n  const options = Object.freeze({...opts}) as Readonly<O>;\n  return {\n    options,\n    route: route as RouteHelper<O>,\n    query: query as RouteHelper<O, false>,\n    mutation: mutation as RouteHelper<O, true>,\n    middleware: middleware as MiddlewareHelper<O>,\n    headersMiddleware: headersMiddleware as HeadersMiddlewareHelper<O>,\n    rawMiddleware: rawMiddleware as RawMiddlewareHelper<O>,\n    // Typed by MionRouter, the one place its signature is written.\n    initRoutes(routes, buildVersion) {\n      initRouter(options, buildVersion);\n      const api = registerRoutes(routes);\n      if (platformConfig) applyMaxBodySizeCap();\n      refreshChainBodyLimits();\n      return api;\n    },\n  };\n}\n\n/** Once per app; `resetRouter()` clears it. */\nfunction initRouter(opts: RouterOptionsInput, version?: string): void {\n  if (isRouterInitialized) throw new Error('Router has already been initialized');\n  routerOptions = {...routerOptions, ...opts};\n  // a pinned version already rides every response, so the middleware adds none\n  responseDefaults = mergeResponseDefaults(routerOptions.responseHeaders);\n  const isPinned = responseDefaults[BUILD_VERSION_HEADER] !== undefined;\n  buildVersion = (routerOptions.apiVersionCheck && !isPinned && version) || undefined;\n  validateSharedDataFactory(routerOptions);\n  Object.freeze(routerOptions);\n  setErrorOptions(routerOptions);\n  isRouterInitialized = true;\n  registerRoutes({...mionErrorsRoutes});\n  if (!isTestEnv()) console.log('mion router initialized', {routerOptions});\n}\n\nfunction registerRoutes<R extends Routes>(routes: R): PublicApi<R> {\n  if (!isRouterInitialized) throw new Error('the router must be initialized first');\n  startMiddlewares = getExecutablesFromMiddlewaresCollection(startMiddlewaresDef);\n  endMiddlewares = getExecutablesFromMiddlewaresCollection(endMiddlewaresDef);\n  recursiveFlatRoutes(routes, [], [], [], 0);\n  buildNotFoundChains();\n  allExecutablesIds = undefined; // the memoized id list must see the routes registered by this call\n  if (shouldFullGenerateSpec()) {\n    return getPublicApi(routes);\n  }\n  return {} as PublicApi<R>;\n}\n\n/** Adds middlewares at the start of the ExecutionChain, before the existing start middlewares by default */\nexport function addStartMiddlewares(middlewaresDef: MiddlewaresCollection, appendBeforeExisting = true) {\n  if (isRouterInitialized) throw new Error('Can not add start middlewares after the router has been initialized');\n  if (appendBeforeExisting) {\n    startMiddlewaresDef = {...middlewaresDef, ...startMiddlewaresDef};\n    return;\n  }\n  startMiddlewaresDef = {...startMiddlewaresDef, ...middlewaresDef};\n}\n\n/** Adds middlewares at the end of the ExecutionChain, after the existing end middlewares by default */\nexport function addEndMiddlewares(middlewaresDef: MiddlewaresCollection, prependAfterExisting = true) {\n  if (isRouterInitialized) throw new Error('Can not add end middlewares after the router has been initialized');\n  if (prependAfterExisting) {\n    endMiddlewaresDef = {...endMiddlewaresDef, ...middlewaresDef};\n    return;\n  }\n  endMiddlewaresDef = {...middlewaresDef, ...endMiddlewaresDef};\n}\n\nexport function isPrivateDefinition(entry: RouterEntry, id: string): entry is PrivateDef {\n  if (isRoute(entry)) return false;\n  if (isRawMiddlewareDef(entry)) return true;\n  try {\n    const executable = getMiddlewareExecutable(id) || getRouteExecutable(id);\n    if (!executable) throw new Error(`Route or Middleware ${id} not found. Please check you have called mion.initRoutes first.`);\n    return !isPublicExecutable(executable);\n  } catch {\n    // a Routes object has no handler, so no executable is found\n    return false;\n  }\n}\n\nexport function getTotalExecutables(): number {\n  return routesById.size + middlewaresById.size + rawMiddlewaresById.size;\n}\n\nexport function getAllExecutablesIds(): string[] {\n  if (allExecutablesIds) return allExecutablesIds;\n  allExecutablesIds = [...routesById.keys(), ...middlewaresById.keys(), ...rawMiddlewaresById.keys()];\n  return allExecutablesIds;\n}\n\n// used by codegen\nexport function shouldFullGenerateSpec(): boolean {\n  return routerOptions.getPublicRoutesData || getENV('GENERATE_ROUTER_SPEC') === 'true';\n}\n\n// ############# PRIVATE METHODS #############\n\n/** Flattens the routes object into a list of Executable objects. `currentPointer` is the position in that\n *  object (i.e. ['users', 'get']); `preMiddlewares` / `postMiddlewares` are the middlewares one level up, before\n *  and after that position. */\nfunction recursiveFlatRoutes(\n  routes: Routes,\n  currentPointer: string[] = [],\n  preMiddlewares: RemoteMethod[] = [],\n  postMiddlewares: RemoteMethod[] = [],\n  nestLevel = 0\n) {\n  if (nestLevel > MAX_ROUTE_NESTING)\n    throw new Error('Too many nested routes, you can only nest routes ${MAX_ROUTE_NESTING} levels');\n\n  const entries = Object.entries(routes);\n  if (entries.length === 0)\n    throw new Error(`Invalid route: ${currentPointer.length ? joinPath(...currentPointer) : '*'}. Can Not define empty routes`);\n\n  let minus1Props: ReturnType<typeof getRouteEntryProperties> | null = null;\n  for (let index = 0; index < entries.length; index++) {\n    const [key, item] = entries[index];\n    const newPointer = [...currentPointer, key];\n    let routeEntry: RemoteMethod | RoutesWithId;\n    if (typeof key !== 'string' || !isNaN(key as any))\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. Numeric route names are not allowed`);\n    if (key.includes(',')) throw new Error(`Invalid route: ${joinPath(...newPointer)}. Route names cannot contain commas.`);\n    // a route id is used as an object key on both ends of the wire, so a prototype name can never be one\n    if (isUnsafePropertyName(key))\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. '${key}' is not a valid route name.`);\n    if (key === MION_BATCH_KEY)\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. '${MION_BATCH_KEY}' is a reserved mion route name.`);\n\n    if (isAnyMiddlewareDef(item)) {\n      // a start or end middleware already owns this id, and would otherwise be silently reused in its place\n      if (nestLevel === 0 && (Object.hasOwn(startMiddlewaresDef, key) || Object.hasOwn(endMiddlewaresDef, key)))\n        throw new Error(`Invalid middleware: ${joinPath(...newPointer)}. '${key}' is a reserved mion middleware name.`);\n      // it can stop a call before its route, so every route must come after it\n      if (\n        isOnDemandMiddleware(item) &&\n        (nestLevel !== 0 || entries.slice(0, index).some(([, entry]) => !isAnyMiddlewareDef(entry)))\n      )\n        throw new Error(\n          `Invalid middleware: ${joinPath(...newPointer)}. Place '${key}' at the root of your routes, before any route or group.`\n        );\n      routeEntry = getExecutableFromAnyMiddleware(item, newPointer, nestLevel);\n      if (middlewareNames.has(routeEntry.id))\n        throw new Error(`Invalid middleware: ${joinPath(...newPointer)}. Naming collision, duplicated middleware.`);\n      middlewareNames.add(routeEntry.id);\n    } else if (isRoute(item)) {\n      routeEntry = getExecutableFromRoute(item, newPointer, nestLevel);\n      if (routeNames.has(routeEntry.id))\n        throw new Error(`Invalid route: ${joinPath(...newPointer)}. Naming collision, duplicated route`);\n      routeNames.add(routeEntry.id);\n    } else if (isRoutes(item)) {\n      routeEntry = {\n        pathPointer: newPointer,\n        routes: item,\n      };\n    } else {\n      const itemType = typeof item;\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. Type <${itemType}> is not a valid route.`);\n    }\n\n    minus1Props = recursiveCreateExecutionChain(\n      routeEntry,\n      newPointer,\n      preMiddlewares,\n      postMiddlewares,\n      nestLevel,\n      index,\n      entries,\n      minus1Props\n    );\n\n    complexity++;\n  }\n}\n\nfunction recursiveCreateExecutionChain(\n  routeEntry: RemoteMethod | RoutesWithId,\n  currentPointer: string[],\n  preMiddlewares: RemoteMethod[],\n  postMiddlewares: RemoteMethod[],\n  nestLevel: number,\n  index: number,\n  routeKeyedEntries: RouterKeyEntryList,\n  minus1Props: ReturnType<typeof getRouteEntryProperties> | null\n) {\n  const minus1 = getEntry(index - 1, routeKeyedEntries);\n  const plus1 = getEntry(index + 1, routeKeyedEntries);\n  const props = getRouteEntryProperties(minus1, routeEntry, plus1);\n\n  if (props.isBetweenRoutes && minus1Props) {\n    props.preLevelMiddlewares = minus1Props.preLevelMiddlewares;\n    props.postLevelMiddlewares = minus1Props.postLevelMiddlewares;\n  } else {\n    for (let i = 0; i < routeKeyedEntries.length; i++) {\n      const [k, entry] = routeKeyedEntries[i];\n      complexity++;\n      if (!isAnyMiddlewareDef(entry)) continue;\n      const newPointer = [...currentPointer.slice(0, -1), k];\n      const executable = getExecutableFromAnyMiddleware(entry, newPointer, nestLevel);\n      if (i < index) props.preLevelMiddlewares.push(executable);\n      if (i > index) props.postLevelMiddlewares.push(executable);\n    }\n  }\n  const isExec = isExecutable(routeEntry);\n\n  if (isExec && props.isRoute) {\n    const path = getRoutePath(routeEntry.pointer, routerOptions);\n    const routeMethod = routeEntry as RouteMethod;\n    const levelMethods = [\n      ...preMiddlewares,\n      ...props.preLevelMiddlewares,\n      routeEntry,\n      ...props.postLevelMiddlewares,\n      ...postMiddlewares,\n    ];\n    const methods = [...startMiddlewares, ...levelMethods, ...endMiddlewares];\n    // internal error routes are never client-called: platform's size, not their no-params tuple's tiny one\n    const maxBodySize = mionInternalRouteIds.has(routeMethod.id)\n      ? routeMethod.options.maxBodySize\n      : resolveChainMaxBodySize(methods, routeMethod, routerOptions);\n    // published in the metadata; undefined means the platform's, filled in when the metadata is read\n    if (maxBodySize !== undefined) routeMethod.options.maxBodySize = maxBodySize;\n    const executionChain: MethodsExecutionChain = {\n      routeIndex: startMiddlewares.length + preMiddlewares.length + props.preLevelMiddlewares.length,\n      methods,\n      path,\n      declaredBodySize: maxBodySize,\n      maxBodySize: maxBodySize ?? platformMaxBodySize,\n      readsBody: true,\n    };\n    // route-level only: a global start/end middleware is not in the API type, so a built client never lists it\n    const middlewareIds = getPublicMiddlewareIds(levelMethods);\n    // add middleware deps, so can be serialized with the router\n    if (middlewareIds.length) routeMethod.middlewareIds = middlewareIds;\n    flatRouter.set(path, executionChain);\n  } else if (!isExec) {\n    recursiveFlatRoutes(\n      routeEntry.routes,\n      routeEntry.pathPointer,\n      [...preMiddlewares, ...props.preLevelMiddlewares],\n      [...props.postLevelMiddlewares, ...postMiddlewares],\n      nestLevel + 1\n    );\n  }\n\n  return props;\n}\n\n/** The thrower goes first so the dispatcher skips every later non-`alwaysRun` member; body size is the platform's. */\nfunction buildNotFoundChains(): void {\n  notFoundChains.clear();\n  const throwers = [\n    [MION_ROUTES.notFound, notFoundMiddleware],\n    [MION_ROUTES.batchNotFound, batchNotFoundMiddleware],\n  ] as const;\n  for (const [id, middlewareDef] of throwers) {\n    const methods = [getExecutableFromRawMiddleware(middlewareDef, [id], 0), ...startMiddlewares, ...endMiddlewares];\n    notFoundChains.set(id, {\n      routeIndex: -1, // there is no route in this chain\n      methods,\n      // a shared chain answers for many paths, so the request brings its own\n      path: undefined,\n      declaredBodySize: undefined,\n      maxBodySize: platformMaxBodySize,\n      readsBody: false,\n    });\n  }\n}\n\nfunction getExecutableFromAnyMiddleware(\n  middleware: MiddlewareDef | HeadersMiddlewareDef | RawMiddlewareDef,\n  middlewarePointer: string[],\n  nestLevel: number\n) {\n  if (isRawMiddlewareDef(middleware)) return getExecutableFromRawMiddleware(middleware, middlewarePointer, nestLevel);\n  return getExecutableFromMiddleware(middleware, middlewarePointer, nestLevel);\n}\n\nexport function getExecutableFromMiddleware(\n  middleware: MiddlewareDef | HeadersMiddlewareDef,\n  middlewarePointer: string[],\n  nestLevel: number\n): MiddlewareMethod | HeadersMethod {\n  const isHeader = isHeadersMiddlewareDef(middleware);\n  // todo fix header id should be same as any other one and then maybe map from id to header name\n  const middlewareId = getRouterItemId(middlewarePointer);\n  const existing = middlewaresById.get(middlewareId);\n  if (existing) return existing as MiddlewareMethod;\n\n  type MixedMiddleware = (Omit<MiddlewareMethod, 'type'> | Omit<HeadersMethod, 'type'>) & {\n    type: typeof HandlerType.middleware | typeof HandlerType.headersMiddleware;\n  };\n\n  let executable: MixedMiddleware;\n  {\n    const parser = resolveParser(middleware.options?.parser, routerOptions.parser, middlewareId);\n    const reflectionData = getHandlerReflection(middleware, middlewareId, routerOptions, middleware.options ?? {}, isHeader);\n    assertCompiledParser(middlewareId, parser, reflectionData);\n    const middlewareType = isHeader ? HandlerType.headersMiddleware : HandlerType.middleware;\n    executable = {\n      id: middlewareId,\n      type: middlewareType,\n      nestLevel,\n      handler: middleware.handler,\n      pointer: middlewarePointer,\n      // resolved here so the dispatch loop reads a field instead of deriving them per request\n      methodCaller: isOnDemandMiddleware(middleware)\n        ? onDemandCaller(callerForType(middlewareType), getOnEveryCall(middleware))\n        : callerForType(middlewareType),\n      alwaysRun: !!middleware.options?.alwaysRun,\n      quotedId: JSON.stringify(middlewareId),\n      ...reflectionData,\n      options: {\n        alwaysRun: !!middleware.options?.alwaysRun,\n        description: middleware.options?.description,\n        parser,\n        sanitizeParams: middleware.options?.sanitizeParams ?? routerOptions.sanitizeParams,\n      },\n    };\n    // a middleware's maxBodySize is its OWN contribution to every chain it sits in, never resolved;\n    // written only when set, so the metadata a client receives carries no `undefined` key\n    if (middleware.options?.maxBodySize !== undefined) executable.options.maxBodySize = middleware.options.maxBodySize;\n  }\n\n  middlewaresById.set(middlewareId, executable as any);\n  routesCache.setMethodJitFns(middlewareId, executable as any);\n  return executable as any;\n}\n\n/** An absent slot skips the params pipeline; the answer is the same only because such a middleware's params are optional. */\nfunction onDemandCaller(\n  caller: RemoteMethod['methodCaller'],\n  onEveryCall?: ReturnType<typeof getOnEveryCall>\n): RemoteMethod['methodCaller'] {\n  return (context: CallContext, executable: RemoteMethod, request: {body: Record<string, unknown>}, ...rest: unknown[]) => {\n    onEveryCall?.(context);\n    return request.body[executable.id] === undefined ? undefined : caller(context, executable, request, ...rest);\n  };\n}\n\nexport function getExecutableFromRawMiddleware(\n  middleware: RawMiddlewareDef,\n  middlewarePointer: string[],\n  nestLevel: number\n): RawMethod {\n  const middlewareId = getRouterItemId(middlewarePointer);\n  const existing = rawMiddlewaresById.get(middlewareId);\n  if (existing) return existing as RawMethod;\n  const reflectionData = getRawMethodReflection(middleware.handler, middlewareId, routerOptions);\n  const executable: RawMethod = {\n    id: middlewareId,\n    type: HandlerType.rawMiddleware,\n    nestLevel,\n    handler: middleware.handler,\n    pointer: middlewarePointer,\n    methodCaller: callerForType(HandlerType.rawMiddleware),\n    alwaysRun: !!middleware.options?.alwaysRun,\n    quotedId: JSON.stringify(middlewareId),\n    ...reflectionData,\n    options: {\n      alwaysRun: !!middleware.options?.alwaysRun,\n      description: middleware.options?.description,\n    },\n  };\n  rawMiddlewaresById.set(middlewareId, executable);\n  routesCache.setMethodJitFns(middlewareId, executable as any);\n  return executable;\n}\n\nexport function getExecutableFromRoute(route: Route, routePointer: string[], nestLevel: number): RouteMethod {\n  const routeId = getRouterItemId(routePointer);\n  const existing = routesById.get(routeId);\n  if (existing) return existing as RouteMethod;\n\n  let executable: RouteMethod;\n  {\n    const parser = resolveParser(route.options?.parser, routerOptions.parser, routeId);\n    const reflectionData = getHandlerReflection(route, routeId, routerOptions, route.options ?? {}, false);\n    assertCompiledParser(routeId, parser, reflectionData);\n    executable = {\n      id: routeId,\n      type: HandlerType.route,\n      nestLevel,\n      handler: route.handler,\n      pointer: routePointer,\n      methodCaller: callerForType(HandlerType.route),\n      alwaysRun: false,\n      quotedId: JSON.stringify(routeId),\n      ...reflectionData,\n      options: {\n        alwaysRun: false,\n        description: route.options?.description,\n        parser,\n        isMutation: route.options?.isMutation,\n        sanitizeParams: route.options?.sanitizeParams ?? routerOptions.sanitizeParams,\n      },\n    };\n    // the route option as written; the chain resolution overwrites it with the resolved number\n    if (route.options?.maxBodySize !== undefined) executable.options.maxBodySize = route.options.maxBodySize;\n  }\n  routesById.set(routeId, executable);\n  routesCache.setMethodJitFns(routeId, executable as any);\n  return executable;\n}\n\nfunction getPublicMiddlewareIds(methods: RemoteMethod[]): string[] {\n  const ids = methods\n    .filter((exec) => isPublicExecutable(exec))\n    .map((exec) => getRouterItemId(exec.pointer))\n    .filter((mfId) => {\n      if (mionInternalRouteIds.has(mfId)) return false;\n      const exec = getMiddlewareExecutable(mfId);\n      return exec && isPublicExecutable(exec);\n    });\n  return ids;\n}\n\nfunction getEntry(index: number, keyEntryList: RouterKeyEntryList) {\n  return keyEntryList[index]?.[1];\n}\n\nfunction getRouteEntryProperties(\n  minus1: RouterEntry | undefined,\n  zero: RemoteMethod | RoutesWithId,\n  plus1: RouterEntry | undefined\n) {\n  const minus1IsRoute = minus1 && isRoute(minus1);\n  const zeroIsRoute = (zero as RemoteMethod).type === HandlerType.route;\n  const plus1IsRoute = plus1 && isRoute(plus1);\n\n  const isExec = !!(zero as RemoteMethod).handler;\n\n  return {\n    isBetweenRoutes: minus1IsRoute && zeroIsRoute && plus1IsRoute,\n    isExecutable: isExec,\n    isRoute: zeroIsRoute,\n    preLevelMiddlewares: [] as RemoteMethod[],\n    postLevelMiddlewares: [] as RemoteMethod[],\n  };\n}\n\nfunction getExecutablesFromMiddlewaresCollection(\n  middlewaresDef: MiddlewaresCollection\n): (RawMethod | MiddlewareMethod | HeadersMethod)[] {\n  const results: (RawMethod | MiddlewareMethod | HeadersMethod)[] = [];\n  for (const [key, middleware] of Object.entries(middlewaresDef)) {\n    if (isRawMiddlewareDef(middleware)) {\n      results.push(getExecutableFromRawMiddleware(middleware, [key], 0));\n    } else if (isHeadersMiddlewareDef(middleware) || isMiddlewareDef(middleware)) {\n      results.push(getExecutableFromMiddleware(middleware, [key], 0));\n    } else {\n      throw new Error(`Invalid middleware: ${key}. Invalid middleware definition`);\n    }\n  }\n  return results;\n}\n\nfunction validateSharedDataFactory(opts?: Partial<RouterOptions>): void {\n  if (!opts?.contextDataFactory) return;\n  const testSharedData = opts.contextDataFactory();\n  if (\n    typeof testSharedData !== 'object' ||\n    Array.isArray(testSharedData) ||\n    testSharedData === null ||\n    Object.keys(testSharedData).length === 0\n  ) {\n    throw new Error('contextDataFactory must return a plain object with at least one property');\n  }\n}\n\n/** Hand-rolled: Node's 'path' module is not available in edge runtimes. */\nfunction joinPath(...parts: string[]): string {\n  return parts.filter(Boolean).join('/');\n}\n\n// ############# PLATFORM SIZE LIMITS #############\n\n/** What a route takes when its own option is unset and its types cannot say: the adapter's `maxBodySize`,\n *  published with its config at start, else the shared default (a router driven with no adapter, as in tests). */\nexport const getPlatformMaxBodySize = (): number => platformMaxBodySize;\n\n/** The platform's own request ceiling, when the adapter published one. */\nexport const getPlatformRequestCap = (): number | undefined => readMaxBodySizeCap(platformConfig);\n\n/** The largest limit any registered route or batch resolves to: what a platform with ONE native,\n *  server-wide read limit (bun) starts with, so it never refuses a body a route allows. */\nexport function getMaxRouteBodySize(): number {\n  let largest = getPlatformMaxBodySize();\n  for (const chain of flatRouter.values()) largest = Math.max(largest, chain.maxBodySize);\n  return Math.max(largest, getMaxBatchBodySize());\n}\n\n/** The platform's own request ceiling the adapter published, in bytes; undefined means none. */\nfunction readMaxBodySizeCap(config: Record<string, unknown> | undefined): number | undefined {\n  const cap = config?.maxBodySizeCap;\n  return typeof cap === 'number' ? cap : undefined;\n}\n\n/** A limit above the platform's ceiling would promise a size the platform refuses before mion ever runs,\n *  so it is brought down. Applied once, when the adapter has published its config AND the routes are\n *  registered, whichever comes last. */\nfunction applyMaxBodySizeCap(): void {\n  const cap = readMaxBodySizeCap(platformConfig);\n  if (cap === undefined) return;\n  for (const chain of flatRouter.values()) {\n    if (chain.declaredBodySize === undefined || chain.declaredBodySize <= cap) continue;\n    chain.declaredBodySize = cap;\n    const route = chain.methods[chain.routeIndex];\n    if (route.options.maxBodySize !== undefined) route.options.maxBodySize = cap;\n  }\n  capBatchBodySizes(cap);\n}\n\n/** `maxBodySize` caches two inputs that both move after a chain is built: the cap above lowers what a\n *  chain declared, and `setPlatformConfig` replaces the fallback the chains that declared nothing read.\n *  Missing a refresh refuses bodies a route allows, or allows bodies past the platform's ceiling. */\nfunction refreshChainBodyLimits(): void {\n  for (const chain of flatRouter.values()) chain.maxBodySize = chain.declaredBodySize ?? platformMaxBodySize;\n  for (const chain of notFoundChains.values()) chain.maxBodySize = chain.declaredBodySize ?? platformMaxBodySize;\n  refreshBatchChainBodyLimits(platformMaxBodySize);\n}\n\n/** `server` first so the option can replace it, `content-type` last so it cannot; lowercased, or `Headers` would\n *  append a name repeated in another case. */\nfunction mergeResponseDefaults(responseHeaders: Record<string, string>): ResponseDefaults {\n  const merged: Record<string, string> = {server: 'mionjs'};\n  for (const name in responseHeaders) merged[name.toLowerCase()] = responseHeaders[name];\n  merged['content-type'] = JSON_CONTENT_TYPE;\n  return merged;\n}\n"],"mappings":"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"}
+{"version":3,"file":"router.js","names":[],"sources":["../../../src/router.ts"],"sourcesContent":["/* ########\n * 2022 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport type {HostRequestHandler, Route, RouterOptions, Routes, RouterEntry} from './types/general.ts';\nimport {assertHeaderSafe} from './lib/headers.ts';\nimport type {\n  RemoteMethod,\n  MethodsExecutionChain,\n  RawMethod,\n  HeadersMethod,\n  MiddlewareMethod,\n  RouteMethod,\n} from './types/remoteMethods.ts';\nimport type {PublicApi, PrivateDef, MiddlewaresCollection} from './types/publicMethods.ts';\nimport type {HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef} from './types/definitions.ts';\nimport type {ResponseDefaults} from './types/context.ts';\nimport {DEFAULT_ROUTE_OPTIONS, JSON_CONTENT_TYPE, MAX_ROUTE_NESTING, MION_SERVER_NAME} from './constants.ts';\nimport {\n  isRawMiddlewareDef,\n  isHeadersMiddlewareDef,\n  isExecutable,\n  isMiddlewareDef,\n  isRoute,\n  isRoutes,\n  isAnyMiddlewareDef,\n  isPublicExecutable,\n} from './types/guards.ts';\nimport {BUILD_VERSION_HEADER, HandlerType, resetRoutesCache, resolveParser, DEFAULT_MAX_BODY_SIZE} from '@mionjs/core';\nimport {getRawMethodReflection, getHandlerReflection, assertCompiledParser} from './lib/reflection.ts';\nimport {resolveChainMaxBodySize} from './lib/bodyLimit.ts';\nimport {callerForType} from './dispatch.ts';\nimport {serializerMiddlewares} from './routes/serializer.routes.ts';\nimport {\n  getRouterItemId,\n  getRoutePath,\n  getENV,\n  MION_ROUTES,\n  MION_BATCH_KEY,\n  routesCache,\n  isUnsafePropertyName,\n} from '@mionjs/core';\nimport {setErrorOptions} from '@mionjs/core';\nimport {getPublicApi, resetRemoteMethodsMetadata} from './lib/remoteMethods.ts';\nimport {mionErrorsRoutes, notFoundMiddleware, batchNotFoundMiddleware} from './routes/errors.routes.ts';\nimport {capBatchBodySizes, clearBatches, getMaxBatchBodySize, refreshBatchChainBodyLimits} from './batches.ts';\nimport {\n  headersMiddleware,\n  isOnDemandMiddleware,\n  getOnEveryCall,\n  middleware,\n  mionInternalRouteIds,\n  mutation,\n  query,\n  rawMiddleware,\n  route,\n} from './lib/handlers.ts';\nimport type {CallContext} from './types/context.ts';\nimport type {\n  HeadersMiddlewareHelper,\n  CheckedRouterTypes,\n  KnownKeysOf,\n  MiddlewareHelper,\n  MionRouter,\n  RawMiddlewareHelper,\n  RouteHelper,\n  RouterOptionsInput,\n  RouterOptionsArg,\n  RouterTypes,\n  TypedRouterFactory,\n  WithShared,\n} from './types/mionRouter.ts';\n\ntype RouterKeyEntryList = [string, RouterEntry][];\ntype RoutesWithId = {\n  pathPointer: string[];\n  routes: Routes;\n};\n\n// ############# PRIVATE STATE #############\n\nconst flatRouter = new Map<string, MethodsExecutionChain>(); // Main Router\n/** mion's two not-found chains (an unknown path, an unknown batch id) are NOT routes and not in the\n *  router above: each is the global middleware behind a first member that throws, and is rebuilt on\n *  every registration because that middleware is. */\nconst notFoundChains = new Map<string, MethodsExecutionChain>();\nconst middlewaresById = new Map<string, MiddlewareMethod | HeadersMethod | RawMethod>();\nconst routesById = new Map<string, RouteMethod>();\nconst rawMiddlewaresById = new Map<string, RawMethod>();\nconst middlewareNames = new Set<string>();\nconst routeNames = new Set<string>();\nlet complexity = 0;\nlet routerOptions: RouterOptions = {...DEFAULT_ROUTE_OPTIONS};\nlet isRouterInitialized = false;\nlet isRouterCreated = false;\nlet allExecutablesIds: string[] | undefined;\nlet platformConfig: Record<string, unknown> | undefined;\n/** Merged by initRouter, read per request. */\nlet responseDefaults: ResponseDefaults = mergeResponseDefaults({});\n/** Sent by mionFetchMetadata; unset with `apiVersionCheck` off, a pinned header or no build version. */\nlet buildVersion: string | undefined;\n/** The adapter's `maxBodySize` under its `maxBodySizeCap`, settled by setPlatformConfig (the default with no adapter). */\nlet platformMaxBodySize = DEFAULT_MAX_BODY_SIZE;\n\n/** Run before and after every middleware or route set through `mion.initRoutes` */\nconst defaultStartMiddlewares = {\n  mionDeserializeRequest: serializerMiddlewares.mionDeserializeRequest,\n};\nconst defaultEndMiddlewares = {\n  mionSerializeResponse: serializerMiddlewares.mionSerializeResponse,\n};\nlet startMiddlewaresDef: MiddlewaresCollection = {...defaultStartMiddlewares};\nlet endMiddlewaresDef: MiddlewaresCollection = {...defaultEndMiddlewares};\nexport let startMiddlewares: RemoteMethod[] = [];\nexport let endMiddlewares: RemoteMethod[] = [];\n\n// ############# PUBLIC METHODS #############\n\nexport const getRouteExecutionChain = (path: string) => flatRouter.get(path);\n/** The chain that answers an unknown path or an unknown batch id, by its `MION_ROUTES` id. */\nexport const getNotFoundExecutionChain = (id: string) => notFoundChains.get(id);\nexport const getRoutesSize = () => flatRouter.size;\nexport const getRouteExecutable = (id: string) => routesById.get(id);\nexport const getMiddlewareExecutable = (id: string) => middlewaresById.get(id);\nexport const getMiddlewaresSize = () => middlewaresById.size;\nexport const getComplexity = () => complexity;\nexport const getRouterOptions = <Opts extends RouterOptions>(): Readonly<Opts> => routerOptions as Opts;\n/** The version mionFetchMetadata sends in `x-build-version`. */\nexport const getBuildVersion = (): string | undefined => buildVersion;\n/** The headers every response starts with: every adapter reads it per request. */\nexport const getResponseDefaults = (): ResponseDefaults => responseDefaults;\n\nexport const getAnyExecutable = (id: string) => routesById.get(id) || middlewaresById.get(id) || rawMiddlewaresById.get(id);\n\n/** Called automatically by platform adapters: the adapter's `maxBodySize` and `maxBodySizeCap` are\n *  settled here, once, so no request reads the config. */\nexport function setPlatformConfig(config: Record<string, unknown>): void {\n  platformConfig = config;\n  const published = config.maxBodySize;\n  platformMaxBodySize = Math.min(\n    typeof published === 'number' ? published : DEFAULT_MAX_BODY_SIZE,\n    readMaxBodySizeCap(config) ?? Infinity\n  );\n  if (isRouterInitialized) applyMaxBodySizeCap();\n  // Unconditional, and NOT inside applyMaxBodySizeCap: that returns early when the adapter published no\n  // cap, while platformMaxBodySize still changed under every chain that declared nothing of its own.\n  refreshChainBodyLimits();\n}\n\nexport const getPlatformConfig = (): Readonly<Record<string, unknown>> | undefined => platformConfig;\n\n// resetRouter leaves it alone: the dev host sets it before the entry loads, not the routes.\nconst devHost = {\n  ownsSocket: false,\n  handler: undefined as HostRequestHandler | undefined,\n};\n\n/** Set by a dev host that owns the socket (the mion vite plugin) BEFORE it loads the server entry, so whatever\n *  platform adapter the entry starts registers its routes and hands over its handler instead of listening. */\nexport function setHostOwnsSocket(ownsSocket: boolean): void {\n  devHost.ownsSocket = ownsSocket;\n  if (!ownsSocket) devHost.handler = undefined;\n}\n\nexport const hostOwnsSocket = (): boolean => devHost.ownsSocket;\n\n/** Every platform adapter calls it on start; true means a dev host owns the socket and the adapter must not listen. */\nexport function handOverToHost(handler: HostRequestHandler): boolean {\n  if (devHost.ownsSocket) devHost.handler = handler;\n  return devHost.ownsSocket;\n}\n\nexport const getHostRequestHandler = (): HostRequestHandler | undefined => devHost.handler;\n\nexport const resetRouter = () => {\n  flatRouter.clear();\n  notFoundChains.clear();\n  middlewaresById.clear();\n  routesById.clear();\n  rawMiddlewaresById.clear();\n  middlewareNames.clear();\n  routeNames.clear();\n  complexity = 0;\n  routerOptions = {...DEFAULT_ROUTE_OPTIONS};\n  startMiddlewaresDef = {...defaultStartMiddlewares};\n  endMiddlewaresDef = {...defaultEndMiddlewares};\n  startMiddlewares = [];\n  endMiddlewares = [];\n  isRouterInitialized = false;\n  isRouterCreated = false;\n  allExecutablesIds = undefined;\n  platformConfig = undefined;\n  responseDefaults = mergeResponseDefaults({});\n  buildVersion = undefined;\n  platformMaxBodySize = DEFAULT_MAX_BODY_SIZE;\n  resetRemoteMethodsMetadata();\n  resetRoutesCache();\n  clearBatches();\n  // No resetJitFnCaches(): it lives in @mionjs/core/testing, which a shipped router must not import.\n};\n\n/** Options ride BY TYPE into every helper, so router-wide defaults are read at build time and `ctx.shared` is typed from\n *  `sharedDataFactory`'s written return type. The helpers are plain closures (no `this`), safe to destructure. */\nexport function createMionRouter<const O extends RouterOptionsInput & KnownKeysOf<O, object> = Record<never, never>>(\n  opts?: RouterOptionsArg<O>\n): MionRouter<O, WithShared<O, object>> {\n  if (isRouterCreated)\n    throw new Error(\n      'createMionRouter has already been called: create the router once per app (resetRouter() clears it in tests)'\n    );\n  isRouterCreated = true;\n  const options = Object.freeze({...opts}) as Readonly<O>;\n  return {\n    options,\n    route: route as RouteHelper<O, WithShared<O, object>>,\n    query: query as RouteHelper<O, WithShared<O, object>, false>,\n    mutation: mutation as RouteHelper<O, WithShared<O, object>, true>,\n    middleware: middleware as MiddlewareHelper<O, WithShared<O, object>>,\n    headersMiddleware: headersMiddleware as HeadersMiddlewareHelper<O, WithShared<O, object>>,\n    rawMiddleware: rawMiddleware as RawMiddlewareHelper<WithShared<O, object>>,\n    // Typed by MionRouter, the one place its signature is written.\n    initRoutes(routes, buildVersion) {\n      initRouter(options, buildVersion);\n      const api = registerRoutes(routes);\n      if (platformConfig) applyMaxBodySizeCap();\n      refreshChainBodyLimits();\n      return api;\n    },\n  };\n}\n\n/** Declares the keys a router adds (see `RouterTypes`) and returns `createMionRouter` typed by them. Types only: a type\n *  argument on `createMionRouter` itself would stop the options literal from being inferred.\n *  @example\n *  ```ts\n *  const mion = createMionRouter.withTypes<{handler: MionSecurityHandlerOptions}>()({basePath: 'api'});\n *  mion.route(handler, {cors: false});\n *  ``` */\ncreateMionRouter.withTypes = function withTypes<T extends RouterTypes & CheckedRouterTypes<T> = object>(): TypedRouterFactory<T> {\n  return createMionRouter as unknown as TypedRouterFactory<T>;\n};\n\n/** Once per app; `resetRouter()` clears it. */\nfunction initRouter(opts: RouterOptionsInput, version?: string): void {\n  if (isRouterInitialized) throw new Error('Router has already been initialized');\n  routerOptions = {...routerOptions, ...opts};\n  // a pinned version already rides every response, so the middleware adds none\n  responseDefaults = mergeResponseDefaults(routerOptions.responseHeaders);\n  const isPinned = responseDefaults[BUILD_VERSION_HEADER] !== undefined;\n  buildVersion = (routerOptions.apiVersionCheck && !isPinned && version) || undefined;\n  validateSharedDataFactory(routerOptions);\n  Object.freeze(routerOptions);\n  setErrorOptions(routerOptions);\n  isRouterInitialized = true;\n  registerRoutes({...mionErrorsRoutes});\n}\n\nfunction registerRoutes<R extends Routes>(routes: R): PublicApi<R> {\n  if (!isRouterInitialized) throw new Error('the router must be initialized first');\n  startMiddlewares = getExecutablesFromMiddlewaresCollection(startMiddlewaresDef);\n  endMiddlewares = getExecutablesFromMiddlewaresCollection(endMiddlewaresDef);\n  recursiveFlatRoutes(routes, [], [], [], 0);\n  buildNotFoundChains();\n  allExecutablesIds = undefined; // the memoized id list must see the routes registered by this call\n  if (shouldFullGenerateSpec()) {\n    return getPublicApi(routes);\n  }\n  return {} as PublicApi<R>;\n}\n\n/** Adds middlewares at the start of the ExecutionChain, before the existing start middlewares by default */\nexport function addStartMiddlewares(middlewaresDef: MiddlewaresCollection, appendBeforeExisting = true) {\n  if (isRouterInitialized) throw new Error('Can not add start middlewares after the router has been initialized');\n  if (appendBeforeExisting) {\n    startMiddlewaresDef = {...middlewaresDef, ...startMiddlewaresDef};\n    return;\n  }\n  startMiddlewaresDef = {...startMiddlewaresDef, ...middlewaresDef};\n}\n\n/** Adds middlewares at the end of the ExecutionChain, after the existing end middlewares by default */\nexport function addEndMiddlewares(middlewaresDef: MiddlewaresCollection, prependAfterExisting = true) {\n  if (isRouterInitialized) throw new Error('Can not add end middlewares after the router has been initialized');\n  if (prependAfterExisting) {\n    endMiddlewaresDef = {...endMiddlewaresDef, ...middlewaresDef};\n    return;\n  }\n  endMiddlewaresDef = {...middlewaresDef, ...endMiddlewaresDef};\n}\n\nexport function isPrivateDefinition(entry: RouterEntry, id: string): entry is PrivateDef {\n  if (isRoute(entry)) return false;\n  if (isRawMiddlewareDef(entry)) return true;\n  try {\n    const executable = getMiddlewareExecutable(id) || getRouteExecutable(id);\n    if (!executable) throw new Error(`Route or Middleware ${id} not found. Please check you have called mion.initRoutes first.`);\n    return !isPublicExecutable(executable);\n  } catch {\n    // a Routes object has no handler, so no executable is found\n    return false;\n  }\n}\n\nexport function getTotalExecutables(): number {\n  return routesById.size + middlewaresById.size + rawMiddlewaresById.size;\n}\n\nexport function getAllExecutablesIds(): string[] {\n  if (allExecutablesIds) return allExecutablesIds;\n  allExecutablesIds = [...routesById.keys(), ...middlewaresById.keys(), ...rawMiddlewaresById.keys()];\n  return allExecutablesIds;\n}\n\n// used by codegen\nexport function shouldFullGenerateSpec(): boolean {\n  return routerOptions.getPublicRoutesData || getENV('GENERATE_ROUTER_SPEC') === 'true';\n}\n\n// ############# PRIVATE METHODS #############\n\n/** `currentPointer` is the position in `routes` (e.g. ['users', 'get']); the middlewares come from one level up. */\nfunction recursiveFlatRoutes(\n  routes: Routes,\n  currentPointer: string[] = [],\n  preMiddlewares: RemoteMethod[] = [],\n  postMiddlewares: RemoteMethod[] = [],\n  nestLevel = 0\n) {\n  if (nestLevel > MAX_ROUTE_NESTING)\n    throw new Error(`Too many nested routes, you can only nest routes ${MAX_ROUTE_NESTING} levels`);\n\n  const entries = Object.entries(routes);\n  if (entries.length === 0)\n    throw new Error(`Invalid route: ${currentPointer.length ? joinPath(...currentPointer) : '*'}. Can Not define empty routes`);\n\n  let minus1Props: ReturnType<typeof getRouteEntryProperties> | null = null;\n  for (let index = 0; index < entries.length; index++) {\n    const [key, item] = entries[index];\n    const newPointer = [...currentPointer, key];\n    let routeEntry: RemoteMethod | RoutesWithId;\n    if (typeof key !== 'string' || !isNaN(key as any))\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. Numeric route names are not allowed`);\n    if (key.includes(',')) throw new Error(`Invalid route: ${joinPath(...newPointer)}. Route names cannot contain commas.`);\n    // a route id is used as an object key on both ends of the wire, so a prototype name can never be one\n    if (isUnsafePropertyName(key))\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. '${key}' is not a valid route name.`);\n    if (key === MION_BATCH_KEY)\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. '${MION_BATCH_KEY}' is a reserved mion route name.`);\n    // the client proxy answers no `then`, so `await routes` settles; such a route could never be called\n    if (key === 'then') throw new Error(`Invalid route: ${joinPath(...newPointer)}. 'then' is a reserved mion route name.`);\n\n    if (isAnyMiddlewareDef(item)) {\n      // a start or end middleware already owns this id, and would otherwise be silently reused in its place\n      if (nestLevel === 0 && (Object.hasOwn(startMiddlewaresDef, key) || Object.hasOwn(endMiddlewaresDef, key)))\n        throw new Error(`Invalid middleware: ${joinPath(...newPointer)}. '${key}' is a reserved mion middleware name.`);\n      // it can stop a call before its route, so every route must come after it\n      if (\n        isOnDemandMiddleware(item) &&\n        (nestLevel !== 0 || entries.slice(0, index).some(([, entry]) => !isAnyMiddlewareDef(entry)))\n      )\n        throw new Error(\n          `Invalid middleware: ${joinPath(...newPointer)}. Place '${key}' at the root of your routes, before any route or group.`\n        );\n      routeEntry = getExecutableFromAnyMiddleware(item, newPointer, nestLevel);\n      if (middlewareNames.has(routeEntry.id))\n        throw new Error(`Invalid middleware: ${joinPath(...newPointer)}. Naming collision, duplicated middleware.`);\n      middlewareNames.add(routeEntry.id);\n    } else if (isRoute(item)) {\n      routeEntry = getExecutableFromRoute(item, newPointer, nestLevel);\n      if (routeNames.has(routeEntry.id))\n        throw new Error(`Invalid route: ${joinPath(...newPointer)}. Naming collision, duplicated route`);\n      routeNames.add(routeEntry.id);\n    } else if (isRoutes(item)) {\n      routeEntry = {\n        pathPointer: newPointer,\n        routes: item,\n      };\n    } else {\n      const itemType = typeof item;\n      throw new Error(`Invalid route: ${joinPath(...newPointer)}. Type <${itemType}> is not a valid route.`);\n    }\n\n    minus1Props = recursiveCreateExecutionChain(\n      routeEntry,\n      newPointer,\n      preMiddlewares,\n      postMiddlewares,\n      nestLevel,\n      index,\n      entries,\n      minus1Props\n    );\n\n    complexity++;\n  }\n}\n\nfunction recursiveCreateExecutionChain(\n  routeEntry: RemoteMethod | RoutesWithId,\n  currentPointer: string[],\n  preMiddlewares: RemoteMethod[],\n  postMiddlewares: RemoteMethod[],\n  nestLevel: number,\n  index: number,\n  routeKeyedEntries: RouterKeyEntryList,\n  minus1Props: ReturnType<typeof getRouteEntryProperties> | null\n) {\n  const minus1 = getEntry(index - 1, routeKeyedEntries);\n  const plus1 = getEntry(index + 1, routeKeyedEntries);\n  const props = getRouteEntryProperties(minus1, routeEntry, plus1);\n\n  if (props.isBetweenRoutes && minus1Props) {\n    props.preLevelMiddlewares = minus1Props.preLevelMiddlewares;\n    props.postLevelMiddlewares = minus1Props.postLevelMiddlewares;\n  } else {\n    for (let i = 0; i < routeKeyedEntries.length; i++) {\n      const [k, entry] = routeKeyedEntries[i];\n      complexity++;\n      if (!isAnyMiddlewareDef(entry)) continue;\n      const newPointer = [...currentPointer.slice(0, -1), k];\n      const executable = getExecutableFromAnyMiddleware(entry, newPointer, nestLevel);\n      if (i < index) props.preLevelMiddlewares.push(executable);\n      if (i > index) props.postLevelMiddlewares.push(executable);\n    }\n  }\n  const isExec = isExecutable(routeEntry);\n\n  if (isExec && props.isRoute) {\n    const path = getRoutePath(routeEntry.pointer, routerOptions);\n    const routeMethod = routeEntry as RouteMethod;\n    const levelMethods = [\n      ...preMiddlewares,\n      ...props.preLevelMiddlewares,\n      routeEntry,\n      ...props.postLevelMiddlewares,\n      ...postMiddlewares,\n    ];\n    const methods = [...startMiddlewares, ...levelMethods, ...endMiddlewares];\n    // internal error routes are never client-called: platform's size, not their no-params tuple's tiny one\n    const maxBodySize = mionInternalRouteIds.has(routeMethod.id)\n      ? routeMethod.options.maxBodySize\n      : resolveChainMaxBodySize(methods, routeMethod, routerOptions);\n    // published in the metadata; undefined means the platform's, filled in when the metadata is read\n    if (maxBodySize !== undefined) routeMethod.options.maxBodySize = maxBodySize;\n    const executionChain: MethodsExecutionChain = {\n      routeIndex: startMiddlewares.length + preMiddlewares.length + props.preLevelMiddlewares.length,\n      methods,\n      path,\n      declaredBodySize: maxBodySize,\n      maxBodySize: maxBodySize ?? platformMaxBodySize,\n      readsBody: true,\n    };\n    // route-level only: a global start/end middleware is not in the API type, so a built client never lists it\n    const middlewareIds = getPublicMiddlewareIds(levelMethods);\n    // add middleware deps, so can be serialized with the router\n    if (middlewareIds.length) routeMethod.middlewareIds = middlewareIds;\n    flatRouter.set(path, executionChain);\n  } else if (!isExec) {\n    recursiveFlatRoutes(\n      routeEntry.routes,\n      routeEntry.pathPointer,\n      [...preMiddlewares, ...props.preLevelMiddlewares],\n      [...props.postLevelMiddlewares, ...postMiddlewares],\n      nestLevel + 1\n    );\n  }\n\n  return props;\n}\n\n/** The thrower goes first so the dispatcher skips every later non-`alwaysRun` member; body size is the platform's. */\nfunction buildNotFoundChains(): void {\n  notFoundChains.clear();\n  const throwers = [\n    [MION_ROUTES.notFound, notFoundMiddleware],\n    [MION_ROUTES.batchNotFound, batchNotFoundMiddleware],\n  ] as const;\n  for (const [id, middlewareDef] of throwers) {\n    const methods = [getExecutableFromRawMiddleware(middlewareDef, [id], 0), ...startMiddlewares, ...endMiddlewares];\n    notFoundChains.set(id, {\n      routeIndex: -1, // there is no route in this chain\n      methods,\n      // a shared chain answers for many paths, so the request brings its own\n      path: undefined,\n      declaredBodySize: undefined,\n      maxBodySize: platformMaxBodySize,\n      readsBody: false,\n    });\n  }\n}\n\nfunction getExecutableFromAnyMiddleware(\n  middleware: MiddlewareDef | HeadersMiddlewareDef | RawMiddlewareDef,\n  middlewarePointer: string[],\n  nestLevel: number\n) {\n  if (isRawMiddlewareDef(middleware)) return getExecutableFromRawMiddleware(middleware, middlewarePointer, nestLevel);\n  return getExecutableFromMiddleware(middleware, middlewarePointer, nestLevel);\n}\n\nexport function getExecutableFromMiddleware(\n  middleware: MiddlewareDef | HeadersMiddlewareDef,\n  middlewarePointer: string[],\n  nestLevel: number\n): MiddlewareMethod | HeadersMethod {\n  const isHeader = isHeadersMiddlewareDef(middleware);\n  // todo fix header id should be same as any other one and then maybe map from id to header name\n  const middlewareId = getRouterItemId(middlewarePointer);\n  const existing = middlewaresById.get(middlewareId);\n  if (existing) return existing as MiddlewareMethod;\n\n  type MixedMiddleware = (Omit<MiddlewareMethod, 'type'> | Omit<HeadersMethod, 'type'>) & {\n    type: typeof HandlerType.middleware | typeof HandlerType.headersMiddleware;\n  };\n\n  let executable: MixedMiddleware;\n  {\n    const parser = resolveParser(middleware.options?.parser, routerOptions.parser, middlewareId);\n    const reflectionData = getHandlerReflection(middleware, middlewareId, routerOptions, middleware.options ?? {}, isHeader);\n    assertCompiledParser(middlewareId, parser, reflectionData);\n    const middlewareType = isHeader ? HandlerType.headersMiddleware : HandlerType.middleware;\n    executable = {\n      id: middlewareId,\n      type: middlewareType,\n      nestLevel,\n      handler: middleware.handler,\n      pointer: middlewarePointer,\n      // resolved here so the dispatch loop reads a field instead of deriving them per request\n      methodCaller: isOnDemandMiddleware(middleware)\n        ? onDemandCaller(callerForType(middlewareType), getOnEveryCall(middleware))\n        : callerForType(middlewareType),\n      alwaysRun: !!middleware.options?.alwaysRun,\n      quotedId: JSON.stringify(middlewareId),\n      ...reflectionData,\n      // added keys first, so mion's own always win\n      options: {\n        ...middleware.options,\n        alwaysRun: !!middleware.options?.alwaysRun,\n        description: middleware.options?.description,\n        parser,\n        sanitizeParams: middleware.options?.sanitizeParams ?? routerOptions.sanitizeParams,\n      },\n    };\n    // a middleware's maxBodySize is its OWN contribution to every chain it sits in, never resolved;\n    // written only when set, so the metadata a client receives carries no `undefined` key\n    if (middleware.options?.maxBodySize !== undefined) executable.options.maxBodySize = middleware.options.maxBodySize;\n  }\n\n  middlewaresById.set(middlewareId, executable as any);\n  routesCache.setMethodJitFns(middlewareId, executable as any);\n  return executable as any;\n}\n\n/** An absent slot skips the params pipeline; the answer is the same only because such a middleware's params are optional. */\nfunction onDemandCaller(\n  caller: RemoteMethod['methodCaller'],\n  onEveryCall?: ReturnType<typeof getOnEveryCall>\n): RemoteMethod['methodCaller'] {\n  return (context: CallContext, executable: RemoteMethod, request: {body: Record<string, unknown>}, ...rest: unknown[]) => {\n    onEveryCall?.(context);\n    return request.body[executable.id] === undefined ? undefined : caller(context, executable, request, ...rest);\n  };\n}\n\nexport function getExecutableFromRawMiddleware(\n  middleware: RawMiddlewareDef,\n  middlewarePointer: string[],\n  nestLevel: number\n): RawMethod {\n  const middlewareId = getRouterItemId(middlewarePointer);\n  const existing = rawMiddlewaresById.get(middlewareId);\n  if (existing) return existing as RawMethod;\n  const reflectionData = getRawMethodReflection(middleware.handler, middlewareId, routerOptions);\n  const executable: RawMethod = {\n    id: middlewareId,\n    type: HandlerType.rawMiddleware,\n    nestLevel,\n    handler: middleware.handler,\n    pointer: middlewarePointer,\n    methodCaller: callerForType(HandlerType.rawMiddleware),\n    alwaysRun: !!middleware.options?.alwaysRun,\n    quotedId: JSON.stringify(middlewareId),\n    ...reflectionData,\n    options: {\n      ...middleware.options,\n      alwaysRun: !!middleware.options?.alwaysRun,\n      description: middleware.options?.description,\n    },\n  };\n  rawMiddlewaresById.set(middlewareId, executable);\n  routesCache.setMethodJitFns(middlewareId, executable as any);\n  return executable;\n}\n\nexport function getExecutableFromRoute(route: Route, routePointer: string[], nestLevel: number): RouteMethod {\n  const routeId = getRouterItemId(routePointer);\n  const existing = routesById.get(routeId);\n  if (existing) return existing as RouteMethod;\n\n  let executable: RouteMethod;\n  {\n    const parser = resolveParser(route.options?.parser, routerOptions.parser, routeId);\n    const reflectionData = getHandlerReflection(route, routeId, routerOptions, route.options ?? {}, false);\n    assertCompiledParser(routeId, parser, reflectionData);\n    executable = {\n      id: routeId,\n      type: HandlerType.route,\n      nestLevel,\n      handler: route.handler,\n      pointer: routePointer,\n      methodCaller: callerForType(HandlerType.route),\n      alwaysRun: false,\n      quotedId: JSON.stringify(routeId),\n      ...reflectionData,\n      options: {\n        ...route.options,\n        alwaysRun: false,\n        description: route.options?.description,\n        parser,\n        isMutation: route.options?.isMutation,\n        sanitizeParams: route.options?.sanitizeParams ?? routerOptions.sanitizeParams,\n      },\n    };\n    // the route option as written; the chain resolution overwrites it with the resolved number\n    if (route.options?.maxBodySize !== undefined) executable.options.maxBodySize = route.options.maxBodySize;\n  }\n  routesById.set(routeId, executable);\n  routesCache.setMethodJitFns(routeId, executable as any);\n  return executable;\n}\n\nfunction getPublicMiddlewareIds(methods: RemoteMethod[]): string[] {\n  const ids = methods\n    .filter((exec) => isPublicExecutable(exec))\n    .map((exec) => getRouterItemId(exec.pointer))\n    .filter((mfId) => {\n      if (mionInternalRouteIds.has(mfId)) return false;\n      const exec = getMiddlewareExecutable(mfId);\n      return exec && isPublicExecutable(exec);\n    });\n  return ids;\n}\n\nfunction getEntry(index: number, keyEntryList: RouterKeyEntryList) {\n  return keyEntryList[index]?.[1];\n}\n\nfunction getRouteEntryProperties(\n  minus1: RouterEntry | undefined,\n  zero: RemoteMethod | RoutesWithId,\n  plus1: RouterEntry | undefined\n) {\n  const minus1IsRoute = minus1 && isRoute(minus1);\n  const zeroIsRoute = (zero as RemoteMethod).type === HandlerType.route;\n  const plus1IsRoute = plus1 && isRoute(plus1);\n\n  const isExec = !!(zero as RemoteMethod).handler;\n\n  return {\n    isBetweenRoutes: minus1IsRoute && zeroIsRoute && plus1IsRoute,\n    isExecutable: isExec,\n    isRoute: zeroIsRoute,\n    preLevelMiddlewares: [] as RemoteMethod[],\n    postLevelMiddlewares: [] as RemoteMethod[],\n  };\n}\n\nfunction getExecutablesFromMiddlewaresCollection(\n  middlewaresDef: MiddlewaresCollection\n): (RawMethod | MiddlewareMethod | HeadersMethod)[] {\n  const results: (RawMethod | MiddlewareMethod | HeadersMethod)[] = [];\n  for (const [key, middleware] of Object.entries(middlewaresDef)) {\n    if (isRawMiddlewareDef(middleware)) {\n      results.push(getExecutableFromRawMiddleware(middleware, [key], 0));\n    } else if (isHeadersMiddlewareDef(middleware) || isMiddlewareDef(middleware)) {\n      results.push(getExecutableFromMiddleware(middleware, [key], 0));\n    } else {\n      throw new Error(`Invalid middleware: ${key}. Invalid middleware definition`);\n    }\n  }\n  return results;\n}\n\nfunction validateSharedDataFactory(opts?: Partial<RouterOptions>): void {\n  if (!opts?.sharedDataFactory) return;\n  const testSharedData = opts.sharedDataFactory();\n  if (\n    typeof testSharedData !== 'object' ||\n    Array.isArray(testSharedData) ||\n    testSharedData === null ||\n    Object.keys(testSharedData).length === 0\n  ) {\n    throw new Error('sharedDataFactory must return a plain object with at least one property');\n  }\n}\n\n/** Hand-rolled: Node's 'path' module is not available in edge runtimes. */\nfunction joinPath(...parts: string[]): string {\n  return parts.filter(Boolean).join('/');\n}\n\n// ############# PLATFORM SIZE LIMITS #############\n\n/** What a route takes when its own option is unset and its types cannot say: the adapter's `maxBodySize`,\n *  published with its config at start, else the shared default (a router driven with no adapter, as in tests). */\nexport const getPlatformMaxBodySize = (): number => platformMaxBodySize;\n\n/** The platform's own request ceiling, when the adapter published one. */\nexport const getPlatformRequestCap = (): number | undefined => readMaxBodySizeCap(platformConfig);\n\n/** The largest limit any registered route or batch resolves to: what a platform with ONE native,\n *  server-wide read limit (bun) starts with, so it never refuses a body a route allows. */\nexport function getMaxRouteBodySize(): number {\n  let largest = getPlatformMaxBodySize();\n  for (const chain of flatRouter.values()) largest = Math.max(largest, chain.maxBodySize);\n  return Math.max(largest, getMaxBatchBodySize());\n}\n\n/** The platform's own request ceiling the adapter published, in bytes; undefined means none. */\nfunction readMaxBodySizeCap(config: Record<string, unknown> | undefined): number | undefined {\n  const cap = config?.maxBodySizeCap;\n  return typeof cap === 'number' ? cap : undefined;\n}\n\n/** A limit above the platform's ceiling would promise a size the platform refuses before mion ever runs,\n *  so it is brought down. Applied once, when the adapter has published its config AND the routes are\n *  registered, whichever comes last. */\nfunction applyMaxBodySizeCap(): void {\n  const cap = readMaxBodySizeCap(platformConfig);\n  if (cap === undefined) return;\n  for (const chain of flatRouter.values()) {\n    if (chain.declaredBodySize === undefined || chain.declaredBodySize <= cap) continue;\n    chain.declaredBodySize = cap;\n    const route = chain.methods[chain.routeIndex];\n    if (route.options.maxBodySize !== undefined) route.options.maxBodySize = cap;\n  }\n  capBatchBodySizes(cap);\n}\n\n/** `maxBodySize` caches two inputs that both move after a chain is built: the cap above lowers what a\n *  chain declared, and `setPlatformConfig` replaces the fallback the chains that declared nothing read.\n *  Missing a refresh refuses bodies a route allows, or allows bodies past the platform's ceiling. */\nfunction refreshChainBodyLimits(): void {\n  for (const chain of flatRouter.values()) chain.maxBodySize = chain.declaredBodySize ?? platformMaxBodySize;\n  for (const chain of notFoundChains.values()) chain.maxBodySize = chain.declaredBodySize ?? platformMaxBodySize;\n  refreshBatchChainBodyLimits(platformMaxBodySize);\n}\n\n/** `server` first so the option can replace it, `content-type` last so it cannot; lowercased, or `Headers` would\n *  append a name repeated in another case. */\nfunction mergeResponseDefaults(responseHeaders: Record<string, string>): ResponseDefaults {\n  const merged: Record<string, string> = {server: MION_SERVER_NAME};\n  for (const name in responseHeaders) {\n    // refused at startup, so no adapter ever writes a bad default\n    assertHeaderSafe(name, responseHeaders[name]);\n    merged[name.toLowerCase()] = responseHeaders[name];\n  }\n  merged['content-type'] = JSON_CONTENT_TYPE;\n  return merged;\n}\n"],"mappings":"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"}

package/.dist/esm/src/routes/errors.routes.js

@@ -1,18 +1,18 @@
 import { rawMiddleware, route } from "../lib/handlers.js";
-import { __rt_A0Qb_D32xQCR } from "../../.mion/types/A0Qb_D32xQCR.js";
-import { __rt_A0Qb_G42dZdW } from "../../.mion/types/A0Qb_G42dZdW.js";
-import { __rt_A0Qb_hqa3Nzs } from "../../.mion/types/A0Qb_hqa3Nzs.js";
-import { __rt_Ky89_D32xQCR } from "../../.mion/types/Ky89_D32xQCR.js";
-import { __rt_Ky89_G42dZdW } from "../../.mion/types/Ky89_G42dZdW.js";
-import { __rt_Ky89_hqa3Nzs } from "../../.mion/types/Ky89_hqa3Nzs.js";
-import { __rt_OBOg_D32xQCR } from "../../.mion/types/OBOg_D32xQCR.js";
-import { __rt_OBOg_G42dZdW } from "../../.mion/types/OBOg_G42dZdW.js";
-import { __rt_OBOg_hqa3Nzs } from "../../.mion/types/OBOg_hqa3Nzs.js";
-import { __rt_Xhuv_D32xQCR } from "../../.mion/types/Xhuv_D32xQCR.js";
-import { __rt_Xhuv_G42dZdW } from "../../.mion/types/Xhuv_G42dZdW.js";
-import { __rt_Xhuv_hqa3Nzs } from "../../.mion/types/Xhuv_hqa3Nzs.js";
-import { __rt_mzca_hqa3Nzs } from "../../.mion/types/mzca_hqa3Nzs.js";
-import { __rt_D32xQCR, __rt_G42dZdW, __rt_JWRNzuD, __rt_hqa3Nzs, __rt_jzOWBBT, __rt_w6KmCD1 } from "../../.mion/types/rt/VIdAjpHu1X.js";
+import { __rt_A0Qb_CXFfAul } from "../../.mion/types/A0Qb_CXFfAul.js";
+import { __rt_A0Qb_Ju6MvJU } from "../../.mion/types/A0Qb_Ju6MvJU.js";
+import { __rt_A0Qb_ujMZYNY } from "../../.mion/types/A0Qb_ujMZYNY.js";
+import { __rt_Ky89_CXFfAul } from "../../.mion/types/Ky89_CXFfAul.js";
+import { __rt_Ky89_Ju6MvJU } from "../../.mion/types/Ky89_Ju6MvJU.js";
+import { __rt_Ky89_ujMZYNY } from "../../.mion/types/Ky89_ujMZYNY.js";
+import { __rt_OBOg_CXFfAul } from "../../.mion/types/OBOg_CXFfAul.js";
+import { __rt_OBOg_Ju6MvJU } from "../../.mion/types/OBOg_Ju6MvJU.js";
+import { __rt_OBOg_ujMZYNY } from "../../.mion/types/OBOg_ujMZYNY.js";
+import { __rt_Xhuv_CXFfAul } from "../../.mion/types/Xhuv_CXFfAul.js";
+import { __rt_Xhuv_Ju6MvJU } from "../../.mion/types/Xhuv_Ju6MvJU.js";
+import { __rt_Xhuv_ujMZYNY } from "../../.mion/types/Xhuv_ujMZYNY.js";
+import { __rt_mzca_Ju6MvJU } from "../../.mion/types/mzca_Ju6MvJU.js";
+import { __rt_A0akS8u, __rt_A7jnlIr, __rt_CXFfAul, __rt_Ju6MvJU, __rt_o1EosWH, __rt_ujMZYNY } from "../../.mion/types/rt/VIdAjpHu1X.js";
 import { FatalError, MION_ROUTES, RpcError, StatusCodes } from "@mionjs/core";
 //#region src/routes/errors.routes.ts
 var DEFAULT_WIRE = { parser: {
@@ -24,17 +24,17 @@ var mionErrorsRoutes = {
 	[MION_ROUTES.thrownErrors]: route((ctx) => {
 		return ctx.request.thrownErrors || {};
 	}, DEFAULT_WIRE, [
-		__rt_Xhuv_hqa3Nzs,
-		__rt_OBOg_hqa3Nzs,
-		__rt_mzca_hqa3Nzs,
-		__rt_A0Qb_hqa3Nzs,
-		__rt_Ky89_hqa3Nzs
+		__rt_Xhuv_Ju6MvJU,
+		__rt_OBOg_Ju6MvJU,
+		__rt_mzca_Ju6MvJU,
+		__rt_A0Qb_Ju6MvJU,
+		__rt_Ky89_Ju6MvJU
 	], [
-		__rt_Xhuv_G42dZdW,
-		__rt_OBOg_G42dZdW,
-		__rt_A0Qb_G42dZdW,
-		__rt_Ky89_G42dZdW
-	], __rt_hqa3Nzs, __rt_G42dZdW, __rt_w6KmCD1, __rt_JWRNzuD),
+		__rt_Xhuv_ujMZYNY,
+		__rt_OBOg_ujMZYNY,
+		__rt_A0Qb_ujMZYNY,
+		__rt_Ky89_ujMZYNY
+	], __rt_Ju6MvJU, __rt_ujMZYNY, __rt_A7jnlIr, __rt_o1EosWH),
 	/** Strongly types the errors an adapter raises rather than a handler: before the router sees the request
 	*  (an HTTP server error, a connection issue), or after the route resolved (a body the adapter refused,
 	*  which then runs the chain's alwaysRun members). Registering it also stops a user route taking the name. */
@@ -44,17 +44,17 @@ var mionErrorsRoutes = {
 			type: "platform-error"
 		});
 	}, DEFAULT_WIRE, [
-		__rt_Xhuv_hqa3Nzs,
-		__rt_OBOg_hqa3Nzs,
-		__rt_mzca_hqa3Nzs,
-		__rt_A0Qb_hqa3Nzs,
-		__rt_Ky89_hqa3Nzs
+		__rt_Xhuv_Ju6MvJU,
+		__rt_OBOg_Ju6MvJU,
+		__rt_mzca_Ju6MvJU,
+		__rt_A0Qb_Ju6MvJU,
+		__rt_Ky89_Ju6MvJU
 	], [
-		__rt_Xhuv_D32xQCR,
-		__rt_OBOg_D32xQCR,
-		__rt_A0Qb_D32xQCR,
-		__rt_Ky89_D32xQCR
-	], __rt_hqa3Nzs, __rt_D32xQCR, __rt_w6KmCD1, __rt_jzOWBBT)
+		__rt_Xhuv_CXFfAul,
+		__rt_OBOg_CXFfAul,
+		__rt_A0Qb_CXFfAul,
+		__rt_Ky89_CXFfAul
+	], __rt_Ju6MvJU, __rt_CXFfAul, __rt_A7jnlIr, __rt_A0akS8u)
 };
 /** The first member of each of mion's two not-found chains. It throws, so the dispatcher skips every later
 *  member that does not declare `alwaysRun`: a failed request never reaches a session loader or an auth step.

package/.dist/esm/src/routes/serializer.routes.js

@@ -1,6 +1,7 @@
 import { JSON_CONTENT_TYPE } from "../constants.js";
 import { recordUndeclaredError } from "../lib/dispatchError.js";
 import { rawMiddleware } from "../lib/handlers.js";
+import { decodeQueryBody } from "../lib/queryBody.js";
 import { getRouteExecutable, getRouterOptions } from "../router.js";
 import { FatalError, MION_ROUTES, SerializerModes, StatusCodes, isRpcError } from "@mionjs/core";
 //#region src/routes/serializer.routes.ts
@@ -9,7 +10,8 @@ import { FatalError, MION_ROUTES, SerializerModes, StatusCodes, isRpcError } fro
 * @mion:rawMiddleware
 */
 function deserializeRequestBody(context) {
-	if (!context.readsBody || context.response.hasErrors || !context.request.rawBody) return;
+	if (!context.readsBody || context.response.stopped) return;
+	if (!context.request.rawBody && !readQueryBody(context)) return;
 	rejectOversizedBody(context.request.rawBody, context.maxBodySize);
 	let parsedBody;
 	switch (context.request.bodyType) {
@@ -42,6 +44,15 @@ function deserializeRequestBody(context) {
 	context.request.body = parsedBody;
 	if (getRouterOptions().releaseRawBody) context.request.rawBody = "";
 }
+/** A body-less request may carry its body in `?data=`; every platform hands the query over as it came */
+function readQueryBody(context) {
+	const rawBody = decodeQueryBody(context.urlQuery);
+	if (rawBody === void 0) return false;
+	const request = context.request;
+	request.rawBody = rawBody;
+	request.bodyType = SerializerModes.stringifyJson;
+	return true;
+}
 /** The router-level check of the limit the context carries (the chain's number, capped by the platform's).
 *  The node / uws adapters stopped the read at the same number; this is what holds on a platform that hands
 *  the body over whole. A string is measured in UTF-16 code units, never more than its byte length, so the
@@ -97,7 +108,7 @@ function onPrepareForJsonExecutableError(context, method, e) {
 	const err = new FatalError({
 		statusCode: StatusCodes.UNEXPECTED_ERROR,
 		type: "prepare-for-json-response-error",
-		publicMessage: `Failed to prepare return value for JSON for handler ${method.id}, expected response type: ${method.returnJitFns.json.encode.typeName}`,
+		publicMessage: `Failed to prepare the return value of ${method.id} for JSON.`,
 		originalError: e,
 		errorData: { methodId: method.id }
 	});

package/.dist/esm/src/routes/serializer.routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.routes.js","names":[],"sources":["../../../../src/routes/serializer.routes.ts"],"sourcesContent":["/* ########\n * 2023 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {MionResponse, MionRequest, CallContext, ResponseBody, RawRequestBody} from '../types/context.ts';\nimport {RouterOptions} from '../types/general.ts';\nimport {MiddlewaresCollection, MayReturnError} from '../types/publicMethods.ts';\nimport {AnyObject, Mutable, MION_ROUTES, StatusCodes, SerializerModes} from '@mionjs/core';\nimport {rawMiddleware} from '../lib/handlers.ts';\nimport {JSON_CONTENT_TYPE} from '../constants.ts';\nimport {getRouteExecutable, getRouterOptions} from '../router.ts';\nimport {FatalError, isRpcError} from '@mionjs/core';\nimport {RemoteMethod} from '../types/remoteMethods.ts';\nimport {recordUndeclaredError} from '../lib/dispatchError.ts';\n\n// ############# PUBLIC METHODS #############\n\n/** Runs before any other middleware or route handler. Registered through `rawMiddleware`: it runs before the\n * response contract exists, so it throws rather than answering with a declared error.\n * @mion:rawMiddleware\n */\nexport function deserializeRequestBody(context: CallContext): MayReturnError {\n  // a request that already failed never parses: a not-found chain has no route to feed and the adapter\n  // skipped the read; a caller that handed a body anyway (aws, gcloud, dispatchRoute) gets the same answer\n  if (!context.readsBody || context.response.hasErrors || !context.request.rawBody) return;\n  rejectOversizedBody(context.request.rawBody, context.maxBodySize);\n  let parsedBody: any;\n  switch (context.request.bodyType) {\n    case SerializerModes.stringifyJson: // jit stringify json\n      try {\n        parsedBody = JSON.parse(context.request.rawBody as string);\n      } catch (err: any) {\n        // Fixed text: the engine's parse message (which quotes the offending input) stays on originalError\n        throw new FatalError({\n          statusCode: StatusCodes.UNEXPECTED_ERROR,\n          type: 'parsing-json-request-error',\n          publicMessage: 'Invalid json request body.',\n          originalError: err,\n        });\n      }\n      break;\n    case SerializerModes.json: // Object (pre-parsed body from platforms like Google Cloud Functions where Express auto-parses JSON)\n      parsedBody = context.request.rawBody;\n      break;\n    default:\n      throw new Error(`Invalid body type ${String(context.request.bodyType)}`);\n  }\n  if (Array.isArray(parsedBody)) {\n    // an array body is a single route call, rebuilt as a body: /route1 [p1, p2] => {route1: [p1, p2]}\n    // the chain already knows which member is the route, so this costs no second router lookup\n    const {methods, routeIndex} = context.executionChain;\n    parsedBody = {[methods[routeIndex].id]: parsedBody};\n  }\n  // `null`, `0`, `false` and `\"\"` are valid JSON documents but not a request body\n  if (parsedBody === null || typeof parsedBody !== 'object')\n    throw new FatalError({\n      statusCode: StatusCodes.UNEXPECTED_ERROR,\n      type: 'invalid-request-body',\n      publicMessage: 'Wrong request body. Expecting a body containing the route name and parameters.',\n    });\n  (context.request as Mutable<MionRequest>).body = parsedBody;\n  // Nothing reads the raw body after this. An empty string rather than undefined, because `rawBody` is a\n  // non-optional public field: it frees the body without making every consumer's read a maybe.\n  if (getRouterOptions().releaseRawBody) (context.request as Mutable<MionRequest>).rawBody = '';\n}\n\n/** The router-level check of the limit the context carries (the chain's number, capped by the platform's).\n *  The node / uws adapters stopped the read at the same number; this is what holds on a platform that hands\n *  the body over whole. A string is measured in UTF-16 code units, never more than its byte length, so the\n *  byte-exact adapter limit always fires first. */\nfunction rejectOversizedBody(rawBody: RawRequestBody, maxBodySize: number): void {\n  // A pre-parsed object body has no wire size here and is never refused for being unmeasurable:\n  // `dispatchRoute`, a batch and a test all pass bodies that never crossed a wire. The adapter handing a\n  // parsed body over still has the wire size, so it owns the check (gcloud measures content-length first).\n  if (typeof rawBody !== 'string' || rawBody.length <= maxBodySize) return;\n  throw new FatalError({\n    statusCode: StatusCodes.PAYLOAD_TOO_LARGE,\n    type: 'request-payload-too-large',\n    publicMessage: 'Payload Too Large',\n  });\n}\n\n/** Runs after any other middleware or route handler. Registered through `rawMiddleware`: it IS the layer that\n * writes the answer, so it has no declared error to return and throws instead.\n * @mion:rawMiddleware\n */\nexport function serializeResponseBody(context: CallContext, opts: RouterOptions): MayReturnError {\n  const response = context.response as Mutable<MionResponse>;\n  const respBody: AnyObject = response.body;\n  // prepareBodyForJson mutates in place; the adapter stringifies the body\n  response.contentType = JSON_CONTENT_TYPE;\n  prepareBodyForJson(context, context.executionChain.methods, respBody);\n}\n\n/** A mistyped handler's undeclared error stays raw JSON: the success encoder would mangle it, the client reads its brand. */\nfunction isUndeclaredError(method: RemoteMethod, value: unknown): boolean {\n  return isRpcError(value) && !method.returnJitFns.isType.fn(value);\n}\n\nfunction prepareBodyForJson(context: CallContext, executionChain: RemoteMethod[], respBody: ResponseBody): void {\n  for (let i = 0; i < executionChain.length; i++) {\n    const method = executionChain[i];\n    // own key only: a skipped member named like `toString` would otherwise encode Object.prototype's function\n    if (!method.hasReturnData || !Object.hasOwn(respBody, method.id)) continue;\n    const returnValue = respBody[method.id];\n    if (typeof returnValue === 'undefined') continue;\n    try {\n      const preparedValue = prepareHandlerReturnValue(method, returnValue);\n      if (preparedValue !== undefined) (respBody as Mutable<ResponseBody>)[method.id] = preparedValue;\n    } catch (e: any) {\n      onPrepareForJsonExecutableError(context, method, e);\n    }\n  }\n  // read off the request after the loop: a failure inside it creates the map when it is the first error\n  const thrownErrors = context.request.thrownErrors;\n  if (thrownErrors) {\n    (respBody as Mutable<ResponseBody>)['@thrownErrors'] = thrownErrors;\n    const method = getRouteExecutable(MION_ROUTES.thrownErrors)!;\n    try {\n      const preparedValue = prepareHandlerReturnValue(method, thrownErrors);\n      if (preparedValue !== undefined) (respBody as Mutable<ResponseBody>)[method.id] = preparedValue;\n    } catch (e: any) {\n      onPrepareForJsonExecutableError(context, method, e);\n    }\n  }\n}\n\nfunction onPrepareForJsonExecutableError(context: CallContext, method: RemoteMethod, e: any) {\n  const err = new FatalError({\n    statusCode: StatusCodes.UNEXPECTED_ERROR,\n    type: 'prepare-for-json-response-error',\n    publicMessage: `Failed to prepare return value for JSON for handler ${method.id}, expected response type: ${method.returnJitFns.json.encode.typeName}`,\n    originalError: e,\n    errorData: {methodId: method.id},\n  });\n  recordUndeclaredError(context, method.id, err);\n}\n\nfunction prepareHandlerReturnValue(method: RemoteMethod, returnValue: any): any {\n  if (!method.hasReturnData) return undefined;\n  const {json} = method.returnJitFns;\n  // an undeclared error is left as it is: the platform's JSON.stringify writes its own fields\n  if (json.encode.isNoop || isUndeclaredError(method, returnValue)) return returnValue;\n  return json.encode.fn(returnValue);\n}\n\nconst SERIALIZE_RESPONSE_ID = 'mionSerializeResponse';\n\nexport const serializerMiddlewares = {\n  mionDeserializeRequest: rawMiddleware(deserializeRequestBody, {alwaysRun: true}),\n  [SERIALIZE_RESPONSE_ID]: rawMiddleware(serializeResponseBody, {alwaysRun: true}),\n} satisfies MiddlewaresCollection;\n"],"mappings":"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"}
+{"version":3,"file":"serializer.routes.js","names":[],"sources":["../../../../src/routes/serializer.routes.ts"],"sourcesContent":["/* ########\n * 2023 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {MionResponse, MionRequest, CallContext, ResponseBody, RawRequestBody} from '../types/context.ts';\nimport {RouterOptions} from '../types/general.ts';\nimport {MiddlewaresCollection, MayReturnError} from '../types/publicMethods.ts';\nimport {AnyObject, Mutable, MION_ROUTES, StatusCodes, SerializerModes} from '@mionjs/core';\nimport {rawMiddleware} from '../lib/handlers.ts';\nimport {JSON_CONTENT_TYPE} from '../constants.ts';\nimport {getRouteExecutable, getRouterOptions} from '../router.ts';\nimport {FatalError, isRpcError} from '@mionjs/core';\nimport {RemoteMethod} from '../types/remoteMethods.ts';\nimport {recordUndeclaredError} from '../lib/dispatchError.ts';\nimport {decodeQueryBody} from '../lib/queryBody.ts';\n\n// ############# PUBLIC METHODS #############\n\n/** Runs before any other middleware or route handler. Registered through `rawMiddleware`: it runs before the\n * response contract exists, so it throws rather than answering with a declared error.\n * @mion:rawMiddleware\n */\nexport function deserializeRequestBody(context: CallContext): MayReturnError {\n  // a request that already failed or ended never parses: a not-found chain has no route to feed and the adapter\n  // skipped the read; a caller that handed a body anyway (aws, gcloud, dispatchRoute) gets the same answer\n  if (!context.readsBody || context.response.stopped) return;\n  if (!context.request.rawBody && !readQueryBody(context)) return;\n  rejectOversizedBody(context.request.rawBody, context.maxBodySize);\n  let parsedBody: any;\n  switch (context.request.bodyType) {\n    case SerializerModes.stringifyJson: // jit stringify json\n      try {\n        parsedBody = JSON.parse(context.request.rawBody as string);\n      } catch (err: any) {\n        // Fixed text: the engine's parse message (which quotes the offending input) stays on originalError\n        throw new FatalError({\n          statusCode: StatusCodes.UNEXPECTED_ERROR,\n          type: 'parsing-json-request-error',\n          publicMessage: 'Invalid json request body.',\n          originalError: err,\n        });\n      }\n      break;\n    case SerializerModes.json: // Object (pre-parsed body from platforms like Google Cloud Functions where Express auto-parses JSON)\n      parsedBody = context.request.rawBody;\n      break;\n    default:\n      throw new Error(`Invalid body type ${String(context.request.bodyType)}`);\n  }\n  if (Array.isArray(parsedBody)) {\n    // an array body is a single route call, rebuilt as a body: /route1 [p1, p2] => {route1: [p1, p2]}\n    // the chain already knows which member is the route, so this costs no second router lookup\n    const {methods, routeIndex} = context.executionChain;\n    parsedBody = {[methods[routeIndex].id]: parsedBody};\n  }\n  // `null`, `0`, `false` and `\"\"` are valid JSON documents but not a request body\n  if (parsedBody === null || typeof parsedBody !== 'object')\n    throw new FatalError({\n      statusCode: StatusCodes.UNEXPECTED_ERROR,\n      type: 'invalid-request-body',\n      publicMessage: 'Wrong request body. Expecting a body containing the route name and parameters.',\n    });\n  (context.request as Mutable<MionRequest>).body = parsedBody;\n  // Nothing reads the raw body after this. An empty string rather than undefined, because `rawBody` is a\n  // non-optional public field: it frees the body without making every consumer's read a maybe.\n  if (getRouterOptions().releaseRawBody) (context.request as Mutable<MionRequest>).rawBody = '';\n}\n\n/** A body-less request may carry its body in `?data=`; every platform hands the query over as it came */\nfunction readQueryBody(context: CallContext): boolean {\n  const rawBody = decodeQueryBody(context.urlQuery);\n  if (rawBody === undefined) return false;\n  const request = context.request as Mutable<MionRequest>;\n  request.rawBody = rawBody;\n  request.bodyType = SerializerModes.stringifyJson;\n  return true;\n}\n\n/** The router-level check of the limit the context carries (the chain's number, capped by the platform's).\n *  The node / uws adapters stopped the read at the same number; this is what holds on a platform that hands\n *  the body over whole. A string is measured in UTF-16 code units, never more than its byte length, so the\n *  byte-exact adapter limit always fires first. */\nfunction rejectOversizedBody(rawBody: RawRequestBody, maxBodySize: number): void {\n  // A pre-parsed object body has no wire size here and is never refused for being unmeasurable:\n  // `dispatchRoute`, a batch and a test all pass bodies that never crossed a wire. The adapter handing a\n  // parsed body over still has the wire size, so it owns the check (gcloud measures content-length first).\n  if (typeof rawBody !== 'string' || rawBody.length <= maxBodySize) return;\n  throw new FatalError({\n    statusCode: StatusCodes.PAYLOAD_TOO_LARGE,\n    type: 'request-payload-too-large',\n    publicMessage: 'Payload Too Large',\n  });\n}\n\n/** Runs after any other middleware or route handler. Registered through `rawMiddleware`: it IS the layer that\n * writes the answer, so it has no declared error to return and throws instead.\n * @mion:rawMiddleware\n */\nexport function serializeResponseBody(context: CallContext, opts: RouterOptions): MayReturnError {\n  const response = context.response as Mutable<MionResponse>;\n  const respBody: AnyObject = response.body;\n  // prepareBodyForJson mutates in place; the adapter stringifies the body\n  response.contentType = JSON_CONTENT_TYPE;\n  prepareBodyForJson(context, context.executionChain.methods, respBody);\n}\n\n/** A mistyped handler's undeclared error stays raw JSON: the success encoder would mangle it, the client reads its brand. */\nfunction isUndeclaredError(method: RemoteMethod, value: unknown): boolean {\n  return isRpcError(value) && !method.returnJitFns.isType.fn(value);\n}\n\nfunction prepareBodyForJson(context: CallContext, executionChain: RemoteMethod[], respBody: ResponseBody): void {\n  for (let i = 0; i < executionChain.length; i++) {\n    const method = executionChain[i];\n    // own key only: a skipped member named like `toString` would otherwise encode Object.prototype's function\n    if (!method.hasReturnData || !Object.hasOwn(respBody, method.id)) continue;\n    const returnValue = respBody[method.id];\n    if (typeof returnValue === 'undefined') continue;\n    try {\n      const preparedValue = prepareHandlerReturnValue(method, returnValue);\n      if (preparedValue !== undefined) (respBody as Mutable<ResponseBody>)[method.id] = preparedValue;\n    } catch (e: any) {\n      onPrepareForJsonExecutableError(context, method, e);\n    }\n  }\n  // read off the request after the loop: a failure inside it creates the map when it is the first error\n  const thrownErrors = context.request.thrownErrors;\n  if (thrownErrors) {\n    (respBody as Mutable<ResponseBody>)['@thrownErrors'] = thrownErrors;\n    const method = getRouteExecutable(MION_ROUTES.thrownErrors)!;\n    try {\n      const preparedValue = prepareHandlerReturnValue(method, thrownErrors);\n      if (preparedValue !== undefined) (respBody as Mutable<ResponseBody>)[method.id] = preparedValue;\n    } catch (e: any) {\n      onPrepareForJsonExecutableError(context, method, e);\n    }\n  }\n}\n\nfunction onPrepareForJsonExecutableError(context: CallContext, method: RemoteMethod, e: any) {\n  const err = new FatalError({\n    statusCode: StatusCodes.UNEXPECTED_ERROR,\n    type: 'prepare-for-json-response-error',\n    // the return type's name is the server's own: it stays off the wire\n    publicMessage: `Failed to prepare the return value of ${method.id} for JSON.`,\n    originalError: e,\n    errorData: {methodId: method.id},\n  });\n  recordUndeclaredError(context, method.id, err);\n}\n\nfunction prepareHandlerReturnValue(method: RemoteMethod, returnValue: any): any {\n  if (!method.hasReturnData) return undefined;\n  const {json} = method.returnJitFns;\n  // an undeclared error is left as it is: the platform's JSON.stringify writes its own fields\n  if (json.encode.isNoop || isUndeclaredError(method, returnValue)) return returnValue;\n  return json.encode.fn(returnValue);\n}\n\nconst SERIALIZE_RESPONSE_ID = 'mionSerializeResponse';\n\nexport const serializerMiddlewares = {\n  mionDeserializeRequest: rawMiddleware(deserializeRequestBody, {alwaysRun: true}),\n  [SERIALIZE_RESPONSE_ID]: rawMiddleware(serializeResponseBody, {alwaysRun: true}),\n} satisfies MiddlewaresCollection;\n"],"mappings":"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"}

package/.dist/esm/src/types/context.d.ts

@@ -1,10 +1,10 @@
 import { AnyObject, SerializerCode, RpcError } from '@mionjs/core';
 import { MethodsExecutionChain } from './remoteMethods.ts';
-export interface CallContext<ContextData extends Record<string, any> = any> {
+export interface CallContext<SharedData extends Record<string, any> = any> {
     readonly path: string;
     readonly request: MionRequest;
     readonly response: MionResponse;
-    shared: ContextData;
+    shared: SharedData;
     readonly executionChain: MethodsExecutionChain;
     readonly maxBodySize: number;
     readonly readsBody: boolean;
@@ -13,7 +13,9 @@ export interface CallContext<ContextData extends Record<string, any> = any> {
     readonly batchRouteIds?: string[];
 }
 export type RawRequestBody = string | AnyObject;
+export type HttpMethod = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH' | 'QUERY' | 'OTHER';
 export interface MionRequest {
+    readonly method: HttpMethod;
     readonly headers: Readonly<Omit<MionHeaders, 'append' | 'set' | 'delete'>>;
     readonly rawBody: RawRequestBody;
     readonly bodyType: SerializerCode;
@@ -26,6 +28,7 @@ export interface MionResponse {
     readonly headers: Readonly<MionHeaders>;
     readonly body: Readonly<ResponseBody>;
     readonly hasErrors: boolean;
+    readonly stopped: boolean;
     readonly fatalError?: RpcError<string>;
 }
 export type ResponseDefaults = Readonly<Record<string, string>>;
@@ -43,7 +46,7 @@ export interface MionHeaders {
     keys(): IterableIterator<string>;
     values(): IterableIterator<string>;
 }
-export type ContextDataFactory<ContextData extends Record<string, any>> = () => ContextData;
+export type SharedDataFactory<SharedData extends Record<string, any>> = () => SharedData;
 export interface ResponseBody extends Record<string, any> {
     '@thrownErrors'?: Record<string, RpcError<string>>;
 }

package/.dist/esm/src/types/definitions.d.ts

@@ -3,21 +3,21 @@ import { HandlerType, RtMarkerPayload } from '@mionjs/core';
 import { HeadersMiddlewareOptions, MiddlewareOptions, RawMiddlewareOptions, RouteOptions } from './remoteMethods.ts';
 import { RouterOptions } from './general.ts';
 export type DeclaredRouterOptions = Partial<RouterOptions>;
-export interface RouteDef<H extends Handler = any, RO extends RouteOptions = RouteOptions, O extends DeclaredRouterOptions = DeclaredRouterOptions> {
+export interface RouteDef<H extends Handler = any, RO extends object = RouteOptions, O extends DeclaredRouterOptions = DeclaredRouterOptions> {
     type: typeof HandlerType.route;
     handler: H;
     options?: RO;
     rtFns?: RtMarkerPayload;
     readonly routerOptions?: O;
 }
-export interface MiddlewareDef<H extends Handler = any, RO extends MiddlewareOptions = MiddlewareOptions, O extends DeclaredRouterOptions = DeclaredRouterOptions> {
+export interface MiddlewareDef<H extends Handler = any, RO extends object = MiddlewareOptions, O extends DeclaredRouterOptions = DeclaredRouterOptions> {
     type: typeof HandlerType.middleware;
     handler: H;
     options?: RO;
     rtFns?: RtMarkerPayload;
     readonly routerOptions?: O;
 }
-export interface HeadersMiddlewareDef<H extends HeaderHandler = any, RO extends HeadersMiddlewareOptions = HeadersMiddlewareOptions, O extends DeclaredRouterOptions = DeclaredRouterOptions> {
+export interface HeadersMiddlewareDef<H extends HeaderHandler = any, RO extends object = HeadersMiddlewareOptions, O extends DeclaredRouterOptions = DeclaredRouterOptions> {
     type: typeof HandlerType.headersMiddleware;
     handler: H;
     options?: RO;
@@ -30,4 +30,6 @@ export interface RawMiddlewareDef<H extends RawMiddlewareHandler = any> {
     options?: RawMiddlewareOptions;
 }
 export type AnyHandlerDef = RouteDef | MiddlewareDef | HeadersMiddlewareDef | RawMiddlewareDef;
+export type AnyMiddlewareDef = MiddlewareDef<any, object>;
+export type AnyHeadersMiddlewareDef = HeadersMiddlewareDef<any, object>;
 //# sourceMappingURL=definitions.d.ts.map

package/.dist/esm/src/types/general.d.ts

@@ -1,16 +1,16 @@
 import { CoreRouterOptions, ParserOption } from '@mionjs/core';
-import { ContextDataFactory } from './context.ts';
-import { HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef, RouteDef } from './definitions.ts';
+import { CallContext, SharedDataFactory } from './context.ts';
+import { AnyHeadersMiddlewareDef, AnyMiddlewareDef, RawMiddlewareDef, RouteDef } from './definitions.ts';
 export type Route = RouteDef;
-export type RouterEntry = Routes | MiddlewareDef | RouteDef | RawMiddlewareDef | HeadersMiddlewareDef;
+export type RouterEntry = Routes | AnyMiddlewareDef | RouteDef<any, object> | RawMiddlewareDef | AnyHeadersMiddlewareDef;
 export interface Routes {
     [key: string]: RouterEntry;
 }
-export interface RouterOptions<Req = any, ContextData extends Record<string, any> = any> extends CoreRouterOptions {
+export interface RouterOptions<Req = any, SharedData extends Record<string, any> = any> extends CoreRouterOptions {
     basePath: string;
     suffix: string;
     pathTransform?: (request: Req, path: string) => string;
-    contextDataFactory?: ContextDataFactory<ContextData>;
+    sharedDataFactory?: SharedDataFactory<SharedData>;
     parser?: ParserOption;
     sanitizeParams?: boolean;
     getPublicRoutesData: boolean;
@@ -26,4 +26,23 @@ export interface HostRequestHandler {
     node?(req: unknown, res: unknown): void;
     fetch?(req: Request): Response | Promise<Response>;
 }
+export interface MionSecurityOptions {
+    origins?: readonly string[] | '*' | ((ctx: CallContext, origin: string) => boolean | Promise<boolean>);
+    cors?: false | MionCorsSettings;
+    csrf?: false | MionCsrfSettings;
+}
+export interface MionSecurityHandlerOptions {
+    cors?: false;
+}
+export interface MionCorsSettings {
+    credentials?: boolean;
+    maxAge?: number;
+    allowHeaders?: string[];
+    exposeHeaders?: string[];
+    excludeHeaders?: string[];
+}
+export interface MionCsrfSettings {
+    crossOrigin?: boolean;
+    methodByIntent?: boolean;
+}
 //# sourceMappingURL=general.d.ts.map

package/.dist/esm/src/types/guards.d.ts

@@ -1,7 +1,6 @@
-import { HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef, RouteDef } from './definitions.ts';
+import { HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef } from './definitions.ts';
 import { Route, RouterEntry, Routes } from './general.ts';
-import { RawMethod, HeadersMethod, RouteMethod, RemoteMethod } from './remoteMethods.ts';
-export declare function isRouteDef(entry: RouterEntry): entry is RouteDef;
+import { RemoteMethod } from './remoteMethods.ts';
 export declare function isMiddlewareDef(entry: RouterEntry): entry is MiddlewareDef;
 export declare function isRawMiddlewareDef(entry: RouterEntry): entry is RawMiddlewareDef;
 export declare function isHeadersMiddlewareDef(entry: RouterEntry): entry is HeadersMiddlewareDef;
@@ -11,8 +10,5 @@ export declare function isRoutes(entry: RouterEntry | Routes): entry is Routes;
 export declare function isExecutable(entry: RemoteMethod | {
     pathPointer: string[];
 }): entry is RemoteMethod;
-export declare function isRawExecutable(entry: RemoteMethod): entry is RawMethod;
 export declare function isPublicExecutable(executable: RemoteMethod): boolean;
-export declare function isHeaderExecutable(entry: RemoteMethod): entry is HeadersMethod;
-export declare function isRouteExecutable(entry: RemoteMethod): entry is RouteMethod;
 //# sourceMappingURL=guards.d.ts.map

package/.dist/esm/src/types/guards.js

@@ -1,8 +1,5 @@
 import { HandlerType } from "@mionjs/core";
 //#region src/types/guards.ts
-function isRouteDef(entry) {
-	return entry.type === HandlerType.route;
-}
 function isMiddlewareDef(entry) {
 	return entry.type === HandlerType.middleware;
 }
@@ -24,9 +21,6 @@ function isRoutes(entry) {
 function isExecutable(entry) {
 	return typeof entry?.id === "string" && typeof entry.handler === "function";
 }
-function isRawExecutable(entry) {
-	return entry.type === HandlerType.rawMiddleware;
-}
 /** What the metadata route exposes: whatever the client must encode or decode. NOT access control. */
 function isPublicExecutable(executable) {
 	if (executable.type === HandlerType.rawMiddleware) return false;
@@ -35,13 +29,7 @@ function isPublicExecutable(executable) {
 	const hasHeaderParams = !!executable.headersParam?.headerNames?.length;
 	return hasPublicParams || hasHeaderParams || executable.hasReturnData;
 }
-function isHeaderExecutable(entry) {
-	return entry.type === HandlerType.headersMiddleware;
-}
-function isRouteExecutable(entry) {
-	return entry.type === HandlerType.route;
-}
 //#endregion
-export { isAnyMiddlewareDef, isExecutable, isHeaderExecutable, isHeadersMiddlewareDef, isMiddlewareDef, isPublicExecutable, isRawExecutable, isRawMiddlewareDef, isRoute, isRouteDef, isRouteExecutable, isRoutes };
+export { isAnyMiddlewareDef, isExecutable, isHeadersMiddlewareDef, isMiddlewareDef, isPublicExecutable, isRawMiddlewareDef, isRoute, isRoutes };
 
 //# sourceMappingURL=guards.js.map

package/.dist/esm/src/types/guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"guards.js","names":[],"sources":["../../../../src/types/guards.ts"],"sourcesContent":["/* ########\n * 2023 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef, RouteDef} from './definitions.ts';\nimport {Route, RouterEntry, Routes} from './general.ts';\nimport {RawMethod} from './remoteMethods.ts';\nimport {HeadersMethod} from './remoteMethods.ts';\nimport {RouteMethod} from './remoteMethods.ts';\nimport {RemoteMethod} from './remoteMethods.ts';\nimport {HandlerType} from '@mionjs/core';\n\n// #######  type guards #######\n\nexport function isRouteDef(entry: RouterEntry): entry is RouteDef {\n  return entry.type === HandlerType.route;\n}\n\nexport function isMiddlewareDef(entry: RouterEntry): entry is MiddlewareDef {\n  return entry.type === HandlerType.middleware;\n}\n\nexport function isRawMiddlewareDef(entry: RouterEntry): entry is RawMiddlewareDef {\n  return entry.type === HandlerType.rawMiddleware;\n}\n\nexport function isHeadersMiddlewareDef(entry: RouterEntry): entry is HeadersMiddlewareDef {\n  return entry.type === HandlerType.headersMiddleware;\n}\n\nexport function isAnyMiddlewareDef(entry: RouterEntry): entry is HeadersMiddlewareDef | MiddlewareDef | RawMiddlewareDef {\n  return isMiddlewareDef(entry) || isRawMiddlewareDef(entry) || isHeadersMiddlewareDef(entry);\n}\n\nexport function isRoute(entry: RouterEntry): entry is Route {\n  return entry.type === HandlerType.route;\n}\n\nexport function isRoutes(entry: RouterEntry | Routes): entry is Routes {\n  return typeof entry === 'object';\n}\n\nexport function isExecutable(entry: RemoteMethod | {pathPointer: string[]}): entry is RemoteMethod {\n  return typeof (entry as RemoteMethod)?.id === 'string' && typeof (entry as RemoteMethod).handler === 'function';\n}\nexport function isRawExecutable(entry: RemoteMethod): entry is RawMethod {\n  return entry.type === HandlerType.rawMiddleware;\n}\n\n/** What the metadata route exposes: whatever the client must encode or decode. NOT access control. */\nexport function isPublicExecutable(executable: RemoteMethod): boolean {\n  if (executable.type === HandlerType.rawMiddleware) return false;\n  if (executable.type === HandlerType.route) return true;\n  const hasPublicParams = !!executable.paramsCount;\n  const hasHeaderParams = !!(executable as HeadersMethod).headersParam?.headerNames?.length;\n  return hasPublicParams || hasHeaderParams || executable.hasReturnData;\n}\n\nexport function isHeaderExecutable(entry: RemoteMethod): entry is HeadersMethod {\n  return entry.type === HandlerType.headersMiddleware;\n}\n\nexport function isRouteExecutable(entry: RemoteMethod): entry is RouteMethod {\n  return entry.type === HandlerType.route;\n}\n"],"mappings":";;AAiBA,SAAgB,WAAW,OAAuC;CAChE,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,gBAAgB,OAA4C;CAC1E,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,mBAAmB,OAA+C;CAChF,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,uBAAuB,OAAmD;CACxF,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,mBAAmB,OAAsF;CACvH,OAAO,gBAAgB,KAAK,KAAK,mBAAmB,KAAK,KAAK,uBAAuB,KAAK;AAC5F;AAEA,SAAgB,QAAQ,OAAoC;CAC1D,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,SAAS,OAA8C;CACrE,OAAO,OAAO,UAAU;AAC1B;AAEA,SAAgB,aAAa,OAAsE;CACjG,OAAO,OAAQ,OAAwB,OAAO,YAAY,OAAQ,MAAuB,YAAY;AACvG;AACA,SAAgB,gBAAgB,OAAyC;CACvE,OAAO,MAAM,SAAS,YAAY;AACpC;;AAGA,SAAgB,mBAAmB,YAAmC;CACpE,IAAI,WAAW,SAAS,YAAY,eAAe,OAAO;CAC1D,IAAI,WAAW,SAAS,YAAY,OAAO,OAAO;CAClD,MAAM,kBAAkB,CAAC,CAAC,WAAW;CACrC,MAAM,kBAAkB,CAAC,CAAE,WAA6B,cAAc,aAAa;CACnF,OAAO,mBAAmB,mBAAmB,WAAW;AAC1D;AAEA,SAAgB,mBAAmB,OAA6C;CAC9E,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,kBAAkB,OAA2C;CAC3E,OAAO,MAAM,SAAS,YAAY;AACpC"}
+{"version":3,"file":"guards.js","names":[],"sources":["../../../../src/types/guards.ts"],"sourcesContent":["/* ########\n * 2023 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef} from './definitions.ts';\nimport {Route, RouterEntry, Routes} from './general.ts';\nimport {HeadersMethod} from './remoteMethods.ts';\nimport {RemoteMethod} from './remoteMethods.ts';\nimport {HandlerType} from '@mionjs/core';\n\n// #######  type guards #######\n\nexport function isMiddlewareDef(entry: RouterEntry): entry is MiddlewareDef {\n  return entry.type === HandlerType.middleware;\n}\n\nexport function isRawMiddlewareDef(entry: RouterEntry): entry is RawMiddlewareDef {\n  return entry.type === HandlerType.rawMiddleware;\n}\n\nexport function isHeadersMiddlewareDef(entry: RouterEntry): entry is HeadersMiddlewareDef {\n  return entry.type === HandlerType.headersMiddleware;\n}\n\nexport function isAnyMiddlewareDef(entry: RouterEntry): entry is HeadersMiddlewareDef | MiddlewareDef | RawMiddlewareDef {\n  return isMiddlewareDef(entry) || isRawMiddlewareDef(entry) || isHeadersMiddlewareDef(entry);\n}\n\nexport function isRoute(entry: RouterEntry): entry is Route {\n  return entry.type === HandlerType.route;\n}\n\nexport function isRoutes(entry: RouterEntry | Routes): entry is Routes {\n  return typeof entry === 'object';\n}\n\nexport function isExecutable(entry: RemoteMethod | {pathPointer: string[]}): entry is RemoteMethod {\n  return typeof (entry as RemoteMethod)?.id === 'string' && typeof (entry as RemoteMethod).handler === 'function';\n}\n/** What the metadata route exposes: whatever the client must encode or decode. NOT access control. */\nexport function isPublicExecutable(executable: RemoteMethod): boolean {\n  if (executable.type === HandlerType.rawMiddleware) return false;\n  if (executable.type === HandlerType.route) return true;\n  const hasPublicParams = !!executable.paramsCount;\n  const hasHeaderParams = !!(executable as HeadersMethod).headersParam?.headerNames?.length;\n  return hasPublicParams || hasHeaderParams || executable.hasReturnData;\n}\n"],"mappings":";;AAeA,SAAgB,gBAAgB,OAA4C;CAC1E,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,mBAAmB,OAA+C;CAChF,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,uBAAuB,OAAmD;CACxF,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,mBAAmB,OAAsF;CACvH,OAAO,gBAAgB,KAAK,KAAK,mBAAmB,KAAK,KAAK,uBAAuB,KAAK;AAC5F;AAEA,SAAgB,QAAQ,OAAoC;CAC1D,OAAO,MAAM,SAAS,YAAY;AACpC;AAEA,SAAgB,SAAS,OAA8C;CACrE,OAAO,OAAO,UAAU;AAC1B;AAEA,SAAgB,aAAa,OAAsE;CACjG,OAAO,OAAQ,OAAwB,OAAO,YAAY,OAAQ,MAAuB,YAAY;AACvG;;AAEA,SAAgB,mBAAmB,YAAmC;CACpE,IAAI,WAAW,SAAS,YAAY,eAAe,OAAO;CAC1D,IAAI,WAAW,SAAS,YAAY,OAAO,OAAO;CAClD,MAAM,kBAAkB,CAAC,CAAC,WAAW;CACrC,MAAM,kBAAkB,CAAC,CAAE,WAA6B,cAAc,aAAa;CACnF,OAAO,mBAAmB,mBAAmB,WAAW;AAC1D"}