@fragno-dev/core 0.0.1

package/dist/integrations/react-ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-ssr.d.ts","names":[],"sources":["../../src/integrations/react-ssr.ts"],"sourcesContent":[],"mappings":";;AAoBA;AAUA;AAOA;;;;;;iBAjBsB,eAAA,CAAA,GAAmB;iBAUnB,cAAA,CAAA,GAAc;;;;iBAOd,gBAAA,CAAA,GAAgB"}

package/dist/integrations/react-ssr.js

@@ -0,0 +1,38 @@
+import { cleanStores, getFinalStoreValues } from "../ssr-tJHqcNSw.js";
+
+//#region src/integrations/react-ssr.ts
+/**
+* Advice from https://pragmaticwebsecurity.com/articles/spasecurity/json-stringify-xss.html
+* @param obj
+* @returns
+*/
+function javascriptEscaped(obj) {
+	return JSON.stringify(obj).replace(/</g, "\\u003c");
+}
+/**
+* This method should be called after a first render pass is finished.
+* It gets all values from the stores and embeds them in a script tag in the HTML body.
+*
+* On the client side, this script tag is used to hydrate the stores.
+* Be sure to also call finishServerLoad when the page is rendered, to reset the stores for the next request.
+*
+* @returns A string to be embedded in a script tag in the HTML body
+*/
+async function startServerLoad() {
+	const initialStoreValues = await getFinalStoreValues();
+	console.log("initialStoreValues", initialStoreValues);
+	return `window.__FRAGNO_INITIAL_DATA__ = ${javascriptEscaped(Array.from(initialStoreValues.entries()))}`;
+}
+async function initServerLoad() {
+	cleanStores();
+}
+/**
+* Reset the stores for the next request.
+*/
+async function finishServerLoad() {
+	cleanStores();
+}
+
+//#endregion
+export { finishServerLoad, initServerLoad, startServerLoad };
+//# sourceMappingURL=react-ssr.js.map

package/dist/integrations/react-ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-ssr.js","names":[],"sources":["../../src/integrations/react-ssr.ts"],"sourcesContent":["import { cleanStores, getFinalStoreValues } from \"../util/ssr\";\n\n/**\n * Advice from https://pragmaticwebsecurity.com/articles/spasecurity/json-stringify-xss.html\n * @param obj\n * @returns\n */\nfunction javascriptEscaped(obj: unknown) {\n  return JSON.stringify(obj).replace(/</g, \"\\\\u003c\");\n}\n\n/**\n * This method should be called after a first render pass is finished.\n * It gets all values from the stores and embeds them in a script tag in the HTML body.\n *\n * On the client side, this script tag is used to hydrate the stores.\n * Be sure to also call finishServerLoad when the page is rendered, to reset the stores for the next request.\n *\n * @returns A string to be embedded in a script tag in the HTML body\n */\nexport async function startServerLoad(): Promise<string> {\n  const initialStoreValues = await getFinalStoreValues();\n\n  console.log(\"initialStoreValues\", initialStoreValues);\n\n  return `window.__FRAGNO_INITIAL_DATA__ = ${javascriptEscaped(\n    Array.from(initialStoreValues.entries()),\n  )}`;\n}\n\nexport async function initServerLoad() {\n  cleanStores();\n}\n\n/**\n * Reset the stores for the next request.\n */\nexport async function finishServerLoad() {\n  cleanStores();\n}\n"],"mappings":";;;;;;;;AAOA,SAAS,kBAAkB,KAAc;AACvC,QAAO,KAAK,UAAU,IAAI,CAAC,QAAQ,MAAM,UAAU;;;;;;;;;;;AAYrD,eAAsB,kBAAmC;CACvD,MAAM,qBAAqB,MAAM,qBAAqB;AAEtD,SAAQ,IAAI,sBAAsB,mBAAmB;AAErD,QAAO,oCAAoC,kBACzC,MAAM,KAAK,mBAAmB,SAAS,CAAC,CACzC;;AAGH,eAAsB,iBAAiB;AACrC,cAAa;;;;;AAMf,eAAsB,mBAAmB;AACvC,cAAa"}

package/dist/integrations/svelte-kit.d.ts

@@ -0,0 +1,21 @@
+//#region src/integrations/svelte-kit.d.ts
+type MaybePromise<T> = T | Promise<T>;
+type SvelteKitRequestEvent = {
+  request: Request;
+};
+type SvelteKitRequestHandler = (event: SvelteKitRequestEvent) => MaybePromise<Response>;
+interface SvelteKitHandlers {
+  GET: SvelteKitRequestHandler;
+  POST: SvelteKitRequestHandler;
+  PUT: SvelteKitRequestHandler;
+  PATCH: SvelteKitRequestHandler;
+  DELETE: SvelteKitRequestHandler;
+  OPTIONS: SvelteKitRequestHandler;
+}
+declare function toSvelteHandler<T extends {
+  handler: (req: Request) => Promise<Response>;
+}>(fragment: T): SvelteKitHandlers;
+declare function toSvelteHandler(handler: (req: Request) => Promise<Response>): SvelteKitHandlers;
+//#endregion
+export { SvelteKitHandlers, SvelteKitRequestHandler, toSvelteHandler };
+//# sourceMappingURL=svelte-kit.d.ts.map

