@fragno-dev/db 0.1.14 → 0.2.0

package/dist/packages/fragno/dist/api/fragment-instantiator.js

@@ -0,0 +1,525 @@
+import { resolveRouteFactories } from "./route.js";
+import { instantiatedFragmentFakeSymbol } from "../internal/symbols.js";
+import { FragnoApiError } from "./error.js";
+import { getMountRoute } from "./internal/route.js";
+import { RequestInputContext } from "./request-input-context.js";
+import { RequestOutputContext } from "./request-output-context.js";
+import { MutableRequestState } from "./mutable-request-state.js";
+import { RequestMiddlewareInputContext, RequestMiddlewareOutputContext } from "./request-middleware.js";
+import { parseFragnoResponse } from "./fragno-response.js";
+import { RequestContextStorage } from "./request-context-storage.js";
+import { bindServicesToContext } from "./bind-services.js";
+import { addRoute, createRouter, findRoute } from "../../../../node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.js";
+
+//#region ../fragno/dist/api/fragment-instantiator.js
+/**
+* Instantiated fragment class with encapsulated state.
+* Provides the same public API as the old FragnoInstantiatedFragment but with better encapsulation.
+*/
+var FragnoInstantiatedFragment = class {
+	[instantiatedFragmentFakeSymbol] = instantiatedFragmentFakeSymbol;
+	#name;
+	#routes;
+	#deps;
+	#services;
+	#mountRoute;
+	#router;
+	#middlewareHandler;
+	#serviceThisContext;
+	#handlerThisContext;
+	#contextStorage;
+	#createRequestStorage;
+	#options;
+	#linkedFragments;
+	constructor(params) {
+		this.#name = params.name;
+		this.#routes = params.routes;
+		this.#deps = params.deps;
+		this.#services = params.services;
+		this.#mountRoute = params.mountRoute;
+		this.#serviceThisContext = params.serviceThisContext;
+		this.#handlerThisContext = params.handlerThisContext;
+		this.#contextStorage = params.storage;
+		this.#createRequestStorage = params.createRequestStorage;
+		this.#options = params.options;
+		this.#linkedFragments = params.linkedFragments ?? {};
+		this.#router = createRouter();
+		for (const routeConfig of this.#routes) addRoute(this.#router, routeConfig.method.toUpperCase(), routeConfig.path, routeConfig);
+		this.handler = this.handler.bind(this);
+	}
+	get name() {
+		return this.#name;
+	}
+	get routes() {
+		return this.#routes;
+	}
+	get services() {
+		return this.#services;
+	}
+	get mountRoute() {
+		return this.#mountRoute;
+	}
+	/**
+	* @internal
+	*/
+	get $internal() {
+		return {
+			deps: this.#deps,
+			options: this.#options,
+			linkedFragments: this.#linkedFragments
+		};
+	}
+	/**
+	* Add middleware to this fragment.
+	* Middleware can inspect and modify requests before they reach handlers.
+	*/
+	withMiddleware(handler) {
+		if (this.#middlewareHandler) throw new Error("Middleware already set");
+		this.#middlewareHandler = handler;
+		return this;
+	}
+	#withRequestStorage(callback) {
+		if (!this.#serviceThisContext && !this.#handlerThisContext) return callback();
+		const storageData = this.#createRequestStorage ? this.#createRequestStorage() : {};
+		return this.#contextStorage.run(storageData, callback);
+	}
+	inContext(callback) {
+		if (this.#handlerThisContext) {
+			const boundCallback = callback.bind(this.#handlerThisContext);
+			return this.#withRequestStorage(boundCallback);
+		}
+		return this.#withRequestStorage(callback);
+	}
+	/**
+	* Get framework-specific handlers for this fragment.
+	* Use this to integrate the fragment with different fullstack frameworks.
+	*/
+	handlersFor(framework) {
+		const handler = this.handler.bind(this);
+		if (framework === "h3" || framework === "nuxt") throw new Error(`To get handlers for h3, use the 'fromWebHandler' utility function:
+        import { fromWebHandler } from "h3";
+        export default fromWebHandler(myFragment().handler);`);
+		return {
+			astro: { ALL: handler },
+			"react-router": {
+				loader: ({ request }) => handler(request),
+				action: ({ request }) => handler(request)
+			},
+			"next-js": {
+				GET: handler,
+				POST: handler,
+				PUT: handler,
+				DELETE: handler,
+				PATCH: handler,
+				HEAD: handler,
+				OPTIONS: handler
+			},
+			"svelte-kit": {
+				GET: handler,
+				POST: handler,
+				PUT: handler,
+				DELETE: handler,
+				PATCH: handler,
+				HEAD: handler,
+				OPTIONS: handler
+			},
+			"solid-start": {
+				GET: ({ request }) => handler(request),
+				POST: ({ request }) => handler(request),
+				PUT: ({ request }) => handler(request),
+				DELETE: ({ request }) => handler(request),
+				PATCH: ({ request }) => handler(request),
+				HEAD: ({ request }) => handler(request),
+				OPTIONS: ({ request }) => handler(request)
+			},
+			"tanstack-start": {
+				GET: ({ request }) => handler(request),
+				POST: ({ request }) => handler(request),
+				PUT: ({ request }) => handler(request),
+				DELETE: ({ request }) => handler(request),
+				PATCH: ({ request }) => handler(request),
+				HEAD: ({ request }) => handler(request),
+				OPTIONS: ({ request }) => handler(request)
+			}
+		}[framework];
+	}
+	/**
+	* Main request handler for this fragment.
+	* Handles routing, middleware, and error handling.
+	*/
+	async handler(req) {
+		const url = new URL(req.url);
+		const pathname = url.pathname;
+		const matchRoute = pathname.startsWith(this.#mountRoute) ? pathname.slice(this.#mountRoute.length) : null;
+		if (matchRoute === null) return Response.json({
+			error: `Fragno: Route for '${this.#name}' not found. Is the fragment mounted on the right route? Expecting: '${this.#mountRoute}'.`,
+			code: "ROUTE_NOT_FOUND"
+		}, { status: 404 });
+		const route = findRoute(this.#router, req.method, matchRoute);
+		if (!route) return Response.json({
+			error: `Fragno: Route for '${this.#name}' not found`,
+			code: "ROUTE_NOT_FOUND"
+		}, { status: 404 });
+		let requestBody = void 0;
+		let rawBody = void 0;
+		if (req.body instanceof ReadableStream) {
+			rawBody = await req.clone().text();
+			if (rawBody) try {
+				requestBody = JSON.parse(rawBody);
+			} catch {
+				requestBody = void 0;
+			}
+		}
+		const requestState = new MutableRequestState({
+			pathParams: route.params ?? {},
+			searchParams: url.searchParams,
+			body: requestBody,
+			headers: new Headers(req.headers)
+		});
+		const executeRequest = async () => {
+			if (this.#middlewareHandler) {
+				const middlewareResult = await this.#executeMiddleware(req, route, requestState);
+				if (middlewareResult !== void 0) return middlewareResult;
+			}
+			return this.#executeHandler(req, route, requestState, rawBody);
+		};
+		return this.#withRequestStorage(executeRequest);
+	}
+	/**
+	* Call a route directly with typed inputs and outputs.
+	* Useful for testing and server-side route calls.
+	*/
+	async callRoute(method, path, inputOptions) {
+		return parseFragnoResponse(await this.callRouteRaw(method, path, inputOptions));
+	}
+	/**
+	* Call a route directly and get the raw Response object.
+	* Useful for testing and server-side route calls.
+	*/
+	async callRouteRaw(method, path, inputOptions) {
+		const route = this.#routes.find((r) => r.method === method && r.path === path);
+		if (!route) return Response.json({
+			error: `Route ${method} ${path} not found`,
+			code: "ROUTE_NOT_FOUND"
+		}, { status: 404 });
+		const { pathParams = {}, body, query, headers } = inputOptions || {};
+		const searchParams = query instanceof URLSearchParams ? query : query ? new URLSearchParams(query) : new URLSearchParams();
+		const requestHeaders = headers instanceof Headers ? headers : headers ? new Headers(headers) : new Headers();
+		const inputContext = new RequestInputContext({
+			path: route.path,
+			method: route.method,
+			pathParams,
+			searchParams,
+			headers: requestHeaders,
+			parsedBody: body,
+			inputSchema: route.inputSchema,
+			shouldValidateInput: true
+		});
+		const outputContext = new RequestOutputContext(route.outputSchema);
+		const executeHandler = async () => {
+			try {
+				const thisContext = this.#handlerThisContext ?? {};
+				return await route.handler.call(thisContext, inputContext, outputContext);
+			} catch (error) {
+				console.error("Error in callRoute handler", error);
+				if (error instanceof FragnoApiError) return error.toResponse();
+				return Response.json({
+					error: "Internal server error",
+					code: "INTERNAL_SERVER_ERROR"
+				}, { status: 500 });
+			}
+		};
+		return this.#withRequestStorage(executeHandler);
+	}
+	/**
+	* Execute middleware for a request.
+	* Returns undefined if middleware allows the request to continue to the handler.
+	*/
+	async #executeMiddleware(req, route, requestState) {
+		if (!this.#middlewareHandler || !route) return;
+		const { path } = route.data;
+		const middlewareInputContext = new RequestMiddlewareInputContext(this.#routes, {
+			method: req.method,
+			path,
+			request: req,
+			state: requestState
+		});
+		const middlewareOutputContext = new RequestMiddlewareOutputContext(this.#deps, this.#services);
+		try {
+			const middlewareResult = await this.#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 });
+		}
+	}
+	/**
+	* Execute a route handler with proper error handling.
+	*/
+	async #executeHandler(req, route, requestState, rawBody) {
+		if (!route) return Response.json({
+			error: "Route not found",
+			code: "ROUTE_NOT_FOUND"
+		}, { status: 404 });
+		const { handler, inputSchema, outputSchema, path } = route.data;
+		const inputContext = await RequestInputContext.fromRequest({
+			request: req,
+			method: req.method,
+			path,
+			pathParams: route.params ?? {},
+			inputSchema,
+			state: requestState,
+			rawBody
+		});
+		const outputContext = new RequestOutputContext(outputSchema);
+		try {
+			const contextForHandler = this.#handlerThisContext ?? {};
+			return await handler.call(contextForHandler, 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 });
+		}
+	}
+};
+/**
+* Core instantiation function that creates a fragment instance from a definition.
+* This function validates dependencies, calls all callbacks, and wires everything together.
+*/
+function instantiateFragment(definition, config, routesOrFactories, options, serviceImplementations, instantiationOptions) {
+	const { dryRun = false } = instantiationOptions ?? {};
+	const serviceDependencies = definition.serviceDependencies;
+	if (serviceDependencies) for (const [serviceName, meta] of Object.entries(serviceDependencies)) {
+		const metadata = meta;
+		const implementation = serviceImplementations?.[serviceName];
+		if (metadata.required && !implementation) throw new Error(`Fragment '${definition.name}' requires service '${metadata.name}' but it was not provided`);
+	}
+	let deps;
+	try {
+		deps = definition.dependencies?.({
+			config,
+			options
+		}) ?? {};
+	} catch (error) {
+		if (dryRun) {
+			console.warn("Warning: Failed to initialize dependencies in dry run mode:", error instanceof Error ? error.message : String(error));
+			deps = {};
+		} else throw error;
+	}
+	const linkedFragmentInstances = {};
+	const linkedFragmentServices = {};
+	if (definition.linkedFragments) for (const [name, callback] of Object.entries(definition.linkedFragments)) {
+		const linkedFragment = callback({
+			config,
+			options,
+			serviceDependencies: serviceImplementations
+		});
+		linkedFragmentInstances[name] = linkedFragment;
+		const services$1 = linkedFragment.services;
+		for (const [serviceName, service] of Object.entries(services$1)) linkedFragmentServices[serviceName] = service;
+	}
+	const defineService = (services$1) => services$1;
+	const privateServices = { ...linkedFragmentServices };
+	if (definition.privateServices) for (const [serviceName, factory] of Object.entries(definition.privateServices)) {
+		const serviceFactory = factory;
+		try {
+			privateServices[serviceName] = serviceFactory({
+				config,
+				options,
+				deps,
+				serviceDeps: serviceImplementations ?? {},
+				privateServices,
+				defineService
+			});
+		} catch (error) {
+			if (dryRun) {
+				console.warn(`Warning: Failed to initialize private service '${serviceName}' in dry run mode:`, error instanceof Error ? error.message : String(error));
+				privateServices[serviceName] = {};
+			} else throw error;
+		}
+	}
+	let baseServices;
+	try {
+		baseServices = definition.baseServices?.({
+			config,
+			options,
+			deps,
+			serviceDeps: serviceImplementations ?? {},
+			privateServices,
+			defineService
+		}) ?? {};
+	} catch (error) {
+		if (dryRun) {
+			console.warn("Warning: Failed to initialize base services in dry run mode:", error instanceof Error ? error.message : String(error));
+			baseServices = {};
+		} else throw error;
+	}
+	const namedServices = {};
+	if (definition.namedServices) for (const [serviceName, factory] of Object.entries(definition.namedServices)) {
+		const serviceFactory = factory;
+		try {
+			namedServices[serviceName] = serviceFactory({
+				config,
+				options,
+				deps,
+				serviceDeps: serviceImplementations ?? {},
+				privateServices,
+				defineService
+			});
+		} catch (error) {
+			if (dryRun) {
+				console.warn(`Warning: Failed to initialize service '${serviceName}' in dry run mode:`, error instanceof Error ? error.message : String(error));
+				namedServices[serviceName] = {};
+			} else throw error;
+		}
+	}
+	const services = {
+		...baseServices,
+		...namedServices
+	};
+	const storage = definition.getExternalStorage ? definition.getExternalStorage({
+		config,
+		options,
+		deps
+	}) : new RequestContextStorage();
+	const contexts = definition.createThisContext?.({
+		config,
+		options,
+		deps,
+		storage
+	});
+	const serviceContext = contexts?.serviceContext;
+	const handlerContext = contexts?.handlerContext;
+	const boundServices = serviceContext ? bindServicesToContext(services, serviceContext) : services;
+	const routes = resolveRouteFactories({
+		config,
+		deps,
+		services: boundServices,
+		serviceDeps: serviceImplementations ?? {}
+	}, routesOrFactories);
+	const mountRoute = getMountRoute({
+		name: definition.name,
+		mountRoute: options.mountRoute
+	});
+	const createRequestStorageWithContext = definition.createRequestStorage ? () => definition.createRequestStorage({
+		config,
+		options,
+		deps
+	}) : void 0;
+	return new FragnoInstantiatedFragment({
+		name: definition.name,
+		routes,
+		deps,
+		services: boundServices,
+		mountRoute,
+		serviceThisContext: serviceContext,
+		handlerThisContext: handlerContext,
+		storage,
+		createRequestStorage: createRequestStorageWithContext,
+		options,
+		linkedFragments: linkedFragmentInstances
+	});
+}
+/**
+* Fluent builder for instantiating fragments.
+* Provides a type-safe API for configuring and building fragment instances.
+*/
+var FragmentInstantiationBuilder = class FragmentInstantiationBuilder$1 {
+	#definition;
+	#config;
+	#routes;
+	#options;
+	#services;
+	constructor(definition, routes) {
+		this.#definition = definition;
+		this.#routes = routes;
+	}
+	/**
+	* Get the fragment definition
+	*/
+	get definition() {
+		return this.#definition;
+	}
+	/**
+	* Get the configured routes
+	*/
+	get routes() {
+		return this.#routes ?? [];
+	}
+	/**
+	* Get the configuration
+	*/
+	get config() {
+		return this.#config;
+	}
+	/**
+	* Get the options
+	*/
+	get options() {
+		return this.#options;
+	}
+	/**
+	* Set the configuration for the fragment
+	*/
+	withConfig(config) {
+		this.#config = config;
+		return this;
+	}
+	/**
+	* Set the routes for the fragment
+	*/
+	withRoutes(routes) {
+		const newBuilder = new FragmentInstantiationBuilder$1(this.#definition, routes);
+		newBuilder.#config = this.#config;
+		newBuilder.#options = this.#options;
+		newBuilder.#services = this.#services;
+		return newBuilder;
+	}
+	/**
+	* Set the options for the fragment (e.g., mountRoute, databaseAdapter)
+	*/
+	withOptions(options) {
+		this.#options = options;
+		return this;
+	}
+	/**
+	* Provide implementations for services that this fragment uses
+	*/
+	withServices(services) {
+		this.#services = services;
+		return this;
+	}
+	/**
+	* Build and return the instantiated fragment
+	*/
+	build() {
+		const dryRun = process.env["FRAGNO_INIT_DRY_RUN"] === "true";
+		return instantiateFragment(this.#definition, this.#config ?? {}, this.#routes ?? [], this.#options ?? {}, this.#services, { dryRun });
+	}
+};
+/**
+* Create a fluent builder for instantiating a fragment.
+*
+* @example
+* ```ts
+* const fragment = instantiate(myFragmentDefinition)
+*   .withConfig({ apiKey: "key" })
+*   .withRoutes([route1, route2])
+*   .withOptions({ mountRoute: "/api" })
+*   .build();
+* ```
+*/
+function instantiate(definition) {
+	return new FragmentInstantiationBuilder(definition);
+}
+
+//#endregion
+export { instantiate };
+//# sourceMappingURL=fragment-instantiator.js.map

package/dist/packages/fragno/dist/api/fragment-instantiator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-instantiator.js","names":["#name","#routes","#deps","#services","#mountRoute","#serviceThisContext","#handlerThisContext","#contextStorage","#createRequestStorage","#options","#linkedFragments","#router","#middlewareHandler","#withRequestStorage","#executeMiddleware","#executeHandler","FragmentInstantiationBuilder","#definition","#config"],"sources":["../../../../../../fragno/dist/api/fragment-instantiator.js"],"sourcesContent":["import { instantiatedFragmentFakeSymbol } from \"../internal/symbols.js\";\nimport { resolveRouteFactories } from \"./route.js\";\nimport { FragnoApiError } from \"./error.js\";\nimport { getMountRoute } from \"./internal/route.js\";\nimport { RequestInputContext } from \"./request-input-context.js\";\nimport { RequestOutputContext } from \"./request-output-context.js\";\nimport { MutableRequestState } from \"./mutable-request-state.js\";\nimport { RequestMiddlewareInputContext, RequestMiddlewareOutputContext } from \"./request-middleware.js\";\nimport { parseFragnoResponse } from \"./fragno-response.js\";\nimport { RequestContextStorage } from \"./request-context-storage.js\";\nimport { bindServicesToContext } from \"./bind-services.js\";\nimport { addRoute, createRouter, findRoute } from \"rou3\";\n\n//#region src/api/fragment-instantiator.ts\n/**\n* Instantiated fragment class with encapsulated state.\n* Provides the same public API as the old FragnoInstantiatedFragment but with better encapsulation.\n*/\nvar FragnoInstantiatedFragment = class {\n\t[instantiatedFragmentFakeSymbol] = instantiatedFragmentFakeSymbol;\n\t#name;\n\t#routes;\n\t#deps;\n\t#services;\n\t#mountRoute;\n\t#router;\n\t#middlewareHandler;\n\t#serviceThisContext;\n\t#handlerThisContext;\n\t#contextStorage;\n\t#createRequestStorage;\n\t#options;\n\t#linkedFragments;\n\tconstructor(params) {\n\t\tthis.#name = params.name;\n\t\tthis.#routes = params.routes;\n\t\tthis.#deps = params.deps;\n\t\tthis.#services = params.services;\n\t\tthis.#mountRoute = params.mountRoute;\n\t\tthis.#serviceThisContext = params.serviceThisContext;\n\t\tthis.#handlerThisContext = params.handlerThisContext;\n\t\tthis.#contextStorage = params.storage;\n\t\tthis.#createRequestStorage = params.createRequestStorage;\n\t\tthis.#options = params.options;\n\t\tthis.#linkedFragments = params.linkedFragments ?? {};\n\t\tthis.#router = createRouter();\n\t\tfor (const routeConfig of this.#routes) addRoute(this.#router, routeConfig.method.toUpperCase(), routeConfig.path, routeConfig);\n\t\tthis.handler = this.handler.bind(this);\n\t}\n\tget name() {\n\t\treturn this.#name;\n\t}\n\tget routes() {\n\t\treturn this.#routes;\n\t}\n\tget services() {\n\t\treturn this.#services;\n\t}\n\tget mountRoute() {\n\t\treturn this.#mountRoute;\n\t}\n\t/**\n\t* @internal\n\t*/\n\tget $internal() {\n\t\treturn {\n\t\t\tdeps: this.#deps,\n\t\t\toptions: this.#options,\n\t\t\tlinkedFragments: this.#linkedFragments\n\t\t};\n\t}\n\t/**\n\t* Add middleware to this fragment.\n\t* Middleware can inspect and modify requests before they reach handlers.\n\t*/\n\twithMiddleware(handler) {\n\t\tif (this.#middlewareHandler) throw new Error(\"Middleware already set\");\n\t\tthis.#middlewareHandler = handler;\n\t\treturn this;\n\t}\n\t#withRequestStorage(callback) {\n\t\tif (!this.#serviceThisContext && !this.#handlerThisContext) return callback();\n\t\tconst storageData = this.#createRequestStorage ? this.#createRequestStorage() : {};\n\t\treturn this.#contextStorage.run(storageData, callback);\n\t}\n\tinContext(callback) {\n\t\tif (this.#handlerThisContext) {\n\t\t\tconst boundCallback = callback.bind(this.#handlerThisContext);\n\t\t\treturn this.#withRequestStorage(boundCallback);\n\t\t}\n\t\treturn this.#withRequestStorage(callback);\n\t}\n\t/**\n\t* Get framework-specific handlers for this fragment.\n\t* Use this to integrate the fragment with different fullstack frameworks.\n\t*/\n\thandlersFor(framework) {\n\t\tconst handler = this.handler.bind(this);\n\t\tif (framework === \"h3\" || framework === \"nuxt\") throw new Error(`To get handlers for h3, use the 'fromWebHandler' utility function:\n        import { fromWebHandler } from \"h3\";\n        export default fromWebHandler(myFragment().handler);`);\n\t\treturn {\n\t\t\tastro: { ALL: handler },\n\t\t\t\"react-router\": {\n\t\t\t\tloader: ({ request }) => handler(request),\n\t\t\t\taction: ({ request }) => handler(request)\n\t\t\t},\n\t\t\t\"next-js\": {\n\t\t\t\tGET: handler,\n\t\t\t\tPOST: handler,\n\t\t\t\tPUT: handler,\n\t\t\t\tDELETE: handler,\n\t\t\t\tPATCH: handler,\n\t\t\t\tHEAD: handler,\n\t\t\t\tOPTIONS: handler\n\t\t\t},\n\t\t\t\"svelte-kit\": {\n\t\t\t\tGET: handler,\n\t\t\t\tPOST: handler,\n\t\t\t\tPUT: handler,\n\t\t\t\tDELETE: handler,\n\t\t\t\tPATCH: handler,\n\t\t\t\tHEAD: handler,\n\t\t\t\tOPTIONS: handler\n\t\t\t},\n\t\t\t\"solid-start\": {\n\t\t\t\tGET: ({ request }) => handler(request),\n\t\t\t\tPOST: ({ request }) => handler(request),\n\t\t\t\tPUT: ({ request }) => handler(request),\n\t\t\t\tDELETE: ({ request }) => handler(request),\n\t\t\t\tPATCH: ({ request }) => handler(request),\n\t\t\t\tHEAD: ({ request }) => handler(request),\n\t\t\t\tOPTIONS: ({ request }) => handler(request)\n\t\t\t},\n\t\t\t\"tanstack-start\": {\n\t\t\t\tGET: ({ request }) => handler(request),\n\t\t\t\tPOST: ({ request }) => handler(request),\n\t\t\t\tPUT: ({ request }) => handler(request),\n\t\t\t\tDELETE: ({ request }) => handler(request),\n\t\t\t\tPATCH: ({ request }) => handler(request),\n\t\t\t\tHEAD: ({ request }) => handler(request),\n\t\t\t\tOPTIONS: ({ request }) => handler(request)\n\t\t\t}\n\t\t}[framework];\n\t}\n\t/**\n\t* Main request handler for this fragment.\n\t* Handles routing, middleware, and error handling.\n\t*/\n\tasync handler(req) {\n\t\tconst url = new URL(req.url);\n\t\tconst pathname = url.pathname;\n\t\tconst matchRoute = pathname.startsWith(this.#mountRoute) ? pathname.slice(this.#mountRoute.length) : null;\n\t\tif (matchRoute === null) return Response.json({\n\t\t\terror: `Fragno: Route for '${this.#name}' not found. Is the fragment mounted on the right route? Expecting: '${this.#mountRoute}'.`,\n\t\t\tcode: \"ROUTE_NOT_FOUND\"\n\t\t}, { status: 404 });\n\t\tconst route = findRoute(this.#router, req.method, matchRoute);\n\t\tif (!route) return Response.json({\n\t\t\terror: `Fragno: Route for '${this.#name}' not found`,\n\t\t\tcode: \"ROUTE_NOT_FOUND\"\n\t\t}, { status: 404 });\n\t\tlet requestBody = void 0;\n\t\tlet rawBody = void 0;\n\t\tif (req.body instanceof ReadableStream) {\n\t\t\trawBody = await req.clone().text();\n\t\t\tif (rawBody) try {\n\t\t\t\trequestBody = JSON.parse(rawBody);\n\t\t\t} catch {\n\t\t\t\trequestBody = void 0;\n\t\t\t}\n\t\t}\n\t\tconst requestState = new MutableRequestState({\n\t\t\tpathParams: route.params ?? {},\n\t\t\tsearchParams: url.searchParams,\n\t\t\tbody: requestBody,\n\t\t\theaders: new Headers(req.headers)\n\t\t});\n\t\tconst executeRequest = async () => {\n\t\t\tif (this.#middlewareHandler) {\n\t\t\t\tconst middlewareResult = await this.#executeMiddleware(req, route, requestState);\n\t\t\t\tif (middlewareResult !== void 0) return middlewareResult;\n\t\t\t}\n\t\t\treturn this.#executeHandler(req, route, requestState, rawBody);\n\t\t};\n\t\treturn this.#withRequestStorage(executeRequest);\n\t}\n\t/**\n\t* Call a route directly with typed inputs and outputs.\n\t* Useful for testing and server-side route calls.\n\t*/\n\tasync callRoute(method, path, inputOptions) {\n\t\treturn parseFragnoResponse(await this.callRouteRaw(method, path, inputOptions));\n\t}\n\t/**\n\t* Call a route directly and get the raw Response object.\n\t* Useful for testing and server-side route calls.\n\t*/\n\tasync callRouteRaw(method, path, inputOptions) {\n\t\tconst route = this.#routes.find((r) => r.method === method && r.path === path);\n\t\tif (!route) return Response.json({\n\t\t\terror: `Route ${method} ${path} not found`,\n\t\t\tcode: \"ROUTE_NOT_FOUND\"\n\t\t}, { status: 404 });\n\t\tconst { pathParams = {}, body, query, headers } = inputOptions || {};\n\t\tconst searchParams = query instanceof URLSearchParams ? query : query ? new URLSearchParams(query) : new URLSearchParams();\n\t\tconst requestHeaders = headers instanceof Headers ? headers : headers ? new Headers(headers) : new Headers();\n\t\tconst inputContext = new RequestInputContext({\n\t\t\tpath: route.path,\n\t\t\tmethod: route.method,\n\t\t\tpathParams,\n\t\t\tsearchParams,\n\t\t\theaders: requestHeaders,\n\t\t\tparsedBody: body,\n\t\t\tinputSchema: route.inputSchema,\n\t\t\tshouldValidateInput: true\n\t\t});\n\t\tconst outputContext = new RequestOutputContext(route.outputSchema);\n\t\tconst executeHandler = async () => {\n\t\t\ttry {\n\t\t\t\tconst thisContext = this.#handlerThisContext ?? {};\n\t\t\t\treturn await route.handler.call(thisContext, inputContext, outputContext);\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"Error in callRoute handler\", error);\n\t\t\t\tif (error instanceof FragnoApiError) return error.toResponse();\n\t\t\t\treturn Response.json({\n\t\t\t\t\terror: \"Internal server error\",\n\t\t\t\t\tcode: \"INTERNAL_SERVER_ERROR\"\n\t\t\t\t}, { status: 500 });\n\t\t\t}\n\t\t};\n\t\treturn this.#withRequestStorage(executeHandler);\n\t}\n\t/**\n\t* Execute middleware for a request.\n\t* Returns undefined if middleware allows the request to continue to the handler.\n\t*/\n\tasync #executeMiddleware(req, route, requestState) {\n\t\tif (!this.#middlewareHandler || !route) return;\n\t\tconst { path } = route.data;\n\t\tconst middlewareInputContext = new RequestMiddlewareInputContext(this.#routes, {\n\t\t\tmethod: req.method,\n\t\t\tpath,\n\t\t\trequest: req,\n\t\t\tstate: requestState\n\t\t});\n\t\tconst middlewareOutputContext = new RequestMiddlewareOutputContext(this.#deps, this.#services);\n\t\ttry {\n\t\t\tconst middlewareResult = await this.#middlewareHandler(middlewareInputContext, middlewareOutputContext);\n\t\t\tif (middlewareResult !== void 0) return middlewareResult;\n\t\t} catch (error) {\n\t\t\tconsole.error(\"Error in middleware\", error);\n\t\t\tif (error instanceof FragnoApiError) return error.toResponse();\n\t\t\treturn Response.json({\n\t\t\t\terror: \"Internal server error\",\n\t\t\t\tcode: \"INTERNAL_SERVER_ERROR\"\n\t\t\t}, { status: 500 });\n\t\t}\n\t}\n\t/**\n\t* Execute a route handler with proper error handling.\n\t*/\n\tasync #executeHandler(req, route, requestState, rawBody) {\n\t\tif (!route) return Response.json({\n\t\t\terror: \"Route not found\",\n\t\t\tcode: \"ROUTE_NOT_FOUND\"\n\t\t}, { status: 404 });\n\t\tconst { handler, inputSchema, outputSchema, path } = route.data;\n\t\tconst inputContext = await RequestInputContext.fromRequest({\n\t\t\trequest: req,\n\t\t\tmethod: req.method,\n\t\t\tpath,\n\t\t\tpathParams: route.params ?? {},\n\t\t\tinputSchema,\n\t\t\tstate: requestState,\n\t\t\trawBody\n\t\t});\n\t\tconst outputContext = new RequestOutputContext(outputSchema);\n\t\ttry {\n\t\t\tconst contextForHandler = this.#handlerThisContext ?? {};\n\t\t\treturn await handler.call(contextForHandler, inputContext, outputContext);\n\t\t} catch (error) {\n\t\t\tconsole.error(\"Error in handler\", error);\n\t\t\tif (error instanceof FragnoApiError) return error.toResponse();\n\t\t\treturn Response.json({\n\t\t\t\terror: \"Internal server error\",\n\t\t\t\tcode: \"INTERNAL_SERVER_ERROR\"\n\t\t\t}, { status: 500 });\n\t\t}\n\t}\n};\n/**\n* Core instantiation function that creates a fragment instance from a definition.\n* This function validates dependencies, calls all callbacks, and wires everything together.\n*/\nfunction instantiateFragment(definition, config, routesOrFactories, options, serviceImplementations, instantiationOptions) {\n\tconst { dryRun = false } = instantiationOptions ?? {};\n\tconst serviceDependencies = definition.serviceDependencies;\n\tif (serviceDependencies) for (const [serviceName, meta] of Object.entries(serviceDependencies)) {\n\t\tconst metadata = meta;\n\t\tconst implementation = serviceImplementations?.[serviceName];\n\t\tif (metadata.required && !implementation) throw new Error(`Fragment '${definition.name}' requires service '${metadata.name}' but it was not provided`);\n\t}\n\tlet deps;\n\ttry {\n\t\tdeps = definition.dependencies?.({\n\t\t\tconfig,\n\t\t\toptions\n\t\t}) ?? {};\n\t} catch (error) {\n\t\tif (dryRun) {\n\t\t\tconsole.warn(\"Warning: Failed to initialize dependencies in dry run mode:\", error instanceof Error ? error.message : String(error));\n\t\t\tdeps = {};\n\t\t} else throw error;\n\t}\n\tconst linkedFragmentInstances = {};\n\tconst linkedFragmentServices = {};\n\tif (definition.linkedFragments) for (const [name, callback] of Object.entries(definition.linkedFragments)) {\n\t\tconst linkedFragment = callback({\n\t\t\tconfig,\n\t\t\toptions,\n\t\t\tserviceDependencies: serviceImplementations\n\t\t});\n\t\tlinkedFragmentInstances[name] = linkedFragment;\n\t\tconst services$1 = linkedFragment.services;\n\t\tfor (const [serviceName, service] of Object.entries(services$1)) linkedFragmentServices[serviceName] = service;\n\t}\n\tconst defineService = (services$1) => services$1;\n\tconst privateServices = { ...linkedFragmentServices };\n\tif (definition.privateServices) for (const [serviceName, factory] of Object.entries(definition.privateServices)) {\n\t\tconst serviceFactory = factory;\n\t\ttry {\n\t\t\tprivateServices[serviceName] = serviceFactory({\n\t\t\t\tconfig,\n\t\t\t\toptions,\n\t\t\t\tdeps,\n\t\t\t\tserviceDeps: serviceImplementations ?? {},\n\t\t\t\tprivateServices,\n\t\t\t\tdefineService\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (dryRun) {\n\t\t\t\tconsole.warn(`Warning: Failed to initialize private service '${serviceName}' in dry run mode:`, error instanceof Error ? error.message : String(error));\n\t\t\t\tprivateServices[serviceName] = {};\n\t\t\t} else throw error;\n\t\t}\n\t}\n\tlet baseServices;\n\ttry {\n\t\tbaseServices = definition.baseServices?.({\n\t\t\tconfig,\n\t\t\toptions,\n\t\t\tdeps,\n\t\t\tserviceDeps: serviceImplementations ?? {},\n\t\t\tprivateServices,\n\t\t\tdefineService\n\t\t}) ?? {};\n\t} catch (error) {\n\t\tif (dryRun) {\n\t\t\tconsole.warn(\"Warning: Failed to initialize base services in dry run mode:\", error instanceof Error ? error.message : String(error));\n\t\t\tbaseServices = {};\n\t\t} else throw error;\n\t}\n\tconst namedServices = {};\n\tif (definition.namedServices) for (const [serviceName, factory] of Object.entries(definition.namedServices)) {\n\t\tconst serviceFactory = factory;\n\t\ttry {\n\t\t\tnamedServices[serviceName] = serviceFactory({\n\t\t\t\tconfig,\n\t\t\t\toptions,\n\t\t\t\tdeps,\n\t\t\t\tserviceDeps: serviceImplementations ?? {},\n\t\t\t\tprivateServices,\n\t\t\t\tdefineService\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tif (dryRun) {\n\t\t\t\tconsole.warn(`Warning: Failed to initialize service '${serviceName}' in dry run mode:`, error instanceof Error ? error.message : String(error));\n\t\t\t\tnamedServices[serviceName] = {};\n\t\t\t} else throw error;\n\t\t}\n\t}\n\tconst services = {\n\t\t...baseServices,\n\t\t...namedServices\n\t};\n\tconst storage = definition.getExternalStorage ? definition.getExternalStorage({\n\t\tconfig,\n\t\toptions,\n\t\tdeps\n\t}) : new RequestContextStorage();\n\tconst contexts = definition.createThisContext?.({\n\t\tconfig,\n\t\toptions,\n\t\tdeps,\n\t\tstorage\n\t});\n\tconst serviceContext = contexts?.serviceContext;\n\tconst handlerContext = contexts?.handlerContext;\n\tconst boundServices = serviceContext ? bindServicesToContext(services, serviceContext) : services;\n\tconst routes = resolveRouteFactories({\n\t\tconfig,\n\t\tdeps,\n\t\tservices: boundServices,\n\t\tserviceDeps: serviceImplementations ?? {}\n\t}, routesOrFactories);\n\tconst mountRoute = getMountRoute({\n\t\tname: definition.name,\n\t\tmountRoute: options.mountRoute\n\t});\n\tconst createRequestStorageWithContext = definition.createRequestStorage ? () => definition.createRequestStorage({\n\t\tconfig,\n\t\toptions,\n\t\tdeps\n\t}) : void 0;\n\treturn new FragnoInstantiatedFragment({\n\t\tname: definition.name,\n\t\troutes,\n\t\tdeps,\n\t\tservices: boundServices,\n\t\tmountRoute,\n\t\tserviceThisContext: serviceContext,\n\t\thandlerThisContext: handlerContext,\n\t\tstorage,\n\t\tcreateRequestStorage: createRequestStorageWithContext,\n\t\toptions,\n\t\tlinkedFragments: linkedFragmentInstances\n\t});\n}\n/**\n* Fluent builder for instantiating fragments.\n* Provides a type-safe API for configuring and building fragment instances.\n*/\nvar FragmentInstantiationBuilder = class FragmentInstantiationBuilder {\n\t#definition;\n\t#config;\n\t#routes;\n\t#options;\n\t#services;\n\tconstructor(definition, routes) {\n\t\tthis.#definition = definition;\n\t\tthis.#routes = routes;\n\t}\n\t/**\n\t* Get the fragment definition\n\t*/\n\tget definition() {\n\t\treturn this.#definition;\n\t}\n\t/**\n\t* Get the configured routes\n\t*/\n\tget routes() {\n\t\treturn this.#routes ?? [];\n\t}\n\t/**\n\t* Get the configuration\n\t*/\n\tget config() {\n\t\treturn this.#config;\n\t}\n\t/**\n\t* Get the options\n\t*/\n\tget options() {\n\t\treturn this.#options;\n\t}\n\t/**\n\t* Set the configuration for the fragment\n\t*/\n\twithConfig(config) {\n\t\tthis.#config = config;\n\t\treturn this;\n\t}\n\t/**\n\t* Set the routes for the fragment\n\t*/\n\twithRoutes(routes) {\n\t\tconst newBuilder = new FragmentInstantiationBuilder(this.#definition, routes);\n\t\tnewBuilder.#config = this.#config;\n\t\tnewBuilder.#options = this.#options;\n\t\tnewBuilder.#services = this.#services;\n\t\treturn newBuilder;\n\t}\n\t/**\n\t* Set the options for the fragment (e.g., mountRoute, databaseAdapter)\n\t*/\n\twithOptions(options) {\n\t\tthis.#options = options;\n\t\treturn this;\n\t}\n\t/**\n\t* Provide implementations for services that this fragment uses\n\t*/\n\twithServices(services) {\n\t\tthis.#services = services;\n\t\treturn this;\n\t}\n\t/**\n\t* Build and return the instantiated fragment\n\t*/\n\tbuild() {\n\t\tconst dryRun = process.env[\"FRAGNO_INIT_DRY_RUN\"] === \"true\";\n\t\treturn instantiateFragment(this.#definition, this.#config ?? {}, this.#routes ?? [], this.#options ?? {}, this.#services, { dryRun });\n\t}\n};\n/**\n* Create a fluent builder for instantiating a fragment.\n*\n* @example\n* ```ts\n* const fragment = instantiate(myFragmentDefinition)\n*   .withConfig({ apiKey: \"key\" })\n*   .withRoutes([route1, route2])\n*   .withOptions({ mountRoute: \"/api\" })\n*   .build();\n* ```\n*/\nfunction instantiate(definition) {\n\treturn new FragmentInstantiationBuilder(definition);\n}\n\n//#endregion\nexport { FragmentInstantiationBuilder, FragnoInstantiatedFragment, instantiate, instantiateFragment };\n//# sourceMappingURL=fragment-instantiator.js.map"],"mappings":"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"}

package/dist/packages/fragno/dist/api/fragno-response.js

@@ -0,0 +1,73 @@
+//#region ../fragno/dist/api/fragno-response.js
+/**
+* Parse a Response object into a FragnoResponse discriminated union
+*/
+async function parseFragnoResponse(response) {
+	const status = response.status;
+	const headers = response.headers;
+	if ((headers.get("content-type") || "").includes("application/x-ndjson")) return {
+		type: "jsonStream",
+		status,
+		headers,
+		stream: parseNDJSONStream(response)
+	};
+	const text = await response.text();
+	if (!text || text === "null") return {
+		type: "empty",
+		status,
+		headers
+	};
+	const data = JSON.parse(text);
+	if (data && typeof data === "object" && "code" in data) {
+		if ("message" in data) return {
+			type: "error",
+			status,
+			headers,
+			error: {
+				message: data.message,
+				code: data.code
+			}
+		};
+		if ("error" in data) return {
+			type: "error",
+			status,
+			headers,
+			error: {
+				message: data.error,
+				code: data.code
+			}
+		};
+	}
+	return {
+		type: "json",
+		status,
+		headers,
+		data
+	};
+}
+/**
+* Parse an NDJSON stream into an async generator
+*/
+async function* parseNDJSONStream(response) {
+	if (!response.body) return;
+	const reader = response.body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			const lines = buffer.split("\n");
+			buffer = lines.pop() || "";
+			for (const line of lines) if (line.trim()) yield JSON.parse(line);
+		}
+		if (buffer.trim()) yield JSON.parse(buffer);
+	} finally {
+		reader.releaseLock();
+	}
+}
+
+//#endregion
+export { parseFragnoResponse };
+//# sourceMappingURL=fragno-response.js.map

package/dist/packages/fragno/dist/api/fragno-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragno-response.js","names":[],"sources":["../../../../../../fragno/dist/api/fragno-response.js"],"sourcesContent":["//#region src/api/fragno-response.ts\n/**\n* Parse a Response object into a FragnoResponse discriminated union\n*/\nasync function parseFragnoResponse(response) {\n\tconst status = response.status;\n\tconst headers = response.headers;\n\tif ((headers.get(\"content-type\") || \"\").includes(\"application/x-ndjson\")) return {\n\t\ttype: \"jsonStream\",\n\t\tstatus,\n\t\theaders,\n\t\tstream: parseNDJSONStream(response)\n\t};\n\tconst text = await response.text();\n\tif (!text || text === \"null\") return {\n\t\ttype: \"empty\",\n\t\tstatus,\n\t\theaders\n\t};\n\tconst data = JSON.parse(text);\n\tif (data && typeof data === \"object\" && \"code\" in data) {\n\t\tif (\"message\" in data) return {\n\t\t\ttype: \"error\",\n\t\t\tstatus,\n\t\t\theaders,\n\t\t\terror: {\n\t\t\t\tmessage: data.message,\n\t\t\t\tcode: data.code\n\t\t\t}\n\t\t};\n\t\tif (\"error\" in data) return {\n\t\t\ttype: \"error\",\n\t\t\tstatus,\n\t\t\theaders,\n\t\t\terror: {\n\t\t\t\tmessage: data.error,\n\t\t\t\tcode: data.code\n\t\t\t}\n\t\t};\n\t}\n\treturn {\n\t\ttype: \"json\",\n\t\tstatus,\n\t\theaders,\n\t\tdata\n\t};\n}\n/**\n* Parse an NDJSON stream into an async generator\n*/\nasync function* parseNDJSONStream(response) {\n\tif (!response.body) return;\n\tconst reader = response.body.getReader();\n\tconst decoder = new TextDecoder();\n\tlet buffer = \"\";\n\ttry {\n\t\twhile (true) {\n\t\t\tconst { done, value } = await reader.read();\n\t\t\tif (done) break;\n\t\t\tbuffer += decoder.decode(value, { stream: true });\n\t\t\tconst lines = buffer.split(\"\\n\");\n\t\t\tbuffer = lines.pop() || \"\";\n\t\t\tfor (const line of lines) if (line.trim()) yield JSON.parse(line);\n\t\t}\n\t\tif (buffer.trim()) yield JSON.parse(buffer);\n\t} finally {\n\t\treader.releaseLock();\n\t}\n}\n\n//#endregion\nexport { parseFragnoResponse };\n//# sourceMappingURL=fragno-response.js.map"],"mappings":";;;;AAIA,eAAe,oBAAoB,UAAU;CAC5C,MAAM,SAAS,SAAS;CACxB,MAAM,UAAU,SAAS;AACzB,MAAK,QAAQ,IAAI,eAAe,IAAI,IAAI,SAAS,uBAAuB,CAAE,QAAO;EAChF,MAAM;EACN;EACA;EACA,QAAQ,kBAAkB,SAAS;EACnC;CACD,MAAM,OAAO,MAAM,SAAS,MAAM;AAClC,KAAI,CAAC,QAAQ,SAAS,OAAQ,QAAO;EACpC,MAAM;EACN;EACA;EACA;CACD,MAAM,OAAO,KAAK,MAAM,KAAK;AAC7B,KAAI,QAAQ,OAAO,SAAS,YAAY,UAAU,MAAM;AACvD,MAAI,aAAa,KAAM,QAAO;GAC7B,MAAM;GACN;GACA;GACA,OAAO;IACN,SAAS,KAAK;IACd,MAAM,KAAK;IACX;GACD;AACD,MAAI,WAAW,KAAM,QAAO;GAC3B,MAAM;GACN;GACA;GACA,OAAO;IACN,SAAS,KAAK;IACd,MAAM,KAAK;IACX;GACD;;AAEF,QAAO;EACN,MAAM;EACN;EACA;EACA;EACA;;;;;AAKF,gBAAgB,kBAAkB,UAAU;AAC3C,KAAI,CAAC,SAAS,KAAM;CACpB,MAAM,SAAS,SAAS,KAAK,WAAW;CACxC,MAAM,UAAU,IAAI,aAAa;CACjC,IAAI,SAAS;AACb,KAAI;AACH,SAAO,MAAM;GACZ,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,OAAI,KAAM;AACV,aAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC;GACjD,MAAM,QAAQ,OAAO,MAAM,KAAK;AAChC,YAAS,MAAM,KAAK,IAAI;AACxB,QAAK,MAAM,QAAQ,MAAO,KAAI,KAAK,MAAM,CAAE,OAAM,KAAK,MAAM,KAAK;;AAElE,MAAI,OAAO,MAAM,CAAE,OAAM,KAAK,MAAM,OAAO;WAClC;AACT,SAAO,aAAa"}