@d1g1tal/transportr 1.4.4 → 2.1.0

package/README.md

@@ -1,90 +1,347 @@
 # transportr
-JavaScript wrapper for Fetch API
+
+[![npm version](https://img.shields.io/npm/v/@d1g1tal/transportr?color=blue)](https://www.npmjs.com/package/@d1g1tal/transportr)
+[![npm downloads](https://img.shields.io/npm/dm/@d1g1tal/transportr)](https://www.npmjs.com/package/@d1g1tal/transportr)
+[![CI](https://github.com/D1g1talEntr0py/transportr/actions/workflows/ci.yml/badge.svg)](https://github.com/D1g1talEntr0py/transportr/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/D1g1talEntr0py/transportr/graph/badge.svg)](https://codecov.io/gh/D1g1talEntr0py/transportr)
+[![License: ISC](https://img.shields.io/github/license/D1g1talEntr0py/transportr)](https://github.com/D1g1talEntr0py/transportr/blob/main/LICENSE)
+[![Node.js](https://img.shields.io/node/v/@d1g1tal/transportr)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+A TypeScript Fetch API wrapper providing type-safe HTTP requests with advanced abort/timeout handling, event-driven architecture, and automatic content-type based response processing.
+
+## Features
+
+- **Type-safe** — Full TypeScript support with strict types, branded JSON strings, and typed headers
+- **Automatic response handling** — Content-type based response parsing (JSON, HTML, XML, images, streams, etc.)
+- **Abort & timeout management** — Per-request timeouts, `AbortController` integration, and `abortAll()` for cleanup
+- **Event-driven** — Global and instance-level lifecycle events (`configured`, `success`, `error`, `complete`, etc.)
+- **Retry logic** — Configurable retry with exponential backoff, status code filtering, and method filtering
+- **Request deduplication** — Identical in-flight GET/HEAD requests share a single fetch
+- **Lifecycle hooks** — `beforeRequest`, `afterResponse`, `beforeError` hooks at global, instance, and per-request levels
+- **XSRF/CSRF protection** — Automatic cookie-to-header token injection
+- **HTML selectors** — Extract specific elements from HTML responses with CSS selectors
+- **FormData auto-detection** — Automatically handles FormData, Blob, ArrayBuffer, and stream bodies
+
 ## Installation
+
 ```bash
-npm install @d1g1tal/transportr
+pnpm add @d1g1tal/transportr
 ```
-## Usage
-```javascript
-import Transportr from '@d1g1tal/transportr';
 
-// Creates default instance configured for JSON requests using UTF-8 encoding.
-const transportr = new Transportr('https://jsonplaceholder.typicode.com', { headers: { [Transportr.RequestHeader.CONTENT_TYPE]: Transportr.MediaType.JSON }, encoding: 'utf-8', });
+## Requirements
 
-transportr.get('/todos/1')
-  .then(json => console.log(json))
-  .catch(error => console.error(error.message));
+- **Node.js** ≥ 20.0.0 or a modern browser with native [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) and `AbortController` support
+- `jsdom` is an **optional peer dependency** — only needed for HTML/XML/DOM features in Node.js. Install it separately if you use `getHtml()`, `getXml()`, `getHtmlFragment()`, `getScript()`, `getStylesheet()`, or `getImage()` in a non-browser environment:
+
+```bash
+pnpm add jsdom
 ```
-Or
 
-```javascript
-const transportr = new Transportr('https://jsonplaceholder.typicode.com');
+## Quick Start
 
-try {
-  const todo1 = await transportr.getJson('/todos/1');
-  console.log(todo1);
+```typescript
+import { Transportr } from '@d1g1tal/transportr';
+
+const api = new Transportr('https://api.example.com');
+
+// GET JSON
+const data = await api.getJson('/users/1');
+
+// POST with JSON body
+const created = await api.post('/users', { body: { name: 'Alice' } });
+
+// GET with search params
+const results = await api.getJson('/search', { searchParams: { q: 'term', page: 1 } });
+
+// Typed response using generics
+interface User { id: number; name: string; }
+const user = await api.get<User>('/users/1');
+```
+
+## API
+
+### Constructor
+
+```typescript
+new Transportr(url?: URL | string | RequestOptions, options?: RequestOptions)
+```
+
+Creates a new instance. When `url` is omitted, defaults to `globalThis.location.origin`.
+
+```typescript
+// With base URL
+const api = new Transportr('https://api.example.com/v2');
+
+// With URL and default options
+const api = new Transportr('https://api.example.com', {
+  timeout: 10000,
+  headers: { 'Authorization': 'Bearer token' }
+});
+
+// With options only (uses current origin)
+const api = new Transportr({ timeout: 5000 });
+```
+
+### Request Methods
+
+| Method | Description |
+|--------|-------------|
+| `get(path?, options?)` | GET request with auto content-type handling |
+| `post(path?, options?)` | POST request |
+| `put(path?, options?)` | PUT request |
+| `patch(path?, options?)` | PATCH request |
+| `delete(path?, options?)` | DELETE request |
+| `head(path?, options?)` | HEAD request |
+| `options(path?, options?)` | OPTIONS request (returns allowed methods) |
+| `request(path?, options?)` | Raw request returning `TypedResponse<T>` |
+
+### Typed Response Methods
+
+| Method | Returns | Accept Header |
+|--------|---------|---------------|
+| `getJson(path?, options?)` | `Json` | `application/json` |
+| `getHtml(path?, options?, selector?)` | `Document \| Element` | `text/html` |
+| `getHtmlFragment(path?, options?, selector?)` | `DocumentFragment \| Element` | `text/html` |
+| `getXml(path?, options?)` | `Document` | `application/xml` |
+| `getScript(path?, options?)` | `void` (injected into DOM) | `application/javascript` |
+| `getStylesheet(path?, options?)` | `void` (injected into DOM) | `text/css` |
+| `getBlob(path?, options?)` | `Blob` | `application/octet-stream` |
+| `getImage(path?, options?)` | `HTMLImageElement` | `image/*` |
+| `getBuffer(path?, options?)` | `ArrayBuffer` | `application/octet-stream` |
+| `getStream(path?, options?)` | `ReadableStream` | `application/octet-stream` |
+
+### Request Options
+
+```typescript
+type RequestOptions = {
+  headers?: RequestHeaders;
+  searchParams?: URLSearchParams | string | Record<string, string | number | boolean>;
+  timeout?: number;              // Default: 30000ms
+  global?: boolean;              // Emit global events (default: true)
+  body?: BodyInit | JsonObject;  // Auto-serialized for JSON content-type
+  retry?: number | RetryOptions;
+  dedupe?: boolean;              // Deduplicate identical GET/HEAD requests
+  xsrf?: boolean | XsrfOptions;
+  hooks?: HooksOptions;
+  // ...all standard RequestInit properties (cache, credentials, mode, etc.)
+};
+```
+
+### Retry
+
+```typescript
+// Simple: retry up to 3 times with default settings
+await api.get('/data', { retry: 3 });
+
+// Advanced configuration
+await api.get('/data', {
+  retry: {
+    limit: 3,
+    statusCodes: [408, 413, 429, 500, 502, 503, 504],
+    methods: ['GET', 'PUT', 'HEAD', 'DELETE', 'OPTIONS'],
+    delay: 300,        // ms before first retry
+    backoffFactor: 2   // exponential backoff multiplier
+  }
+});
+```
+
+### Request Deduplication
+
+When `dedupe: true`, identical in-flight GET/HEAD requests share a single fetch call. Each consumer receives a cloned response.
+
+```typescript
+// Only one fetch call is made
+const [a, b] = await Promise.all([
+  api.get('/data', { dedupe: true }),
+  api.get('/data', { dedupe: true })
+]);
+```
+
+### Lifecycle Hooks
+
+Hooks run in order: global → instance → per-request.
+
+```typescript
+// Global hooks (all instances)
+Transportr.addHooks({
+  beforeRequest: [async (options, url) => {
+    options.headers.set('X-Request-ID', crypto.randomUUID());
+    return options;
+  }],
+  afterResponse: [async (response, options) => response],
+  beforeError: [(error) => error]
+});
+
+// Instance hooks
+api.addHooks({
+  afterResponse: [async (response) => {
+    console.log(`Response: ${response.status}`);
+    return response;
+  }]
+});
+
+// Per-request hooks
+await api.get('/data', {
+  hooks: { beforeRequest: [async (opts) => opts] }
+});
+```
+
+### Events
 
-  const todo2 = await transportr.getJson('/todos/2');
-  console.log(todo2);
+```typescript
+// Global events (all instances)
+const reg = Transportr.register(Transportr.RequestEvents.SUCCESS, (event, data) => {
+  console.log('Request succeeded:', data);
+});
+
+// Instance events
+const reg = api.register(Transportr.RequestEvents.ERROR, (event, error) => {
+  console.error('Request failed:', error);
+});
+
+// Unregister
+api.unregister(reg);  // Returns `this` for chaining
+```
+
+**Event lifecycle**: `configured` → `success | error | aborted | timeout` → `complete` → `all-complete`
+
+Additional events: `retry` (emitted on each retry attempt)
+
+### Error Handling
+
+Non-2xx responses throw an error with `name === 'HttpError'`. Aborted and timed-out requests also produce an `HttpError` with synthetic status codes.
+
+```typescript
+import type { HttpError } from '@d1g1tal/transportr';
+
+try {
+	const user = await api.getJson('/users/1');
 } catch (error) {
-  console.error(error.message);
+	if (error instanceof Error && error.name === 'HttpError') {
+		const httpError = error as unknown as HttpError;
+		console.error(httpError.statusCode);  // HTTP status code
+		console.error(httpError.statusText);  // HTTP status text
+		console.error(httpError.entity);      // parsed response body (if any)
+		console.error(httpError.url?.href);   // request URL
+		console.error(httpError.method);      // HTTP method used
+		console.error(httpError.timing);      // { start, end, duration } in ms
+	}
 }
 ```
 
-## API
-### Transportr
-#### constructor(options)
-##### options
-Type: `Object`
-
-###### options.baseURL
-Type: `String`
-Base URL for all requests.
-
-###### options.headers
-Type: `Object`
-Default headers for all requests.
-
-###### options.timeout
-Type: `Number`
-Default timeout for all requests.
-
-###### options.credentials
-Type: `String`
-Default credentials for all requests.
-
-###### options.mode
-Type: `String`
-Default mode for all requests.
-
-###### options.cache
-Type: `String`
-Default cache for all requests.
-
-###### options.redirect
-Type: `String`
-Default redirect for all requests.
-
-###### options.referrer
-Type: `String`
-Default referrer for all requests.
-
-###### options.integrity
-Type: `String`
-Default integrity for all requests.
-
-###### options.keepalive
-Type: `Boolean`
-Default keepalive for all requests.
-
-###### options.signal
-Type: `AbortSignal`
-Default signal for all requests.
-
-###### options.encoding
-Type: `String`
-Default encoding for all requests.
-
-###### options.body
-Type: `Object|String|FormData|URLSearchParams|Blob|BufferSource|ReadableStream`
-Default body for all requests.
+**Synthetic status codes for non-HTTP failures:**
+
+| Code | Text | Cause |
+|------|------|-------|
+| `499` | `Aborted` | Cancelled via `controller.abort()` or `Transportr.abortAll()` |
+| `504` | `Request Timeout` | `timeout` option exceeded |
+
+### Abort & Timeout
+
+```typescript
+// Per-request timeout
+await api.get('/slow', { timeout: 5000 });
+
+// Manual abort via AbortController
+const controller = new AbortController();
+api.get('/data', { signal: controller.signal });
+controller.abort();
+
+// Abort all in-flight requests
+Transportr.abortAll();
+```
+
+### XSRF/CSRF Protection
+
+```typescript
+// Default: reads 'XSRF-TOKEN' cookie, sets 'X-XSRF-TOKEN' header
+await api.post('/data', { body: payload, xsrf: true });
+
+// Custom cookie/header names
+await api.post('/data', {
+  body: payload,
+  xsrf: { cookieName: 'MY-CSRF', headerName: 'X-MY-CSRF' }
+});
+```
+
+### HTML Selector Support
+
+```typescript
+// Get a specific element from HTML response
+const nav = await api.getHtml('/page', {}, 'nav.main');
+const item = await api.getHtmlFragment('/partial', {}, '.item:first-child');
+```
+
+### FormData & Raw Bodies
+
+FormData, Blob, ArrayBuffer, ReadableStream, TypedArray, and URLSearchParams are sent as-is. The `Content-Type` header is automatically removed so the runtime can set it (e.g., multipart boundary for FormData).
+
+```typescript
+const form = new FormData();
+form.append('file', fileBlob, 'photo.jpg');
+await api.post('/upload', { body: form });
+```
+
+### Custom Content-Type Handlers
+
+```typescript
+// Register a custom handler (takes priority over built-in)
+Transportr.registerContentTypeHandler('csv', async (response) => {
+  const text = await response.text();
+  return text.split('\n').map(row => row.split(','));
+});
+
+// Remove a handler
+Transportr.unregisterContentTypeHandler('csv');
+```
+
+### Cleanup
+
+```typescript
+// Tear down a single instance
+api.destroy();
+
+// Tear down all global state
+Transportr.unregisterAll();
+
+// Clear only global hooks without aborting in-flight requests
+Transportr.clearHooks();
+```
+
+### Method Chaining
+
+Instance methods `unregister()`, `addHooks()`, and `clearHooks()` return `this`:
+
+```typescript
+api
+  .addHooks({ beforeRequest: [myHook] })
+  .clearHooks()
+  .addHooks({ afterResponse: [logHook] });
+```
+
+### Instance Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `baseUrl` | `URL` | The base URL used for all requests from this instance |
+
+### Static Properties
+
+| Property | Description |
+|----------|-------------|
+| `Transportr.MediaType` | HTTP media type constants |
+| `Transportr.RequestMethod` | HTTP method constants |
+| `Transportr.RequestHeader` | Request header constants |
+| `Transportr.ResponseHeader` | Response header constants |
+| `Transportr.CachingPolicy` | Cache policy constants |
+| `Transportr.CredentialsPolicy` | Credentials policy constants |
+| `Transportr.RequestModes` | Request mode constants |
+| `Transportr.RequestPriorities` | Request priority constants |
+| `Transportr.RedirectPolicies` | Redirect policy constants |
+| `Transportr.ReferrerPolicy` | Referrer policy constants |
+| `Transportr.RequestEvents` | Event name constants |
+
+## License
+
+[ISC](LICENSE)

package/dist/OP3JQ447.js

@@ -0,0 +1,8 @@
+var{entries:_t,setPrototypeOf:ct,isFrozen:Yt,getPrototypeOf:Xt,getOwnPropertyDescriptor:jt}=Object,{freeze:S,seal:b,create:me}=Object,{apply:ve,construct:Ue}=typeof Reflect<"u"&&Reflect;S||(S=function(o){return o});b||(b=function(o){return o});ve||(ve=function(o,l){for(var a=arguments.length,c=new Array(a>2?a-2:0),D=2;D<a;D++)c[D-2]=arguments[D];return o.apply(l,c)});Ue||(Ue=function(o){for(var l=arguments.length,a=new Array(l>1?l-1:0),c=1;c<l;c++)a[c-1]=arguments[c];return new o(...a)});var fe=R(Array.prototype.forEach),Vt=R(Array.prototype.lastIndexOf),ft=R(Array.prototype.pop),q=R(Array.prototype.push),$t=R(Array.prototype.splice),pe=R(String.prototype.toLowerCase),Ie=R(String.prototype.toString),Me=R(String.prototype.match),K=R(String.prototype.replace),qt=R(String.prototype.indexOf),Kt=R(String.prototype.trim),y=R(Object.prototype.hasOwnProperty),h=R(RegExp.prototype.test),Z=Zt(TypeError);function R(s){return function(o){o instanceof RegExp&&(o.lastIndex=0);for(var l=arguments.length,a=new Array(l>1?l-1:0),c=1;c<l;c++)a[c-1]=arguments[c];return ve(s,o,a)}}function Zt(s){return function(){for(var o=arguments.length,l=new Array(o),a=0;a<o;a++)l[a]=arguments[a];return Ue(s,l)}}function r(s,o){let l=arguments.length>2&&arguments[2]!==void 0?arguments[2]:pe;ct&&ct(s,null);let a=o.length;for(;a--;){let c=o[a];if(typeof c=="string"){let D=l(c);D!==c&&(Yt(o)||(o[a]=D),c=D)}s[c]=!0}return s}function Jt(s){for(let o=0;o<s.length;o++)y(s,o)||(s[o]=null);return s}function C(s){let o=me(null);for(let[l,a]of _t(s))y(s,l)&&(Array.isArray(a)?o[l]=Jt(a):a&&typeof a=="object"&&a.constructor===Object?o[l]=C(a):o[l]=a);return o}function J(s,o){for(;s!==null;){let a=jt(s,o);if(a){if(a.get)return R(a.get);if(typeof a.value=="function")return R(a.value)}s=Xt(s)}function l(){return null}return l}var ut=S(["a","abbr","acronym","address","area","article","aside","audio","b","bdi","bdo","big","blink","blockquote","body","br","button","canvas","caption","center","cite","code","col","colgroup","content","data","datalist","dd","decorator","del","details","dfn","dialog","dir","div","dl","dt","element","em","fieldset","figcaption","figure","font","footer","form","h1","h2","h3","h4","h5","h6","head","header","hgroup","hr","html","i","img","input","ins","kbd","label","legend","li","main","map","mark","marquee","menu","menuitem","meter","nav","nobr","ol","optgroup","option","output","p","picture","pre","progress","q","rp","rt","ruby","s","samp","search","section","select","shadow","slot","small","source","spacer","span","strike","strong","style","sub","summary","sup","table","tbody","td","template","textarea","tfoot","th","thead","time","tr","track","tt","u","ul","var","video","wbr"]),we=S(["svg","a","altglyph","altglyphdef","altglyphitem","animatecolor","animatemotion","animatetransform","circle","clippath","defs","desc","ellipse","enterkeyhint","exportparts","filter","font","g","glyph","glyphref","hkern","image","inputmode","line","lineargradient","marker","mask","metadata","mpath","part","path","pattern","polygon","polyline","radialgradient","rect","stop","style","switch","symbol","text","textpath","title","tref","tspan","view","vkern"]),xe=S(["feBlend","feColorMatrix","feComponentTransfer","feComposite","feConvolveMatrix","feDiffuseLighting","feDisplacementMap","feDistantLight","feDropShadow","feFlood","feFuncA","feFuncB","feFuncG","feFuncR","feGaussianBlur","feImage","feMerge","feMergeNode","feMorphology","feOffset","fePointLight","feSpecularLighting","feSpotLight","feTile","feTurbulence"]),Qt=S(["animate","color-profile","cursor","discard","font-face","font-face-format","font-face-name","font-face-src","font-face-uri","foreignobject","hatch","hatchpath","mesh","meshgradient","meshpatch","meshrow","missing-glyph","script","set","solidcolor","unknown","use"]),Pe=S(["math","menclose","merror","mfenced","mfrac","mglyph","mi","mlabeledtr","mmultiscripts","mn","mo","mover","mpadded","mphantom","mroot","mrow","ms","mspace","msqrt","mstyle","msub","msup","msubsup","mtable","mtd","mtext","mtr","munder","munderover","mprescripts"]),en=S(["maction","maligngroup","malignmark","mlongdiv","mscarries","mscarry","msgroup","mstack","msline","msrow","semantics","annotation","annotation-xml","mprescripts","none"]),mt=S(["#text"]),pt=S(["accept","action","align","alt","autocapitalize","autocomplete","autopictureinpicture","autoplay","background","bgcolor","border","capture","cellpadding","cellspacing","checked","cite","class","clear","color","cols","colspan","controls","controlslist","coords","crossorigin","datetime","decoding","default","dir","disabled","disablepictureinpicture","disableremoteplayback","download","draggable","enctype","enterkeyhint","exportparts","face","for","headers","height","hidden","high","href","hreflang","id","inert","inputmode","integrity","ismap","kind","label","lang","list","loading","loop","low","max","maxlength","media","method","min","minlength","multiple","muted","name","nonce","noshade","novalidate","nowrap","open","optimum","part","pattern","placeholder","playsinline","popover","popovertarget","popovertargetaction","poster","preload","pubdate","radiogroup","readonly","rel","required","rev","reversed","role","rows","rowspan","spellcheck","scope","selected","shape","size","sizes","slot","span","srclang","start","src","srcset","step","style","summary","tabindex","title","translate","type","usemap","valign","value","width","wrap","xmlns","slot"]),ke=S(["accent-height","accumulate","additive","alignment-baseline","amplitude","ascent","attributename","attributetype","azimuth","basefrequency","baseline-shift","begin","bias","by","class","clip","clippathunits","clip-path","clip-rule","color","color-interpolation","color-interpolation-filters","color-profile","color-rendering","cx","cy","d","dx","dy","diffuseconstant","direction","display","divisor","dur","edgemode","elevation","end","exponent","fill","fill-opacity","fill-rule","filter","filterunits","flood-color","flood-opacity","font-family","font-size","font-size-adjust","font-stretch","font-style","font-variant","font-weight","fx","fy","g1","g2","glyph-name","glyphref","gradientunits","gradienttransform","height","href","id","image-rendering","in","in2","intercept","k","k1","k2","k3","k4","kerning","keypoints","keysplines","keytimes","lang","lengthadjust","letter-spacing","kernelmatrix","kernelunitlength","lighting-color","local","marker-end","marker-mid","marker-start","markerheight","markerunits","markerwidth","maskcontentunits","maskunits","max","mask","mask-type","media","method","mode","min","name","numoctaves","offset","operator","opacity","order","orient","orientation","origin","overflow","paint-order","path","pathlength","patterncontentunits","patterntransform","patternunits","points","preservealpha","preserveaspectratio","primitiveunits","r","rx","ry","radius","refx","refy","repeatcount","repeatdur","restart","result","rotate","scale","seed","shape-rendering","slope","specularconstant","specularexponent","spreadmethod","startoffset","stddeviation","stitchtiles","stop-color","stop-opacity","stroke-dasharray","stroke-dashoffset","stroke-linecap","stroke-linejoin","stroke-miterlimit","stroke-opacity","stroke","stroke-width","style","surfacescale","systemlanguage","tabindex","tablevalues","targetx","targety","transform","transform-origin","text-anchor","text-decoration","text-rendering","textlength","type","u1","u2","unicode","values","viewbox","visibility","version","vert-adv-y","vert-origin-x","vert-origin-y","width","word-spacing","wrap","writing-mode","xchannelselector","ychannelselector","x","x1","x2","xmlns","y","y1","y2","z","zoomandpan"]),Tt=S(["accent","accentunder","align","bevelled","close","columnsalign","columnlines","columnspan","denomalign","depth","dir","display","displaystyle","encoding","fence","frame","height","href","id","largeop","length","linethickness","lspace","lquote","mathbackground","mathcolor","mathsize","mathvariant","maxsize","minsize","movablelimits","notation","numalign","open","rowalign","rowlines","rowspacing","rowspan","rspace","rquote","scriptlevel","scriptminsize","scriptsizemultiplier","selection","separator","separators","stretchy","subscriptshift","supscriptshift","symmetric","voffset","width","xmlns"]),ue=S(["xlink:href","xml:id","xlink:title","xml:space","xmlns:xlink"]),tn=b(/\{\{[\w\W]*|[\w\W]*\}\}/gm),nn=b(/<%[\w\W]*|[\w\W]*%>/gm),on=b(/\$\{[\w\W]*/gm),an=b(/^data-[\-\w.\u00B7-\uFFFF]+$/),rn=b(/^aria-[\-\w]+$/),gt=b(/^(?:(?:(?:f|ht)tps?|mailto|tel|callto|sms|cid|xmpp|matrix):|[^a-z]|[a-z+.\-]+(?:[^a-z+.\-:]|$))/i),sn=b(/^(?:\w+script|data):/i),ln=b(/[\u0000-\u0020\u00A0\u1680\u180E\u2000-\u2029\u205F\u3000]/g),At=b(/^html$/i),cn=b(/^[a-z][.\w]*(-[.\w]+)+$/i),dt=Object.freeze({__proto__:null,ARIA_ATTR:rn,ATTR_WHITESPACE:ln,CUSTOM_ELEMENT:cn,DATA_ATTR:an,DOCTYPE_NAME:At,ERB_EXPR:nn,IS_ALLOWED_URI:gt,IS_SCRIPT_OR_DATA:sn,MUSTACHE_EXPR:tn,TMPLIT_EXPR:on}),Q={element:1,attribute:2,text:3,cdataSection:4,entityReference:5,entityNode:6,progressingInstruction:7,comment:8,document:9,documentType:10,documentFragment:11,notation:12},fn=function(){return typeof window>"u"?null:window},un=function(o,l){if(typeof o!="object"||typeof o.createPolicy!="function")return null;let a=null,c="data-tt-policy-suffix";l&&l.hasAttribute(c)&&(a=l.getAttribute(c));let D="dompurify"+(a?"#"+a:"");try{return o.createPolicy(D,{createHTML(v){return v},createScriptURL(v){return v}})}catch{return console.warn("TrustedTypes policy "+D+" could not be created."),null}},Et=function(){return{afterSanitizeAttributes:[],afterSanitizeElements:[],afterSanitizeShadowDOM:[],beforeSanitizeAttributes:[],beforeSanitizeElements:[],beforeSanitizeShadowDOM:[],uponSanitizeAttribute:[],uponSanitizeElement:[],uponSanitizeShadowNode:[]}};function ht(){let s=arguments.length>0&&arguments[0]!==void 0?arguments[0]:fn(),o=i=>ht(i);if(o.version="3.3.3",o.removed=[],!s||!s.document||s.document.nodeType!==Q.document||!s.Element)return o.isSupported=!1,o;let{document:l}=s,a=l,c=a.currentScript,{DocumentFragment:D,HTMLTemplateElement:v,Node:Te,Element:Fe,NodeFilter:B,NamedNodeMap:St=s.NamedNodeMap||s.MozNamedAttrMap,HTMLFormElement:Rt,DOMParser:Dt,trustedTypes:ee}=s,Y=Fe.prototype,Ot=J(Y,"cloneNode"),yt=J(Y,"remove"),bt=J(Y,"nextSibling"),Lt=J(Y,"childNodes"),te=J(Y,"parentNode");if(typeof v=="function"){let i=l.createElement("template");i.content&&i.content.ownerDocument&&(l=i.content.ownerDocument)}let g,X="",{implementation:de,createNodeIterator:Nt,createDocumentFragment:Ct,getElementsByTagName:It}=l,{importNode:Mt}=a,A=Et();o.isSupported=typeof _t=="function"&&typeof te=="function"&&de&&de.createHTMLDocument!==void 0;let{MUSTACHE_EXPR:Ee,ERB_EXPR:_e,TMPLIT_EXPR:ge,DATA_ATTR:wt,ARIA_ATTR:xt,IS_SCRIPT_OR_DATA:Pt,ATTR_WHITESPACE:He,CUSTOM_ELEMENT:kt}=dt,{IS_ALLOWED_URI:ze}=dt,T=null,Ge=r({},[...ut,...we,...xe,...Pe,...mt]),d=null,We=r({},[...pt,...ke,...Tt,...ue]),u=Object.seal(me(null,{tagNameCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},attributeNameCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},allowCustomizedBuiltInElements:{writable:!0,configurable:!1,enumerable:!0,value:!1}})),j=null,ne=null,x=Object.seal(me(null,{tagCheck:{writable:!0,configurable:!1,enumerable:!0,value:null},attributeCheck:{writable:!0,configurable:!1,enumerable:!0,value:null}})),Be=!0,Ae=!0,Ye=!1,Xe=!0,U=!1,oe=!0,P=!1,he=!1,Se=!1,F=!1,ie=!1,ae=!1,je=!0,Ve=!1,vt="user-content-",Re=!0,V=!1,H={},L=null,De=r({},["annotation-xml","audio","colgroup","desc","foreignobject","head","iframe","math","mi","mn","mo","ms","mtext","noembed","noframes","noscript","plaintext","script","style","svg","template","thead","title","video","xmp"]),$e=null,qe=r({},["audio","video","img","source","image","track"]),Oe=null,Ke=r({},["alt","class","for","id","label","name","pattern","placeholder","role","summary","title","value","style","xmlns"]),re="http://www.w3.org/1998/Math/MathML",se="http://www.w3.org/2000/svg",I="http://www.w3.org/1999/xhtml",z=I,ye=!1,be=null,Ut=r({},[re,se,I],Ie),le=r({},["mi","mo","mn","ms","mtext"]),ce=r({},["annotation-xml"]),Ft=r({},["title","style","font","a","script"]),$=null,Ht=["application/xhtml+xml","text/html"],zt="text/html",p=null,G=null,Gt=l.createElement("form"),Ze=function(e){return e instanceof RegExp||e instanceof Function},Le=function(){let e=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};if(!(G&&G===e)){if((!e||typeof e!="object")&&(e={}),e=C(e),$=Ht.indexOf(e.PARSER_MEDIA_TYPE)===-1?zt:e.PARSER_MEDIA_TYPE,p=$==="application/xhtml+xml"?Ie:pe,T=y(e,"ALLOWED_TAGS")?r({},e.ALLOWED_TAGS,p):Ge,d=y(e,"ALLOWED_ATTR")?r({},e.ALLOWED_ATTR,p):We,be=y(e,"ALLOWED_NAMESPACES")?r({},e.ALLOWED_NAMESPACES,Ie):Ut,Oe=y(e,"ADD_URI_SAFE_ATTR")?r(C(Ke),e.ADD_URI_SAFE_ATTR,p):Ke,$e=y(e,"ADD_DATA_URI_TAGS")?r(C(qe),e.ADD_DATA_URI_TAGS,p):qe,L=y(e,"FORBID_CONTENTS")?r({},e.FORBID_CONTENTS,p):De,j=y(e,"FORBID_TAGS")?r({},e.FORBID_TAGS,p):C({}),ne=y(e,"FORBID_ATTR")?r({},e.FORBID_ATTR,p):C({}),H=y(e,"USE_PROFILES")?e.USE_PROFILES:!1,Be=e.ALLOW_ARIA_ATTR!==!1,Ae=e.ALLOW_DATA_ATTR!==!1,Ye=e.ALLOW_UNKNOWN_PROTOCOLS||!1,Xe=e.ALLOW_SELF_CLOSE_IN_ATTR!==!1,U=e.SAFE_FOR_TEMPLATES||!1,oe=e.SAFE_FOR_XML!==!1,P=e.WHOLE_DOCUMENT||!1,F=e.RETURN_DOM||!1,ie=e.RETURN_DOM_FRAGMENT||!1,ae=e.RETURN_TRUSTED_TYPE||!1,Se=e.FORCE_BODY||!1,je=e.SANITIZE_DOM!==!1,Ve=e.SANITIZE_NAMED_PROPS||!1,Re=e.KEEP_CONTENT!==!1,V=e.IN_PLACE||!1,ze=e.ALLOWED_URI_REGEXP||gt,z=e.NAMESPACE||I,le=e.MATHML_TEXT_INTEGRATION_POINTS||le,ce=e.HTML_INTEGRATION_POINTS||ce,u=e.CUSTOM_ELEMENT_HANDLING||{},e.CUSTOM_ELEMENT_HANDLING&&Ze(e.CUSTOM_ELEMENT_HANDLING.tagNameCheck)&&(u.tagNameCheck=e.CUSTOM_ELEMENT_HANDLING.tagNameCheck),e.CUSTOM_ELEMENT_HANDLING&&Ze(e.CUSTOM_ELEMENT_HANDLING.attributeNameCheck)&&(u.attributeNameCheck=e.CUSTOM_ELEMENT_HANDLING.attributeNameCheck),e.CUSTOM_ELEMENT_HANDLING&&typeof e.CUSTOM_ELEMENT_HANDLING.allowCustomizedBuiltInElements=="boolean"&&(u.allowCustomizedBuiltInElements=e.CUSTOM_ELEMENT_HANDLING.allowCustomizedBuiltInElements),U&&(Ae=!1),ie&&(F=!0),H&&(T=r({},mt),d=me(null),H.html===!0&&(r(T,ut),r(d,pt)),H.svg===!0&&(r(T,we),r(d,ke),r(d,ue)),H.svgFilters===!0&&(r(T,xe),r(d,ke),r(d,ue)),H.mathMl===!0&&(r(T,Pe),r(d,Tt),r(d,ue))),y(e,"ADD_TAGS")||(x.tagCheck=null),y(e,"ADD_ATTR")||(x.attributeCheck=null),e.ADD_TAGS&&(typeof e.ADD_TAGS=="function"?x.tagCheck=e.ADD_TAGS:(T===Ge&&(T=C(T)),r(T,e.ADD_TAGS,p))),e.ADD_ATTR&&(typeof e.ADD_ATTR=="function"?x.attributeCheck=e.ADD_ATTR:(d===We&&(d=C(d)),r(d,e.ADD_ATTR,p))),e.ADD_URI_SAFE_ATTR&&r(Oe,e.ADD_URI_SAFE_ATTR,p),e.FORBID_CONTENTS&&(L===De&&(L=C(L)),r(L,e.FORBID_CONTENTS,p)),e.ADD_FORBID_CONTENTS&&(L===De&&(L=C(L)),r(L,e.ADD_FORBID_CONTENTS,p)),Re&&(T["#text"]=!0),P&&r(T,["html","head","body"]),T.table&&(r(T,["tbody"]),delete j.tbody),e.TRUSTED_TYPES_POLICY){if(typeof e.TRUSTED_TYPES_POLICY.createHTML!="function")throw Z('TRUSTED_TYPES_POLICY configuration option must provide a "createHTML" hook.');if(typeof e.TRUSTED_TYPES_POLICY.createScriptURL!="function")throw Z('TRUSTED_TYPES_POLICY configuration option must provide a "createScriptURL" hook.');g=e.TRUSTED_TYPES_POLICY,X=g.createHTML("")}else g===void 0&&(g=un(ee,c)),g!==null&&typeof X=="string"&&(X=g.createHTML(""));S&&S(e),G=e}},Je=r({},[...we,...xe,...Qt]),Qe=r({},[...Pe,...en]),Wt=function(e){let t=te(e);(!t||!t.tagName)&&(t={namespaceURI:z,tagName:"template"});let n=pe(e.tagName),f=pe(t.tagName);return be[e.namespaceURI]?e.namespaceURI===se?t.namespaceURI===I?n==="svg":t.namespaceURI===re?n==="svg"&&(f==="annotation-xml"||le[f]):!!Je[n]:e.namespaceURI===re?t.namespaceURI===I?n==="math":t.namespaceURI===se?n==="math"&&ce[f]:!!Qe[n]:e.namespaceURI===I?t.namespaceURI===se&&!ce[f]||t.namespaceURI===re&&!le[f]?!1:!Qe[n]&&(Ft[n]||!Je[n]):!!($==="application/xhtml+xml"&&be[e.namespaceURI]):!1},N=function(e){q(o.removed,{element:e});try{te(e).removeChild(e)}catch{yt(e)}},k=function(e,t){try{q(o.removed,{attribute:t.getAttributeNode(e),from:t})}catch{q(o.removed,{attribute:null,from:t})}if(t.removeAttribute(e),e==="is")if(F||ie)try{N(t)}catch{}else try{t.setAttribute(e,"")}catch{}},et=function(e){let t=null,n=null;if(Se)e="<remove></remove>"+e;else{let m=Me(e,/^[\r\n\t ]+/);n=m&&m[0]}$==="application/xhtml+xml"&&z===I&&(e='<html xmlns="http://www.w3.org/1999/xhtml"><head></head><body>'+e+"</body></html>");let f=g?g.createHTML(e):e;if(z===I)try{t=new Dt().parseFromString(f,$)}catch{}if(!t||!t.documentElement){t=de.createDocument(z,"template",null);try{t.documentElement.innerHTML=ye?X:f}catch{}}let _=t.body||t.documentElement;return e&&n&&_.insertBefore(l.createTextNode(n),_.childNodes[0]||null),z===I?It.call(t,P?"html":"body")[0]:P?t.documentElement:_},tt=function(e){return Nt.call(e.ownerDocument||e,e,B.SHOW_ELEMENT|B.SHOW_COMMENT|B.SHOW_TEXT|B.SHOW_PROCESSING_INSTRUCTION|B.SHOW_CDATA_SECTION,null)},Ne=function(e){return e instanceof Rt&&(typeof e.nodeName!="string"||typeof e.textContent!="string"||typeof e.removeChild!="function"||!(e.attributes instanceof St)||typeof e.removeAttribute!="function"||typeof e.setAttribute!="function"||typeof e.namespaceURI!="string"||typeof e.insertBefore!="function"||typeof e.hasChildNodes!="function")},nt=function(e){return typeof Te=="function"&&e instanceof Te};function M(i,e,t){fe(i,n=>{n.call(o,e,t,G)})}let ot=function(e){let t=null;if(M(A.beforeSanitizeElements,e,null),Ne(e))return N(e),!0;let n=p(e.nodeName);if(M(A.uponSanitizeElement,e,{tagName:n,allowedTags:T}),oe&&e.hasChildNodes()&&!nt(e.firstElementChild)&&h(/<[/\w!]/g,e.innerHTML)&&h(/<[/\w!]/g,e.textContent)||e.nodeType===Q.progressingInstruction||oe&&e.nodeType===Q.comment&&h(/<[/\w]/g,e.data))return N(e),!0;if(!(x.tagCheck instanceof Function&&x.tagCheck(n))&&(!T[n]||j[n])){if(!j[n]&&at(n)&&(u.tagNameCheck instanceof RegExp&&h(u.tagNameCheck,n)||u.tagNameCheck instanceof Function&&u.tagNameCheck(n)))return!1;if(Re&&!L[n]){let f=te(e)||e.parentNode,_=Lt(e)||e.childNodes;if(_&&f){let m=_.length;for(let O=m-1;O>=0;--O){let w=Ot(_[O],!0);w.__removalCount=(e.__removalCount||0)+1,f.insertBefore(w,bt(e))}}}return N(e),!0}return e instanceof Fe&&!Wt(e)||(n==="noscript"||n==="noembed"||n==="noframes")&&h(/<\/no(script|embed|frames)/i,e.innerHTML)?(N(e),!0):(U&&e.nodeType===Q.text&&(t=e.textContent,fe([Ee,_e,ge],f=>{t=K(t,f," ")}),e.textContent!==t&&(q(o.removed,{element:e.cloneNode()}),e.textContent=t)),M(A.afterSanitizeElements,e,null),!1)},it=function(e,t,n){if(ne[t]||je&&(t==="id"||t==="name")&&(n in l||n in Gt))return!1;if(!(Ae&&!ne[t]&&h(wt,t))){if(!(Be&&h(xt,t))){if(!(x.attributeCheck instanceof Function&&x.attributeCheck(t,e))){if(!d[t]||ne[t]){if(!(at(e)&&(u.tagNameCheck instanceof RegExp&&h(u.tagNameCheck,e)||u.tagNameCheck instanceof Function&&u.tagNameCheck(e))&&(u.attributeNameCheck instanceof RegExp&&h(u.attributeNameCheck,t)||u.attributeNameCheck instanceof Function&&u.attributeNameCheck(t,e))||t==="is"&&u.allowCustomizedBuiltInElements&&(u.tagNameCheck instanceof RegExp&&h(u.tagNameCheck,n)||u.tagNameCheck instanceof Function&&u.tagNameCheck(n))))return!1}else if(!Oe[t]){if(!h(ze,K(n,He,""))){if(!((t==="src"||t==="xlink:href"||t==="href")&&e!=="script"&&qt(n,"data:")===0&&$e[e])){if(!(Ye&&!h(Pt,K(n,He,"")))){if(n)return!1}}}}}}}return!0},at=function(e){return e!=="annotation-xml"&&Me(e,kt)},rt=function(e){M(A.beforeSanitizeAttributes,e,null);let{attributes:t}=e;if(!t||Ne(e))return;let n={attrName:"",attrValue:"",keepAttr:!0,allowedAttributes:d,forceKeepAttr:void 0},f=t.length;for(;f--;){let _=t[f],{name:m,namespaceURI:O,value:w}=_,W=p(m),Ce=w,E=m==="value"?Ce:Kt(Ce);if(n.attrName=W,n.attrValue=E,n.keepAttr=!0,n.forceKeepAttr=void 0,M(A.uponSanitizeAttribute,e,n),E=n.attrValue,Ve&&(W==="id"||W==="name")&&(k(m,e),E=vt+E),oe&&h(/((--!?|])>)|<\/(style|script|title|xmp|textarea|noscript|iframe|noembed|noframes)/i,E)){k(m,e);continue}if(W==="attributename"&&Me(E,"href")){k(m,e);continue}if(n.forceKeepAttr)continue;if(!n.keepAttr){k(m,e);continue}if(!Xe&&h(/\/>/i,E)){k(m,e);continue}U&&fe([Ee,_e,ge],lt=>{E=K(E,lt," ")});let st=p(e.nodeName);if(!it(st,W,E)){k(m,e);continue}if(g&&typeof ee=="object"&&typeof ee.getAttributeType=="function"&&!O)switch(ee.getAttributeType(st,W)){case"TrustedHTML":{E=g.createHTML(E);break}case"TrustedScriptURL":{E=g.createScriptURL(E);break}}if(E!==Ce)try{O?e.setAttributeNS(O,m,E):e.setAttribute(m,E),Ne(e)?N(e):ft(o.removed)}catch{k(m,e)}}M(A.afterSanitizeAttributes,e,null)},Bt=function i(e){let t=null,n=tt(e);for(M(A.beforeSanitizeShadowDOM,e,null);t=n.nextNode();)M(A.uponSanitizeShadowNode,t,null),ot(t),rt(t),t.content instanceof D&&i(t.content);M(A.afterSanitizeShadowDOM,e,null)};return o.sanitize=function(i){let e=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},t=null,n=null,f=null,_=null;if(ye=!i,ye&&(i="<!-->"),typeof i!="string"&&!nt(i))if(typeof i.toString=="function"){if(i=i.toString(),typeof i!="string")throw Z("dirty is not a string, aborting")}else throw Z("toString is not a function");if(!o.isSupported)return i;if(he||Le(e),o.removed=[],typeof i=="string"&&(V=!1),V){if(i.nodeName){let w=p(i.nodeName);if(!T[w]||j[w])throw Z("root node is forbidden and cannot be sanitized in-place")}}else if(i instanceof Te)t=et("<!---->"),n=t.ownerDocument.importNode(i,!0),n.nodeType===Q.element&&n.nodeName==="BODY"||n.nodeName==="HTML"?t=n:t.appendChild(n);else{if(!F&&!U&&!P&&i.indexOf("<")===-1)return g&&ae?g.createHTML(i):i;if(t=et(i),!t)return F?null:ae?X:""}t&&Se&&N(t.firstChild);let m=tt(V?i:t);for(;f=m.nextNode();)ot(f),rt(f),f.content instanceof D&&Bt(f.content);if(V)return i;if(F){if(ie)for(_=Ct.call(t.ownerDocument);t.firstChild;)_.appendChild(t.firstChild);else _=t;return(d.shadowroot||d.shadowrootmode)&&(_=Mt.call(a,_,!0)),_}let O=P?t.outerHTML:t.innerHTML;return P&&T["!doctype"]&&t.ownerDocument&&t.ownerDocument.doctype&&t.ownerDocument.doctype.name&&h(At,t.ownerDocument.doctype.name)&&(O="<!DOCTYPE "+t.ownerDocument.doctype.name+`>
+`+O),U&&fe([Ee,_e,ge],w=>{O=K(O,w," ")}),g&&ae?g.createHTML(O):O},o.setConfig=function(){let i=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};Le(i),he=!0},o.clearConfig=function(){G=null,he=!1},o.isValidAttribute=function(i,e,t){G||Le({});let n=p(i),f=p(e);return it(n,f,t)},o.addHook=function(i,e){typeof e=="function"&&q(A[i],e)},o.removeHook=function(i,e){if(e!==void 0){let t=Vt(A[i],e);return t===-1?void 0:$t(A[i],t,1)[0]}return ft(A[i])},o.removeHooks=function(i){A[i]=[]},o.removeAllHooks=function(){A=Et()},o}var mn=ht();export{mn as default};
+/*! Bundled license information:
+
+dompurify/dist/purify.es.mjs:
+  (*! @license DOMPurify 3.3.3 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.3.3/LICENSE *)
+*/
+//# sourceMappingURL=OP3JQ447.js.map