semola 0.5.4 → 0.6.1

package/dist/lib/api/index.d.cts

@@ -1,271 +1 @@
-//#region src/lib/api/openapi/types.d.ts
-type OpenApiSpec = {
-  openapi: string;
-  info: {
-    title: string;
-    description?: string;
-    version: string;
-  };
-  servers?: Array<{
-    url: string;
-    description?: string;
-  }>;
-  paths: Record<string, OpenApiPath>;
-  components?: {
-    schemas?: Record<string, unknown>;
-    responses?: Record<string, unknown>;
-    parameters?: Record<string, unknown>;
-    requestBodies?: Record<string, unknown>;
-    securitySchemes?: Record<string, unknown>;
-  };
-};
-type OpenApiPath = {
-  [method: string]: OpenApiOperation;
-};
-type OpenApiOperation = {
-  summary?: string;
-  description?: string;
-  operationId?: string;
-  tags?: string[];
-  parameters?: OpenApiParameter[];
-  requestBody?: OpenApiRequestBody;
-  responses: Record<string, OpenApiResponse>;
-  security?: Array<Record<string, string[]>>;
-};
-type OpenApiParameter = {
-  name: string;
-  in: "path" | "query" | "header" | "cookie";
-  required?: boolean;
-  schema: unknown;
-  description?: string;
-};
-type OpenApiRequestBody = {
-  required?: boolean;
-  content: {
-    [mediaType: string]: {
-      schema: unknown;
-    };
-  };
-};
-type OpenApiResponse = {
-  description: string;
-  content?: {
-    [mediaType: string]: {
-      schema: unknown;
-    };
-  };
-};
-//#endregion
-//#region node_modules/@standard-schema/spec/dist/index.d.ts
-/** The Standard Typed interface. This is a base type extended by other specs. */
-interface StandardTypedV1<Input = unknown, Output = Input> {
-  /** The Standard properties. */
-  readonly "~standard": StandardTypedV1.Props<Input, Output>;
-}
-declare namespace StandardTypedV1 {
-  /** The Standard Typed properties interface. */
-  interface Props<Input = unknown, Output = Input> {
-    /** The version number of the standard. */
-    readonly version: 1;
-    /** The vendor name of the schema library. */
-    readonly vendor: string;
-    /** Inferred types associated with the schema. */
-    readonly types?: Types<Input, Output> | undefined;
-  }
-  /** The Standard Typed types interface. */
-  interface Types<Input = unknown, Output = Input> {
-    /** The input type of the schema. */
-    readonly input: Input;
-    /** The output type of the schema. */
-    readonly output: Output;
-  }
-  /** Infers the input type of a Standard Typed. */
-  type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["input"];
-  /** Infers the output type of a Standard Typed. */
-  type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema["~standard"]["types"]>["output"];
-}
-/** The Standard Schema interface. */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-  /** The Standard Schema properties. */
-  readonly "~standard": StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-  /** The Standard Schema properties interface. */
-  interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {
-    /** Validates unknown input values. */
-    readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
-  }
-  /** The result interface of the validate function. */
-  type Result<Output> = SuccessResult<Output> | FailureResult;
-  /** The result interface if validation succeeds. */
-  interface SuccessResult<Output> {
-    /** The typed output value. */
-    readonly value: Output;
-    /** A falsy value for `issues` indicates success. */
-    readonly issues?: undefined;
-  }
-  interface Options {
-    /** Explicit support for additional vendor-specific parameters, if needed. */
-    readonly libraryOptions?: Record<string, unknown> | undefined;
-  }
-  /** The result interface if validation fails. */
-  interface FailureResult {
-    /** The issues of failed validation. */
-    readonly issues: ReadonlyArray<Issue>;
-  }
-  /** The issue interface of the failure output. */
-  interface Issue {
-    /** The error message of the issue. */
-    readonly message: string;
-    /** The path of the issue, if any. */
-    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
-  }
-  /** The path segment interface of the issue. */
-  interface PathSegment {
-    /** The key representing a path segment. */
-    readonly key: PropertyKey;
-  }
-  /** The Standard types interface. */
-  interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {}
-  /** Infers the input type of a Standard. */
-  type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;
-  /** Infers the output type of a Standard. */
-  type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
-}
-/** The Standard JSON Schema interface. */
-//#endregion
-//#region src/lib/api/middleware/types.d.ts
-type MiddlewareHandler<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<never, never>> = (c: Context<TReq, TRes>) => Response | TExt | undefined | Promise<Response | TExt | undefined> | Promise<void> | void;
-type MiddlewareOptions<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<string, unknown>> = {
-  request?: TReq;
-  response?: TRes;
-  handler: MiddlewareHandler<TReq, TRes, TExt>;
-};
-type InferMiddlewareExtension<T> = T extends {
-  options: MiddlewareOptions<infer _TReq, infer _TRes, infer E>;
-} ? E : never;
-type MergeMiddlewareExtensions<T extends readonly unknown[]> = T extends readonly [infer First, ...infer Rest] ? InferMiddlewareExtension<First> & MergeMiddlewareExtensions<Rest> : {};
-//#endregion
-//#region src/lib/api/core/types.d.ts
-type ResponseSchema = {
-  [status: number]: StandardSchemaV1;
-};
-type RequestSchema = {
-  params?: StandardSchemaV1;
-  body?: StandardSchemaV1;
-  query?: StandardSchemaV1;
-  headers?: StandardSchemaV1;
-  cookies?: StandardSchemaV1;
-};
-type SafeTypeAccess<T, K extends "input" | "output"> = T extends StandardSchemaV1 ? T["~standard"] extends {
-  types?: infer U;
-} ? U extends Record<K, infer V> ? V : never : never : undefined;
-type InferOutput<T extends StandardSchemaV1 | undefined> = SafeTypeAccess<T, "output">;
-type InferInput<T extends StandardSchemaV1 | undefined> = SafeTypeAccess<T, "input">;
-type ExtractStatusCodes<T extends ResponseSchema> = keyof T & number;
-type ExtractStatusCodesOrAny<T extends ResponseSchema | undefined> = T extends ResponseSchema ? ExtractStatusCodes<T> : number;
-type ValidationOptions = boolean | {
-  input?: boolean;
-  output?: boolean;
-};
-type ApiOptions<TMiddlewares extends readonly Middleware[] = readonly []> = {
-  prefix?: string;
-  openapi?: OpenApiOptions;
-  middlewares?: TMiddlewares;
-  validation?: ValidationOptions;
-};
-type SecuritySchemeApiKey = {
-  type: "apiKey";
-  name: string;
-  in: "query" | "header" | "cookie";
-  description?: string;
-};
-type SecuritySchemeHttp = {
-  type: "http";
-  scheme: string;
-  bearerFormat?: string;
-  description?: string;
-};
-type SecuritySchemeOAuth2Flow = {
-  authorizationUrl?: string;
-  tokenUrl?: string;
-  refreshUrl?: string;
-  scopes: Record<string, string>;
-};
-type SecuritySchemeOAuth2 = {
-  type: "oauth2";
-  flows: {
-    implicit?: SecuritySchemeOAuth2Flow;
-    password?: SecuritySchemeOAuth2Flow;
-    clientCredentials?: SecuritySchemeOAuth2Flow;
-    authorizationCode?: SecuritySchemeOAuth2Flow;
-  };
-  description?: string;
-};
-type SecuritySchemeOpenIdConnect = {
-  type: "openIdConnect";
-  openIdConnectUrl: string;
-  description?: string;
-};
-type SecurityScheme = SecuritySchemeApiKey | SecuritySchemeHttp | SecuritySchemeOAuth2 | SecuritySchemeOpenIdConnect;
-type OpenApiOptions = {
-  version: string;
-  title: string;
-  description?: string;
-  servers?: Array<{
-    url: string;
-    description?: string;
-  }>;
-  securitySchemes?: Record<string, SecurityScheme>;
-};
-type Context<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<string, unknown>> = {
-  raw: Request;
-  req: {
-    body: InferOutput<TReq["body"]>;
-    query: InferOutput<TReq["query"]>;
-    headers: InferOutput<TReq["headers"]>;
-    cookies: InferOutput<TReq["cookies"]>;
-    params: InferOutput<TReq["params"]>;
-  };
-  json: <S extends ExtractStatusCodesOrAny<TRes>>(status: S, data: TRes extends ResponseSchema ? InferOutput<TRes[S]> : unknown) => Response;
-  text: (status: number, text: string) => Response;
-  html: (status: number, html: string) => Response;
-  redirect: (status: number, url: string) => Response;
-  get: <K extends keyof TExt>(key: K) => TExt[K];
-};
-type RouteHandler<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<string, unknown>> = (c: Context<TReq, TRes, TExt>) => Response | Promise<Response>;
-type RouteConfig<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TGlobalMiddlewares extends readonly Middleware[] = readonly [], TRouteMiddlewares extends readonly Middleware[] = readonly []> = {
-  path: string;
-  method: Bun.Serve.HTTPMethod;
-  request?: TReq;
-  response?: TRes;
-  middlewares?: TRouteMiddlewares;
-  handler: RouteHandler<TReq, TRes, MergeMiddlewareExtensions<TGlobalMiddlewares> & MergeMiddlewareExtensions<TRouteMiddlewares>>;
-  summary?: string;
-  description?: string;
-  operationId?: string;
-  tags?: string[];
-};
-//#endregion
-//#region src/lib/api/middleware/index.d.ts
-declare class Middleware<TRequest extends RequestSchema = RequestSchema, TResponse extends ResponseSchema = ResponseSchema, TExtension extends Record<string, unknown> = Record<string, unknown>> {
-  options: MiddlewareOptions<TRequest, TResponse, TExtension>;
-  constructor(options: MiddlewareOptions<TRequest, TResponse, TExtension>);
-}
-//#endregion
-//#region src/lib/api/core/index.d.ts
-declare class Api<TMiddlewares extends readonly Middleware[] = readonly []> {
-  private options;
-  private routes;
-  constructor(options?: ApiOptions<TMiddlewares>);
-  private getFullPath;
-  private validateRequestSchema;
-  private createContext;
-  private validateResponseBody;
-  private buildBunRoutes;
-  defineRoute<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema = ResponseSchema, TRouteMiddlewares extends readonly Middleware[] = readonly []>(config: RouteConfig<TReq, TRes, TMiddlewares, TRouteMiddlewares>): void;
-  getOpenApiSpec(): Promise<OpenApiSpec>;
-  serve(port: number, callback?: (server: Bun.Server<unknown>) => void): void;
-}
-//#endregion
-export { Api, type ApiOptions, type Context, type ExtractStatusCodes, type InferInput, type InferMiddlewareExtension, type InferOutput, type MergeMiddlewareExtensions, Middleware, type MiddlewareHandler, type MiddlewareOptions, type OpenApiOptions, type RequestSchema, type ResponseSchema, type RouteConfig, type RouteHandler, type SecurityScheme, type SecuritySchemeApiKey, type SecuritySchemeHttp, type SecuritySchemeOAuth2, type SecuritySchemeOAuth2Flow, type SecuritySchemeOpenIdConnect };
+export type * from './index.d.mts'

