@croct/sdk 0.22.2 → 0.22.3

package/evaluator.d.cts

@@ -1,8 +1,10 @@
 import { JsonObject, JsonValue } from '@croct/json';
 import { Token } from './token/token.cjs';
+import { ApiProblem } from './error.cjs';
 import { Location } from './sourceLocation.cjs';
 import { Logger } from './logging/logger.cjs';
 import { ApiKey } from './apiKey.cjs';
+import { UrlSanitizer } from './url.cjs';
 
 type Campaign = {
     name?: string;
@@ -16,12 +18,38 @@ type Page = {
     title?: string;
     referrer?: string;
 };
+type PageEvaluationContext = Omit<EvaluationContext, 'page'> & Required<Pick<EvaluationContext, 'page'>>;
+type PageContextOptions = {
+    urlSanitizer?: UrlSanitizer;
+};
 type EvaluationContext = {
     timeZone?: string;
     campaign?: Campaign;
     page?: Page;
     attributes?: JsonObject;
 };
+declare namespace EvaluationContext {
+    /**
+     * Creates a context describing the page an evaluation refers to.
+     *
+     * The context describes the page currently open in the browser, if any,
+     * extended with the given context. Values provided by the caller take
+     * precedence over the captured ones, so the context can describe a page
+     * other than the one running the code, as in server-side evaluations.
+     *
+     * The URLs of the resulting page are sanitized, whether captured or
+     * provided, so the context never carries what the sanitizer strips.
+     *
+     * @param base The context to extend the captured one with.
+     * @param options The options for creating the context.
+     *
+     * @returns The context describing the page.
+     *
+     * @throws {TypeError} If the URL of the page is not absolute.
+     */
+    function createPageContext(base: PageEvaluationContext, options?: PageContextOptions): PageEvaluationContext;
+    function createPageContext(base?: EvaluationContext, options?: PageContextOptions): EvaluationContext;
+}
 type AllowedFetchOptions = Exclude<keyof RequestInit, 'method' | 'body' | 'headers' | 'signal'>;
 type ExtraFetchOptions<T extends keyof RequestInit = AllowedFetchOptions> = Pick<RequestInit, T> & {
     [key in Exclude<keyof RequestInit, T>]?: never;
@@ -37,21 +65,13 @@ type EvaluationOptions = {
 };
 declare enum EvaluationErrorType {
     TIMEOUT = "https://croct.help/sdk/javascript/request-timeout",
-    UNEXPECTED_ERROR = "https://croct.help/sdk/javascript/unexpected-error",
-    INVALID_QUERY = "https://croct.help/sdk/javascript/invalid-query",
-    TOO_COMPLEX_QUERY = "https://croct.help/sdk/javascript/too-complex-query",
-    EVALUATION_FAILED = "https://croct.help/sdk/javascript/evaluation-failed",
-    UNALLOWED_RESULT = "https://croct.help/sdk/javascript/unallowed-result",
     SUSPENDED_SERVICE = "https://croct.help/sdk/javascript/suspended-service",
-    UNSERIALIZABLE_RESULT = "https://croct.help/sdk/javascript/unserializable-result"
+    TOO_COMPLEX_QUERY = "https://croct.help/sdk/javascript/too-complex-query",
+    INTERNAL_ERROR = "https://croct.help/api/evaluation/internal-error",
+    INVALID_QUERY = "https://croct.help/api/evaluation/invalid-query",
+    EVALUATION_FAILED = "https://croct.help/api/evaluation/evaluation-failed"
 }
-type ErrorResponse = {
-    type: EvaluationErrorType;
-    title: string;
-    status: number;
-    detail?: string;
-};
-declare class EvaluationError<T extends ErrorResponse = ErrorResponse> extends Error {
+declare class EvaluationError<T extends ApiProblem = ApiProblem> extends Error {
     readonly response: T;
     constructor(response: T);
 }
@@ -59,7 +79,7 @@ type QueryErrorDetail = {
     cause: string;
     location: Location;
 };
-type QueryErrorResponse = ErrorResponse & {
+type QueryErrorResponse = ApiProblem & {
     errors: QueryErrorDetail[];
 };
 declare class QueryError extends EvaluationError<QueryErrorResponse> {
@@ -84,4 +104,4 @@ declare class Evaluator {
     toJSON(): never;
 }
 
-export { type Campaign, type Configuration, type ErrorResponse, type EvaluationContext, EvaluationError, EvaluationErrorType, type EvaluationOptions, Evaluator, type Page, QueryError, type QueryErrorResponse };
+export { type Campaign, type Configuration, EvaluationContext, EvaluationError, EvaluationErrorType, type EvaluationOptions, Evaluator, type Page, type PageContextOptions, type PageEvaluationContext, QueryError, type QueryErrorResponse };

package/evaluator.d.ts

@@ -1,8 +1,10 @@
 import { JsonObject, JsonValue } from '@croct/json';
 import { Token } from './token/token.js';
+import { ApiProblem } from './error.js';
 import { Location } from './sourceLocation.js';
 import { Logger } from './logging/logger.js';
 import { ApiKey } from './apiKey.js';
+import { UrlSanitizer } from './url.js';
 
 type Campaign = {
     name?: string;
@@ -16,12 +18,38 @@ type Page = {
     title?: string;
     referrer?: string;
 };
+type PageEvaluationContext = Omit<EvaluationContext, 'page'> & Required<Pick<EvaluationContext, 'page'>>;
+type PageContextOptions = {
+    urlSanitizer?: UrlSanitizer;
+};
 type EvaluationContext = {
     timeZone?: string;
     campaign?: Campaign;
     page?: Page;
     attributes?: JsonObject;
 };
+declare namespace EvaluationContext {
+    /**
+     * Creates a context describing the page an evaluation refers to.
+     *
+     * The context describes the page currently open in the browser, if any,
+     * extended with the given context. Values provided by the caller take
+     * precedence over the captured ones, so the context can describe a page
+     * other than the one running the code, as in server-side evaluations.
+     *
+     * The URLs of the resulting page are sanitized, whether captured or
+     * provided, so the context never carries what the sanitizer strips.
+     *
+     * @param base The context to extend the captured one with.
+     * @param options The options for creating the context.
+     *
+     * @returns The context describing the page.
+     *
+     * @throws {TypeError} If the URL of the page is not absolute.
+     */
+    function createPageContext(base: PageEvaluationContext, options?: PageContextOptions): PageEvaluationContext;
+    function createPageContext(base?: EvaluationContext, options?: PageContextOptions): EvaluationContext;
+}
 type AllowedFetchOptions = Exclude<keyof RequestInit, 'method' | 'body' | 'headers' | 'signal'>;
 type ExtraFetchOptions<T extends keyof RequestInit = AllowedFetchOptions> = Pick<RequestInit, T> & {
     [key in Exclude<keyof RequestInit, T>]?: never;
@@ -37,21 +65,13 @@ type EvaluationOptions = {
 };
 declare enum EvaluationErrorType {
     TIMEOUT = "https://croct.help/sdk/javascript/request-timeout",
-    UNEXPECTED_ERROR = "https://croct.help/sdk/javascript/unexpected-error",
-    INVALID_QUERY = "https://croct.help/sdk/javascript/invalid-query",
-    TOO_COMPLEX_QUERY = "https://croct.help/sdk/javascript/too-complex-query",
-    EVALUATION_FAILED = "https://croct.help/sdk/javascript/evaluation-failed",
-    UNALLOWED_RESULT = "https://croct.help/sdk/javascript/unallowed-result",
     SUSPENDED_SERVICE = "https://croct.help/sdk/javascript/suspended-service",
-    UNSERIALIZABLE_RESULT = "https://croct.help/sdk/javascript/unserializable-result"
+    TOO_COMPLEX_QUERY = "https://croct.help/sdk/javascript/too-complex-query",
+    INTERNAL_ERROR = "https://croct.help/api/evaluation/internal-error",
+    INVALID_QUERY = "https://croct.help/api/evaluation/invalid-query",
+    EVALUATION_FAILED = "https://croct.help/api/evaluation/evaluation-failed"
 }
-type ErrorResponse = {
-    type: EvaluationErrorType;
-    title: string;
-    status: number;
-    detail?: string;
-};
-declare class EvaluationError<T extends ErrorResponse = ErrorResponse> extends Error {
+declare class EvaluationError<T extends ApiProblem = ApiProblem> extends Error {
     readonly response: T;
     constructor(response: T);
 }
@@ -59,7 +79,7 @@ type QueryErrorDetail = {
     cause: string;
     location: Location;
 };
-type QueryErrorResponse = ErrorResponse & {
+type QueryErrorResponse = ApiProblem & {
     errors: QueryErrorDetail[];
 };
 declare class QueryError extends EvaluationError<QueryErrorResponse> {
@@ -84,4 +104,4 @@ declare class Evaluator {
     toJSON(): never;
 }
 
-export { type Campaign, type Configuration, type ErrorResponse, type EvaluationContext, EvaluationError, EvaluationErrorType, type EvaluationOptions, Evaluator, type Page, QueryError, type QueryErrorResponse };
+export { type Campaign, type Configuration, EvaluationContext, EvaluationError, EvaluationErrorType, type EvaluationOptions, Evaluator, type Page, type PageContextOptions, type PageEvaluationContext, QueryError, type QueryErrorResponse };

package/evaluator.js

@@ -4,15 +4,62 @@ import { getLength, getLocation } from "./sourceLocation.js";
 import { NullLogger } from "./logging/index.js";
 import { ApiKey } from "./apiKey.js";
 import { Help } from "./help.js";
+import { sanitizeUrl } from "./url.js";
+const UNKNOWN_TIME_ZONE = "Etc/Unknown";
+var EvaluationContext;
+((EvaluationContext2) => {
+  function createPageContext(base = {}, options = {}) {
+    const { page, timeZone = detectTimeZone(), attributes, ...context } = base;
+    const currentPage = mergePage(capturePage(), page);
+    return {
+      ...context,
+      ...currentPage !== void 0 ? { page: normalizePage(currentPage, options.urlSanitizer) } : {},
+      ...timeZone !== void 0 ? { timeZone } : {},
+      ...attributes !== void 0 && Object.keys(attributes).length > 0 ? { attributes } : {}
+    };
+  }
+  EvaluationContext2.createPageContext = createPageContext;
+  function capturePage() {
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    return {
+      url: window.location.href,
+      title: document.title,
+      referrer: document.referrer
+    };
+  }
+  function mergePage(currentPage, providedPage) {
+    if (providedPage === void 0) {
+      return currentPage;
+    }
+    return currentPage === void 0 ? providedPage : { ...currentPage, ...providedPage };
+  }
+  function normalizePage({ url, title, referrer }, urlSanitizer) {
+    return {
+      url: new URL(sanitizeUrl(url, urlSanitizer)).toString(),
+      ...title !== void 0 && title !== "" ? { title } : {},
+      ...referrer !== void 0 && referrer !== "" ? { referrer: sanitizeUrl(referrer, urlSanitizer) } : {}
+    };
+  }
+  function detectTimeZone() {
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    const { timeZone } = Intl.DateTimeFormat().resolvedOptions();
+    if (timeZone === void 0 || timeZone === UNKNOWN_TIME_ZONE) {
+      return void 0;
+    }
+    return timeZone;
+  }
+})(EvaluationContext || (EvaluationContext = {}));
 var EvaluationErrorType = /* @__PURE__ */ ((EvaluationErrorType2) => {
   EvaluationErrorType2["TIMEOUT"] = "https://croct.help/sdk/javascript/request-timeout";
-  EvaluationErrorType2["UNEXPECTED_ERROR"] = "https://croct.help/sdk/javascript/unexpected-error";
-  EvaluationErrorType2["INVALID_QUERY"] = "https://croct.help/sdk/javascript/invalid-query";
-  EvaluationErrorType2["TOO_COMPLEX_QUERY"] = "https://croct.help/sdk/javascript/too-complex-query";
-  EvaluationErrorType2["EVALUATION_FAILED"] = "https://croct.help/sdk/javascript/evaluation-failed";
-  EvaluationErrorType2["UNALLOWED_RESULT"] = "https://croct.help/sdk/javascript/unallowed-result";
   EvaluationErrorType2["SUSPENDED_SERVICE"] = "https://croct.help/sdk/javascript/suspended-service";
-  EvaluationErrorType2["UNSERIALIZABLE_RESULT"] = "https://croct.help/sdk/javascript/unserializable-result";
+  EvaluationErrorType2["TOO_COMPLEX_QUERY"] = "https://croct.help/sdk/javascript/too-complex-query";
+  EvaluationErrorType2["INTERNAL_ERROR"] = "https://croct.help/api/evaluation/internal-error";
+  EvaluationErrorType2["INVALID_QUERY"] = "https://croct.help/api/evaluation/invalid-query";
+  EvaluationErrorType2["EVALUATION_FAILED"] = "https://croct.help/api/evaluation/evaluation-failed";
   return EvaluationErrorType2;
 })(EvaluationErrorType || {});
 class EvaluationError extends Error {
@@ -80,7 +127,7 @@ const _Evaluator = class _Evaluator {
               // Request Timeout
             };
             abortController.abort();
-            this.logHelp(response.status);
+            this.logHelp(response);
             reject(new EvaluationError(response));
           },
           timeout
@@ -105,12 +152,11 @@ const _Evaluator = class _Evaluator {
             if (response.ok) {
               return resolve(body);
             }
-            this.logHelp(response.status);
             const problem = body;
+            this.logHelp(problem);
             switch (problem.type) {
-              case "https://croct.help/sdk/javascript/invalid-query" /* INVALID_QUERY */:
-              case "https://croct.help/sdk/javascript/evaluation-failed" /* EVALUATION_FAILED */:
-              case "https://croct.help/sdk/javascript/too-complex-query" /* TOO_COMPLEX_QUERY */:
+              case "https://croct.help/api/evaluation/invalid-query" /* INVALID_QUERY */:
+              case "https://croct.help/api/evaluation/evaluation-failed" /* EVALUATION_FAILED */:
                 reject(new QueryError(problem));
                 break;
               default:
@@ -130,7 +176,7 @@ const _Evaluator = class _Evaluator {
             reject(
               new EvaluationError({
                 title: formatMessage(error),
-                type: "https://croct.help/sdk/javascript/unexpected-error" /* UNEXPECTED_ERROR */,
+                type: "https://croct.help/api/evaluation/internal-error" /* INTERNAL_ERROR */,
                 detail: "Please try again or contact Croct support if the error persists.",
                 status: 500
                 // Internal Server Error
@@ -181,8 +227,8 @@ const _Evaluator = class _Evaluator {
       body: JSON.stringify(body)
     });
   }
-  logHelp(statusCode) {
-    const help = Help.forStatusCode(statusCode);
+  logHelp(problem) {
+    const help = Help.forApiProblem(problem);
     if (help !== void 0) {
       this.logger.error(help);
     }
@@ -194,6 +240,7 @@ const _Evaluator = class _Evaluator {
 _Evaluator.MAX_QUERY_LENGTH = MAX_QUERY_LENGTH;
 let Evaluator = _Evaluator;
 export {
+  EvaluationContext,
   EvaluationError,
   EvaluationErrorType,
   Evaluator,

package/facade/contentFetcherFacade.d.cts

@@ -5,9 +5,11 @@ import { TokenProvider } from '../token/token.cjs';
 import { CidAssigner } from '../cid/assigner.cjs';
 import '@croct/content-model/definition';
 import '../evaluator.cjs';
+import '../error.cjs';
 import '../sourceLocation.cjs';
 import '../logging/logger.cjs';
 import '../apiKey.cjs';
+import '../url.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
 

package/facade/contentFetcherFacade.d.ts

@@ -5,9 +5,11 @@ import { TokenProvider } from '../token/token.js';
 import { CidAssigner } from '../cid/assigner.js';
 import '@croct/content-model/definition';
 import '../evaluator.js';
+import '../error.js';
 import '../sourceLocation.js';
 import '../logging/logger.js';
 import '../apiKey.js';
+import '../url.js';
 import '../tab.js';
 import '../eventManager.js';
 

package/facade/evaluatorFacade.cjs

@@ -22,6 +22,7 @@ __export(evaluatorFacade_exports, {
   TabContextFactory: () => TabContextFactory
 });
 module.exports = __toCommonJS(evaluatorFacade_exports);
+var import_evaluator = require('../evaluator.cjs');
 var import_schema = require('../schema/index.cjs');
 var import_error = require('../error.cjs');
 function validate(options) {
@@ -65,24 +66,15 @@ class TabContextFactory {
     this.timeZone = timeZone;
   }
   createContext(attributes) {
-    const url = new URL(this.tab.url);
-    const context = {};
-    const page = {
-      title: this.tab.title,
-      url: url.toString()
-    };
-    const { referrer } = this.tab;
-    if (referrer.length > 0) {
-      page.referrer = referrer;
-    }
-    context.page = page;
-    if (this.timeZone !== void 0) {
-      context.timeZone = this.timeZone;
-    }
-    if (attributes !== void 0 && Object.keys(attributes).length > 0) {
-      context.attributes = attributes;
-    }
-    return context;
+    return import_evaluator.EvaluationContext.createPageContext({
+      page: {
+        url: this.tab.url,
+        title: this.tab.title,
+        referrer: this.tab.referrer
+      },
+      ...this.timeZone !== void 0 ? { timeZone: this.timeZone } : {},
+      ...attributes !== void 0 ? { attributes } : {}
+    });
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/facade/evaluatorFacade.d.cts

@@ -3,9 +3,11 @@ import { EvaluationContext, Evaluator } from '../evaluator.cjs';
 import { Tab } from '../tab.cjs';
 import { TokenProvider } from '../token/token.cjs';
 import { CidAssigner } from '../cid/assigner.cjs';
+import '../error.cjs';
 import '../sourceLocation.cjs';
 import '../logging/logger.cjs';
 import '../apiKey.cjs';
+import '../url.cjs';
 import '../eventManager.cjs';
 
 type EvaluationOptions = {

package/facade/evaluatorFacade.d.ts

@@ -3,9 +3,11 @@ import { EvaluationContext, Evaluator } from '../evaluator.js';
 import { Tab } from '../tab.js';
 import { TokenProvider } from '../token/token.js';
 import { CidAssigner } from '../cid/assigner.js';
+import '../error.js';
 import '../sourceLocation.js';
 import '../logging/logger.js';
 import '../apiKey.js';
+import '../url.js';
 import '../eventManager.js';
 
 type EvaluationOptions = {

package/facade/evaluatorFacade.js

@@ -1,3 +1,4 @@
+import { EvaluationContext } from "../evaluator.js";
 import { evaluationOptionsSchema as optionsSchema } from "../schema/index.js";
 import { formatCause } from "../error.js";
 function validate(options) {
@@ -41,24 +42,15 @@ class TabContextFactory {
     this.timeZone = timeZone;
   }
   createContext(attributes) {
-    const url = new URL(this.tab.url);
-    const context = {};
-    const page = {
-      title: this.tab.title,
-      url: url.toString()
-    };
-    const { referrer } = this.tab;
-    if (referrer.length > 0) {
-      page.referrer = referrer;
-    }
-    context.page = page;
-    if (this.timeZone !== void 0) {
-      context.timeZone = this.timeZone;
-    }
-    if (attributes !== void 0 && Object.keys(attributes).length > 0) {
-      context.attributes = attributes;
-    }
-    return context;
+    return EvaluationContext.createPageContext({
+      page: {
+        url: this.tab.url,
+        title: this.tab.title,
+        referrer: this.tab.referrer
+      },
+      ...this.timeZone !== void 0 ? { timeZone: this.timeZone } : {},
+      ...attributes !== void 0 ? { attributes } : {}
+    });
   }
 }
 export {

package/facade/index.d.cts

@@ -9,8 +9,10 @@ import '@croct/json';
 import '../evaluator.cjs';
 import '../token/token.cjs';
 import '../apiKey.cjs';
+import '../error.cjs';
 import '../sourceLocation.cjs';
 import '../logging/logger.cjs';
+import '../url.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
 import '../cid/assigner.cjs';

package/facade/index.d.ts

@@ -9,8 +9,10 @@ import '@croct/json';
 import '../evaluator.js';
 import '../token/token.js';
 import '../apiKey.js';
+import '../error.js';
 import '../sourceLocation.js';
 import '../logging/logger.js';
+import '../url.js';
 import '../tab.js';
 import '../eventManager.js';
 import '../cid/assigner.js';

package/facade/sdkFacade.d.cts

@@ -8,15 +8,17 @@ import { Logger } from '../logging/logger.cjs';
 import { SdkEventMap } from '../sdkEvents.cjs';
 import { EventManager } from '../eventManager.cjs';
 import { CidAssigner } from '../cid/assigner.cjs';
-import { UrlSanitizer } from '../tab.cjs';
+import { UrlSanitizer } from '../url.cjs';
 import { ContentFetcherFacade } from './contentFetcherFacade.cjs';
 import { CookieCacheConfiguration } from '../cache/cookieCache.cjs';
 import './sessionPatch.cjs';
 import './userPatch.cjs';
 import '@croct/json';
 import '../evaluator.cjs';
+import '../error.cjs';
 import '../sourceLocation.cjs';
 import '../apiKey.cjs';
+import '../tab.cjs';
 import '../trackingEvents.cjs';
 import '../patch.cjs';
 import '../utilityTypes.cjs';

package/facade/sdkFacade.d.ts

@@ -8,15 +8,17 @@ import { Logger } from '../logging/logger.js';
 import { SdkEventMap } from '../sdkEvents.js';
 import { EventManager } from '../eventManager.js';
 import { CidAssigner } from '../cid/assigner.js';
-import { UrlSanitizer } from '../tab.js';
+import { UrlSanitizer } from '../url.js';
 import { ContentFetcherFacade } from './contentFetcherFacade.js';
 import { CookieCacheConfiguration } from '../cache/cookieCache.js';
 import './sessionPatch.js';
 import './userPatch.js';
 import '@croct/json';
 import '../evaluator.js';
+import '../error.js';
 import '../sourceLocation.js';
 import '../apiKey.js';
+import '../tab.js';
 import '../trackingEvents.js';
 import '../patch.js';
 import '../utilityTypes.js';

package/facade/sessionFacade.d.cts

@@ -3,6 +3,7 @@ import { SessionPatch } from './sessionPatch.cjs';
 import '../logging/logger.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
+import '../url.cjs';
 import '../channel/channel.cjs';
 import '../retry/policy.cjs';
 import '../token/token.cjs';

package/facade/sessionFacade.d.ts

@@ -3,6 +3,7 @@ import { SessionPatch } from './sessionPatch.js';
 import '../logging/logger.js';
 import '../tab.js';
 import '../eventManager.js';
+import '../url.js';
 import '../channel/channel.js';
 import '../retry/policy.js';
 import '../token/token.js';

package/facade/sessionPatch.d.cts

@@ -7,6 +7,7 @@ import '../utilityTypes.cjs';
 import '../logging/logger.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
+import '../url.cjs';
 import '../channel/channel.cjs';
 import '../retry/policy.cjs';
 import '../token/token.cjs';

package/facade/sessionPatch.d.ts

@@ -7,6 +7,7 @@ import '../utilityTypes.js';
 import '../logging/logger.js';
 import '../tab.js';
 import '../eventManager.js';
+import '../url.js';
 import '../channel/channel.js';
 import '../retry/policy.js';
 import '../token/token.js';

package/facade/trackerFacade.d.cts

@@ -6,6 +6,7 @@ import '../utilityTypes.cjs';
 import '../logging/logger.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
+import '../url.cjs';
 import '../channel/channel.cjs';
 import '../retry/policy.cjs';
 import '../token/token.cjs';

package/facade/trackerFacade.d.ts

@@ -6,6 +6,7 @@ import '../utilityTypes.js';
 import '../logging/logger.js';
 import '../tab.js';
 import '../eventManager.js';
+import '../url.js';
 import '../channel/channel.js';
 import '../retry/policy.js';
 import '../token/token.js';

package/facade/userFacade.d.cts

@@ -4,6 +4,7 @@ import { Context } from '../context.cjs';
 import '../logging/logger.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
+import '../url.cjs';
 import '../channel/channel.cjs';
 import '../retry/policy.cjs';
 import '../token/token.cjs';

package/facade/userFacade.d.ts

@@ -4,6 +4,7 @@ import { Context } from '../context.js';
 import '../logging/logger.js';
 import '../tab.js';
 import '../eventManager.js';
+import '../url.js';
 import '../channel/channel.js';
 import '../retry/policy.js';
 import '../token/token.js';

package/facade/userPatch.d.cts

@@ -7,6 +7,7 @@ import '../utilityTypes.cjs';
 import '../logging/logger.cjs';
 import '../tab.cjs';
 import '../eventManager.cjs';
+import '../url.cjs';
 import '../channel/channel.cjs';
 import '../retry/policy.cjs';
 import '../token/token.cjs';

package/facade/userPatch.d.ts

@@ -7,6 +7,7 @@ import '../utilityTypes.js';
 import '../logging/logger.js';
 import '../tab.js';
 import '../eventManager.js';
+import '../url.js';
 import '../channel/channel.js';
 import '../retry/policy.js';
 import '../token/token.js';

package/help.cjs

@@ -20,20 +20,32 @@ __export(help_exports, {
   Help: () => Help
 });
 module.exports = __toCommonJS(help_exports);
+var AuthErrorType = /* @__PURE__ */ ((AuthErrorType2) => {
+  AuthErrorType2["FORBIDDEN_ORIGIN"] = "https://croct.help/api/authentication/forbidden-origin";
+  AuthErrorType2["QUOTA_EXCEEDED"] = "https://croct.help/api/authentication/quota-exceeded";
+  return AuthErrorType2;
+})(AuthErrorType || {});
 var Help;
 ((Help2) => {
+  function forApiProblem(problem) {
+    switch (problem.type) {
+      case "https://croct.help/api/authentication/forbidden-origin" /* FORBIDDEN_ORIGIN */:
+        return "The origin of the request is not allowed in your application settings. For help, see https://croct.help/sdk/javascript/unauthorized-origin";
+      case "https://croct.help/api/authentication/quota-exceeded" /* QUOTA_EXCEEDED */:
+        return "The application has exceeded the monthly active users (MAU) quota. For help, see https://croct.help/sdk/javascript/mau-exceeded";
+      default:
+        return Help2.forStatusCode(problem.status);
+    }
+  }
+  Help2.forApiProblem = forApiProblem;
   function forStatusCode(statusCode) {
     switch (statusCode) {
       case 202:
         return "The service is temporarily suspended. For help, see https://croct.help/sdk/javascript/suspended-service";
       case 401:
         return "The request was not authorized, most likely due to invalid credentials. For help, see https://croct.help/sdk/javascript/invalid-credentials";
-      case 403:
-        return "The origin of the request is not allowed in your application settings. For help, see https://croct.help/sdk/javascript/unauthorized-origin";
       case 408:
         return "The request timed out. For help, see https://croct.help/sdk/javascript/request-timeout";
-      case 423:
-        return "The application has exceeded the monthly active users (MAU) quota. For help, see https://croct.help/sdk/javascript/mau-exceeded";
       default:
         return void 0;
     }

package/help.d.cts

@@ -1,5 +1,8 @@
+import { ApiProblem } from './error.cjs';
+
 declare namespace Help {
-    function forStatusCode(statusCode: 204 | 401 | 403 | 408 | 423): string;
+    function forApiProblem(problem: ApiProblem): string | undefined;
+    function forStatusCode(statusCode: 202 | 401 | 408): string;
     function forStatusCode(statusCode: number): string | undefined;
 }
 

package/help.d.ts

@@ -1,5 +1,8 @@
+import { ApiProblem } from './error.js';
+
 declare namespace Help {
-    function forStatusCode(statusCode: 204 | 401 | 403 | 408 | 423): string;
+    function forApiProblem(problem: ApiProblem): string | undefined;
+    function forStatusCode(statusCode: 202 | 401 | 408): string;
     function forStatusCode(statusCode: number): string | undefined;
 }