intor 2.5.0 → 2.6.0

package/dist/fastify/src/routing/pathname/canonicalize-pathname.js

@@ -4,75 +4,33 @@ import 'logry';
 import 'p-limit';
 import 'intor-translator';
 
-/**
- * Returns the internal canonical pathname.
- *
- * Canonical representation is the locale-neutral and deployment-neutral
- * internal routing form used for identity and routing computation.
- *
- * Guarantees:
- * - Pathname is normalized
- * - Deployment prefix (`basePath`) is removed
- * - Leading locale segment or `{locale}` placeholder is removed
- * - Only the first path segment is evaluated for locale stripping
- * - Result always starts with "/"
- * - Root is represented as "/"
- *
- * Accepts `{locale}` as a locale placeholder segment.
- *
- * @example
- * ```ts
- * // config.supportedLocales: ["en"]
- * // config.routing.basePath: "/app"
- * // config.routing.prefix: "all"
- * canonicalizePathname("/app/en/about", config);
- * // => "/about"
- *```
- */
 function canonicalizePathname(rawPathname, config) {
-    const { routing, supportedLocales } = config;
-    const normalizedPathname = normalizePathname(rawPathname);
-    // ---------------------------------------------------------------------------
-    // Strip basePath (deployment prefix)
-    // ---------------------------------------------------------------------------
-    const basePath = routing.basePath === "/" ? "" : routing.basePath;
-    let path = normalizedPathname;
-    if (basePath) {
-        if (path === basePath) {
-            path = "/";
-        }
-        else if (path.startsWith(basePath + "/")) {
-            path = path.slice(basePath.length);
-        }
+  const { routing, supportedLocales } = config;
+  const normalizedPathname = normalizePathname(rawPathname);
+  const basePath = routing.basePath === "/" ? "" : routing.basePath;
+  let path = normalizedPathname;
+  if (basePath) {
+    if (path === basePath) {
+      path = "/";
+    } else if (path.startsWith(basePath + "/")) {
+      path = path.slice(basePath.length);
     }
-    // ---------------------------------------------------------------------------
-    // Detect first segment (allocation-minimized)
-    // ---------------------------------------------------------------------------
-    if (path === "/")
-        return "/";
-    const segmentStart = 1; // skip leading "/"
-    const nextSlash = path.indexOf("/", segmentStart);
-    const firstSegment = nextSlash === -1
-        ? path.slice(segmentStart)
-        : path.slice(segmentStart, nextSlash);
-    // ---------------------------------------------------------------------------
-    // Determine if first segment is locale representation
-    // ---------------------------------------------------------------------------
-    let localeLength;
-    if (firstSegment === LOCALE_PLACEHOLDER) {
-        localeLength = firstSegment.length;
-    }
-    else if (supportedLocales.includes(firstSegment)) {
-        localeLength = firstSegment.length;
-    }
-    // ---------------------------------------------------------------------------
-    // Strip locale segment (if any)
-    // ---------------------------------------------------------------------------
-    if (localeLength !== undefined) {
-        const stripped = path.slice(localeLength + 1);
-        return stripped || "/";
-    }
-    return path;
+  }
+  if (path === "/") return "/";
+  const segmentStart = 1;
+  const nextSlash = path.indexOf("/", segmentStart);
+  const firstSegment = nextSlash === -1 ? path.slice(segmentStart) : path.slice(segmentStart, nextSlash);
+  let localeLength;
+  if (firstSegment === LOCALE_PLACEHOLDER) {
+    localeLength = firstSegment.length;
+  } else if (supportedLocales.includes(firstSegment)) {
+    localeLength = firstSegment.length;
+  }
+  if (localeLength !== void 0) {
+    const stripped = path.slice(localeLength + 1);
+    return stripped || "/";
+  }
+  return path;
 }
 
 export { canonicalizePathname };

package/dist/fastify/src/routing/pathname/localize-pathname.js

@@ -2,37 +2,19 @@ import { canonicalizePathname } from './canonicalize-pathname.js';
 import { materializePathname } from './materialize-pathname.js';
 import { standardizePathname } from './standardize-pathname.js';
 
-/**
- * Localizes a pathname by composing canonicalization,
- * standardization, and locale prefix strategies.
- *
- * @example
- * ```ts
- * // config.supportedLocales: ["en-US"]
- * // config.routing.basePath: "/app"
- * // config.routing.prefix: "all"
- * localizePathname("/app/en-US/about", config, "en-US");
- * // => {
- * //   pathname: '/app/en-US/about'
- * //   canonicalPathname: '/about',
- * //   templatedPathname: '/app/{locale}/about',
- * // }
- * ```
- *
- * @public
- */
 const localizePathname = (rawPathname, config, locale) => {
-    // 1. Canonicalize: normalize and remove routing-specific prefixes
-    const canonicalPathname = canonicalizePathname(rawPathname, config);
-    // 2. Standardize: convert to internal pathname shape with locale placeholder
-    const standardizedPathname = standardizePathname(canonicalPathname, config);
-    // 3. Materialize: apply routing rules to produce the final pathname
-    const materializedPathname = materializePathname(standardizedPathname, config, locale);
-    return {
-        canonicalPathname,
-        templatedPathname: standardizedPathname,
-        pathname: materializedPathname,
-    };
+  const canonicalPathname = canonicalizePathname(rawPathname, config);
+  const standardizedPathname = standardizePathname(canonicalPathname, config);
+  const materializedPathname = materializePathname(
+    standardizedPathname,
+    config,
+    locale
+  );
+  return {
+    canonicalPathname,
+    templatedPathname: standardizedPathname,
+    pathname: materializedPathname
+  };
 };
 
 export { localizePathname };

package/dist/fastify/src/routing/pathname/materialize-pathname.js

@@ -3,51 +3,16 @@ import 'logry';
 import 'p-limit';
 import 'intor-translator';
 
-/**
- * Materializes a standardized pathname into a concrete, locale-aware URL.
- *
- * This function resolves the `{locale}` placeholder according to the
- * configured `localePrefix` strategy and produces the final pathname.
- *
- * Behavior:
- * - "all": always injects the locale segment
- * - "except-default": injects the locale unless it equals `defaultLocale`
- * - "none": removes the locale placeholder entirely
- *
- * Invariants:
- * - `standardizedPathname` must be produced by `standardizePathname`
- * - The pathname must contain exactly one `{locale}` placeholder
- * - The placeholder must appear as the first path segment
- *
- * This function performs structural transformation only.
- * It does not normalize or sanitize the resulting pathname.
- *
- * @example
- * ```ts
- * // config.routing.localePrefix: "all"
- * materializePathname("/app/{locale}/about", config, "en");
- * // => /app/en/about
- *
- * // config.routing.localePrefix: "none"
- * materializePathname("/app/{locale}/about", config, "en");
- * // => /app/about
- * ```
- */
 const materializePathname = (standardizedPathname, config, locale) => {
-    const { localePrefix } = config.routing;
-    const removeLocale = () => {
-        const result = standardizedPathname.replace(`/${LOCALE_PLACEHOLDER}`, "");
-        return result === "" ? "/" : result;
-    };
-    const injectLocale = () => standardizedPathname.replace(LOCALE_PLACEHOLDER, locale);
-    // localePrefix: "none"
-    if (localePrefix === "none")
-        return removeLocale();
-    // localePrefix: "all"
-    if (localePrefix === "all")
-        return injectLocale();
-    // localePrefix: "except-default"
-    return locale === config.defaultLocale ? removeLocale() : injectLocale();
+  const { localePrefix } = config.routing;
+  const removeLocale = () => {
+    const result = standardizedPathname.replace(`/${LOCALE_PLACEHOLDER}`, "");
+    return result === "" ? "/" : result;
+  };
+  const injectLocale = () => standardizedPathname.replace(LOCALE_PLACEHOLDER, locale);
+  if (localePrefix === "none") return removeLocale();
+  if (localePrefix === "all") return injectLocale();
+  return locale === config.defaultLocale ? removeLocale() : injectLocale();
 };
 
 export { materializePathname };

package/dist/fastify/src/routing/pathname/standardize-pathname.js

@@ -3,37 +3,13 @@ import 'logry';
 import 'p-limit';
 import 'intor-translator';
 
-/**
- * Standardizes a canonical pathname into an internal routing template.
- *
- * Standardized representation:
- * - Prepends the deployment prefix (`basePath`) if defined
- * - Injects the `{locale}` placeholder as the first path segment
- * - Preserves the canonical pathname structure
- *
- * Input must be a canonical pathname.
- *
- * Output is an internal routing template and
- * is not a locale-resolved URL.
- *
- * @example
- * ```ts
- * // config.routing.basePath: "/app",
- * standardizePathname("/about", config);
- * // => "/app/{locale}/about"
- * ```
- */
 const standardizePathname = (canonicalPathname, config) => {
-    const { routing } = config;
-    const basePath = routing.basePath && routing.basePath !== "/" ? routing.basePath : "";
-    if (canonicalPathname === "/") {
-        return basePath
-            ? `${basePath}/${LOCALE_PLACEHOLDER}`
-            : `/${LOCALE_PLACEHOLDER}`;
-    }
-    return basePath
-        ? `${basePath}/${LOCALE_PLACEHOLDER}${canonicalPathname}`
-        : `/${LOCALE_PLACEHOLDER}${canonicalPathname}`;
+  const { routing } = config;
+  const basePath = routing.basePath && routing.basePath !== "/" ? routing.basePath : "";
+  if (canonicalPathname === "/") {
+    return basePath ? `${basePath}/${LOCALE_PLACEHOLDER}` : `/${LOCALE_PLACEHOLDER}`;
+  }
+  return basePath ? `${basePath}/${LOCALE_PLACEHOLDER}${canonicalPathname}` : `/${LOCALE_PLACEHOLDER}${canonicalPathname}`;
 };
 
 export { standardizePathname };

package/dist/hono/src/adapters/hono/create-intor-handler.js

@@ -7,51 +7,40 @@ import 'intor-translator';
 import { resolveInbound } from '../../routing/inbound/resolve-inbound.js';
 import { getLocaleFromAcceptLanguage } from '../../routing/locale/get-locale-from-accept-language.js';
 
-/**
- * Resolves locale-aware routing for the current execution context.
- *
- * - Binds resolved routing state to the request.
- * - Optionally binds convenience routing shortcuts for downstream consumption.
- *
- * @public
- */
 function createIntorHandler(config, options) {
-    return async function intorHandler(c, next) {
-        // Locale from Accept-Language header
-        const acceptLanguage = c.req.header("accept-language");
-        const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(acceptLanguage, config.supportedLocales);
-        // ----------------------------------------------------------
-        // Resolve inbound routing decision (pure computation)
-        // ----------------------------------------------------------
-        const url = new URL(c.req.url);
-        const cookie = parseCookieHeader(c.req.header("cookie"))[config.cookie.name];
-        const { locale, localeSource, pathname } = resolveInbound(config, url.pathname, {
-            host: url.hostname,
-            query: normalizeQuery(Object.fromEntries(url.searchParams)),
-            ...(cookie !== undefined ? { cookie } : {}),
-            ...(localeFromAcceptLanguage !== undefined
-                ? { detected: localeFromAcceptLanguage }
-                : {}),
-        });
-        // --------------------------------------------------
-        // Bind inbound routing context
-        // --------------------------------------------------
-        c.set("intor", { locale, localeSource, pathname });
-        const { handlers, hooks } = options ?? {};
-        const { hasKey, t, tRich } = await getTranslator(config, {
-            locale,
-            ...(handlers !== undefined ? { handlers } : {}),
-            ...(hooks !== undefined ? { hooks } : {}),
-        });
-        // DX shortcuts (enabled by default)
-        if (options?.shortcuts !== false) {
-            c.set("locale", locale);
-            c.set("hasKey", hasKey);
-            c.set("t", t);
-            c.set("tRich", tRich);
-        }
-        await next();
-    };
+  return async function intorHandler(c, next) {
+    const acceptLanguage = c.req.header("accept-language");
+    const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(
+      acceptLanguage,
+      config.supportedLocales
+    );
+    const url = new URL(c.req.url);
+    const cookie = parseCookieHeader(c.req.header("cookie"))[config.cookie.name];
+    const { locale, localeSource, pathname } = resolveInbound(
+      config,
+      url.pathname,
+      {
+        host: url.hostname,
+        query: normalizeQuery(Object.fromEntries(url.searchParams)),
+        ...cookie !== void 0 ? { cookie } : {},
+        ...localeFromAcceptLanguage !== void 0 ? { detected: localeFromAcceptLanguage } : {}
+      }
+    );
+    c.set("intor", { locale, localeSource, pathname });
+    const { handlers, hooks } = options ?? {};
+    const { hasKey, t, tRich } = await getTranslator(config, {
+      locale,
+      ...handlers !== void 0 ? { handlers } : {},
+      ...hooks !== void 0 ? { hooks } : {}
+    });
+    if (options?.shortcuts !== false) {
+      c.set("locale", locale);
+      c.set("hasKey", hasKey);
+      c.set("t", t);
+      c.set("tRich", tRich);
+    }
+    await next();
+  };
 }
 
 export { createIntorHandler };

package/dist/hono/src/adapters/hono/get-translator.js

@@ -1,15 +1,8 @@
 import { getTranslator as getTranslator$1 } from 'intor/edge';
 
-/**
- * Get a edge-runtime translator for the current execution context.
- *
- * - Automatically resolves the locale from the framework context.
- *
- * @public
- */
 async function getTranslator(config, c, params) {
-    const locale = c.get("intor")?.locale ?? config.defaultLocale;
-    return getTranslator$1(config, { locale, ...(params ?? {}) });
+  const locale = c.get("intor")?.locale ?? config.defaultLocale;
+  return getTranslator$1(config, { locale, ...params ?? {} });
 }
 
 export { getTranslator };

package/dist/hono/src/core/constants/locale-placeholder.js

@@ -1,4 +1,3 @@
-// Default locale placeholder
 const LOCALE_PLACEHOLDER = "{locale}";
 
 export { LOCALE_PLACEHOLDER };

package/dist/hono/src/core/locale/canonicalize-locale.js

@@ -1,23 +1,12 @@
-/**
- * Canonicalizes a BCP 47 locale string.
- *
- * - Uses `Intl.getCanonicalLocales` when available.
- * - Returns the original input if `Intl` is unavailable.
- * - Returns `undefined` for invalid locale input.
- *
- * This function performs normalization only.
- * It does not perform matching or fallback.
- */
 function canonicalizeLocale(input) {
-    try {
-        if (typeof Intl === "undefined" || !Intl.getCanonicalLocales) {
-            return input;
-        }
-        return Intl.getCanonicalLocales(input)[0];
-    }
-    catch {
-        return;
+  try {
+    if (typeof Intl === "undefined" || !Intl.getCanonicalLocales) {
+      return input;
     }
+    return Intl.getCanonicalLocales(input)[0];
+  } catch {
+    return;
+  }
 }
 
 export { canonicalizeLocale };

package/dist/hono/src/core/locale/match-locale.js

@@ -1,61 +1,35 @@
 import { canonicalizeLocale } from './canonicalize-locale.js';
 import { parseLocale } from './parse-locale.js';
 
-/**
- * Matches a locale candidate against a list of supported locales.
- *
- * Resolution order:
- * 1. Exact canonical match
- * 2. Same language + same script
- * 3. Same language only (only if candidate has no script)
- *
- * Returns one of the original `supportedLocales` values if matched.
- * Returns `undefined` if no match is found.
- *
- * Notes:
- * - Matching is deterministic and order-sensitive.
- * - Does not perform automatic fallback to a default locale.
- *   Consumers are responsible for applying fallback logic.
- * - If the candidate includes a script subtag, language-only fallback is skipped.
- *
- * @public
- */
 function matchLocale(locale, supportedLocales = []) {
-    if (!locale || supportedLocales.length === 0)
-        return;
-    const canonicalCandidate = canonicalizeLocale(locale);
-    if (!canonicalCandidate)
-        return;
-    const candidateParts = parseLocale(canonicalCandidate);
-    const supportedCanonical = supportedLocales.flatMap((original) => {
-        const canonical = canonicalizeLocale(original);
-        if (!canonical)
-            return [];
-        return [{ original, canonical, parts: parseLocale(canonical) }];
-    });
-    // 1. Exact match
-    for (const s of supportedCanonical) {
-        if (s.canonical === canonicalCandidate) {
-            return s.original;
-        }
-    }
-    // 2. Same language + same script
-    if (candidateParts.script) {
-        for (const s of supportedCanonical) {
-            if (s.parts.language === candidateParts.language &&
-                s.parts.script === candidateParts.script) {
-                return s.original;
-            }
-        }
-        return;
+  if (!locale || supportedLocales.length === 0) return;
+  const canonicalCandidate = canonicalizeLocale(locale);
+  if (!canonicalCandidate) return;
+  const candidateParts = parseLocale(canonicalCandidate);
+  const supportedCanonical = supportedLocales.flatMap((original) => {
+    const canonical = canonicalizeLocale(original);
+    if (!canonical) return [];
+    return [{ original, canonical, parts: parseLocale(canonical) }];
+  });
+  for (const s of supportedCanonical) {
+    if (s.canonical === canonicalCandidate) {
+      return s.original;
     }
-    // 3. Same language only
+  }
+  if (candidateParts.script) {
     for (const s of supportedCanonical) {
-        if (s.parts.language === candidateParts.language) {
-            return s.original;
-        }
+      if (s.parts.language === candidateParts.language && s.parts.script === candidateParts.script) {
+        return s.original;
+      }
     }
     return;
+  }
+  for (const s of supportedCanonical) {
+    if (s.parts.language === candidateParts.language) {
+      return s.original;
+    }
+  }
+  return;
 }
 
 export { matchLocale };

package/dist/hono/src/core/locale/parse-locale.js

@@ -1,27 +1,17 @@
-/**
- * Parses a canonical locale tag into structural components.
- *
- * - Uses `Intl.Locale` when available.
- * - Falls back to minimal parsing (language only) if unavailable.
- *
- * This function does not validate or match locales.
- */
 function parseLocale(tag) {
-    try {
-        if (typeof Intl !== "undefined" && typeof Intl.Locale === "function") {
-            const locale = new Intl.Locale(tag);
-            return {
-                language: locale.language,
-                ...(locale.script !== undefined ? { script: locale.script } : {}),
-                ...(locale.region !== undefined ? { region: locale.region } : {}),
-            };
-        }
+  try {
+    if (typeof Intl !== "undefined" && typeof Intl.Locale === "function") {
+      const locale = new Intl.Locale(tag);
+      return {
+        language: locale.language,
+        ...locale.script !== void 0 ? { script: locale.script } : {},
+        ...locale.region !== void 0 ? { region: locale.region } : {}
+      };
     }
-    catch {
-        // fallback below
-    }
-    const parts = tag.split("-");
-    return { language: parts[0].toLowerCase() };
+  } catch {
+  }
+  const parts = tag.split("-");
+  return { language: parts[0].toLowerCase() };
 }
 
 export { parseLocale };

package/dist/hono/src/core/utils/normalizers/normalize-pathname.js

@@ -1,42 +1,24 @@
-/**
- * Normalizes a raw pathname string into a consistent structural form.
- *
- * Canonical guarantees:
- * - Leading and trailing whitespace (code points ≤ 32) are trimmed
- * - Consecutive slashes are collapsed into a single slash
- * - The result always starts with a single "/"
- * - Redundant trailing slashes are removed
- * - The root path is represented as "/"
- *
- * This function is deterministic and allocation-minimized.
- */
 const normalizePathname = (rawPathname) => {
-    const length = rawPathname.length;
-    let start = 0;
-    let end = length - 1;
-    // Trim leading whitespace
-    while (start <= end && rawPathname.codePointAt(start) <= 32)
-        start++;
-    // Trim trailing whitespace
-    while (end >= start && rawPathname.codePointAt(end) <= 32)
-        end--;
-    if (start > end)
-        return "/"; // Only whitespace
-    let result = "";
-    let hasSlash = false;
-    for (let i = start; i <= end; i++) {
-        const char = rawPathname[i];
-        if (char === "/") {
-            if (!hasSlash) {
-                hasSlash = true;
-            }
-        }
-        else {
-            result += hasSlash || result === "" ? "/" + char : char;
-            hasSlash = false;
-        }
+  const length = rawPathname.length;
+  let start = 0;
+  let end = length - 1;
+  while (start <= end && rawPathname.codePointAt(start) <= 32) start++;
+  while (end >= start && rawPathname.codePointAt(end) <= 32) end--;
+  if (start > end) return "/";
+  let result = "";
+  let hasSlash = false;
+  for (let i = start; i <= end; i++) {
+    const char = rawPathname[i];
+    if (char === "/") {
+      if (!hasSlash) {
+        hasSlash = true;
+      }
+    } else {
+      result += hasSlash || result === "" ? "/" + char : char;
+      hasSlash = false;
     }
-    return result || "/";
+  }
+  return result || "/";
 };
 
 export { normalizePathname };

package/dist/hono/src/core/utils/normalizers/normalize-query.js

@@ -1,25 +1,11 @@
-/**
- * Normalize a raw query object into a string-only map.
- *
- * This utility is used to sanitize framework-specific query inputs
- * into a stable shape that the routing core
- * can safely consume.
- *
- * Behavior:
- * - Keeps only entries whose values are strings
- * - Ignores arrays, objects, and other non-string values
- * - Does not throw or attempt to coerce values
- *
- * This function is intentionally conservative by design.
- */
 function normalizeQuery(query) {
-    const normalized = {};
-    for (const [key, value] of Object.entries(query)) {
-        if (typeof value === "string") {
-            normalized[key] = value;
-        }
+  const normalized = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (typeof value === "string") {
+      normalized[key] = value;
     }
-    return normalized;
+  }
+  return normalized;
 }
 
 export { normalizeQuery };