package/dist/lib/api/index.d.mts

@@ -1,61 +1,3 @@
-//#region src/lib/api/openapi/types.d.ts
-type OpenApiSpec = {
-  openapi: string;
-  info: {
-    title: string;
-    description?: string;
-    version: string;
-  };
-  servers?: Array<{
-    url: string;
-    description?: string;
-  }>;
-  paths: Record<string, OpenApiPath>;
-  components?: {
-    schemas?: Record<string, unknown>;
-    responses?: Record<string, unknown>;
-    parameters?: Record<string, unknown>;
-    requestBodies?: Record<string, unknown>;
-    securitySchemes?: Record<string, unknown>;
-  };
-};
-type OpenApiPath = {
-  [method: string]: OpenApiOperation;
-};
-type OpenApiOperation = {
-  summary?: string;
-  description?: string;
-  operationId?: string;
-  tags?: string[];
-  parameters?: OpenApiParameter[];
-  requestBody?: OpenApiRequestBody;
-  responses: Record<string, OpenApiResponse>;
-  security?: Array<Record<string, string[]>>;
-};
-type OpenApiParameter = {
-  name: string;
-  in: "path" | "query" | "header" | "cookie";
-  required?: boolean;
-  schema: unknown;
-  description?: string;
-};
-type OpenApiRequestBody = {
-  required?: boolean;
-  content: {
-    [mediaType: string]: {
-      schema: unknown;
-    };
-  };
-};
-type OpenApiResponse = {
-  description: string;
-  content?: {
-    [mediaType: string]: {
-      schema: unknown;
-    };
-  };
-};
-//#endregion
 //#region node_modules/@standard-schema/spec/dist/index.d.ts
 /** The Standard Typed interface. This is a base type extended by other specs. */
 interface StandardTypedV1<Input = unknown, Output = Input> {
@@ -134,19 +76,15 @@ declare namespace StandardSchemaV1 {
 }
 /** The Standard JSON Schema interface. */
 //#endregion
-//#region src/lib/api/middleware/types.d.ts
-type MiddlewareHandler<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<never, never>> = (c: Context<TReq, TRes>) => Response | TExt | undefined | Promise<Response | TExt | undefined> | Promise<void> | void;
-type MiddlewareOptions<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<string, unknown>> = {
-  request?: TReq;
-  response?: TRes;
-  handler: MiddlewareHandler<TReq, TRes, TExt>;
-};
-type InferMiddlewareExtension<T> = T extends {
-  options: MiddlewareOptions<infer _TReq, infer _TRes, infer E>;
-} ? E : never;
-type MergeMiddlewareExtensions<T extends readonly unknown[]> = T extends readonly [infer First, ...infer Rest] ? InferMiddlewareExtension<First> & MergeMiddlewareExtensions<Rest> : {};
+//#region src/lib/api/middleware.d.ts
+declare class Middleware<TRequest extends RequestSchema = RequestSchema, TResponse extends ResponseSchema = ResponseSchema, TExtension extends Record<string, unknown> = Record<string, unknown>> {
+  options: MiddlewareOptions<TRequest, TResponse, TExtension>;
+  constructor(options: MiddlewareOptions<TRequest, TResponse, TExtension>);
+}
 //#endregion
-//#region src/lib/api/core/types.d.ts
+//#region src/lib/api/types.d.ts
+type HTTPMethod = Bun.Serve.HTTPMethod;
+type BunHandler = Bun.Serve.Handler<Bun.BunRequest, Bun.Server<unknown>, Response>;
 type ResponseSchema = {
   [status: number]: StandardSchemaV1;
 };
@@ -233,39 +171,97 @@ type Context<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSc
   redirect: (status: number, url: string) => Response;
   get: <K extends keyof TExt>(key: K) => TExt[K];
 };
