rosetta-i18n 0.2.1 → 1.0.0-beta.2

package/dist/esm/astro.js

@@ -0,0 +1,103 @@
+const LOCALE_HEADER = "x-rosetta-locale";
+const DEFAULT_LOCALE_COOKIE = "locale";
+const ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;
+function localeCookieName(config) {
+  return config.cookieName ?? DEFAULT_LOCALE_COOKIE;
+}
+function localeCookieOptions(config) {
+  return {
+    path: "/",
+    maxAge: config.cookieMaxAgeSeconds ?? ONE_YEAR_SECONDS,
+    sameSite: "lax"
+  };
+}
+function isLocale(config, value) {
+  return typeof value === "string" && config.locales.includes(value);
+}
+function localeFromPath(config, pathname) {
+  const segment = pathname.split("/")[1];
+  return segment && isLocale(config, segment) ? segment : null;
+}
+function stripLocale(config, pathname) {
+  const locale = localeFromPath(config, pathname);
+  if (!locale) return { locale: null, path: pathname || "/" };
+  const rest = pathname.slice(locale.length + 1);
+  return { locale, path: rest || "/" };
+}
+function resolveLocale(config, input) {
+  const fromPath = localeFromPath(config, input.pathname);
+  if (fromPath) {
+    return {
+      locale: fromPath,
+      path: stripLocale(config, input.pathname).path,
+      source: "url"
+    };
+  }
+  if (isLocale(config, input.header)) {
+    return { locale: input.header, path: input.pathname, source: "header" };
+  }
+  if (isLocale(config, input.cookie)) {
+    return { locale: input.cookie, path: input.pathname, source: "cookie" };
+  }
+  return {
+    locale: config.defaultLocale,
+    path: input.pathname,
+    source: "default"
+  };
+}
+function serializeLocaleCookie(config, locale) {
+  const options = localeCookieOptions(config);
+  return `${localeCookieName(config)}=${encodeURIComponent(locale)}; Path=${options.path}; Max-Age=${options.maxAge}; SameSite=${capitalize(options.sameSite)}`;
+}
+function parseCookie(header, name) {
+  if (!header) return null;
+  for (const part of header.split(";")) {
+    const [key, ...rest] = part.trim().split("=");
+    if (key === name) return decodeURIComponent(rest.join("="));
+  }
+  return null;
+}
+function capitalize(value) {
+  return value.charAt(0).toUpperCase() + value.slice(1);
+}
+
+function createAstroLocaleMiddleware(config) {
+  return async function onRequest(context, next) {
+    const url = new URL(context.request.url);
+    const resolved = resolveLocale(config, {
+      pathname: url.pathname,
+      header: context.request.headers.get(LOCALE_HEADER),
+      cookie: parseCookie(
+        context.request.headers.get("cookie"),
+        localeCookieName(config)
+      )
+    });
+    context.locals.locale = resolved.locale;
+    if (resolved.source === "url") {
+      const target = new URL(url);
+      target.pathname = resolved.path;
+      const response2 = await context.rewrite(target);
+      response2.headers.set(LOCALE_HEADER, resolved.locale);
+      response2.headers.append(
+        "Set-Cookie",
+        serializeLocaleCookie(config, resolved.locale)
+      );
+      return response2;
+    }
+    const response = await next();
+    if (resolved.source === "cookie" || resolved.source === "default") {
+      response.headers.append(
+        "Set-Cookie",
+        serializeLocaleCookie(config, resolved.locale)
+      );
+    }
+    return response;
+  };
+}
+function getAstroLocale(context, config) {
+  const locale = context.locals.locale;
+  return isLocale(config, locale) ? locale : config.defaultLocale;
+}
+
+export { createAstroLocaleMiddleware, getAstroLocale };
+//# sourceMappingURL=astro.js.map

