@croct/sdk 0.22.2 → 0.22.4

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;
 }
 

package/help.js

@@ -1,17 +1,29 @@
+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/index.d.cts

@@ -7,6 +7,7 @@ import './apiKey.cjs';
 import './cache/cache.cjs';
 import './tab.cjs';
 import './eventManager.cjs';
+import './url.cjs';
 import './sdkEvents.cjs';
 import './logging/logger.cjs';
 import './tracker.cjs';
@@ -16,6 +17,7 @@ import './trackingEvents.cjs';
 import './patch.cjs';
 import './utilityTypes.cjs';
 import './evaluator.cjs';
+import './error.cjs';
 import './sourceLocation.cjs';
 import './cid/assigner.cjs';
 import './contentFetcher.cjs';

package/index.d.ts

@@ -7,6 +7,7 @@ import './apiKey.js';
 import './cache/cache.js';
 import './tab.js';
 import './eventManager.js';
+import './url.js';
 import './sdkEvents.js';
 import './logging/logger.js';
 import './tracker.js';
@@ -16,6 +17,7 @@ import './trackingEvents.js';
 import './patch.js';
 import './utilityTypes.js';
 import './evaluator.js';
+import './error.js';
 import './sourceLocation.js';
 import './cid/assigner.js';
 import './contentFetcher.js';

package/interactionMonitor.cjs

