@tramvai/module-i18n 7.21.0 → 7.26.8

package/lib/browser.js

@@ -1,6 +1,6 @@
 import { declareModule, provide } from '@tramvai/core';
 import { I18N_CONFIGURATION_TOKEN } from './tokens.browser.js';
-export { I18N_CONFIGURATION_TOKEN, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN } from './tokens.browser.js';
+export { I18N_CONFIGURATION_TOKEN, I18N_HOOKS_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN } from './tokens.browser.js';
 import { sharedProviders } from './shared/providers.browser.js';
 import { defaultConfiguration } from './shared/config.browser.js';
 export { I18nStore, setAvailableLanguages, setLanguage } from './shared/store.browser.js';

package/lib/server.es.js

@@ -1,6 +1,6 @@
 import { declareModule, provide } from '@tramvai/core';
 import { I18N_CONFIGURATION_TOKEN } from './tokens.es.js';
-export { I18N_CONFIGURATION_TOKEN, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN } from './tokens.es.js';
+export { I18N_CONFIGURATION_TOKEN, I18N_HOOKS_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN } from './tokens.es.js';
 import { sharedProviders } from './shared/providers.es.js';
 import { defaultConfiguration } from './shared/config.es.js';
 export { I18nStore, setAvailableLanguages, setLanguage } from './shared/store.es.js';

package/lib/server.js

@@ -29,6 +29,8 @@ const I18nModule = /* @__PURE__ */ core.declareModule({
 });
 
 exports.I18N_CONFIGURATION_TOKEN = tokens.I18N_CONFIGURATION_TOKEN;
+exports.I18N_HOOKS_TOKEN = tokens.I18N_HOOKS_TOKEN;
+exports.I18N_LANGUAGE_COOKIE_EXPIRES_VALUE = tokens.I18N_LANGUAGE_COOKIE_EXPIRES_VALUE;
 exports.I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN = tokens.I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN;
 exports.I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN = tokens.I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN;
 exports.I18N_RESOLVE_LANGUAGE_TOKEN = tokens.I18N_RESOLVE_LANGUAGE_TOKEN;

package/lib/shared/providers.browser.js

@@ -1,10 +1,12 @@
 import { provide, commandLineListTokens, DI_TOKEN } from '@tramvai/core';
-import { COMBINE_REDUCERS, STORE_TOKEN, REQUEST_MANAGER_TOKEN, LOGGER_TOKEN, ENV_MANAGER_TOKEN } from '@tramvai/tokens-common';
+import { COMBINE_REDUCERS, STORE_TOKEN, ENV_MANAGER_TOKEN, REQUEST_MANAGER_TOKEN, LOGGER_TOKEN } from '@tramvai/tokens-common';
 import { COOKIE_MANAGER_TOKEN } from '@tramvai/tokens-cookie';
-import { ROUTER_TOKEN, ROUTER_GUARD_TOKEN, ROUTER_PLUGIN } from '@tramvai/tokens-router';
+import { ROUTER_TOKEN, ROUTER_GUARD_TOKEN, ROUTER_PLUGIN, PAGE_SERVICE_TOKEN } from '@tramvai/tokens-router';
 import { USER_LANGUAGE_TOKEN } from '@tramvai/module-client-hints';
-import { HTML_ATTRS, RENDER_SLOTS, ResourceType, ResourceSlot } from '@tramvai/tokens-render';
-import { I18N_CONFIGURATION_TOKEN, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN } from '../tokens.browser.js';
+import { HTML_ATTRS } from '@tramvai/tokens-render';
+import { META_UPDATER_TOKEN, META_PRIORITY_ROUTE } from '@tramvai/module-seo';
+import { TAPABLE_HOOK_FACTORY_TOKEN } from '@tramvai/tokens-core';
+import { I18N_CONFIGURATION_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_HOOKS_TOKEN } from '../tokens.browser.js';
 import { I18nStore, setAvailableLanguages, setLanguage } from './store.browser.js';
 import { I18nServiceImpl } from './service.browser.js';
 import { defaultConfiguration } from './config.browser.js';
@@ -19,13 +21,24 @@ const sharedProviders = [
         provide: COMBINE_REDUCERS,
         useValue: [I18nStore],
     }),
+    provide({
+        provide: I18N_LANGUAGE_COOKIE_EXPIRES_VALUE,
+        useValue: 7 * 24 * 60 * 60,
+    }),
     provide({
         provide: I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN,
-        useFactory: ({ config }) => {
-            // TODO: sync with state from server if SSR?
+        useFactory: ({ config, store, envManager }) => {
+            // At client-side, for SSR mode, we can resolve available languages from server state
+            if (typeof window !== 'undefined' &&
+                envManager.get('TRAMVAI_FORCE_CLIENT_SIDE_RENDERING') !== 'true') {
+                const { availableLanguages } = store.getState(I18nStore);
+                return async () => availableLanguages;
+            }
             return async () => config.availableLanguages ?? [config.defaultLanguage];
         },
         deps: {
+            store: STORE_TOKEN,
+            envManager: ENV_MANAGER_TOKEN,
             config: I18N_CONFIGURATION_TOKEN,
         },
     }),
@@ -39,6 +52,7 @@ const sharedProviders = [
             router: ROUTER_TOKEN,
             requestManager: REQUEST_MANAGER_TOKEN,
             logger: LOGGER_TOKEN,
+            languageCookieExpiresValue: I18N_LANGUAGE_COOKIE_EXPIRES_VALUE,
         },
     }),
     // Language from cookie has higher priority
