@wix/essentials 0.1.25 → 0.1.27

package/build/error-handler/createErrorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { Host } from '@wix/sdk-types';
+export declare function createErrorHandler(host: Host): import("@wix/error-handler/dist/types/error-handler/ErrorHandlerV2.js").ErrorHandlerV2;

package/build/error-handler/createErrorHandler.js

@@ -0,0 +1,20 @@
+import { ErrorHandler } from '@wix/error-handler';
+import { createI18n } from '../i18n/createI18n.js';
+export function createErrorHandler(host) {
+    return new ErrorHandler({
+        environment: {
+            artifactId: 'sdk-essentials',
+        },
+        biDefaultsOverrides: {
+            hostingEnvironment: host.name,
+        },
+        biLoggerOrFactory: {
+            async report() { },
+        },
+        showError: host.showError,
+        createErrorMonitor: () => ({
+            captureException() { },
+        }),
+        createI18n: ({ asyncMessagesLoader }) => createI18n(host, asyncMessagesLoader),
+    }).v2;
+}

package/build/{error-handler.d.ts → error-handler/error-handler.d.ts}

@@ -1,4 +1,4 @@
-import type { ResolvedError, ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps } from '@wix/sdk-types';
+import type { ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps, ResolvedError } from '@wix/sdk-types';
 export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap<T>, options?: import("@wix/error-handler-types/dist/types/v2/ErrorHandlerPublicAPI.js").WithErrorHandlerOptions) => Promise<T>;
 export declare const getResolvedError: <T>(error: unknown) => ResolvedError & Partial<T>;
 export declare const showError: (error: unknown, props?: Partial<import("@wix/error-handler-types/dist/types/v2/ShowError.js").ShowErrorOverrideProps> | null) => void;

package/build/{error-handler.js → error-handler/error-handler.js}

@@ -1,9 +1,13 @@
 import { createHostModule } from '@wix/sdk-runtime/host-modules';
