@fragno-dev/db 0.3.0 → 0.4.1

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

@@ -1,669 +0,0 @@
-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 { recordTraceEvent } from "../internal/trace-context.js";
-import { addRoute, createRouter, findRoute } from "../../../../node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.js";
-
-//#region ../fragno/dist/api/fragment-instantiator.js
-const serializeHeadersForTrace = (headers) => Array.from(headers.entries()).sort(([a], [b]) => a.localeCompare(b));
-const serializeQueryForTrace = (query) => Array.from(query.entries()).sort(([a], [b]) => a.localeCompare(b));
-const serializeBodyForTrace = (body) => {
-	if (body instanceof FormData) return {
-		type: "form-data",
-		entries: Array.from(body.entries()).map(([key, value]) => {
-			if (value instanceof Blob) return [key, {
-				type: "blob",
-				size: value.size,
-				mime: value.type
-			}];
-			return [key, value];
-		})
-	};
-	if (body instanceof Blob) return {
-		type: "blob",
-		size: body.size,
-		mime: body.type
-	};
-	if (body instanceof ReadableStream) return { type: "stream" };
-	return body;
-};
-const INTERNAL_LINKED_FRAGMENT_NAME = "_fragno_internal";
-const INTERNAL_ROUTE_PREFIX = "/_internal";
-function normalizeRoutePrefix(prefix) {
-	if (!prefix.startsWith("/")) prefix = `/${prefix}`;
-	return prefix.endsWith("/") && prefix.length > 1 ? prefix.slice(0, -1) : prefix;
-}
-function joinRoutePath(prefix, path) {
-	const normalizedPrefix = normalizeRoutePrefix(prefix);
-	if (!path || path === "/") return normalizedPrefix;
-	return `${normalizedPrefix}${path.startsWith("/") ? path : `/${path}`}`;
-}
-function collectLinkedFragmentRoutes(linkedFragments) {
-	const linkedRoutes = [];
-	for (const [name, fragment] of Object.entries(linkedFragments)) {
-		if (name !== INTERNAL_LINKED_FRAGMENT_NAME) continue;
-		const internalRoutes = fragment.routes ?? [];
-		if (internalRoutes.length === 0) continue;
-		for (const route of internalRoutes) linkedRoutes.push({
-			...route,
-			path: joinRoutePath(INTERNAL_ROUTE_PREFIX, route.path),
-			__internal: {
-				fragment,
-				originalPath: route.path,
-				routes: internalRoutes
-			}
-		});
-	}
-	return linkedRoutes;
-}
-/**
-* Instantiated fragment class with encapsulated state.
-* Provides the same public API as the old FragnoInstantiatedFragment but with better encapsulation.
-*/
-var FragnoInstantiatedFragment = class FragnoInstantiatedFragment$1 {
-	[instantiatedFragmentFakeSymbol] = instantiatedFragmentFakeSymbol;
-	#name;
-	#routes;
-	#deps;
-	#services;
-	#mountRoute;
-	#router;
-	#middlewareHandler;
-	#serviceThisContext;
-	#handlerThisContext;
-	#contextStorage;
-	#createRequestStorage;
-	#options;
-	#linkedFragments;
-	#internalData;
-	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.#internalData = params.internalData ?? {};
-		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,
-			...this.#internalData
-		};
-	}
-	/**
-	* 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 });
-		const routeConfig = route.data;
-		const expectedContentType = routeConfig.contentType ?? "application/json";
-		let requestBody = void 0;
-		let rawBody = void 0;
-		if (req.body instanceof ReadableStream) {
-			const requestContentType = (req.headers.get("content-type") ?? "").toLowerCase();
-			if (expectedContentType === "multipart/form-data") {
-				if (!requestContentType.includes("multipart/form-data")) return Response.json({
-					error: `This endpoint expects multipart/form-data, but received: ${requestContentType || "no content-type"}`,
-					code: "UNSUPPORTED_MEDIA_TYPE"
-				}, { status: 415 });
-				try {
-					requestBody = await req.formData();
-				} catch {
-					return Response.json({
-						error: "Failed to parse multipart form data",
-						code: "INVALID_REQUEST_BODY"
-					}, { status: 400 });
-				}
-			} else if (expectedContentType === "application/octet-stream") {
-				if (!requestContentType.includes("application/octet-stream")) return Response.json({
-					error: `This endpoint expects application/octet-stream, but received: ${requestContentType || "no content-type"}`,
-					code: "UNSUPPORTED_MEDIA_TYPE"
-				}, { status: 415 });
-				requestBody = req.body ?? new ReadableStream();
-			} else {
-				if (requestContentType.includes("multipart/form-data")) return Response.json({
-					error: `This endpoint expects JSON, but received multipart/form-data. Use a route with contentType: "multipart/form-data" for file uploads.`,
-					code: "UNSUPPORTED_MEDIA_TYPE"
-				}, { status: 415 });
-				rawBody = await req.clone().text();
-				if (rawBody) try {
-					requestBody = JSON.parse(rawBody);
-				} catch {
-					requestBody = void 0;
-				}
-			}
-		}
-		const decodedRouteParams = {};
-		for (const [key, value] of Object.entries(route.params ?? {})) decodedRouteParams[key] = decodeURIComponent(value);
-		const requestState = new MutableRequestState({
-			pathParams: decodedRouteParams,
-			searchParams: url.searchParams,
-			body: requestBody,
-			headers: new Headers(req.headers)
-		});
-		const executeRequest = async () => {
-			const middlewareResult = await this.#executeMiddleware(req, route, requestState);
-			if (middlewareResult !== void 0) return middlewareResult;
-			const internalMeta = routeConfig.__internal;
-			if (internalMeta) {
-				const internalResult = await FragnoInstantiatedFragment$1.#runMiddlewareForFragment(internalMeta.fragment, {
-					req,
-					method: routeConfig.method,
-					path: internalMeta.originalPath,
-					requestState,
-					routes: internalMeta.routes
-				});
-				if (internalResult !== void 0) return internalResult;
-			}
-			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
-		});
-		recordTraceEvent({
-			type: "route-input",
-			method: route.method,
-			path: route.path,
-			pathParams: pathParams ?? {},
-			queryParams: serializeQueryForTrace(searchParams),
-			headers: serializeHeadersForTrace(requestHeaders),
-			body: serializeBodyForTrace(body)
-		});
-		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 (!route) return;
-		const { path } = route.data;
-		return FragnoInstantiatedFragment$1.#runMiddlewareForFragment(this, {
-			req,
-			method: req.method,
-			path,
-			requestState
-		});
-	}
-	static async #runMiddlewareForFragment(fragment, options) {
-		if (!fragment.#middlewareHandler) return;
-		const middlewareInputContext = new RequestMiddlewareInputContext(options.routes ?? fragment.#routes, {
-			method: options.method,
-			path: options.path,
-			request: options.req,
-			state: options.requestState
-		});
-		const middlewareOutputContext = new RequestMiddlewareOutputContext(fragment.#deps, fragment.#services);
-		try {
-			const middlewareResult = await fragment.#middlewareHandler(middlewareInputContext, middlewareOutputContext);
-			recordTraceEvent({
-				type: "middleware-decision",
-				method: options.method,
-				path: options.path,
-				outcome: middlewareResult ? "deny" : "allow",
-				status: middlewareResult?.status
-			});
-			if (middlewareResult !== void 0) return middlewareResult;
-		} catch (error) {
-			console.error("Error in middleware", error);
-			recordTraceEvent({
-				type: "middleware-decision",
-				method: options.method,
-				path: options.path,
-				outcome: "deny",
-				status: error instanceof FragnoApiError ? error.status : 500
-			});
-			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
-		});
-		recordTraceEvent({
-			type: "route-input",
-			method: req.method,
-			path,
-			pathParams: inputContext.pathParams,
-			queryParams: serializeQueryForTrace(requestState.searchParams),
-			headers: serializeHeadersForTrace(requestState.headers),
-			body: serializeBodyForTrace(requestState.body)
-		});
-		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 internalData = definition.internalDataFactory?.({
-		config,
-		options,
-		deps,
-		linkedFragments: linkedFragmentInstances
-	}) ?? {};
-	const boundServices = serviceContext ? bindServicesToContext(services, serviceContext) : services;
-	const routes = resolveRouteFactories({
-		config,
-		deps,
-		services: boundServices,
-		serviceDeps: serviceImplementations ?? {}
-	}, routesOrFactories);
-	const linkedRoutes = collectLinkedFragmentRoutes(linkedFragmentInstances);
-	const finalRoutes = linkedRoutes.length > 0 ? [...routes, ...linkedRoutes] : routes;
-	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: finalRoutes,
-		deps,
-		services: boundServices,
-		mountRoute,
-		serviceThisContext: serviceContext,
-		handlerThisContext: handlerContext,
-		storage,
-		createRequestStorage: createRequestStorageWithContext,
-		options,
-		linkedFragments: linkedFragmentInstances,
-		internalData
-	});
-}
-/**
-* 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