@@ -174,11 +188,7 @@ const sharedProviders = [
                             store.dispatch(setLanguage(language));
                             if (!cookieManager.get(config.cookieName)) {
                                 log.info(`${config.cookieName} cookie is not found, save resolved "${language.language}" language to cookie`);
-                                cookieManager.set({
-                                    name: config.cookieName,
-                                    value: language.language,
-                                    // TODO valid params!
-                                });
+                                i18n.setLanguageToCookie(language.language);
                             }
                             const currentUrl = router.getCurrentUrl() ?? requestManager.getParsedUrl();
                             const languageFromUrl = i18n.getLanguageFromUrl(currentUrl);
@@ -295,6 +305,17 @@ const sharedProviders = [
             store: STORE_TOKEN,
         },
     }),
+    provide({
+        provide: I18N_HOOKS_TOKEN,
+        useFactory: ({ tapableHookFactory }) => {
+            return {
+                'i18n:get-alternate-languages': tapableHookFactory.createSync('i18n:get-alternate-languages'),
+            };
+        },
+        deps: {
+            tapableHookFactory: TAPABLE_HOOK_FACTORY_TOKEN,
+        },
+    }),
     provide({
         provide: HTML_ATTRS,
         useFactory: ({ i18n }) => {
@@ -310,24 +331,39 @@ const sharedProviders = [
         },
     }),
     provide({
-        provide: RENDER_SLOTS,
-        multi: true,
-        useFactory: ({ i18n, requestManager }) => {
-            const parsedUrl = requestManager.getParsedUrl();
-            const url = `${parsedUrl.origin}${parsedUrl.pathname}`;
-            // TODO: dynamic list of available languages for specific route to generate alternate links
-            // TODO: `x-default` link?
-            return [
-                {
-                    type: ResourceType.asIs,
-                    slot: ResourceSlot.HEAD_META,
-                    payload: `<link rel="alternate" hreflang="${i18n.getLanguage()}" href="${url}" />`,
-                },
-            ];
+        provide: META_UPDATER_TOKEN,
+        useFactory: ({ pageService, i18n, requestManager, i18nHooks }) => {
+            return (meta) => {
+                const parsedUrl = requestManager.getParsedUrl();
+                const routeConfig = pageService.getConfig() || {};
+                const urlWithoutLanguage = i18n.removeLanguageFromUrl(parsedUrl);
+                const baseAvailableLanguages = i18n.getAvailableLanguages();
+                const alternateLanguages = i18nHooks['i18n:get-alternate-languages'].call({
+                    availableLanguages: baseAvailableLanguages,
+                    routeConfig,
+                }) ?? baseAvailableLanguages;
+                const tags = alternateLanguages.reduce((result, languageCode) => {
+                    const { pathname } = i18n.addLanguageToUrl(urlWithoutLanguage, languageCode);
+                    //@ts-expect-error
+                    result[`i18nAlternate_${languageCode}`] = {
+                        tag: 'link',
+                        attributes: {
+                            rel: 'alternate',
+                            hreflang: languageCode,
+                            href: `${parsedUrl.origin}${pathname}${parsedUrl.search}${parsedUrl.hash}`,
+                        },
+                    };
+                    return result;
+                }, {});
+                meta.updateMeta(META_PRIORITY_ROUTE, tags);
+            };
         },
         deps: {
-            i18n: I18N_TOKEN,
+            pageService: PAGE_SERVICE_TOKEN,
+            i18nHooks: I18N_HOOKS_TOKEN,
             requestManager: REQUEST_MANAGER_TOKEN,
+            i18nConfiguration: I18N_CONFIGURATION_TOKEN,
+            i18n: I18N_TOKEN,
         },
     }),
 ];

package/lib/shared/providers.d.ts

@@ -1,10 +1,22 @@
 export declare const sharedProviders: (import("@tinkoff/dippy/lib/Provider").ValueProvider<any> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithDeps<unknown, any> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithoutDeps<any> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithDeps<unknown, any> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithoutDeps<any> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithDeps<{
+    store: import("@tramvai/tokens-common").Store<Record<string, any>> & {
+        __type?: "base token" | undefined;
+    };
+    envManager: import("@tramvai/tokens-common").EnvironmentManager & {
+        __type?: "base token" | undefined;
+    };
     config: import("../types").I18nConfiguration & {
         __type?: "base token" | undefined;
     };
 }, (() => Promise<string[]>) & {
     __type?: "base token" | undefined;
 }> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithDeps<{
+    store: import("@tramvai/tokens-common").Store<Record<string, any>> & {
+        __type?: "base token" | undefined;
+    };
+    envManager: import("@tramvai/tokens-common").EnvironmentManager & {
+        __type?: "base token" | undefined;
+    };
     config: import("../types").I18nConfiguration & {
         __type?: "base token" | undefined;
     };
@@ -32,6 +44,9 @@ export declare const sharedProviders: (import("@tinkoff/dippy/lib/Provider").Val
     }) => import("@tramvai/tokens-common").Logger) & {
         __type?: "base token" | undefined;
     };
+    languageCookieExpiresValue: number & {
+        __type?: "base token" | undefined;
+    };
 }, import("../types").I18nService & {
     __type?: "base token" | undefined;
 }> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithDeps<{
@@ -56,6 +71,9 @@ export declare const sharedProviders: (import("@tinkoff/dippy/lib/Provider").Val
     }) => import("@tramvai/tokens-common").Logger) & {
         __type?: "base token" | undefined;
     };