+type RouteReturn = Response | string | number | boolean | null | Record<string, unknown> | unknown[];
 type RouteHandler<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<string, unknown>> = (c: Context<TReq, TRes, TExt>) => Response | Promise<Response>;
+type BareRouteHandler = () => RouteReturn | Promise<RouteReturn>;
+type MethodRoutes = Record<string, Partial<Record<HTTPMethod, BunHandler>>>;
 type RouteConfig<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TGlobalMiddlewares extends readonly Middleware[] = readonly [], TRouteMiddlewares extends readonly Middleware[] = readonly []> = {
   path: string;
   method: Bun.Serve.HTTPMethod;
   request?: TReq;
   response?: TRes;
   middlewares?: TRouteMiddlewares;
-  handler: RouteHandler<TReq, TRes, MergeMiddlewareExtensions<TGlobalMiddlewares> & MergeMiddlewareExtensions<TRouteMiddlewares>>;
+  handler: RouteHandler<TReq, TRes, MergeMiddlewareExtensions<TGlobalMiddlewares> & MergeMiddlewareExtensions<TRouteMiddlewares>> | BareRouteHandler;
   summary?: string;
   description?: string;
   operationId?: string;
   tags?: string[];
 };
+type MiddlewareHandler<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<never, never>> = (c: Context<TReq, TRes>) => Response | TExt | undefined | Promise<Response | TExt | undefined> | Promise<void> | void;
+type MiddlewareOptions<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema | undefined = undefined, TExt extends Record<string, unknown> = Record<string, unknown>> = {
+  request?: TReq;
+  response?: TRes;
+  handler: MiddlewareHandler<TReq, TRes, TExt>;
+};
+type InferMiddlewareExtension<T> = T extends {
+  options: MiddlewareOptions<infer _TReq, infer _TRes, infer E>;
+} ? E : never;
+type MergeMiddlewareExtensions<T extends readonly unknown[]> = T extends readonly [infer First, ...infer Rest] ? InferMiddlewareExtension<First> & MergeMiddlewareExtensions<Rest> : {};
+type OpenApiSpec = {
+  openapi: string;
+  info: {
+    title: string;
+    description?: string;
+    version: string;
+  };
+  servers?: Array<{
+    url: string;
+    description?: string;
+  }>;
+  paths: Record<string, OpenApiPath>;
+  components?: {
+    schemas?: Record<string, unknown>;
+    securitySchemes?: Record<string, unknown>;
+  };
+};
+type OpenApiPath = {
+  [method: string]: OpenApiOperation;
+};
+type OpenApiOperation = {
+  summary?: string;
+  description?: string;
+  operationId?: string;
+  tags?: string[];
+  parameters?: OpenApiParameter[];
+  requestBody?: OpenApiRequestBody;
+  responses: Record<string, OpenApiResponse>;
+};
+type OpenApiParameter = {
+  name: string;
+  in: "path" | "query" | "header" | "cookie";
+  required?: boolean;
+  schema: unknown;
+};
+type OpenApiRequestBody = {
+  required?: boolean;
+  content: {
+    [mediaType: string]: {
+      schema: unknown;
+    };
+  };
+};
+type OpenApiResponse = {
+  description: string;
+  content?: {
+    [mediaType: string]: {
+      schema: unknown;
+    };
+  };
+};
 //#endregion
