@mionjs/router 0.8.8 → 0.13.0

package/.dist/esm/src/middlewares/syncRoutes.js

@@ -0,0 +1,66 @@
+import { middleware, mionInternalRouteIds } from "../lib/handlers.js";
+import { getRouteExecutable } from "../router.js";
+import { getMethodsDataFor } from "./fetchMetadata.js";
+import { __rt_A0Qb_D5PMNNO } from "../../.mion/types/A0Qb_D5PMNNO.js";
+import { __rt_A0Qb_kibOHkN } from "../../.mion/types/A0Qb_kibOHkN.js";
+import { __rt_Ky89_D5PMNNO } from "../../.mion/types/Ky89_D5PMNNO.js";
+import { __rt_Ky89_kibOHkN } from "../../.mion/types/Ky89_kibOHkN.js";
+import { __rt_Xhuv_D5PMNNO } from "../../.mion/types/Xhuv_D5PMNNO.js";
+import { __rt_OBOg_D5PMNNO } from "../../.mion/types/OBOg_D5PMNNO.js";
+import { __rt_OBOg_kibOHkN } from "../../.mion/types/OBOg_kibOHkN.js";
+import { __rt_Xhuv_kibOHkN } from "../../.mion/types/Xhuv_kibOHkN.js";
+import { __rt_mzca_kibOHkN } from "../../.mion/types/mzca_kibOHkN.js";
+import { __rt_D5PMNNO, __rt_RzooVQg, __rt_kibOHkN, __rt_w6KmCD1 } from "../../.mion/types/rt/C7ezVBCtGn.js";
+import { FatalError } from "@mionjs/core";
+//#region src/middlewares/syncRoutes.ts
+/** Refuses a call whose route sync ids are missing or differ, before any route runs. */
+function syncRoutes(ctx, routeSyncIds) {
+	const routes = getCalledRoutes(ctx);
+	const mismatched = [];
+	let missing = false;
+	for (let i = 0; i < routes.length; i++) {
+		const sent = routeSyncIds?.[i];
+		if (!sent) missing = true;
+		else if (sent !== routes[i].syncId) mismatched.push(routes[i].id);
+	}
+	if (mismatched.length) return new FatalError({
+		type: "route-types-mismatch",
+		publicMessage: `The types of ${mismatched.map((id) => `"${id}"`).join(", ")} changed on the server since this client was built. Reload the app or rebuild the client against the current API.`,
+		errorData: { routeIds: mismatched }
+	});
+	if (missing) return new FatalError({
+		type: "route-sync-required",
+		publicMessage: "This server checks each route before running it: send the route sync ids along with the call.",
+		errorData: { metadata: getMethodsDataFor(routes.map((route) => route.id)) }
+	});
+}
+/** The routes a call runs, in call order; mion's own routes are never checked. */
+function getCalledRoutes(ctx) {
+	if (ctx.batchRouteIds) return ctx.batchRouteIds.map((id) => getRouteExecutable(id));
+	const { executionChain } = ctx;
+	const route = executionChain.methods[executionChain.routeIndex];
+	if (!route || mionInternalRouteIds.has(route.id)) return [];
+	return [route];
+}
+var mionSyncRoutes = middleware(syncRoutes, {
+	parser: {
+		params: "clone",
+		return: "clone"
+	},
+	maxBodySize: 1024
+}, [
+	__rt_Xhuv_kibOHkN,
+	__rt_OBOg_kibOHkN,
+	__rt_mzca_kibOHkN,
+	__rt_A0Qb_kibOHkN,
+	__rt_Ky89_kibOHkN
+], [
+	__rt_Xhuv_D5PMNNO,
+	__rt_OBOg_D5PMNNO,
+	__rt_A0Qb_D5PMNNO,
+	__rt_Ky89_D5PMNNO
+], __rt_kibOHkN, __rt_D5PMNNO, __rt_w6KmCD1, __rt_RzooVQg);
+//#endregion
+export { mionSyncRoutes };
+
+//# sourceMappingURL=syncRoutes.js.map

