@wix/essentials 0.1.19 → 0.1.21

package/build/bi.d.ts

@@ -0,0 +1 @@
+export {};

package/build/bi.js

@@ -0,0 +1,10 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+/** @internal */
+export const bi = createHostModule({
+    getLogger: (host) => () => {
+        if (!host.getBiLogger) {
+            throw new Error('Host bi logger is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getBiLogger();
+    },
+});

package/build/error-handler.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedError, ErrorCodesMap, ErrorHandler } from '@wix/sdk-types';
+export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap) => 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").ShowErrorProps> | null) => void;
+export type { ErrorHandler, ResolvedError, ErrorCodesMap };

package/build/error-handler.js

@@ -0,0 +1,18 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+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.');
+    }
+    return fn(host.getErrorHandler());
+};
+const errorHandler = createHostModule({
+    withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),
+    getResolvedError: getFromHostErrorHandlerOrDefault((e) => e.getResolvedError),
+    showError: getFromHostErrorHandlerOrDefault((e) => e.showError),
+    reportRetryAttempt: getFromHostErrorHandlerOrDefault((e) => e.reportRetryAttempt),
+});
+export const withErrorHandler = errorHandler.withErrorHandler;
+export const getResolvedError = errorHandler.getResolvedError;
+export const showError = errorHandler.showError;
+/** @internal */
+export const reportRetryAttempt = errorHandler.reportRetryAttempt;

package/build/experiments.d.ts

@@ -0,0 +1 @@
+export {};

package/build/experiments.js

@@ -0,0 +1,28 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+/** @internal */
+export const experiments = createHostModule({
+    isEnabled_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().enabled(specName);
+    },
+    getValue_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().get(specName);
+    },
+    isFeatureOn: (host) => (featureName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().isFeatureOn(featureName);
+    },
+    getABTestVariant: (host) => (abTestName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().getABTestVariant(abTestName);
+    },
+});

package/build/http-client.d.ts

@@ -16,15 +16,4 @@ export type TypedQueryInput<Result = {
     [key: string]: any;
 }, Variables = {
     [key: string]: any;
-}> = {
-    /**
-     * Type to support `@graphql-typed-document-node/core`
-     * @internal
-     */
-    __apiType?: (variables: Variables) => Result;
-    /**
-     * Type to support `TypedQueryDocumentNode` from `graphql`
-     * @internal
-     */
-    __ensureTypesOfVariablesAndResultMatching?: (variables: Variables) => Result;
-};
+}> = {};

package/build/index.d.ts

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

package/build/index.js

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

package/cjs/build/bi.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/build/bi.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bi = void 0;
+const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+/** @internal */
+exports.bi = (0, host_modules_1.createHostModule)({
+    getLogger: (host) => () => {
+        if (!host.getBiLogger) {
+            throw new Error('Host bi logger is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getBiLogger();
+    },
+});

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

@@ -0,0 +1,5 @@
+import type { ResolvedError, ErrorCodesMap, ErrorHandler } from '@wix/sdk-types';
+export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap) => 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").ShowErrorProps> | null) => void;
+export type { ErrorHandler, ResolvedError, ErrorCodesMap };

package/cjs/build/error-handler.js

@@ -0,0 +1,21 @@
+"use strict";
+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 getFromHostErrorHandlerOrDefault = (fn) => (host) => {
+    if (!host.getErrorHandler) {
+        throw new Error('Error handler is not available. Make sure to include the error handler in the host.');
+    }
+    return fn(host.getErrorHandler());
+};
+const errorHandler = (0, host_modules_1.createHostModule)({
+    withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),
+    getResolvedError: getFromHostErrorHandlerOrDefault((e) => e.getResolvedError),
+    showError: getFromHostErrorHandlerOrDefault((e) => e.showError),
+    reportRetryAttempt: getFromHostErrorHandlerOrDefault((e) => e.reportRetryAttempt),
+});
+exports.withErrorHandler = errorHandler.withErrorHandler;
+exports.getResolvedError = errorHandler.getResolvedError;
+exports.showError = errorHandler.showError;
+/** @internal */
+exports.reportRetryAttempt = errorHandler.reportRetryAttempt;

