@fragno-dev/core 0.1.7 → 0.1.9

package/dist/api/request-context-storage.js

@@ -0,0 +1,43 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/api/request-context-storage.ts
+/**
+* Typed wrapper around AsyncLocalStorage for managing per-request data storage.
+* Each fragment instance has its own storage to ensure proper isolation.
+*
+* TRequestStorage represents the type of data stored per-request (e.g., { userId: string, requestId: number })
+*
+* Note: The data stored should be an object that can be mutated during the request lifecycle.
+* For example, you can store { uow: UnitOfWork } and modify properties on that object.
+*
+* @internal - Used by @fragno-dev/db, not part of public API
+*/
+var RequestContextStorage = class {
+	#storage;
+	constructor() {
+		this.#storage = new AsyncLocalStorage();
+	}
+	run(data, callback) {
+		return this.#storage.run(data, callback);
+	}
+	/**
+	* Get the current stored data from AsyncLocalStorage.
+	* @throws an error if called outside of a run() callback.
+	*
+	* Note: The returned object can be mutated. Changes will be visible to all code
+	* running within the same async context.
+	*/
+	getStore() {
+		const store = this.#storage.getStore();
+		if (!store) throw new Error("No storage found in RequestContextStorage. Service must be called within a route handler OR using `inContext`.");
+		return store;
+	}
+	runWithInitializer(initializer, callback) {
+		const data = initializer();
+		return this.#storage.run(data, callback);
+	}
+};
+
+//#endregion
+export { RequestContextStorage };
+//# sourceMappingURL=request-context-storage.js.map

package/dist/api/request-context-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context-storage.js","names":["#storage"],"sources":["../../src/api/request-context-storage.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\n/**\n * Typed wrapper around AsyncLocalStorage for managing per-request data storage.\n * Each fragment instance has its own storage to ensure proper isolation.\n *\n * TRequestStorage represents the type of data stored per-request (e.g., { userId: string, requestId: number })\n *\n * Note: The data stored should be an object that can be mutated during the request lifecycle.\n * For example, you can store { uow: UnitOfWork } and modify properties on that object.\n *\n * @internal - Used by @fragno-dev/db, not part of public API\n */\nexport class RequestContextStorage<TRequestStorage> {\n  #storage: AsyncLocalStorage<TRequestStorage>;\n\n  constructor() {\n    this.#storage = new AsyncLocalStorage<TRequestStorage>();\n  }\n\n  /**\n   * Run a callback with the given data available via getStore().\n   * This establishes the async context for the duration of the callback.\n   */\n  run<T>(data: TRequestStorage, callback: () => T): T;\n  run<T>(data: TRequestStorage, callback: () => Promise<T>): Promise<T>;\n  run<T>(data: TRequestStorage, callback: () => T | Promise<T>): T | Promise<T> {\n    return this.#storage.run(data, callback);\n  }\n\n  /**\n   * Get the current stored data from AsyncLocalStorage.\n   * @throws an error if called outside of a run() callback.\n   *\n   * Note: The returned object can be mutated. Changes will be visible to all code\n   * running within the same async context.\n   */\n  getStore(): TRequestStorage {\n    const store = this.#storage.getStore();\n    if (!store) {\n      throw new Error(\n        \"No storage found in RequestContextStorage. Service must be called within a route handler OR using `inContext`.\",\n      );\n    }\n    return store;\n  }\n\n  /**\n   * Enter a new async context with fresh storage.\n   * This is typically called at the start of a request handler.\n   *\n   * @param initializer Function that returns the initial storage data\n   * @param callback The request handler to execute with the storage\n   */\n  runWithInitializer<T>(initializer: () => TRequestStorage, callback: () => T): T;\n  runWithInitializer<T>(initializer: () => TRequestStorage, callback: () => Promise<T>): Promise<T>;\n  runWithInitializer<T>(\n    initializer: () => TRequestStorage,\n    callback: () => T | Promise<T>,\n  ): T | Promise<T> {\n    const data = initializer();\n    return this.#storage.run(data, callback);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAaA,IAAa,wBAAb,MAAoD;CAClD;CAEA,cAAc;AACZ,QAAKA,UAAW,IAAI,mBAAoC;;CAS1D,IAAO,MAAuB,UAAgD;AAC5E,SAAO,MAAKA,QAAS,IAAI,MAAM,SAAS;;;;;;;;;CAU1C,WAA4B;EAC1B,MAAM,QAAQ,MAAKA,QAAS,UAAU;AACtC,MAAI,CAAC,MACH,OAAM,IAAI,MACR,iHACD;AAEH,SAAO;;CAYT,mBACE,aACA,UACgB;EAChB,MAAM,OAAO,aAAa;AAC1B,SAAO,MAAKA,QAAS,IAAI,MAAM,SAAS"}

package/dist/api/request-input-context.d.ts

@@ -0,0 +1,89 @@
+import { ExtractPathParams } from "./internal/path.js";
+import { MutableRequestState } from "./mutable-request-state.js";
+import { HTTPMethod } from "./api.js";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/api/request-input-context.d.ts
+type RequestBodyType = unknown | FormData | Blob | null | undefined;
+declare class RequestInputContext<TPath extends string = string, TInputSchema extends StandardSchemaV1 | undefined = undefined> {
+  #private;
+  constructor(config: {
+    path: TPath;
+    method: string;
+    pathParams: ExtractPathParams<TPath>;
+    searchParams: URLSearchParams;
+    parsedBody: RequestBodyType;
+    rawBody?: string;
+    headers: Headers;
+    request?: Request;
+    inputSchema?: TInputSchema;
+    shouldValidateInput?: boolean;
+  });
+  /**
+   * Create a RequestContext from a Request object for server-side handling
+   */
+  static fromRequest<TPath extends string, TInputSchema extends StandardSchemaV1 | undefined = undefined>(config: {
+    request: Request;
+    method: string;
+    path: TPath;
+    pathParams: ExtractPathParams<TPath>;
+    inputSchema?: TInputSchema;
+    shouldValidateInput?: boolean;
+    state: MutableRequestState;
+    rawBody?: string;
+  }): Promise<RequestInputContext<TPath, TInputSchema>>;
+  /**
+   * Create a RequestContext for server-side rendering contexts (no Request object)
+   */
+  static fromSSRContext<TPath extends string, TInputSchema extends StandardSchemaV1 | undefined = undefined>(config: {
+    method: "GET";
+    path: TPath;
+    pathParams: ExtractPathParams<TPath>;
+    searchParams?: URLSearchParams;
+    headers?: Headers;
+  } | {
+    method: Exclude<HTTPMethod, "GET">;
+    path: TPath;
+    pathParams: ExtractPathParams<TPath>;
+    searchParams?: URLSearchParams;
+    headers?: Headers;
+    body: RequestBodyType;
+    inputSchema?: TInputSchema;
+  }): RequestInputContext<TPath, TInputSchema>;
+  /**
+   * The HTTP method as string (e.g., `GET`, `POST`)
+   */
+  get method(): string;
+  /**
+   * The matched route path (e.g., `/users/:id`)
+   * @remarks `string`
+   */
+  get path(): TPath;
+  /**
+   * Extracted path parameters as object (e.g., `{ id: '123' }`)
+   * @remarks `Record<string, string>`
+   */
+  get pathParams(): ExtractPathParams<TPath>;
+  /**
+   * [URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams) object for query parameters
+   * @remarks `URLSearchParams`
+   */
+  get query(): URLSearchParams;
+  /**
+   * [Headers](https://developer.mozilla.org/en-US/docs/Web/API/Headers) object for request headers
+   * @remarks `Headers`
+   */
+  get headers(): Headers;
+  get rawBody(): string | undefined;
+  /**
+   * Input validation context (only if inputSchema is defined)
+   * @remarks `InputContext`
+   */
+  get input(): TInputSchema extends undefined ? undefined : {
+    schema: TInputSchema;
+    valid: () => Promise<TInputSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TInputSchema> : unknown>;
+  };
+}
+//#endregion
+export { RequestBodyType, RequestInputContext };
+//# sourceMappingURL=request-input-context.d.ts.map