+    languageCookieExpiresValue: number & {
+        __type?: "base token" | undefined;
+    };
 }, import("../types").I18nService & {
     __type?: "base token" | undefined;
 }> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithDeps<{
@@ -290,6 +308,18 @@ export declare const sharedProviders: (import("@tinkoff/dippy/lib/Provider").Val
     };
 }, import("@tinkoff/router").RouterPlugin & {
     __type?: "multi token" | undefined;
+}> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithDeps<{
+    tapableHookFactory: import("@tramvai/core").TapableHooks & {
+        __type?: "base token" | undefined;
+    };
+}, import("../types").I18nHooks & {
+    __type?: "base token" | undefined;
+}> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithDeps<{
+    tapableHookFactory: import("@tramvai/core").TapableHooks & {
+        __type?: "base token" | undefined;
+    };
+}, import("../types").I18nHooks & {
+    __type?: "base token" | undefined;
 }> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithDeps<{
     i18n: import("../types").I18nService & {
         __type?: "base token" | undefined;
@@ -303,26 +333,40 @@ export declare const sharedProviders: (import("@tinkoff/dippy/lib/Provider").Val
 }, import("@tramvai/tokens-render").HtmlAttrs & {
     __type?: "multi token" | undefined;
 }> | import("@tinkoff/dippy/lib/Provider").ClassProviderWithDeps<{
-    i18n: import("../types").I18nService & {
+    pageService: import("@tramvai/tokens-router").PageService & {
+        __type?: "base token" | undefined;
+    };
+    i18nHooks: import("../types").I18nHooks & {
         __type?: "base token" | undefined;
     };
     requestManager: import("@tramvai/tokens-common").RequestManager & {
         __type?: "base token" | undefined;
     };
-}, (import("@tramvai/tokens-render").PageResource & {
-    __type?: "multi token" | undefined;
-}) | (import("@tramvai/tokens-render").PageResource[] & {
-    __type?: "multi token" | undefined;
-})> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithDeps<{
+    i18nConfiguration: import("../types").I18nConfiguration & {
+        __type?: "base token" | undefined;
+    };
     i18n: import("../types").I18nService & {
         __type?: "base token" | undefined;
     };
+}, ((walker: import("@tinkoff/meta-tags-generate").MetaWalk, ...args: any[]) => void) & {
+    __type?: "multi token" | undefined;
+}> | import("@tinkoff/dippy/lib/Provider").FactoryProviderWithDeps<{
+    pageService: import("@tramvai/tokens-router").PageService & {
+        __type?: "base token" | undefined;
+    };
+    i18nHooks: import("../types").I18nHooks & {
+        __type?: "base token" | undefined;
+    };
     requestManager: import("@tramvai/tokens-common").RequestManager & {
         __type?: "base token" | undefined;
     };
-}, (import("@tramvai/tokens-render").PageResource & {
-    __type?: "multi token" | undefined;
-}) | (import("@tramvai/tokens-render").PageResource[] & {
+    i18nConfiguration: import("../types").I18nConfiguration & {
+        __type?: "base token" | undefined;
+    };
+    i18n: import("../types").I18nService & {
+        __type?: "base token" | undefined;
+    };
+}, ((walker: import("@tinkoff/meta-tags-generate").MetaWalk, ...args: any[]) => void) & {
     __type?: "multi token" | undefined;
-})>)[];
+}>)[];
 //# sourceMappingURL=providers.d.ts.map

package/lib/shared/providers.es.js

@@ -1,10 +1,12 @@
 import { provide, commandLineListTokens, DI_TOKEN } from '@tramvai/core';
-import { COMBINE_REDUCERS, STORE_TOKEN, REQUEST_MANAGER_TOKEN, LOGGER_TOKEN, ENV_MANAGER_TOKEN } from '@tramvai/tokens-common';
+import { COMBINE_REDUCERS, STORE_TOKEN, ENV_MANAGER_TOKEN, REQUEST_MANAGER_TOKEN, LOGGER_TOKEN } from '@tramvai/tokens-common';
 import { COOKIE_MANAGER_TOKEN } from '@tramvai/tokens-cookie';
-import { ROUTER_TOKEN, ROUTER_GUARD_TOKEN, ROUTER_PLUGIN } from '@tramvai/tokens-router';
+import { ROUTER_TOKEN, ROUTER_GUARD_TOKEN, ROUTER_PLUGIN, PAGE_SERVICE_TOKEN } from '@tramvai/tokens-router';
 import { USER_LANGUAGE_TOKEN } from '@tramvai/module-client-hints';
-import { HTML_ATTRS, RENDER_SLOTS, ResourceType, ResourceSlot } from '@tramvai/tokens-render';
-import { I18N_CONFIGURATION_TOKEN, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN } from '../tokens.es.js';
+import { HTML_ATTRS } from '@tramvai/tokens-render';
+import { META_UPDATER_TOKEN, META_PRIORITY_ROUTE } from '@tramvai/module-seo';
+import { TAPABLE_HOOK_FACTORY_TOKEN } from '@tramvai/tokens-core';
+import { I18N_CONFIGURATION_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_HOOKS_TOKEN } from '../tokens.es.js';
 import { I18nStore, setAvailableLanguages, setLanguage } from './store.es.js';
 import { I18nServiceImpl } from './service.es.js';
 import { defaultConfiguration } from './config.es.js';
