semola 0.6.0 → 0.6.1

package/README.md

@@ -26,7 +26,7 @@ Type-safe APIs, Redis queues, pub/sub, i18n, caching & auth with tree-shakeable
 | **🔐 Policy**        | Policy-based authorization with type-safe guards       | `semola/policy`   |
 | **🌍 i18n**          | Compile-time validated internationalization            | `semola/i18n`     |
 | **💾 Cache**         | Redis cache wrapper with TTL & automatic serialization | `semola/cache`    |
-| **⏰ Cron**          | In-memory cron scheduler for periodic task execution   | `semola/cron`     |
+| **⏰ Cron**          | In-memory and OS cron scheduler for periodic task execution   | `semola/cron`     |
 | **🔁 Workflow**      | Durable resumable workflows with retries and hooks   | `semola/workflow` |
 | **⚠️ Errors**        | Result-based error handling without try/catch          | `semola/errors`   |
 | **📃 Logging**       | A simple logging utility                               | `semola/logging`  |
@@ -153,18 +153,30 @@ console.log(user);
 ### Schedule Recurring Tasks
 
 ```typescript
-import { Cron } from "semola/cron";
+import { Cron, RetryCronJob } from "semola/cron";
 
 const cleanup = new Cron({
   name: "daily-cleanup",
-  schedule: "0 0 * * *", // Daily at midnight
+  schedule: "@daily",
   handler: async () => {
     await deleteOldLogs();
     await archiveInactiveUsers();
   },
+  retry: new RetryCronJob({
+    maxAttempts: 2,
+    onError: (err) => console.log(`An error: ${err.error.message}`),
+    onFailedAttempt: async ({ attemptNumber, delay, error, retriesLeft }) => {
+      console.log(
+        `Attempt ${attemptNumber} failed. Retrying in ${delay}ms. ${retriesLeft} retries left.`,
+      );
+
+      await recover();
+    },
+  }),
 });
 
-cleanup.start();
+cleanup.run();
+
 ```
 
 ### Query a Database
@@ -317,7 +329,7 @@ _Higher is better for req/sec, lower is better for latency._
 - [API Framework](./docs/api.md) - Type-safe REST API framework with OpenAPI
 - [Queue](./docs/queue.md) - Redis-backed job queue with timeouts & concurrency
 - [PubSub](./docs/pubsub.md) - Type-safe Redis pub/sub
-- [Cron](./docs/cron.md) - In-memory cron scheduler for periodic task execution
+- [Cron](./docs/cron.md) - In-memory and OS cron scheduler for periodic task execution
 - [Workflow](./docs/workflow.md) - Durable and resumable workflows with retries and hooks
 - [Policy](./docs/policy.md) - Policy-based authorization
 - [i18n](./docs/i18n.md) - Type-safe internationalization

package/dist/lib/api/index.cjs