package/dist/api/request-input-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-input-context.d.ts","names":[],"sources":["../../src/api/request-input-context.ts"],"sourcesContent":[],"mappings":";;;;;;KAKY,eAAA,aAER,WACA;cAIS,wEAEU;EATX,CAAA,OAAA;EAOC,WAAA,CAAA,MAAA,EAAA;IAEU,IAAA,EAab,KAba;IAab,MAAA,EAAA,MAAA;IAEwB,UAAA,EAAlB,iBAAkB,CAAA,KAAA,CAAA;IAAlB,YAAA,EACE,eADF;IACE,UAAA,EACF,eADE;IACF,OAAA,CAAA,EAAA,MAAA;IAEH,OAAA,EAAA,OAAA;IACC,OAAA,CAAA,EAAA,OAAA;IACI,WAAA,CAAA,EAAA,YAAA;IAmBO,mBAAA,CAAA,EAAA,OAAA;EAEZ,CAAA;EAEH;;;EAEQ,OAAA,WAAA,CAAA,cAAA,MAAA,EAAA,qBANO,gBAMP,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA,MAAA,EAAA;IAEP,OAAA,EANE,OAMF;IAEuB,MAAA,EAAA,MAAA;IAAO,IAAA,EAN/B,KAM+B;IAA3B,UAAA,EALE,iBAKF,CALoB,KAKpB,CAAA;IAAR,WAAA,CAAA,EAJY,YAIZ;IAoBmB,mBAAA,CAAA,EAAA,OAAA;IAKT,KAAA,EA3BL,mBA2BK;IACwB,OAAA,CAAA,EAAA,MAAA;EAAlB,CAAA,CAAA,EA1BhB,OA0BgB,CA1BR,mBA0BQ,CA1BY,KA0BZ,EA1BmB,YA0BnB,CAAA,CAAA;EACG;;;EAIP,OAAA,cAAA,CAAA,cAAA,MAAA,EAAA,qBAXO,gBAWP,GAAA,SAAA,GAAA,SAAA,CAAA,CAAA,MAAA,EAAA;IACF,MAAA,EAAA,KAAA;IACwB,IAAA,EARxB,KAQwB;IAAlB,UAAA,EAPA,iBAOA,CAPkB,KAOlB,CAAA;IACG,YAAA,CAAA,EAPA,eAOA;IACL,OAAA,CAAA,EAPA,OAOA;EACJ,CAAA,GAAA;IACQ,MAAA,EANN,OAMM,CANE,UAMF,EAAA,KAAA,CAAA;IAEC,IAAA,EAPT,KAOS;IAAO,UAAA,EANV,iBAMU,CANQ,KAMR,CAAA;IAA3B,YAAA,CAAA,EALoB,eAKpB;IAuBS,OAAA,CAAA,EA3BM,OA2BN;IAOwB,IAAA,EAjCtB,eAiCsB;IAAlB,WAAA,CAAA,EAhCI,YAgCJ;EAOL,CAAA,CAAA,EArCV,mBAqCU,CArCU,KAqCV,EArCiB,YAqCjB,CAAA;EAOE;;;EAiBP,IAAA,MAAA,CAAA,CAAA,EAAA,MAAA;EAAqB;;;;EADH,IAAA,IAAA,CAAA,CAAA,EArCd,KAqCc;;;;;oBA9BR,kBAAkB;;;;;eAOvB;;;;;iBAOE;;;;;;eAYF;YAGC;iBACK,QACX,qBAAqB,mBACjB,gBAAA,CAAiB,YAAY"}

package/dist/api/request-input-context.js