package/cjs/build/experiments.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/build/experiments.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experiments = void 0;
+const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+/** @internal */
+exports.experiments = (0, host_modules_1.createHostModule)({
+    isEnabled_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().enabled(specName);
+    },
+    getValue_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().get(specName);
+    },
+    isFeatureOn: (host) => (featureName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().isFeatureOn(featureName);
+    },
+    getABTestVariant: (host) => (abTestName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().getABTestVariant(abTestName);
+    },
+});

package/cjs/build/http-client.d.ts

@@ -16,15 +16,4 @@ export type TypedQueryInput<Result = {
     [key: string]: any;
 }, Variables = {
     [key: string]: any;
-}> = {
-    /**
-     * Type to support `@graphql-typed-document-node/core`
-     * @internal
-     */
-    __apiType?: (variables: Variables) => Result;
-    /**
-     * Type to support `TypedQueryDocumentNode` from `graphql`
-     * @internal
-     */
-    __ensureTypesOfVariablesAndResultMatching?: (variables: Variables) => Result;
-};
+}> = {};

package/cjs/build/index.d.ts

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

package/cjs/build/index.js

@@ -33,12 +33,18 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.monitoring = exports.i18n = exports.httpClient = exports.auth = void 0;
+exports.experiments = exports.bi = exports.monitoring = exports.i18n = exports.errorHandler = exports.httpClient = exports.auth = void 0;
 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"));