+import { createErrorHandler } from './createErrorHandler.js';
 const getFromHostErrorHandlerOrDefault = (fn) => (host) => {
-    if (!host.getErrorHandler) {
-        throw new Error('Error handler is not available. Make sure to include the error handler in the host.');
+    if (host.getErrorHandler) {
+        return fn(host.getErrorHandler());
     }
-    return fn(host.getErrorHandler());
+    const errorHandler = createErrorHandler(host);
+    // memoize the error handler on the host
+    host.getErrorHandler = () => errorHandler;
+    return fn(createErrorHandler(host));
 };
 const errorHandler = createHostModule({
     withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),

package/build/i18n/createI18n.d.ts

@@ -0,0 +1,6 @@
+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 {};

package/build/i18n/createI18n.js

@@ -0,0 +1,30 @@
+import i18n from 'i18next';
+import ICU from 'i18next-icu';
+export function createI18n(host, asyncMessagesLoader) {
+    const i18nInstance = i18n
+        .createInstance({
+        lng: host.essentials?.locale || 'en',
+        fallbackLng: 'en',
+        keySeparator: false,
+    })
+        .use(ICU);
+    if (asyncMessagesLoader) {
+        i18nInstance.use(customBackend(asyncMessagesLoader));
+    }
+    return i18nInstance;
+}
+function customBackend(asyncMessagesLoader) {
+    return {
+        type: 'backend',
+        init: () => { },
+        read: async (language, _namespace, callback) => {
+            try {
+                const translation = await asyncMessagesLoader(language);
+                return callback(null, translation);
+            }
+            catch (err) {
+                return callback(err, null);
+            }
+        },
+    };
+}

package/build/index.d.ts

@@ -1,8 +1,8 @@
 import * as auth from './auth.js';
 import * as httpClient from './http-client.js';
-import * as errorHandler from './error-handler.js';
+import * as errorHandler from './error-handler/error-handler.js';
 export { auth, httpClient, errorHandler };
-export { i18n } from './i18n.js';
+export { i18n } from './i18n/i18n.js';
 export { monitoring } from './monitoring.js';
 export { bi } from './bi.js';
 export { experiments } from './experiments.js';

package/build/index.js

@@ -1,8 +1,8 @@
 import * as auth from './auth.js';
 import * as httpClient from './http-client.js';
-import * as errorHandler from './error-handler.js';
+import * as errorHandler from './error-handler/error-handler.js';
 export { auth, httpClient, errorHandler };
-export { i18n } from './i18n.js';
+export { i18n } from './i18n/i18n.js';
 export { monitoring } from './monitoring.js';
 export { bi } from './bi.js';
 export { experiments } from './experiments.js';

package/build/mock-factory.d.ts

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

package/build/mock-factory.js

@@ -0,0 +1,71 @@
+export function createEssentialsMockFactory(mockFn) {
+    return {
+        i18n: {
+            getLanguage: mockFn(() => 'en'),
+            getLocale: mockFn(() => 'en-US'),
+        },
+        bi: {
+            getLogger: mockFn(() => ({
+                log: mockFn(),
+                report: mockFn(),
+                flush: mockFn(),
+                updateDefaults: mockFn((params) => ({
+                    log: mockFn(),
+                    report: mockFn(),
+                    flush: mockFn(),
+                    updateDefaults: mockFn(),
+                })),
+            })),
+        },
+        monitoring: {
+            getMonitoringClient: mockFn(() => ({
+                captureException: mockFn(),
+                captureMessage: mockFn(),
+                setContext: mockFn(),
+                setTag: mockFn(),
+                setUser: mockFn(),
+                addBreadcrumb: mockFn(),
+            })),
+        },
+        experiments: {
+            enabled: mockFn(() => false),
+            get: mockFn(() => null),
+        },
+        settings: {
+            getTimezone: mockFn(() => 'UTC'),
+        },
+        auth: {
+            elevate: mockFn((restModule) => restModule),
+            getContextualAuth: mockFn(() => ({
+                headers: {},
+            })),
+            getTokenInfo: mockFn(() => Promise.resolve({
+                active: true,
+                subjectType: 'USER',
+                subjectId: 'mock-user-id',
+                exp: Date.now() + 3600000,
+                iat: Date.now(),
+                clientId: 'mock-client-id',
+                siteId: 'mock-site-id',
+                instanceId: 'mock-instance-id',
+            })),
+        },
+        httpClient: {
+            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
+            graphql: mockFn(() => Promise.resolve({
+                data: {},
+                errors: [],
+            })),
+        },
+        errorHandler: {
+            withErrorHandler: mockFn((fn) => fn),
+            getResolvedError: mockFn(() => ({
+                code: 'UNKNOWN_ERROR',
+                message: 'Mock error',
+                details: {},
+            })),
+            showError: mockFn(),
+            reportRetryAttempt: mockFn(),
+        },
+    };
+}

package/cjs/build/error-handler/createErrorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { Host } from '@wix/sdk-types';
+export declare function createErrorHandler(host: Host): import("@wix/error-handler/dist/types/error-handler/ErrorHandlerV2.js").ErrorHandlerV2;

package/cjs/build/error-handler/createErrorHandler.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorHandler = createErrorHandler;
+const error_handler_1 = require("@wix/error-handler");
+const createI18n_js_1 = require("../i18n/createI18n.js");
+function createErrorHandler(host) {
+    return new error_handler_1.ErrorHandler({
+        environment: {
+            artifactId: 'sdk-essentials',
+        },
+        biDefaultsOverrides: {
+            hostingEnvironment: host.name,
+        },
+        biLoggerOrFactory: {
+            async report() { },
+        },
+        showError: host.showError,
+        createErrorMonitor: () => ({
+            captureException() { },
+        }),
+        createI18n: ({ asyncMessagesLoader }) => (0, createI18n_js_1.createI18n)(host, asyncMessagesLoader),
+    }).v2;
+}

package/cjs/build/{error-handler.d.ts → error-handler/error-handler.d.ts}

@@ -1,5 +1,5 @@
-import type { ResolvedError, ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps } from '@wix/sdk-types';
-export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap<T>, options?: import("@wix/error-handler-types/dist/types/v2").WithErrorHandlerOptions) => Promise<T>;
+import type { ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps, ResolvedError } from '@wix/sdk-types';
+export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap<T>, options?: import("@wix/error-handler-types/dist/types/v2/ErrorHandlerPublicAPI.js").WithErrorHandlerOptions) => Promise<T>;
 export declare const getResolvedError: <T>(error: unknown) => ResolvedError & Partial<T>;
