@wix/essentials 0.1.28 → 1.0.1

package/build/i18n/createI18n.d.ts

@@ -2,5 +2,5 @@ import { Host } from '@wix/sdk-types';
 interface Messages {
     [key: string]: string;
 }
-export declare function createI18n(host: Host, asyncMessagesLoader?: (language: string) => Promise<Messages>): import("i18next", { with: { "resolution-mode": "require" } }).i18n;
+export declare function createI18n(host: Host, asyncMessagesLoader?: (language: string) => Promise<Messages>): import("i18next").i18n;
 export {};

package/build/i18n/i18n.d.ts

@@ -1,7 +1,10 @@
+import { TFunction } from 'i18next';
 export declare const i18n: {
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 } & import("@wix/sdk-types").HostModule<{
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 }, import("@wix/sdk-types").Host>;

package/build/i18n/i18n.js

@@ -1,4 +1,11 @@
 import { createHostModule } from '@wix/sdk-runtime/host-modules';
+import i18next from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import { multilingual } from '@wix/site';
+function getPrimaryLanguage(fallback) {
+    return (multilingual.listSupportedLanguages().find((language) => language.primary)
+        ?.id ?? fallback);
+}
 export const i18n = createHostModule({
     getLanguage: (host) => () => {
         const language = host.essentials?.language;
@@ -14,4 +21,25 @@ export const i18n = createHostModule({
         }
         return locale;
     },
+    useTranslation: (host) => () => {
+        const resources = host.translations?.();
+        if (!resources) {
+            throw new Error('Host translation resources are not available.');
+        }
+        const instance = i18next.createInstance();
+        const mainLanguage = getPrimaryLanguage(host.essentials?.language) || 'en';
+        const initOptions = {
+            lng: host.essentials?.language || mainLanguage,
+            fallbackLng: mainLanguage,
+            resources,
+        };
+        // Init is asynchronous, but when provided with a synchronous resource,
+        // it inits immediately and the callback ensures synchronous completion.
+        void instance.use(initReactI18next).init(initOptions, (err) => {
+            if (err) {
+                throw err;
+            }
+        });
+        return instance.t.bind(instance);
+    },
 });

package/build/mock-factory.d.ts

@@ -1,34 +1,34 @@
 export declare function createEssentialsMockFactory(mockFn: any): {
     i18n: {
-        getLanguage: any;
-        getLocale: any;
+        getLanguage: Function | undefined;
+        getLocale: Function | undefined;
     };
     bi: {
-        getLogger: any;
+        getLogger: Function | undefined;
     };
     monitoring: {
-        getMonitoringClient: any;
+        getMonitoringClient: Function | undefined;
     };
     experiments: {
-        enabled: any;
-        get: any;
+        enabled: Function | undefined;
+        get: Function | undefined;
     };
     settings: {
-        getTimezone: any;
+        getTimezone: Function | undefined;
     };
     auth: {
-        elevate: any;
-        getContextualAuth: any;
-        getTokenInfo: any;
+        elevate: Function | undefined;
+        getContextualAuth: Function | undefined;
+        getTokenInfo: Function | undefined;
     };
     httpClient: {
-        fetchWithAuth: any;
-        graphql: any;
+        fetchWithAuth: Function | undefined;
+        graphql: Function | undefined;
     };
     errorHandler: {
-        withErrorHandler: any;
-        getResolvedError: any;
-        showError: any;
-        reportRetryAttempt: any;
+        withErrorHandler: Function | undefined;
+        getResolvedError: Function | undefined;
+        showError: Function | undefined;
+        reportRetryAttempt: Function | undefined;
     };
 };

package/build/mock-factory.js

@@ -1,45 +1,52 @@
 export function createEssentialsMockFactory(mockFn) {
+    const mockFns = new Map();
+    const createUniqueFn = (name, implementation) => {
+        if (!mockFns.has(name)) {
+            mockFns.set(name, mockFn(implementation));
+        }
+        return mockFns.get(name);
+    };
     return {
         i18n: {
-            getLanguage: mockFn(() => 'en'),
-            getLocale: mockFn(() => 'en-US'),
+            getLanguage: createUniqueFn('i18n.getLanguage', () => 'en'),
+            getLocale: createUniqueFn('i18n.getLocale', () => 'en-US'),
         },
         bi: {
-            getLogger: mockFn(() => ({
-                log: mockFn(),
-                report: mockFn(),
-                flush: mockFn(),
-                updateDefaults: mockFn((params) => ({
-                    log: mockFn(),
-                    report: mockFn(),
-                    flush: mockFn(),
-                    updateDefaults: mockFn(),
+            getLogger: createUniqueFn('bi.getLogger', () => ({
+                log: createUniqueFn('bi.getLogger.log'),
+                report: createUniqueFn('bi.getLogger.report'),
+                flush: createUniqueFn('bi.getLogger.flush'),
+                updateDefaults: createUniqueFn('bi.getLogger.updateDefaults', (params) => ({
+                    log: createUniqueFn('bi.getLogger.updateDefaults.log'),
+                    report: createUniqueFn('bi.getLogger.updateDefaults.report'),
+                    flush: createUniqueFn('bi.getLogger.updateDefaults.flush'),
+                    updateDefaults: createUniqueFn('bi.getLogger.updateDefaults.updateDefaults'),
                 })),
             })),
         },
         monitoring: {
-            getMonitoringClient: mockFn(() => ({
-                captureException: mockFn(),
-                captureMessage: mockFn(),
-                setContext: mockFn(),
-                setTag: mockFn(),
-                setUser: mockFn(),
-                addBreadcrumb: mockFn(),
+            getMonitoringClient: createUniqueFn('monitoring.getMonitoringClient', () => ({
+                captureException: createUniqueFn('monitoring.getMonitoringClient.captureException'),
+                captureMessage: createUniqueFn('monitoring.getMonitoringClient.captureMessage'),
+                setContext: createUniqueFn('monitoring.getMonitoringClient.setContext'),
+                setTag: createUniqueFn('monitoring.getMonitoringClient.setTag'),
+                setUser: createUniqueFn('monitoring.getMonitoringClient.setUser'),
+                addBreadcrumb: createUniqueFn('monitoring.getMonitoringClient.addBreadcrumb'),
             })),
         },
         experiments: {
-            enabled: mockFn(() => false),
-            get: mockFn(() => null),
+            enabled: createUniqueFn('experiments.enabled', () => false),
+            get: createUniqueFn('experiments.get', () => null),
         },
         settings: {
-            getTimezone: mockFn(() => 'UTC'),
+            getTimezone: createUniqueFn('settings.getTimezone', () => 'UTC'),
         },
         auth: {
-            elevate: mockFn((restModule) => restModule),
-            getContextualAuth: mockFn(() => ({
+            elevate: createUniqueFn('auth.elevate', (restModule) => restModule),
+            getContextualAuth: createUniqueFn('auth.getContextualAuth', () => ({
                 headers: {},
             })),
-            getTokenInfo: mockFn(() => Promise.resolve({
+            getTokenInfo: createUniqueFn('auth.getTokenInfo', () => Promise.resolve({
                 active: true,
                 subjectType: 'USER',
                 subjectId: 'mock-user-id',
@@ -51,21 +58,21 @@ export function createEssentialsMockFactory(mockFn) {
             })),
         },
         httpClient: {
-            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
-            graphql: mockFn(() => Promise.resolve({
+            fetchWithAuth: createUniqueFn('httpClient.fetchWithAuth', () => global.fetch || mockFn()),
+            graphql: createUniqueFn('httpClient.graphql', () => Promise.resolve({
                 data: {},
                 errors: [],
             })),
         },
         errorHandler: {
-            withErrorHandler: mockFn((fn) => fn()),
-            getResolvedError: mockFn(() => ({
+            withErrorHandler: createUniqueFn('errorHandler.withErrorHandler', (fn) => fn()),
+            getResolvedError: createUniqueFn('errorHandler.getResolvedError', () => ({
                 code: 'UNKNOWN_ERROR',
                 message: 'Mock error',
                 details: {},
             })),
-            showError: mockFn(),
-            reportRetryAttempt: mockFn(),
+            showError: createUniqueFn('errorHandler.showError'),
+            reportRetryAttempt: createUniqueFn('errorHandler.reportRetryAttempt'),
         },
     };
 }

package/cjs/build/i18n/i18n.d.ts

@@ -1,7 +1,10 @@
+import { TFunction } from 'i18next';
 export declare const i18n: {
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 } & import("@wix/sdk-types").HostModule<{
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 }, import("@wix/sdk-types").Host>;

package/cjs/build/i18n/i18n.js

@@ -1,7 +1,17 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.i18n = void 0;
 const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+const i18next_1 = __importDefault(require("i18next"));
+const react_i18next_1 = require("react-i18next");
+const site_1 = require("@wix/site");
+function getPrimaryLanguage(fallback) {
+    return (site_1.multilingual.listSupportedLanguages().find((language) => language.primary)
+        ?.id ?? fallback);
+}
 exports.i18n = (0, host_modules_1.createHostModule)({
     getLanguage: (host) => () => {
         const language = host.essentials?.language;
@@ -17,4 +27,25 @@ exports.i18n = (0, host_modules_1.createHostModule)({
         }
         return locale;
     },
+    useTranslation: (host) => () => {
+        const resources = host.translations?.();
+        if (!resources) {
+            throw new Error('Host translation resources are not available.');
+        }
+        const instance = i18next_1.default.createInstance();
+        const mainLanguage = getPrimaryLanguage(host.essentials?.language) || 'en';
+        const initOptions = {
+            lng: host.essentials?.language || mainLanguage,
+            fallbackLng: mainLanguage,
+            resources,
+        };
+        // Init is asynchronous, but when provided with a synchronous resource,
+        // it inits immediately and the callback ensures synchronous completion.
+        void instance.use(react_i18next_1.initReactI18next).init(initOptions, (err) => {
+            if (err) {
+                throw err;
+            }
+        });
+        return instance.t.bind(instance);
+    },
 });

package/cjs/build/mock-factory.d.ts

@@ -1,34 +1,34 @@
 export declare function createEssentialsMockFactory(mockFn: any): {
     i18n: {
-        getLanguage: any;
-        getLocale: any;
+        getLanguage: Function | undefined;
+        getLocale: Function | undefined;
     };
     bi: {
-        getLogger: any;
+        getLogger: Function | undefined;
     };
     monitoring: {
-        getMonitoringClient: any;
+        getMonitoringClient: Function | undefined;
     };
     experiments: {
-        enabled: any;
-        get: any;
+        enabled: Function | undefined;
+        get: Function | undefined;
     };
     settings: {
-        getTimezone: any;
+        getTimezone: Function | undefined;
     };
     auth: {
-        elevate: any;
-        getContextualAuth: any;
-        getTokenInfo: any;
+        elevate: Function | undefined;
+        getContextualAuth: Function | undefined;
+        getTokenInfo: Function | undefined;
     };
     httpClient: {
-        fetchWithAuth: any;
-        graphql: any;
+        fetchWithAuth: Function | undefined;
+        graphql: Function | undefined;
     };
     errorHandler: {
-        withErrorHandler: any;
-        getResolvedError: any;
-        showError: any;
-        reportRetryAttempt: any;
+        withErrorHandler: Function | undefined;
+        getResolvedError: Function | undefined;
+        showError: Function | undefined;
+        reportRetryAttempt: Function | undefined;
     };
 };

package/cjs/build/mock-factory.js

@@ -2,47 +2,54 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEssentialsMockFactory = createEssentialsMockFactory;
 function createEssentialsMockFactory(mockFn) {
+    const mockFns = new Map();
+    const createUniqueFn = (name, implementation) => {
+        if (!mockFns.has(name)) {
+            mockFns.set(name, mockFn(implementation));
+        }
+        return mockFns.get(name);
+    };
     return {
         i18n: {
-            getLanguage: mockFn(() => 'en'),
-            getLocale: mockFn(() => 'en-US'),
+            getLanguage: createUniqueFn('i18n.getLanguage', () => 'en'),
+            getLocale: createUniqueFn('i18n.getLocale', () => 'en-US'),
         },
         bi: {
-            getLogger: mockFn(() => ({
-                log: mockFn(),
-                report: mockFn(),
-                flush: mockFn(),
-                updateDefaults: mockFn((params) => ({
-                    log: mockFn(),
-                    report: mockFn(),
-                    flush: mockFn(),
-                    updateDefaults: mockFn(),
+            getLogger: createUniqueFn('bi.getLogger', () => ({
+                log: createUniqueFn('bi.getLogger.log'),
+                report: createUniqueFn('bi.getLogger.report'),
+                flush: createUniqueFn('bi.getLogger.flush'),
+                updateDefaults: createUniqueFn('bi.getLogger.updateDefaults', (params) => ({
+                    log: createUniqueFn('bi.getLogger.updateDefaults.log'),
+                    report: createUniqueFn('bi.getLogger.updateDefaults.report'),
+                    flush: createUniqueFn('bi.getLogger.updateDefaults.flush'),
+                    updateDefaults: createUniqueFn('bi.getLogger.updateDefaults.updateDefaults'),
                 })),
             })),
         },
         monitoring: {
-            getMonitoringClient: mockFn(() => ({
-                captureException: mockFn(),
-                captureMessage: mockFn(),
-                setContext: mockFn(),
-                setTag: mockFn(),
-                setUser: mockFn(),
-                addBreadcrumb: mockFn(),
+            getMonitoringClient: createUniqueFn('monitoring.getMonitoringClient', () => ({
+                captureException: createUniqueFn('monitoring.getMonitoringClient.captureException'),
+                captureMessage: createUniqueFn('monitoring.getMonitoringClient.captureMessage'),
+                setContext: createUniqueFn('monitoring.getMonitoringClient.setContext'),
+                setTag: createUniqueFn('monitoring.getMonitoringClient.setTag'),
+                setUser: createUniqueFn('monitoring.getMonitoringClient.setUser'),
+                addBreadcrumb: createUniqueFn('monitoring.getMonitoringClient.addBreadcrumb'),
             })),
         },
         experiments: {
-            enabled: mockFn(() => false),
-            get: mockFn(() => null),
+            enabled: createUniqueFn('experiments.enabled', () => false),
+            get: createUniqueFn('experiments.get', () => null),
         },
         settings: {
-            getTimezone: mockFn(() => 'UTC'),
+            getTimezone: createUniqueFn('settings.getTimezone', () => 'UTC'),
         },
         auth: {
-            elevate: mockFn((restModule) => restModule),
-            getContextualAuth: mockFn(() => ({
+            elevate: createUniqueFn('auth.elevate', (restModule) => restModule),
+            getContextualAuth: createUniqueFn('auth.getContextualAuth', () => ({
                 headers: {},
             })),
-            getTokenInfo: mockFn(() => Promise.resolve({
+            getTokenInfo: createUniqueFn('auth.getTokenInfo', () => Promise.resolve({
                 active: true,
                 subjectType: 'USER',
                 subjectId: 'mock-user-id',
@@ -54,21 +61,21 @@ function createEssentialsMockFactory(mockFn) {
             })),
         },
         httpClient: {
-            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
-            graphql: mockFn(() => Promise.resolve({
+            fetchWithAuth: createUniqueFn('httpClient.fetchWithAuth', () => global.fetch || mockFn()),
+            graphql: createUniqueFn('httpClient.graphql', () => Promise.resolve({
                 data: {},
                 errors: [],
             })),
         },
         errorHandler: {
-            withErrorHandler: mockFn((fn) => fn()),
-            getResolvedError: mockFn(() => ({
+            withErrorHandler: createUniqueFn('errorHandler.withErrorHandler', (fn) => fn()),
+            getResolvedError: createUniqueFn('errorHandler.getResolvedError', () => ({
                 code: 'UNKNOWN_ERROR',
                 message: 'Mock error',
                 details: {},
             })),
-            showError: mockFn(),
-            reportRetryAttempt: mockFn(),
+            showError: createUniqueFn('errorHandler.showError'),
+            reportRetryAttempt: createUniqueFn('errorHandler.reportRetryAttempt'),
         },
     };
 }

package/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/auth.ts","../src/bi.ts","../src/experiments.ts","../src/http-client.ts","../src/index.ts","../src/mock-factory.ts","../src/monitoring.ts","../src/settings.ts","../src/error-handler/createErrorHandler.ts","../src/error-handler/error-handler.ts","../src/i18n/createI18n.ts","../src/i18n/i18n.ts"],"version":"5.9.2"}
+{"root":["../src/auth.ts","../src/bi.ts","../src/experiments.ts","../src/http-client.ts","../src/index.ts","../src/mock-factory.ts","../src/monitoring.ts","../src/settings.ts","../src/error-handler/createErrorHandler.ts","../src/error-handler/error-handler.ts","../src/i18n/createI18n.ts","../src/i18n/i18n.ts"],"version":"5.9.3"}

package/internal/build/i18n/createI18n.d.ts

@@ -2,5 +2,5 @@ import { Host } from '@wix/sdk-types';
 interface Messages {
     [key: string]: string;
 }
-export declare function createI18n(host: Host, asyncMessagesLoader?: (language: string) => Promise<Messages>): import("i18next", { with: { "resolution-mode": "require" } }).i18n;
+export declare function createI18n(host: Host, asyncMessagesLoader?: (language: string) => Promise<Messages>): import("i18next").i18n;
 export {};

package/internal/build/i18n/i18n.d.ts

@@ -1,7 +1,10 @@
+import { TFunction } from 'i18next';
 export declare const i18n: {
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 } & import("@wix/sdk-types").HostModule<{
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 }, import("@wix/sdk-types").Host>;

package/internal/build/i18n/i18n.js

@@ -1,4 +1,11 @@
 import { createHostModule } from '@wix/sdk-runtime/host-modules';
+import i18next from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import { multilingual } from '@wix/site';
+function getPrimaryLanguage(fallback) {
+    return (multilingual.listSupportedLanguages().find((language) => language.primary)
+        ?.id ?? fallback);
+}
 export const i18n = createHostModule({
     getLanguage: (host) => () => {
         const language = host.essentials?.language;
@@ -14,4 +21,25 @@ export const i18n = createHostModule({
         }
         return locale;
     },
+    useTranslation: (host) => () => {
+        const resources = host.translations?.();
+        if (!resources) {
+            throw new Error('Host translation resources are not available.');
+        }
+        const instance = i18next.createInstance();
+        const mainLanguage = getPrimaryLanguage(host.essentials?.language) || 'en';
+        const initOptions = {
+            lng: host.essentials?.language || mainLanguage,
+            fallbackLng: mainLanguage,
+            resources,
+        };
+        // Init is asynchronous, but when provided with a synchronous resource,
+        // it inits immediately and the callback ensures synchronous completion.
+        void instance.use(initReactI18next).init(initOptions, (err) => {
+            if (err) {
+                throw err;
+            }
+        });
+        return instance.t.bind(instance);
+    },
 });

package/internal/build/mock-factory.d.ts

@@ -1,34 +1,34 @@
 export declare function createEssentialsMockFactory(mockFn: any): {
     i18n: {
-        getLanguage: any;
-        getLocale: any;
+        getLanguage: Function | undefined;
+        getLocale: Function | undefined;
     };
     bi: {
-        getLogger: any;
+        getLogger: Function | undefined;
     };
     monitoring: {
-        getMonitoringClient: any;
+        getMonitoringClient: Function | undefined;
     };
     experiments: {
-        enabled: any;
-        get: any;
+        enabled: Function | undefined;
+        get: Function | undefined;
     };
     settings: {
-        getTimezone: any;
+        getTimezone: Function | undefined;
     };
     auth: {
-        elevate: any;
-        getContextualAuth: any;
-        getTokenInfo: any;
+        elevate: Function | undefined;
+        getContextualAuth: Function | undefined;
+        getTokenInfo: Function | undefined;
     };
     httpClient: {
-        fetchWithAuth: any;
-        graphql: any;
+        fetchWithAuth: Function | undefined;
+        graphql: Function | undefined;
     };
     errorHandler: {
-        withErrorHandler: any;
-        getResolvedError: any;
-        showError: any;
-        reportRetryAttempt: any;
+        withErrorHandler: Function | undefined;
+        getResolvedError: Function | undefined;
+        showError: Function | undefined;
+        reportRetryAttempt: Function | undefined;
     };
 };

package/internal/build/mock-factory.js

@@ -1,45 +1,52 @@
 export function createEssentialsMockFactory(mockFn) {
+    const mockFns = new Map();
+    const createUniqueFn = (name, implementation) => {
+        if (!mockFns.has(name)) {
+            mockFns.set(name, mockFn(implementation));
+        }
+        return mockFns.get(name);
+    };
     return {
         i18n: {
-            getLanguage: mockFn(() => 'en'),
-            getLocale: mockFn(() => 'en-US'),
+            getLanguage: createUniqueFn('i18n.getLanguage', () => 'en'),
+            getLocale: createUniqueFn('i18n.getLocale', () => 'en-US'),
         },
         bi: {
-            getLogger: mockFn(() => ({
-                log: mockFn(),
-                report: mockFn(),
-                flush: mockFn(),
-                updateDefaults: mockFn((params) => ({
-                    log: mockFn(),
-                    report: mockFn(),
-                    flush: mockFn(),
-                    updateDefaults: mockFn(),
+            getLogger: createUniqueFn('bi.getLogger', () => ({
+                log: createUniqueFn('bi.getLogger.log'),
+                report: createUniqueFn('bi.getLogger.report'),
+                flush: createUniqueFn('bi.getLogger.flush'),
+                updateDefaults: createUniqueFn('bi.getLogger.updateDefaults', (params) => ({
+                    log: createUniqueFn('bi.getLogger.updateDefaults.log'),
+                    report: createUniqueFn('bi.getLogger.updateDefaults.report'),
+                    flush: createUniqueFn('bi.getLogger.updateDefaults.flush'),
+                    updateDefaults: createUniqueFn('bi.getLogger.updateDefaults.updateDefaults'),
                 })),
             })),
         },
         monitoring: {
-            getMonitoringClient: mockFn(() => ({
-                captureException: mockFn(),
-                captureMessage: mockFn(),
-                setContext: mockFn(),
-                setTag: mockFn(),
-                setUser: mockFn(),
-                addBreadcrumb: mockFn(),
+            getMonitoringClient: createUniqueFn('monitoring.getMonitoringClient', () => ({
+                captureException: createUniqueFn('monitoring.getMonitoringClient.captureException'),
+                captureMessage: createUniqueFn('monitoring.getMonitoringClient.captureMessage'),
+                setContext: createUniqueFn('monitoring.getMonitoringClient.setContext'),
+                setTag: createUniqueFn('monitoring.getMonitoringClient.setTag'),
+                setUser: createUniqueFn('monitoring.getMonitoringClient.setUser'),
+                addBreadcrumb: createUniqueFn('monitoring.getMonitoringClient.addBreadcrumb'),
             })),
         },
         experiments: {
-            enabled: mockFn(() => false),
-            get: mockFn(() => null),
+            enabled: createUniqueFn('experiments.enabled', () => false),
+            get: createUniqueFn('experiments.get', () => null),
         },
         settings: {
-            getTimezone: mockFn(() => 'UTC'),
+            getTimezone: createUniqueFn('settings.getTimezone', () => 'UTC'),
         },
         auth: {
-            elevate: mockFn((restModule) => restModule),
-            getContextualAuth: mockFn(() => ({
+            elevate: createUniqueFn('auth.elevate', (restModule) => restModule),
+            getContextualAuth: createUniqueFn('auth.getContextualAuth', () => ({
                 headers: {},
             })),
-            getTokenInfo: mockFn(() => Promise.resolve({
+            getTokenInfo: createUniqueFn('auth.getTokenInfo', () => Promise.resolve({
                 active: true,
                 subjectType: 'USER',
                 subjectId: 'mock-user-id',
@@ -51,21 +58,21 @@ export function createEssentialsMockFactory(mockFn) {
             })),
         },
         httpClient: {
-            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
-            graphql: mockFn(() => Promise.resolve({
+            fetchWithAuth: createUniqueFn('httpClient.fetchWithAuth', () => global.fetch || mockFn()),
+            graphql: createUniqueFn('httpClient.graphql', () => Promise.resolve({
                 data: {},
                 errors: [],
             })),
         },
         errorHandler: {
-            withErrorHandler: mockFn((fn) => fn()),
-            getResolvedError: mockFn(() => ({
+            withErrorHandler: createUniqueFn('errorHandler.withErrorHandler', (fn) => fn()),
+            getResolvedError: createUniqueFn('errorHandler.getResolvedError', () => ({
                 code: 'UNKNOWN_ERROR',
                 message: 'Mock error',
                 details: {},
             })),
-            showError: mockFn(),
-            reportRetryAttempt: mockFn(),
+            showError: createUniqueFn('errorHandler.showError'),
+            reportRetryAttempt: createUniqueFn('errorHandler.reportRetryAttempt'),
         },
     };
 }

package/internal/cjs/build/i18n/i18n.d.ts

@@ -1,7 +1,10 @@
+import { TFunction } from 'i18next';
 export declare const i18n: {
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 } & import("@wix/sdk-types").HostModule<{
     getLanguage: () => string;
     getLocale: () => string;
+    useTranslation: () => TFunction;
 }, import("@wix/sdk-types").Host>;

package/internal/cjs/build/i18n/i18n.js

@@ -1,7 +1,17 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.i18n = void 0;
 const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+const i18next_1 = __importDefault(require("i18next"));
+const react_i18next_1 = require("react-i18next");
+const site_1 = require("@wix/site");
+function getPrimaryLanguage(fallback) {
+    return (site_1.multilingual.listSupportedLanguages().find((language) => language.primary)
+        ?.id ?? fallback);
+}
 exports.i18n = (0, host_modules_1.createHostModule)({
     getLanguage: (host) => () => {
         const language = host.essentials?.language;
@@ -17,4 +27,25 @@ exports.i18n = (0, host_modules_1.createHostModule)({
         }
         return locale;
     },
+    useTranslation: (host) => () => {
+        const resources = host.translations?.();
+        if (!resources) {
+            throw new Error('Host translation resources are not available.');
+        }
+        const instance = i18next_1.default.createInstance();
+        const mainLanguage = getPrimaryLanguage(host.essentials?.language) || 'en';
+        const initOptions = {
+            lng: host.essentials?.language || mainLanguage,
+            fallbackLng: mainLanguage,
+            resources,
+        };
+        // Init is asynchronous, but when provided with a synchronous resource,
+        // it inits immediately and the callback ensures synchronous completion.
+        void instance.use(react_i18next_1.initReactI18next).init(initOptions, (err) => {
+            if (err) {
+                throw err;
+            }
+        });
+        return instance.t.bind(instance);
+    },
 });

package/internal/cjs/build/mock-factory.d.ts

@@ -1,34 +1,34 @@
 export declare function createEssentialsMockFactory(mockFn: any): {
     i18n: {
-        getLanguage: any;
-        getLocale: any;
+        getLanguage: Function | undefined;
+        getLocale: Function | undefined;
     };
     bi: {
-        getLogger: any;
+        getLogger: Function | undefined;
     };
     monitoring: {
-        getMonitoringClient: any;
+        getMonitoringClient: Function | undefined;
     };
     experiments: {
-        enabled: any;
-        get: any;
+        enabled: Function | undefined;
+        get: Function | undefined;
     };
     settings: {
-        getTimezone: any;
+        getTimezone: Function | undefined;
     };
     auth: {
-        elevate: any;
-        getContextualAuth: any;
-        getTokenInfo: any;
+        elevate: Function | undefined;
+        getContextualAuth: Function | undefined;
+        getTokenInfo: Function | undefined;
     };
     httpClient: {
-        fetchWithAuth: any;
-        graphql: any;
+        fetchWithAuth: Function | undefined;
+        graphql: Function | undefined;
     };
     errorHandler: {
-        withErrorHandler: any;
-        getResolvedError: any;
-        showError: any;
-        reportRetryAttempt: any;
+        withErrorHandler: Function | undefined;
+        getResolvedError: Function | undefined;
+        showError: Function | undefined;
+        reportRetryAttempt: Function | undefined;
     };
 };

package/internal/cjs/build/mock-factory.js

@@ -2,47 +2,54 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEssentialsMockFactory = createEssentialsMockFactory;
 function createEssentialsMockFactory(mockFn) {
+    const mockFns = new Map();
+    const createUniqueFn = (name, implementation) => {
+        if (!mockFns.has(name)) {
+            mockFns.set(name, mockFn(implementation));
+        }
+        return mockFns.get(name);
+    };
     return {
         i18n: {
-            getLanguage: mockFn(() => 'en'),
-            getLocale: mockFn(() => 'en-US'),
+            getLanguage: createUniqueFn('i18n.getLanguage', () => 'en'),
+            getLocale: createUniqueFn('i18n.getLocale', () => 'en-US'),
         },
         bi: {
-            getLogger: mockFn(() => ({
-                log: mockFn(),
-                report: mockFn(),
-                flush: mockFn(),
-                updateDefaults: mockFn((params) => ({
-                    log: mockFn(),
-                    report: mockFn(),
-                    flush: mockFn(),
-                    updateDefaults: mockFn(),
+            getLogger: createUniqueFn('bi.getLogger', () => ({
+                log: createUniqueFn('bi.getLogger.log'),
+                report: createUniqueFn('bi.getLogger.report'),
+                flush: createUniqueFn('bi.getLogger.flush'),
+                updateDefaults: createUniqueFn('bi.getLogger.updateDefaults', (params) => ({
+                    log: createUniqueFn('bi.getLogger.updateDefaults.log'),
+                    report: createUniqueFn('bi.getLogger.updateDefaults.report'),
+                    flush: createUniqueFn('bi.getLogger.updateDefaults.flush'),
+                    updateDefaults: createUniqueFn('bi.getLogger.updateDefaults.updateDefaults'),
                 })),
             })),
         },
         monitoring: {
-            getMonitoringClient: mockFn(() => ({
-                captureException: mockFn(),
-                captureMessage: mockFn(),
-                setContext: mockFn(),
-                setTag: mockFn(),
-                setUser: mockFn(),
-                addBreadcrumb: mockFn(),
+            getMonitoringClient: createUniqueFn('monitoring.getMonitoringClient', () => ({
+                captureException: createUniqueFn('monitoring.getMonitoringClient.captureException'),
+                captureMessage: createUniqueFn('monitoring.getMonitoringClient.captureMessage'),
+                setContext: createUniqueFn('monitoring.getMonitoringClient.setContext'),
+                setTag: createUniqueFn('monitoring.getMonitoringClient.setTag'),
+                setUser: createUniqueFn('monitoring.getMonitoringClient.setUser'),
+                addBreadcrumb: createUniqueFn('monitoring.getMonitoringClient.addBreadcrumb'),
             })),
         },
         experiments: {
-            enabled: mockFn(() => false),
-            get: mockFn(() => null),
+            enabled: createUniqueFn('experiments.enabled', () => false),
+            get: createUniqueFn('experiments.get', () => null),
         },
         settings: {
-            getTimezone: mockFn(() => 'UTC'),
+            getTimezone: createUniqueFn('settings.getTimezone', () => 'UTC'),
         },
         auth: {
-            elevate: mockFn((restModule) => restModule),
-            getContextualAuth: mockFn(() => ({
+            elevate: createUniqueFn('auth.elevate', (restModule) => restModule),
+            getContextualAuth: createUniqueFn('auth.getContextualAuth', () => ({
                 headers: {},
             })),
-            getTokenInfo: mockFn(() => Promise.resolve({
+            getTokenInfo: createUniqueFn('auth.getTokenInfo', () => Promise.resolve({
                 active: true,
                 subjectType: 'USER',
                 subjectId: 'mock-user-id',
@@ -54,21 +61,21 @@ function createEssentialsMockFactory(mockFn) {
             })),
         },
         httpClient: {
-            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
-            graphql: mockFn(() => Promise.resolve({
+            fetchWithAuth: createUniqueFn('httpClient.fetchWithAuth', () => global.fetch || mockFn()),
+            graphql: createUniqueFn('httpClient.graphql', () => Promise.resolve({
                 data: {},
                 errors: [],
             })),
         },
         errorHandler: {
-            withErrorHandler: mockFn((fn) => fn()),
-            getResolvedError: mockFn(() => ({
+            withErrorHandler: createUniqueFn('errorHandler.withErrorHandler', (fn) => fn()),
+            getResolvedError: createUniqueFn('errorHandler.getResolvedError', () => ({
                 code: 'UNKNOWN_ERROR',
                 message: 'Mock error',
                 details: {},
             })),
-            showError: mockFn(),
-            reportRetryAttempt: mockFn(),
+            showError: createUniqueFn('errorHandler.showError'),
+            reportRetryAttempt: createUniqueFn('errorHandler.reportRetryAttempt'),
         },
     };
 }

package/internal/cjs/tsconfig.internal.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../src/auth.ts","../../src/bi.ts","../../src/experiments.ts","../../src/http-client.ts","../../src/index.ts","../../src/mock-factory.ts","../../src/monitoring.ts","../../src/settings.ts","../../src/error-handler/createErrorHandler.ts","../../src/error-handler/error-handler.ts","../../src/i18n/createI18n.ts","../../src/i18n/i18n.ts"],"version":"5.9.2"}
+{"root":["../../src/auth.ts","../../src/bi.ts","../../src/experiments.ts","../../src/http-client.ts","../../src/index.ts","../../src/mock-factory.ts","../../src/monitoring.ts","../../src/settings.ts","../../src/error-handler/createErrorHandler.ts","../../src/error-handler/error-handler.ts","../../src/i18n/createI18n.ts","../../src/i18n/i18n.ts"],"version":"5.9.3"}

package/internal/tsconfig.internal.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/auth.ts","../src/bi.ts","../src/experiments.ts","../src/http-client.ts","../src/index.ts","../src/mock-factory.ts","../src/monitoring.ts","../src/settings.ts","../src/error-handler/createErrorHandler.ts","../src/error-handler/error-handler.ts","../src/i18n/createI18n.ts","../src/i18n/i18n.ts"],"version":"5.9.2"}
+{"root":["../src/auth.ts","../src/bi.ts","../src/experiments.ts","../src/http-client.ts","../src/index.ts","../src/mock-factory.ts","../src/monitoring.ts","../src/settings.ts","../src/error-handler/createErrorHandler.ts","../src/error-handler/error-handler.ts","../src/i18n/createI18n.ts","../src/i18n/i18n.ts"],"version":"5.9.3"}

package/package.json

@@ -1,10 +1,35 @@
 {
   "name": "@wix/essentials",
-  "version": "0.1.28",
-  "license": "MIT",
-  "main": "cjs/build/index.js",
-  "module": "build/index.mjs",
-  "type": "module",
+  "version": "1.0.1",
+  "dependencies": {
+    "@wix/error-handler": "^1.67.0",
+    "@wix/monitoring": "^0.21.0",
+    "@wix/sdk-runtime": "1.0.3",
+    "@wix/sdk-types": "1.17.1",
+    "@wix/site": "^1.37.0",
+    "i18next": "^25.6.3",
+    "i18next-icu": "^2.4.1",
+    "intl-messageformat": "^10.7.18",
+    "react-i18next": "^16.1.2"
+  },
+  "devDependencies": {
+    "@types/is-ci": "^3.0.4",
+    "@types/node": "^20.19.25",
+    "@vitest/ui": "^1.6.1",
+    "@wix/sdk": "1.21.1",
+    "eslint": "^8.57.1",
+    "eslint-config-sdk": "1.0.0",
+    "graphql": "^16.8.0",
+    "is-ci": "^3.0.1",
+    "jsdom": "^22.1.0",
+    "msw": "^2.12.2",
+    "typescript": "^5.9.3",
+    "vitest": "^1.6.1",
+    "vitest-teamcity-reporter": "^0.3.1"
+  },
+  "eslintConfig": {
+    "extends": "sdk"
+  },
   "exports": {
     ".": {
       "import": "./build/index.js",
@@ -16,59 +41,36 @@
     },
     "./package.json": "./package.json"
   },
-  "sideEffects": false,
-  "keywords": [
-    "wix-sdk-module=backend,page,public"
-  ],
   "files": [
     "build",
     "cjs",
     "internal"
   ],
+  "keywords": [
+    "wix-sdk-module=backend,page,public"
+  ],
+  "license": "MIT",
+  "lint-staged": {
+    "*.{js,ts}": "yarn lint"
+  },
+  "main": "cjs/build/index.js",
+  "module": "build/index.mjs",
+  "optionalDependencies": {
+    "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "scripts": {
     "build": "tsc -b tsconfig.json tsconfig.cjs.json tsconfig.internal.json tsconfig.internal.cjs.json",
-    "test": "vitest",
     "lint": "eslint --max-warnings=0 .",
     "lint:fix": "eslint --max-warnings=0 . --fix",
+    "test": "vitest",
     "typecheck": "tsc --noEmit"
   },
-  "lint-staged": {
-    "*.{js,ts}": "yarn lint"
-  },
-  "dependencies": {
-    "@wix/error-handler": "^1.67.0",
-    "@wix/monitoring": "^0.21.0",
-    "@wix/sdk-runtime": "^0.3.62",
-    "@wix/sdk-types": "^1.13.41",
-    "i18next": "^25.3.2",
-    "i18next-icu": "^2.3.0",
-    "intl-messageformat": "^10.7.16"
-  },
-  "optionalDependencies": {
-    "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0"
-  },
-  "devDependencies": {
-    "@types/is-ci": "^3.0.4",
-    "@types/node": "^20.19.10",
-    "@vitest/ui": "^1.6.1",
-    "@wix/sdk": "1.15.27",
-    "eslint": "^8.57.1",
-    "eslint-config-sdk": "0.0.0",
-    "graphql": "^16.8.0",
-    "is-ci": "^3.0.1",
-    "jsdom": "^22.1.0",
-    "msw": "^2.10.4",
-    "typescript": "^5.9.2",
-    "vitest": "^1.6.1",
-    "vitest-teamcity-reporter": "^0.3.1"
-  },
-  "eslintConfig": {
-    "extends": "sdk"
-  },
+  "sideEffects": false,
+  "type": "module",
   "wix": {
     "artifact": {
       "groupId": "com.wixpress",
@@ -83,5 +85,5 @@
       ]
     }
   },
-  "falconPackageHash": "52c1ad0cd86cd3dc571912ef73d7743c6a3afb566bc9cbc288af37f6"
+  "falconPackageHash": "7b256d0376ce1c1f5e87495b65f5d237327350612d600b2d03120ff5"
 }