@fragno-dev/core 0.1.7 → 0.1.9

package/dist/api-BWN97TOr.d.ts

@@ -1,377 +0,0 @@
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
-//#region src/api/internal/path.d.ts
-type SplitPath<T extends string> = T extends `${infer First}/${infer Rest}` ? First extends "" ? SplitPath<Rest> : [First, ...SplitPath<Rest>] : T extends "" ? [] : [T];
-type ExtractParam<T extends string> = T extends `:${infer Name}` ? Name : T extends `**:${infer Name}` ? Name : T extends "**" ? "**" : never;
-type ExtractParamsFromSegments<T extends readonly string[]> = T extends readonly [infer First, ...infer Rest] ? First extends string ? Rest extends readonly string[] ? ExtractParam<First> | ExtractParamsFromSegments<Rest> : ExtractParam<First> : never : never;
-/**
- * Type helper to extract path parameters from a const string path
- *
- * Supports:
- * - Regular paths: "/path" -> never
- * - Named parameters: "/path/:name" -> "name"
- * - Wildcard paths: "/path/foo/**" -> "**"
- * - Named wildcard paths: "/path/foo/**:name" -> "name"
- * - String (narrows): string -> never
- */
-type ExtractPathParams<T extends string, ValueType = string> = ExtractParamsFromSegments<SplitPath<T>> extends never ? Record<string, never> : Record<ExtractParamsFromSegments<SplitPath<T>>, ValueType>;
-/**
- * Same as @see ExtractPathParams, but returns `Record<string, ValueType>` when a string is
- * passed in.
- */
-type ExtractPathParamsOrWiden<T extends string, ValueType = string> = string extends T ? Record<string, ValueType> : ExtractPathParams<T, ValueType>;
-/**
- * Same as @see ExtractPathParamsOrWiden, but returns `undefined` when no path parameters in the
- * const.
- */
-type MaybeExtractPathParamsOrWiden<T extends string, ValueType = string> = HasPathParams<T> extends true ? ExtractPathParamsOrWiden<T, ValueType> : undefined;
-type ExtractPathParamNames<T extends string> = ExtractParamsFromSegments<SplitPath<T>>;
-type HasPathParams<T extends string> = ExtractPathParamNames<T> extends never ? false : true;
-/**
- * Creates a query parameters type where the specified keys are hints (optional)
- * and additional string keys are also allowed.
- *
- * This allows for flexible query parameter typing where:
- * - All hinted parameters are optional
- * - Additional parameters beyond the hints are allowed
- * - Values can be of any specified type (defaults to string)
- *
- * @example
- * ```ts
- * type MyQuery = QueryParamsHint<"page" | "limit", string>;
- * // Allows: { page?: string, limit?: string, [key: string]: string }
- *
- * const query1: MyQuery = {}; // Valid - no params required
- * const query2: MyQuery = { page: "1" }; // Valid - hinted param
- * const query3: MyQuery = { page: "1", sort: "asc" }; // Valid - additional param
- * ```
- */
-type QueryParamsHint<TQueryParameters extends string, ValueType = string> = Partial<Record<TQueryParameters, ValueType>> & Record<string, ValueType | undefined>;
-//#endregion
-//#region src/api/mutable-request-state.d.ts
-/**
- * Holds mutable request state that can be modified by middleware and consumed by handlers.
- *
- * This class provides a structural way for middleware to modify request data:
- * - Path parameters can be modified
- * - Query/search parameters can be modified
- * - Request body can be overridden
- * - Request headers can be modified
- *
- * @example
- * ```typescript
- * // In middleware
- * const state = new MutableRequestState({
- *   pathParams: { id: "123" },
- *   searchParams: new URLSearchParams("?role=user"),
- *   body: { name: "John" },
- *   headers: new Headers()
- * });
- *
- * // Modify query parameters
- * state.searchParams.set("role", "admin");
- *
- * // Override body
- * state.setBody({ name: "Jane" });
- *
- * // Modify headers
- * state.headers.set("X-Custom", "value");
- * ```
- */
-declare class MutableRequestState {
-  #private;
-  constructor(config: {
-    pathParams: Record<string, string>;
-    searchParams: URLSearchParams;
-    body: RequestBodyType;
-    headers: Headers;
-  });
-  /**
-   * Path parameters extracted from the route.
-   * Can be modified directly (e.g., `state.pathParams.id = "456"`).
-   */
-  get pathParams(): Record<string, string>;
-  /**
-   * URLSearchParams for query parameters.
-   * Can be modified using URLSearchParams API (e.g., `state.searchParams.set("key", "value")`).
-   */
-  get searchParams(): URLSearchParams;
-  /**
-   * Request headers.
-   * Can be modified using Headers API (e.g., `state.headers.set("X-Custom", "value")`).
-   */
-  get headers(): Headers;
-  /**
-   * Get the current body value.
-   * Returns the override if set, otherwise the initial body.
-   */
-  get body(): RequestBodyType;
-  /**
-   * Override the request body.
-   * This allows middleware to replace the body that will be seen by the handler.
-   *
-   * @param body - The new body value
-   *
-   * @example
-   * ```typescript
-   * // In middleware
-   * state.setBody({ modifiedField: "new value" });
-   * ```
-   */
-  setBody(body: RequestBodyType): void;
-  /**
-   * Check if the body has been overridden by middleware.
-   */
-  get hasBodyOverride(): boolean;
-}
-//#endregion
-//#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
-//#region src/http/http-status.d.ts
-/**
- * @module
- * HTTP Status utility.
- *
- * Modified from honojs/hono
- * Original source: https://github.com/honojs/hono/blob/0e3db674ad3f40be215a55a18062dd8e387ce525/src/utils/http-status.ts
- * License: MIT
- * Date obtained: August 28 2025
- * Copyright (c) 2021-present Yusuke Wada and Hono contributors
- *
- */
-type InfoStatusCode = 100 | 101 | 102 | 103;
-type SuccessStatusCode = 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226;
-type DeprecatedStatusCode = 305 | 306;
-type RedirectStatusCode = 300 | 301 | 302 | 303 | 304 | DeprecatedStatusCode | 307 | 308;
-type ClientErrorStatusCode = 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451;
-type ServerErrorStatusCode = 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
-/**
- * If you want to use an unofficial status, use `UnofficialStatusCode`.
- */
-type StatusCode = InfoStatusCode | SuccessStatusCode | RedirectStatusCode | ClientErrorStatusCode | ServerErrorStatusCode;
-type ContentlessStatusCode = 101 | 204 | 205 | 304;
-//#endregion
-//#region src/api/internal/response-stream.d.ts
-/**
- * @module
- * Stream utility.
- *
- * Modified from honojs/hono
- * Original source: https://github.com/honojs/hono/blob/0e3db674ad3f40be215a55a18062dd8e387ce525/src/utils/stream.ts
- * License: MIT
- * Date obtained: August 28 2025
- * Copyright (c) 2021-present Yusuke Wada and Hono contributors
- */
-type Error$1<Message extends string> = {
-  __errorMessage: Message;
-};
-declare class ResponseStream<TArray> {
-  #private;
-  /**
-   * Whether the stream has been aborted.
-   */
-  get aborted(): boolean;
-  /**
-   * Whether the stream has been closed normally.
-   */
-  get closed(): boolean;
-  /**
-   * The readable stream that the response is piped to.
-   */
-  get responseReadable(): ReadableStream;
-  constructor(writable: WritableStream, readable: ReadableStream);
-  writeRaw(input: Uint8Array | string): Promise<void>;
-  write(input: TArray extends (infer U)[] ? U : Error$1<"To use a streaming response, outputSchema must be an array.">): Promise<void>;
-  sleep(ms: number): Promise<unknown>;
-  close(): Promise<void>;
-  onAbort(listener: () => void | Promise<void>): void;
-  /**
-   * Abort the stream.
-   * You can call this method when stream is aborted by external event.
-   */
-  abort(): void;
-}
-//#endregion
-//#region src/util/types-util.d.ts
-type InferOr<T, U$1> = T extends NonNullable<StandardSchemaV1> ? StandardSchemaV1.InferOutput<T> : T extends undefined ? U$1 : U$1;
-type InferOrUnknown<T> = InferOr<T, unknown>;
-//#endregion
-//#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
-//#region src/api/error.d.ts
-declare class FragnoApiError extends Error {
-  #private;
-  constructor({
-    message,
-    code
-  }: {
-    message: string;
-    code: string;
-  }, status: StatusCode);
-  get status(): StatusCode;
-  get code(): string;
-  toResponse(): Response;
-}
-declare class FragnoApiValidationError extends FragnoApiError {
-  #private;
-  constructor(message: string, issues: readonly StandardSchemaV1.Issue[]);
-  get issues(): readonly StandardSchemaV1.Issue[];
-  toResponse(): Response;
-}
-//#endregion
-//#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
-//#region src/api/api.d.ts
-type HTTPMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
-type NonGetHTTPMethod = Exclude<HTTPMethod, "GET">;
-type PathError<T extends string, TMessage extends string> = T & [`Error: ${TMessage}`];
-/**
- * A valid path string that:
- * - Is non-empty
- * - Starts with "/"
- * - Is not just "/"
- * - Does not end with "/"
- */
-type ValidPath<T extends string = string> = T extends `/${infer Rest}` ? Rest extends "" ? PathError<T, "Path cannot be just '/'."> : T extends `${string}/` ? PathError<T, "Path cannot end with '/'."> : T : PathError<T, "Path must start with '/'.">;
-interface FragnoRouteConfig<TMethod extends HTTPMethod, TPath extends string, TInputSchema extends StandardSchemaV1 | undefined, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string = string, TQueryParameters extends string = string> {
-  method: TMethod;
-  path: TPath;
-  inputSchema?: TInputSchema;
-  outputSchema?: TOutputSchema;
-  errorCodes?: readonly TErrorCode[];
-  queryParameters?: readonly TQueryParameters[];
-  handler(inputCtx: RequestInputContext<TPath, TInputSchema>, outputCtx: RequestOutputContext<TOutputSchema, TErrorCode>): Promise<Response>;
-}
-declare function addRoute<TMethod extends HTTPMethod, TPath extends string, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string = string, TQueryParameters extends string = string>(route: FragnoRouteConfig<TMethod, ValidPath<TPath>, undefined, TOutputSchema, TErrorCode, TQueryParameters> & {
-  inputSchema?: undefined;
-}): FragnoRouteConfig<TMethod, TPath, undefined, TOutputSchema, TErrorCode, TQueryParameters>;
-declare function addRoute<TMethod extends HTTPMethod, TPath extends string, TInputSchema extends StandardSchemaV1, TOutputSchema extends StandardSchemaV1 | undefined, TErrorCode extends string = string, TQueryParameters extends string = string>(route: FragnoRouteConfig<TMethod, ValidPath<TPath>, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> & {
-  inputSchema: TInputSchema;
-}): FragnoRouteConfig<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>;
-//#endregion
-export { QueryParamsHint as _, addRoute as a, FragnoApiValidationError as c, InferOrUnknown as d, StatusCode as f, MaybeExtractPathParamsOrWiden as g, HasPathParams as h, ValidPath as i, OutputContext as l, ExtractPathParamsOrWiden as m, HTTPMethod as n, RouteHandlerInputOptions as o, MutableRequestState as p, NonGetHTTPMethod as r, FragnoApiError as s, FragnoRouteConfig as t, InferOr as u };
-//# sourceMappingURL=api-BWN97TOr.d.ts.map