-export declare const showError: (error: unknown, props?: Partial<import("@wix/error-handler-types/dist/types/v2").ShowErrorOverrideProps> | null) => void;
+export declare const showError: (error: unknown, props?: Partial<import("@wix/error-handler-types/dist/types/v2/ShowError.js").ShowErrorOverrideProps> | null) => void;
 export type { ErrorHandler, ResolvedError, ErrorCodesMap, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps, };

package/cjs/build/{error-handler.js → error-handler/error-handler.js}

@@ -2,11 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.reportRetryAttempt = exports.showError = exports.getResolvedError = exports.withErrorHandler = void 0;
 const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+const createErrorHandler_js_1 = require("./createErrorHandler.js");
 const getFromHostErrorHandlerOrDefault = (fn) => (host) => {
-    if (!host.getErrorHandler) {
-        throw new Error('Error handler is not available. Make sure to include the error handler in the host.');
+    if (host.getErrorHandler) {
+        return fn(host.getErrorHandler());
     }
-    return fn(host.getErrorHandler());
+    const errorHandler = (0, createErrorHandler_js_1.createErrorHandler)(host);
+    // memoize the error handler on the host
+    host.getErrorHandler = () => errorHandler;
+    return fn((0, createErrorHandler_js_1.createErrorHandler)(host));
 };
 const errorHandler = (0, host_modules_1.createHostModule)({
     withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),

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

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

package/cjs/build/i18n/createI18n.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createI18n = createI18n;
+const i18next_1 = __importDefault(require("i18next"));
+const i18next_icu_1 = __importDefault(require("i18next-icu"));
+function createI18n(host, asyncMessagesLoader) {
+    const i18nInstance = i18next_1.default
+        .createInstance({
+        lng: host.essentials?.locale || 'en',
+        fallbackLng: 'en',
+        keySeparator: false,
+    })
+        .use(i18next_icu_1.default);
+    if (asyncMessagesLoader) {
+        i18nInstance.use(customBackend(asyncMessagesLoader));
+    }
+    return i18nInstance;
+}
+function customBackend(asyncMessagesLoader) {
+    return {
+        type: 'backend',
+        init: () => { },
+        read: async (language, _namespace, callback) => {
+            try {
+                const translation = await asyncMessagesLoader(language);
+                return callback(null, translation);
+            }
+            catch (err) {
+                return callback(err, null);
+            }
+        },
+    };
+}

package/cjs/build/index.d.ts

@@ -1,8 +1,8 @@
 import * as auth from './auth.js';
 import * as httpClient from './http-client.js';
-import * as errorHandler from './error-handler.js';
+import * as errorHandler from './error-handler/error-handler.js';
 export { auth, httpClient, errorHandler };
-export { i18n } from './i18n.js';
+export { i18n } from './i18n/i18n.js';
 export { monitoring } from './monitoring.js';
 export { bi } from './bi.js';
 export { experiments } from './experiments.js';

package/cjs/build/index.js

@@ -38,9 +38,9 @@ const auth = __importStar(require("./auth.js"));
 exports.auth = auth;
 const httpClient = __importStar(require("./http-client.js"));
 exports.httpClient = httpClient;
-const errorHandler = __importStar(require("./error-handler.js"));
+const errorHandler = __importStar(require("./error-handler/error-handler.js"));
 exports.errorHandler = errorHandler;
-var i18n_js_1 = require("./i18n.js");
+var i18n_js_1 = require("./i18n/i18n.js");
 Object.defineProperty(exports, "i18n", { enumerable: true, get: function () { return i18n_js_1.i18n; } });
 var monitoring_js_1 = require("./monitoring.js");
 Object.defineProperty(exports, "monitoring", { enumerable: true, get: function () { return monitoring_js_1.monitoring; } });

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

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

package/cjs/build/mock-factory.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEssentialsMockFactory = createEssentialsMockFactory;
+function createEssentialsMockFactory(mockFn) {
+    return {
+        i18n: {
+            getLanguage: mockFn(() => 'en'),
+            getLocale: mockFn(() => 'en-US'),
+        },
+        bi: {
+            getLogger: mockFn(() => ({
+                log: mockFn(),
+                report: mockFn(),
+                flush: mockFn(),
+                updateDefaults: mockFn((params) => ({
+                    log: mockFn(),
+                    report: mockFn(),
+                    flush: mockFn(),
+                    updateDefaults: mockFn(),
+                })),
+            })),
+        },
+        monitoring: {
+            getMonitoringClient: mockFn(() => ({
+                captureException: mockFn(),
+                captureMessage: mockFn(),
+                setContext: mockFn(),
+                setTag: mockFn(),
+                setUser: mockFn(),
+                addBreadcrumb: mockFn(),
+            })),
+        },
+        experiments: {
+            enabled: mockFn(() => false),
+            get: mockFn(() => null),
+        },
+        settings: {
+            getTimezone: mockFn(() => 'UTC'),
+        },
+        auth: {
+            elevate: mockFn((restModule) => restModule),
+            getContextualAuth: mockFn(() => ({
+                headers: {},
+            })),
+            getTokenInfo: mockFn(() => Promise.resolve({
+                active: true,
+                subjectType: 'USER',
+                subjectId: 'mock-user-id',
+                exp: Date.now() + 3600000,
+                iat: Date.now(),
+                clientId: 'mock-client-id',
+                siteId: 'mock-site-id',
+                instanceId: 'mock-instance-id',
+            })),
+        },
+        httpClient: {
+            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
+            graphql: mockFn(() => Promise.resolve({
+                data: {},
+                errors: [],
+            })),
+        },
+        errorHandler: {
+            withErrorHandler: mockFn((fn) => fn),
+            getResolvedError: mockFn(() => ({
+                code: 'UNKNOWN_ERROR',
+                message: 'Mock error',
+                details: {},
+            })),
+            showError: mockFn(),
+            reportRetryAttempt: mockFn(),
+        },
+    };
+}

package/cjs/tsconfig.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/auth.ts","../src/bi.ts","../src/error-handler.ts","../src/experiments.ts","../src/http-client.ts","../src/i18n.ts","../src/index.ts","../src/monitoring.ts","../src/settings.ts"],"version":"5.8.3"}
+{"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"}

package/internal/build/error-handler/createErrorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { Host } from '@wix/sdk-types';
+export declare function createErrorHandler(host: Host): import("@wix/error-handler/dist/types/error-handler/ErrorHandlerV2.js").ErrorHandlerV2;

package/internal/build/error-handler/createErrorHandler.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createErrorHandler = createErrorHandler;
+const error_handler_1 = require("@wix/error-handler");
+const createI18n_js_1 = require("../i18n/createI18n.js");
+function createErrorHandler(host) {
+    return new error_handler_1.ErrorHandler({
+        environment: {
+            artifactId: 'sdk-essentials',
+        },
+        biDefaultsOverrides: {
+            hostingEnvironment: host.name,
+        },
+        biLoggerOrFactory: {
+            async report() { },
+        },
+        showError: host.showError,
+        createErrorMonitor: () => ({
+            captureException() { },
+        }),
+        createI18n: ({ asyncMessagesLoader }) => (0, createI18n_js_1.createI18n)(host, asyncMessagesLoader),
+    }).v2;
+}

package/internal/{cjs/build → build/error-handler}/error-handler.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedError, ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps } from '@wix/sdk-types';
+import type { ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps, ResolvedError } from '@wix/sdk-types';
 export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap<T>, options?: import("@wix/error-handler-types/dist/types/v2/ErrorHandlerPublicAPI.js").WithErrorHandlerOptions) => Promise<T>;
 export declare const getResolvedError: <T>(error: unknown) => ResolvedError & Partial<T>;
 export declare const showError: (error: unknown, props?: Partial<import("@wix/error-handler-types/dist/types/v2/ShowError.js").ShowErrorOverrideProps> | null) => void;

