bluera-knowledge 0.9.21

package/tests/fixtures/corpus/oss-repos/hono/docs/MIGRATION.md

@@ -0,0 +1,295 @@
+# Migration Guide
+
+## v4.3.11 to v4.4.0
+
+### `deno.land/x` to JSR
+
+There is no braking change, but we no longer publish the module from `deno.land/x`. If you want to use Hono on Deno, use JSR instead of it.
+
+If you migrate, replace the path `deno.land/x` with JSR's.
+
+```ts
+// From
+import { Hono } from 'https://deno.land/x/hono/mod.ts'
+
+// To
+import { Hono } from 'jsr:@hono/hono'
+```
+
+You can see more details on our website: https://hono.dev/getting-started/deno
+
+## v3.12.x to v4.0.0
+
+There are some breaking changes.
+
+### Removal of deprecated features
+
+- AWS Lambda Adapter - `LambdaFunctionUrlRequestContext` is obsolete. Use `ApiGatewayRequestContextV2` instead.
+- Next.js Adapter - `hono/nextjs` is obsolete. Use `hono/vercel` instead.
+- Context - `c.jsonT()` is obsolete. Use `c.json()` instead.
+- Context - `c.stream()` and `c.streamText()` are obsolete. Use `stream()` and `streamText()` in `hono/streaming` instead.
+- Context - `c.env()` is obsolete. Use `getRuntimeKey()` in `hono/adapter` instead.
+- Hono - `app.showRoutes()` is obsolete. Use `showRoutes()` in `hono/dev` instead.
+- Hono - `app.routerName` is obsolete. Use `getRouterName()` in `hono/dev` instead.
+- Hono - `app.head()` is no longer used. `app.get()` implicitly handles the HEAD method.
+- Hono - `app.handleEvent()` is obsolete. Use `app.fetch()` instead.
+- HonoRequest - `req.cookie()` is obsolete. Use `getCookie()` in `hono/cookie` instead.
+- HonoRequest - `headers()`, `body()`, `bodyUsed()`, `integrity()`, `keepalive()`, `referrer()`, and `signal()` are obsolete. Use the methods in `req.raw` such as `req.raw.headers()`.
+
+### `serveStatic` in Cloudflare Workers Adapter requires `manifest`
+
+If you use the Cloudflare Workers adapter's `serve-static`, you should specify the `manifest` option.
+
+```ts
+import manifest from '__STATIC_CONTENT_MANIFEST'
+
+// ...
+
+app.use('/static/*', serveStatic({ root: './assets', manifest }))
+```
+
+### Others
+
+- The default value of `docType` option in JSX Renderer Middleware is now `true`.
+- `FC` in `hono/jsx` does not pass `children`. Use `PropsWithChildren`.
+- Some Mime Types are removed https://github.com/honojs/hono/pull/2119.
+- Types for chaining routes with middleware matter: https://github.com/honojs/hono/pull/2046.
+- Types for the validator matter: https://github.com/honojs/hono/pull/2130.
+
+## v2.7.8 to v3.0.0
+
+There are some breaking changes.
+In addition to the following, type mismatches may occur.
+
+### `c.req` is now `HonoRequest`
+
+`c.req` becomes `HonoRequest`, not `Request`.
+Although APIs are almost same, but if you want to access `Request`, use `c.req.raw`.
+
+```ts
+app.post('/', async (c) => {
+  const metadata = c.req.raw.cf?.hostMetadata?
+  ...
+})
+```
+
+### StaticRouter is obsolete
+
+You can't use `StaticRouter`.
+
+### Validator is changed
+
+Previous Validator Middleware is obsolete.
+You can still use `hono/validator`, but the API has been changed.
+See [the document](https://hono.dev).
+
+### `serveStatic` is provided from Adapter
+
+Serve Static Middleware is obsolete. Use Adapters instead.
+
+```ts
+// For Cloudflare Workers
+import { serveStatic } from 'hono/cloudflare-workers'
+
+// For Bun
+// import { serveStatic } from 'hono/bun'
+
+// For Deno
+// import { serveStatic } from 'npm:hono/deno'
+
+// ...
+
+app.get('/static/*', serveStatic({ root: './' }))
+```
+
+### `serveStatic` for Cloudflare Workers "Service Worker mode" is obsolete
+
+For Cloudflare Workers, the `serveStatic` is obsolete in Service Worker mode.
+
+Note: Service Worker mode is that using `app.fire()`.
+We recommend use "Module Worker" mode with `export default app`.
+
+### Use `type` to define the Generics for `new Hono`
+
+You must use `type` to define the Generics for `new Hono`. Do not use `interface`.
+
+```ts
+// Should use `type`
+type Bindings = {
+  TOKEN: string
+}
+
+const app = new Hono<{ Bindings: Bindings }>()
+```
+
+## v2.7.1 - v2.x.x
+
+### Current Validator Middleware is deprecated
+
+At the next major version, Validator Middleware will be changed with "breaking changes". Therefore, the current Validator Middleware will be deprecated; please use 3rd-party Validator libraries such as [Zod](https://zod.dev) or [TypeBox](https://github.com/sinclairzx81/typebox).
+
+```ts
+import { z } from 'zod'
+
+//...
+
+const schema = z.object({
+  title: z.string().max(100),
+})
+
+app.post('/posts', async (c) => {
+  const body = await c.req.parseBody()
+  const res = schema.safeParse(body)
+  if (!res.success) {
+    return c.text('Invalid!', 400)
+  }
+  return c.text('Valid!')
+})
+```
+
+## v2.2.5 to v2.3.0
+
+There is a breaking change associated to the security update.
+
+### Basic Auth Middleware and Bearer Auth Middleware
+
+If you are using Basic Auth and Bearer Auth in your Handler (nested), change as follows:
+
+```ts
+app.use('/auth/*', async (c, next) => {
+  const auth = basicAuth({ username: c.env.USERNAME, password: c.env.PASSWORD })
+  return auth(c, next) // Older: `await auth(c, next)`
+})
+```
+
+## v2.0.9 to v2.1.0
+
+There are two BREAKING CHANGES.
+
+### `c.req.parseBody` does not parse JSON, text, and ArrayBuffer
+
+**DO NOT** use `c.req.parseBody` for parsing **JSON**, **text**, or **ArrayBuffer**.
+
+`c.req.parseBody` now only parses FormData with content type `multipart/form` or `application/x-www-form-urlencoded`. If you want to parse JSON, text, or ArrayBuffer, use `c.req.json()`, `c.req.text()`, or `c.req.arrayBuffer()`.
+
+```ts
+// `multipart/form` or `application/x-www-form-urlencoded`
+const data = await c.req.parseBody()
+
+const jsonData = await c.req.json() // for JSON body
+const text = await c.req.text() // for text body
+const arrayBuffer = await c.req.arrayBuffer() // for ArrayBuffer
+```
+
+### The arguments of Generics for `new Hono` have been changed
+
+Now, the constructor of "Hono" receives `Variables` and `Bindings`.
+"Bindings" is for types of environment variables for Cloudflare Workers. "Variables" is for types of `c.set`/`c.get`
+
+```ts
+type Bindings = {
+  KV: KVNamespace
+  Storage: R2Bucket
+}
+
+type WebClient = {
+  user: string
+  pass: string
+}
+
+type Variables = {
+  client: WebClient
+}
+
+const app = new Hono<{ Variables: Variables; Bindings: Bindings }>()
+
+app.get('/foo', (c) => {
+  const client = c.get('client') // client is WebClient
+  const kv = c.env.KV // kv is KVNamespace
+  //...
+})
+```
+
+## v1.6.4 to v2.0.0
+
+There are many BREAKING CHANGES. Please follow instructions below.
+
+### The way to import Middleware on Deno has been changed
+
+**DO NOT** import middleware from `hono/mod.ts`.
+
+```ts
+import { Hono, poweredBy } from 'https://deno.land/x/hono/mod.ts' // <--- NG
+```
+
+`hono/mod.ts` does not export middleware.
+To import middleware, use `hono/middleware.ts`:
+
+```ts
+import { Hono } from 'https://deno.land/x/hono/mod.ts'
+import { poweredBy, basicAuth } from 'https://deno.land/x/hono/middleware.ts'
+```
+
+### Cookie middleware is obsolete
+
+**DO NOT** use `cookie` middleware.
+
+```ts
+import { cookie } from 'hono/cookie' // <--- Obsolete!
+```
+
+You do not have to use Cookie middleware to parse or set cookies.
+They become default functions:
+
+```ts
+// Parse cookie
+app.get('/entry/:id', (c) => {
+  const value = c.req.cookie('name')
+  ...
+})
+```
+
+```ts
+app.get('/', (c) => {
+  c.cookie('delicious_cookie', 'choco')
+  return c.text('Do you like cookie?')
+})
+```
+
+### Body parse middleware is obsolete
+
+**DO NOT** use `body-parse` middleware.
+
+```ts
+import { bodyParse } from 'hono/body-parse' // <--- Obsolete!
+```
+
+You do not have to use Body parse middleware to parse request body. Use `c.req.parseBody()` method instead.
+
+```ts
+// Parse Request body
+ app.post('', (c) => {
+   const body = c.req.parseBody()
+   ...
+ })
+```
+
+### GraphQL Server middleware is obsolete
+
+**DO NOT** use `graphql-server` middleware.
+
+```ts
+import { graphqlServer } from 'hono/graphql-server' // <--- Obsolete!
+```
+
+It might be distributed as third-party middleware.
+
+### Mustache middleware is obsolete
+
+**DO NOT** use `mustache` middleware.
+
+```ts
+import { mustache } from 'hono/mustache' // <--- Obsolete!
+```
+
+It will no longer be implemented.

package/tests/fixtures/corpus/oss-repos/hono/docs/images/hono-logo.svg

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="500px" height="500px" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g><path style="opacity:0.993" fill="#ff5b11" d="M 257.5,0.5 C 258.822,0.330034 259.989,0.663368 261,1.5C 298.193,46.8936 333.193,93.8936 366,142.5C 390.289,179.069 410.955,217.735 428,258.5C 455.221,331.104 441.054,394.271 385.5,448C 336.892,489.082 280.892,505.082 217.5,496C 141.727,480.551 90.2265,436.718 63,364.5C 55.9081,340.989 53.5748,316.989 56,292.5C 60.0384,250.347 70.0384,209.68 86,170.5C 92.6509,154.514 101.318,139.848 112,126.5C 120.715,136.88 129.048,147.547 137,158.5C 140.682,162.349 144.515,166.016 148.5,169.5C 178.917,109.136 215.251,52.8028 257.5,0.5 Z"/></g>
+<g><path style="opacity:1" fill="#ff9758" d="M 250.5,81.5 C 287.193,124.06 320.36,169.393 350,217.5C 359.293,233.418 366.959,250.085 373,267.5C 385.584,317.008 372.084,357.842 332.5,390C 294.216,416.939 252.216,424.939 206.5,414C 157.201,398.702 128.701,365.535 121,314.5C 119.131,298.409 120.798,282.742 126,267.5C 133.418,248.663 142.418,230.663 153,213.5C 163,198.833 173,184.167 183,169.5C 205.716,140.29 228.216,110.957 250.5,81.5 Z"/></g>
+</svg>

package/tests/fixtures/corpus/oss-repos/hono/jsr.json

@@ -0,0 +1,119 @@
+{
+  "name": "@hono/hono",
+  "version": "0.0.0",
+  "compilerOptions": {
+    "lib": [
+      "dom",
+      "dom.iterable",
+      "deno.ns"
+    ]
+  },
+  "unstable": [
+    "sloppy-imports"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./types": "./src/types.ts",
+    "./hono-base": "./src/hono-base.ts",
+    "./tiny": "./src/preset/tiny.ts",
+    "./quick": "./src/preset/quick.ts",
+    "./http-exception": "./src/http-exception.ts",
+    "./basic-auth": "./src/middleware/basic-auth/index.ts",
+    "./bearer-auth": "./src/middleware/bearer-auth/index.ts",
+    "./body-limit": "./src/middleware/body-limit/index.ts",
+    "./ip-restriction": "./src/middleware/ip-restriction/index.ts",
+    "./cache": "./src/middleware/cache/index.ts",
+    "./cookie": "./src/helper/cookie/index.ts",
+    "./accepts": "./src/helper/accepts/index.ts",
+    "./compress": "./src/middleware/compress/index.ts",
+    "./context-storage": "./src/middleware/context-storage/index.ts",
+    "./cors": "./src/middleware/cors/index.ts",
+    "./csrf": "./src/middleware/csrf/index.ts",
+    "./etag": "./src/middleware/etag/index.ts",
+    "./trailing-slash": "./src/middleware/trailing-slash/index.ts",
+    "./html": "./src/helper/html/index.ts",
+    "./css": "./src/helper/css/index.ts",
+    "./jsx": "./src/jsx/index.ts",
+    "./jsx/jsx-dev-runtime": "./src/jsx/jsx-dev-runtime.ts",
+    "./jsx/jsx-runtime": "./src/jsx/jsx-runtime.ts",
+    "./jsx/streaming": "./src/jsx/streaming.ts",
+    "./jsx-renderer": "./src/middleware/jsx-renderer/index.ts",
+    "./jsx/dom": "./src/jsx/dom/index.ts",
+    "./jsx/dom/jsx-dev-runtime": "./src/jsx/dom/jsx-dev-runtime.ts",
+    "./jsx/dom/jsx-runtime": "./src/jsx/dom/jsx-runtime.ts",
+    "./jsx/dom/client": "./src/jsx/dom/client.ts",
+    "./jsx/dom/css": "./src/jsx/dom/css.ts",
+    "./jsx/dom/server": "./src/jsx/dom/server.ts",
+    "./jwt": "./src/middleware/jwt/jwt.ts",
+    "./timing": "./src/middleware/timing/timing.ts",
+    "./logger": "./src/middleware/logger/index.ts",
+    "./method-override": "./src/middleware/method-override/index.ts",
+    "./powered-by": "./src/middleware/powered-by/index.ts",
+    "./pretty-json": "./src/middleware/pretty-json/index.ts",
+    "./request-id": "./src/middleware/request-id/request-id.ts",
+    "./secure-headers": "./src/middleware/secure-headers/secure-headers.ts",
+    "./combine": "./src/middleware/combine/index.ts",
+    "./ssg": "./src/helper/ssg/index.ts",
+    "./streaming": "./src/helper/streaming/index.ts",
+    "./validator": "./src/validator/index.ts",
+    "./router": "./src/router.ts",
+    "./router/reg-exp-router": "./src/router/reg-exp-router/index.ts",
+    "./router/smart-router": "./src/router/smart-router/index.ts",
+    "./router/trie-router": "./src/router/trie-router/index.ts",
+    "./router/pattern-router": "./src/router/pattern-router/index.ts",
+    "./router/linear-router": "./src/router/linear-router/index.ts",
+    "./client": "./src/client/index.ts",
+    "./adapter": "./src/helper/adapter/index.ts",
+    "./factory": "./src/helper/factory/index.ts",
+    "./serve-static": "./src/middleware/serve-static/index.ts",
+    "./cloudflare-workers": "./src/adapter/cloudflare-workers/index.ts",
+    "./cloudflare-pages": "./src/adapter/cloudflare-pages/index.ts",
+    "./deno": "./src/adapter/deno/index.ts",
+    "./bun": "./src/adapter/bun/index.ts",
+    "./aws-lambda": "./src/adapter/aws-lambda/index.ts",
+    "./vercel": "./src/adapter/vercel/index.ts",
+    "./netlify": "./src/adapter/netlify/index.ts",
+    "./lambda-edge": "./src/adapter/lambda-edge/index.ts",
+    "./service-worker": "./src/adapter/service-worker/index.ts",
+    "./testing": "./src/helper/testing/index.ts",
+    "./dev": "./src/helper/dev/index.ts",
+    "./ws": "./src/helper/websocket/index.ts",
+    "./utils/body": "./src/utils/body.ts",
+    "./utils/buffer": "./src/utils/buffer.ts",
+    "./utils/color": "./src/utils/color.ts",
+    "./utils/concurrent": "./src/utils/concurrent.ts",
+    "./utils/cookie": "./src/utils/cookie.ts",
+    "./utils/crypto": "./src/utils/crypto.ts",
+    "./utils/encode": "./src/utils/encode.ts",
+    "./utils/filepath": "./src/utils/filepath.ts",
+    "./utils/handler": "./src/utils/handler.ts",
+    "./utils/html": "./src/utils/html.ts",
+    "./utils/http-status": "./src/utils/http-status.ts",
+    "./utils/jwt": "./src/utils/jwt/index.ts",
+    "./utils/jwt/jwa": "./src/utils/jwt/jwa.ts",
+    "./utils/jwt/jws": "./src/utils/jwt/jws.ts",
+    "./utils/jwt/jwt": "./src/utils/jwt/jwt.ts",
+    "./utils/jwt/types": "./src/utils/jwt/types.ts",
+    "./utils/jwt/utf8": "./src/utils/jwt/utf8.ts",
+    "./utils/mime": "./src/utils/mime.ts",
+    "./utils/stream": "./src/utils/stream.ts",
+    "./utils/types": "./src/utils/types.ts",
+    "./utils/url": "./src/utils/url.ts",
+    "./utils/ipaddr": "./src/utils/ipaddr.ts"
+  },
+  "publish": {
+    "include": [
+      "jsr.json",
+      "LICENSE",
+      "README.md",
+      "docs/CODE_OF_CONDUCT.md",
+      "docs/CONTRIBUTING.md",
+      "docs/MIGRATION.md",
+      "src/**/*.ts"
+    ],
+    "exclude": [
+      "src/**/*.test.ts",
+      "src/**/*.test.tsx"
+    ]
+  }
+}

package/tests/fixtures/corpus/oss-repos/hono/package.cjs.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}