package/dist/api-BWN97TOr.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-BWN97TOr.d.ts","names":[],"sources":["../src/api/internal/path.ts","../src/api/mutable-request-state.ts","../src/api/request-input-context.ts","../src/http/http-status.ts","../src/api/internal/response-stream.ts","../src/util/types-util.ts","../src/api/request-output-context.ts","../src/api/error.ts","../src/api/route-handler-input-options.ts","../src/api/api.ts"],"sourcesContent":[],"mappings":"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sBM,aTtBN,ESsBqB,UTtBrB,CAAA,CAAA,ESuBzB,OTvByB,CSuBjB,QTvBiB,CAAA;;AAI1B,iBSuBY,QTvBZ,CAAA,gBSwBc,UTxBd,EAAA,cAAA,MAAA,EAAA,sBS0BoB,gBT1BpB,GAAA,SAAA,EAAA,mBAAA,MAAA,GAAA,MAAA,EAAA,yBAAA,MAAA,GAAA,MAAA,CAAA,CAAA,KAAA,ES8BK,iBT9BL,CS+BA,OT/BA,ESgCA,SThCA,CSgCU,KThCV,CAAA,EAAA,SAAA,ESkCA,aTlCA,ESmCA,UTnCA,ESoCA,gBTpCA,CAAA,GAAA;EACE,WAAA,CAAA,EAAA,SAAA;CACe,CAAA,ESoClB,iBTpCkB,CSoCA,OTpCA,ESoCS,KTpCT,EAAA,SAAA,ESoC2B,aTpC3B,ESoC0C,UTpC1C,ESoCsD,gBTpCtD,CAAA;AAAb,iBSuCQ,QTvCR,CAAA,gBSwCU,UTxCV,EAAA,cAAA,MAAA,EAAA,qBS0Ce,gBT1Cf,EAAA,sBS2CgB,gBT3ChB,GAAA,SAAA,EAAA,mBAAA,MAAA,GAAA,MAAA,EAAA,yBAAA,MAAA,GAAA,MAAA,CAAA,CAAA,KAAA,ES+CC,iBT/CD,CSgDJ,OThDI,ESiDJ,STjDI,CSiDM,KTjDN,CAAA,ESkDJ,YTlDI,ESmDJ,aTnDI,ESoDJ,UTpDI,ESqDJ,gBTrDI,CAAA,GAAA;EAAgD,WAAA,ESuDvC,YTvDuC;CAA1B,CAAA,ESyD3B,iBTzD2B,CSyDT,OTzDS,ESyDA,KTzDA,ESyDO,YTzDP,ESyDqB,aTzDrB,ESyDoC,UTzDpC,ESyDgD,gBTzDhD,CAAA"}