package/internal/build/{error-handler.js → error-handler/error-handler.js}

@@ -2,11 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.reportRetryAttempt = exports.showError = exports.getResolvedError = exports.withErrorHandler = void 0;
 const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+const createErrorHandler_js_1 = require("./createErrorHandler.js");
 const getFromHostErrorHandlerOrDefault = (fn) => (host) => {
-    if (!host.getErrorHandler) {
-        throw new Error('Error handler is not available. Make sure to include the error handler in the host.');
+    if (host.getErrorHandler) {
+        return fn(host.getErrorHandler());
     }
-    return fn(host.getErrorHandler());
+    const errorHandler = (0, createErrorHandler_js_1.createErrorHandler)(host);
+    // memoize the error handler on the host
+    host.getErrorHandler = () => errorHandler;
+    return fn((0, createErrorHandler_js_1.createErrorHandler)(host));
 };
 const errorHandler = (0, host_modules_1.createHostModule)({
     withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),

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

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

package/internal/build/i18n/createI18n.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createI18n = createI18n;
+const i18next_1 = __importDefault(require("i18next"));
+const i18next_icu_1 = __importDefault(require("i18next-icu"));
+function createI18n(host, asyncMessagesLoader) {
+    const i18nInstance = i18next_1.default
+        .createInstance({
+        lng: host.essentials?.locale || 'en',
+        fallbackLng: 'en',
+        keySeparator: false,
+    })
+        .use(i18next_icu_1.default);
+    if (asyncMessagesLoader) {
+        i18nInstance.use(customBackend(asyncMessagesLoader));
+    }
+    return i18nInstance;
+}
+function customBackend(asyncMessagesLoader) {
+    return {
+        type: 'backend',
+        init: () => { },
+        read: async (language, _namespace, callback) => {
+            try {
+                const translation = await asyncMessagesLoader(language);
+                return callback(null, translation);
+            }
+            catch (err) {
+                return callback(err, null);
+            }
+        },
+    };
+}

package/internal/build/index.d.ts

@@ -1,8 +1,8 @@
 import * as auth from './auth.js';
 import * as httpClient from './http-client.js';
-import * as errorHandler from './error-handler.js';
+import * as errorHandler from './error-handler/error-handler.js';
 export { auth, httpClient, errorHandler };
-export { i18n } from './i18n.js';
+export { i18n } from './i18n/i18n.js';
 export { monitoring } from './monitoring.js';
 export { bi } from './bi.js';
 export { experiments } from './experiments.js';

package/internal/build/index.js

@@ -38,9 +38,9 @@ const auth = __importStar(require("./auth.js"));
 exports.auth = auth;
 const httpClient = __importStar(require("./http-client.js"));
 exports.httpClient = httpClient;
-const errorHandler = __importStar(require("./error-handler.js"));
+const errorHandler = __importStar(require("./error-handler/error-handler.js"));
 exports.errorHandler = errorHandler;
-var i18n_js_1 = require("./i18n.js");
+var i18n_js_1 = require("./i18n/i18n.js");
 Object.defineProperty(exports, "i18n", { enumerable: true, get: function () { return i18n_js_1.i18n; } });
 var monitoring_js_1 = require("./monitoring.js");
 Object.defineProperty(exports, "monitoring", { enumerable: true, get: function () { return monitoring_js_1.monitoring; } });

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

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

package/internal/build/mock-factory.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEssentialsMockFactory = createEssentialsMockFactory;
+function createEssentialsMockFactory(mockFn) {
+    return {
+        i18n: {
+            getLanguage: mockFn(() => 'en'),
+            getLocale: mockFn(() => 'en-US'),
+        },
+        bi: {
+            getLogger: mockFn(() => ({
+                log: mockFn(),
+                report: mockFn(),
+                flush: mockFn(),
+                updateDefaults: mockFn((params) => ({
+                    log: mockFn(),
+                    report: mockFn(),
+                    flush: mockFn(),
+                    updateDefaults: mockFn(),
+                })),
+            })),
+        },
+        monitoring: {
+            getMonitoringClient: mockFn(() => ({
+                captureException: mockFn(),
+                captureMessage: mockFn(),
+                setContext: mockFn(),
+                setTag: mockFn(),
+                setUser: mockFn(),
+                addBreadcrumb: mockFn(),
+            })),
+        },
+        experiments: {
+            enabled: mockFn(() => false),
+            get: mockFn(() => null),
+        },
+        settings: {
+            getTimezone: mockFn(() => 'UTC'),
+        },
+        auth: {
+            elevate: mockFn((restModule) => restModule),
+            getContextualAuth: mockFn(() => ({
+                headers: {},
+            })),
+            getTokenInfo: mockFn(() => Promise.resolve({
+                active: true,
+                subjectType: 'USER',
+                subjectId: 'mock-user-id',
+                exp: Date.now() + 3600000,
+                iat: Date.now(),
+                clientId: 'mock-client-id',
+                siteId: 'mock-site-id',
+                instanceId: 'mock-instance-id',
+            })),
+        },
+        httpClient: {
+            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
+            graphql: mockFn(() => Promise.resolve({
+                data: {},
+                errors: [],
+            })),
+        },
+        errorHandler: {
+            withErrorHandler: mockFn((fn) => fn),
+            getResolvedError: mockFn(() => ({
+                code: 'UNKNOWN_ERROR',
+                message: 'Mock error',
+                details: {},
+            })),
+            showError: mockFn(),
+            reportRetryAttempt: mockFn(),
+        },
+    };
+}

package/internal/cjs/build/error-handler/createErrorHandler.d.ts

@@ -0,0 +1,2 @@
+import type { Host } from '@wix/sdk-types';
+export declare function createErrorHandler(host: Host): import("@wix/error-handler/dist/types/error-handler/ErrorHandlerV2.js").ErrorHandlerV2;

package/internal/cjs/build/error-handler/createErrorHandler.js

@@ -0,0 +1,20 @@
+import { ErrorHandler } from '@wix/error-handler';
+import { createI18n } from '../i18n/createI18n.js';
+export function createErrorHandler(host) {
+    return new ErrorHandler({
+        environment: {
+            artifactId: 'sdk-essentials',
+        },
+        biDefaultsOverrides: {
+            hostingEnvironment: host.name,
+        },
+        biLoggerOrFactory: {
+            async report() { },
+        },
+        showError: host.showError,
+        createErrorMonitor: () => ({
+            captureException() { },
+        }),
+        createI18n: ({ asyncMessagesLoader }) => createI18n(host, asyncMessagesLoader),
+    }).v2;
+}

package/internal/{build → cjs/build/error-handler}/error-handler.d.ts

@@ -1,7 +1,7 @@
-import type { ResolvedError, ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps } from '@wix/sdk-types';
-export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap<T>, options?: import("@wix/error-handler-types/dist/types/v2").WithErrorHandlerOptions) => Promise<T>;
+import type { ErrorCodesMap, ErrorHandler, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps, ResolvedError } from '@wix/sdk-types';
+export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap<T>, options?: import("@wix/error-handler-types/dist/types/v2/ErrorHandlerPublicAPI.js").WithErrorHandlerOptions) => Promise<T>;
 export declare const getResolvedError: <T>(error: unknown) => ResolvedError & Partial<T>;