package/dist/integrations/svelte-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte-kit.d.ts","names":[],"sources":["../../src/integrations/svelte-kit.ts"],"sourcesContent":[],"mappings":";KAAK,kBAAkB,IAAI,QAAQ;KAE9B,qBAAA,GAFY;EAAA,OAAA,EAGN,OAHM;;AAAkB,KAMvB,uBAAA,GANuB,CAAA,KAAA,EAMW,qBANX,EAAA,GAMqC,YANrC,CAMkD,QANlD,CAAA;AAAR,UAQV,iBAAA,CARU;EAAO,GAAA,EAS3B,uBAT2B;EAE7B,IAAA,EAQG,uBARkB;EAId,GAAA,EAKL,uBAL4B;EAAA,KAAA,EAM1B,uBAN0B;QAAW,EAOpC,uBAPoC;SAAuC,EAQ1E,uBAR0E;;AAAD,iBAWpE,eAXoE,CAAA,UAAA;EAEnE,OAAA,EAAA,CAAA,GAAA,EAS0C,OATzB,EAAA,GASqC,OATrC,CAS6C,QAT7C,CAAA;CAAA,CAAA,CAAA,QAAA,EAUtB,CAVsB,CAAA,EAW/B,iBAX+B;AAC3B,iBAWS,eAAA,CAXT,OAAA,EAAA,CAAA,GAAA,EAWwC,OAXxC,EAAA,GAWoD,OAXpD,CAW4D,QAX5D,CAAA,CAAA,EAWwE,iBAXxE"}

package/dist/integrations/svelte-kit.js

@@ -0,0 +1,18 @@
+//#region src/integrations/svelte-kit.ts
+function toSvelteHandler(fragmentOrHandler) {
+	const requestHandler = async ({ request }) => {
+		return "handler" in fragmentOrHandler ? fragmentOrHandler.handler(request) : fragmentOrHandler(request);
+	};
+	return {
+		GET: requestHandler,
+		POST: requestHandler,
+		PUT: requestHandler,
+		PATCH: requestHandler,
+		DELETE: requestHandler,
+		OPTIONS: requestHandler
+	};
+}
+
+//#endregion
+export { toSvelteHandler };
+//# sourceMappingURL=svelte-kit.js.map

package/dist/integrations/svelte-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte-kit.js","names":["requestHandler: SvelteKitRequestHandler"],"sources":["../../src/integrations/svelte-kit.ts"],"sourcesContent":["type MaybePromise<T> = T | Promise<T>;\n\ntype SvelteKitRequestEvent = {\n  request: Request;\n};\n\nexport type SvelteKitRequestHandler = (event: SvelteKitRequestEvent) => MaybePromise<Response>;\n\nexport interface SvelteKitHandlers {\n  GET: SvelteKitRequestHandler;\n  POST: SvelteKitRequestHandler;\n  PUT: SvelteKitRequestHandler;\n  PATCH: SvelteKitRequestHandler;\n  DELETE: SvelteKitRequestHandler;\n  OPTIONS: SvelteKitRequestHandler;\n}\n\nexport function toSvelteHandler<T extends { handler: (req: Request) => Promise<Response> }>(\n  fragment: T,\n): SvelteKitHandlers;\nexport function toSvelteHandler(handler: (req: Request) => Promise<Response>): SvelteKitHandlers;\nexport function toSvelteHandler(\n  fragmentOrHandler:\n    | { handler: (req: Request) => Promise<Response> }\n    | ((req: Request) => Promise<Response>),\n): SvelteKitHandlers {\n  const requestHandler: SvelteKitRequestHandler = async ({ request }) => {\n    return \"handler\" in fragmentOrHandler\n      ? fragmentOrHandler.handler(request)\n      : fragmentOrHandler(request);\n  };\n\n  return {\n    GET: requestHandler,\n    POST: requestHandler,\n    PUT: requestHandler,\n    PATCH: requestHandler,\n    DELETE: requestHandler,\n    OPTIONS: requestHandler,\n  };\n}\n"],"mappings":";AAqBA,SAAgB,gBACd,mBAGmB;CACnB,MAAMA,iBAA0C,OAAO,EAAE,cAAc;AACrE,SAAO,aAAa,oBAChB,kBAAkB,QAAQ,QAAQ,GAClC,kBAAkB,QAAQ;;AAGhC,QAAO;EACL,KAAK;EACL,MAAM;EACN,KAAK;EACL,OAAO;EACP,QAAQ;EACR,SAAS;EACV"}

package/dist/mod.d.ts