@@ -19,13 +21,24 @@ const sharedProviders = [
         provide: COMBINE_REDUCERS,
         useValue: [I18nStore],
     }),
+    provide({
+        provide: I18N_LANGUAGE_COOKIE_EXPIRES_VALUE,
+        useValue: 7 * 24 * 60 * 60,
+    }),
     provide({
         provide: I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN,
-        useFactory: ({ config }) => {
-            // TODO: sync with state from server if SSR?
+        useFactory: ({ config, store, envManager }) => {
+            // At client-side, for SSR mode, we can resolve available languages from server state
+            if (typeof window !== 'undefined' &&
+                envManager.get('TRAMVAI_FORCE_CLIENT_SIDE_RENDERING') !== 'true') {
+                const { availableLanguages } = store.getState(I18nStore);
+                return async () => availableLanguages;
+            }
             return async () => config.availableLanguages ?? [config.defaultLanguage];
         },
         deps: {
+            store: STORE_TOKEN,
+            envManager: ENV_MANAGER_TOKEN,
             config: I18N_CONFIGURATION_TOKEN,
         },
     }),
@@ -39,6 +52,7 @@ const sharedProviders = [
             router: ROUTER_TOKEN,
             requestManager: REQUEST_MANAGER_TOKEN,
             logger: LOGGER_TOKEN,
+            languageCookieExpiresValue: I18N_LANGUAGE_COOKIE_EXPIRES_VALUE,
         },
     }),
     // Language from cookie has higher priority
@@ -174,11 +188,7 @@ const sharedProviders = [
                             store.dispatch(setLanguage(language));
                             if (!cookieManager.get(config.cookieName)) {
                                 log.info(`${config.cookieName} cookie is not found, save resolved "${language.language}" language to cookie`);
-                                cookieManager.set({
-                                    name: config.cookieName,
-                                    value: language.language,
-                                    // TODO valid params!
-                                });
+                                i18n.setLanguageToCookie(language.language);
                             }
                             const currentUrl = router.getCurrentUrl() ?? requestManager.getParsedUrl();
                             const languageFromUrl = i18n.getLanguageFromUrl(currentUrl);
@@ -295,6 +305,17 @@ const sharedProviders = [
             store: STORE_TOKEN,
         },
     }),
+    provide({
+        provide: I18N_HOOKS_TOKEN,
+        useFactory: ({ tapableHookFactory }) => {
+            return {
+                'i18n:get-alternate-languages': tapableHookFactory.createSync('i18n:get-alternate-languages'),
+            };
+        },
+        deps: {
+            tapableHookFactory: TAPABLE_HOOK_FACTORY_TOKEN,
+        },
+    }),
     provide({
         provide: HTML_ATTRS,
         useFactory: ({ i18n }) => {
@@ -310,24 +331,39 @@ const sharedProviders = [
         },
     }),
     provide({
-        provide: RENDER_SLOTS,
-        multi: true,
-        useFactory: ({ i18n, requestManager }) => {
-            const parsedUrl = requestManager.getParsedUrl();
-            const url = `${parsedUrl.origin}${parsedUrl.pathname}`;
-            // TODO: dynamic list of available languages for specific route to generate alternate links
-            // TODO: `x-default` link?
-            return [
-                {
-                    type: ResourceType.asIs,
-                    slot: ResourceSlot.HEAD_META,
-                    payload: `<link rel="alternate" hreflang="${i18n.getLanguage()}" href="${url}" />`,
-                },
-            ];
+        provide: META_UPDATER_TOKEN,
+        useFactory: ({ pageService, i18n, requestManager, i18nHooks }) => {
+            return (meta) => {
+                const parsedUrl = requestManager.getParsedUrl();
+                const routeConfig = pageService.getConfig() || {};
+                const urlWithoutLanguage = i18n.removeLanguageFromUrl(parsedUrl);
+                const baseAvailableLanguages = i18n.getAvailableLanguages();
+                const alternateLanguages = i18nHooks['i18n:get-alternate-languages'].call({
+                    availableLanguages: baseAvailableLanguages,
+                    routeConfig,
+                }) ?? baseAvailableLanguages;
+                const tags = alternateLanguages.reduce((result, languageCode) => {
+                    const { pathname } = i18n.addLanguageToUrl(urlWithoutLanguage, languageCode);
+                    //@ts-expect-error
+                    result[`i18nAlternate_${languageCode}`] = {
+                        tag: 'link',
+                        attributes: {
+                            rel: 'alternate',
+                            hreflang: languageCode,
+                            href: `${parsedUrl.origin}${pathname}${parsedUrl.search}${parsedUrl.hash}`,
+                        },
+                    };
+                    return result;
+                }, {});
+                meta.updateMeta(META_PRIORITY_ROUTE, tags);
+            };
         },
         deps: {
-            i18n: I18N_TOKEN,
+            pageService: PAGE_SERVICE_TOKEN,
+            i18nHooks: I18N_HOOKS_TOKEN,
             requestManager: REQUEST_MANAGER_TOKEN,
+            i18nConfiguration: I18N_CONFIGURATION_TOKEN,
+            i18n: I18N_TOKEN,
         },
     }),
 ];

package/lib/shared/providers.js

@@ -8,6 +8,8 @@ var tokensCookie = require('@tramvai/tokens-cookie');
 var tokensRouter = require('@tramvai/tokens-router');
 var moduleClientHints = require('@tramvai/module-client-hints');
 var tokensRender = require('@tramvai/tokens-render');
+var moduleSeo = require('@tramvai/module-seo');
+var tokensCore = require('@tramvai/tokens-core');
 var tokens = require('../tokens.js');
 var store = require('./store.js');
 var service = require('./service.js');
@@ -23,13 +25,24 @@ const sharedProviders = [
         provide: tokensCommon.COMBINE_REDUCERS,
         useValue: [store.I18nStore],
     }),