package/dist/api-DngJDcmO.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-DngJDcmO.js","names":["#status","#code","#issues"],"sources":["../src/api/error.ts","../src/api/api.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { StatusCode } from \"../http/http-status\";\n\nexport class FragnoApiError extends Error {\n  readonly #status: StatusCode;\n  readonly #code: string;\n\n  constructor({ message, code }: { message: string; code: string }, status: StatusCode) {\n    super(message);\n    this.name = \"FragnoApiError\";\n    this.#status = status;\n    this.#code = code;\n  }\n\n  get status() {\n    return this.#status;\n  }\n\n  get code() {\n    return this.#code;\n  }\n\n  toResponse() {\n    return Response.json({ message: this.message, code: this.code }, { status: this.status });\n  }\n}\n\nexport class FragnoApiValidationError extends FragnoApiError {\n  #issues: readonly StandardSchemaV1.Issue[];\n\n  constructor(message: string, issues: readonly StandardSchemaV1.Issue[]) {\n    super({ message, code: \"FRAGNO_VALIDATION_ERROR\" }, 400);\n    this.name = \"FragnoApiValidationError\";\n    this.#issues = issues;\n  }\n\n  get issues() {\n    return this.#issues;\n  }\n\n  override toResponse() {\n    return Response.json(\n      { message: this.message, issues: this.#issues, code: this.code },\n      { status: this.status },\n    );\n  }\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { RequestInputContext } from \"./request-input-context\";\nimport type { RequestOutputContext } from \"./request-output-context\";\n\nexport type HTTPMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\" | \"HEAD\" | \"OPTIONS\";\nexport type NonGetHTTPMethod = Exclude<HTTPMethod, \"GET\">;\n\n// Helper type to create branded error messages that are still assignable to string\ntype PathError<T extends string, TMessage extends string> = T & [`Error: ${TMessage}`];\n\n/**\n * A valid path string that:\n * - Is non-empty\n * - Starts with \"/\"\n * - Is not just \"/\"\n * - Does not end with \"/\"\n */\nexport type ValidPath<T extends string = string> = T extends `/${infer Rest}`\n  ? Rest extends \"\"\n    ? PathError<T, \"Path cannot be just '/'.\"> // Excludes \"/\"\n    : T extends `${string}/`\n      ? PathError<T, \"Path cannot end with '/'.\"> // Excludes paths ending with \"/\"\n      : T\n  : PathError<T, \"Path must start with '/'.\">; // Excludes paths not starting with \"/\"\n\nexport interface FragnoRouteConfig<\n  TMethod extends HTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string = string,\n  TQueryParameters extends string = string,\n> {\n  method: TMethod;\n  path: TPath;\n  inputSchema?: TInputSchema;\n  outputSchema?: TOutputSchema;\n  errorCodes?: readonly TErrorCode[];\n  queryParameters?: readonly TQueryParameters[];\n  handler(\n    inputCtx: RequestInputContext<TPath, TInputSchema>,\n    outputCtx: RequestOutputContext<TOutputSchema, TErrorCode>,\n  ): Promise<Response>;\n}\n\n// Overload for routes without inputSchema\nexport function addRoute<\n  TMethod extends HTTPMethod,\n  TPath extends string,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string = string,\n  TQueryParameters extends string = string,\n>(\n  route: FragnoRouteConfig<\n    TMethod,\n    ValidPath<TPath>,\n    undefined,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  > & { inputSchema?: undefined },\n): FragnoRouteConfig<TMethod, TPath, undefined, TOutputSchema, TErrorCode, TQueryParameters>;\n\n// Overload for routes with inputSchema\nexport function addRoute<\n  TMethod extends HTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string = string,\n  TQueryParameters extends string = string,\n>(\n  route: FragnoRouteConfig<\n    TMethod,\n    ValidPath<TPath>,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  > & {\n    inputSchema: TInputSchema;\n  },\n): FragnoRouteConfig<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters>;\n\n// Implementation\nexport function addRoute<\n  TMethod extends HTTPMethod,\n  TPath extends string,\n  TInputSchema extends StandardSchemaV1 | undefined,\n  TOutputSchema extends StandardSchemaV1 | undefined,\n  TErrorCode extends string = string,\n  TQueryParameters extends string = string,\n>(\n  route: FragnoRouteConfig<\n    TMethod,\n    ValidPath<TPath>,\n    TInputSchema,\n    TOutputSchema,\n    TErrorCode,\n    TQueryParameters\n  >,\n): FragnoRouteConfig<TMethod, TPath, TInputSchema, TOutputSchema, TErrorCode, TQueryParameters> {\n  return route;\n}\n\nexport { FragnoApiError, FragnoApiValidationError } from \"./error\";\nexport type { RouteHandlerInputOptions } from \"./route-handler-input-options\";\n"],"mappings":";AAGA,IAAa,iBAAb,cAAoC,MAAM;CACxC,CAASA;CACT,CAASC;CAET,YAAY,EAAE,SAAS,QAA2C,QAAoB;AACpF,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,QAAKD,SAAU;AACf,QAAKC,OAAQ;;CAGf,IAAI,SAAS;AACX,SAAO,MAAKD;;CAGd,IAAI,OAAO;AACT,SAAO,MAAKC;;CAGd,aAAa;AACX,SAAO,SAAS,KAAK;GAAE,SAAS,KAAK;GAAS,MAAM,KAAK;GAAM,EAAE,EAAE,QAAQ,KAAK,QAAQ,CAAC;;;AAI7F,IAAa,2BAAb,cAA8C,eAAe;CAC3D;CAEA,YAAY,SAAiB,QAA2C;AACtE,QAAM;GAAE;GAAS,MAAM;GAA2B,EAAE,IAAI;AACxD,OAAK,OAAO;AACZ,QAAKC,SAAU;;CAGjB,IAAI,SAAS;AACX,SAAO,MAAKA;;CAGd,AAAS,aAAa;AACpB,SAAO,SAAS,KACd;GAAE,SAAS,KAAK;GAAS,QAAQ,MAAKA;GAAS,MAAM,KAAK;GAAM,EAChE,EAAE,QAAQ,KAAK,QAAQ,CACxB;;;;;;ACyCL,SAAgB,SAQd,OAQ8F;AAC9F,QAAO"}