@@ -1,537 +1 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_lib_errors_index = require("../errors/index.cjs");
-//#region src/lib/api/openapi/index.ts
-const toOpenAPISchema = (schema, io = "input") => ({ schema: schema["~standard"].jsonSchema[io]({ target: "draft-2020-12" }) });
-const getSchemaDescription = (schema) => {
-	const metadata = schema["~standard"];
-	if (!metadata) return "";
-	if ("description" in metadata && typeof metadata.description === "string") return metadata.description;
-	return "";
-};
-const requestFields = [
-	"body",
-	"query",
-	"headers",
-	"cookies",
-	"params"
-];
-const mergeRequestSchemas = (schemas) => {
-	const merged = {};
-	for (const schema of schemas) {
-		if (!schema) continue;
-		for (const field of requestFields) if (schema[field]) merged[field] = schema[field];
-	}
-	return merged;
-};
-const mergeResponseSchemas = (schemas) => {
-	const merged = {};
-	for (const schema of schemas) {
-		if (!schema) continue;
-		for (const status in schema) {
-			const statusCode = Number(status);
-			const responseSchema = schema[statusCode];
-			if (responseSchema) merged[statusCode] = responseSchema;
-		}
-	}
-	return Object.keys(merged).length > 0 ? merged : void 0;
-};
-const convertSchemaToOpenApi = async (schema, io = "input") => {
-	const result = toOpenAPISchema(schema, io);
-	const { schema: jsonSchema } = result;
-	const schemaId = jsonSchema.id;
-	if (schemaId && typeof schemaId === "string") {
-		const schemaWithoutId = { ...jsonSchema };
-		delete schemaWithoutId.id;
-		delete schemaWithoutId.$schema;
-		return {
-			schema: { $ref: `#/components/schemas/${schemaId}` },
-			components: { schemas: { [schemaId]: schemaWithoutId } }
-		};
-	}
-	if (jsonSchema.$schema) {
-		const schemaWithoutMeta = { ...jsonSchema };
-		delete schemaWithoutMeta.$schema;
-		return {
-			schema: schemaWithoutMeta,
-			components: void 0
-		};
-	}
-	return result;
-};
-const convertSchemaToInlineOpenApi = async (schema, io = "input") => {
-	const { schema: jsonSchema } = toOpenAPISchema(schema, io);
-	const cleanSchema = { ...jsonSchema };
-	delete cleanSchema.$schema;
-	delete cleanSchema.id;
-	return {
-		schema: cleanSchema,
-		components: void 0
-	};
-};
-const extractParametersFromSchema = async (schema, location) => {
-	const { schema: jsonSchema, components } = await convertSchemaToInlineOpenApi(schema);
-	if (jsonSchema.type !== "object") return {
-		parameters: [],
-		components
-	};
-	if (!jsonSchema.properties) return {
-		parameters: [],
-		components
-	};
-	const parameters = [];
-	const requiredFields = jsonSchema.required ?? [];
-	for (const name in jsonSchema.properties) {
-		const propertySchema = jsonSchema.properties[name];
-		const isRequired = requiredFields.includes(name);
-		parameters.push({
-			name,
-			in: location,
-			required: isRequired,
-			schema: propertySchema
-		});
-	}
-	return {
-		parameters,
-		components
-	};
-};
-const normalizePathForOpenAPI = (path) => {
-	return path.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, "{$1}");
-};
-const extractPathParameters = (path) => {
-	const matches = path.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
-	if (!matches) return [];
-	return matches.map((match) => match.slice(1));
-};
-const paramSources = [
-	["query", "query"],
-	["headers", "header"],
-	["cookies", "cookie"]
-];
-const createParameters = async (request, path) => {
-	const parameters = [];
-	const allComponents = [];
-	for (const [field, location] of paramSources) if (request[field]) {
-		const { parameters: params, components } = await extractParametersFromSchema(request[field], location);
-		parameters.push(...params);
-		if (components) allComponents.push(components);
-	}
-	const pathParamNames = extractPathParameters(path);
-	if (pathParamNames.length > 0 && request.params) {
-		const { schema: jsonSchema, components } = await convertSchemaToInlineOpenApi(request.params);
-		if (components) allComponents.push(components);
-		if (jsonSchema.type === "object" && jsonSchema.properties) for (const name of pathParamNames) {
-			const propertySchema = jsonSchema.properties[name];
-			if (propertySchema) parameters.push({
-				name,
-				in: "path",
-				required: true,
-				schema: propertySchema
-			});
-		}
-	}
-	return {
-		parameters,
-		components: allComponents
-	};
-};
-const createRequestBody = async (bodySchema) => {
-	const { schema, components } = await convertSchemaToOpenApi(bodySchema);
-	return {
-		components,
-		requestBody: {
-			required: true,
-			content: { "application/json": { schema } }
-		}
-	};
-};
-const createResponses = async (response) => {
-	const responses = {};
-	const allComponents = [];
-	if (!response) return {
-		responses,
-		components: allComponents
-	};
-	for (const status in response) {
-		const statusCode = String(status);
-		const schema = response[Number(status)];
-		if (!schema) continue;
-		const description = getSchemaDescription(schema);
-		const { schema: jsonSchema, components } = await convertSchemaToOpenApi(schema, "output");
-		if (components) allComponents.push(components);
-		responses[statusCode] = {
-			description: description || `Response with status ${statusCode}`,
-			content: { "application/json": { schema: jsonSchema } }
-		};
-	}
-	return {
-		responses,
-		components: allComponents
-	};
-};
-const createOperation = async (route, globalMiddlewares, prefix) => {
-	const allMiddlewares = [...globalMiddlewares ?? [], ...route.middlewares ?? []];
-	const requestSchemas = [];
-	const responseSchemas = [];
-	for (const middleware of allMiddlewares) {
-		requestSchemas.push(middleware.options.request);
-		responseSchemas.push(middleware.options.response);
-	}
-	requestSchemas.push(route.request);
-	responseSchemas.push(route.response);
-	const mergedRequest = mergeRequestSchemas(requestSchemas);
-	const mergedResponse = mergeResponseSchemas(responseSchemas);
-	const { parameters, components: parameterComponents } = await createParameters(mergedRequest, prefix ? prefix + route.path : route.path);
-	const { responses, components: responseComponents } = await createResponses(mergedResponse);
-	const operation = { responses };
-	const allComponents = [];
-	allComponents.push(...responseComponents);
-	allComponents.push(...parameterComponents);
-	for (const field of [
-		"summary",
-		"description",
-		"operationId"
-	]) if (route[field]) operation[field] = route[field];
-	if (route.tags && route.tags.length > 0) operation.tags = route.tags;
-	if (parameters.length > 0) operation.parameters = parameters;
-	const bodySchema = mergedRequest.body;
-	if (bodySchema) {
-		const { requestBody, components: bodyComponents } = await createRequestBody(bodySchema);
-		operation.requestBody = requestBody;
-		if (bodyComponents) allComponents.push(bodyComponents);
-	}
-	return {
-		operation,
-		components: allComponents
-	};
-};
-const componentKeys = [
-	"schemas",
-	"responses",
-	"parameters",
-	"requestBodies"
-];
-const mergeComponents = (componentsArray) => {
-	const merged = {};
-	for (const components of componentsArray) {
-		if (!components) continue;
-		for (const key of componentKeys) if (components[key]) merged[key] = {
-			...merged[key],
-			...components[key]
-		};
-	}
-	return merged;
-};
-const generateOpenApiSpec = async (options) => {
-	const spec = {
-		openapi: "3.1.0",
-		info: {
-			title: options.title,
-			description: options.description,
-			version: options.version
-		},
-		paths: {}
-	};
-	if (options.servers && options.servers.length > 0) spec.servers = options.servers;
-	if (options.securitySchemes) spec.components = { securitySchemes: options.securitySchemes };
-	const allRouteComponents = [];
-	for (const route of options.routes) {
-		const openApiPath = normalizePathForOpenAPI(options.prefix ? options.prefix + route.path : route.path);
-		const method = route.method.toLowerCase();
-		if (!spec.paths[openApiPath]) spec.paths[openApiPath] = {};
-		const { operation, components } = await createOperation(route, options.globalMiddlewares ?? [], options.prefix);
-		spec.paths[openApiPath][method] = operation;
-		allRouteComponents.push(...components);
-	}
-	const mergedComponents = mergeComponents(allRouteComponents);
-	if (!spec.components) spec.components = {};
-	if (options.securitySchemes) spec.components.securitySchemes = options.securitySchemes;
-	for (const key of componentKeys) {
-		const value = mergedComponents[key];
-		if (value && Object.keys(value).length > 0) spec.components[key] = value;
-	}
-	return spec;
-};
-//#endregion
-//#region src/lib/api/errors.ts
-var ParseError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "ParseError";
-	}
-};
-var ValidationError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "ValidationError";
-	}
-};
-//#endregion
-//#region src/lib/api/validation/index.ts
-const validateSchema = async (schema, data) => {
-	const result = await schema["~standard"].validate(data);
-	if (!result.issues) return result.value;
-	throw new ValidationError(result.issues.map((issue) => {
-		let path = "unknown";
-		if (Array.isArray(issue.path)) path = issue.path.map(String).join(".");
-		return `${path}: ${issue.message ?? "validation failed"}`;
-	}).join(", "));
-};
-const validateBody = async (req, bodySchema, bodyCache) => {
-	if (!bodySchema) return true;
-	if (!(req.headers.get("content-type") ?? "").includes("application/json")) return;
-	if (bodyCache?.parsed) return validateSchema(bodySchema, bodyCache.value);
-	const [parseError, parsedBody] = await require_lib_errors_index.mightThrow(req.json());
-	if (parseError) throw new ParseError("Invalid JSON body");
-	if (bodyCache) {
-		bodyCache.parsed = true;
-		bodyCache.value = parsedBody;
-	}
-	return validateSchema(bodySchema, parsedBody);
-};
-const validateQuery = async (req, querySchema) => {
-	if (!querySchema) return true;
-	const qIndex = req.url.indexOf("?");
-	if (qIndex === -1) return validateSchema(querySchema, {});
-	const hashIndex = req.url.indexOf("#", qIndex + 1);
-	const queryString = hashIndex === -1 ? req.url.slice(qIndex + 1) : req.url.slice(qIndex + 1, hashIndex);
-	const searchParams = new URLSearchParams(queryString);
-	const queryParams = {};
-	for (const key of searchParams.keys()) {
-		const values = searchParams.getAll(key);
-		const [firstValue] = values;
-		if (values.length === 1) queryParams[key] = firstValue;
-		else queryParams[key] = values;
-	}
-	return validateSchema(querySchema, queryParams);
-};
-const validateHeaders = async (req, headersSchema) => {
-	if (!headersSchema) return true;
-	const headers = {};
-	req.headers.forEach((value, key) => {
-		headers[key] = value;
-	});
-	return validateSchema(headersSchema, headers);
-};
-const validateCookies = async (req, cookiesSchema) => {
-	if (!cookiesSchema) return true;
-	const cookieHeader = req.headers.get("cookie") ?? "";
-	const cookieMap = new Bun.CookieMap(cookieHeader);
-	return validateSchema(cookiesSchema, Object.fromEntries(cookieMap));
-};
-const validateParams = async (req, paramsSchema) => {
-	if (!paramsSchema) return true;
-	return validateSchema(paramsSchema, req.params);
-};
-//#endregion
-//#region src/lib/api/core/index.ts
-const defaultValidated = Object.freeze({
-	body: void 0,
-	query: void 0,
-	headers: void 0,
-	cookies: void 0,
-	params: void 0
-});
-const responseHelpers = {
-	json: (status, data) => Response.json(data, { status }),
-	text: (status, text) => new Response(text, { status }),
-	html: (status, html) => new Response(html, {
-		status,
-		headers: { "Content-Type": "text/html" }
-	}),
-	redirect: (status, url) => Response.redirect(url, status)
-};
-const noopGet = () => void 0;
-const stripTrailingSlash = (path) => {
-	if (path !== "/" && path.endsWith("/")) return path.slice(0, -1);
-	return path;
-};
-const hasSchemas = (schema) => schema && (schema.body || schema.query || schema.headers || schema.cookies || schema.params);
-const needsBodyCache = (schema) => schema?.body !== void 0;
-const shouldCreateBodyCache = (hasMiddlewares, allMiddlewares, request) => {
-	if (needsBodyCache(request)) return true;
-	if (!hasMiddlewares) return false;
-	return allMiddlewares.some((mw) => needsBodyCache(mw.options.request));
-};
-const resolveValidation = (v) => {
-	if (v === void 0 || v === true) return {
-		input: true,
-		output: true
-	};
-	if (v === false) return {
-		input: false,
-		output: false
-	};
-	return {
-		input: v.input !== false,
-		output: v.output !== false
-	};
-};
-var Api = class {
-	options;
-	routes = [];
-	constructor(options = {}) {
-		this.options = options;
-	}
-	getFullPath(path) {
-		const normalizedPath = stripTrailingSlash(path) || "/";
-		if (!this.options.prefix) return normalizedPath;
-		const normalizedPrefix = stripTrailingSlash(this.options.prefix);
-		if (normalizedPrefix === "/") return normalizedPath;
-		if (normalizedPath === "/") return normalizedPrefix;
-		return normalizedPrefix + normalizedPath;
-	}
-	async validateRequestSchema(req, schema, bodyCache) {
-		if (!schema) return {
-			success: true,
-			data: {}
-		};
-		const v = {};
-		if (schema.body) {
-			const [err, val] = await require_lib_errors_index.mightThrow(validateBody(req, schema.body, bodyCache));
-			if (err) return {
-				success: false,
-				error: err
-			};
-			v.body = val;
-		}
-		if (schema.query) {
-			const [err, val] = await require_lib_errors_index.mightThrow(validateQuery(req, schema.query));
-			if (err) return {
-				success: false,
-				error: err
-			};
-			v.query = val;
-		}
-		if (schema.headers) {
-			const [err, val] = await require_lib_errors_index.mightThrow(validateHeaders(req, schema.headers));
-			if (err) return {
-				success: false,
-				error: err
-			};
-			v.headers = val;
-		}
-		if (schema.cookies) {
-			const [err, val] = await require_lib_errors_index.mightThrow(validateCookies(req, schema.cookies));
-			if (err) return {
-				success: false,
-				error: err
-			};
-			v.cookies = val;
-		}
-		if (schema.params) {
-			const [err, val] = await require_lib_errors_index.mightThrow(validateParams(req, schema.params));
-			if (err) return {
-				success: false,
-				error: err
-			};
-			v.params = val;
-		}
-		return {
-			success: true,
-			data: v
-		};
-	}
-	createContext(req, validated, extensions) {
-		return {
-			raw: req,
-			req: validated,
-			...responseHelpers,
-			get: (key) => extensions[key]
-		};
-	}
-	async validateResponseBody(response, schema) {
-		if (!schema) return response;
-		const statusSchema = schema[response.status];
-		if (!statusSchema) return response;
-		if (!(response.headers.get("content-type") ?? "").includes("application/json")) return response;
-		const [parseError, body] = await require_lib_errors_index.mightThrow(response.clone().json());
-		if (parseError) return responseHelpers.json(400, { message: "Invalid response body" });
-		const [validationError] = await require_lib_errors_index.mightThrow(validateSchema(statusSchema, body));
-		if (validationError) return responseHelpers.json(400, { message: validationError.message });
-		return response;
-	}
-	buildBunRoutes() {
-		const bunRoutes = {};
-		const validationConfig = resolveValidation(this.options.validation);
-		for (const route of this.routes) {
-			const { path, method, handler, request, response, middlewares } = route;
-			const fullPath = this.getFullPath(path);
-			if (!bunRoutes[fullPath]) bunRoutes[fullPath] = {};
-			const allMiddlewares = [...this.options.middlewares ?? [], ...middlewares ?? []];
-			const hasMiddlewares = allMiddlewares.length > 0;
-			const hasRouteSchemas = hasSchemas(request);
-			const effectiveOutputValidation = validationConfig.output && !!response;
-			if (!hasMiddlewares && !(validationConfig.input && hasRouteSchemas) && !effectiveOutputValidation) bunRoutes[fullPath][method] = (req) => {
-				const context = Object.create(responseHelpers);
-				context.raw = req;
-				context.req = defaultValidated;
-				context.get = noopGet;
-				return handler(context);
-			};
-			else bunRoutes[fullPath][method] = async (req) => {
-				const extensions = {};
-				const bodyCache = validationConfig.input && shouldCreateBodyCache(hasMiddlewares, allMiddlewares, request) ? {
-					parsed: false,
-					value: void 0
-				} : void 0;
-				for (const mw of allMiddlewares) {
-					const { request: reqSchema, handler: mwHandler } = mw.options;
-					let validated = defaultValidated;
-					if (validationConfig.input && hasSchemas(reqSchema)) {
-						const result = await this.validateRequestSchema(req, reqSchema, bodyCache);
-						if (!result.success) return responseHelpers.json(400, { message: result.error?.message });
-						validated = result.data;
-					}
-					const mwResult = await mwHandler(this.createContext(req, validated, extensions));
-					if (mwResult instanceof Response) return mwResult;
-					if (mwResult) Object.assign(extensions, mwResult);
-				}
-				let routeValidated = defaultValidated;
-				if (validationConfig.input && hasRouteSchemas) {
-					const result = await this.validateRequestSchema(req, request, bodyCache);
-					if (!result.success) return responseHelpers.json(400, { message: result.error?.message });
-					routeValidated = result.data;
-				}
-				const handlerResponse = await handler(this.createContext(req, routeValidated, extensions));
-				if (effectiveOutputValidation) return this.validateResponseBody(handlerResponse, response);
-				return handlerResponse;
-			};
-		}
-		return bunRoutes;
-	}
-	defineRoute(config) {
-		this.routes.push(config);
-	}
-	getOpenApiSpec() {
-		return generateOpenApiSpec({
-			title: this.options.openapi?.title ?? "API",
-			description: this.options.openapi?.description,
-			version: this.options.openapi?.version ?? "1.0.0",
-			prefix: this.options.prefix,
-			servers: this.options.openapi?.servers,
-			securitySchemes: this.options.openapi?.securitySchemes,
-			routes: this.routes,
-			globalMiddlewares: this.options.middlewares
-		});
-	}
-	serve(port, callback) {
-		const bunRoutes = this.buildBunRoutes();
-		const server = Bun.serve({
-			port,
-			routes: bunRoutes,
-			fetch: () => new Response("Not found", { status: 404 })
-		});
-		if (callback) callback(server);
-	}
-};
-//#endregion
-//#region src/lib/api/middleware/index.ts
-var Middleware = class {
-	constructor(options) {
-		this.options = options;
-	}
-};
-//#endregion
-exports.Api = Api;
-exports.Middleware = Middleware;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e={status:404},t=(e,t)=>{let n=e.split(`/`).slice(1),r=[],i=0;for(let e of n){if(e.startsWith(`:`)){r.push({value:``,paramName:e.slice(1)}),i++;continue}r.push({value:e})}return{segments:r,methods:t,paramStarts:Array(i),paramEnds:Array(i)}},n=(e,t)=>{let n=1,r=0;if(t===`/`)return e.segments.length===0;for(let i of e.segments){let a=t.indexOf(`/`,n),o=t.length;if(a!==-1&&(o=a),i.paramName){if(o===n)return!1;e.paramStarts[r]=n,e.paramEnds[r]=o,r++}else{let e=o-n;if(i.value.length!==e||!t.startsWith(i.value,n))return!1}n=a===-1?t.length:a+1}return n===t.length},r=(e,t)=>{let n={},r=0;for(let i of e.segments)i.paramName&&(n[i.paramName]=t.slice(e.paramStarts[r],e.paramEnds[r]),r++);return n},i=e=>{let t=e.indexOf(`://`),n=e.indexOf(`/`,t+3);if(n===-1)return`/`;let r=e.indexOf(`?`,n),i;return i=r===-1?e.slice(n):e.slice(n,r),i.length>1&&i.endsWith(`/`)?i.slice(0,-1):i},a=a=>{let o=Object.create(null),s=[],c=[];for(let[e,n]of Object.entries(a)){let r=n;if(e.includes(`*`)){c.push({pattern:new URLPattern({pathname:e}),methods:r});continue}if(e.includes(`:`)){s.push(t(e,r));continue}o[e]=r}return t=>{let a=i(t.url),l=t.method,u=o[a]?.[l];if(u)return u(t);for(let e of s){if(!n(e,a))continue;let i=e.methods[l];if(i)return t.params=r(e,a),i(t)}for(let e of c){let n=e.pattern.exec({pathname:a});if(!n)continue;let r=e.methods[l];if(r)return t.params=n.pathname.groups,r(t)}return new Response(`Not found`,e)}},o=e=>{if(Array.isArray(e))return e.map(o);if(typeof e!=`object`||!e)return e;let t=e;if(typeof t.$ref==`string`&&t.$ref.startsWith(`#/$defs/`))return{$ref:`#/components/schemas/${t.$ref.slice(8)}`};let n={};for(let e in t)n[e]=o(t[e]);return n},s=e=>{let t=e.$defs;if(!t||typeof t!=`object`)return{schema:e,components:void 0};let n=o({...e});delete n.$defs;let r=t,i={};for(let e in r)i[e]=o(r[e]);return{schema:n,components:{schemas:i}}},c=(e,t=`input`)=>{let n=e[`~standard`].jsonSchema[t]({target:`draft-2020-12`});return s(n)},l=e=>{let t=e[`~standard`];return t&&`description`in t&&typeof t.description==`string`?t.description:``},u=e=>{let t=e.meta;if(typeof t!=`function`)return;let n=t();if(typeof n==`object`&&n&&typeof n.id==`string`)return n.id},d=(e,t)=>typeof t.id==`string`?t.id:u(e),f=[`body`,`query`,`headers`,`cookies`,`params`],p=(e,t=`input`)=>{let n=c(e,t),{schema:r,components:i}=n,a=d(e,r);if(a){let e={...r};return delete e.id,delete e.$schema,{schema:{$ref:`#/components/schemas/${a}`},components:{...i,schemas:{...i?.schemas,[a]:e}}}}if(r.$schema){let e={...r};return delete e.$schema,{schema:e,components:i}}return n},m=(e,t=`input`)=>{let{schema:n,components:r}=c(e,t),i={...n};return delete i.$schema,delete i.id,{schema:i,components:r}},h=(e,t)=>{let{schema:n,components:r}=m(e);if(n.type!==`object`||!n.properties)return{parameters:[],components:r};let i=[],a=n.required??[];for(let e in n.properties){let r=n.properties[e],o=a.includes(e);i.push({name:e,in:t,required:o,schema:r})}return{parameters:i,components:r}},g=e=>e.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g,`{$1}`),_=e=>{let t=e.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);return t?t.map(e=>e.slice(1)):[]},ee=[[`query`,`query`],[`headers`,`header`],[`cookies`,`cookie`]],te=(e,t)=>{let n=[],r=[];for(let[t,i]of ee)if(e[t]){let{parameters:a,components:o}=h(e[t],i);n.push(...a),o&&r.push(o)}let i=_(t);if(i.length>0&&e.params){let{schema:t,components:a}=m(e.params);if(a&&r.push(a),t.type===`object`&&t.properties)for(let e of i){let r=t.properties[e];r&&n.push({name:e,in:`path`,required:!0,schema:r})}}return{parameters:n,components:r}},ne=e=>{let{schema:t,components:n}=p(e);return{components:n,requestBody:{required:!0,content:{"application/json":{schema:t}}}}},re=e=>{let t={},n=[];if(!e)return{responses:t,components:n};for(let r in e){let i=String(r),a=e[Number(r)];if(!a)continue;let o=l(a),{schema:s,components:c}=p(a,`output`);c&&n.push(c),t[i]={description:o||`Response with status ${i}`,content:{"application/json":{schema:s}}}}return{responses:t,components:n}},v=(e,t,n)=>{let{request:r,response:i}=y(e,t),a=e.path;n&&(a=n+e.path);let{parameters:o,components:s}=te(r,a),{responses:c,components:l}=re(i),u={responses:c},d=[];d.push(...l),d.push(...s);for(let t of[`summary`,`description`,`operationId`])e[t]&&(u[t]=e[t]);e.tags&&e.tags.length>0&&(u.tags=e.tags),o.length>0&&(u.parameters=o);let f=r.body;if(f){let{requestBody:e,components:t}=ne(f);u.requestBody=e,t&&d.push(t)}return{operation:u,components:d}},y=(e,t)=>{let n={},r={};for(let i of[...t,...e.middlewares??[]])b(n,i.options.request),x(r,i.options.response);b(n,e.request),x(r,e.response);let i;return Object.keys(r).length>0&&(i=r),{request:n,response:i}},b=(e,t)=>{if(t)for(let n of f)t[n]&&(e[n]=t[n])},x=(e,t)=>{if(t)for(let n in t){let r=Number(n),i=t[r];i&&(e[r]=i)}},S=e=>{let t={openapi:`3.1.0`,info:{title:e.title,description:e.description,version:e.version},paths:{}};e.servers&&e.servers.length>0&&(t.servers=e.servers);let n={};for(let r of e.routes){let i=r.path;e.prefix&&(i=e.prefix+r.path);let a=g(i),o=r.method.toLowerCase();t.paths[a]??={};let{operation:s,components:c}=v(r,e.globalMiddlewares??[],e.prefix);t.paths[a][o]=s,c.forEach(e=>{Object.assign(n,e.schemas??{})})}let r=Object.keys(n).length>0;return(e.securitySchemes||r)&&(t.components={},e.securitySchemes&&(t.components.securitySchemes=e.securitySchemes),r&&(t.components.schemas=n)),t};var C=class extends Error{constructor(e){super(e),this.name=`ParseError`}},w=class extends Error{constructor(e){super(e),this.name=`ValidationError`}},T=class extends Error{constructor(e){super(e),this.name=`SchemaConfigError`}};function ie(e){if(e.path?.length){let t=``;for(let n of e.path){let e=typeof n==`object`?n.key:n;if(typeof e==`string`||typeof e==`number`)t?t+=`.${e}`:t+=e;else return null}return t}return null}const ae=e=>ie(e)??`unknown`,E=e=>e.map(e=>`${ae(e)}: ${e.message??`validation failed`}`).join(`, `),D=e=>!(!e.body||e.query||e.headers||e.cookies||e.params),O=e=>{let t=e[`~standard`].validate;return async e=>{let n=e.headers.get(`content-type`)??``,r;if(n.startsWith(`application/json`))try{r=await e.json()}catch{throw new C(`Invalid JSON body`)}else r=await e.text();let i=t(r);if(i instanceof Promise)throw new T(`Async schema validation is not supported`);if(i.issues)throw new w(E(i.issues))}},k=e=>{if(!e.issues)return e.value;throw new w(E(e.issues))},A=(e,t=!1)=>{let n=e;t&&e.includes(`+`)&&(n=e.replaceAll(`+`,` `));try{return decodeURIComponent(n)}catch{return n}},j=(e,t,n)=>{let r=e[t];if(r===void 0){e[t]=n;return}if(Array.isArray(r)){r.push(n);return}e[t]=[r,n]},M=(e,t)=>{let n=e[`~standard`].validate(t);if(n instanceof Promise)throw new T(`Async schema validation is not supported`);return k(n)},N=async(e,t,n)=>{if(!t)return!0;if(n?.parsed)return M(t,n.value);let r=e.headers.get(`content-type`)??``,i;if(r.startsWith(`application/json`))try{i=await e.json()}catch{throw new C(`Invalid JSON body`)}else i=await e.text();return n&&(n.parsed=!0,n.value=i),M(t,i)},P=(e,t)=>{if(!t)return!0;let n=e.url.indexOf(`?`);if(n===-1)return M(t,{});let r=e.url.indexOf(`#`,n+1),i=e.url.length;r!==-1&&(i=r);let a={},o=n+1;for(;o<=i;){let t=e.url.indexOf(`&`,o),n=i;if(t!==-1&&t<i&&(n=t),n>o){let t=e.url.indexOf(`=`,o),r=t!==-1&&t<n,i=e.url.slice(o,n),s=``;r&&(i=e.url.slice(o,t),s=e.url.slice(t+1,n)),j(a,A(i,!0),A(s,!0))}if(t===-1||t>=i)break;o=t+1}return M(t,a)},F=(e,t)=>{if(!t)return!0;let n={};for(let[t,r]of e.headers)n[t]=r;return M(t,n)},I=(e,t)=>{if(!t)return!0;let n=e.headers.get(`cookie`)??``,r={},i=0;for(;i<n.length;){let e=n.indexOf(`;`,i),t=n.length;e!==-1&&(t=e);let a=n.indexOf(`=`,i);if(a!==-1&&a<t){let e=n.slice(i,a).trim();if(e){let i=n.slice(a+1,t).trim();r[e]=A(i)}}if(e===-1)break;i=e+1}return M(t,r)},L=(e,t)=>t?M(t,e.params??{}):!0,R=async(e,t)=>{let n=e.schema;if(n)try{if(n.body){let r=await N(e.req,n.body,e.bodyCache);t&&(t.body=r)}if(n.query){let r=P(e.req,n.query);t&&(t.query=r)}if(n.headers){let r=F(e.req,n.headers);t&&(t.headers=r)}if(n.cookies){let r=I(e.req,n.cookies);t&&(t.cookies=r)}if(n.params){let r=L(e.req,n.params);t&&(t.params=r)}}catch(e){return e}},z=e=>{if(e){if(D(e)){let t=e.body;if(!t)return;let n=O(t);return async e=>{try{await n(e)}catch(e){return e}}}return(t,n)=>R({req:t,schema:e,bodyCache:n})}},B={"Content-Type":`text/html`},V={status:400},H=(e,t)=>e===200?Response.json(t):Response.json(t,{status:e}),U=(e,t)=>e===200?new Response(t):new Response(t,{status:e}),W=(e,t)=>new Response(t,{status:e,headers:B}),G=(e,t)=>Response.redirect(t,e),K=e=>Response.json({message:e},V),q=e=>{if(e instanceof w||e instanceof C)return K(e.message);throw e},oe=e=>(t,n)=>{let r=e[t];if(!r)return H(t,n);try{M(r,n)}catch(e){return q(e)}return H(t,n)},J=Object.freeze({body:void 0,query:void 0,headers:void 0,cookies:void 0,params:void 0}),se={req:J,get:()=>{},json:H,text:U,html:W,redirect:G},Y=(e,t,n,r)=>{let i=Object.create(se);return i.raw=e,t&&(i.req=t),n&&(i.get=n),r&&(i.json=r),i},X=e=>e!==`/`&&e.endsWith(`/`)?e.slice(0,-1):e,ce=e=>{let t=X(e.path)||`/`;if(!e.prefix)return t;let n=X(e.prefix);return n===`/`?t:t===`/`?n:n+t},le=e=>{let t=0;e.request?.body!==void 0&&t++;for(let n of e.middlewares)if(n.options.request?.body!==void 0&&(t++,t>1))return!0;return!1},ue=e=>e===void 0||e===!0?{input:!0,output:!0}:e===!1?{input:!1,output:!1}:{input:e.input!==!1,output:e.output!==!1},de=[],Z=e=>e instanceof Response?e:typeof e==`string`?new Response(e):Response.json(e),Q=async(e,t)=>{let n=Z(e),r=t?.[n.status];if(!r)return n;let i=e;e instanceof Response&&(i=await n.clone().json());try{M(r,i)}catch(e){return q(e)}return n},fe=(e,t)=>{if(e instanceof Response)return Q(e,t);let n=Z(e),r=t?.[n.status];if(!r)return n;try{M(r,e)}catch(e){return q(e)}return n},pe=(e,t,n,r=!1,i=!1)=>{let a=i?n:void 0,o;if(r&&t&&D(t)){let e=t.body;e&&(o=O(e))}let s=r&&!o?z(t):void 0,c=e();if(c instanceof Promise)return async t=>{if(o)try{await o(t)}catch(e){return q(e)}if(s){let e=await s(t);if(e)return q(e)}let n=await e();return Q(n,a)};let l=fe(c,a);if(!o&&!s)return l instanceof Promise?async()=>l:()=>l;if(o)return async e=>{try{await o(e)}catch(e){return q(e)}return l};let u=s;return u?async e=>{let t=await u(e);return t?q(t):l}:l instanceof Promise?async()=>l:()=>l},me=e=>t=>{let n=e(Y(t));return n instanceof Promise?n.then(e=>e instanceof Response?e:Z(e)):n instanceof Response?n:Z(n)},he=(e,t)=>e.middlewares?.length?t.length===0?e.middlewares:[...t,...e.middlewares]:t,ge=(e,t,n)=>{if(!e.input)return!1;if(t)return!0;for(let e of n)if(e.options.request)return!0;return!1},$=async(e,t)=>{let n,r,i;t.validateInput&&le({middlewares:t.middlewares,request:t.routeRequest})&&(i={parsed:!1,value:void 0});let a;t.validateOutput&&t.routeResponse&&(a=oe(t.routeResponse)),t.middlewares.length>0&&(r=e=>n?.[e]);for(let a of t.middlewares){let{request:o,handler:s}=a.options,c=J;if(t.validateInput&&o){let t={},n=await R({req:e,schema:o,bodyCache:i},t);if(n)return q(n);c=t}let l=await s(Y(e,c,r));if(l instanceof Response)return l;l&&(n||={},Object.assign(n,l))}let o=J;if(t.validateInput&&t.routeRequest){let n={},r=await R({req:e,schema:t.routeRequest,bodyCache:i},n);if(r)return q(r);o=n}let s=Y(e,o,r,a);return t.handler(s)},_e=(e,t,n)=>{let r=he(e,t),i=e.handler,a=r.length>0,o=ge(n,e.request,r),s=n.output&&!!e.response;if(!a&&typeof i==`function`&&i.length===0)return pe(i,e.request,e.response,o,s);if(!a&&typeof i==`function`&&i.length===1&&!o&&!s)return me(i);let c={middlewares:r,routeRequest:e.request,routeResponse:e.response,validateInput:o,validateOutput:s,handler:i};return e=>$(e,c)},ve=(e,t,n,r)=>{let i={};for(let a of e){let e=ce({prefix:t,path:a.path});i[e]||(i[e]={}),i[e][a.method]=_e(a,n,r)}return i};var ye=class{options;routes=[];routesDirty=!0;compiled;constructor(e={}){this.options=e}defineRoute(e){this.routes.push(e),this.routesDirty=!0}fetch=e=>this.ensureCompiled().fetch(e);getRouteHandlers(){return this.ensureCompiled().routes}getOpenApiSpec(){return S({title:this.options.openapi?.title??`API`,description:this.options.openapi?.description,version:this.options.openapi?.version??`1.0.0`,prefix:this.options.prefix,servers:this.options.openapi?.servers,securitySchemes:this.options.openapi?.securitySchemes,routes:this.routes,globalMiddlewares:this.options.middlewares})}serve(e,t){let n=Bun.serve({port:e,routes:this.getRouteHandlers(),fetch:()=>new Response(`Not found`,{status:404})});t&&t(n)}ensureCompiled(){if(!this.routesDirty&&this.compiled)return this.compiled;let e=ve(this.routes,this.options.prefix,this.options.middlewares??de,ue(this.options.validation));return this.compiled={routes:e,fetch:a(e)},this.routesDirty=!1,this.compiled}},be=class{options;constructor(e){this.options=e}};exports.Api=ye,exports.Middleware=be;