hono 4.6.20 → 4.7.1

package/dist/types/middleware/language/language.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @module
+ * Language module for Hono.
+ */
+import type { Context } from '../../context';
+import type { MiddlewareHandler } from '../../types';
+export type DetectorType = "path" | "querystring" | "cookie" | "header";
+export type CacheType = "cookie";
+export interface DetectorOptions {
+    /** Order of language detection strategies */
+    order: DetectorType[];
+    /** Query parameter name for language */
+    lookupQueryString: string;
+    /** Cookie name for language */
+    lookupCookie: string;
+    /** Index in URL path where language code appears */
+    lookupFromPathIndex: number;
+    /** Header key for language detection */
+    lookupFromHeaderKey: string;
+    /** Caching strategies */
+    caches: CacheType[] | false;
+    /** Cookie configuration options */
+    cookieOptions?: {
+        domain?: string;
+        path?: string;
+        sameSite?: "Strict" | "Lax" | "None";
+        secure?: boolean;
+        maxAge?: number;
+        httpOnly?: boolean;
+    };
+    /** Whether to ignore case in language codes */
+    ignoreCase: boolean;
+    /** Default language if none detected */
+    fallbackLanguage: string;
+    /** List of supported language codes */
+    supportedLanguages: string[];
+    /** Optional function to transform detected language codes */
+    convertDetectedLanguage?: (lang: string) => string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface LanguageVariables {
+    language: string;
+}
+export declare const DEFAULT_OPTIONS: DetectorOptions;
+/**
+ * Parse Accept-Language header values with quality scores
+ * @param header Accept-Language header string
+ * @returns Array of parsed languages with quality scores
+ */
+export declare function parseAcceptLanguage(header: string): Array<{
+    lang: string;
+    q: number;
+}>;
+/**
+ * Validate and normalize language codes
+ * @param lang Language code to normalize
+ * @param options Detector options
+ * @returns Normalized language code or undefined
+ */
+export declare const normalizeLanguage: (lang: string | null | undefined, options: DetectorOptions) => string | undefined;
+/**
+ * Detects language from query parameter
+ */
+export declare const detectFromQuery: (c: Context, options: DetectorOptions) => string | undefined;
+/**
+ * Detects language from cookie
+ */
+export declare const detectFromCookie: (c: Context, options: DetectorOptions) => string | undefined;
+/**
+ * Detects language from Accept-Language header
+ */
+export declare function detectFromHeader(c: Context, options: DetectorOptions): string | undefined;
+/**
+ * Detects language from URL path
+ */
+export declare function detectFromPath(c: Context, options: DetectorOptions): string | undefined;
+/**
+ * Collection of all language detection strategies
+ */
+export declare const detectors: {
+    readonly querystring: (c: Context, options: DetectorOptions) => string | undefined;
+    readonly cookie: (c: Context, options: DetectorOptions) => string | undefined;
+    readonly header: typeof detectFromHeader;
+    readonly path: typeof detectFromPath;
+};
+/** Type for detector functions */
+export type DetectorFunction = (c: Context, options: DetectorOptions) => string | undefined;
+/** Type-safe detector map */
+export type Detectors = Record<keyof typeof detectors, DetectorFunction>;
+/**
+ * Validate detector options
+ * @param options Detector options to validate
+ * @throws Error if options are invalid
+ */
+export declare function validateOptions(options: DetectorOptions): void;
+/**
+ * Language detector middleware factory
+ * @param userOptions Configuration options for the language detector
+ * @returns Hono middleware function
+ */
+export declare const languageDetector: (userOptions: Partial<DetectorOptions>) => MiddlewareHandler;

package/dist/types/middleware/secure-headers/permissions-policy.d.ts

@@ -2,13 +2,13 @@ export type PermissionsPolicyDirective = StandardizedFeatures | ProposedFeatures
 /**
  * These features have been declared in a published version of the respective specification.
  */
-type StandardizedFeatures = 'accelerometer' | 'ambientLightSensor' | 'attributionReporting' | 'autoplay' | 'battery' | 'bluetooth' | 'camera' | 'chUa' | 'chUaArch' | 'chUaBitness' | 'chUaFullVersion' | 'chUaFullVersionList' | 'chUaMobile' | 'chUaModel' | 'chUaPlatform' | 'chUaPlatformVersion' | 'chUaWow64' | 'computePressure' | 'crossOriginIsolated' | 'directSockets' | 'displayCapture' | 'encryptedMedia' | 'executionWhileNotRendered' | 'executionWhileOutOfViewport' | 'fullscreen' | 'geolocation' | 'gyroscope' | 'hid' | 'identityCredentialsGet' | 'idleDetection' | 'keyboardMap' | 'magnetometer' | 'microphone' | 'midi' | 'navigationOverride' | 'payment' | 'pictureInPicture' | 'publickeyCredentialsGet' | 'screenWakeLock' | 'serial' | 'storageAccess' | 'syncXhr' | 'usb' | 'webShare' | 'windowManagement' | 'xrSpatialTracking';
+type StandardizedFeatures = "accelerometer" | "ambientLightSensor" | "attributionReporting" | "autoplay" | "battery" | "bluetooth" | "camera" | "chUa" | "chUaArch" | "chUaBitness" | "chUaFullVersion" | "chUaFullVersionList" | "chUaMobile" | "chUaModel" | "chUaPlatform" | "chUaPlatformVersion" | "chUaWow64" | "computePressure" | "crossOriginIsolated" | "directSockets" | "displayCapture" | "encryptedMedia" | "executionWhileNotRendered" | "executionWhileOutOfViewport" | "fullscreen" | "geolocation" | "gyroscope" | "hid" | "identityCredentialsGet" | "idleDetection" | "keyboardMap" | "magnetometer" | "microphone" | "midi" | "navigationOverride" | "payment" | "pictureInPicture" | "publickeyCredentialsGet" | "screenWakeLock" | "serial" | "storageAccess" | "syncXhr" | "usb" | "webShare" | "windowManagement" | "xrSpatialTracking";
 /**
  * These features have been proposed, but the definitions have not yet been integrated into their respective specs.
  */
-type ProposedFeatures = 'clipboardRead' | 'clipboardWrite' | 'gemepad' | 'sharedAutofill' | 'speakerSelection';
+type ProposedFeatures = "clipboardRead" | "clipboardWrite" | "gemepad" | "sharedAutofill" | "speakerSelection";
 /**
  * These features generally have an explainer only, but may be available for experimentation by web developers.
  */
-type ExperimentalFeatures = 'allScreensCapture' | 'browsingTopics' | 'capturedSurfaceControl' | 'conversionMeasurement' | 'digitalCredentialsGet' | 'focusWithoutUserActivation' | 'joinAdInterestGroup' | 'localFonts' | 'runAdAuction' | 'smartCard' | 'syncScript' | 'trustTokenRedemption' | 'unload' | 'verticalScroll';
+type ExperimentalFeatures = "allScreensCapture" | "browsingTopics" | "capturedSurfaceControl" | "conversionMeasurement" | "digitalCredentialsGet" | "focusWithoutUserActivation" | "joinAdInterestGroup" | "localFonts" | "runAdAuction" | "smartCard" | "syncScript" | "trustTokenRedemption" | "unload" | "verticalScroll";
 export {};

package/dist/types/middleware/secure-headers/secure-headers.d.ts

@@ -46,7 +46,7 @@ interface ReportingEndpointOptions {
     name: string;
     url: string;
 }
-type PermissionsPolicyValue = '*' | 'self' | 'src' | 'none' | string;
+type PermissionsPolicyValue = "*" | "self" | "src" | "none" | string;
 type PermissionsPolicyOptions = Partial<Record<PermissionsPolicyDirective, PermissionsPolicyValue[] | boolean>>;
 type overridableHeader = boolean | string;
 interface SecureHeadersOptions {

package/dist/types/preset/quick.d.ts

@@ -5,6 +5,6 @@
 import { HonoBase } from '../hono-base';
 import type { HonoOptions } from '../hono-base';
 import type { BlankEnv, BlankSchema, Env, Schema } from '../types';
-export declare class Hono<E extends Env = BlankEnv, S extends Schema = BlankSchema, BasePath extends string = '/'> extends HonoBase<E, S, BasePath> {
+export declare class Hono<E extends Env = BlankEnv, S extends Schema = BlankSchema, BasePath extends string = "/"> extends HonoBase<E, S, BasePath> {
     constructor(options?: HonoOptions<E>);
 }

package/dist/types/preset/tiny.d.ts

@@ -5,6 +5,6 @@
 import { HonoBase } from '../hono-base';
 import type { HonoOptions } from '../hono-base';
 import type { BlankEnv, BlankSchema, Env, Schema } from '../types';
-export declare class Hono<E extends Env = BlankEnv, S extends Schema = BlankSchema, BasePath extends string = '/'> extends HonoBase<E, S, BasePath> {
+export declare class Hono<E extends Env = BlankEnv, S extends Schema = BlankSchema, BasePath extends string = "/"> extends HonoBase<E, S, BasePath> {
     constructor(options?: HonoOptions<E>);
 }

package/dist/types/request.d.ts

@@ -13,8 +13,7 @@ type Body = {
 type BodyCache = Partial<Body & {
     parsedBody: BodyData;
 }>;
-export declare class HonoRequest<P extends string = '/', I extends Input['out'] = {}> {
-    #private;
+export declare class HonoRequest<P extends string = "/", I extends Input["out"] = {}> {
     /**
      * `.raw` can get the raw Request object.
      *
@@ -45,7 +44,10 @@ export declare class HonoRequest<P extends string = '/', I extends Input['out']
      */
     path: string;
     bodyCache: BodyCache;
-    constructor(request: Request, path?: string, matchResult?: Result<[unknown, RouterRoute]>);
+    constructor(request: Request, path?: string, matchResult?: Result<[
+        unknown,
+        RouterRoute
+    ]>);
     /**
      * `.req.param()` gets the path parameters.
      *

package/dist/types/router/linear-router/router.d.ts

@@ -1,6 +1,5 @@
 import type { Result, Router } from '../../router';
 export declare class LinearRouter<T> implements Router<T> {
-    #private;
     name: string;
     add(method: string, path: string, handler: T): void;
     match(method: string, path: string): Result<T>;

package/dist/types/router/pattern-router/router.d.ts

@@ -1,6 +1,5 @@
 import type { Result, Router } from '../../router';
 export declare class PatternRouter<T> implements Router<T> {
-    #private;
     name: string;
     add(method: string, path: string, handler: T): void;
     match(method: string, path: string): Result<T>;

package/dist/types/router/reg-exp-router/node.d.ts

@@ -1,10 +1,12 @@
 export declare const PATH_ERROR: unique symbol;
-export type ParamAssocArray = [string, number][];
+export type ParamAssocArray = [
+    string,
+    number
+][];
 export interface Context {
     varIndex: number;
 }
 export declare class Node {
-    #private;
     insert(tokens: readonly string[], index: number, paramMap: ParamAssocArray, context: Context, pathErrorCheckOnly: boolean): void;
     buildRegExpStr(): string;
 }

package/dist/types/router/reg-exp-router/router.d.ts

@@ -1,6 +1,5 @@
 import type { Result, Router } from '../../router';
 export declare class RegExpRouter<T> implements Router<T> {
-    #private;
     name: string;
     constructor();
     add(method: string, path: string, handler: T): void;

package/dist/types/router/reg-exp-router/trie.d.ts

@@ -1,7 +1,10 @@
 import type { ParamAssocArray } from './node';
 export type ReplacementMap = number[];
 export declare class Trie {
-    #private;
     insert(path: string, index: number, pathErrorCheckOnly: boolean): ParamAssocArray;
-    buildRegExp(): [RegExp, ReplacementMap, ReplacementMap];
+    buildRegExp(): [
+        RegExp,
+        ReplacementMap,
+        ReplacementMap
+    ];
 }

package/dist/types/router/smart-router/router.d.ts

@@ -1,6 +1,5 @@
 import type { Result, Router } from '../../router';
 export declare class SmartRouter<T> implements Router<T> {
-    #private;
     name: string;
     constructor(init: {
         routers: Router<T>[];

package/dist/types/router/trie-router/node.d.ts

@@ -1,7 +1,11 @@
 import type { Params } from '../../router';
 export declare class Node<T> {
-    #private;
     constructor(method?: string, handler?: T, children?: Record<string, Node<T>>);
     insert(method: string, path: string, handler: T): Node<T>;
-    search(method: string, path: string): [[T, Params][]];
+    search(method: string, path: string): [
+        [
+            T,
+            Params
+        ][]
+    ];
 }

package/dist/types/router/trie-router/router.d.ts

@@ -1,6 +1,5 @@
 import type { Result, Router } from '../../router';
 export declare class TrieRouter<T> implements Router<T> {
-    #private;
     name: string;
     constructor();
     add(method: string, path: string, handler: T): void;

package/dist/types/router.d.ts

@@ -13,7 +13,14 @@ export declare const METHOD_NAME_ALL_LOWERCASE: "all";
 /**
  * Array of supported HTTP methods.
  */
-export declare const METHODS: readonly ["get", "post", "put", "delete", "options", "patch"];
+export declare const METHODS: readonly [
+    "get",
+    "post",
+    "put",
+    "delete",
+    "options",
+    "patch"
+];
 /**
  * Error message indicating that a route cannot be added because the matcher is already built.
  */
@@ -89,7 +96,18 @@ export type Params = Record<string, string>;
  * ]
  * ```
  */
-export type Result<T> = [[T, ParamIndexMap][], ParamStash] | [[T, Params][]];
+export type Result<T> = [
+    [
+        T,
+        ParamIndexMap
+    ][],
+    ParamStash
+] | [
+    [
+        T,
+        Params
+    ][]
+];
 /**
  * Error class representing an unsupported path error.
  */