@@ -0,0 +1,118 @@
+import { FragnoApiValidationError } from "./error.js";
+
+//#region src/api/request-input-context.ts
+var RequestInputContext = class RequestInputContext {
+	#path;
+	#method;
+	#pathParams;
+	#searchParams;
+	#headers;
+	#body;
+	#parsedBody;
+	#inputSchema;
+	#shouldValidateInput;
+	constructor(config) {
+		this.#path = config.path;
+		this.#method = config.method;
+		this.#pathParams = config.pathParams;
+		this.#searchParams = config.searchParams;
+		this.#headers = config.headers;
+		this.#body = config.rawBody;
+		this.#parsedBody = config.parsedBody;
+		this.#inputSchema = config.inputSchema;
+		this.#shouldValidateInput = config.shouldValidateInput ?? true;
+	}
+	/**
+	* Create a RequestContext from a Request object for server-side handling
+	*/
+	static async fromRequest(config) {
+		return new RequestInputContext({
+			method: config.method,
+			path: config.path,
+			pathParams: config.state.pathParams,
+			searchParams: config.state.searchParams,
+			headers: config.state.headers,
+			parsedBody: config.state.body,
+			rawBody: config.rawBody,
+			inputSchema: config.inputSchema,
+			shouldValidateInput: config.shouldValidateInput
+		});
+	}
+	/**
+	* Create a RequestContext for server-side rendering contexts (no Request object)
+	*/
+	static fromSSRContext(config) {
+		return new RequestInputContext({
+			method: config.method,
+			path: config.path,
+			pathParams: config.pathParams,
+			searchParams: config.searchParams ?? new URLSearchParams(),
+			headers: config.headers ?? new Headers(),
+			parsedBody: "body" in config ? config.body : void 0,
+			inputSchema: "inputSchema" in config ? config.inputSchema : void 0,
+			shouldValidateInput: false
+		});
+	}
+	/**
+	* The HTTP method as string (e.g., `GET`, `POST`)
+	*/
+	get method() {
+		return this.#method;
+	}
+	/**
+	* The matched route path (e.g., `/users/:id`)
+	* @remarks `string`
+	*/
+	get path() {
+		return this.#path;
+	}
+	/**
+	* Extracted path parameters as object (e.g., `{ id: '123' }`)
+	* @remarks `Record<string, string>`
+	*/
+	get pathParams() {
+		return this.#pathParams;
+	}
+	/**
+	* [URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams) object for query parameters
+	* @remarks `URLSearchParams`
+	*/
+	get query() {
+		return this.#searchParams;
+	}
+	/**
+	* [Headers](https://developer.mozilla.org/en-US/docs/Web/API/Headers) object for request headers
+	* @remarks `Headers`
+	*/
+	get headers() {
+		return this.#headers;
+	}
+	get rawBody() {
+		return this.#body;
+	}
+	/**
+	* Input validation context (only if inputSchema is defined)
+	* @remarks `InputContext`
+	*/
+	get input() {
+		if (!this.#inputSchema) return;
+		return {
+			schema: this.#inputSchema,
+			valid: async () => {
+				if (!this.#shouldValidateInput) return this.#parsedBody;
+				return this.#validateInput();
+			}
+		};
+	}
+	async #validateInput() {
+		if (!this.#inputSchema) throw new Error("No input schema defined for this route");
+		if (this.#parsedBody instanceof FormData || this.#parsedBody instanceof Blob) throw new Error("Schema validation is only supported for JSON data, not FormData or Blob");
+		const result = await this.#inputSchema["~standard"].validate(this.#parsedBody);
+		if (result.issues) throw new FragnoApiValidationError("Validation failed", result.issues);
+		return result.value;
+	}
+};
+
+//#endregion
+export { RequestInputContext };
+//# sourceMappingURL=request-input-context.js.map

package/dist/api/request-input-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-input-context.js","names":["#path","#method","#pathParams","#searchParams","#headers","#body","#parsedBody","#inputSchema","#shouldValidateInput","#validateInput"],"sources":["../../src/api/request-input-context.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ExtractPathParams } from \"./internal/path\";\nimport { FragnoApiValidationError, type HTTPMethod } from \"./api\";\nimport type { MutableRequestState } from \"./mutable-request-state\";\n\nexport type RequestBodyType =\n  | unknown // JSON\n  | FormData\n  | Blob\n  | null\n  | undefined;\n\nexport class RequestInputContext<\n  TPath extends string = string,\n  TInputSchema extends StandardSchemaV1 | undefined = undefined,\n> {\n  readonly #path: TPath;\n  readonly #method: string;\n  readonly #pathParams: ExtractPathParams<TPath>;\n  readonly #searchParams: URLSearchParams;\n  readonly #headers: Headers;\n  readonly #body: string | undefined;\n  readonly #parsedBody: RequestBodyType;\n  readonly #inputSchema: TInputSchema | undefined;\n  readonly #shouldValidateInput: boolean;\n\n  constructor(config: {\n    path: TPath;\n    method: string;\n    pathParams: ExtractPathParams<TPath>;\n    searchParams: URLSearchParams;\n    parsedBody: RequestBodyType;\n    rawBody?: string;\n    headers: Headers;\n    request?: Request;\n    inputSchema?: TInputSchema;\n    shouldValidateInput?: boolean;\n  }) {\n    this.#path = config.path;\n    this.#method = config.method;\n    this.#pathParams = config.pathParams;\n    this.#searchParams = config.searchParams;\n    this.#headers = config.headers;\n    this.#body = config.rawBody;\n    this.#parsedBody = config.parsedBody;\n    this.#inputSchema = config.inputSchema;\n    this.#shouldValidateInput = config.shouldValidateInput ?? true;\n  }\n\n  /**\n   * Create a RequestContext from a Request object for server-side handling\n   */\n  static async fromRequest<\n    TPath extends string,\n    TInputSchema extends StandardSchemaV1 | undefined = undefined,\n  >(config: {\n    request: Request;\n    method: string;\n    path: TPath;\n    pathParams: ExtractPathParams<TPath>;\n    inputSchema?: TInputSchema;\n    shouldValidateInput?: boolean;\n    state: MutableRequestState;\n    rawBody?: string;\n  }): Promise<RequestInputContext<TPath, TInputSchema>> {\n    // Use the mutable state (potentially modified by middleware)\n    return new RequestInputContext({\n      method: config.method,\n      path: config.path,\n      pathParams: config.state.pathParams as ExtractPathParams<TPath>,\n      searchParams: config.state.searchParams,\n      headers: config.state.headers,\n      parsedBody: config.state.body,\n      rawBody: config.rawBody,\n      inputSchema: config.inputSchema,\n      shouldValidateInput: config.shouldValidateInput,\n    });\n  }\n\n  /**\n   * Create a RequestContext for server-side rendering contexts (no Request object)\n   */\n  static fromSSRContext<\n    TPath extends string,\n    TInputSchema extends StandardSchemaV1 | undefined = undefined,\n  >(\n    config:\n      | {\n          method: \"GET\";\n          path: TPath;\n          pathParams: ExtractPathParams<TPath>;\n          searchParams?: URLSearchParams;\n          headers?: Headers;\n        }\n      | {\n          method: Exclude<HTTPMethod, \"GET\">;\n          path: TPath;\n          pathParams: ExtractPathParams<TPath>;\n          searchParams?: URLSearchParams;\n          headers?: Headers;\n          body: RequestBodyType;\n          inputSchema?: TInputSchema;\n        },\n  ): RequestInputContext<TPath, TInputSchema> {\n    return new RequestInputContext({\n      method: config.method,\n      path: config.path,\n      pathParams: config.pathParams,\n      searchParams: config.searchParams ?? new URLSearchParams(),\n      headers: config.headers ?? new Headers(),\n      parsedBody: \"body\" in config ? config.body : undefined,\n      inputSchema: \"inputSchema\" in config ? config.inputSchema : undefined,\n      shouldValidateInput: false, // No input validation in SSR context\n    });\n  }\n\n  /**\n   * The HTTP method as string (e.g., `GET`, `POST`)\n   */\n  get method(): string {\n    return this.#method;\n  }\n  /**\n   * The matched route path (e.g., `/users/:id`)\n   * @remarks `string`\n   */\n  get path(): TPath {\n    return this.#path;\n  }\n  /**\n   * Extracted path parameters as object (e.g., `{ id: '123' }`)\n   * @remarks `Record<string, string>`\n   */\n  get pathParams(): ExtractPathParams<TPath> {\n    return this.#pathParams;\n  }\n  /**\n   * [URLSearchParams](https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams) object for query parameters\n   * @remarks `URLSearchParams`\n   */\n  get query(): URLSearchParams {\n    return this.#searchParams;\n  }\n  /**\n   * [Headers](https://developer.mozilla.org/en-US/docs/Web/API/Headers) object for request headers\n   * @remarks `Headers`\n   */\n  get headers(): Headers {\n    return this.#headers;\n  }\n\n  get rawBody(): string | undefined {\n    return this.#body;\n  }\n\n  /**\n   * Input validation context (only if inputSchema is defined)\n   * @remarks `InputContext`\n   */\n  get input(): TInputSchema extends undefined\n    ? undefined\n    : {\n        schema: TInputSchema;\n        valid: () => Promise<\n          TInputSchema extends StandardSchemaV1\n            ? StandardSchemaV1.InferOutput<TInputSchema>\n            : unknown\n        >;\n      } {\n    if (!this.#inputSchema) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      return undefined as any;\n    }\n\n    return {\n      schema: this.#inputSchema,\n      valid: async () => {\n        if (!this.#shouldValidateInput) {\n          // In SSR context, return the body directly without validation\n          return this.#parsedBody;\n        }\n\n        return this.#validateInput();\n      },\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any;\n  }\n\n  async #validateInput(): Promise<\n    TInputSchema extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TInputSchema> : never\n  > {\n    if (!this.#inputSchema) {\n      throw new Error(\"No input schema defined for this route\");\n    }\n\n    if (this.#parsedBody instanceof FormData || this.#parsedBody instanceof Blob) {\n      throw new Error(\"Schema validation is only supported for JSON data, not FormData or Blob\");\n    }\n\n    const result = await this.#inputSchema[\"~standard\"].validate(this.#parsedBody);\n\n    if (result.issues) {\n      throw new FragnoApiValidationError(\"Validation failed\", result.issues);\n    }\n\n    return result.value as TInputSchema extends StandardSchemaV1\n      ? StandardSchemaV1.InferOutput<TInputSchema>\n      : never;\n  }\n}\n"],"mappings":";;;AAYA,IAAa,sBAAb,MAAa,oBAGX;CACA,CAASA;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CACT,CAASC;CAET,YAAY,QAWT;AACD,QAAKR,OAAQ,OAAO;AACpB,QAAKC,SAAU,OAAO;AACtB,QAAKC,aAAc,OAAO;AAC1B,QAAKC,eAAgB,OAAO;AAC5B,QAAKC,UAAW,OAAO;AACvB,QAAKC,OAAQ,OAAO;AACpB,QAAKC,aAAc,OAAO;AAC1B,QAAKC,cAAe,OAAO;AAC3B,QAAKC,sBAAuB,OAAO,uBAAuB;;;;;CAM5D,aAAa,YAGX,QASoD;AAEpD,SAAO,IAAI,oBAAoB;GAC7B,QAAQ,OAAO;GACf,MAAM,OAAO;GACb,YAAY,OAAO,MAAM;GACzB,cAAc,OAAO,MAAM;GAC3B,SAAS,OAAO,MAAM;GACtB,YAAY,OAAO,MAAM;GACzB,SAAS,OAAO;GAChB,aAAa,OAAO;GACpB,qBAAqB,OAAO;GAC7B,CAAC;;;;;CAMJ,OAAO,eAIL,QAiB0C;AAC1C,SAAO,IAAI,oBAAoB;GAC7B,QAAQ,OAAO;GACf,MAAM,OAAO;GACb,YAAY,OAAO;GACnB,cAAc,OAAO,gBAAgB,IAAI,iBAAiB;GAC1D,SAAS,OAAO,WAAW,IAAI,SAAS;GACxC,YAAY,UAAU,SAAS,OAAO,OAAO;GAC7C,aAAa,iBAAiB,SAAS,OAAO,cAAc;GAC5D,qBAAqB;GACtB,CAAC;;;;;CAMJ,IAAI,SAAiB;AACnB,SAAO,MAAKP;;;;;;CAMd,IAAI,OAAc;AAChB,SAAO,MAAKD;;;;;;CAMd,IAAI,aAAuC;AACzC,SAAO,MAAKE;;;;;;CAMd,IAAI,QAAyB;AAC3B,SAAO,MAAKC;;;;;;CAMd,IAAI,UAAmB;AACrB,SAAO,MAAKC;;CAGd,IAAI,UAA8B;AAChC,SAAO,MAAKC;;;;;;CAOd,IAAI,QASE;AACJ,MAAI,CAAC,MAAKE,YAER;AAGF,SAAO;GACL,QAAQ,MAAKA;GACb,OAAO,YAAY;AACjB,QAAI,CAAC,MAAKC,oBAER,QAAO,MAAKF;AAGd,WAAO,MAAKG,eAAgB;;GAG/B;;CAGH,OAAMA,gBAEJ;AACA,MAAI,CAAC,MAAKF,YACR,OAAM,IAAI,MAAM,yCAAyC;AAG3D,MAAI,MAAKD,sBAAuB,YAAY,MAAKA,sBAAuB,KACtE,OAAM,IAAI,MAAM,0EAA0E;EAG5F,MAAM,SAAS,MAAM,MAAKC,YAAa,aAAa,SAAS,MAAKD,WAAY;AAE9E,MAAI,OAAO,OACT,OAAM,IAAI,yBAAyB,qBAAqB,OAAO,OAAO;AAGxE,SAAO,OAAO"}

package/dist/api/request-middleware.d.ts

@@ -0,0 +1,50 @@
+import { MutableRequestState } from "./mutable-request-state.js";
+import { OutputContext } from "./request-output-context.js";
+import { HTTPMethod } from "./api.js";
+import { AnyFragnoRouteConfig } from "./route.js";
+import { ExtractRouteByPath, ExtractRoutePath } from "../client/client.js";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/api/request-middleware.d.ts
+type FragnoMiddlewareCallback<TRoutes extends readonly AnyFragnoRouteConfig[], TDeps, TServices extends Record<string, unknown>> = (inputContext: RequestMiddlewareInputContext<TRoutes>, outputContext: RequestMiddlewareOutputContext<TDeps, TServices>) => Promise<Response | undefined> | Response | undefined;
+interface RequestMiddlewareOptions {
+  path: string;
+  method: HTTPMethod;
+  request: Request;
+  state: MutableRequestState;
+}
+declare class RequestMiddlewareOutputContext<const TDeps, const TServices extends Record<string, unknown>> extends OutputContext<unknown, string> {
+  #private;
+  constructor(deps: TDeps, services: TServices);
+  get deps(): TDeps;
+  get services(): TServices;
+}
+declare class RequestMiddlewareInputContext<const TRoutes extends readonly AnyFragnoRouteConfig[]> {
+  #private;
+  constructor(routes: TRoutes, options: RequestMiddlewareOptions);
+  get path(): string;
+  get method(): HTTPMethod;
+  get pathParams(): Record<string, string>;
+  get queryParams(): URLSearchParams;
+  get headers(): Headers;
+  get inputSchema(): StandardSchemaV1 | undefined;
+  get outputSchema(): StandardSchemaV1 | undefined;
+  /**
+   * Access to the mutable request state.
+   * Use this to modify query parameters, path parameters, or request body.
+   *
+   * @example
+   * ```typescript
+   * // Modify body
+   * requestState.setBody({ modified: true });
+   *
+   * // Query params are already accessible via queryParams getter
+   * // Path params are already accessible via pathParams getter
+   * ```
+   */
+  get requestState(): MutableRequestState;
+  ifMatchesRoute: <const TMethod extends HTTPMethod, const TPath extends ExtractRoutePath<TRoutes>, const TRoute extends ExtractRouteByPath<TRoutes, TPath, TMethod> = ExtractRouteByPath<TRoutes, TPath, TMethod>>(method: TMethod, path: TPath, handler: (...args: Parameters<TRoute["handler"]>) => Promise<Response | undefined | void> | Response | undefined | void) => Promise<Response | undefined>;
+}
+//#endregion
+export { FragnoMiddlewareCallback, RequestMiddlewareInputContext, RequestMiddlewareOptions, RequestMiddlewareOutputContext };
+//# sourceMappingURL=request-middleware.d.ts.map

package/dist/api/request-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-middleware.d.ts","names":[],"sources":["../../src/api/request-middleware.ts"],"sourcesContent":[],"mappings":";;;;;;;;KASY,kDACe,iDAEP,0CAEJ,8BAA8B,yBAC7B,+BAA+B,OAAO,eAClD,QAAQ,wBAAwB;UAEpB,wBAAA;EATL,IAAA,EAAA,MAAA;EACe,MAAA,EAUjB,UAViB;EAEP,OAAA,EAST,OATS;EAE0B,KAAA,EAQrC,mBARqC;;AACE,cAUnC,8BAVmC,CAAA,WAAA,EAAA,wBAYtB,MAZsB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,SAatC,aAbsC,CAAA,OAAA,EAAA,MAAA,CAAA,CAAA;EAAO,CAAA,OAAA;EAAtC,WAAA,CAAA,IAAA,EAiBG,KAjBH,EAAA,QAAA,EAiBoB,SAjBpB;EACJ,IAAA,IAAA,CAAA,CAAA,EAsBC,KAtBD;EAAR,IAAA,QAAA,CAAA,CAAA,EA0Ba,SA1Bb;;AAAwC,cA+BhC,6BA/BgC,CAAA,sBAAA,SA+B6B,oBA/B7B,EAAA,CAAA,CAAA;EAE5B,CAAA,OAAA;EAEP,WAAA,CAAA,MAAA,EAgCY,OAhCZ,EAAA,OAAA,EAgC8B,wBAhC9B;EACC,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EACF,IAAA,MAAA,CAAA,CAAA,EAiDO,UAjDP;EAAmB,IAAA,UAAA,CAAA,CAAA,EAqDR,MArDQ,CAAA,MAAA,EAAA,MAAA,CAAA;EAGf,IAAA,WAAA,CAAA,CAAA,EAsDQ,eAtDsB;EAEjB,IAAA,OAAA,CAAA,CAAA,EAwDT,OAxDS;EAKN,IAAA,WAAA,CAAA,CAAA,EAuDC,gBAvDD,GAAA,SAAA;EAAiB,IAAA,YAAA,CAAA,CAAA,EA2Df,gBA3De,GAAA,SAAA;EAMvB;;;;AASd;;;;;;;;;EA4CsB,IAAA,YAAA,CAAA,CAAA,EAiBA,mBAjBA;EAiBA,cAAA,EAAA,CAAA,sBAMI,UANJ,EAAA,oBAOE,gBAPF,CAOmB,OAPnB,CAAA,EAAA,qBAQG,kBARH,CAQsB,OARtB,EAQ+B,KAR/B,EAQsC,OARtC,CAAA,GAQiD,kBARjD,CAShB,OATgB,EAUhB,KAVgB,EAWhB,OAXgB,CAAA,CAAA,CAAA,MAAA,EAcV,OAdU,EAAA,IAAA,EAeZ,KAfY,EAAA,OAAA,EAAA,CAAA,GAAA,IAAA,EAiBP,UAjBO,CAiBI,MAjBJ,CAAA,SAAA,CAAA,CAAA,EAAA,GAkBb,OAlBa,CAkBL,QAlBK,GAAA,SAAA,GAAA,IAAA,CAAA,GAkB0B,QAlB1B,GAAA,SAAA,GAAA,IAAA,EAAA,GAmBjB,OAnBiB,CAmBT,QAnBS,GAAA,SAAA,CAAA"}

package/dist/api/request-middleware.js

@@ -0,0 +1,83 @@
+import { RequestInputContext } from "./request-input-context.js";
+import { OutputContext, RequestOutputContext } from "./request-output-context.js";
+
+//#region src/api/request-middleware.ts
+var RequestMiddlewareOutputContext = class extends OutputContext {
+	#deps;
+	#services;
+	constructor(deps, services) {
+		super();
+		this.#deps = deps;
+		this.#services = services;
+	}
+	get deps() {
+		return this.#deps;
+	}
+	get services() {
+		return this.#services;
+	}
+};
+var RequestMiddlewareInputContext = class {
+	#options;
+	#route;
+	#state;
+	constructor(routes, options) {
+		this.#options = options;
+		this.#state = options.state;
+		const route = routes.find((route$1) => route$1.path === options.path && route$1.method === options.method);
+		if (!route) throw new Error(`Route not found: ${options.path} ${options.method}`);
+		this.#route = route;
+	}
+	get path() {
+		return this.#options.path;
+	}
+	get method() {
+		return this.#options.method;
+	}
+	get pathParams() {
+		return this.#state.pathParams;
+	}
+	get queryParams() {
+		return this.#state.searchParams;
+	}
+	get headers() {
+		return this.#state.headers;
+	}
+	get inputSchema() {
+		return this.#route.inputSchema;
+	}
+	get outputSchema() {
+		return this.#route.outputSchema;
+	}
+	/**
+	* Access to the mutable request state.
+	* Use this to modify query parameters, path parameters, or request body.
+	*
+	* @example
+	* ```typescript
+	* // Modify body
+	* requestState.setBody({ modified: true });
+	*
+	* // Query params are already accessible via queryParams getter
+	* // Path params are already accessible via pathParams getter
+	* ```
+	*/
+	get requestState() {
+		return this.#state;
+	}
+	ifMatchesRoute = async (method, path, handler) => {
+		if (this.path !== path || this.method !== method) return;
+		return await handler(await RequestInputContext.fromRequest({
+			request: this.#options.request,
+			method: this.#options.method,
+			path,
+			pathParams: this.pathParams,
+			inputSchema: this.#route.inputSchema,
+			state: this.#state
+		}), new RequestOutputContext(this.#route.outputSchema));
+	};
+};
+
+//#endregion
+export { RequestMiddlewareInputContext, RequestMiddlewareOutputContext };
+//# sourceMappingURL=request-middleware.js.map

package/dist/api/request-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-middleware.js","names":["#deps","#services","#options","#route","#state","route"],"sources":["../../src/api/request-middleware.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ExtractRouteByPath, ExtractRoutePath } from \"../client/client\";\nimport type { HTTPMethod } from \"./api\";\nimport type { ExtractPathParams } from \"./internal/path\";\nimport type { AnyFragnoRouteConfig } from \"./route\";\nimport { RequestInputContext } from \"./request-input-context\";\nimport { OutputContext, RequestOutputContext } from \"./request-output-context\";\nimport { MutableRequestState } from \"./mutable-request-state\";\n\nexport type FragnoMiddlewareCallback<\n  TRoutes extends readonly AnyFragnoRouteConfig[],\n  TDeps,\n  TServices extends Record<string, unknown>,\n> = (\n  inputContext: RequestMiddlewareInputContext<TRoutes>,\n  outputContext: RequestMiddlewareOutputContext<TDeps, TServices>,\n) => Promise<Response | undefined> | Response | undefined;\n\nexport interface RequestMiddlewareOptions {\n  path: string;\n  method: HTTPMethod;\n  request: Request;\n  state: MutableRequestState;\n}\n\nexport class RequestMiddlewareOutputContext<\n  const TDeps,\n  const TServices extends Record<string, unknown>,\n> extends OutputContext<unknown, string> {\n  readonly #deps: TDeps;\n  readonly #services: TServices;\n\n  constructor(deps: TDeps, services: TServices) {\n    super();\n    this.#deps = deps;\n    this.#services = services;\n  }\n\n  get deps(): TDeps {\n    return this.#deps;\n  }\n\n  get services(): TServices {\n    return this.#services;\n  }\n}\n\nexport class RequestMiddlewareInputContext<const TRoutes extends readonly AnyFragnoRouteConfig[]> {\n  readonly #options: RequestMiddlewareOptions;\n  readonly #route: TRoutes[number];\n  readonly #state: MutableRequestState;\n\n  constructor(routes: TRoutes, options: RequestMiddlewareOptions) {\n    this.#options = options;\n    this.#state = options.state;\n\n    const route = routes.find(\n      (route) => route.path === options.path && route.method === options.method,\n    );\n\n    if (!route) {\n      throw new Error(`Route not found: ${options.path} ${options.method}`);\n    }\n\n    this.#route = route;\n  }\n\n  get path(): string {\n    return this.#options.path;\n  }\n\n  get method(): HTTPMethod {\n    return this.#options.method;\n  }\n\n  get pathParams(): Record<string, string> {\n    return this.#state.pathParams;\n  }\n\n  get queryParams(): URLSearchParams {\n    return this.#state.searchParams;\n  }\n\n  get headers(): Headers {\n    return this.#state.headers;\n  }\n\n  get inputSchema(): StandardSchemaV1 | undefined {\n    return this.#route.inputSchema;\n  }\n\n  get outputSchema(): StandardSchemaV1 | undefined {\n    return this.#route.outputSchema;\n  }\n\n  /**\n   * Access to the mutable request state.\n   * Use this to modify query parameters, path parameters, or request body.\n   *\n   * @example\n   * ```typescript\n   * // Modify body\n   * requestState.setBody({ modified: true });\n   *\n   * // Query params are already accessible via queryParams getter\n   * // Path params are already accessible via pathParams getter\n   * ```\n   */\n  get requestState(): MutableRequestState {\n    return this.#state;\n  }\n\n  // Defined as a field so that `this` reference stays in tact when destructuring\n  ifMatchesRoute = async <\n    const TMethod extends HTTPMethod,\n    const TPath extends ExtractRoutePath<TRoutes>,\n    const TRoute extends ExtractRouteByPath<TRoutes, TPath, TMethod> = ExtractRouteByPath<\n      TRoutes,\n      TPath,\n      TMethod\n    >,\n  >(\n    method: TMethod,\n    path: TPath,\n    handler: (\n      ...args: Parameters<TRoute[\"handler\"]>\n    ) => Promise<Response | undefined | void> | Response | undefined | void,\n  ): Promise<Response | undefined> => {\n    if (this.path !== path || this.method !== method) {\n      return undefined;\n    }\n\n    // TODO(Wilco): We should support reading/modifying headers here.\n    const inputContext = await RequestInputContext.fromRequest({\n      request: this.#options.request,\n      method: this.#options.method,\n      path: path,\n      pathParams: this.pathParams as ExtractPathParams<TPath>,\n      inputSchema: this.#route.inputSchema,\n      state: this.#state,\n    });\n\n    const outputContext = new RequestOutputContext(this.#route.outputSchema);\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return await (handler as any)(inputContext, outputContext);\n  };\n}\n"],"mappings":";;;;AAyBA,IAAa,iCAAb,cAGU,cAA+B;CACvC,CAASA;CACT,CAASC;CAET,YAAY,MAAa,UAAqB;AAC5C,SAAO;AACP,QAAKD,OAAQ;AACb,QAAKC,WAAY;;CAGnB,IAAI,OAAc;AAChB,SAAO,MAAKD;;CAGd,IAAI,WAAsB;AACxB,SAAO,MAAKC;;;AAIhB,IAAa,gCAAb,MAAkG;CAChG,CAASC;CACT,CAASC;CACT,CAASC;CAET,YAAY,QAAiB,SAAmC;AAC9D,QAAKF,UAAW;AAChB,QAAKE,QAAS,QAAQ;EAEtB,MAAM,QAAQ,OAAO,MAClB,YAAUC,QAAM,SAAS,QAAQ,QAAQA,QAAM,WAAW,QAAQ,OACpE;AAED,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,oBAAoB,QAAQ,KAAK,GAAG,QAAQ,SAAS;AAGvE,QAAKF,QAAS;;CAGhB,IAAI,OAAe;AACjB,SAAO,MAAKD,QAAS;;CAGvB,IAAI,SAAqB;AACvB,SAAO,MAAKA,QAAS;;CAGvB,IAAI,aAAqC;AACvC,SAAO,MAAKE,MAAO;;CAGrB,IAAI,cAA+B;AACjC,SAAO,MAAKA,MAAO;;CAGrB,IAAI,UAAmB;AACrB,SAAO,MAAKA,MAAO;;CAGrB,IAAI,cAA4C;AAC9C,SAAO,MAAKD,MAAO;;CAGrB,IAAI,eAA6C;AAC/C,SAAO,MAAKA,MAAO;;;;;;;;;;;;;;;CAgBrB,IAAI,eAAoC;AACtC,SAAO,MAAKC;;CAId,iBAAiB,OASf,QACA,MACA,YAGkC;AAClC,MAAI,KAAK,SAAS,QAAQ,KAAK,WAAW,OACxC;AAgBF,SAAO,MAAO,QAZO,MAAM,oBAAoB,YAAY;GACzD,SAAS,MAAKF,QAAS;GACvB,QAAQ,MAAKA,QAAS;GAChB;GACN,YAAY,KAAK;GACjB,aAAa,MAAKC,MAAO;GACzB,OAAO,MAAKC;GACb,CAAC,EAEoB,IAAI,qBAAqB,MAAKD,MAAO,aAAa,CAGd"}

package/dist/api/request-output-context.d.ts

@@ -0,0 +1,41 @@
+import { ContentlessStatusCode, StatusCode } from "../http/http-status.js";
+import { ResponseStream } from "./internal/response-stream.js";
+import { InferOrUnknown } from "../util/types-util.js";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/api/request-output-context.d.ts
+interface ResponseInit<T extends StatusCode = StatusCode> {
+  headers?: HeadersInit;
+  status?: T;
+  statusText?: string;
+}
+declare abstract class OutputContext<const TOutput, const TErrorCode extends string> {
+  /**
+   * Creates an error response.
+   *
+   * Shortcut for `throw new FragnoApiError(...)`
+   */
+  error: ({
+    message,
+    code
+  }: {
+    message: string;
+    code: TErrorCode;
+  }, initOrStatus?: ResponseInit | StatusCode, headers?: HeadersInit) => Response;
+  empty: (initOrStatus?: ResponseInit<ContentlessStatusCode> | ContentlessStatusCode, headers?: HeadersInit) => Response;
+  json: (object: TOutput, initOrStatus?: ResponseInit | StatusCode, headers?: HeadersInit) => Response;
+  jsonStream: (cb: (stream: ResponseStream<TOutput>) => void | Promise<void>, {
+    onError,
+    headers
+  }?: {
+    onError?: (error: Error, stream: ResponseStream<TOutput>) => void | Promise<void>;
+    headers?: HeadersInit;
+  }) => Response;
+}
+declare class RequestOutputContext<const TOutputSchema extends StandardSchemaV1 | undefined = undefined, const TErrorCode extends string = string> extends OutputContext<InferOrUnknown<TOutputSchema>, TErrorCode> {
+  #private;
+  constructor(outputSchema?: TOutputSchema);
+}
+//#endregion
+export { OutputContext, RequestOutputContext };
+//# sourceMappingURL=request-output-context.d.ts.map

package/dist/api/request-output-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-output-context.d.ts","names":[],"sources":["../../src/api/request-output-context.ts"],"sourcesContent":[],"mappings":";;;;;;UAOU,uBAAuB,aAAa;EAApC,OAAA,CAAA,EACE,WADU;EAAW,MAAA,CAAA,EAEtB,CAFsB;EAAa,UAAA,CAAA,EAAA,MAAA;;AAEnC,uBAkCW,aAlCX,CAAA,aAAA,EAAA,yBAAA,MAAA,CAAA,CAAA;EAAC;AAkCZ;;;;EAQmB,KAAA,EAAA,CAAA;IAAA,OAAA;IAAA;EAEd,CAFc,EAAA;IAAe,OAAA,EAAA,MAAA;IACpB,IAAA,EAFkC,UAElC;EACT,CAAA,EAAA,YAAA,CAAA,EAFc,YAEd,GAF6B,UAE7B,EAAA,OAAA,CAAA,EADS,WACT,EAAA,GAAA,QAAA;EAiB2B,KAAA,EAAA,CAAA,YAAA,CAAA,EAAb,YAAa,CAAA,qBAAA,CAAA,GAAyB,qBAAzB,EAAA,OAAA,CAAA,EAClB,WADkB,EAAA,GAE3B,QAF2B;EAAb,IAAA,EAAA,CAAA,MAAA,EA6BP,OA7BO,EAAA,YAAA,CAAA,EA8BA,YA9BA,GA8Be,UA9Bf,EAAA,OAAA,CAAA,EA+BL,WA/BK,EAAA,GAgCd,QAhCc;EAAsC,UAAA,EAAA,CAAA,EAAA,EAAA,CAAA,MAAA,EAuDxC,cAvDwC,CAuDzB,OAvDyB,CAAA,EAAA,GAAA,IAAA,GAuDL,OAvDK,CAAA,IAAA,CAAA,EAAA;IAAA,OAAA;IAAA;EA6B7C,CAAA,CA7B6C,EAAA;IAC3C,OAAA,CAAA,EAAA,CAAA,KAAA,EA2DU,KA3DV,EAAA,MAAA,EA2DyB,cA3DzB,CA2DwC,OA3DxC,CAAA,EAAA,GAAA,IAAA,GA2D4D,OA3D5D,CAAA,IAAA,CAAA;IACT,OAAA,CAAA,EA2DW,WA3DX;EA2BO,CAAA,EAAA,GAkCP,QAlCO;;AACsB,cAqErB,oBArEqB,CAAA,4BAsEJ,gBAtEI,GAAA,SAAA,GAAA,SAAA,EAAA,yBAAA,MAAA,GAAA,MAAA,CAAA,SAwExB,aAxEwB,CAwEV,cAxEU,CAwEK,aAxEL,CAAA,EAwEqB,UAxErB,CAAA,CAAA;EACpB,CAAA,OAAA;EACT,WAAA,CAAA,YAAA,CAAA,EA0EwB,aA1ExB"}

package/dist/api/request-output-context.js

@@ -0,0 +1,119 @@
+import { ResponseStream } from "./internal/response-stream.js";
+
+//#region src/api/request-output-context.ts
+/**
+* Utility function to merge headers from multiple sources.
+* Later headers override earlier ones.
+*/
+function mergeHeaders(...headerSources) {
+	const mergedHeaders = new Headers();
+	for (const headerSource of headerSources) {
+		if (!headerSource) continue;
+		if (headerSource instanceof Headers) for (const [key, value] of headerSource.entries()) mergedHeaders.set(key, value);
+		else if (Array.isArray(headerSource)) for (const [key, value] of headerSource) mergedHeaders.set(key, value);
+		else for (const [key, value] of Object.entries(headerSource)) mergedHeaders.set(key, value);
+	}
+	return mergedHeaders;
+}
+var OutputContext = class {
+	/**
+	* Creates an error response.
+	*
+	* Shortcut for `throw new FragnoApiError(...)`
+	*/
+	error = ({ message, code }, initOrStatus, headers) => {
+		if (typeof initOrStatus === "undefined") return Response.json({
+			message,
+			code
+		}, {
+			status: 500,
+			headers
+		});
+		if (typeof initOrStatus === "number") return Response.json({
+			message,
+			code
+		}, {
+			status: initOrStatus,
+			headers
+		});
+		const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);
+		return Response.json({
+			message,
+			code
+		}, {
+			status: initOrStatus.status,
+			headers: mergedHeaders
+		});
+	};
+	empty = (initOrStatus, headers) => {
+		const defaultHeaders = {};
+		if (typeof initOrStatus === "undefined") {
+			const mergedHeaders$1 = mergeHeaders(defaultHeaders, headers);
+			return new Response(null, {
+				status: 201,
+				headers: mergedHeaders$1
+			});
+		}
+		if (typeof initOrStatus === "number") {
+			const mergedHeaders$1 = mergeHeaders(defaultHeaders, headers);
+			return new Response(null, {
+				status: initOrStatus,
+				headers: mergedHeaders$1
+			});
+		}
+		const mergedHeaders = mergeHeaders(defaultHeaders, initOrStatus.headers, headers);
+		return new Response(null, {
+			status: initOrStatus.status,
+			headers: mergedHeaders
+		});
+	};
+	json = (object, initOrStatus, headers) => {
+		if (typeof initOrStatus === "undefined") return Response.json(object, {
+			status: 200,
+			headers
+		});
+		if (typeof initOrStatus === "number") return Response.json(object, {
+			status: initOrStatus,
+			headers
+		});
+		const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);
+		return Response.json(object, {
+			status: initOrStatus.status,
+			headers: mergedHeaders
+		});
+	};
+	jsonStream = (cb, { onError, headers } = {}) => {
+		const defaultHeaders = {
+			"content-type": "application/x-ndjson; charset=utf-8",
+			"transfer-encoding": "chunked",
+			"cache-control": "no-cache"
+		};
+		const { readable, writable } = new TransformStream();
+		const stream = new ResponseStream(writable, readable);
+		(async () => {
+			try {
+				await cb(stream);
+			} catch (e) {
+				if (e === void 0) {} else if (e instanceof Error && onError) await onError(e, stream);
+				else console.error(e);
+			} finally {
+				stream.close();
+			}
+		})();
+		return new Response(stream.responseReadable, {
+			status: 200,
+			headers: mergeHeaders(defaultHeaders, headers)
+		});
+	};
+};
+var RequestOutputContext = class extends OutputContext {
+	#outputSchema;
+	constructor(outputSchema) {
+		super();
+		this.#outputSchema = outputSchema;
+	}
+};
+
+//#endregion
+export { OutputContext, RequestOutputContext };
+//# sourceMappingURL=request-output-context.js.map

package/dist/api/request-output-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-output-context.js","names":["mergedHeaders","#outputSchema"],"sources":["../../src/api/request-output-context.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ContentlessStatusCode, StatusCode } from \"../http/http-status\";\nimport { ResponseStream } from \"./internal/response-stream\";\nimport type { InferOrUnknown } from \"../util/types-util\";\n\nexport type ResponseData = string | ArrayBuffer | ReadableStream | Uint8Array<ArrayBuffer>;\n\ninterface ResponseInit<T extends StatusCode = StatusCode> {\n  headers?: HeadersInit;\n  status?: T;\n  statusText?: string;\n}\n\n/**\n * Utility function to merge headers from multiple sources.\n * Later headers override earlier ones.\n */\nfunction mergeHeaders(...headerSources: (HeadersInit | undefined)[]): HeadersInit | undefined {\n  const mergedHeaders = new Headers();\n\n  for (const headerSource of headerSources) {\n    if (!headerSource) {\n      continue;\n    }\n\n    if (headerSource instanceof Headers) {\n      for (const [key, value] of headerSource.entries()) {\n        mergedHeaders.set(key, value);\n      }\n    } else if (Array.isArray(headerSource)) {\n      for (const [key, value] of headerSource) {\n        mergedHeaders.set(key, value);\n      }\n    } else {\n      for (const [key, value] of Object.entries(headerSource)) {\n        mergedHeaders.set(key, value);\n      }\n    }\n  }\n\n  return mergedHeaders;\n}\n\nexport abstract class OutputContext<const TOutput, const TErrorCode extends string> {\n  /**\n   * Creates an error response.\n   *\n   * Shortcut for `throw new FragnoApiError(...)`\n   */\n  error = (\n    { message, code }: { message: string; code: TErrorCode },\n    initOrStatus?: ResponseInit | StatusCode,\n    headers?: HeadersInit,\n  ): Response => {\n    if (typeof initOrStatus === \"undefined\") {\n      return Response.json({ message: message, code }, { status: 500, headers });\n    }\n\n    if (typeof initOrStatus === \"number\") {\n      return Response.json({ message: message, code }, { status: initOrStatus, headers });\n    }\n\n    const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);\n    return Response.json(\n      { message: message, code },\n      { status: initOrStatus.status, headers: mergedHeaders },\n    );\n  };\n\n  empty = (\n    initOrStatus?: ResponseInit<ContentlessStatusCode> | ContentlessStatusCode,\n    headers?: HeadersInit,\n  ): Response => {\n    const defaultHeaders = {};\n\n    if (typeof initOrStatus === \"undefined\") {\n      const mergedHeaders = mergeHeaders(defaultHeaders, headers);\n      return new Response(null, {\n        status: 201,\n        headers: mergedHeaders,\n      });\n    }\n\n    if (typeof initOrStatus === \"number\") {\n      const mergedHeaders = mergeHeaders(defaultHeaders, headers);\n      return new Response(null, {\n        status: initOrStatus,\n        headers: mergedHeaders,\n      });\n    }\n\n    const mergedHeaders = mergeHeaders(defaultHeaders, initOrStatus.headers, headers);\n    return new Response(null, {\n      status: initOrStatus.status,\n      headers: mergedHeaders,\n    });\n  };\n\n  json = (\n    object: TOutput,\n    initOrStatus?: ResponseInit | StatusCode,\n    headers?: HeadersInit,\n  ): Response => {\n    if (typeof initOrStatus === \"undefined\") {\n      return Response.json(object, {\n        status: 200,\n        headers,\n      });\n    }\n\n    if (typeof initOrStatus === \"number\") {\n      return Response.json(object, {\n        status: initOrStatus,\n        headers,\n      });\n    }\n\n    const mergedHeaders = mergeHeaders(initOrStatus.headers, headers);\n    return Response.json(object, {\n      status: initOrStatus.status,\n      headers: mergedHeaders,\n    });\n  };\n\n  jsonStream = (\n    cb: (stream: ResponseStream<TOutput>) => void | Promise<void>,\n    {\n      onError,\n      headers,\n    }: {\n      onError?: (error: Error, stream: ResponseStream<TOutput>) => void | Promise<void>;\n      headers?: HeadersInit;\n    } = {},\n  ): Response => {\n    // Note: this is intentionally an arrow function (=>) to keep `this` context.\n    const defaultHeaders = {\n      \"content-type\": \"application/x-ndjson; charset=utf-8\",\n      \"transfer-encoding\": \"chunked\",\n      \"cache-control\": \"no-cache\",\n    };\n\n    const { readable, writable } = new TransformStream();\n    const stream = new ResponseStream(writable, readable);\n\n    (async () => {\n      try {\n        await cb(stream);\n      } catch (e) {\n        if (e === undefined) {\n          // If reading is canceled without a reason value (e.g. by StreamingApi)\n          // then the .pipeTo() promise will reject with undefined.\n          // In this case, do nothing because the stream is already closed.\n        } else if (e instanceof Error && onError) {\n          await onError(e, stream);\n        } else {\n          console.error(e);\n        }\n      } finally {\n        stream.close();\n      }\n    })();\n\n    return new Response(stream.responseReadable, {\n      status: 200,\n      headers: mergeHeaders(defaultHeaders, headers),\n    });\n  };\n}\n\nexport class RequestOutputContext<\n  const TOutputSchema extends StandardSchemaV1 | undefined = undefined,\n  const TErrorCode extends string = string,\n> extends OutputContext<InferOrUnknown<TOutputSchema>, TErrorCode> {\n  // eslint-disable-next-line no-unused-private-class-members\n  #outputSchema?: TOutputSchema;\n\n  constructor(outputSchema?: TOutputSchema) {\n    super();\n    this.#outputSchema = outputSchema;\n  }\n}\n"],"mappings":";;;;;;;AAiBA,SAAS,aAAa,GAAG,eAAqE;CAC5F,MAAM,gBAAgB,IAAI,SAAS;AAEnC,MAAK,MAAM,gBAAgB,eAAe;AACxC,MAAI,CAAC,aACH;AAGF,MAAI,wBAAwB,QAC1B,MAAK,MAAM,CAAC,KAAK,UAAU,aAAa,SAAS,CAC/C,eAAc,IAAI,KAAK,MAAM;WAEtB,MAAM,QAAQ,aAAa,CACpC,MAAK,MAAM,CAAC,KAAK,UAAU,aACzB,eAAc,IAAI,KAAK,MAAM;MAG/B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,eAAc,IAAI,KAAK,MAAM;;AAKnC,QAAO;;AAGT,IAAsB,gBAAtB,MAAoF;;;;;;CAMlF,SACE,EAAE,SAAS,QACX,cACA,YACa;AACb,MAAI,OAAO,iBAAiB,YAC1B,QAAO,SAAS,KAAK;GAAW;GAAS;GAAM,EAAE;GAAE,QAAQ;GAAK;GAAS,CAAC;AAG5E,MAAI,OAAO,iBAAiB,SAC1B,QAAO,SAAS,KAAK;GAAW;GAAS;GAAM,EAAE;GAAE,QAAQ;GAAc;GAAS,CAAC;EAGrF,MAAM,gBAAgB,aAAa,aAAa,SAAS,QAAQ;AACjE,SAAO,SAAS,KACd;GAAW;GAAS;GAAM,EAC1B;GAAE,QAAQ,aAAa;GAAQ,SAAS;GAAe,CACxD;;CAGH,SACE,cACA,YACa;EACb,MAAM,iBAAiB,EAAE;AAEzB,MAAI,OAAO,iBAAiB,aAAa;GACvC,MAAMA,kBAAgB,aAAa,gBAAgB,QAAQ;AAC3D,UAAO,IAAI,SAAS,MAAM;IACxB,QAAQ;IACR,SAASA;IACV,CAAC;;AAGJ,MAAI,OAAO,iBAAiB,UAAU;GACpC,MAAMA,kBAAgB,aAAa,gBAAgB,QAAQ;AAC3D,UAAO,IAAI,SAAS,MAAM;IACxB,QAAQ;IACR,SAASA;IACV,CAAC;;EAGJ,MAAM,gBAAgB,aAAa,gBAAgB,aAAa,SAAS,QAAQ;AACjF,SAAO,IAAI,SAAS,MAAM;GACxB,QAAQ,aAAa;GACrB,SAAS;GACV,CAAC;;CAGJ,QACE,QACA,cACA,YACa;AACb,MAAI,OAAO,iBAAiB,YAC1B,QAAO,SAAS,KAAK,QAAQ;GAC3B,QAAQ;GACR;GACD,CAAC;AAGJ,MAAI,OAAO,iBAAiB,SAC1B,QAAO,SAAS,KAAK,QAAQ;GAC3B,QAAQ;GACR;GACD,CAAC;EAGJ,MAAM,gBAAgB,aAAa,aAAa,SAAS,QAAQ;AACjE,SAAO,SAAS,KAAK,QAAQ;GAC3B,QAAQ,aAAa;GACrB,SAAS;GACV,CAAC;;CAGJ,cACE,IACA,EACE,SACA,YAIE,EAAE,KACO;EAEb,MAAM,iBAAiB;GACrB,gBAAgB;GAChB,qBAAqB;GACrB,iBAAiB;GAClB;EAED,MAAM,EAAE,UAAU,aAAa,IAAI,iBAAiB;EACpD,MAAM,SAAS,IAAI,eAAe,UAAU,SAAS;AAErD,GAAC,YAAY;AACX,OAAI;AACF,UAAM,GAAG,OAAO;YACT,GAAG;AACV,QAAI,MAAM,QAAW,YAIV,aAAa,SAAS,QAC/B,OAAM,QAAQ,GAAG,OAAO;QAExB,SAAQ,MAAM,EAAE;aAEV;AACR,WAAO,OAAO;;MAEd;AAEJ,SAAO,IAAI,SAAS,OAAO,kBAAkB;GAC3C,QAAQ;GACR,SAAS,aAAa,gBAAgB,QAAQ;GAC/C,CAAC;;;AAIN,IAAa,uBAAb,cAGU,cAAyD;CAEjE;CAEA,YAAY,cAA8B;AACxC,SAAO;AACP,QAAKC,eAAgB"}

package/dist/api/route-handler-input-options.d.ts

@@ -0,0 +1,21 @@
+import { ExtractPathParams } from "./internal/path.js";
+import { InferOr } from "../util/types-util.js";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/api/route-handler-input-options.d.ts
+
+/**
+ * Options for calling a route handler
+ */
+type RouteHandlerInputOptions<TPath extends string, TInputSchema extends StandardSchemaV1 | undefined> = {
+  pathParams?: ExtractPathParams<TPath>;
+  query?: URLSearchParams | Record<string, string>;
+  headers?: Headers | Record<string, string>;
+} & (TInputSchema extends undefined ? {
+  body?: never;
+} : {
+  body: InferOr<TInputSchema, unknown>;
+});
+//#endregion
+export { RouteHandlerInputOptions };
+//# sourceMappingURL=route-handler-input-options.d.ts.map

package/dist/api/route-handler-input-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-handler-input-options.d.ts","names":[],"sources":["../../src/api/route-handler-input-options.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAOA;AAEuB,KAFX,wBAEW,CAAA,cAAA,MAAA,EAAA,qBAAA,gBAAA,GAAA,SAAA,CAAA,GAAA;EAEU,UAAA,CAAA,EAAlB,iBAAkB,CAAA,KAAA,CAAA;EAAlB,KAAA,CAAA,EACL,eADK,GACa,MADb,CAAA,MAAA,EAAA,MAAA,CAAA;EACL,OAAA,CAAA,EACE,OADF,GACY,MADZ,CAAA,MAAA,EAAA,MAAA,CAAA;CAAkB,GAAA,CAEvB,YAFuB,SAAA,SAAA,GAAA;EAChB,IAAA,CAAA,EAAA,KAAA;CAAU,GAAA;EACjB,IAAA,EAA4D,OAA5D,CAAoE,YAApE,EAAA,OAAA,CAAA;CAAoE,CAAA"}