import "keycloakify/tools/Object.fromEntries"; import { useEffect, useState, useRef } from "react"; import fallbackMessages from "./baseMessages/en"; import { getMessages } from "./baseMessages"; import { assert } from "tsafe/assert"; import type { KcContext } from "../KcContext"; import { Reflect } from "tsafe/Reflect"; export const fallbackLanguageTag = "en"; export type KcContextLike = { locale?: { currentLanguageTag: string; supported: { languageTag: string; url: string; label: string }[]; }; }; assert(); export type MessageKey = keyof typeof fallbackMessages | keyof (typeof keycloakifyExtraMessages)[typeof fallbackLanguageTag]; export type GenericI18n = { /** * e.g: "en", "fr", "zh-CN" * * The current language */ currentLanguageTag: string; /** * Redirect to this url to change the language. * After reload currentLanguageTag === newLanguageTag */ getChangeLocalUrl: (newLanguageTag: string) => string; /** * e.g. "en" => "English", "fr" => "Français", ... * * Used to render a select that enable user to switch language. * ex: https://user-images.githubusercontent.com/6702424/186044799-38801eec-4e89-483b-81dd-8e9233e8c0eb.png * */ labelBySupportedLanguageTag: Record; /** * Examples assuming currentLanguageTag === "en" * * msg("access-denied") === Access denied * msg("impersonateTitleHtml", "Foo") === Foo Impersonate User */ msg: (key: MessageKey, ...args: (string | undefined)[]) => JSX.Element; /** * It's the same thing as msg() but instead of returning a JSX.Element it returns a string. * It can be more convenient to manipulate strings but if there are HTML tags it wont render. * msgStr("impersonateTitleHtml", "Foo") === "Foo Impersonate User" */ msgStr: (key: MessageKey, ...args: (string | undefined)[]) => string; /** * This is meant to be used when the key argument is variable, something that might have been configured by the user * in the Keycloak admin for example. * * Examples assuming currentLanguageTag === "en" * { * en: { * "access-denied": "Access denied", * "foo": "Foo {0} {1}", * "bar": "Bar {0}" * } * } * * advancedMsg("${access-denied} foo bar") === {msgStr("access-denied")} foo bar === Access denied foo bar * advancedMsg("${access-denied}") === advancedMsg("access-denied") === msg("access-denied") === Access denied * advancedMsg("${not-a-message-key}") === advancedMsg(not-a-message-key") === not-a-message-key * advancedMsg("${bar}", "c") * === {msgStr("bar", "XXX")} * === Bar <strong>XXX</strong> (The html in the arg is partially escaped for security reasons, it might be untrusted) * advancedMsg("${foo} xx ${bar}", "a", "b", "c") * === {msgStr("foo", "a", "b")} xx {msgStr("bar")} * === Foo a b xx Bar {0} (The substitution are only applied in the first message) */ advancedMsg: (key: string, ...args: (string | undefined)[]) => JSX.Element; /** * See advancedMsg() but instead of returning a JSX.Element it returns a string. */ advancedMsgStr: (key: string, ...args: (string | undefined)[]) => string; }; export type I18n = GenericI18n; export function createUseI18n(extraMessages: { [languageTag: string]: { [key in ExtraMessageKey]: string }; }) { function useI18n(params: { kcContext: KcContextLike }): GenericI18n | null { const { kcContext } = params; const [i18n, setI18n] = useState | undefined>(undefined); const refHasStartedFetching = useRef(false); useEffect(() => { if (refHasStartedFetching.current) { return; } refHasStartedFetching.current = true; (async () => { const { currentLanguageTag = fallbackLanguageTag } = kcContext.locale ?? {}; setI18n({ ...createI18nTranslationFunctions({ fallbackMessages: { ...fallbackMessages, ...(keycloakifyExtraMessages[fallbackLanguageTag] ?? {}), ...(extraMessages[fallbackLanguageTag] ?? {}) } as any, messages: { ...(await getMessages(currentLanguageTag)), ...((keycloakifyExtraMessages as any)[currentLanguageTag] ?? {}), ...(extraMessages[currentLanguageTag] ?? {}) } as any }), currentLanguageTag, getChangeLocalUrl: newLanguageTag => { const { locale } = kcContext; assert(locale !== undefined, "Internationalization not enabled"); const targetSupportedLocale = locale.supported.find(({ languageTag }) => languageTag === newLanguageTag); assert(targetSupportedLocale !== undefined, `${newLanguageTag} need to be enabled in Keycloak admin`); return targetSupportedLocale.url; }, labelBySupportedLanguageTag: Object.fromEntries( (kcContext.locale?.supported ?? []).map(({ languageTag, label }) => [languageTag, label]) ) }); })(); }, []); return i18n ?? null; } return { useI18n, ofTypeI18n: Reflect>() }; } function createI18nTranslationFunctions(params: { fallbackMessages: Record; messages: Record; }): Pick, "msg" | "msgStr" | "advancedMsg" | "advancedMsgStr"> { const { fallbackMessages, messages } = params; function resolveMsg(props: { key: string; args: (string | undefined)[]; doRenderAsHtml: boolean }): string | JSX.Element | undefined { const { key, args, doRenderAsHtml } = props; const messageOrUndefined: string | undefined = (messages as any)[key] ?? (fallbackMessages as any)[key]; if (messageOrUndefined === undefined) { return undefined; } const message = messageOrUndefined; const messageWithArgsInjectedIfAny = (() => { const startIndex = message .match(/{[0-9]+}/g) ?.map(g => g.match(/{([0-9]+)}/)![1]) .map(indexStr => parseInt(indexStr)) .sort((a, b) => a - b)[0]; if (startIndex === undefined) { // No {0} in message (no arguments expected) return message; } let messageWithArgsInjected = message; args.forEach((arg, i) => { if (arg === undefined) { return; } messageWithArgsInjected = messageWithArgsInjected.replace( new RegExp(`\\{${i + startIndex}\\}`, "g"), arg.replace(//g, ">") ); }); return messageWithArgsInjected; })(); return doRenderAsHtml ? ( ) : ( messageWithArgsInjectedIfAny ); } function resolveMsgAdvanced(props: { key: string; args: (string | undefined)[]; doRenderAsHtml: boolean }): JSX.Element | string { const { key, args, doRenderAsHtml } = props; if (!/\$\{[^}]+\}/.test(key)) { const resolvedMessage = resolveMsg({ key, args, doRenderAsHtml }); if (resolvedMessage === undefined) { return doRenderAsHtml ? : key; } return resolvedMessage; } let isFirstMatch = true; const resolvedComplexMessage = key.replace(/\$\{([^}]+)\}/g, (...[, key_i]) => { const replaceBy = resolveMsg({ key: key_i, args: isFirstMatch ? args : [], doRenderAsHtml: false }) ?? key_i; isFirstMatch = false; return replaceBy; }); return doRenderAsHtml ? : resolvedComplexMessage; } return { msgStr: (key, ...args) => resolveMsg({ key, args, doRenderAsHtml: false }) as string, msg: (key, ...args) => resolveMsg({ key, args, doRenderAsHtml: true }) as JSX.Element, advancedMsg: (key, ...args) => resolveMsgAdvanced({ key, args, doRenderAsHtml: true }) as JSX.Element, advancedMsgStr: (key, ...args) => resolveMsgAdvanced({ key, args, doRenderAsHtml: false }) as string }; } const keycloakifyExtraMessages = { en: { shouldBeEqual: "{0} should be equal to {1}", shouldBeDifferent: "{0} should be different to {1}", shouldMatchPattern: "Pattern should match: `/{0}/`", mustBeAnInteger: "Must be an integer", notAValidOption: "Not a valid option", newPasswordSameAsOld: "New password must be different from the old one", passwordConfirmNotMatch: "Password confirmation does not match" }, fr: { /* spell-checker: disable */ shouldBeEqual: "{0} doit être égal à {1}", shouldBeDifferent: "{0} doit être différent de {1}", shouldMatchPattern: "Dois respecter le schéma: `/{0}/`", mustBeAnInteger: "Doit être un nombre entier", notAValidOption: "N'est pas une option valide", logoutConfirmTitle: "Déconnexion", logoutConfirmHeader: "Êtes-vous sûr(e) de vouloir vous déconnecter ?", doLogout: "Se déconnecter", newPasswordSameAsOld: "Le nouveau mot de passe doit être différent de l'ancien", passwordConfirmNotMatch: "La confirmation du mot de passe ne correspond pas" /* spell-checker: enable */ } };