-export declare const showError: (error: unknown, props?: Partial<import("@wix/error-handler-types/dist/types/v2").ShowErrorOverrideProps> | null) => void;
+export declare const showError: (error: unknown, props?: Partial<import("@wix/error-handler-types/dist/types/v2/ShowError.js").ShowErrorOverrideProps> | null) => void;
 /** @internal */
 export declare const reportRetryAttempt: (error: unknown) => void;
 export type { ErrorHandler, ResolvedError, ErrorCodesMap, StatusCodeMap, ShowErrorMapFunction, ShowErrorProps, };

package/internal/cjs/build/{error-handler.js → error-handler/error-handler.js}

@@ -1,9 +1,13 @@
 import { createHostModule } from '@wix/sdk-runtime/host-modules';
+import { createErrorHandler } from './createErrorHandler.js';
 const getFromHostErrorHandlerOrDefault = (fn) => (host) => {
-    if (!host.getErrorHandler) {
-        throw new Error('Error handler is not available. Make sure to include the error handler in the host.');
+    if (host.getErrorHandler) {
+        return fn(host.getErrorHandler());
     }
-    return fn(host.getErrorHandler());
+    const errorHandler = createErrorHandler(host);
+    // memoize the error handler on the host
+    host.getErrorHandler = () => errorHandler;
+    return fn(createErrorHandler(host));
 };
 const errorHandler = createHostModule({
     withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),

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

@@ -0,0 +1,6 @@
+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 {};

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

@@ -0,0 +1,30 @@
+import i18n from 'i18next';
+import ICU from 'i18next-icu';
+export function createI18n(host, asyncMessagesLoader) {
+    const i18nInstance = i18n
+        .createInstance({
+        lng: host.essentials?.locale || 'en',
+        fallbackLng: 'en',
+        keySeparator: false,
+    })
+        .use(ICU);
+    if (asyncMessagesLoader) {
+        i18nInstance.use(customBackend(asyncMessagesLoader));
+    }
+    return i18nInstance;
+}
+function customBackend(asyncMessagesLoader) {
+    return {
+        type: 'backend',
+        init: () => { },
+        read: async (language, _namespace, callback) => {
+            try {
+                const translation = await asyncMessagesLoader(language);
+                return callback(null, translation);
+            }
+            catch (err) {
+                return callback(err, null);
+            }
+        },
+    };
+}

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

@@ -1,8 +1,8 @@
 import * as auth from './auth.js';
 import * as httpClient from './http-client.js';
-import * as errorHandler from './error-handler.js';
+import * as errorHandler from './error-handler/error-handler.js';
 export { auth, httpClient, errorHandler };
-export { i18n } from './i18n.js';
+export { i18n } from './i18n/i18n.js';
 export { monitoring } from './monitoring.js';
 export { bi } from './bi.js';
 export { experiments } from './experiments.js';

package/internal/cjs/build/index.js

@@ -1,8 +1,8 @@
 import * as auth from './auth.js';
 import * as httpClient from './http-client.js';
-import * as errorHandler from './error-handler.js';
+import * as errorHandler from './error-handler/error-handler.js';
 export { auth, httpClient, errorHandler };
-export { i18n } from './i18n.js';
+export { i18n } from './i18n/i18n.js';
 export { monitoring } from './monitoring.js';
 export { bi } from './bi.js';
 export { experiments } from './experiments.js';

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

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

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

@@ -0,0 +1,71 @@
+export function createEssentialsMockFactory(mockFn) {
+    return {
+        i18n: {
+            getLanguage: mockFn(() => 'en'),
+            getLocale: mockFn(() => 'en-US'),
+        },
+        bi: {
+            getLogger: mockFn(() => ({
+                log: mockFn(),
+                report: mockFn(),
+                flush: mockFn(),
+                updateDefaults: mockFn((params) => ({
+                    log: mockFn(),
+                    report: mockFn(),
+                    flush: mockFn(),
+                    updateDefaults: mockFn(),
+                })),
+            })),
+        },
+        monitoring: {
+            getMonitoringClient: mockFn(() => ({
+                captureException: mockFn(),
+                captureMessage: mockFn(),
+                setContext: mockFn(),
+                setTag: mockFn(),
+                setUser: mockFn(),
+                addBreadcrumb: mockFn(),
+            })),
+        },
+        experiments: {
+            enabled: mockFn(() => false),
+            get: mockFn(() => null),
+        },
+        settings: {
+            getTimezone: mockFn(() => 'UTC'),
+        },
+        auth: {
+            elevate: mockFn((restModule) => restModule),
+            getContextualAuth: mockFn(() => ({
+                headers: {},
+            })),
+            getTokenInfo: mockFn(() => Promise.resolve({
+                active: true,
+                subjectType: 'USER',
+                subjectId: 'mock-user-id',
+                exp: Date.now() + 3600000,
+                iat: Date.now(),
+                clientId: 'mock-client-id',
+                siteId: 'mock-site-id',
+                instanceId: 'mock-instance-id',
+            })),
+        },
+        httpClient: {
+            fetchWithAuth: mockFn(() => global.fetch || mockFn()),
+            graphql: mockFn(() => Promise.resolve({
+                data: {},
+                errors: [],
+            })),
+        },
+        errorHandler: {
+            withErrorHandler: mockFn((fn) => fn),
+            getResolvedError: mockFn(() => ({
+                code: 'UNKNOWN_ERROR',
+                message: 'Mock error',
+                details: {},
+            })),
+            showError: mockFn(),
+            reportRetryAttempt: mockFn(),
+        },
+    };
+}

package/internal/cjs/tsconfig.internal.tsbuildinfo

@@ -1 +1 @@
-{"root":["../../src/auth.ts","../../src/bi.ts","../../src/error-handler.ts","../../src/experiments.ts","../../src/http-client.ts","../../src/i18n.ts","../../src/index.ts","../../src/monitoring.ts","../../src/settings.ts"],"version":"5.8.3"}
+{"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"}

package/internal/tsconfig.internal.cjs.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/auth.ts","../src/bi.ts","../src/error-handler.ts","../src/experiments.ts","../src/http-client.ts","../src/i18n.ts","../src/index.ts","../src/monitoring.ts","../src/settings.ts"],"version":"5.8.3"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/essentials",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "license": "MIT",
   "main": "cjs/build/index.js",
   "module": "build/index.mjs",
@@ -10,6 +10,10 @@
       "import": "./build/index.js",
       "require": "./cjs/build/index.js"
     },
+    "./mock": {
+      "import": "./build/mock-factory.js",
+      "require": "./cjs/build/mock-factory.js"
+    },
     "./package.json": "./package.json"
   },
   "sideEffects": false,
@@ -36,25 +40,29 @@
     "*.{js,ts}": "yarn lint"
   },
   "dependencies": {
+    "@wix/error-handler": "^1.67.0",
     "@wix/monitoring": "^0.21.0",
-    "@wix/sdk-runtime": "^0.3.58",
-    "@wix/sdk-types": "^1.13.37"
+    "@wix/sdk-runtime": "^0.3.61",
+    "@wix/sdk-types": "^1.13.40",
+    "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.9",
+    "@types/node": "^20.19.10",
     "@vitest/ui": "^1.6.1",
-    "@wix/sdk": "1.15.25",
+    "@wix/sdk": "1.15.26",
     "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.8.3",
+    "typescript": "^5.9.2",
     "vitest": "^1.6.1",
     "vitest-teamcity-reporter": "^0.3.1"
   },
@@ -75,5 +83,5 @@
       ]
     }
   },
-  "falconPackageHash": "b5cd0deaa6ee134095f322e48ff0293d079ec71a855e9052ea572288"
+  "falconPackageHash": "a801c32a834f4fe35de7aaf398f7e2e478fb8c7a573dee31a5a3902d"
 }