@@ -0,0 +1,3 @@
+import { FragnoRouteConfig } from "./api-CBDGZiLC.js";
+import { AnyRouteOrFactory, FlattenRouteFactories, FragmentBuilder, FragnoFragmentSharedConfig, FragnoInstantiatedFragment, FragnoPublicClientConfig, FragnoPublicConfig, RouteFactory, RouteFactoryContext, createFragment, defineFragment, defineRoute, defineRoutes } from "./client-XFdAy-IQ.js";
+export { type AnyRouteOrFactory, type FlattenRouteFactories, FragmentBuilder, type FragnoFragmentSharedConfig, type FragnoInstantiatedFragment, type FragnoPublicClientConfig, type FragnoPublicConfig, type FragnoRouteConfig, type RouteFactory, type RouteFactoryContext, createFragment, defineFragment, defineRoute, defineRoutes };

package/dist/mod.js

@@ -0,0 +1,177 @@
+import { FragnoApiError } from "./api-DgHfYjq2.js";
+import { OutputContext, RequestInputContext, RequestOutputContext, defineRoute, defineRoutes, getMountRoute, resolveRouteFactories } from "./route-Bp6eByhz.js";
+import { addRoute, createRouter, findRoute } from "rou3";
+
+//#region src/api/request-middleware.ts
+var RequestMiddlewareOutputContext = class extends OutputContext {
+	#deps;
+	#services;
+	constructor(deps, services) {
+		super();
+		this.#deps = deps;
+		this.#services = services;
+	}
+	get deps() {
+		return this.#deps;
+	}
+	get services() {
+		return this.#services;
+	}
+};
+var RequestMiddlewareInputContext = class {
+	#options;
+	#route;
+	constructor(routes, options) {
+		this.#options = options;
+		const route = routes.find((route$1) => route$1.path === options.path && route$1.method === options.method);
+		if (!route) throw new Error(`Route not found: ${options.path} ${options.method}`);
+		this.#route = route;
+	}
+	get path() {
+		return this.#options.path;
+	}
+	get method() {
+		return this.#options.method;
+	}
+	get pathParams() {
+		return this.#options.pathParams ?? {};
+	}
+	get queryParams() {
+		return this.#options.searchParams;
+	}
+	get inputSchema() {
+		return this.#route.inputSchema;
+	}
+	get outputSchema() {
+		return this.#route.outputSchema;
+	}
+	ifMatchesRoute = async (method, path, handler) => {
+		if (this.path !== path || this.method !== method) return;
+		const inputContext = await RequestInputContext.fromRequest({
+			request: this.#options.request,
+			method: this.#options.method,
+			path,
+			pathParams: this.pathParams,
+			inputSchema: this.#route.inputSchema
+		});
+		const outputContext = new RequestOutputContext(this.#route.outputSchema);
+		return handler(inputContext, outputContext);
+	};
+};
+
+//#endregion
+//#region src/api/fragment.ts
+var FragmentBuilder = class FragmentBuilder {
+	#definition;
+	constructor(definition) {
+		this.#definition = definition;
+	}
+	get definition() {
+		return this.#definition;
+	}
+	withDependencies(fn) {
+		return new FragmentBuilder({
+			...this.#definition,
+			dependencies: fn
+		});
+	}
+	withServices(fn) {
+		return new FragmentBuilder({
+			...this.#definition,
+			services: fn
+		});
+	}
+};
+function defineFragment(name) {
+	return new FragmentBuilder({ name });
+}
+function createFragment(fragmentDefinition, config, routesOrFactories, fragnoConfig = {}) {
+	const definition = fragmentDefinition.definition;
+	const dependencies = definition.dependencies ? definition.dependencies(config) : {};
+	const services = definition.services ? definition.services(config, dependencies) : {};
+	const routes = resolveRouteFactories({
+		config,
+		deps: dependencies,
+		services
+	}, routesOrFactories);
+	const mountRoute = getMountRoute({
+		name: definition.name,
+		mountRoute: fragnoConfig.mountRoute
+	});
+	const router = createRouter();
+	let middlewareHandler;
+	for (const routeConfig of routes) addRoute(router, routeConfig.method.toUpperCase(), routeConfig.path, routeConfig);
+	const fragment = {
+		mountRoute,
+		config: {
+			name: definition.name,
+			routes
+		},
+		services,
+		deps: dependencies,
+		withMiddleware: (handler) => {
+			if (middlewareHandler) throw new Error("Middleware already set");
+			middlewareHandler = handler;
+			return fragment;
+		},
+		handler: async (req) => {
+			const pathname = new URL(req.url).pathname;
+			const matchRoute = pathname.startsWith(mountRoute) ? pathname.slice(mountRoute.length) : null;
+			if (matchRoute === null) return Response.json({
+				error: `Fragno: Route for '${definition.name}' not found. Is the fragment mounted on the right route? Expecting: '${mountRoute}'.`,
+				code: "ROUTE_NOT_FOUND"
+			}, { status: 404 });
+			const route = findRoute(router, req.method, matchRoute);
+			if (!route) return Response.json({
+				error: `Fragno: Route for '${definition.name}' not found`,
+				code: "ROUTE_NOT_FOUND"
+			}, { status: 404 });
+			const { handler, inputSchema, outputSchema, path } = route.data;
+			const outputContext = new RequestOutputContext(outputSchema);
+			if (middlewareHandler) {
+				const middlewareInputContext = new RequestMiddlewareInputContext(routes, {
+					method: req.method,
+					path,
+					pathParams: route.params,
+					searchParams: new URL(req.url).searchParams,
+					body: req.body,
+					request: req
+				});
+				const middlewareOutputContext = new RequestMiddlewareOutputContext(dependencies, services);
+				try {
+					const middlewareResult = await middlewareHandler(middlewareInputContext, middlewareOutputContext);
+					if (middlewareResult !== void 0) return middlewareResult;
+				} catch (error) {
+					console.error("Error in middleware", error);
+					if (error instanceof FragnoApiError) return error.toResponse();
+					return Response.json({
+						error: "Internal server error",
+						code: "INTERNAL_SERVER_ERROR"
+					}, { status: 500 });
+				}
+			}
+			const inputContext = await RequestInputContext.fromRequest({
+				request: req,
+				method: req.method,
+				path,
+				pathParams: route.params ?? {},
+				inputSchema
+			});
+			try {
+				return await handler(inputContext, outputContext);
+			} catch (error) {
+				console.error("Error in handler", error);
+				if (error instanceof FragnoApiError) return error.toResponse();
+				return Response.json({
+					error: "Internal server error",
+					code: "INTERNAL_SERVER_ERROR"
+				}, { status: 500 });
+			}
+		}
+	};
+	return fragment;
+}
+
+//#endregion
+export { FragmentBuilder, createFragment, defineFragment, defineRoute, defineRoutes };
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":["#deps","#services","#options","#route","route","#definition","middlewareHandler:\n    | FragnoMiddlewareCallback<FlattenRouteFactories<TRoutesOrFactories>, TDeps, TServices>\n    | undefined","fragment: FragnoInstantiatedFragment<\n    FlattenRouteFactories<TRoutesOrFactories>,\n    TDeps,\n    TServices\n  >"],"sources":["../src/api/request-middleware.ts","../src/api/fragment.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ExtractRouteByPath, ExtractRoutePath } from \"../client/client\";\nimport type { HTTPMethod } from \"./api\";\nimport type { ExtractPathParams } from \"./internal/path\";\nimport type { RequestBodyType } from \"./request-input-context\";\nimport type { AnyFragnoRouteConfig } from \"./route\";\nimport { RequestInputContext } from \"./request-input-context\";\nimport { OutputContext, RequestOutputContext } from \"./request-output-context\";\n\nexport type FragnoMiddlewareCallback<\n  TRoutes extends readonly AnyFragnoRouteConfig[],\n  TDeps,\n  TServices extends Record<string, unknown>,\n> = (\n  inputContext: RequestMiddlewareInputContext<TRoutes>,\n  outputContext: RequestMiddlewareOutputContext<TDeps, TServices>,\n) => Promise<Response | undefined> | Response | undefined;\n\nexport interface RequestMiddlewareOptions {\n  path: string;\n  method: HTTPMethod;\n  pathParams?: Record<string, string>;\n  searchParams: URLSearchParams;\n  body: RequestBodyType;\n  request: Request;\n}\n\nexport class RequestMiddlewareOutputContext<\n  const TDeps,\n  const TServices extends Record<string, unknown>,\n> extends OutputContext<unknown, string> {\n  readonly #deps: TDeps;\n  readonly #services: TServices;\n\n  constructor(deps: TDeps, services: TServices) {\n    super();\n    this.#deps = deps;\n    this.#services = services;\n  }\n\n  get deps(): TDeps {\n    return this.#deps;\n  }\n\n  get services(): TServices {\n    return this.#services;\n  }\n}\n\nexport class RequestMiddlewareInputContext<const TRoutes extends readonly AnyFragnoRouteConfig[]> {\n  readonly #options: RequestMiddlewareOptions;\n  readonly #route: TRoutes[number];\n\n  constructor(routes: TRoutes, options: RequestMiddlewareOptions) {\n    this.#options = options;\n\n    const route = routes.find(\n      (route) => route.path === options.path && route.method === options.method,\n    );\n\n    if (!route) {\n      throw new Error(`Route not found: ${options.path} ${options.method}`);\n    }\n\n    this.#route = route;\n  }\n\n  get path(): string {\n    return this.#options.path;\n  }\n\n  get method(): HTTPMethod {\n    return this.#options.method;\n  }\n\n  get pathParams(): Record<string, string> {\n    return this.#options.pathParams ?? {};\n  }\n\n  get queryParams(): URLSearchParams {\n    return this.#options.searchParams;\n  }\n\n  get inputSchema(): StandardSchemaV1 | undefined {\n    return this.#route.inputSchema;\n  }\n\n  get outputSchema(): StandardSchemaV1 | undefined {\n    return this.#route.outputSchema;\n  }\n\n  // Defined as a field so that `this` reference stays in tact when destructuring\n  ifMatchesRoute = async <\n    const TMethod extends HTTPMethod,\n    const TPath extends ExtractRoutePath<TRoutes>,\n    const TRoute extends ExtractRouteByPath<TRoutes, TPath, TMethod> = ExtractRouteByPath<\n      TRoutes,\n      TPath,\n      TMethod\n    >,\n  >(\n    method: TMethod,\n    path: TPath,\n    handler: (\n      ...args: Parameters<TRoute[\"handler\"]>\n    ) => Promise<Response | undefined | void> | Response | undefined | void,\n  ): Promise<Response | undefined> => {\n    if (this.path !== path || this.method !== method) {\n      return undefined;\n    }\n\n    // TODO(Wilco): We should support reading/modifying headers here.\n    const inputContext = await RequestInputContext.fromRequest({\n      request: this.#options.request,\n      method: this.#options.method,\n      path: path,\n      pathParams: this.pathParams as ExtractPathParams<TPath>,\n      inputSchema: this.#route.inputSchema,\n    });\n\n    const outputContext = new RequestOutputContext(this.#route.outputSchema);\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (handler as any)(inputContext, outputContext);\n  };\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { type FragnoRouteConfig, type HTTPMethod } from \"./api\";\nimport { FragnoApiError } from \"./error\";\nimport { getMountRoute } from \"./internal/route\";\nimport { addRoute, createRouter, findRoute } from \"rou3\";\nimport { RequestInputContext } from \"./request-input-context\";\nimport type { ExtractPathParams } from \"./internal/path\";\nimport { RequestOutputContext } from \"./request-output-context\";\nimport {\n  type EmptyObject,\n  type AnyFragnoRouteConfig,\n  type AnyRouteOrFactory,\n  type FlattenRouteFactories,\n  resolveRouteFactories,\n} from \"./route\";\nimport {\n  RequestMiddlewareInputContext,\n  RequestMiddlewareOutputContext,\n  type FragnoMiddlewareCallback,\n} from \"./request-middleware\";\n\nexport interface FragnoPublicConfig {\n  mountRoute?: string;\n}\n\nexport interface FragnoPublicClientConfig {\n  mountRoute?: string;\n  baseUrl?: string;\n}\n\nexport interface FragnoInstantiatedFragment<\n  TRoutes extends readonly AnyFragnoRouteConfig[] = [],\n  TDeps = EmptyObject,\n  TServices extends Record<string, unknown> = Record<string, unknown>,\n> {\n  config: FragnoFragmentSharedConfig<TRoutes>;\n  deps: TDeps;\n  services: TServices;\n  handler: (req: Request) => Promise<Response>;\n  mountRoute: string;\n  withMiddleware: (\n    handler: FragnoMiddlewareCallback<TRoutes, TDeps, TServices>,\n  ) => FragnoInstantiatedFragment<TRoutes, TDeps, TServices>;\n}\n\nexport interface FragnoFragmentSharedConfig<\n  TRoutes extends readonly FragnoRouteConfig<\n    HTTPMethod,\n    string,\n    StandardSchemaV1 | undefined,\n    StandardSchemaV1 | undefined,\n    string,\n    string\n  >[],\n> {\n  name: string;\n  routes: TRoutes;\n}\n\nexport type AnyFragnoFragmentSharedConfig = FragnoFragmentSharedConfig<\n  readonly AnyFragnoRouteConfig[]\n>;\n\ninterface FragmentDefinition<\n  TConfig,\n  TDeps = EmptyObject,\n  TServices extends Record<string, unknown> = EmptyObject,\n> {\n  name: string;\n  dependencies?: (config: TConfig) => TDeps;\n  services?: (config: TConfig, deps: TDeps) => TServices;\n}\n\nexport class FragmentBuilder<\n  TConfig,\n  TDeps = EmptyObject,\n  TServices extends Record<string, unknown> = EmptyObject,\n> {\n  #definition: FragmentDefinition<TConfig, TDeps, TServices>;\n\n  constructor(definition: FragmentDefinition<TConfig, TDeps, TServices>) {\n    this.#definition = definition;\n  }\n\n  get definition() {\n    return this.#definition;\n  }\n\n  withDependencies<TNewDeps>(\n    fn: (config: TConfig) => TNewDeps,\n  ): FragmentBuilder<TConfig, TNewDeps, TServices> {\n    return new FragmentBuilder<TConfig, TNewDeps, TServices>({\n      ...this.#definition,\n      dependencies: fn,\n    } as FragmentDefinition<TConfig, TNewDeps, TServices>);\n  }\n\n  withServices<TNewServices extends Record<string, unknown>>(\n    fn: (config: TConfig, deps: TDeps) => TNewServices,\n  ): FragmentBuilder<TConfig, TDeps, TNewServices> {\n    return new FragmentBuilder<TConfig, TDeps, TNewServices>({\n      ...this.#definition,\n      services: fn,\n    } as FragmentDefinition<TConfig, TDeps, TNewServices>);\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport function defineFragment<TConfig = {}>(name: string): FragmentBuilder<TConfig> {\n  return new FragmentBuilder({\n    name,\n  });\n}\n\nexport function createFragment<\n  TConfig,\n  TDeps,\n  TServices extends Record<string, unknown>,\n  const TRoutesOrFactories extends readonly AnyRouteOrFactory[],\n>(\n  fragmentDefinition: FragmentBuilder<TConfig, TDeps, TServices>,\n  config: TConfig,\n  routesOrFactories: TRoutesOrFactories,\n  fragnoConfig: FragnoPublicConfig = {},\n): FragnoInstantiatedFragment<FlattenRouteFactories<TRoutesOrFactories>, TDeps, TServices> {\n  const definition = fragmentDefinition.definition;\n\n  const dependencies = definition.dependencies ? definition.dependencies(config) : ({} as TDeps);\n  const services = definition.services\n    ? definition.services(config, dependencies)\n    : ({} as TServices);\n\n  const context = { config, deps: dependencies, services };\n  const routes = resolveRouteFactories(context, routesOrFactories);\n\n  const mountRoute = getMountRoute({\n    name: definition.name,\n    mountRoute: fragnoConfig.mountRoute,\n  });\n\n  const router =\n    createRouter<\n      FragnoRouteConfig<\n        HTTPMethod,\n        string,\n        StandardSchemaV1 | undefined,\n        StandardSchemaV1 | undefined,\n        string,\n        string\n      >\n    >();\n\n  let middlewareHandler:\n    | FragnoMiddlewareCallback<FlattenRouteFactories<TRoutesOrFactories>, TDeps, TServices>\n    | undefined;\n\n  for (const routeConfig of routes) {\n    addRoute(router, routeConfig.method.toUpperCase(), routeConfig.path, routeConfig);\n  }\n\n  const fragment: FragnoInstantiatedFragment<\n    FlattenRouteFactories<TRoutesOrFactories>,\n    TDeps,\n    TServices\n  > = {\n    mountRoute,\n    config: {\n      name: definition.name,\n      routes,\n    },\n    services,\n    deps: dependencies,\n    withMiddleware: (handler) => {\n      if (middlewareHandler) {\n        throw new Error(\"Middleware already set\");\n      }\n\n      middlewareHandler = handler;\n\n      return fragment;\n    },\n    handler: async (req: Request) => {\n      const url = new URL(req.url);\n      const pathname = url.pathname;\n\n      const matchRoute = pathname.startsWith(mountRoute) ? pathname.slice(mountRoute.length) : null;\n\n      if (matchRoute === null) {\n        return Response.json(\n          {\n            error:\n              `Fragno: Route for '${definition.name}' not found. Is the fragment mounted on the right route? ` +\n              `Expecting: '${mountRoute}'.`,\n            code: \"ROUTE_NOT_FOUND\",\n          },\n          { status: 404 },\n        );\n      }\n\n      const route = findRoute(router, req.method, matchRoute);\n\n      if (!route) {\n        return Response.json(\n          { error: `Fragno: Route for '${definition.name}' not found`, code: \"ROUTE_NOT_FOUND\" },\n          { status: 404 },\n        );\n      }\n\n      const { handler, inputSchema, outputSchema, path } = route.data;\n\n      const outputContext = new RequestOutputContext(outputSchema);\n\n      if (middlewareHandler) {\n        const middlewareInputContext = new RequestMiddlewareInputContext(routes, {\n          method: req.method as HTTPMethod,\n          path,\n          pathParams: route.params,\n          searchParams: new URL(req.url).searchParams,\n          body: req.body,\n          request: req,\n        });\n\n        const middlewareOutputContext = new RequestMiddlewareOutputContext(dependencies, services);\n\n        try {\n          const middlewareResult = await middlewareHandler(\n            middlewareInputContext,\n            middlewareOutputContext,\n          );\n          if (middlewareResult !== undefined) {\n            return middlewareResult;\n          }\n        } catch (error) {\n          console.error(\"Error in middleware\", error);\n\n          if (error instanceof FragnoApiError) {\n            // TODO: If a validation error occurs in middleware (when calling `await input.valid()`)\n            //       the processing is short-circuited and a potential `catch` block around the call\n            //       to `input.valid()` in the actual handler will not be executed.\n            return error.toResponse();\n          }\n\n          return Response.json(\n            { error: \"Internal server error\", code: \"INTERNAL_SERVER_ERROR\" },\n            { status: 500 },\n          );\n        }\n      }\n\n      const inputContext = await RequestInputContext.fromRequest({\n        request: req,\n        method: req.method,\n        path,\n        pathParams: (route.params ?? {}) as ExtractPathParams<typeof path>,\n        inputSchema,\n      });\n\n      try {\n        const result = await handler(inputContext, outputContext);\n        return result;\n      } catch (error) {\n        console.error(\"Error in handler\", error);\n\n        if (error instanceof FragnoApiError) {\n          return error.toResponse();\n        }\n\n        return Response.json(\n          { error: \"Internal server error\", code: \"INTERNAL_SERVER_ERROR\" },\n          { status: 500 },\n        );\n      }\n    },\n  };\n\n  return fragment;\n}\n"],"mappings":"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"}

package/dist/route-Bp6eByhz.js

@@ -0,0 +1,331 @@
+import { FragnoApiValidationError } from "./api-DgHfYjq2.js";
+
+//#region src/api/internal/route.ts
+function getMountRoute(opts) {
+	const mountRoute = opts.mountRoute ?? `/api/${opts.name}`;
+	if (mountRoute.endsWith("/")) return mountRoute.slice(0, -1);
+	return mountRoute;
+}
+
+//#endregion
+//#region src/api/request-input-context.ts
+var RequestInputContext = class RequestInputContext {
+	#path;
+	#method;
+	#pathParams;
+	#searchParams;
+	#body;
+	#inputSchema;
+	#shouldValidateInput;
+	constructor(config) {
+		this.#path = config.path;
+		this.#method = config.method;
+		this.#pathParams = config.pathParams;
+		this.#searchParams = config.searchParams;
+		this.#body = config.body;
+		this.#inputSchema = config.inputSchema;
+		this.#shouldValidateInput = config.shouldValidateInput ?? true;
+	}
+	/**
+	* Create a RequestContext from a Request object for server-side handling
+	*/
+	static async fromRequest(config) {
+		const url = new URL(config.request.url);
+		const request = config.request.clone();
+		const json = request.body instanceof ReadableStream ? await request.json() : void 0;
+		return new RequestInputContext({
+			method: config.method,
+			path: config.path,
+			pathParams: config.pathParams,
+			searchParams: url.searchParams,
+			body: json,
+			inputSchema: config.inputSchema,
+			shouldValidateInput: config.shouldValidateInput
+		});
+	}
+	/**
+	* Create a RequestContext for server-side rendering contexts (no Request object)
+	*/
+	static fromSSRContext(config) {
+		return new RequestInputContext({
+			method: config.method,
+			path: config.path,
+			pathParams: config.pathParams,
+			searchParams: config.searchParams ?? new URLSearchParams(),
+			body: "body" in config ? config.body : void 0,
+			inputSchema: "inputSchema" in config ? config.inputSchema : void 0,
+			shouldValidateInput: false
+		});
+	}
+	/**
+	* The HTTP method as string (e.g., `GET`, `POST`)
+	*/
+	get method() {
+		return this.#method;
+	}
+	/**
+	* The matched route path (e.g., `/users/:id`)
+	* @remarks `string`
+	*/
+	get path() {
+		return this.#path;
+	}
+	/**
+	* Extracted path parameters as object (e.g., `{ id: '123' }`)
+	* @remarks `Record<string, string>`
+	*/
+	get pathParams() {
+		return this.#pathParams;
+	}
+	/**
+	* [URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams) object for query parameters
+	* @remarks `URLSearchParams`
+	*/
+	get query() {
+		return this.#searchParams;
+	}
+	/**
+	* @internal
+	*/
+	get rawBody() {
+		return this.#body;
+	}
+	/**
+	* Input validation context (only if inputSchema is defined)
+	* @remarks `InputContext`
+	*/
+	get input() {
+		if (!this.#inputSchema) return;
+		return {
+			schema: this.#inputSchema,
+			valid: async () => {
+				if (!this.#shouldValidateInput) return this.#body;
+				return this.#validateInput();
+			}
+		};
+	}
+	async #validateInput() {
+		if (!this.#inputSchema) throw new Error("No input schema defined for this route");
+		if (this.#body instanceof FormData || this.#body instanceof Blob) throw new Error("Schema validation is only supported for JSON data, not FormData or Blob");
+		const result = await this.#inputSchema["~standard"].validate(this.#body);
+		if (result.issues) throw new FragnoApiValidationError("Validation failed", result.issues);
+		return result.value;
+	}
+};
+
+//#endregion
+//#region src/api/internal/response-stream.ts
+var ResponseStream = class {
+	#writer;
+	#encoder;
+	#abortSubscribers = [];
+	#responseReadable;
+	#aborted = false;
+	#closed = false;
+	/**
+	* Whether the stream has been aborted.
+	*/
+	get aborted() {
+		return this.#aborted;
+	}
+	/**
+	* Whether the stream has been closed normally.
+	*/
+	get closed() {
+		return this.#closed;
+	}
+	/**
+	* The readable stream that the response is piped to.
+	*/
+	get responseReadable() {
+		return this.#responseReadable;
+	}
+	constructor(writable, readable) {
+		this.#writer = writable.getWriter();
+		this.#encoder = new TextEncoder();
+		const reader = readable.getReader();
+		this.#abortSubscribers.push(async () => {
+			await reader.cancel();
+		});
+		this.#responseReadable = new ReadableStream({
+			async pull(controller) {
+				const { done, value } = await reader.read();
+				if (done) controller.close();
+				else controller.enqueue(value);
+			},
+			cancel: () => {
+				this.abort();
+			}
+		});
+	}
+	async writeRaw(input) {
+		try {
+			if (typeof input === "string") input = this.#encoder.encode(input);
+			await this.#writer.write(input);
+		} catch {}
+	}
+	write(input) {
+		return this.writeRaw(JSON.stringify(input) + "\n");
+	}
+	sleep(ms) {
+		return new Promise((res) => setTimeout(res, ms));
+	}
+	async close() {
+		try {
+			await this.#writer.close();
+		} catch {} finally {
+			this.#closed = true;
+		}
+	}
+	onAbort(listener) {
+		this.#abortSubscribers.push(listener);
+	}
+	/**
+	* Abort the stream.
+	* You can call this method when stream is aborted by external event.
+	*/
+	abort() {
+		if (!this.aborted) {
+			this.#aborted = true;
+			this.#abortSubscribers.forEach((subscriber) => subscriber());
+		}
+	}
+};
+
+//#endregion
+//#region src/api/request-output-context.ts
+/**
+* Utility function to merge headers from multiple sources.
+* Later headers override earlier ones.
+*/
+function mergeHeaders(...headerSources) {
+	const mergedHeaders = new Headers();
+	for (const headerSource of headerSources) {
+		if (!headerSource) continue;
+		if (headerSource instanceof Headers) for (const [key, value] of headerSource.entries()) mergedHeaders.set(key, value);
+		else if (Array.isArray(headerSource)) for (const [key, value] of headerSource) mergedHeaders.set(key, value);
+		else for (const [key, value] of Object.entries(headerSource)) mergedHeaders.set(key, value);
+	}
+	return mergedHeaders;
+}
+var OutputContext = class {
+	/**
+	* Creates an error response.
+	*
+	* Shortcut for `throw new FragnoApiError(...)`
+	*/
+	error({ message, code }, initOrStatus, headers) {
+		if (typeof initOrStatus === "undefined") return Response.json({
+			error: message,
+			code
+		}, {
+			status: 500,
+			headers
+		});
+		if (typeof initOrStatus === "number") return Response.json({
+			error: message,
+			code
+		}, {
+			status: initOrStatus,
+			headers
+		});
+		const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);
+		return Response.json({
+			error: message,
+			code
+		}, {
+			status: initOrStatus.status,
+			headers: mergedHeaders
+		});
+	}
+	empty(initOrStatus, headers) {
+		const defaultHeaders = {};
+		if (typeof initOrStatus === "undefined") {
+			const mergedHeaders$1 = mergeHeaders(defaultHeaders, headers);
+			return Response.json(null, {
+				status: 201,
+				headers: mergedHeaders$1
+			});
+		}
+		if (typeof initOrStatus === "number") {
+			const mergedHeaders$1 = mergeHeaders(defaultHeaders, headers);
+			return Response.json(null, {
+				status: initOrStatus,
+				headers: mergedHeaders$1
+			});
+		}
+		const mergedHeaders = mergeHeaders(defaultHeaders, initOrStatus.headers, headers);
+		return Response.json(null, {
+			status: initOrStatus.status,
+			headers: mergedHeaders
+		});
+	}
+	json(object, initOrStatus, headers) {
+		if (typeof initOrStatus === "undefined") return Response.json(object, {
+			status: 200,
+			headers
+		});
+		if (typeof initOrStatus === "number") return Response.json(object, {
+			status: initOrStatus,
+			headers
+		});
+		const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);
+		return Response.json(object, {
+			status: initOrStatus.status,
+			headers: mergedHeaders
+		});
+	}
+	jsonStream = (cb, { onError, headers } = {}) => {
+		const defaultHeaders = {
+			"content-type": "application/x-ndjson; charset=utf-8",
+			"transfer-encoding": "chunked",
+			"cache-control": "no-cache"
+		};
+		const { readable, writable } = new TransformStream();
+		const stream = new ResponseStream(writable, readable);
+		(async () => {
+			try {
+				await cb(stream);
+			} catch (e) {
+				if (e === void 0) {} else if (e instanceof Error && onError) await onError(e, stream);
+				else console.error(e);
+			} finally {
+				stream.close();
+			}
+		})();
+		return new Response(stream.responseReadable, {
+			status: 200,
+			headers: mergeHeaders(defaultHeaders, headers)
+		});
+	};
+};
+var RequestOutputContext = class extends OutputContext {
+	#outputSchema;
+	constructor(outputSchema) {
+		super();
+		this.#outputSchema = outputSchema;
+	}
+};
+
+//#endregion
+//#region src/api/route.ts
+function resolveRouteFactories(context, routesOrFactories) {
+	const routes = [];
+	for (const item of routesOrFactories) if (typeof item === "function") {
+		const factoryRoutes = item(context);
+		routes.push(...factoryRoutes);
+	} else routes.push(item);
+	return routes;
+}
+function defineRoute(config) {
+	return config;
+}
+function defineRoutes() {
+	return { create: (fn) => {
+		return fn;
+	} };
+}
+
+//#endregion
+export { OutputContext, RequestInputContext, RequestOutputContext, defineRoute, defineRoutes, getMountRoute, resolveRouteFactories };
+//# sourceMappingURL=route-Bp6eByhz.js.map