-//#region src/lib/api/middleware/index.d.ts
-declare class Middleware<TRequest extends RequestSchema = RequestSchema, TResponse extends ResponseSchema = ResponseSchema, TExtension extends Record<string, unknown> = Record<string, unknown>> {
-  options: MiddlewareOptions<TRequest, TResponse, TExtension>;
-  constructor(options: MiddlewareOptions<TRequest, TResponse, TExtension>);
-}
-//#endregion
-//#region src/lib/api/core/index.d.ts
+//#region src/lib/api/api.d.ts
 declare class Api<TMiddlewares extends readonly Middleware[] = readonly []> {
   private options;
   private routes;
+  private routesDirty;
+  private compiled?;
   constructor(options?: ApiOptions<TMiddlewares>);
-  private getFullPath;
-  private validateRequestSchema;
-  private createContext;
-  private validateResponseBody;
-  private buildBunRoutes;
   defineRoute<TReq extends RequestSchema = RequestSchema, TRes extends ResponseSchema = ResponseSchema, TRouteMiddlewares extends readonly Middleware[] = readonly []>(config: RouteConfig<TReq, TRes, TMiddlewares, TRouteMiddlewares>): void;
-  getOpenApiSpec(): Promise<OpenApiSpec>;
+  fetch: (req: Request) => Promise<Response> | Response;
+  getRouteHandlers(): MethodRoutes;
+  getOpenApiSpec(): OpenApiSpec;
   serve(port: number, callback?: (server: Bun.Server<unknown>) => void): void;
+  private ensureCompiled;
 }
 //#endregion
 export { Api, type ApiOptions, type Context, type ExtractStatusCodes, type InferInput, type InferMiddlewareExtension, type InferOutput, type MergeMiddlewareExtensions, Middleware, type MiddlewareHandler, type MiddlewareOptions, type OpenApiOptions, type RequestSchema, type ResponseSchema, type RouteConfig, type RouteHandler, type SecurityScheme, type SecuritySchemeApiKey, type SecuritySchemeHttp, type SecuritySchemeOAuth2, type SecuritySchemeOAuth2Flow, type SecuritySchemeOpenIdConnect };