@@ -30,6 +30,7 @@ class InteractionMonitor {
     this.scrollDebounceInterval = options.scrollDebounceInterval ?? 250;
     this.handleClick = this.handleClick.bind(this);
     this.handleScroll = this.handleScroll.bind(this);
+    this.handleResize = this.handleResize.bind(this);
   }
   addListener(type, listener) {
     this.eventManager.addListener(type, listener);
@@ -47,6 +48,7 @@ class InteractionMonitor {
     this.enabled = true;
     window.addEventListener("click", this.handleClick, true);
     window.addEventListener("scroll", this.handleScroll, true);
+    window.addEventListener("resize", this.handleResize, true);
   }
   disable() {
     if (!this.enabled) {
@@ -55,6 +57,7 @@ class InteractionMonitor {
     this.enabled = false;
     window.removeEventListener("click", this.handleClick, true);
     window.removeEventListener("scroll", this.handleScroll, true);
+    window.removeEventListener("resize", this.handleResize, true);
     this.flushPendingScroll();
   }
   handleClick(event) {
@@ -75,22 +78,47 @@ class InteractionMonitor {
       }
     });
   }
+  handleResize() {
+    if (this.scrollDebounceTimer !== void 0) {
+      window.clearTimeout(this.scrollDebounceTimer);
+      this.scrollDebounceTimer = void 0;
+    }
+    const currentPosition = {
+      x: Math.max(0, Math.round(window.scrollX)),
+      y: Math.max(0, Math.round(window.scrollY))
+    };
+    const currentSurfaceSize = {
+      width: document.documentElement.scrollWidth,
+      height: document.documentElement.scrollHeight
+    };
+    this.scrollState = {
+      start: currentPosition,
+      lastPosition: currentPosition,
+      surfaceSize: currentSurfaceSize
+    };
+  }
   handleScroll() {
     const currentPosition = {
       x: Math.max(0, Math.round(window.scrollX)),
       y: Math.max(0, Math.round(window.scrollY))
     };
-    if (this.scrollState === void 0) {
+    const currentSurfaceSize = {
+      width: document.documentElement.scrollWidth,
+      height: document.documentElement.scrollHeight
+    };
+    if (this.scrollState?.surfaceSize.width !== currentSurfaceSize.width || this.scrollState.surfaceSize.height !== currentSurfaceSize.height) {
       this.scrollState = {
         start: currentPosition,
-        lastPosition: currentPosition
+        lastPosition: currentPosition,
+        surfaceSize: currentSurfaceSize
       };
     } else if (this.hasDirectionChanged(this.scrollState, currentPosition)) {
       const turningPoint = this.scrollState.lastPosition;
       this.flushPendingScroll(turningPoint);
       this.scrollState = {
         start: turningPoint,
-        lastPosition: currentPosition
+        lastPosition: currentPosition,
+        surfaceSize: currentSurfaceSize
       };
     } else {
       this.scrollState.lastPosition = currentPosition;
@@ -148,12 +176,20 @@ class InteractionMonitor {
     if (this.scrollState === void 0) {
       return;
     }
-    const { start } = this.scrollState;
+    const state = this.scrollState;
+    this.scrollState = void 0;
+    const currentSurfaceSize = {
+      width: document.documentElement.scrollWidth,
+      height: document.documentElement.scrollHeight
+    };
+    if (state.surfaceSize.width !== currentSurfaceSize.width || state.surfaceSize.height !== currentSurfaceSize.height) {
+      return;
+    }
+    const { start } = state;
     const destination = end ?? {
       x: Math.max(0, Math.round(window.scrollX)),
       y: Math.max(0, Math.round(window.scrollY))
     };
-    this.scrollState = void 0;
     if (start.x === destination.x && start.y === destination.y) {
       return;
     }
@@ -161,10 +197,7 @@ class InteractionMonitor {
       type: "userScrolled",
       start,
       end: destination,
-      surfaceSize: {
-        width: document.documentElement.scrollWidth,
-        height: document.documentElement.scrollHeight
-      },
+      surfaceSize: state.surfaceSize,
       // Uses clientWidth/clientHeight instead of innerWidth/innerHeight to get the
       // layout viewport size, which remains stable regardless of pinch-to-zoom level
       // on mobile devices.

package/interactionMonitor.d.cts

@@ -27,6 +27,7 @@ declare class InteractionMonitor {
     enable(): void;
     disable(): void;
     private handleClick;
+    private handleResize;
     private handleScroll;
     /**
      * Determines whether the scroll direction has reversed on either axis.

package/interactionMonitor.d.ts

@@ -27,6 +27,7 @@ declare class InteractionMonitor {
     enable(): void;
     disable(): void;
     private handleClick;
+    private handleResize;
     private handleScroll;
     /**
      * Determines whether the scroll direction has reversed on either axis.

package/interactionMonitor.js

@@ -8,6 +8,7 @@ class InteractionMonitor {
     this.scrollDebounceInterval = options.scrollDebounceInterval ?? 250;
     this.handleClick = this.handleClick.bind(this);
     this.handleScroll = this.handleScroll.bind(this);
+    this.handleResize = this.handleResize.bind(this);
   }
   addListener(type, listener) {
     this.eventManager.addListener(type, listener);
@@ -25,6 +26,7 @@ class InteractionMonitor {
     this.enabled = true;
     window.addEventListener("click", this.handleClick, true);
     window.addEventListener("scroll", this.handleScroll, true);
+    window.addEventListener("resize", this.handleResize, true);
   }
   disable() {
     if (!this.enabled) {
@@ -33,6 +35,7 @@ class InteractionMonitor {
     this.enabled = false;
     window.removeEventListener("click", this.handleClick, true);
     window.removeEventListener("scroll", this.handleScroll, true);
+    window.removeEventListener("resize", this.handleResize, true);
     this.flushPendingScroll();
   }
   handleClick(event) {
@@ -53,22 +56,47 @@ class InteractionMonitor {
       }
     });
   }
+  handleResize() {
+    if (this.scrollDebounceTimer !== void 0) {
+      window.clearTimeout(this.scrollDebounceTimer);
+      this.scrollDebounceTimer = void 0;
+    }
+    const currentPosition = {
+      x: Math.max(0, Math.round(window.scrollX)),
+      y: Math.max(0, Math.round(window.scrollY))
+    };
+    const currentSurfaceSize = {
+      width: document.documentElement.scrollWidth,
+      height: document.documentElement.scrollHeight
+    };
+    this.scrollState = {
+      start: currentPosition,
+      lastPosition: currentPosition,
+      surfaceSize: currentSurfaceSize
+    };
+  }
   handleScroll() {
     const currentPosition = {
       x: Math.max(0, Math.round(window.scrollX)),
       y: Math.max(0, Math.round(window.scrollY))
     };
-    if (this.scrollState === void 0) {
+    const currentSurfaceSize = {
+      width: document.documentElement.scrollWidth,
+      height: document.documentElement.scrollHeight
+    };
+    if (this.scrollState?.surfaceSize.width !== currentSurfaceSize.width || this.scrollState.surfaceSize.height !== currentSurfaceSize.height) {
       this.scrollState = {
         start: currentPosition,
-        lastPosition: currentPosition
+        lastPosition: currentPosition,
+        surfaceSize: currentSurfaceSize
       };
     } else if (this.hasDirectionChanged(this.scrollState, currentPosition)) {
       const turningPoint = this.scrollState.lastPosition;
       this.flushPendingScroll(turningPoint);
       this.scrollState = {
         start: turningPoint,
-        lastPosition: currentPosition
+        lastPosition: currentPosition,
+        surfaceSize: currentSurfaceSize
       };
     } else {
       this.scrollState.lastPosition = currentPosition;
@@ -126,12 +154,20 @@ class InteractionMonitor {
     if (this.scrollState === void 0) {
       return;
     }
-    const { start } = this.scrollState;
+    const state = this.scrollState;
+    this.scrollState = void 0;
+    const currentSurfaceSize = {
+      width: document.documentElement.scrollWidth,
+      height: document.documentElement.scrollHeight
+    };
+    if (state.surfaceSize.width !== currentSurfaceSize.width || state.surfaceSize.height !== currentSurfaceSize.height) {
+      return;
+    }
+    const { start } = state;
     const destination = end ?? {
       x: Math.max(0, Math.round(window.scrollX)),
       y: Math.max(0, Math.round(window.scrollY))
     };
-    this.scrollState = void 0;
     if (start.x === destination.x && start.y === destination.y) {
       return;
     }
@@ -139,10 +175,7 @@ class InteractionMonitor {
       type: "userScrolled",
       start,
       end: destination,
-      surfaceSize: {
-        width: document.documentElement.scrollWidth,
-        height: document.documentElement.scrollHeight
-      },
+      surfaceSize: state.surfaceSize,
       // Uses clientWidth/clientHeight instead of innerWidth/innerHeight to get the
       // layout viewport size, which remains stable regardless of pinch-to-zoom level
       // on mobile devices.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@croct/sdk",
-  "version": "0.22.2",
+  "version": "0.22.4",
   "description": "Croct SDK for JavaScript.",
   "license": "MIT",
   "author": {

package/sdk.d.cts

@@ -5,17 +5,19 @@ import { Evaluator } from './evaluator.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 { ContentFetcher } from './contentFetcher.cjs';
 import { TokenStore } from './token/token.cjs';
 import { CookieCacheConfiguration } from './cache/cookieCache.cjs';
 import './cache/cache.cjs';
+import './tab.cjs';
 import './channel/channel.cjs';
 import './retry/policy.cjs';
 import './trackingEvents.cjs';
 import './patch.cjs';
 import '@croct/json';
 import './utilityTypes.cjs';
+import './error.cjs';
 import './sourceLocation.cjs';
 import './apiKey.cjs';
 import '@croct/content-model/definition';

package/sdk.d.ts

@@ -5,17 +5,19 @@ import { Evaluator } from './evaluator.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 { ContentFetcher } from './contentFetcher.js';
 import { TokenStore } from './token/token.js';
 import { CookieCacheConfiguration } from './cache/cookieCache.js';
 import './cache/cache.js';
+import './tab.js';
 import './channel/channel.js';
 import './retry/policy.js';
 import './trackingEvents.js';
 import './patch.js';
 import '@croct/json';
 import './utilityTypes.js';
+import './error.js';
 import './sourceLocation.js';
 import './apiKey.js';
 import '@croct/content-model/definition';

package/tab.cjs

@@ -21,6 +21,7 @@ __export(tab_exports, {
 });
 module.exports = __toCommonJS(tab_exports);
 var import_eventManager = require('./eventManager.cjs');
+var import_url = require('./url.cjs');
 const EventMap = {
   focus: "focus",
   blur: "blur",
@@ -82,11 +83,7 @@ class Tab {
     this.eventManager.removeListener(type, listener);
   }
   sanitizeUrl(url) {
-    const normalized = window.encodeURI(window.decodeURI(url));
-    if (this.urlSanitizer !== void 0) {
-      return this.urlSanitizer(normalized).toString();
-    }
-    return normalized;
+    return (0, import_url.sanitizeUrl)(url, this.urlSanitizer);
   }
   emit(type, event) {
     this.eventManager.dispatch(type, event);

package/tab.d.cts

@@ -1,4 +1,5 @@
 import { EventListener } from './eventManager.cjs';
+import { UrlSanitizer } from './url.cjs';
 
 type TabEvent<T = Record<string, unknown>> = CustomEvent<{
     tab: Tab;
@@ -9,7 +10,6 @@ type TabVisibilityChangeEvent = TabEvent<{
 type TabUrlChangeEvent = TabEvent<{
     url: string;
 }>;
-type UrlSanitizer = (url: string) => URL;
 type TabEventMap = {
     focus: TabEvent;
     blur: TabEvent;
@@ -37,4 +37,4 @@ declare class Tab {
     private static addUrlChangeListener;
 }
 
-export { Tab, type TabEvent, type TabUrlChangeEvent, type TabVisibilityChangeEvent, type UrlSanitizer };
+export { Tab, type TabEvent, type TabUrlChangeEvent, type TabVisibilityChangeEvent, UrlSanitizer };

package/tab.d.ts

@@ -1,4 +1,5 @@
 import { EventListener } from './eventManager.js';
+import { UrlSanitizer } from './url.js';
 
 type TabEvent<T = Record<string, unknown>> = CustomEvent<{
     tab: Tab;
@@ -9,7 +10,6 @@ type TabVisibilityChangeEvent = TabEvent<{
 type TabUrlChangeEvent = TabEvent<{
     url: string;
 }>;
-type UrlSanitizer = (url: string) => URL;
 type TabEventMap = {
     focus: TabEvent;
     blur: TabEvent;
@@ -37,4 +37,4 @@ declare class Tab {
     private static addUrlChangeListener;
 }
 
-export { Tab, type TabEvent, type TabUrlChangeEvent, type TabVisibilityChangeEvent, type UrlSanitizer };
+export { Tab, type TabEvent, type TabUrlChangeEvent, type TabVisibilityChangeEvent, UrlSanitizer };

package/tab.js

@@ -1,4 +1,5 @@
 import { SynchronousEventManager } from "./eventManager.js";
+import { sanitizeUrl } from "./url.js";
 const EventMap = {
   focus: "focus",
   blur: "blur",
@@ -60,11 +61,7 @@ class Tab {
     this.eventManager.removeListener(type, listener);
   }
   sanitizeUrl(url) {
-    const normalized = window.encodeURI(window.decodeURI(url));
-    if (this.urlSanitizer !== void 0) {
-      return this.urlSanitizer(normalized).toString();
-    }
-    return normalized;
+    return sanitizeUrl(url, this.urlSanitizer);
   }
   emit(type, event) {
     this.eventManager.dispatch(type, event);

package/tracker.d.cts

@@ -5,6 +5,7 @@ import { RetryPolicy } from './retry/policy.cjs';
 import { TokenProvider, Token } from './token/token.cjs';
 import { Beacon, TrackingEvent, TrackingEventContext, PartialTrackingEvent } from './trackingEvents.cjs';
 import './eventManager.cjs';
+import './url.cjs';
 import '@croct/json';
 import './apiKey.cjs';
 import './patch.cjs';

package/tracker.d.ts

@@ -5,6 +5,7 @@ import { RetryPolicy } from './retry/policy.js';
 import { TokenProvider, Token } from './token/token.js';
 import { Beacon, TrackingEvent, TrackingEventContext, PartialTrackingEvent } from './trackingEvents.js';
 import './eventManager.js';
+import './url.js';
 import '@croct/json';
 import './apiKey.js';
 import './patch.js';

package/url.cjs

@@ -0,0 +1,30 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var url_exports = {};
+__export(url_exports, {
+  sanitizeUrl: () => sanitizeUrl
+});
+module.exports = __toCommonJS(url_exports);
+function sanitizeUrl(url, sanitizer) {
+  const normalizedUrl = encodeURI(decodeURI(url));
+  return sanitizer !== void 0 ? sanitizer(normalizedUrl).toString() : normalizedUrl;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  sanitizeUrl
+});

package/url.d.cts

@@ -0,0 +1,12 @@
+type UrlSanitizer = (url: string) => URL;
+/**
+ * Normalizes the URL and sanitizes it, if a sanitizer is given.
+ *
+ * @param url The URL to sanitize.
+ * @param sanitizer The sanitizer to apply to the normalized URL.
+ *
+ * @returns The sanitized URL.
+ */
+declare function sanitizeUrl(url: string, sanitizer?: UrlSanitizer): string;
+
+export { type UrlSanitizer, sanitizeUrl };

package/url.d.ts

@@ -0,0 +1,12 @@
+type UrlSanitizer = (url: string) => URL;
+/**
+ * Normalizes the URL and sanitizes it, if a sanitizer is given.
+ *
+ * @param url The URL to sanitize.
+ * @param sanitizer The sanitizer to apply to the normalized URL.
+ *
+ * @returns The sanitized URL.
+ */
+declare function sanitizeUrl(url: string, sanitizer?: UrlSanitizer): string;
+
+export { type UrlSanitizer, sanitizeUrl };

package/url.js

@@ -0,0 +1,7 @@
+function sanitizeUrl(url, sanitizer) {
+  const normalizedUrl = encodeURI(decodeURI(url));
+  return sanitizer !== void 0 ? sanitizer(normalizedUrl).toString() : normalizedUrl;
+}
+export {
+  sanitizeUrl
+};