@kerebron/extension-server-hono 0.4.27 → 0.4.29

package/src/deps/jsr.io/@hono/hono/4.11.3/src/utils/body.ts

@@ -0,0 +1,229 @@
+/**
+ * @module
+ * Body utility.
+ */
+
+import { HonoRequest } from '../request.js'
+
+type BodyDataValueDot = { [x: string]: string | File | BodyDataValueDot }
+type BodyDataValueDotAll = {
+  [x: string]: string | File | (string | File)[] | BodyDataValueDotAll
+}
+type SimplifyBodyData<T> = {
+  [K in keyof T]: string | File | (string | File)[] | BodyDataValueDotAll extends T[K]
+    ? string | File | (string | File)[] | BodyDataValueDotAll
+    : string | File | BodyDataValueDot extends T[K]
+      ? string | File | BodyDataValueDot
+      : string | File | (string | File)[] extends T[K]
+        ? string | File | (string | File)[]
+        : string | File
+} & {}
+
+type BodyDataValueComponent<T> =
+  | string
+  | File
+  | (T extends { all: false }
+      ? never // explicitly set to false
+      : T extends { all: true } | { all: boolean }
+        ? (string | File)[] // use all option
+        : never) // without options
+type BodyDataValueObject<T> = { [key: string]: BodyDataValueComponent<T> | BodyDataValueObject<T> }
+type BodyDataValue<T> =
+  | BodyDataValueComponent<T>
+  | (T extends { dot: false }
+      ? never // explicitly set to false
+      : T extends { dot: true } | { dot: boolean }
+        ? BodyDataValueObject<T> // use dot option
+        : never) // without options
+export type BodyData<T extends Partial<ParseBodyOptions> = {}> = SimplifyBodyData<
+  Record<string, BodyDataValue<T>>
+>
+
+export type ParseBodyOptions = {
+  /**
+   * Determines whether all fields with multiple values should be parsed as arrays.
+   * @default false
+   * @example
+   * const data = new FormData()
+   * data.append('file', 'aaa')
+   * data.append('file', 'bbb')
+   * data.append('message', 'hello')
+   *
+   * If all is false:
+   * parseBody should return { file: 'bbb', message: 'hello' }
+   *
+   * If all is true:
+   * parseBody should return { file: ['aaa', 'bbb'], message: 'hello' }
+   */
+  all: boolean
+  /**
+   * Determines whether all fields with dot notation should be parsed as nested objects.
+   * @default false
+   * @example
+   * const data = new FormData()
+   * data.append('obj.key1', 'value1')
+   * data.append('obj.key2', 'value2')
+   *
+   * If dot is false:
+   * parseBody should return { 'obj.key1': 'value1', 'obj.key2': 'value2' }
+   *
+   * If dot is true:
+   * parseBody should return { obj: { key1: 'value1', key2: 'value2' } }
+   */
+  dot: boolean
+}
+
+/**
+ * Parses the body of a request based on the provided options.
+ *
+ * @template T - The type of the parsed body data.
+ * @param {HonoRequest | Request} request - The request object to parse.
+ * @param {Partial<ParseBodyOptions>} [options] - Options for parsing the body.
+ * @returns {Promise<T>} The parsed body data.
+ */
+interface ParseBody {
+  <Options extends Partial<ParseBodyOptions>, T extends BodyData<Options>>(
+    request: HonoRequest | Request,
+    options?: Options
+  ): Promise<T>
+  <T extends BodyData>(
+    request: HonoRequest | Request,
+    options?: Partial<ParseBodyOptions>
+  ): Promise<T>
+}
+export const parseBody: ParseBody = async (
+  request: HonoRequest | Request,
+  options = Object.create(null)
+) => {
+  const { all = false, dot = false } = options
+
+  const headers = request instanceof HonoRequest ? request.raw.headers : request.headers
+  const contentType = headers.get('Content-Type')
+
+  if (
+    contentType?.startsWith('multipart/form-data') ||
+    contentType?.startsWith('application/x-www-form-urlencoded')
+  ) {
+    return parseFormData(request, { all, dot })
+  }
+
+  return {}
+}
+
+/**
+ * Parses form data from a request.
+ *
+ * @template T - The type of the parsed body data.
+ * @param {HonoRequest | Request} request - The request object containing form data.
+ * @param {ParseBodyOptions} options - Options for parsing the form data.
+ * @returns {Promise<T>} The parsed body data.
+ */
+async function parseFormData<T extends BodyData>(
+  request: HonoRequest | Request,
+  options: ParseBodyOptions
+): Promise<T> {
+  const formData = await (request as Request).formData()
+
+  if (formData) {
+    return convertFormDataToBodyData<T>(formData, options)
+  }
+
+  return {} as T
+}
+
+/**
+ * Converts form data to body data based on the provided options.
+ *
+ * @template T - The type of the parsed body data.
+ * @param {FormData} formData - The form data to convert.
+ * @param {ParseBodyOptions} options - Options for parsing the form data.
+ * @returns {T} The converted body data.
+ */
+function convertFormDataToBodyData<T extends BodyData = BodyData>(
+  formData: FormData,
+  options: ParseBodyOptions
+): T {
+  const form: BodyData = Object.create(null)
+
+  formData.forEach((value, key) => {
+    const shouldParseAllValues = options.all || key.endsWith('[]')
+
+    if (!shouldParseAllValues) {
+      form[key] = value
+    } else {
+      handleParsingAllValues(form, key, value)
+    }
+  })
+
+  if (options.dot) {
+    Object.entries(form).forEach(([key, value]) => {
+      const shouldParseDotValues = key.includes('.')
+
+      if (shouldParseDotValues) {
+        handleParsingNestedValues(form, key, value)
+        delete form[key]
+      }
+    })
+  }
+
+  return form as T
+}
+
+/**
+ * Handles parsing all values for a given key, supporting multiple values as arrays.
+ *
+ * @param {BodyData} form - The form data object.
+ * @param {string} key - The key to parse.
+ * @param {FormDataEntryValue} value - The value to assign.
+ */
+const handleParsingAllValues = (
+  form: BodyData<{ all: true }>,
+  key: string,
+  value: FormDataEntryValue
+): void => {
+  if (form[key] !== undefined) {
+    if (Array.isArray(form[key])) {
+      ;(form[key] as (string | File)[]).push(value)
+    } else {
+      form[key] = [form[key] as string | File, value]
+    }
+  } else {
+    if (!key.endsWith('[]')) {
+      form[key] = value
+    } else {
+      form[key] = [value]
+    }
+  }
+}
+
+/**
+ * Handles parsing nested values using dot notation keys.
+ *
+ * @param {BodyData} form - The form data object.
+ * @param {string} key - The dot notation key.
+ * @param {BodyDataValue} value - The value to assign.
+ */
+const handleParsingNestedValues = (
+  form: BodyData,
+  key: string,
+  value: BodyDataValue<Partial<ParseBodyOptions>>
+): void => {
+  let nestedForm = form
+  const keys = key.split('.')
+
+  keys.forEach((key, index) => {
+    if (index === keys.length - 1) {
+      nestedForm[key] = value
+    } else {
+      if (
+        !nestedForm[key] ||
+        typeof nestedForm[key] !== 'object' ||
+        Array.isArray(nestedForm[key]) ||
+        nestedForm[key] instanceof File
+      ) {
+        nestedForm[key] = Object.create(null)
+      }
+      nestedForm = nestedForm[key] as unknown as BodyData
+    }
+  })
+}