+    core.provide({
+        provide: tokens.I18N_LANGUAGE_COOKIE_EXPIRES_VALUE,
+        useValue: 7 * 24 * 60 * 60,
+    }),
     core.provide({
         provide: tokens.I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN,
-        useFactory: ({ config }) => {
-            // TODO: sync with state from server if SSR?
+        useFactory: ({ config, store: store$1, envManager }) => {
+            // At client-side, for SSR mode, we can resolve available languages from server state
+            if (typeof window !== 'undefined' &&
+                envManager.get('TRAMVAI_FORCE_CLIENT_SIDE_RENDERING') !== 'true') {
+                const { availableLanguages } = store$1.getState(store.I18nStore);
+                return async () => availableLanguages;
+            }
             return async () => config.availableLanguages ?? [config.defaultLanguage];
         },
         deps: {
+            store: tokensCommon.STORE_TOKEN,
+            envManager: tokensCommon.ENV_MANAGER_TOKEN,
             config: tokens.I18N_CONFIGURATION_TOKEN,
         },
     }),
@@ -43,6 +56,7 @@ const sharedProviders = [
             router: tokensRouter.ROUTER_TOKEN,
             requestManager: tokensCommon.REQUEST_MANAGER_TOKEN,
             logger: tokensCommon.LOGGER_TOKEN,
+            languageCookieExpiresValue: tokens.I18N_LANGUAGE_COOKIE_EXPIRES_VALUE,
         },
     }),
     // Language from cookie has higher priority
@@ -178,11 +192,7 @@ const sharedProviders = [
                             store$1.dispatch(store.setLanguage(language));
                             if (!cookieManager.get(config.cookieName)) {
                                 log.info(`${config.cookieName} cookie is not found, save resolved "${language.language}" language to cookie`);
-                                cookieManager.set({
-                                    name: config.cookieName,
-                                    value: language.language,
-                                    // TODO valid params!
-                                });
+                                i18n.setLanguageToCookie(language.language);
                             }
                             const currentUrl = router.getCurrentUrl() ?? requestManager.getParsedUrl();
                             const languageFromUrl = i18n.getLanguageFromUrl(currentUrl);
@@ -299,6 +309,17 @@ const sharedProviders = [
             store: tokensCommon.STORE_TOKEN,
         },
     }),