+exports.errorHandler = errorHandler;
 var i18n_js_1 = require("./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; } });
+var bi_js_1 = require("./bi.js");
+Object.defineProperty(exports, "bi", { enumerable: true, get: function () { return bi_js_1.bi; } });
+var experiments_js_1 = require("./experiments.js");
+Object.defineProperty(exports, "experiments", { enumerable: true, get: function () { return experiments_js_1.experiments; } });

package/cjs/tsconfig.cjs.tsbuildinfo

@@ -0,0 +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"],"version":"5.8.3"}

package/internal/build/auth.d.ts

@@ -0,0 +1,66 @@
+export declare function elevate<T>(restModule: T): T;
+/**
+ * Returns the information encoded in the currently active token in API backend extensions.
+ *
+ * When developing API backend extensions you might need to access information about the session that is making the request.
+ *
+ * This can include the user ID, the site ID, the instance ID, and more. This information is encoded in the token that is sent with the request
+ * and can be accessed using this function.
+ * @returns A promise that resolves to the token info.
+ * @example
+ * ```ts
+ * // In an API backend extension in a Wix CLI project
+ * import { auth } from '@wix/essentials';
+ *
+ * export async function GET(req: Request) {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ *  if (tokenInfo.subjectType === 'USER') {
+ *    return new Response(`Hello user ${tokenInfo.subjectId}`);
+ *  } else if (tokenInfo.subjectType === 'APP') {
+ *    return new Response('Hello app');
+ *  } else if (tokenInfo.subjectType === 'MEMBER') {
+ *    return new Response(`Hello member ${tokenInfo.subjectId}`);
+ *  } else {
+ *    return new Response(`Hello visitor ${tokenInfo.subjectId}`);
+ *  }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * // In a Velo web method
+ * import { auth } from '@wix/essentials';
+ * import { Permissions, webMethod } from 'wix-web-module';
+ *
+ * export const sayHello = webMethod(Permimissions.Anyone, async () => {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ * if (tokenInfo.subjectType === 'USER') {
+ *  return `Hello user ${tokenInfo.subjectId}`;
+ * } else if (tokenInfo.subjectType === 'APP') {
+ *  return 'Hello app';
+ * } else if (tokenInfo.subjectType === 'MEMBER') {
+ *  return `Hello member ${tokenInfo.subjectId}`;
+ * } else {
+ *  return `Hello visitor ${tokenInfo.subjectId}`;
+ * }
+ */
+export declare const getTokenInfo: (() => Promise<{
+    active: boolean;
+    subjectType: "APP" | "USER" | "MEMBER" | "VISITOR" | "UNKNOWN";
+    subjectId: string;
+    exp: number;
+    iat: number;
+    clientId?: string;
+    siteId: string;
+    instanceId?: string;
+}>) & ((restModuleOpts: import("@wix/sdk-types").HttpClient) => () => Promise<{
+    active: boolean;
+    subjectType: "APP" | "USER" | "MEMBER" | "VISITOR" | "UNKNOWN";
+    subjectId: string;
+    exp: number;
+    iat: number;
+    clientId?: string;
+    siteId: string;
+    instanceId?: string;
+}>);

package/internal/build/auth.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTokenInfo = void 0;
+exports.elevate = elevate;
+const rest_modules_1 = require("@wix/sdk-runtime/rest-modules");
+function elevate(restModule) {
+    return (0, rest_modules_1.createRESTModule)(restModule, true);
+}
+/**
+ * Returns the information encoded in the currently active token in API backend extensions.
+ *
+ * When developing API backend extensions you might need to access information about the session that is making the request.
+ *
+ * This can include the user ID, the site ID, the instance ID, and more. This information is encoded in the token that is sent with the request
+ * and can be accessed using this function.
+ * @returns A promise that resolves to the token info.
+ * @example
+ * ```ts
+ * // In an API backend extension in a Wix CLI project
+ * import { auth } from '@wix/essentials';
+ *
+ * export async function GET(req: Request) {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ *  if (tokenInfo.subjectType === 'USER') {
+ *    return new Response(`Hello user ${tokenInfo.subjectId}`);
+ *  } else if (tokenInfo.subjectType === 'APP') {
+ *    return new Response('Hello app');
+ *  } else if (tokenInfo.subjectType === 'MEMBER') {
+ *    return new Response(`Hello member ${tokenInfo.subjectId}`);
+ *  } else {
+ *    return new Response(`Hello visitor ${tokenInfo.subjectId}`);
+ *  }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * // In a Velo web method
+ * import { auth } from '@wix/essentials';
+ * import { Permissions, webMethod } from 'wix-web-module';
+ *
+ * export const sayHello = webMethod(Permimissions.Anyone, async () => {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ * if (tokenInfo.subjectType === 'USER') {
+ *  return `Hello user ${tokenInfo.subjectId}`;
+ * } else if (tokenInfo.subjectType === 'APP') {
+ *  return 'Hello app';
+ * } else if (tokenInfo.subjectType === 'MEMBER') {
+ *  return `Hello member ${tokenInfo.subjectId}`;
+ * } else {
+ *  return `Hello visitor ${tokenInfo.subjectId}`;
+ * }
+ */
+exports.getTokenInfo = (0, rest_modules_1.createRESTModule)((restModuleOpts) => {
+    return async () => {
+        if (!restModuleOpts.getActiveToken) {
+            throw new Error('Unable to get the currently active token. Please make sure you are using an authentication strategy that supports this operation.');
+        }
+        const res = await fetch('https://www.wixapis.com/oauth2/token-info', {
+            method: 'POST',
+            body: JSON.stringify({ token: restModuleOpts.getActiveToken() }),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to fetch token info: ${res.status} - ${res.statusText}. ${await res.text()}`);
+        }
+        return res.json();
+    };
+});

package/internal/build/bi.d.ts

@@ -0,0 +1,7 @@
+import type { Host } from '@wix/sdk-types';
+/** @internal */
+export declare const bi: {
+    getLogger: () => ReturnType<NonNullable<Host["getBiLogger"]>>;
+} & import("@wix/sdk-types").HostModule<{
+    getLogger: () => ReturnType<NonNullable<Host["getBiLogger"]>>;
+}, Host>;

package/internal/build/bi.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bi = void 0;
+const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+/** @internal */
+exports.bi = (0, host_modules_1.createHostModule)({
+    getLogger: (host) => () => {
+        if (!host.getBiLogger) {
+            throw new Error('Host bi logger is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getBiLogger();
+    },
+});

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

@@ -0,0 +1,7 @@
+import type { ResolvedError, ErrorCodesMap, ErrorHandler } from '@wix/sdk-types';
+export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap) => 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").ShowErrorProps> | null) => void;
+/** @internal */
+export declare const reportRetryAttempt: (error: unknown) => void;
+export type { ErrorHandler, ResolvedError, ErrorCodesMap };

package/internal/build/error-handler.js

@@ -0,0 +1,21 @@
+"use strict";
+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 getFromHostErrorHandlerOrDefault = (fn) => (host) => {
+    if (!host.getErrorHandler) {
+        throw new Error('Error handler is not available. Make sure to include the error handler in the host.');
+    }
+    return fn(host.getErrorHandler());
+};
+const errorHandler = (0, host_modules_1.createHostModule)({
+    withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),
+    getResolvedError: getFromHostErrorHandlerOrDefault((e) => e.getResolvedError),
+    showError: getFromHostErrorHandlerOrDefault((e) => e.showError),
+    reportRetryAttempt: getFromHostErrorHandlerOrDefault((e) => e.reportRetryAttempt),
+});
+exports.withErrorHandler = errorHandler.withErrorHandler;
+exports.getResolvedError = errorHandler.getResolvedError;
+exports.showError = errorHandler.showError;
+/** @internal */
+exports.reportRetryAttempt = errorHandler.reportRetryAttempt;

package/internal/build/experiments.d.ts

@@ -0,0 +1,12 @@
+/** @internal */
+export declare const experiments: {
+    isEnabled_legacy: (specName: string) => boolean;
+    getValue_legacy: (specName: string) => any;
+    isFeatureOn: (featureName: string) => boolean;
+    getABTestVariant: (abTestName: string) => "a" | "b" | "c" | "d" | "e";
+} & import("@wix/sdk-types").HostModule<{
+    isEnabled_legacy: (specName: string) => boolean;
+    getValue_legacy: (specName: string) => any;
+    isFeatureOn: (featureName: string) => boolean;
+    getABTestVariant: (abTestName: string) => "a" | "b" | "c" | "d" | "e";
+}, import("@wix/sdk-types").Host>;

package/internal/build/experiments.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experiments = void 0;
+const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+/** @internal */
+exports.experiments = (0, host_modules_1.createHostModule)({
+    isEnabled_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().enabled(specName);
+    },
+    getValue_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().get(specName);
+    },
+    isFeatureOn: (host) => (featureName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().isFeatureOn(featureName);
+    },
+    getABTestVariant: (host) => (abTestName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().getABTestVariant(abTestName);
+    },
+});

package/internal/build/http-client.d.ts

@@ -0,0 +1,30 @@
+import { DocumentNode, GraphQLFormattedError } from 'graphql';
+import { RESTFunctionDescriptor } from '@wix/sdk-types';
+export declare const fetchWithAuth: typeof fetch & ((restModuleOpts: import("@wix/sdk-types").HttpClient) => typeof fetch);
+export declare const graphql: (<Result, Variables>(query: string | String | DocumentNode | TypedQueryInput<Result, Variables>, variables?: Variables, opts?: {
+    apiVersion: string;
+}) => Promise<{
+    data: Result;
+    errors?: GraphQLFormattedError[];
+}>) & RESTFunctionDescriptor<(<Result, Variables>(query: string | String | DocumentNode | TypedQueryInput<Result, Variables>, variables?: Variables, opts?: {
+    apiVersion: string;
+}) => Promise<{
+    data: Result;
+    errors?: GraphQLFormattedError[];
+}>)>;
+export type TypedQueryInput<Result = {
+    [key: string]: any;
+}, Variables = {
+    [key: string]: any;
+}> = {
+    /**
+     * Type to support `@graphql-typed-document-node/core`
+     * @internal
+     */
+    __apiType?: (variables: Variables) => Result;
+    /**
+     * Type to support `TypedQueryDocumentNode` from `graphql`
+     * @internal
+     */
+    __ensureTypesOfVariablesAndResultMatching?: (variables: Variables) => Result;
+};

package/internal/build/http-client.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.graphql = exports.fetchWithAuth = void 0;
+const rest_modules_1 = require("@wix/sdk-runtime/rest-modules");
+exports.fetchWithAuth = (0, rest_modules_1.createRESTModule)((restModuleOpts) => {
+    return ((url, options) => restModuleOpts.fetchWithAuth(url, options));
+});
+exports.graphql = (0, rest_modules_1.createRESTModule)(((restModuleOpts) => {
+    // eslint-disable-next-line @typescript-eslint/no-shadow
+    return async function graphql(query, variables, opts = {
+        apiVersion: 'alpha',
+    }) {
+        const result = await restModuleOpts.request(({ host }) => {
+            const basePath = host === 'www.wixapis.com' ? '/graphql' : '/_api/graphql';
+            return {
+                method: 'POST',
+                url: `${basePath}/${opts.apiVersion}`,
+                data: { query, variables },
+                packageName: '@wix/essentials',
+            };
+        });
+        return result.data;
+    };
+}));

package/internal/build/i18n.d.ts

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

package/internal/build/i18n.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.i18n = void 0;
+const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+exports.i18n = (0, host_modules_1.createHostModule)({
+    getLanguage: (host) => () => {
+        const language = host.essentials?.language;
+        if (!language) {
+            throw new Error('Host language is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return language;
+    },
+    getLocale: (host) => () => {
+        const locale = host.essentials?.locale;
+        if (!locale) {
+            throw new Error('Host locale is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return locale;
+    },
+});

package/internal/build/index.d.ts

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

package/internal/build/index.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experiments = exports.bi = exports.monitoring = exports.i18n = exports.errorHandler = exports.httpClient = exports.auth = void 0;
+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"));
+exports.errorHandler = errorHandler;
+var i18n_js_1 = require("./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; } });
+var bi_js_1 = require("./bi.js");
+Object.defineProperty(exports, "bi", { enumerable: true, get: function () { return bi_js_1.bi; } });
+var experiments_js_1 = require("./experiments.js");
+Object.defineProperty(exports, "experiments", { enumerable: true, get: function () { return experiments_js_1.experiments; } });

package/internal/build/monitoring.d.ts

@@ -0,0 +1,6 @@
+import type { Host } from '@wix/sdk-types';
+export declare const monitoring: {
+    getMonitoringClient: () => ReturnType<NonNullable<Host["getMonitoringClient"]>>;
+} & import("@wix/sdk-types").HostModule<{
+    getMonitoringClient: () => ReturnType<NonNullable<Host["getMonitoringClient"]>>;
+}, Host>;

package/internal/build/monitoring.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.monitoring = void 0;
+const monitoring_1 = require("@wix/monitoring");
+const host_modules_1 = require("@wix/sdk-runtime/host-modules");
+exports.monitoring = (0, host_modules_1.createHostModule)({
+    getMonitoringClient: (host) => () => {
+        if (!host.getMonitoringClient) {
+            return (0, monitoring_1.createFallbackMonitoringClient)('Host monitoring client is not available on the current host. Make sure to use an updated version of the host initialization package.');
+        }
+        return host.getMonitoringClient();
+    },
+});

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

@@ -0,0 +1,66 @@
+export declare function elevate<T>(restModule: T): T;
+/**
+ * Returns the information encoded in the currently active token in API backend extensions.
+ *
+ * When developing API backend extensions you might need to access information about the session that is making the request.
+ *
+ * This can include the user ID, the site ID, the instance ID, and more. This information is encoded in the token that is sent with the request
+ * and can be accessed using this function.
+ * @returns A promise that resolves to the token info.
+ * @example
+ * ```ts
+ * // In an API backend extension in a Wix CLI project
+ * import { auth } from '@wix/essentials';
+ *
+ * export async function GET(req: Request) {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ *  if (tokenInfo.subjectType === 'USER') {
+ *    return new Response(`Hello user ${tokenInfo.subjectId}`);
+ *  } else if (tokenInfo.subjectType === 'APP') {
+ *    return new Response('Hello app');
+ *  } else if (tokenInfo.subjectType === 'MEMBER') {
+ *    return new Response(`Hello member ${tokenInfo.subjectId}`);
+ *  } else {
+ *    return new Response(`Hello visitor ${tokenInfo.subjectId}`);
+ *  }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * // In a Velo web method
+ * import { auth } from '@wix/essentials';
+ * import { Permissions, webMethod } from 'wix-web-module';
+ *
+ * export const sayHello = webMethod(Permimissions.Anyone, async () => {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ * if (tokenInfo.subjectType === 'USER') {
+ *  return `Hello user ${tokenInfo.subjectId}`;
+ * } else if (tokenInfo.subjectType === 'APP') {
+ *  return 'Hello app';
+ * } else if (tokenInfo.subjectType === 'MEMBER') {
+ *  return `Hello member ${tokenInfo.subjectId}`;
+ * } else {
+ *  return `Hello visitor ${tokenInfo.subjectId}`;
+ * }
+ */
+export declare const getTokenInfo: (() => Promise<{
+    active: boolean;
+    subjectType: "APP" | "USER" | "MEMBER" | "VISITOR" | "UNKNOWN";
+    subjectId: string;
+    exp: number;
+    iat: number;
+    clientId?: string;
+    siteId: string;
+    instanceId?: string;
+}>) & ((restModuleOpts: import("@wix/sdk-types").HttpClient) => () => Promise<{
+    active: boolean;
+    subjectType: "APP" | "USER" | "MEMBER" | "VISITOR" | "UNKNOWN";
+    subjectId: string;
+    exp: number;
+    iat: number;
+    clientId?: string;
+    siteId: string;
+    instanceId?: string;
+}>);

package/internal/cjs/build/auth.js

@@ -0,0 +1,68 @@
+import { createRESTModule } from '@wix/sdk-runtime/rest-modules';
+export function elevate(restModule) {
+    return createRESTModule(restModule, true);
+}
+/**
+ * Returns the information encoded in the currently active token in API backend extensions.
+ *
+ * When developing API backend extensions you might need to access information about the session that is making the request.
+ *
+ * This can include the user ID, the site ID, the instance ID, and more. This information is encoded in the token that is sent with the request
+ * and can be accessed using this function.
+ * @returns A promise that resolves to the token info.
+ * @example
+ * ```ts
+ * // In an API backend extension in a Wix CLI project
+ * import { auth } from '@wix/essentials';
+ *
+ * export async function GET(req: Request) {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ *  if (tokenInfo.subjectType === 'USER') {
+ *    return new Response(`Hello user ${tokenInfo.subjectId}`);
+ *  } else if (tokenInfo.subjectType === 'APP') {
+ *    return new Response('Hello app');
+ *  } else if (tokenInfo.subjectType === 'MEMBER') {
+ *    return new Response(`Hello member ${tokenInfo.subjectId}`);
+ *  } else {
+ *    return new Response(`Hello visitor ${tokenInfo.subjectId}`);
+ *  }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * // In a Velo web method
+ * import { auth } from '@wix/essentials';
+ * import { Permissions, webMethod } from 'wix-web-module';
+ *
+ * export const sayHello = webMethod(Permimissions.Anyone, async () => {
+ *  const tokenInfo = await auth.getTokenInfo();
+ *
+ * if (tokenInfo.subjectType === 'USER') {
+ *  return `Hello user ${tokenInfo.subjectId}`;
+ * } else if (tokenInfo.subjectType === 'APP') {
+ *  return 'Hello app';
+ * } else if (tokenInfo.subjectType === 'MEMBER') {
+ *  return `Hello member ${tokenInfo.subjectId}`;
+ * } else {
+ *  return `Hello visitor ${tokenInfo.subjectId}`;
+ * }
+ */
+export const getTokenInfo = createRESTModule((restModuleOpts) => {
+    return async () => {
+        if (!restModuleOpts.getActiveToken) {
+            throw new Error('Unable to get the currently active token. Please make sure you are using an authentication strategy that supports this operation.');
+        }
+        const res = await fetch('https://www.wixapis.com/oauth2/token-info', {
+            method: 'POST',
+            body: JSON.stringify({ token: restModuleOpts.getActiveToken() }),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to fetch token info: ${res.status} - ${res.statusText}. ${await res.text()}`);
+        }
+        return res.json();
+    };
+});

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

@@ -0,0 +1,7 @@
+import type { Host } from '@wix/sdk-types';
+/** @internal */
+export declare const bi: {
+    getLogger: () => ReturnType<NonNullable<Host["getBiLogger"]>>;
+} & import("@wix/sdk-types").HostModule<{
+    getLogger: () => ReturnType<NonNullable<Host["getBiLogger"]>>;
+}, Host>;

package/internal/cjs/build/bi.js

@@ -0,0 +1,10 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+/** @internal */
+export const bi = createHostModule({
+    getLogger: (host) => () => {
+        if (!host.getBiLogger) {
+            throw new Error('Host bi logger is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getBiLogger();
+    },
+});

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

@@ -0,0 +1,7 @@
+import type { ResolvedError, ErrorCodesMap, ErrorHandler } from '@wix/sdk-types';
+export declare const withErrorHandler: <T>(fn: () => Promise<T>, errorCodesMap: ErrorCodesMap) => 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").ShowErrorProps> | null) => void;
+/** @internal */
+export declare const reportRetryAttempt: (error: unknown) => void;
+export type { ErrorHandler, ResolvedError, ErrorCodesMap };

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

@@ -0,0 +1,18 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+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.');
+    }
+    return fn(host.getErrorHandler());
+};
+const errorHandler = createHostModule({
+    withErrorHandler: getFromHostErrorHandlerOrDefault((e) => e.withErrorHandler),
+    getResolvedError: getFromHostErrorHandlerOrDefault((e) => e.getResolvedError),
+    showError: getFromHostErrorHandlerOrDefault((e) => e.showError),
+    reportRetryAttempt: getFromHostErrorHandlerOrDefault((e) => e.reportRetryAttempt),
+});
+export const withErrorHandler = errorHandler.withErrorHandler;
+export const getResolvedError = errorHandler.getResolvedError;
+export const showError = errorHandler.showError;
+/** @internal */
+export const reportRetryAttempt = errorHandler.reportRetryAttempt;

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

@@ -0,0 +1,12 @@
+/** @internal */
+export declare const experiments: {
+    isEnabled_legacy: (specName: string) => boolean;
+    getValue_legacy: (specName: string) => any;
+    isFeatureOn: (featureName: string) => boolean;
+    getABTestVariant: (abTestName: string) => "a" | "b" | "c" | "d" | "e";
+} & import("@wix/sdk-types").HostModule<{
+    isEnabled_legacy: (specName: string) => boolean;
+    getValue_legacy: (specName: string) => any;
+    isFeatureOn: (featureName: string) => boolean;
+    getABTestVariant: (abTestName: string) => "a" | "b" | "c" | "d" | "e";
+}, import("@wix/sdk-types").Host>;

package/internal/cjs/build/experiments.js

@@ -0,0 +1,28 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+/** @internal */
+export const experiments = createHostModule({
+    isEnabled_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().enabled(specName);
+    },
+    getValue_legacy: (host) => (specName) => {
+        if (!host.getPetriExperimentsClient) {
+            throw new Error('Host "PetriExperiments" are not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getPetriExperimentsClient().get(specName);
+    },
+    isFeatureOn: (host) => (featureName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().isFeatureOn(featureName);
+    },
+    getABTestVariant: (host) => (abTestName) => {
+        if (!host.getConductorClient) {
+            throw new Error('Host conductor client is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return host.getConductorClient().getABTestVariant(abTestName);
+    },
+});

package/internal/cjs/build/http-client.d.ts

@@ -0,0 +1,30 @@
+import { DocumentNode, GraphQLFormattedError } from 'graphql';
+import { RESTFunctionDescriptor } from '@wix/sdk-types';
+export declare const fetchWithAuth: typeof fetch & ((restModuleOpts: import("@wix/sdk-types").HttpClient) => typeof fetch);
+export declare const graphql: (<Result, Variables>(query: string | String | DocumentNode | TypedQueryInput<Result, Variables>, variables?: Variables, opts?: {
+    apiVersion: string;
+}) => Promise<{
+    data: Result;
+    errors?: GraphQLFormattedError[];
+}>) & RESTFunctionDescriptor<(<Result, Variables>(query: string | String | DocumentNode | TypedQueryInput<Result, Variables>, variables?: Variables, opts?: {
+    apiVersion: string;
+}) => Promise<{
+    data: Result;
+    errors?: GraphQLFormattedError[];
+}>)>;
+export type TypedQueryInput<Result = {
+    [key: string]: any;
+}, Variables = {
+    [key: string]: any;
+}> = {
+    /**
+     * Type to support `@graphql-typed-document-node/core`
+     * @internal
+     */
+    __apiType?: (variables: Variables) => Result;
+    /**
+     * Type to support `TypedQueryDocumentNode` from `graphql`
+     * @internal
+     */
+    __ensureTypesOfVariablesAndResultMatching?: (variables: Variables) => Result;
+};

package/internal/cjs/build/http-client.js

@@ -0,0 +1,21 @@
+import { createRESTModule } from '@wix/sdk-runtime/rest-modules';
+export const fetchWithAuth = createRESTModule((restModuleOpts) => {
+    return ((url, options) => restModuleOpts.fetchWithAuth(url, options));
+});
+export const graphql = createRESTModule(((restModuleOpts) => {
+    // eslint-disable-next-line @typescript-eslint/no-shadow
+    return async function graphql(query, variables, opts = {
+        apiVersion: 'alpha',
+    }) {
+        const result = await restModuleOpts.request(({ host }) => {
+            const basePath = host === 'www.wixapis.com' ? '/graphql' : '/_api/graphql';
+            return {
+                method: 'POST',
+                url: `${basePath}/${opts.apiVersion}`,
+                data: { query, variables },
+                packageName: '@wix/essentials',
+            };
+        });
+        return result.data;
+    };
+}));

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

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

package/internal/cjs/build/i18n.js

@@ -0,0 +1,17 @@
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+export const i18n = createHostModule({
+    getLanguage: (host) => () => {
+        const language = host.essentials?.language;
+        if (!language) {
+            throw new Error('Host language is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return language;
+    },
+    getLocale: (host) => () => {
+        const locale = host.essentials?.locale;
+        if (!locale) {
+            throw new Error('Host locale is not available on the current host. Make sure to use an updated version of the host initialization pacakge.');
+        }
+        return locale;
+    },
+});

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

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

package/internal/cjs/build/index.js

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

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

@@ -0,0 +1,6 @@
+import type { Host } from '@wix/sdk-types';
+export declare const monitoring: {
+    getMonitoringClient: () => ReturnType<NonNullable<Host["getMonitoringClient"]>>;
+} & import("@wix/sdk-types").HostModule<{
+    getMonitoringClient: () => ReturnType<NonNullable<Host["getMonitoringClient"]>>;
+}, Host>;

package/internal/cjs/build/monitoring.js

@@ -0,0 +1,10 @@
+import { createFallbackMonitoringClient } from '@wix/monitoring';
+import { createHostModule } from '@wix/sdk-runtime/host-modules';
+export const monitoring = createHostModule({
+    getMonitoringClient: (host) => () => {
+        if (!host.getMonitoringClient) {
+            return createFallbackMonitoringClient('Host monitoring client is not available on the current host. Make sure to use an updated version of the host initialization package.');
+        }
+        return host.getMonitoringClient();
+    },
+});

package/internal/cjs/tsconfig.internal.tsbuildinfo

@@ -0,0 +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"],"version":"5.8.3"}

package/internal/tsconfig.internal.cjs.tsbuildinfo

@@ -0,0 +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"],"version":"5.8.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/essentials",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "license": "MIT",
   "main": "cjs/build/index.js",
   "module": "build/index.mjs",
@@ -18,14 +18,15 @@
   ],
   "files": [
     "build",
-    "cjs"
+    "cjs",
+    "internal"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "scripts": {
-    "build": "tsc && tsc --project tsconfig.cjs.json",
+    "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",
@@ -35,25 +36,25 @@
     "*.{js,ts}": "yarn lint"
   },
   "dependencies": {
-    "@wix/monitoring": "^0.18.0",
-    "@wix/sdk-runtime": "^0.3.38",
-    "@wix/sdk-types": "^1.13.6"
+    "@wix/monitoring": "^0.21.0",
+    "@wix/sdk-runtime": "^0.3.52",
+    "@wix/sdk-types": "^1.13.25"
   },
   "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.17.22",
+    "@types/node": "^20.17.47",
     "@vitest/ui": "^1.6.1",
-    "@wix/sdk": "1.15.12",
+    "@wix/sdk": "1.15.22",
     "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.7.3",
-    "typescript": "^5.8.2",
+    "msw": "^2.8.3",
+    "typescript": "^5.8.3",
     "vitest": "^1.6.1",
     "vitest-teamcity-reporter": "^0.3.1"
   },
@@ -74,5 +75,5 @@
       ]
     }
   },
-  "falconPackageHash": "db0e3821e8879a032b11ffe4a48267b2b48a65c18f2a0686aa744371"
+  "falconPackageHash": "acf8fdc9a191264c4e3c35fe2f1770f1722dffc7057ea2dd52c0380f"
 }