package/src/deps/jsr.io/@hono/hono/4.11.3/src/utils/constants.ts

@@ -0,0 +1,4 @@
+/**
+ * Constant used to mark a composed handler.
+ */
+export const COMPOSED_HANDLER = '__COMPOSED_HANDLER'

package/src/deps/jsr.io/@hono/hono/4.11.3/src/utils/headers.ts

@@ -0,0 +1,333 @@
+/**
+ * @module
+ * HTTP Headers utility.
+ */
+
+// note: https://www.iana.org/assignments/http-fields/http-fields.xhtml
+
+export type RequestHeader =
+  | 'A-IM'
+  | 'Accept'
+  | 'Accept-Additions'
+  | 'Accept-CH'
+  | 'Accept-Charset'
+  | 'Accept-Datetime'
+  | 'Accept-Encoding'
+  | 'Accept-Features'
+  | 'Accept-Language'
+  | 'Accept-Patch'
+  | 'Accept-Post'
+  | 'Accept-Ranges'
+  | 'Accept-Signature'
+  | 'Access-Control'
+  | 'Access-Control-Allow-Credentials'
+  | 'Access-Control-Allow-Headers'
+  | 'Access-Control-Allow-Methods'
+  | 'Access-Control-Allow-Origin'
+  | 'Access-Control-Expose-Headers'
+  | 'Access-Control-Max-Age'
+  | 'Access-Control-Request-Headers'
+  | 'Access-Control-Request-Method'
+  | 'Age'
+  | 'Allow'
+  | 'ALPN'
+  | 'Alt-Svc'
+  | 'Alt-Used'
+  | 'Alternates'
+  | 'AMP-Cache-Transform'
+  | 'Apply-To-Redirect-Ref'
+  | 'Authentication-Control'
+  | 'Authentication-Info'
+  | 'Authorization'
+  | 'Available-Dictionary'
+  | 'C-Ext'
+  | 'C-Man'
+  | 'C-Opt'
+  | 'C-PEP'
+  | 'C-PEP-Info'
+  | 'Cache-Control'
+  | 'Cache-Status'
+  | 'Cal-Managed-ID'
+  | 'CalDAV-Timezones'
+  | 'Capsule-Protocol'
+  | 'CDN-Cache-Control'
+  | 'CDN-Loop'
+  | 'Cert-Not-After'
+  | 'Cert-Not-Before'
+  | 'Clear-Site-Data'
+  | 'Client-Cert'
+  | 'Client-Cert-Chain'
+  | 'Close'
+  | 'CMCD-Object'
+  | 'CMCD-Request'
+  | 'CMCD-Session'
+  | 'CMCD-Status'
+  | 'CMSD-Dynamic'
+  | 'CMSD-Static'
+  | 'Concealed-Auth-Export'
+  | 'Configuration-Context'
+  | 'Connection'
+  | 'Content-Base'
+  | 'Content-Digest'
+  | 'Content-Disposition'
+  | 'Content-Encoding'
+  | 'Content-ID'
+  | 'Content-Language'
+  | 'Content-Length'
+  | 'Content-Location'
+  | 'Content-MD5'
+  | 'Content-Range'
+  | 'Content-Script-Type'
+  | 'Content-Security-Policy'
+  | 'Content-Security-Policy-Report-Only'
+  | 'Content-Style-Type'
+  | 'Content-Type'
+  | 'Content-Version'
+  | 'Cookie'
+  | 'Cookie2'
+  | 'Cross-Origin-Embedder-Policy'
+  | 'Cross-Origin-Embedder-Policy-Report-Only'
+  | 'Cross-Origin-Opener-Policy'
+  | 'Cross-Origin-Opener-Policy-Report-Only'
+  | 'Cross-Origin-Resource-Policy'
+  | 'CTA-Common-Access-Token'
+  | 'DASL'
+  | 'Date'
+  | 'DAV'
+  | 'Default-Style'
+  | 'Delta-Base'
+  | 'Deprecation'
+  | 'Depth'
+  | 'Derived-From'
+  | 'Destination'
+  | 'Differential-ID'
+  | 'Dictionary-ID'
+  | 'Digest'
+  | 'DPoP'
+  | 'DPoP-Nonce'
+  | 'Early-Data'
+  | 'EDIINT-Features'
+  | 'ETag'
+  | 'Expect'
+  | 'Expect-CT'
+  | 'Expires'
+  | 'Ext'
+  | 'Forwarded'
+  | 'From'
+  | 'GetProfile'
+  | 'Hobareg'
+  | 'Host'
+  | 'HTTP2-Settings'
+  | 'If'
+  | 'If-Match'
+  | 'If-Modified-Since'
+  | 'If-None-Match'
+  | 'If-Range'
+  | 'If-Schedule-Tag-Match'
+  | 'If-Unmodified-Since'
+  | 'IM'
+  | 'Include-Referred-Token-Binding-ID'
+  | 'Isolation'
+  | 'Keep-Alive'
+  | 'Label'
+  | 'Last-Event-ID'
+  | 'Last-Modified'
+  | 'Link'
+  | 'Link-Template'
+  | 'Location'
+  | 'Lock-Token'
+  | 'Man'
+  | 'Max-Forwards'
+  | 'Memento-Datetime'
+  | 'Meter'
+  | 'Method-Check'
+  | 'Method-Check-Expires'
+  | 'MIME-Version'
+  | 'Negotiate'
+  | 'NEL'
+  | 'OData-EntityId'
+  | 'OData-Isolation'
+  | 'OData-MaxVersion'
+  | 'OData-Version'
+  | 'Opt'
+  | 'Optional-WWW-Authenticate'
+  | 'Ordering-Type'
+  | 'Origin'
+  | 'Origin-Agent-Cluster'
+  | 'OSCORE'
+  | 'OSLC-Core-Version'
+  | 'Overwrite'
+  | 'P3P'
+  | 'PEP'
+  | 'PEP-Info'
+  | 'Permissions-Policy'
+  | 'PICS-Label'
+  | 'Ping-From'
+  | 'Ping-To'
+  | 'Position'
+  | 'Pragma'
+  | 'Prefer'
+  | 'Preference-Applied'
+  | 'Priority'
+  | 'ProfileObject'
+  | 'Protocol'
+  | 'Protocol-Info'
+  | 'Protocol-Query'
+  | 'Protocol-Request'
+  | 'Proxy-Authenticate'
+  | 'Proxy-Authentication-Info'
+  | 'Proxy-Authorization'
+  | 'Proxy-Features'
+  | 'Proxy-Instruction'
+  | 'Proxy-Status'
+  | 'Public'
+  | 'Public-Key-Pins'
+  | 'Public-Key-Pins-Report-Only'
+  | 'Range'
+  | 'Redirect-Ref'
+  | 'Referer'
+  | 'Referer-Root'
+  | 'Referrer-Policy'
+  | 'Refresh'
+  | 'Repeatability-Client-ID'
+  | 'Repeatability-First-Sent'
+  | 'Repeatability-Request-ID'
+  | 'Repeatability-Result'
+  | 'Replay-Nonce'
+  | 'Reporting-Endpoints'
+  | 'Repr-Digest'
+  | 'Retry-After'
+  | 'Safe'
+  | 'Schedule-Reply'
+  | 'Schedule-Tag'
+  | 'Sec-GPC'
+  | 'Sec-Purpose'
+  | 'Sec-Token-Binding'
+  | 'Sec-WebSocket-Accept'
+  | 'Sec-WebSocket-Extensions'
+  | 'Sec-WebSocket-Key'
+  | 'Sec-WebSocket-Protocol'
+  | 'Sec-WebSocket-Version'
+  | 'Security-Scheme'
+  | 'Server'
+  | 'Server-Timing'
+  | 'Set-Cookie'
+  | 'Set-Cookie2'
+  | 'SetProfile'
+  | 'Signature'
+  | 'Signature-Input'
+  | 'SLUG'
+  | 'SoapAction'
+  | 'Status-URI'
+  | 'Strict-Transport-Security'
+  | 'Sunset'
+  | 'Surrogate-Capability'
+  | 'Surrogate-Control'
+  | 'TCN'
+  | 'TE'
+  | 'Timeout'
+  | 'Timing-Allow-Origin'
+  | 'Topic'
+  | 'Traceparent'
+  | 'Tracestate'
+  | 'Trailer'
+  | 'Transfer-Encoding'
+  | 'TTL'
+  | 'Upgrade'
+  | 'Urgency'
+  | 'URI'
+  | 'Use-As-Dictionary'
+  | 'User-Agent'
+  | 'Variant-Vary'
+  | 'Vary'
+  | 'Via'
+  | 'Want-Content-Digest'
+  | 'Want-Digest'
+  | 'Want-Repr-Digest'
+  | 'Warning'
+  | 'WWW-Authenticate'
+  | 'X-Content-Type-Options'
+  | 'X-Frame-Options'
+
+export type ResponseHeader =
+  | 'Access-Control-Allow-Credentials'
+  | 'Access-Control-Allow-Headers'
+  | 'Access-Control-Allow-Methods'
+  | 'Access-Control-Allow-Origin'
+  | 'Access-Control-Expose-Headers'
+  | 'Access-Control-Max-Age'
+  | 'Age'
+  | 'Allow'
+  | 'Cache-Control'
+  | 'Clear-Site-Data'
+  | 'Content-Disposition'
+  | 'Content-Encoding'
+  | 'Content-Language'
+  | 'Content-Length'
+  | 'Content-Location'
+  | 'Content-Range'
+  | 'Content-Security-Policy'
+  | 'Content-Security-Policy-Report-Only'
+  | 'Content-Type'
+  | 'Cookie'
+  | 'Cross-Origin-Embedder-Policy'
+  | 'Cross-Origin-Opener-Policy'
+  | 'Cross-Origin-Resource-Policy'
+  | 'Date'
+  | 'ETag'
+  | 'Expires'
+  | 'Last-Modified'
+  | 'Location'
+  | 'Permissions-Policy'
+  | 'Pragma'
+  | 'Retry-After'
+  | 'Save-Data'
+  | 'Sec-CH-Prefers-Color-Scheme'
+  | 'Sec-CH-Prefers-Reduced-Motion'
+  | 'Sec-CH-UA'
+  | 'Sec-CH-UA-Arch'
+  | 'Sec-CH-UA-Bitness'
+  | 'Sec-CH-UA-Form-Factor'
+  | 'Sec-CH-UA-Full-Version'
+  | 'Sec-CH-UA-Full-Version-List'
+  | 'Sec-CH-UA-Mobile'
+  | 'Sec-CH-UA-Model'
+  | 'Sec-CH-UA-Platform'
+  | 'Sec-CH-UA-Platform-Version'
+  | 'Sec-CH-UA-WoW64'
+  | 'Sec-Fetch-Dest'
+  | 'Sec-Fetch-Mode'
+  | 'Sec-Fetch-Site'
+  | 'Sec-Fetch-User'
+  | 'Sec-GPC'
+  | 'Server'
+  | 'Server-Timing'
+  | 'Service-Worker-Navigation-Preload'
+  | 'Set-Cookie'
+  | 'Strict-Transport-Security'
+  | 'Timing-Allow-Origin'
+  | 'Trailer'
+  | 'Transfer-Encoding'
+  | 'Upgrade'
+  | 'Vary'
+  | 'WWW-Authenticate'
+  | 'Warning'
+  | 'X-Content-Type-Options'
+  | 'X-DNS-Prefetch-Control'
+  | 'X-Frame-Options'
+  | 'X-Permitted-Cross-Domain-Policies'
+  | 'X-Powered-By'
+  | 'X-Robots-Tag'
+  | 'X-XSS-Protection'
+
+export type AcceptHeader =
+  | 'Accept'
+  | 'Accept-Charset'
+  | 'Accept-Encoding'
+  | 'Accept-Language'
+  | 'Accept-Patch'
+  | 'Accept-Post'
+  | 'Accept-Ranges'
+
+// note: `X-${string}` is deprecated
+export type CustomHeader = string & {}