package/.dist/esm/src/middlewares/syncRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncRoutes.js","names":[],"sources":["../../../../src/middlewares/syncRoutes.ts"],"sourcesContent":["/* ########\n * 2026 mion\n * Author: Ma-jerez\n * License: MIT\n * The software is provided \"as is\", without warranty of any kind.\n * ######## */\n\nimport {FatalError} from '@mionjs/core';\nimport type {RouteSyncError, RouteSyncErrorData, SyncRoutesHandler} from '@mionjs/core/middlewares';\nimport {middleware, mionInternalRouteIds} from '../lib/handlers.ts';\nimport {getRouteExecutable} from '../router.ts';\nimport {getMethodsDataFor} from './fetchMetadata.ts';\nimport type {RemoteMethod} from '../types/remoteMethods.ts';\nimport type {CallContext} from '../types/context.ts';\n\n/** Refuses a call whose route sync ids are missing or differ, before any route runs. */\nfunction syncRoutes(ctx: CallContext, routeSyncIds?: string[]): RouteSyncError | void {\n  const routes = getCalledRoutes(ctx);\n  const mismatched: string[] = [];\n  let missing = false;\n  for (let i = 0; i < routes.length; i++) {\n    const sent = routeSyncIds?.[i];\n    if (!sent) missing = true;\n    else if (sent !== routes[i].syncId) mismatched.push(routes[i].id);\n  }\n  if (mismatched.length) {\n    return new FatalError<'route-types-mismatch', RouteSyncErrorData>({\n      type: 'route-types-mismatch',\n      publicMessage:\n        `The types of ${mismatched.map((id) => `\"${id}\"`).join(', ')} changed on the server since this client was built. ` +\n        `Reload the app or rebuild the client against the current API.`,\n      errorData: {routeIds: mismatched},\n    });\n  }\n  if (missing) {\n    return new FatalError<'route-sync-required', RouteSyncErrorData>({\n      type: 'route-sync-required',\n      publicMessage: 'This server checks each route before running it: send the route sync ids along with the call.',\n      errorData: {metadata: getMethodsDataFor(routes.map((route) => route.id))},\n    });\n  }\n}\n\n/** The routes a call runs, in call order; mion's own routes are never checked. */\nfunction getCalledRoutes(ctx: CallContext): RemoteMethod[] {\n  if (ctx.batchRouteIds) return ctx.batchRouteIds.map((id) => getRouteExecutable(id) as RemoteMethod);\n  const {executionChain} = ctx;\n  const route = executionChain.methods[executionChain.routeIndex];\n  if (!route || mionInternalRouteIds.has(route.id)) return [];\n  return [route];\n}\n\n// Place it first in the routes so a refused call runs nothing else.\n// The router-wide parser never reaches this helper at build time; a fixed body share keeps chain limits type-derived.\nexport const mionSyncRoutes = middleware(syncRoutes satisfies SyncRoutesHandler, {\n  parser: {params: 'clone', return: 'clone'},\n  maxBodySize: 1024,\n});\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAS,WAAW,KAAkB,cAAgD;CACpF,MAAM,SAAS,gBAAgB,GAAG;CAClC,MAAM,aAAuB,CAAC;CAC9B,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;EACtC,MAAM,OAAO,eAAe;EAC5B,IAAI,CAAC,MAAM,UAAU;OAChB,IAAI,SAAS,OAAO,GAAG,QAAQ,WAAW,KAAK,OAAO,GAAG,EAAE;CAClE;CACA,IAAI,WAAW,QACb,OAAO,IAAI,WAAuD;EAChE,MAAM;EACN,eACE,gBAAgB,WAAW,KAAK,OAAO,IAAI,GAAG,EAAE,EAAE,KAAK,IAAI,EAAE;EAE/D,WAAW,EAAC,UAAU,WAAU;CAClC,CAAC;CAEH,IAAI,SACF,OAAO,IAAI,WAAsD;EAC/D,MAAM;EACN,eAAe;EACf,WAAW,EAAC,UAAU,kBAAkB,OAAO,KAAK,UAAU,MAAM,EAAE,CAAC,EAAC;CAC1E,CAAC;AAEL;;AAGA,SAAS,gBAAgB,KAAkC;CACzD,IAAI,IAAI,eAAe,OAAO,IAAI,cAAc,KAAK,OAAO,mBAAmB,EAAE,CAAiB;CAClG,MAAM,EAAC,mBAAkB;CACzB,MAAM,QAAQ,eAAe,QAAQ,eAAe;CACpD,IAAI,CAAC,SAAS,qBAAqB,IAAI,MAAM,EAAE,GAAG,OAAO,CAAC;CAC1D,OAAO,CAAC,KAAK;AACf;AAIA,IAAa,iBAAiB,WAAW,YAAwC;CAC/E,QAAQ;EAAC,QAAQ;EAAS,QAAQ;CAAO;CACzC,aAAa;AACf,GAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAAA,GAAA;CAAA;CAAA;CAAA;CAAA;AAAA,GAAA,cAAA,cAAA,cAAA,YAAC"}

package/.dist/esm/src/router.d.ts

@@ -1,33 +1,41 @@
-import { Route, RouterOptions, Routes, RouterEntry } from './types/general.ts';
-import { RemoteMethod, MethodsExecutionChain, RawMethod, HeadersMethod, MiddleFnMethod, RouteMethod } from './types/remoteMethods.ts';
-import { PublicApi, PrivateDef, MiddleFnsCollection } from './types/publicMethods.ts';
-import { HeadersMiddleFnDef, MiddleFnDef, RawMiddleFnDef } from './types/definitions.ts';
-export declare let startMiddleFns: RemoteMethod[];
-export declare let endMiddleFns: RemoteMethod[];
+import { HostRequestHandler, Route, RouterOptions, RouterEntry } from './types/general.ts';
+import { RemoteMethod, MethodsExecutionChain, RawMethod, HeadersMethod, MiddlewareMethod, RouteMethod } from './types/remoteMethods.ts';
+import { PrivateDef, MiddlewaresCollection } from './types/publicMethods.ts';
+import { HeadersMiddlewareDef, MiddlewareDef, RawMiddlewareDef } from './types/definitions.ts';
+import { ResponseDefaults } from './types/context.ts';
+import { MionRouter, RouterOptionsInput, RouterOptionsArg } from './types/mionRouter.ts';
+export declare let startMiddlewares: RemoteMethod[];
+export declare let endMiddlewares: RemoteMethod[];
 export declare const getRouteExecutionChain: (path: string) => MethodsExecutionChain | undefined;
+export declare const getNotFoundExecutionChain: (id: string) => MethodsExecutionChain | undefined;
 export declare const getRouteEntries: () => MapIterator<[string, MethodsExecutionChain]>;
 export declare const geRoutesSize: () => number;
 export declare const getRouteExecutable: (id: string) => RouteMethod<any> | undefined;
-export declare const getMiddleFnExecutable: (id: string) => MiddleFnMethod<any> | HeadersMethod<any> | RawMethod<any> | undefined;
-export declare const geMiddleFnsSize: () => number;
+export declare const getMiddlewareExecutable: (id: string) => RawMethod<any> | HeadersMethod<any> | MiddlewareMethod<any> | undefined;
+export declare const getMiddlewaresSize: () => number;
 export declare const getComplexity: () => number;
 export declare const getRouterOptions: <Opts extends RouterOptions>() => Readonly<Opts>;
-export declare const getAnyExecutable: (id: string) => RouteMethod<any> | MiddleFnMethod<any> | HeadersMethod<any> | RawMethod<any> | undefined;
+export declare const getBuildVersion: () => string | undefined;
+export declare const getResponseDefaults: () => ResponseDefaults;
+export declare const getAnyExecutable: (id: string) => RawMethod<any> | HeadersMethod<any> | RouteMethod<any> | MiddlewareMethod<any> | undefined;
 export declare function setPlatformConfig(config: Record<string, unknown>): void;
 export declare const getPlatformConfig: () => Readonly<Record<string, unknown>> | undefined;
+export declare function setHostOwnsSocket(ownsSocket: boolean): void;
+export declare const hostOwnsSocket: () => boolean;
+export declare function handOverToHost(handler: HostRequestHandler): boolean;
+export declare const getHostRequestHandler: () => HostRequestHandler | undefined;
 export declare const resetRouter: () => void;
-export declare function initMionRouter<R extends Routes>(routes: R, opts?: Partial<RouterOptions>): Promise<PublicApi<R>>;
-export declare function initRouter(opts?: Partial<RouterOptions>): Promise<Readonly<RouterOptions>>;
-export declare function registerRoutes<R extends Routes>(routes: R): Promise<PublicApi<R>>;
-export declare function addStartMiddleFns(middleFnsDef: MiddleFnsCollection, appendBeforeExisting?: boolean): void;
-export declare function addEndMiddleFns(middleFnsDef: MiddleFnsCollection, prependAfterExisting?: boolean): void;
+export declare function createMionRouter<const O extends RouterOptionsInput = RouterOptionsInput>(opts?: RouterOptionsArg<O>): MionRouter<O>;
+export declare function addStartMiddlewares(middlewaresDef: MiddlewaresCollection, appendBeforeExisting?: boolean): void;
+export declare function addEndMiddlewares(middlewaresDef: MiddlewaresCollection, prependAfterExisting?: boolean): void;
 export declare function isPrivateDefinition(entry: RouterEntry, id: string): entry is PrivateDef;
-export declare function isPrivateExecutable(executable: RemoteMethod): boolean;
 export declare function getTotalExecutables(): number;
 export declare function getAllExecutablesIds(): string[];
 export declare function shouldFullGenerateSpec(): boolean;
-export declare function getRouteExecutableFromPath(path: string): RouteMethod;
-export declare function getExecutableFromMiddleFn(middleFn: MiddleFnDef | HeadersMiddleFnDef, middleFnPointer: string[], nestLevel: number): Promise<MiddleFnMethod | HeadersMethod>;
-export declare function getExecutableFromRawMiddleFn(middleFn: RawMiddleFnDef, middleFnPointer: string[], nestLevel: number): Promise<RawMethod>;
-export declare function getExecutableFromRoute(route: Route, routePointer: string[], nestLevel: number): Promise<RouteMethod>;
+export declare function getExecutableFromMiddleware(middleware: MiddlewareDef | HeadersMiddlewareDef, middlewarePointer: string[], nestLevel: number): MiddlewareMethod | HeadersMethod;
+export declare function getExecutableFromRawMiddleware(middleware: RawMiddlewareDef, middlewarePointer: string[], nestLevel: number): RawMethod;
+export declare function getExecutableFromRoute(route: Route, routePointer: string[], nestLevel: number): RouteMethod;
+export declare const getPlatformMaxBodySize: () => number;
+export declare const getPlatformRequestCap: () => number | undefined;
+export declare function getMaxRouteBodySize(): number;
 //# sourceMappingURL=router.d.ts.map