bluera-knowledge 0.13.3 → 0.14.1

package/tests/fixtures/corpus/oss-repos/hono/src/hono-base.ts

@@ -1,523 +0,0 @@
-/**
- * @module
- * This module is the base module for the Hono object.
- */
-
-/* eslint-disable @typescript-eslint/no-explicit-any */
-import { compose } from './compose'
-import { Context } from './context'
-import type { ExecutionContext } from './context'
-import type { Router } from './router'
-import { METHODS, METHOD_NAME_ALL, METHOD_NAME_ALL_LOWERCASE } from './router'
-import type {
-  Env,
-  ErrorHandler,
-  FetchEventLike,
-  H,
-  HTTPResponseError,
-  HandlerInterface,
-  MergePath,
-  MergeSchemaPath,
-  MiddlewareHandler,
-  MiddlewareHandlerInterface,
-  Next,
-  NotFoundHandler,
-  OnHandlerInterface,
-  RouterRoute,
-  Schema,
-} from './types'
-import { getPath, getPathNoStrict, mergePath } from './utils/url'
-
-/**
- * Symbol used to mark a composed handler.
- */
-export const COMPOSED_HANDLER = Symbol('composedHandler')
-
-const notFoundHandler = (c: Context) => {
-  return c.text('404 Not Found', 404)
-}
-
-const errorHandler = (err: Error | HTTPResponseError, c: Context) => {
-  if ('getResponse' in err) {
-    return err.getResponse()
-  }
-  console.error(err)
-  return c.text('Internal Server Error', 500)
-}
-
-type GetPath<E extends Env> = (request: Request, options?: { env?: E['Bindings'] }) => string
-
-export type HonoOptions<E extends Env> = {
-  /**
-   * `strict` option specifies whether to distinguish whether the last path is a directory or not.
-   *
-   * @see {@link https://hono.dev/docs/api/hono#strict-mode}
-   *
-   * @default true
-   */
-  strict?: boolean
-  /**
-   * `router` option specifices which router to use.
-   *
-   * @see {@link https://hono.dev/docs/api/hono#router-option}
-   *
-   * @example
-   * ```ts
-   * const app = new Hono({ router: new RegExpRouter() })
-   * ```
-   */
-  router?: Router<[H, RouterRoute]>
-  /**
-   * `getPath` can handle the host header value.
-   *
-   * @see {@link https://hono.dev/docs/api/routing#routing-with-host-header-value}
-   *
-   * @example
-   * ```ts
-   * const app = new Hono({
-   *  getPath: (req) =>
-   *   '/' + req.headers.get('host') + req.url.replace(/^https?:\/\/[^/]+(\/[^?]*)/, '$1'),
-   * })
-   *
-   * app.get('/www1.example.com/hello', () => c.text('hello www1'))
-   *
-   * // A following request will match the route:
-   * // new Request('http://www1.example.com/hello', {
-   * //  headers: { host: 'www1.example.com' },
-   * // })
-   * ```
-   */
-  getPath?: GetPath<E>
-}
-
-type MountOptionHandler = (c: Context) => unknown
-type MountReplaceRequest = (originalRequest: Request) => Request
-type MountOptions =
-  | MountOptionHandler
-  | {
-      optionHandler?: MountOptionHandler
-      replaceRequest?: MountReplaceRequest
-    }
-
-class Hono<E extends Env = Env, S extends Schema = {}, BasePath extends string = '/'> {
-  get!: HandlerInterface<E, 'get', S, BasePath>
-  post!: HandlerInterface<E, 'post', S, BasePath>
-  put!: HandlerInterface<E, 'put', S, BasePath>
-  delete!: HandlerInterface<E, 'delete', S, BasePath>
-  options!: HandlerInterface<E, 'options', S, BasePath>
-  patch!: HandlerInterface<E, 'patch', S, BasePath>
-  all!: HandlerInterface<E, 'all', S, BasePath>
-  on: OnHandlerInterface<E, S, BasePath>
-  use: MiddlewareHandlerInterface<E, S, BasePath>
-
-  /*
-    This class is like an abstract class and does not have a router.
-    To use it, inherit the class and implement router in the constructor.
-  */
-  router!: Router<[H, RouterRoute]>
-  readonly getPath: GetPath<E>
-  // Cannot use `#` because it requires visibility at JavaScript runtime.
-  private _basePath: string = '/'
-  #path: string = '/'
-
-  routes: RouterRoute[] = []
-
-  constructor(options: HonoOptions<E> = {}) {
-    // Implementation of app.get(...handlers[]) or app.get(path, ...handlers[])
-    const allMethods = [...METHODS, METHOD_NAME_ALL_LOWERCASE]
-    allMethods.forEach((method) => {
-      this[method] = (args1: string | H, ...args: H[]) => {
-        if (typeof args1 === 'string') {
-          this.#path = args1
-        } else {
-          this.addRoute(method, this.#path, args1)
-        }
-        args.forEach((handler) => {
-          if (typeof handler !== 'string') {
-            this.addRoute(method, this.#path, handler)
-          }
-        })
-        return this as any
-      }
-    })
-
-    // Implementation of app.on(method, path, ...handlers[])
-    this.on = (method: string | string[], path: string | string[], ...handlers: H[]) => {
-      for (const p of [path].flat()) {
-        this.#path = p
-        for (const m of [method].flat()) {
-          handlers.map((handler) => {
-            this.addRoute(m.toUpperCase(), this.#path, handler)
-          })
-        }
-      }
-      return this as any
-    }
-
-    // Implementation of app.use(...handlers[]) or app.use(path, ...handlers[])
-    this.use = (arg1: string | MiddlewareHandler<any>, ...handlers: MiddlewareHandler<any>[]) => {
-      if (typeof arg1 === 'string') {
-        this.#path = arg1
-      } else {
-        this.#path = '*'
-        handlers.unshift(arg1)
-      }
-      handlers.forEach((handler) => {
-        this.addRoute(METHOD_NAME_ALL, this.#path, handler)
-      })
-      return this as any
-    }
-
-    const strict = options.strict ?? true
-    delete options.strict
-    Object.assign(this, options)
-    this.getPath = strict ? (options.getPath ?? getPath) : getPathNoStrict
-  }
-
-  private clone(): Hono<E, S, BasePath> {
-    const clone = new Hono<E, S, BasePath>({
-      router: this.router,
-      getPath: this.getPath,
-    })
-    clone.routes = this.routes
-    return clone
-  }
-
-  private notFoundHandler: NotFoundHandler = notFoundHandler
-  private errorHandler: ErrorHandler = errorHandler
-
-  /**
-   * `.route()` allows grouping other Hono instance in routes.
-   *
-   * @see {@link https://hono.dev/docs/api/routing#grouping}
-   *
-   * @param {string} path - base Path
-   * @param {Hono} app - other Hono instance
-   * @returns {Hono} routed Hono instance
-   *
-   * @example
-   * ```ts
-   * const app = new Hono()
-   * const app2 = new Hono()
-   *
-   * app2.get("/user", (c) => c.text("user"))
-   * app.route("/api", app2) // GET /api/user
-   * ```
-   */
-  route<
-    SubPath extends string,
-    SubEnv extends Env,
-    SubSchema extends Schema,
-    SubBasePath extends string,
-  >(
-    path: SubPath,
-    app: Hono<SubEnv, SubSchema, SubBasePath>
-  ): Hono<E, MergeSchemaPath<SubSchema, MergePath<BasePath, SubPath>> & S, BasePath> {
-    const subApp = this.basePath(path)
-    app.routes.map((r) => {
-      let handler
-      if (app.errorHandler === errorHandler) {
-        handler = r.handler
-      } else {
-        handler = async (c: Context, next: Next) =>
-          (await compose<Context>([], app.errorHandler)(c, () => r.handler(c, next))).res
-        ;(handler as any)[COMPOSED_HANDLER] = r.handler
-      }
-
-      subApp.addRoute(r.method, r.path, handler)
-    })
-    return this
-  }
-
-  /**
-   * `.basePath()` allows base paths to be specified.
-   *
-   * @see {@link https://hono.dev/docs/api/routing#base-path}
-   *
-   * @param {string} path - base Path
-   * @returns {Hono} changed Hono instance
-   *
-   * @example
-   * ```ts
-   * const api = new Hono().basePath('/api')
-   * ```
-   */
-  basePath<SubPath extends string>(path: SubPath): Hono<E, S, MergePath<BasePath, SubPath>> {
-    const subApp = this.clone()
-    subApp._basePath = mergePath(this._basePath, path)
-    return subApp
-  }
-
-  /**
-   * `.onError()` handles an error and returns a customized Response.
-   *
-   * @see {@link https://hono.dev/docs/api/hono#error-handling}
-   *
-   * @param {ErrorHandler} handler - request Handler for error
-   * @returns {Hono} changed Hono instance
-   *
-   * @example
-   * ```ts
-   * app.onError((err, c) => {
-   *   console.error(`${err}`)
-   *   return c.text('Custom Error Message', 500)
-   * })
-   * ```
-   */
-  onError = (handler: ErrorHandler<E>): Hono<E, S, BasePath> => {
-    this.errorHandler = handler
-    return this
-  }
-
-  /**
-   * `.notFound()` allows you to customize a Not Found Response.
-   *
-   * @see {@link https://hono.dev/docs/api/hono#not-found}
-   *
-   * @param {NotFoundHandler} handler - request handler for not-found
-   * @returns {Hono} changed Hono instance
-   *
-   * @example
-   * ```ts
-   * app.notFound((c) => {
-   *   return c.text('Custom 404 Message', 404)
-   * })
-   * ```
-   */
-  notFound = (handler: NotFoundHandler<E>): Hono<E, S, BasePath> => {
-    this.notFoundHandler = handler
-    return this
-  }
-
-  /**
-   * `.mount()` allows you to mount applications built with other frameworks into your Hono application.
-   *
-   * @see {@link https://hono.dev/docs/api/hono#mount}
-   *
-   * @param {string} path - base Path
-   * @param {Function} applicationHandler - other Request Handler
-   * @param {MountOptions} [options] - options of `.mount()`
-   * @returns {Hono} mounted Hono instance
-   *
-   * @example
-   * ```ts
-   * import { Router as IttyRouter } from 'itty-router'
-   * import { Hono } from 'hono'
-   * // Create itty-router application
-   * const ittyRouter = IttyRouter()
-   * // GET /itty-router/hello
-   * ittyRouter.get('/hello', () => new Response('Hello from itty-router'))
-   *
-   * const app = new Hono()
-   * app.mount('/itty-router', ittyRouter.handle)
-   * ```
-   *
-   * @example
-   * ```ts
-   * const app = new Hono()
-   * // Send the request to another application without modification.
-   * app.mount('/app', anotherApp, {
-   *   replaceRequest: (req) => req,
-   * })
-   * ```
-   */
-  mount(
-    path: string,
-    applicationHandler: (request: Request, ...args: any) => Response | Promise<Response>,
-    options?: MountOptions
-  ): Hono<E, S, BasePath> {
-    // handle options
-    let replaceRequest: MountReplaceRequest | undefined
-    let optionHandler: MountOptionHandler | undefined
-    if (options) {
-      if (typeof options === 'function') {
-        optionHandler = options
-      } else {
-        optionHandler = options.optionHandler
-        replaceRequest = options.replaceRequest
-      }
-    }
-
-    // prepare handlers for request
-    const getOptions: (c: Context) => unknown[] = optionHandler
-      ? (c) => {
-          const options = optionHandler!(c)
-          return Array.isArray(options) ? options : [options]
-        }
-      : (c) => {
-          let executionContext: ExecutionContext | undefined = undefined
-          try {
-            executionContext = c.executionCtx
-          } catch {} // Do nothing
-          return [c.env, executionContext]
-        }
-    replaceRequest ||= (() => {
-      const mergedPath = mergePath(this._basePath, path)
-      const pathPrefixLength = mergedPath === '/' ? 0 : mergedPath.length
-      return (request) => {
-        const url = new URL(request.url)
-        url.pathname = url.pathname.slice(pathPrefixLength) || '/'
-        return new Request(url, request)
-      }
-    })()
-
-    const handler: MiddlewareHandler = async (c, next) => {
-      const res = await applicationHandler(replaceRequest!(c.req.raw), ...getOptions(c))
-
-      if (res) {
-        return res
-      }
-
-      await next()
-    }
-    this.addRoute(METHOD_NAME_ALL, mergePath(path, '*'), handler)
-    return this
-  }
-
-  private addRoute(method: string, path: string, handler: H) {
-    method = method.toUpperCase()
-    path = mergePath(this._basePath, path)
-    const r: RouterRoute = { path: path, method: method, handler: handler }
-    this.router.add(method, path, [handler, r])
-    this.routes.push(r)
-  }
-
-  private matchRoute(method: string, path: string) {
-    return this.router.match(method, path)
-  }
-
-  private handleError(err: unknown, c: Context<E>) {
-    if (err instanceof Error) {
-      return this.errorHandler(err, c)
-    }
-    throw err
-  }
-
-  private dispatch(
-    request: Request,
-    executionCtx: ExecutionContext | FetchEventLike | undefined,
-    env: E['Bindings'],
-    method: string
-  ): Response | Promise<Response> {
-    // Handle HEAD method
-    if (method === 'HEAD') {
-      return (async () =>
-        new Response(null, await this.dispatch(request, executionCtx, env, 'GET')))()
-    }
-
-    const path = this.getPath(request, { env })
-    const matchResult = this.matchRoute(method, path)
-
-    const c = new Context(request, {
-      path,
-      matchResult,
-      env,
-      executionCtx,
-      notFoundHandler: this.notFoundHandler,
-    })
-
-    // Do not `compose` if it has only one handler
-    if (matchResult[0].length === 1) {
-      let res: ReturnType<H>
-      try {
-        res = matchResult[0][0][0][0](c, async () => {
-          c.res = await this.notFoundHandler(c)
-        })
-      } catch (err) {
-        return this.handleError(err, c)
-      }
-
-      return res instanceof Promise
-        ? res
-            .then(
-              (resolved: Response | undefined) =>
-                resolved || (c.finalized ? c.res : this.notFoundHandler(c))
-            )
-            .catch((err: Error) => this.handleError(err, c))
-        : (res ?? this.notFoundHandler(c))
-    }
-
-    const composed = compose<Context>(matchResult[0], this.errorHandler, this.notFoundHandler)
-
-    return (async () => {
-      try {
-        const context = await composed(c)
-        if (!context.finalized) {
-          throw new Error(
-            'Context is not finalized. Did you forget to return a Response object or `await next()`?'
-          )
-        }
-
-        return context.res
-      } catch (err) {
-        return this.handleError(err, c)
-      }
-    })()
-  }
-
-  /**
-   * `.fetch()` will be entry point of your app.
-   *
-   * @see {@link https://hono.dev/docs/api/hono#fetch}
-   *
-   * @param {Request} request - request Object of request
-   * @param {Env} Env - env Object
-   * @param {ExecutionContext} - context of execution
-   * @returns {Response | Promise<Response>} response of request
-   *
-   */
-  fetch: (
-    request: Request,
-    Env?: E['Bindings'] | {},
-    executionCtx?: ExecutionContext
-  ) => Response | Promise<Response> = (request, ...rest) => {
-    return this.dispatch(request, rest[1], rest[0], request.method)
-  }
-
-  /**
-   * `.request()` is a useful method for testing.
-   * You can pass a URL or pathname to send a GET request.
-   * app will return a Response object.
-   * ```ts
-   * test('GET /hello is ok', async () => {
-   *   const res = await app.request('/hello')
-   *   expect(res.status).toBe(200)
-   * })
-   * ```
-   * @see https://hono.dev/docs/api/hono#request
-   */
-  request = (
-    input: RequestInfo | URL,
-    requestInit?: RequestInit,
-    Env?: E['Bindings'] | {},
-    executionCtx?: ExecutionContext
-  ): Response | Promise<Response> => {
-    if (input instanceof Request) {
-      if (requestInit !== undefined) {
-        input = new Request(input, requestInit)
-      }
-      return this.fetch(input, Env, executionCtx)
-    }
-    input = input.toString()
-    const path = /^https?:\/\//.test(input) ? input : `http://localhost${mergePath('/', input)}`
-    const req = new Request(path, requestInit)
-    return this.fetch(req, Env, executionCtx)
-  }
-
-  /**
-   * `.fire()` automatically adds a global fetch event listener.
-   * This can be useful for environments that adhere to the Service Worker API, such as non-ES module Cloudflare Workers.
-   * @see https://hono.dev/docs/api/hono#fire
-   * @see https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API
-   * @see https://developers.cloudflare.com/workers/reference/migrate-to-module-workers/
-   */
-  fire = (): void => {
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-ignore
-    addEventListener('fetch', (event: FetchEventLike): void => {
-      event.respondWith(this.dispatch(event.request, event, undefined, event.request.method))
-    })
-  }
-}
-
-export { Hono as HonoBase }

package/tests/fixtures/corpus/oss-repos/hono/src/hono.ts

@@ -1,34 +0,0 @@
-import { HonoBase } from './hono-base'
-import type { HonoOptions } from './hono-base'
-import { RegExpRouter } from './router/reg-exp-router'
-import { SmartRouter } from './router/smart-router'
-import { TrieRouter } from './router/trie-router'
-import type { BlankEnv, BlankSchema, Env, Schema } from './types'
-
-/**
- * The Hono class extends the functionality of the HonoBase class.
- * It sets up routing and allows for custom options to be passed.
- *
- * @template E - The environment type.
- * @template S - The schema type.
- * @template BasePath - The base path type.
- */
-export class Hono<
-  E extends Env = BlankEnv,
-  S extends Schema = BlankSchema,
-  BasePath extends string = '/',
-> extends HonoBase<E, S, BasePath> {
-  /**
-   * Creates an instance of the Hono class.
-   *
-   * @param options - Optional configuration options for the Hono instance.
-   */
-  constructor(options: HonoOptions<E> = {}) {
-    super(options)
-    this.router =
-      options.router ??
-      new SmartRouter({
-        routers: [new RegExpRouter(), new TrieRouter()],
-      })
-  }
-}

package/tests/fixtures/corpus/oss-repos/hono/src/http-exception.ts

@@ -1,78 +0,0 @@
-/**
- * @module
- * This module provides the `HTTPException` class.
- */
-
-import type { StatusCode } from './utils/http-status'
-
-/**
- * Options for creating an `HTTPException`.
- * @property res - Optional response object to use.
- * @property message - Optional custom error message.
- * @property cause - Optional cause of the error.
- */
-type HTTPExceptionOptions = {
-  res?: Response
-  message?: string
-  cause?: unknown
-}
-
-/**
- * `HTTPException` must be used when a fatal error such as authentication failure occurs.
- *
- * @see {@link https://hono.dev/docs/api/exception}
- *
- * @param {StatusCode} status - status code of HTTPException
- * @param {HTTPExceptionOptions} options - options of HTTPException
- * @param {HTTPExceptionOptions["res"]} options.res - response of options of HTTPException
- * @param {HTTPExceptionOptions["message"]} options.message - message of options of HTTPException
- * @param {HTTPExceptionOptions["cause"]} options.cause - cause of options of HTTPException
- *
- * @example
- * ```ts
- * import { HTTPException } from 'hono/http-exception'
- *
- * // ...
- *
- * app.post('/auth', async (c, next) => {
- *   // authentication
- *   if (authorized === false) {
- *     throw new HTTPException(401, { message: 'Custom error message' })
- *   }
- *   await next()
- * })
- * ```
- */
-export class HTTPException extends Error {
-  readonly res?: Response
-  readonly status: StatusCode
-
-  /**
-   * Creates an instance of `HTTPException`.
-   * @param status - HTTP status code for the exception. Defaults to 500.
-   * @param options - Additional options for the exception.
-   */
-  constructor(status: StatusCode = 500, options?: HTTPExceptionOptions) {
-    super(options?.message, { cause: options?.cause })
-    this.res = options?.res
-    this.status = status
-  }
-
-  /**
-   * Returns the response object associated with the exception.
-   * If a response object is not provided, a new response is created with the error message and status code.
-   * @returns The response object.
-   */
-  getResponse(): Response {
-    if (this.res) {
-      const newResponse = new Response(this.res.body, {
-        status: this.status,
-        headers: this.res.headers,
-      })
-      return newResponse
-    }
-    return new Response(this.message, {
-      status: this.status,
-    })
-  }
-}

package/tests/fixtures/corpus/oss-repos/hono/src/index.ts

@@ -1,51 +0,0 @@
-/**
- * @module
- *
- * Hono - Web Framework built on Web Standards
- *
- * @example
- * ```ts
- * import { Hono } from 'hono'
- * const app = new Hono()
- *
- * app.get('/', (c) => c.text('Hono!'))
- *
- * export default app
- * ```
- */
-
-import { Hono } from './hono'
-
-/**
- * Types for environment variables, error handlers, handlers, middleware handlers, and more.
- */
-export type {
-  Env,
-  ErrorHandler,
-  Handler,
-  MiddlewareHandler,
-  Next,
-  NotFoundHandler,
-  ValidationTargets,
-  Input,
-  Schema,
-  ToSchema,
-  TypedResponse,
-} from './types'
-/**
- * Types for context, context variable map, context renderer, and execution context.
- */
-export type { Context, ContextVariableMap, ContextRenderer, ExecutionContext } from './context'
-/**
- * Type for HonoRequest.
- */
-export type { HonoRequest } from './request'
-/**
- * Types for inferring request and response types and client request options.
- */
-export type { InferRequestType, InferResponseType, ClientRequestOptions } from './client'
-
-/**
- * Hono framework for building web applications.
- */
-export { Hono }