package/dist/esm/astro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.js","sources":["../../src/locale/core.ts","../../src/locale/astro.ts"],"sourcesContent":["/**\n * Runtime locale layer — framework-agnostic core.\n *\n * The translation engine answers \"how do I translate these strings?\". This\n * module answers \"which locale is this request in, and how do I switch?\" — the\n * routing + cookie model that the React, Next, and Astro adapters are thin\n * wrappers around.\n *\n * The config is deliberately plain data (no functions) so the exact same object\n * can cross the server → client boundary. Resolution is deterministic and\n * one-directional:\n *\n *   1. a locale-prefixed URL (`/ja/pricing`) is authoritative,\n *   2. then a forced header (`x-rosetta-locale`, set by middleware),\n *   3. then the persisted cookie,\n *   4. then the default locale.\n *\n * Switching sets the cookie *and* navigates to the localized URL, so the URL and\n * the cookie always agree. There is no client-side guessing, no\n * refresh-after-push race, and no way for a stale request to re-pin the locale.\n */\n\nexport const LOCALE_HEADER = \"x-rosetta-locale\";\nexport const DEFAULT_LOCALE_COOKIE = \"locale\";\nexport const ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;\n\nexport interface LocaleConfig {\n\t/** Every locale, including the default. Order is the switcher order. */\n\tlocales: readonly string[];\n\t/** The locale served without a URL prefix. */\n\tdefaultLocale: string;\n\t/** Cookie that persists the choice. Default `\"locale\"`. */\n\tcookieName?: string;\n\t/** Cookie max-age in seconds. Default one year. */\n\tcookieMaxAgeSeconds?: number;\n\t/** Prefix the default locale too (`/en/...`). Default `false`. */\n\tprefixDefaultLocale?: boolean;\n\t/**\n\t * Canonical (unprefixed) paths that have localized variants — exact matches.\n\t * Omit both this and `localizedPathPrefixes` to localize every path.\n\t */\n\tlocalizedPaths?: readonly string[];\n\t/** Canonical paths that have localized variants — prefix matches (e.g. `/blog/`). */\n\tlocalizedPathPrefixes?: readonly string[];\n}\n\nexport type LocaleSource = \"url\" | \"header\" | \"cookie\" | \"default\";\n\nexport interface ResolvedLocale {\n\tlocale: string;\n\t/** The canonical, unprefixed path for this request. */\n\tpath: string;\n\tsource: LocaleSource;\n}\n\nexport interface LocaleCookieOptions {\n\tpath: string;\n\tmaxAge: number;\n\tsameSite: \"lax\";\n}\n\nexport interface LocaleSwitchPlan {\n\t/** Localized URL to navigate to. */\n\thref: string;\n\t/** Cookie to persist the choice. */\n\tcookie: { name: string; value: string; options: LocaleCookieOptions };\n}\n\nexport function localeCookieName(config: LocaleConfig): string {\n\treturn config.cookieName ?? DEFAULT_LOCALE_COOKIE;\n}\n\nexport function localeCookieOptions(config: LocaleConfig): LocaleCookieOptions {\n\treturn {\n\t\tpath: \"/\",\n\t\tmaxAge: config.cookieMaxAgeSeconds ?? ONE_YEAR_SECONDS,\n\t\tsameSite: \"lax\",\n\t};\n}\n\nexport function isLocale(\n\tconfig: LocaleConfig,\n\tvalue: unknown,\n): value is string {\n\treturn typeof value === \"string\" && config.locales.includes(value);\n}\n\nexport function isLocalizedPath(\n\tconfig: LocaleConfig,\n\tpathname: string,\n): boolean {\n\tconst hasRules =\n\t\t(config.localizedPaths?.length ?? 0) > 0 ||\n\t\t(config.localizedPathPrefixes?.length ?? 0) > 0;\n\tif (!hasRules) return true;\n\tif (config.localizedPaths?.includes(pathname)) return true;\n\treturn (\n\t\tconfig.localizedPathPrefixes?.some(\n\t\t\t(prefix) => pathname === prefix || pathname.startsWith(prefix),\n\t\t) ?? false\n\t);\n}\n\n/** The leading locale segment of a path, if it is one we know. */\nexport function localeFromPath(\n\tconfig: LocaleConfig,\n\tpathname: string,\n): string | null {\n\tconst segment = pathname.split(\"/\")[1];\n\treturn segment && isLocale(config, segment) ? segment : null;\n}\n\n/** Strip a leading locale segment, returning the canonical path. */\nexport function stripLocale(\n\tconfig: LocaleConfig,\n\tpathname: string,\n): { locale: string | null; path: string } {\n\tconst locale = localeFromPath(config, pathname);\n\tif (!locale) return { locale: null, path: pathname || \"/\" };\n\tconst rest = pathname.slice(locale.length + 1);\n\treturn { locale, path: rest || \"/\" };\n}\n\n/**\n * Prefix a canonical path for a locale. The default locale stays bare unless\n * `prefixDefaultLocale` is set.\n */\nexport function localizePath(\n\tconfig: LocaleConfig,\n\tpathname: string,\n\tlocale: string,\n): string {\n\tif (locale === config.defaultLocale && !config.prefixDefaultLocale) {\n\t\treturn pathname;\n\t}\n\treturn pathname === \"/\" ? `/${locale}` : `/${locale}${pathname}`;\n}\n\n/** The URL to navigate to when switching `pathname` to `locale`. */\nexport function switchHref(\n\tconfig: LocaleConfig,\n\tpathname: string,\n\tlocale: string,\n): string {\n\tconst { path } = stripLocale(config, pathname);\n\treturn localizePath(config, path, locale);\n}\n\n/**\n * Resolve the active locale for a request. Precedence: URL prefix → forced\n * header → cookie → default. `path` is always the canonical (unprefixed) path.\n */\nexport function resolveLocale(\n\tconfig: LocaleConfig,\n\tinput: { pathname: string; header?: string | null; cookie?: string | null },\n): ResolvedLocale {\n\tconst fromPath = localeFromPath(config, input.pathname);\n\tif (fromPath) {\n\t\treturn {\n\t\t\tlocale: fromPath,\n\t\t\tpath: stripLocale(config, input.pathname).path,\n\t\t\tsource: \"url\",\n\t\t};\n\t}\n\tif (isLocale(config, input.header)) {\n\t\treturn { locale: input.header, path: input.pathname, source: \"header\" };\n\t}\n\tif (isLocale(config, input.cookie)) {\n\t\treturn { locale: input.cookie, path: input.pathname, source: \"cookie\" };\n\t}\n\treturn {\n\t\tlocale: config.defaultLocale,\n\t\tpath: input.pathname,\n\t\tsource: \"default\",\n\t};\n}\n\n/** The `Set-Cookie` value that persists `locale`. */\nexport function serializeLocaleCookie(\n\tconfig: LocaleConfig,\n\tlocale: string,\n): string {\n\tconst options = localeCookieOptions(config);\n\treturn `${localeCookieName(config)}=${encodeURIComponent(locale)}; Path=${\n\t\toptions.path\n\t}; Max-Age=${options.maxAge}; SameSite=${capitalize(options.sameSite)}`;\n}\n\n/** Read a single cookie value from a `Cookie:` header. */\nexport function parseCookie(\n\theader: string | null | undefined,\n\tname: string,\n): string | null {\n\tif (!header) return null;\n\tfor (const part of header.split(\";\")) {\n\t\tconst [key, ...rest] = part.trim().split(\"=\");\n\t\tif (key === name) return decodeURIComponent(rest.join(\"=\"));\n\t}\n\treturn null;\n}\n\n/**\n * Everything a client needs to switch locale: set `cookie`, navigate to `href`.\n * Returns `null` when the current path has no localized variant (legal pages,\n * API routes, …), so the switcher can no-op instead of linking to a 404.\n */\nexport function planSwitch(\n\tconfig: LocaleConfig,\n\tpathname: string,\n\tlocale: string,\n): LocaleSwitchPlan | null {\n\tconst { path } = stripLocale(config, pathname);\n\tif (!isLocalizedPath(config, path)) return null;\n\treturn {\n\t\thref: localizePath(config, path, locale),\n\t\tcookie: {\n\t\t\tname: localeCookieName(config),\n\t\t\tvalue: locale,\n\t\t\toptions: localeCookieOptions(config),\n\t\t},\n\t};\n}\n\nfunction capitalize(value: string): string {\n\treturn value.charAt(0).toUpperCase() + value.slice(1);\n}\n","/**\n * Astro adapter.\n *\n * Astro's middleware runs on every request, so it's the natural place to\n * resolve the locale, force it onto `Astro.locals.locale`, rewrite\n * locale-prefixed URLs to their canonical path, and persist the cookie.\n *\n * ```ts\n * // src/middleware.ts\n * import { defineMiddleware } from \"astro:middleware\";\n * import { createAstroLocaleMiddleware } from \"rosetta-i18n/astro\";\n * import { localeConfig } from \"../i18n/config\";\n *\n * export const onRequest = createAstroLocaleMiddleware(localeConfig);\n * ```\n *\n * For a client switch, render the React `<LocaleSwitcher>` as an island and\n * wrap it in `<LocaleProvider locale={Astro.locals.locale} config={localeConfig}>`.\n * Types are structural, so this module never depends on `astro`.\n */\n\nimport {\n\tisLocale,\n\tLOCALE_HEADER,\n\ttype LocaleConfig,\n\tlocaleCookieName,\n\tparseCookie,\n\tresolveLocale,\n\tserializeLocaleCookie,\n} from \"./core\";\n\nexport interface AstroLocaleContext {\n\trequest: Request;\n\tlocals: Record<string, unknown>;\n\t/** Astro's `context.rewrite()`. */\n\trewrite: (url: string | URL) => Promise<Response>;\n}\n\nexport type AstroMiddlewareNext = (rewrite?: URL) => Promise<Response>;\n\nexport function createAstroLocaleMiddleware(config: LocaleConfig) {\n\treturn async function onRequest(\n\t\tcontext: AstroLocaleContext,\n\t\tnext: AstroMiddlewareNext,\n\t): Promise<Response> {\n\t\tconst url = new URL(context.request.url);\n\t\tconst resolved = resolveLocale(config, {\n\t\t\tpathname: url.pathname,\n\t\t\theader: context.request.headers.get(LOCALE_HEADER),\n\t\t\tcookie: parseCookie(\n\t\t\t\tcontext.request.headers.get(\"cookie\"),\n\t\t\t\tlocaleCookieName(config),\n\t\t\t),\n\t\t});\n\n\t\tcontext.locals.locale = resolved.locale;\n\n\t\tif (resolved.source === \"url\") {\n\t\t\tconst target = new URL(url);\n\t\t\ttarget.pathname = resolved.path;\n\t\t\tconst response = await context.rewrite(target);\n\t\t\tresponse.headers.set(LOCALE_HEADER, resolved.locale);\n\t\t\tresponse.headers.append(\n\t\t\t\t\"Set-Cookie\",\n\t\t\t\tserializeLocaleCookie(config, resolved.locale),\n\t\t\t);\n\t\t\treturn response;\n\t\t}\n\n\t\tconst response = await next();\n\t\t// Persist only when the URL can't decide it (bare path) and the cookie\n\t\t// disagrees — never on a rewrite, where the URL is authoritative.\n\t\tif (resolved.source === \"cookie\" || resolved.source === \"default\") {\n\t\t\tresponse.headers.append(\n\t\t\t\t\"Set-Cookie\",\n\t\t\t\tserializeLocaleCookie(config, resolved.locale),\n\t\t\t);\n\t\t}\n\t\treturn response;\n\t};\n}\n\n/** Read the locale the middleware stored on `Astro.locals`. */\nexport function getAstroLocale(\n\tcontext: { locals: Record<string, unknown> },\n\tconfig: LocaleConfig,\n): string {\n\tconst locale = context.locals.locale;\n\treturn isLocale(config, locale) ? locale : config.defaultLocale;\n}\n"],"names":["response"],"mappings":"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"}