+    core.provide({
+        provide: tokens.I18N_HOOKS_TOKEN,
+        useFactory: ({ tapableHookFactory }) => {
+            return {
+                'i18n:get-alternate-languages': tapableHookFactory.createSync('i18n:get-alternate-languages'),
+            };
+        },
+        deps: {
+            tapableHookFactory: tokensCore.TAPABLE_HOOK_FACTORY_TOKEN,
+        },
+    }),
     core.provide({
         provide: tokensRender.HTML_ATTRS,
         useFactory: ({ i18n }) => {
@@ -314,24 +335,39 @@ const sharedProviders = [
         },
     }),
     core.provide({
-        provide: tokensRender.RENDER_SLOTS,
-        multi: true,
-        useFactory: ({ i18n, requestManager }) => {
-            const parsedUrl = requestManager.getParsedUrl();
-            const url = `${parsedUrl.origin}${parsedUrl.pathname}`;
-            // TODO: dynamic list of available languages for specific route to generate alternate links
-            // TODO: `x-default` link?
-            return [
-                {
-                    type: tokensRender.ResourceType.asIs,
-                    slot: tokensRender.ResourceSlot.HEAD_META,
-                    payload: `<link rel="alternate" hreflang="${i18n.getLanguage()}" href="${url}" />`,
-                },
-            ];
+        provide: moduleSeo.META_UPDATER_TOKEN,
+        useFactory: ({ pageService, i18n, requestManager, i18nHooks }) => {
+            return (meta) => {
+                const parsedUrl = requestManager.getParsedUrl();
+                const routeConfig = pageService.getConfig() || {};
+                const urlWithoutLanguage = i18n.removeLanguageFromUrl(parsedUrl);
+                const baseAvailableLanguages = i18n.getAvailableLanguages();
+                const alternateLanguages = i18nHooks['i18n:get-alternate-languages'].call({
+                    availableLanguages: baseAvailableLanguages,
+                    routeConfig,
+                }) ?? baseAvailableLanguages;
+                const tags = alternateLanguages.reduce((result, languageCode) => {
+                    const { pathname } = i18n.addLanguageToUrl(urlWithoutLanguage, languageCode);
+                    //@ts-expect-error
+                    result[`i18nAlternate_${languageCode}`] = {
+                        tag: 'link',
+                        attributes: {
+                            rel: 'alternate',
+                            hreflang: languageCode,
+                            href: `${parsedUrl.origin}${pathname}${parsedUrl.search}${parsedUrl.hash}`,
+                        },
+                    };
+                    return result;
+                }, {});
+                meta.updateMeta(moduleSeo.META_PRIORITY_ROUTE, tags);
+            };
         },
         deps: {
-            i18n: tokens.I18N_TOKEN,
+            pageService: tokensRouter.PAGE_SERVICE_TOKEN,
+            i18nHooks: tokens.I18N_HOOKS_TOKEN,
             requestManager: tokensCommon.REQUEST_MANAGER_TOKEN,
+            i18nConfiguration: tokens.I18N_CONFIGURATION_TOKEN,
+            i18n: tokens.I18N_TOKEN,
         },
     }),
 ];

package/lib/shared/service.browser.js

@@ -9,6 +9,7 @@ class I18nServiceImpl {
     router;
     requestManager;
     log;
+    languageCookieExpiresValue;
     constructor(deps) {
         this.store = deps.store;
         this.config = deps.config;
@@ -16,6 +17,7 @@ class I18nServiceImpl {
         this.router = deps.router;
         this.requestManager = deps.requestManager;
         this.log = deps.logger('i18n');
+        this.languageCookieExpiresValue = deps.languageCookieExpiresValue;
     }
     getLanguage() {
         const state = this.store.getState(I18nStore);
@@ -25,20 +27,26 @@ class I18nServiceImpl {
         const state = this.store.getState(I18nStore);
         return state.availableLanguages;
     }
+    setLanguageToCookie(language, expires) {
+        this.cookieManager.set({
+            name: this.config.cookieName,
+            value: language,
+            expires: expires ?? this.languageCookieExpiresValue,
+        });
+    }
     // eslint-disable-next-line max-statements
-    async switchLanguage(language) {
+    async switchLanguage(switchToLanguage) {
         const availableLanguages = this.getAvailableLanguages();
+        const language = switchToLanguage;
         if (!availableLanguages.includes(language)) {
-            // TODO: is throwing an error is a best solution?
-            throw new Error(`Language "${language}" is not available. Available languages: ${availableLanguages.join(', ')}`);
+            this.log.info(`Language ${language} is not in availableLanguages list. Available languages is ${availableLanguages}`);
+            return;
         }
         this.log.info(`Switch language to "${language}"`);
         const { cookieName, routingStrategy, updateStrategy } = this.config;
-        this.cookieManager.set({
-            name: cookieName,
-            value: language,
-            // TODO valid params!
-        });
+        if (this.cookieManager.get(cookieName) !== language) {
+            this.setLanguageToCookie(language);
+        }
         const currentUrl = this.router.getCurrentUrl() ?? this.requestManager.getUrl();
         const parsedUrl = typeof currentUrl === 'string' ? parse(currentUrl) : currentUrl;
         const currentLanguage = this.getLanguage();

package/lib/shared/service.d.ts

@@ -4,7 +4,7 @@ import { LOGGER_TOKEN, REQUEST_MANAGER_TOKEN, STORE_TOKEN } from '@tramvai/token
 import { ROUTER_TOKEN } from '@tramvai/tokens-router';
 import { Url } from '@tinkoff/url';
 import type { I18nService, Language } from '../types';
-import { I18N_CONFIGURATION_TOKEN } from '../tokens';
+import { I18N_CONFIGURATION_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE } from '../tokens';
 type Deps = {
     store: ExtractDependencyType<typeof STORE_TOKEN>;
     config: ExtractDependencyType<typeof I18N_CONFIGURATION_TOKEN>;
@@ -12,6 +12,7 @@ type Deps = {
     router: ExtractDependencyType<typeof ROUTER_TOKEN>;
     requestManager: ExtractDependencyType<typeof REQUEST_MANAGER_TOKEN>;
     logger: ExtractDependencyType<typeof LOGGER_TOKEN>;
+    languageCookieExpiresValue: ExtractDependencyType<typeof I18N_LANGUAGE_COOKIE_EXPIRES_VALUE>;
 };
 export declare class I18nServiceImpl implements I18nService {
     private store;
@@ -20,10 +21,12 @@ export declare class I18nServiceImpl implements I18nService {
     private router;
     private requestManager;
     private log;
+    private languageCookieExpiresValue;
     constructor(deps: Deps);
     getLanguage(): Language;
     getAvailableLanguages(): Language[];
-    switchLanguage(language: Language): Promise<void>;
+    setLanguageToCookie(language: string, expires?: number): void;
+    switchLanguage(switchToLanguage: Language): Promise<void>;
     getLanguageFromUrl(url: string | Url): Language | null;
     removeLanguageFromUrl(url: string | Url): Url;
     addLanguageToUrl(url: string | Url, lang: Language): Url;

package/lib/shared/service.es.js

@@ -9,6 +9,7 @@ class I18nServiceImpl {
     router;
     requestManager;
     log;
+    languageCookieExpiresValue;
     constructor(deps) {
         this.store = deps.store;
         this.config = deps.config;
@@ -16,6 +17,7 @@ class I18nServiceImpl {
         this.router = deps.router;
         this.requestManager = deps.requestManager;
         this.log = deps.logger('i18n');
+        this.languageCookieExpiresValue = deps.languageCookieExpiresValue;
     }
     getLanguage() {
         const state = this.store.getState(I18nStore);
@@ -25,20 +27,26 @@ class I18nServiceImpl {
         const state = this.store.getState(I18nStore);
         return state.availableLanguages;
     }
+    setLanguageToCookie(language, expires) {
+        this.cookieManager.set({
+            name: this.config.cookieName,
+            value: language,
+            expires: expires ?? this.languageCookieExpiresValue,
+        });
+    }
     // eslint-disable-next-line max-statements
-    async switchLanguage(language) {
+    async switchLanguage(switchToLanguage) {
         const availableLanguages = this.getAvailableLanguages();
+        const language = switchToLanguage;
         if (!availableLanguages.includes(language)) {
-            // TODO: is throwing an error is a best solution?
-            throw new Error(`Language "${language}" is not available. Available languages: ${availableLanguages.join(', ')}`);
+            this.log.info(`Language ${language} is not in availableLanguages list. Available languages is ${availableLanguages}`);
+            return;
         }
         this.log.info(`Switch language to "${language}"`);
         const { cookieName, routingStrategy, updateStrategy } = this.config;
-        this.cookieManager.set({
-            name: cookieName,
-            value: language,
-            // TODO valid params!
-        });
+        if (this.cookieManager.get(cookieName) !== language) {
+            this.setLanguageToCookie(language);
+        }
         const currentUrl = this.router.getCurrentUrl() ?? this.requestManager.getUrl();
         const parsedUrl = typeof currentUrl === 'string' ? parse(currentUrl) : currentUrl;
         const currentLanguage = this.getLanguage();

package/lib/shared/service.js

@@ -13,6 +13,7 @@ class I18nServiceImpl {
     router;
     requestManager;
     log;
+    languageCookieExpiresValue;
     constructor(deps) {
         this.store = deps.store;
         this.config = deps.config;
@@ -20,6 +21,7 @@ class I18nServiceImpl {
         this.router = deps.router;
         this.requestManager = deps.requestManager;
         this.log = deps.logger('i18n');
+        this.languageCookieExpiresValue = deps.languageCookieExpiresValue;
     }
     getLanguage() {
         const state = this.store.getState(store.I18nStore);
@@ -29,20 +31,26 @@ class I18nServiceImpl {
         const state = this.store.getState(store.I18nStore);
         return state.availableLanguages;
     }
+    setLanguageToCookie(language, expires) {
+        this.cookieManager.set({
+            name: this.config.cookieName,
+            value: language,
+            expires: expires ?? this.languageCookieExpiresValue,
+        });
+    }
     // eslint-disable-next-line max-statements
-    async switchLanguage(language) {
+    async switchLanguage(switchToLanguage) {
         const availableLanguages = this.getAvailableLanguages();
+        const language = switchToLanguage;
         if (!availableLanguages.includes(language)) {
-            // TODO: is throwing an error is a best solution?
-            throw new Error(`Language "${language}" is not available. Available languages: ${availableLanguages.join(', ')}`);
+            this.log.info(`Language ${language} is not in availableLanguages list. Available languages is ${availableLanguages}`);
+            return;
         }
         this.log.info(`Switch language to "${language}"`);
         const { cookieName, routingStrategy, updateStrategy } = this.config;
-        this.cookieManager.set({
-            name: cookieName,
-            value: language,
-            // TODO valid params!
-        });
+        if (this.cookieManager.get(cookieName) !== language) {
+            this.setLanguageToCookie(language);
+        }
         const currentUrl = this.router.getCurrentUrl() ?? this.requestManager.getUrl();
         const parsedUrl = typeof currentUrl === 'string' ? url.parse(currentUrl) : currentUrl;
         const currentLanguage = this.getLanguage();

package/lib/tokens.browser.js

@@ -2,8 +2,12 @@ import { createToken, Scope } from '@tramvai/core';
 
 const I18N_CONFIGURATION_TOKEN = createToken('tramvai i18n configuration', { scope: Scope.SINGLETON });
 const I18N_TOKEN = createToken('tramvai i18n service');
+const I18N_LANGUAGE_COOKIE_EXPIRES_VALUE = createToken('tramvai i18n language cookie expires value');
+const I18N_HOOKS_TOKEN = createToken('tramvai i18n tapable hooks', {
+    scope: Scope.REQUEST,
+});
 const I18N_RESOLVE_LANGUAGE_TOKEN = createToken('tramvai i18n resolve language');
 const I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN = createToken('tramvai i18n resolve language source', { multi: true });
 const I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN = createToken('tramvai i18n resolve available languages');
 
-export { I18N_CONFIGURATION_TOKEN, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN };
+export { I18N_CONFIGURATION_TOKEN, I18N_HOOKS_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN };

package/lib/tokens.d.ts

@@ -1,10 +1,16 @@
-import type { I18nConfiguration, I18nService, Language } from './types';
+import type { I18nConfiguration, I18nHooks, I18nService, Language } from './types';
 export declare const I18N_CONFIGURATION_TOKEN: I18nConfiguration & {
     __type?: "base token" | undefined;
 };
 export declare const I18N_TOKEN: I18nService & {
     __type?: "base token" | undefined;
 };
+export declare const I18N_LANGUAGE_COOKIE_EXPIRES_VALUE: number & {
+    __type?: "base token" | undefined;
+};
+export declare const I18N_HOOKS_TOKEN: I18nHooks & {
+    __type?: "base token" | undefined;
+};
 export declare const I18N_RESOLVE_LANGUAGE_TOKEN: (() => Promise<{
     language: Language;
     source: string;

package/lib/tokens.es.js

@@ -2,8 +2,12 @@ import { createToken, Scope } from '@tramvai/core';
 
 const I18N_CONFIGURATION_TOKEN = createToken('tramvai i18n configuration', { scope: Scope.SINGLETON });
 const I18N_TOKEN = createToken('tramvai i18n service');
+const I18N_LANGUAGE_COOKIE_EXPIRES_VALUE = createToken('tramvai i18n language cookie expires value');
+const I18N_HOOKS_TOKEN = createToken('tramvai i18n tapable hooks', {
+    scope: Scope.REQUEST,
+});
 const I18N_RESOLVE_LANGUAGE_TOKEN = createToken('tramvai i18n resolve language');
 const I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN = createToken('tramvai i18n resolve language source', { multi: true });
 const I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN = createToken('tramvai i18n resolve available languages');
 
-export { I18N_CONFIGURATION_TOKEN, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN };
+export { I18N_CONFIGURATION_TOKEN, I18N_HOOKS_TOKEN, I18N_LANGUAGE_COOKIE_EXPIRES_VALUE, I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN, I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN, I18N_RESOLVE_LANGUAGE_TOKEN, I18N_TOKEN };

package/lib/tokens.js

@@ -6,11 +6,17 @@ var core = require('@tramvai/core');
 
 const I18N_CONFIGURATION_TOKEN = core.createToken('tramvai i18n configuration', { scope: core.Scope.SINGLETON });
 const I18N_TOKEN = core.createToken('tramvai i18n service');
+const I18N_LANGUAGE_COOKIE_EXPIRES_VALUE = core.createToken('tramvai i18n language cookie expires value');
+const I18N_HOOKS_TOKEN = core.createToken('tramvai i18n tapable hooks', {
+    scope: core.Scope.REQUEST,
+});
 const I18N_RESOLVE_LANGUAGE_TOKEN = core.createToken('tramvai i18n resolve language');
 const I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN = core.createToken('tramvai i18n resolve language source', { multi: true });
 const I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN = core.createToken('tramvai i18n resolve available languages');
 
 exports.I18N_CONFIGURATION_TOKEN = I18N_CONFIGURATION_TOKEN;
+exports.I18N_HOOKS_TOKEN = I18N_HOOKS_TOKEN;
+exports.I18N_LANGUAGE_COOKIE_EXPIRES_VALUE = I18N_LANGUAGE_COOKIE_EXPIRES_VALUE;
 exports.I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN = I18N_RESOLVE_AVAILABLE_LANGUAGES_TOKEN;
 exports.I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN = I18N_RESOLVE_LANGUAGE_SOURCE_TOKEN;
 exports.I18N_RESOLVE_LANGUAGE_TOKEN = I18N_RESOLVE_LANGUAGE_TOKEN;

package/lib/types.d.ts

@@ -1,3 +1,5 @@
+import { SyncTapableHookInstance } from '@tinkoff/hook-runner';
+import type { RouteConfig } from '@tinkoff/router';
 import { Url } from '@tinkoff/url';
 /**
  * Language code in ISO 639-1 format (e.g., 'en', 'ru', 'zh')
@@ -68,5 +70,12 @@ export interface I18nService {
     switchLanguage(language: Language): Promise<void>;
     removeLanguageFromUrl(url: string | Url): Url;
     addLanguageToUrl(url: string | Url, language: Language): Url;
+    setLanguageToCookie(language: string, expires?: number): void;
 }
+export type I18nHooks = {
+    'i18n:get-alternate-languages': SyncTapableHookInstance<{
+        availableLanguages: string[];
+        routeConfig: RouteConfig;
+    }, Language[]>;
+};
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tramvai/module-i18n",
-  "version": "7.21.0",
+  "version": "7.26.8",
   "description": "Internationalization (i18n) module for Tramvai",
   "main": "lib/server.js",
   "module": "lib/server.es.js",
@@ -18,21 +18,27 @@
     "build": "tramvai-build --forPublish --preserveModules",
     "watch": "tsc -w"
   },
+  "devDependencies": {
+    "@tinkoff/hook-runner": "0.9.1"
+  },
   "dependencies": {
     "@tinkoff/errors": "0.8.1",
     "@tinkoff/url": "0.13.1",
-    "@tramvai/module-client-hints": "7.21.0",
-    "@tramvai/tokens-common": "7.21.0",
-    "@tramvai/tokens-cookie": "7.21.0",
-    "@tramvai/tokens-render": "7.21.0",
-    "@tramvai/tokens-router": "7.21.0"
+    "@tramvai/module-client-hints": "7.26.8",
+    "@tramvai/module-seo": "7.26.8",
+    "@tramvai/tokens-common": "7.26.8",
+    "@tramvai/tokens-cookie": "7.26.8",
+    "@tramvai/tokens-core": "7.26.8",
+    "@tramvai/tokens-render": "7.26.8",
+    "@tramvai/tokens-router": "7.26.8"
   },
   "peerDependencies": {
     "@tinkoff/dippy": "^1.0.0",
     "@tinkoff/logger": "^0.10.518",
-    "@tramvai/core": "7.21.0",
-    "@tramvai/react": "7.21.0",
-    "@tramvai/state": "7.21.0",
+    "@tinkoff/utils": "^2.1.2",
+    "@tramvai/core": "7.26.8",
+    "@tramvai/react": "7.26.8",
+    "@tramvai/state": "7.26.8",
     "tslib": "^2.4.0"
   },
   "license": "Apache-2.0"