@esposter/shared 4.1.2 → 4.3.1

package/README.md

@@ -23,7 +23,7 @@ pnpm i @esposter/shared zod
 
 ## <a name="documentation">📖 Documentation</a>
 
-We highly recommend you take a look at the [documentation](https://esposter.com/docs/api/modules/_esposter_shared.html) to level up.
+We highly recommend you take a look at the [documentation](https://github.com/Esposter/Esposter/tree/main/openspec/specs/shared) to level up.
 
 ### Key Exports
 

package/dist/index.d.ts

@@ -56,6 +56,19 @@ export declare class TypedEventEmitter<TEventMap extends EventListenerMap<TEvent
   removeAllListeners(event?: keyof TEventMap): void;
 }
 //#endregion
+//#region src/models/history/History.d.ts
+export interface History<T> {
+  future: T[];
+  limit: number;
+  past: T[];
+}
+//#endregion
+//#region src/models/history/HistoryStep.d.ts
+export interface HistoryStep<T> {
+  entry?: T;
+  history: History<T>;
+}
+//#endregion
 //#region src/models/indexedDb/DatabaseStoreSchema.d.ts
 export interface DatabaseStoreSchema {
   indexes: Record<string, IDBValidKey>;
@@ -135,6 +148,39 @@ export interface DatabaseOpenOptions<TSchema extends DatabaseSchema = DatabaseSc
   upgrade?: (database: UpgradeDatabase<TSchema>, oldVersion: number, newVersion: null | number, transaction: DatabaseTransaction<TSchema, DatabaseStoreName<TSchema>, "versionchange">) => void;
 }
 //#endregion
+//#region src/models/jsonPatch/JsonPatchOperationType.d.ts
+export declare enum JsonPatchOperationType {
+  Add = "add",
+  Copy = "copy",
+  Move = "move",
+  Remove = "remove",
+  Replace = "replace",
+  Test = "test"
+}
+//#endregion
+//#region src/models/jsonPatch/JsonPatchOperation.d.ts
+export type JsonPatchOperation = JsonPatchFromOperation | JsonPatchRemoveOperation | JsonPatchValueOperation;
+interface JsonPatchFromOperation {
+  from: string;
+  op: JsonPatchOperationType.Copy | JsonPatchOperationType.Move;
+  path: string;
+}
+interface JsonPatchRemoveOperation {
+  op: JsonPatchOperationType.Remove;
+  path: string;
+}
+interface JsonPatchValueOperation {
+  op: JsonPatchOperationType.Add | JsonPatchOperationType.Replace | JsonPatchOperationType.Test;
+  path: string;
+  value: unknown;
+}
+//#endregion
+//#region src/models/jsonPatch/ApplyPatchesResult.d.ts
+export interface ApplyPatchesResult<T> {
+  document: T;
+  inverses: JsonPatchOperation[];
+}
+//#endregion
 //#region src/models/message/MentionType.d.ts
 export declare enum MentionType {
   Role = "role",
@@ -173,7 +219,6 @@ export declare const RoutePath: {
   readonly Calls: (id: string) => string;
   readonly CallsIndex: "/calls";
   readonly Clicker: "/clicker";
-  readonly Docs: "/docs";
   readonly Dungeons: "/dungeons";
   readonly FluidSimulator: "/fluid-simulator";
   readonly Genshin: "/genshin";
@@ -2012,7 +2057,7 @@ export interface Dedent {
 export type UniqueArraySchemaKey<TSchema extends z.ZodType> = TSchema extends z.ZodObject ? keyof TSchema["shape"] & string : keyof z.output<TSchema> & string;
 //#endregion
 //#region src/models/zod/CreateUniqueArraySchema.d.ts
-export type CreateUniqueArraySchema = (<TOutput extends object, TInput, TSchema extends z.ZodType<TOutput, TInput>>(schema: TSchema, key: UniqueArraySchemaKey<TSchema>) => z.ZodArray<TSchema>) & (<TOutput extends Primitive, TInput, TSchema extends z.ZodType<TOutput, TInput>>(schema: TSchema) => z.ZodArray<TSchema>);
+export type CreateUniqueArraySchema = (<TOutput extends object, TInput, TSchema extends z.ZodType<TOutput, TInput>>(schema: TSchema, key: readonly UniqueArraySchemaKey<TSchema>[] | UniqueArraySchemaKey<TSchema>) => z.ZodArray<TSchema>) & (<TOutput extends Primitive, TInput, TSchema extends z.ZodType<TOutput, TInput>>(schema: TSchema) => z.ZodArray<TSchema>);
 //#endregion
 //#region src/services/app/constants.d.ts
 export declare const MAX_READ_LIMIT = 1e3;
@@ -2038,6 +2083,18 @@ export declare const withFinalizer: <T>(callback: () => T, finalizer?: () => voi
 //#region src/services/error/withFinalizerAsync.d.ts
 export declare const withFinalizerAsync: <T>(callback: () => Promisable<T>, finalizer?: () => Promisable<void>) => Promise<T>;
 //#endregion
+//#region src/services/history/createHistory.d.ts
+export declare const createHistory: <T>(limit: number) => History<T>;
+//#endregion
+//#region src/services/history/pushHistory.d.ts
+export declare const pushHistory: <T>(history: History<T>, entry: T) => History<T>;
+//#endregion
+//#region src/services/history/redoHistory.d.ts
+export declare const redoHistory: <T>(history: History<T>) => HistoryStep<T>;
+//#endregion
+//#region src/services/history/undoHistory.d.ts
+export declare const undoHistory: <T>(history: History<T>) => HistoryStep<T>;
+//#endregion
 //#region src/services/indexedDb/getRequestError.d.ts
 export declare const getRequestError: (request: IDBRequest) => DOMException;
 //#endregion
@@ -2071,6 +2128,37 @@ export declare const wrapUpgradeDatabase: <TSchema extends DatabaseSchema = Data
 //#region src/services/indexedDb/wrapUpgradeTransaction.d.ts
 export declare const wrapUpgradeTransaction: <TSchema extends DatabaseSchema>(transaction: IDBTransaction) => DatabaseTransaction<TSchema, DatabaseStoreName<TSchema>, "versionchange">;
 //#endregion
+//#region src/services/jsonPatch/addJsonValue.d.ts
+export declare const addJsonValue: (document: unknown, path: string, value: unknown) => ApplyPatchesResult<unknown>;
+//#endregion
+//#region src/services/jsonPatch/applyPatch.d.ts
+export declare const applyPatch: (document: unknown, operation: JsonPatchOperation) => ApplyPatchesResult<unknown>;
+//#endregion
+//#region src/services/jsonPatch/applyPatches.d.ts
+export declare const applyPatches: <T>(document: T, operations: JsonPatchOperation[]) => ApplyPatchesResult<T>;
+//#endregion
+//#region src/services/jsonPatch/constants.d.ts
+export declare const APPEND_SEGMENT = "-";
+export declare const JSON_POINTER_REGEX: RegExp;
+//#endregion
+//#region src/services/jsonPatch/parseArrayIndex.d.ts
+export declare const parseArrayIndex: (segment: string, maxIndex: number) => number | undefined;
+//#endregion
+//#region src/services/jsonPatch/parseJsonPointer.d.ts
+export declare const parseJsonPointer: (pointer: string) => string[];
+//#endregion
+//#region src/services/jsonPatch/readJsonValue.d.ts
+export declare const readJsonValue: (document: unknown, segments: string[]) => unknown;
+//#endregion
+//#region src/services/jsonPatch/removeJsonValue.d.ts
+export declare const removeJsonValue: (document: unknown, path: string) => ApplyPatchesResult<unknown>;
+//#endregion
+//#region src/services/jsonPatch/toJsonPointer.d.ts
+export declare const toJsonPointer: (segments: string[]) => string;
+//#endregion
+//#region src/services/jsonPatch/updateJsonValue.d.ts
+export declare const updateJsonValue: (document: unknown, segments: string[], update: (value: unknown) => unknown) => unknown;
+//#endregion
 //#region src/services/message/constants.d.ts
 export declare const MENTION_ID_ATTRIBUTE = "data-id";
 export declare const MENTION_ITEM_TYPE_ATTRIBUTE = "data-mention-type";
@@ -2164,7 +2252,7 @@ export declare const MAX_NESTING_DEPTH = 256;
 export declare const SRCSET_DESCRIPTOR_REGEX: RegExp;
 export declare const ESCAPED_TEXT_CHARACTERS_REGEX: RegExp;
 export declare const ESCAPED_ATTRIBUTE_CHARACTERS_REGEX: RegExp;
-export declare const SANITIZER_ADVISORY_WATCH_SINCE = "2026-10-11";
+export declare const SANITIZER_ADVISORY_WATCH_SINCE = "2026-10-21";
 //#endregion
 //#region src/services/sanitizeHtml/escapeAttribute.d.ts
 export declare const escapeAttribute: (value: string) => string;
@@ -2237,15 +2325,27 @@ export declare const chunkBySerializedSize: <T>(items: T[], maxBytes: number, ma
 //#region src/util/array/takeOne.d.ts
 export declare const takeOne: TakeOne;
 //#endregion
+//#region src/util/array/takeRandom.d.ts
+export declare const takeRandom: <T>(values: readonly T[], random: () => number) => T;
+//#endregion
 //#region src/util/date/getEndOfDay.d.ts
 export declare const getEndOfDay: (date: Date) => Date;
 //#endregion
 //#region src/util/date/getZonedDateTime.d.ts
 export declare const getZonedDateTime: (date: Date) => Temporal.ZonedDateTime;
 //#endregion
+//#region src/util/dom/checkIsNestedControl.d.ts
+export declare const checkIsNestedControl: (event: MouseEvent) => boolean;
+//#endregion
 //#region src/util/dom/checkIsNestedInteraction.d.ts
 export declare const checkIsNestedInteraction: (event: MouseEvent) => boolean;
 //#endregion
+//#region src/util/dom/downloadFile.d.ts
+export declare const downloadFile: (filename: string, blobPart: BlobPart, type: string) => void;
+//#endregion
+//#region src/util/dom/downloadUrl.d.ts
+export declare const downloadUrl: (url: string, filename: string) => void;
+//#endregion
 //#region src/util/environment/checkIsServer.d.ts
 export declare const checkIsServer: () => boolean;
 //#endregion
@@ -2280,6 +2380,9 @@ export declare const checkIsSameBytes: (first: ArrayBuffer | ArrayBufferView | S
 //#region src/util/object/checkIsSameValueZero.d.ts
 export declare const checkIsSameValueZero: (first: unknown, second: unknown) => boolean;
 //#endregion
+//#region src/util/object/clonePlainDeep.d.ts
+export declare const clonePlainDeep: <T>(data: T) => T;
+//#endregion
 //#region src/util/object/getEnumerableKeys.d.ts
 export declare const getEnumerableKeys: (value: object) => PropertyKey[];
 //#endregion
@@ -2358,7 +2461,7 @@ export declare const encodeUrlSubDelimiters: (value: string) => string;
 export declare const getDecodedUriComponent: (value: string, fallback: string) => string;
 //#endregion
 //#region src/util/text/normalizeString.d.ts
-export declare const normalizeString: (value: null | string | undefined) => string;
+export declare const normalizeString: (value: string | undefined) => string;
 //#endregion
 //#region src/util/text/streamToText.d.ts
 export declare const streamToText: (readable: NodeJS.ReadableStream) => Promise<string>;
@@ -2372,6 +2475,9 @@ export declare const truncate: (string: string, length: number) => string;
 //#region src/util/text/uncapitalize.d.ts
 export declare const uncapitalize: <T extends string>(string: T) => Uncapitalize<T>;
 //#endregion
+//#region src/util/time/constants.d.ts
+export declare const MILLISECONDS_PER_SECOND = 1e3;
+//#endregion
 //#region src/util/time/hrtime.d.ts
 export declare const hrtime: (previousHrTime?: [number, number]) => [number, number];
 //#endregion

package/dist/index.js

@@ -90,6 +90,17 @@ var TypedEventEmitter = class {
 	}
 };
 //#endregion
+//#region src/models/jsonPatch/JsonPatchOperationType.ts
+let JsonPatchOperationType = /* @__PURE__ */ function(JsonPatchOperationType) {
+	JsonPatchOperationType["Add"] = "add";
+	JsonPatchOperationType["Copy"] = "copy";
+	JsonPatchOperationType["Move"] = "move";
+	JsonPatchOperationType["Remove"] = "remove";
+	JsonPatchOperationType["Replace"] = "replace";
+	JsonPatchOperationType["Test"] = "test";
+	return JsonPatchOperationType;
+}({});
+//#endregion
 //#region src/models/message/MentionType.ts
 let MentionType = /* @__PURE__ */ function(MentionType) {
 	MentionType["Role"] = "role";
@@ -118,7 +129,6 @@ const RoutePath = {
 	Calls: (id) => `/calls/${id}`,
 	CallsIndex: "/calls",
 	Clicker: "/clicker",
-	Docs: "/docs",
 	Dungeons: "/dungeons",
 	FluidSimulator: "/fluid-simulator",
 	Genshin: "/genshin",
@@ -231,6 +241,50 @@ const withFinalizerAsync = async (callback, finalizer) => {
 	});
 };
 //#endregion
+//#region src/services/history/createHistory.ts
+const createHistory = (limit) => ({
+	future: [],
+	limit,
+	past: []
+});
+//#endregion
+//#region src/services/history/pushHistory.ts
+const pushHistory = (history, entry) => {
+	const past = [...history.past, entry];
+	return {
+		future: [],
+		limit: history.limit,
+		past: past.slice(Math.max(past.length - history.limit, 0))
+	};
+};
+//#endregion
+//#region src/services/history/redoHistory.ts
+const redoHistory = (history) => {
+	const [entry] = history.future;
+	if (entry === void 0) return { history };
+	return {
+		entry,
+		history: {
+			...pushHistory(history, entry),
+			future: history.future.slice(1)
+		}
+	};
+};
+//#endregion
+//#region src/services/history/undoHistory.ts
+const undoHistory = (history) => {
+	const entry = history.past.at(-1);
+	if (entry === void 0) return { history };
+	return {
+		entry,
+		history: {
+			future: [entry, ...history.future],
+			limit: history.limit,
+			past: history.past.slice(0, -1)
+		}
+	};
+};
+//#endregion
 //#region src/services/indexedDb/getRequestError.ts
 const getRequestError = (request) => request.error ?? new DOMException("The request failed without an error", "UnknownError");
 //#endregion
@@ -322,7 +376,9 @@ const wrapUpgradeDatabase = (database) => ({
 //#region src/services/indexedDb/wrapUpgradeTransaction.ts
 const wrapUpgradeTransaction = (transaction) => {
 	const done = getTransactionDone(transaction);
-	getResultAsync(() => done).match(noop, console.error);
+	getResultAsync(() => done).match(noop, (error) => {
+		if (transaction.error) console.error(error);
+	});
 	return {
 		get done() {
 			return done;
@@ -360,6 +416,243 @@ const openDatabase = (name, version, options = {}) => new Promise((resolve, reje
 	});
 });
 //#endregion
+//#region src/services/jsonPatch/constants.ts
+const APPEND_SEGMENT = "-";
+const JSON_POINTER_REGEX = /^(?:\/(?:[^/~]|~[01])*)*$/u;
+//#endregion
+//#region src/services/jsonPatch/parseArrayIndex.ts
+const ARRAY_INDEX_REGEX = /^(?:0|[1-9]\d*)$/u;
+const parseArrayIndex = (segment, maxIndex) => {
+	const index = Number(segment);
+	return ARRAY_INDEX_REGEX.test(segment) && index <= maxIndex ? index : void 0;
+};
+//#endregion
+//#region src/services/jsonPatch/parseJsonPointer.ts
+const parseJsonPointer = (pointer) => {
+	if (pointer === "") return [];
+	else if (!JSON_POINTER_REGEX.test(pointer)) throw new InvalidOperationError("Read", pointer, "not a JSON Pointer");
+	return pointer.slice(1).split("/").map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+};
+//#endregion
+//#region src/services/jsonPatch/toJsonPointer.ts
+const toJsonPointer = (segments) => segments.map((segment) => `/${segment.replaceAll("~", "~0").replaceAll("/", "~1")}`).join("");
+//#endregion
+//#region src/util/object/checkIsPlainObject.ts
+const checkIsPlainObject = (data) => {
+	if (typeof data !== "object" || data === null) return false;
+	const prototype = Object.getPrototypeOf(data);
+	return prototype === null || prototype === Object.prototype;
+};
+//#endregion
+//#region src/services/jsonPatch/readJsonValue.ts
+const readJsonValue = (document, segments) => {
+	let value = document;
+	for (const segment of segments) {
+		const index = Array.isArray(value) ? parseArrayIndex(segment, value.length - 1) : void 0;
+		if (Array.isArray(value) && index !== void 0) value = value[index];
+		else if (checkIsPlainObject(value) && Object.hasOwn(value, segment)) value = value[segment];
+		else throw new InvalidOperationError("Read", toJsonPointer(segments), "no such member");
+	}
+	return value;
+};
+//#endregion
+//#region src/services/jsonPatch/updateJsonValue.ts
+const updateJsonValue = (document, segments, update) => {
+	const [segment, ...restSegments] = segments;
+	if (segment === void 0) return update(document);
+	const index = Array.isArray(document) ? parseArrayIndex(segment, document.length - 1) : void 0;
+	if (Array.isArray(document) && index !== void 0) return document.with(index, updateJsonValue(document[index], restSegments, update));
+	else if (checkIsPlainObject(document) && Object.hasOwn(document, segment)) return {
+		...document,
+		[segment]: updateJsonValue(document[segment], restSegments, update)
+	};
+	else throw new InvalidOperationError("Update", toJsonPointer(segments), "no such member");
+};
+//#endregion
+//#region src/services/jsonPatch/addJsonValue.ts
+const addJsonValue = (document, path, value) => {
+	const segments = parseJsonPointer(path);
+	const parentSegments = segments.slice(0, -1);
+	const key = segments.at(-1);
+	if (key === void 0) return {
+		document: value,
+		inverses: [{
+			op: "replace",
+			path,
+			value: document
+		}]
+	};
+	const parent = readJsonValue(document, parentSegments);
+	if (Array.isArray(parent)) {
+		const index = key === "-" ? parent.length : parseArrayIndex(key, parent.length);
+		if (index === void 0) throw new InvalidOperationError("Update", path, "no such index in the array");
+		return {
+			document: updateJsonValue(document, parentSegments, () => parent.toSpliced(index, 0, value)),
+			inverses: [{
+				op: "remove",
+				path: toJsonPointer([...parentSegments, `${index}`])
+			}]
+		};
+	} else if (checkIsPlainObject(parent)) return {
+		document: updateJsonValue(document, parentSegments, () => ({
+			...parent,
+			[key]: value
+		})),
+		inverses: [Object.hasOwn(parent, key) ? {
+			op: "replace",
+			path,
+			value: parent[key]
+		} : {
+			op: "remove",
+			path
+		}]
+	};
+	else throw new InvalidOperationError("Update", path, "its parent holds no members");
+};
+//#endregion
+//#region src/services/jsonPatch/removeJsonValue.ts
+const removeJsonValue = (document, path) => {
+	const segments = parseJsonPointer(path);
+	const parentSegments = segments.slice(0, -1);
+	const key = segments.at(-1);
+	if (key === void 0) throw new InvalidOperationError("Delete", path, "the root cannot be removed");
+	const parent = readJsonValue(document, parentSegments);
+	const index = Array.isArray(parent) ? parseArrayIndex(key, parent.length - 1) : void 0;
+	if (Array.isArray(parent) && index !== void 0) return {
+		document: updateJsonValue(document, parentSegments, () => parent.toSpliced(index, 1)),
+		inverses: [{
+			op: "add",
+			path,
+			value: parent[index]
+		}]
+	};
+	else if (checkIsPlainObject(parent) && Object.hasOwn(parent, key)) {
+		const { [key]: removedValue, ...restParent } = parent;
+		return {
+			document: updateJsonValue(document, parentSegments, () => restParent),
+			inverses: [{
+				op: "add",
+				path,
+				value: removedValue
+			}]
+		};
+	} else throw new InvalidOperationError("Delete", path, "no such member");
+};
+//#endregion
+//#region src/util/object/checkIsCustomMethod.ts
+const checkIsCustomMethod = (value, methodName) => {
+	const method = Reflect.get(value, methodName);
+	return typeof method === "function" && method !== Object.prototype[methodName];
+};
+//#endregion
+//#region src/util/object/checkIsSameBytes.ts
+const toBytes = (view) => ArrayBuffer.isView(view) ? new Uint8Array(view.buffer, view.byteOffset, view.byteLength) : new Uint8Array(view);
+const checkIsSameBytes = (first, second) => {
+	const firstBytes = toBytes(first);
+	const secondBytes = toBytes(second);
+	return firstBytes.length === secondBytes.length && firstBytes.every((byte, index) => byte === secondBytes[index]);
+};
+//#endregion
+//#region src/util/object/checkIsSameValueZero.ts
+const checkIsSameValueZero = (first, second) => first === second || Number.isNaN(first) && Number.isNaN(second);
+//#endregion
+//#region src/util/object/getEnumerableKeys.ts
+const getEnumerableKeys = (value) => Reflect.ownKeys(value).filter((key) => Object.prototype.propertyIsEnumerable.call(value, key));
+//#endregion
+//#region src/util/object/checkIsDeepEqual.ts
+const checkIsBinary = (value) => ArrayBuffer.isView(value) || value instanceof ArrayBuffer || typeof SharedArrayBuffer !== "undefined" && value instanceof SharedArrayBuffer;
+const checkIsDeepEqual = (first, second) => {
+	if (first === second) return true;
+	if (typeof first !== "object" || typeof second !== "object" || first === null || second === null) return checkIsSameValueZero(first, second);
+	if (Object.getPrototypeOf(first) !== Object.getPrototypeOf(second)) return false;
+	if (Array.isArray(first) || Array.isArray(second)) {
+		if (!Array.isArray(first) || !Array.isArray(second) || first.length !== second.length) return false;
+		for (const [index, item] of first.entries()) if (!checkIsDeepEqual(item, second[index])) return false;
+		return true;
+	}
+	if (checkIsBinary(first) && checkIsBinary(second)) return checkIsSameBytes(first, second);
+	if (first instanceof RegExp && second instanceof RegExp) return first.source === second.source && first.flags === second.flags;
+	if (first instanceof WeakMap || first instanceof WeakSet || first instanceof Promise || first instanceof Blob) return false;
+	if (checkIsCustomMethod(first, "valueOf") && checkIsCustomMethod(second, "valueOf")) return checkIsSameValueZero(first.valueOf(), second.valueOf());
+	if (checkIsCustomMethod(first, "toString") && checkIsCustomMethod(second, "toString")) return first.toString() === second.toString();
+	if (first instanceof Map && second instanceof Map) {
+		if (first.size !== second.size) return false;
+		for (const [key, value] of first) if (!second.has(key) || !checkIsDeepEqual(value, second.get(key))) return false;
+		return true;
+	}
+	if (first instanceof Set && second instanceof Set) {
+		if (first.size !== second.size) return false;
+		for (const value of first) if (!second.has(value)) return false;
+		return true;
+	}
+	const firstKeys = getEnumerableKeys(first);
+	if (firstKeys.length !== getEnumerableKeys(second).length) return false;
+	return firstKeys.every((key) => Object.prototype.propertyIsEnumerable.call(second, key) && checkIsDeepEqual(Reflect.get(first, key), Reflect.get(second, key)));
+};
+//#endregion
+//#region src/util/validation/exhaustiveGuard.ts
+const exhaustiveGuard = (value) => {
+	throw new InvalidOperationError("Read", exhaustiveGuard.name, JSON.stringify(value));
+};
+//#endregion
+//#region src/services/jsonPatch/applyPatch.ts
+const applyPatch = (document, operation) => {
+	switch (operation.op) {
+		case "add": return addJsonValue(document, operation.path, operation.value);
+		case "copy": return addJsonValue(document, operation.path, readJsonValue(document, parseJsonPointer(operation.from)));
+		case "move": {
+			if (operation.from === operation.path) {
+				readJsonValue(document, parseJsonPointer(operation.from));
+				return {
+					document,
+					inverses: []
+				};
+			} else if (operation.path.startsWith(`${operation.from}/`)) throw new InvalidOperationError("Update", operation.path, "a value cannot move into itself");
+			const removed = removeJsonValue(document, operation.from);
+			const added = addJsonValue(removed.document, operation.path, readJsonValue(document, parseJsonPointer(operation.from)));
+			return {
+				document: added.document,
+				inverses: [...added.inverses, ...removed.inverses]
+			};
+		}
+		case "remove": return removeJsonValue(document, operation.path);
+		case "replace": {
+			const segments = parseJsonPointer(operation.path);
+			const replacedValue = readJsonValue(document, segments);
+			return {
+				document: updateJsonValue(document, segments, () => operation.value),
+				inverses: [{
+					op: "replace",
+					path: operation.path,
+					value: replacedValue
+				}]
+			};
+		}
+		case "test":
+			if (!checkIsDeepEqual(readJsonValue(document, parseJsonPointer(operation.path)), operation.value)) throw new InvalidOperationError("Read", operation.path, "the value differs from the test's");
+			return {
+				document,
+				inverses: []
+			};
+		default: return exhaustiveGuard(operation);
+	}
+};
+//#endregion
+//#region src/services/jsonPatch/applyPatches.ts
+const applyPatches = (document, operations) => {
+	let patchedDocument = document;
+	const inverseGroups = [];
+	for (const operation of operations) {
+		const result = applyPatch(patchedDocument, operation);
+		patchedDocument = result.document;
+		inverseGroups.push(result.inverses);
+	}
+	return {
+		document: patchedDocument,
+		inverses: inverseGroups.toReversed().flat()
+	};
+};
+//#endregion
 //#region src/services/message/constants.ts
 const MENTION_ID_ATTRIBUTE = "data-id";
 const MENTION_ITEM_TYPE_ATTRIBUTE = "data-mention-type";
@@ -971,7 +1264,7 @@ const checkIsAllowedUrl = (url, allowedSchemes) => {
 	const beforePath = takeOne(normalizedUrl.split(PATH_DELIMITER_REGEX), 0);
 	const separatorIndex = beforePath.indexOf(SCHEME_SEPARATOR);
 	if (separatorIndex === -1) return true;
-	const scheme = beforePath.slice(0, separatorIndex).replace(NON_SCHEME_CHARACTERS_REGEX, "").toLowerCase();
+	const scheme = beforePath.slice(0, separatorIndex).replaceAll(NON_SCHEME_CHARACTERS_REGEX, "").toLowerCase();
 	return allowedSchemes.includes(scheme);
 };
 //#endregion
@@ -1109,7 +1402,7 @@ const MAX_NESTING_DEPTH = 256;
 const SRCSET_DESCRIPTOR_REGEX = /^(?:\d+w|\d*\.?\d+x|\d+h)$/u;
 const ESCAPED_TEXT_CHARACTERS_REGEX = /[&<>]/gu;
 const ESCAPED_ATTRIBUTE_CHARACTERS_REGEX = /[&"<>]/gu;
-const SANITIZER_ADVISORY_WATCH_SINCE = "2026-10-11";
+const SANITIZER_ADVISORY_WATCH_SINCE = "2026-10-21";
 //#endregion
 //#region src/services/sanitizeHtml/getChildNodes.ts
 const getChildNodes = (element) => "content" in element ? element.content.childNodes : element.childNodes;
@@ -1213,6 +1506,7 @@ const filterStyle = (value, rules) => {
 //#endregion
 //#region src/services/sanitizeHtml/filterAttributes.ts
 const getTagPolicy = (tagPolicies, tagName) => Object.hasOwn(tagPolicies, tagName) ? tagPolicies[tagName] : void 0;
+const checkIsMetaRefresh = (tagName, attributes) => tagName === "meta" && attributes["http-equiv"]?.trim().toLowerCase() === "refresh";
 const filterAttributes = (element, policy) => {
 	const { tagName } = element;
 	const allowedAttributes = getTagPolicy(policy.allowedAttributes, tagName) ?? [];
@@ -1223,6 +1517,7 @@ const filterAttributes = (element, policy) => {
 	const kept = {};
 	for (const [name, value] of Object.entries(attributes)) {
 		if (name === "class" ? !isClassAllowed : !allowedAttributes.includes(name)) continue;
+		if (name === "content" && checkIsMetaRefresh(tagName, attributes)) continue;
 		const filteredValue = filterValue(tagName, name, value, policy);
 		if (filteredValue !== void 0) kept[name] = filteredValue;
 	}
@@ -1370,8 +1665,15 @@ const normalizeString = (value) => value?.trim() ?? "";
 //#region src/services/zod/createNormalizedStringSchema.ts
 const createNormalizedStringSchema = (maxLength, schema = z.string()) => schema.transform(normalizeString).pipe(z.string().max(maxLength));
 //#endregion
+//#region src/util/id/constants.ts
+const ID_SEPARATOR = "|";
+//#endregion
 //#region src/services/zod/createUniqueArraySchema.ts
-const createUniqueArraySchema = (schema, key) => schema.array().refine((array) => new Set(key === void 0 ? array : array.map((item) => item[key])).size === array.length, "Array items must be unique");
+const getItemKey = (item, key) => {
+	const record = item;
+	return typeof key === "string" ? record[key] : key.map((part) => record[part]).join("|");
+};
+const createUniqueArraySchema = (schema, key) => schema.array().refine((array) => new Set(key === void 0 ? array : array.map((item) => getItemKey(item, key))).size === array.length, { error: "Array items must be unique" });
 //#endregion
 //#region src/services/zstd/constants.ts
 const DEFAULT_COMPRESSION_LEVEL = 12;
@@ -1457,13 +1759,16 @@ const chunkBySerializedSize = (items, maxBytes, maxCount) => {
 	return chunks;
 };
 //#endregion
+//#region src/util/array/takeRandom.ts
+const takeRandom = (values, random) => takeOne(values, Math.floor(random() * values.length));
+//#endregion
 //#region src/util/date/getZonedDateTime.ts
 const getZonedDateTime = (date) => Temporal.Instant.fromEpochMilliseconds(date.getTime()).toZonedDateTimeISO(Temporal.Now.timeZoneId());
 //#endregion
 //#region src/util/date/getEndOfDay.ts
 const getEndOfDay = (date) => /* @__PURE__ */ new Date(getZonedDateTime(date).startOfDay().add({ days: 1 }).epochMilliseconds - 1);
 //#endregion
-//#region src/util/dom/checkIsNestedInteraction.ts
+//#region src/util/dom/checkIsNestedControl.ts
 const NESTED_INTERACTION_SELECTOR = [
 	"a[href]",
 	"button",
@@ -1487,12 +1792,31 @@ const NESTED_INTERACTION_SELECTOR = [
 	"[role='switch']",
 	"[role='tab']"
 ].join(", ");
-const checkIsNestedInteraction = (event) => {
+const checkIsNestedControl = (event) => {
 	const { currentTarget, target } = event;
 	if (!(currentTarget instanceof Element) || !(target instanceof Element)) return false;
 	const interactiveElement = target.closest(NESTED_INTERACTION_SELECTOR);
-	if (interactiveElement && interactiveElement !== currentTarget && currentTarget.contains(interactiveElement)) return true;
-	else return Boolean(window.getSelection()?.toString());
+	return Boolean(interactiveElement && interactiveElement !== currentTarget && currentTarget.contains(interactiveElement));
+};
+//#endregion
+//#region src/util/dom/checkIsNestedInteraction.ts
+const checkIsNestedInteraction = (event) => checkIsNestedControl(event) || Boolean(window.getSelection()?.toString());
+//#endregion
+//#region src/util/dom/downloadUrl.ts
+const downloadUrl = (url, filename) => {
+	const anchor = window.document.createElement("a");
+	anchor.href = url;
+	anchor.download = filename;
+	anchor.click();
+};
+//#endregion
+//#region src/util/dom/downloadFile.ts
+const downloadFile = (filename, blobPart, type) => {
+	const url = URL.createObjectURL(new Blob([blobPart], { type }));
+	downloadUrl(url, filename);
+	window.setTimeout(() => {
+		URL.revokeObjectURL(url);
+	}, 0);
 };
 //#endregion
 //#region src/util/environment/checkIsServer.ts
@@ -1510,9 +1834,6 @@ const waitForSynchronizedFunctions = async () => {
 	await Promise.allSettled(pendingPromises);
 };
 //#endregion
-//#region src/util/id/constants.ts
-const ID_SEPARATOR = "|";
-//#endregion
 //#region src/util/id/uuid/constants.ts
 const UUIDV4_REGEX = /^[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/iu;
 //#endregion
@@ -1524,63 +1845,23 @@ const getOrCreate = (map, key, create) => {
 	return value;
 };
 //#endregion
-//#region src/util/object/checkIsCustomMethod.ts
-const checkIsCustomMethod = (value, methodName) => {
-	const method = Reflect.get(value, methodName);
-	return typeof method === "function" && method !== Object.prototype[methodName];
-};
-//#endregion
-//#region src/util/object/checkIsSameBytes.ts
-const toBytes = (view) => ArrayBuffer.isView(view) ? new Uint8Array(view.buffer, view.byteOffset, view.byteLength) : new Uint8Array(view);
-const checkIsSameBytes = (first, second) => {
-	const firstBytes = toBytes(first);
-	const secondBytes = toBytes(second);
-	return firstBytes.length === secondBytes.length && firstBytes.every((byte, index) => byte === secondBytes[index]);
-};
-//#endregion
-//#region src/util/object/checkIsSameValueZero.ts
-const checkIsSameValueZero = (first, second) => first === second || Number.isNaN(first) && Number.isNaN(second);
-//#endregion
-//#region src/util/object/getEnumerableKeys.ts
-const getEnumerableKeys = (value) => Reflect.ownKeys(value).filter((key) => Object.prototype.propertyIsEnumerable.call(value, key));
-//#endregion
-//#region src/util/object/checkIsDeepEqual.ts
-const checkIsBinary = (value) => ArrayBuffer.isView(value) || value instanceof ArrayBuffer || typeof SharedArrayBuffer !== "undefined" && value instanceof SharedArrayBuffer;
-const checkIsDeepEqual = (first, second) => {
-	if (first === second) return true;
-	if (typeof first !== "object" || typeof second !== "object" || first === null || second === null) return checkIsSameValueZero(first, second);
-	if (Object.getPrototypeOf(first) !== Object.getPrototypeOf(second)) return false;
-	if (Array.isArray(first) || Array.isArray(second)) {
-		if (!Array.isArray(first) || !Array.isArray(second) || first.length !== second.length) return false;
-		for (const [index, item] of first.entries()) if (!checkIsDeepEqual(item, second[index])) return false;
-		return true;
-	}
-	if (checkIsBinary(first) && checkIsBinary(second)) return checkIsSameBytes(first, second);
-	if (first instanceof RegExp && second instanceof RegExp) return first.source === second.source && first.flags === second.flags;
-	if (first instanceof WeakMap || first instanceof WeakSet || first instanceof Promise || first instanceof Blob) return false;
-	if (checkIsCustomMethod(first, "valueOf") && checkIsCustomMethod(second, "valueOf")) return checkIsSameValueZero(first.valueOf(), second.valueOf());
-	if (checkIsCustomMethod(first, "toString") && checkIsCustomMethod(second, "toString")) return first.toString() === second.toString();
-	if (first instanceof Map && second instanceof Map) {
-		if (first.size !== second.size) return false;
-		for (const [key, value] of first) if (!second.has(key) || !checkIsDeepEqual(value, second.get(key))) return false;
-		return true;
-	}
-	if (first instanceof Set && second instanceof Set) {
-		if (first.size !== second.size) return false;
-		for (const value of first) if (!second.has(value)) return false;
-		return true;
+//#region src/util/object/clonePlainDeep.ts
+const clone = (data, copies) => {
+	if (!Array.isArray(data) && !checkIsPlainObject(data)) return data;
+	else if (copies.has(data)) return copies.get(data);
+	else if (Array.isArray(data)) {
+		const copy = [];
+		copies.set(data, copy);
+		for (const [index, item] of data.entries()) copy[index] = clone(item, copies);
+		return copy;
+	} else {
+		const copy = {};
+		copies.set(data, copy);
+		for (const [key, value] of Object.entries(data)) copy[key] = clone(value, copies);
+		return copy;
 	}
-	const firstKeys = getEnumerableKeys(first);
-	if (firstKeys.length !== getEnumerableKeys(second).length) return false;
-	return firstKeys.every((key) => Object.prototype.propertyIsEnumerable.call(second, key) && checkIsDeepEqual(Reflect.get(first, key), Reflect.get(second, key)));
-};
-//#endregion
-//#region src/util/object/checkIsPlainObject.ts
-const checkIsPlainObject = (data) => {
-	if (typeof data !== "object" || data === null) return false;
-	const prototype = Object.getPrototypeOf(data);
-	return prototype === null || prototype === Object.prototype;
 };
+const clonePlainDeep = (data) => clone(data, /* @__PURE__ */ new WeakMap());
 //#endregion
 //#region src/util/object/getPropertyNames.ts
 const getPropertyNames = () => new Proxy({}, { get: (_target, property) => property });
@@ -1878,6 +2159,9 @@ const truncate = (string, length) => {
 //#region src/util/text/uncapitalize.ts
 const uncapitalize = (string) => `${string.charAt(0).toLowerCase()}${string.slice(1)}`;
 //#endregion
+//#region src/util/time/constants.ts
+const MILLISECONDS_PER_SECOND = 1e3;
+//#endregion
 //#region src/util/time/hrtime.ts
 const hrtime = (previousHrTime) => {
 	if (checkIsServer()) return process.hrtime(previousHrTime);
@@ -1910,9 +2194,4 @@ const sleep = (durationMs) => new Promise((resolve) => {
 	}, durationMs);
 });
 //#endregion
-//#region src/util/validation/exhaustiveGuard.ts
-const exhaustiveGuard = (value) => {
-	throw new InvalidOperationError("Read", exhaustiveGuard.name, JSON.stringify(value));
-};
-//#endregion
-export { ALL_SPECIAL_VALUES, CHARSET_PARAMETER_REGEX, CUSTOM_EMOJI_ID_ATTRIBUTE, CUSTOM_EMOJI_NAME_ATTRIBUTE, DEFAULT_ALLOWED_ATTRIBUTES, DEFAULT_ALLOWED_SCHEMES, DEFAULT_ALLOWED_TAGS, DEFAULT_COMPRESSION_LEVEL, DEFAULT_FACET_SCORE, DEFAULT_LINK_ATTRIBUTES, DEFAULT_SOURCE_SCORE, DEFAULT_TEXT_CHARSET, DEFAULT_TYPE_SCORE, ESCAPED_ATTRIBUTE_CHARACTERS_REGEX, ESCAPED_TEXT_CHARACTERS_REGEX, FacetScoreMap, ForbiddenError, GIBIBYTE, HTML_NAMESPACE, ID_SEPARATOR, IMPORTANT_REGEX, InvalidOperationError, ItemMetadata, KIBIBYTE, MAX_NESTING_DEPTH, MAX_READ_LIMIT, MAX_WINDOW_LOG, MEDIA_TYPE_REGEX, MENTION_EVERYONE_ID, MENTION_HERE_ID, MENTION_ID_ATTRIBUTE, MENTION_ITEM_TYPE_ATTRIBUTE, MENTION_LABEL_ATTRIBUTE, MENTION_SELECTOR, MENTION_TYPE, MENTION_TYPE_ATTRIBUTE, MIN_WINDOW_LOG, MentionType, NON_TEXT_TAGS, NotFoundError, NotInitializedError, ObjectMethod, Operation, PATH_SEPARATOR_REGEX, RoutePath, SANITIZER_ADVISORY_WATCH_SINCE, SITE_NAME, SPOILER_ATTRIBUTE, SPOILER_SELECTOR, SRCSET_ATTRIBUTE, SRCSET_DESCRIPTOR_REGEX, Serializable, SourceScoreMap, TEXT_MEDIA_TYPE_REGEX, TypeScoreMap, TypedEventEmitter, URL_ATTRIBUTES, UUIDV4_REGEX, VOID_TAGS, WordFilteredError, applyItemMetadataMixin, capitalize, charset, checkContainsProfanity, checkIsAllowedUrl, checkIsCustomMethod, checkIsDeepEqual, checkIsNestedInteraction, checkIsPlainObject, checkIsSameBytes, checkIsSameValueZero, checkIsServer, checkIsUnsafeUrlCharacter, checkIsWhitespaceCharacter, chunk, chunkBySerializedSize, collectText, contentType, createEvictingPromiseCache, createItemEntityTypeSchema, createNormalizedStringSchema, createUniqueArraySchema, css, dedent, encodeUrlSubDelimiters, englishProfaneWords, escapeAttribute, escapeCharacters, escapeText, exhaustiveGuard, extension, filterAttributes, filterClasses, filterHtml, filterSrcset, filterStyle, getChildNodes, getDecodedUriComponent, getEndOfDay, getEnumerableKeys, getExtensionMimeTypeMap, getMediaType, getMentions, getMimeScore, getMimeTypeEntryMap, getOrCreate, getPropertyNames, getRawData, getRequestError, getResult, getResultAsync, getSynchronizedFunction, getTransactionDone, getTransactionObjectStore, getWindowLog, getZonedDateTime, hrtime, html, jsonDateParse, lookup, matchesClassPattern, mergeObjectsStrict, noop, normalizeString, now, omitDeep, openDatabase, renderNode, reportFinalizerError, requestToPromise, sanitizeHtml, sanitizeTextHtml, settleAll, sleep, streamToText, takeOne, toAppError, toKebabCase, toRawDeep, truncate, uncapitalize, waitForSynchronizedFunctions, withFinalizer, withFinalizerAsync, wrapDatabase, wrapIndex, wrapObjectStore, wrapTransaction, wrapUpgradeDatabase, wrapUpgradeTransaction };
+export { ALL_SPECIAL_VALUES, APPEND_SEGMENT, CHARSET_PARAMETER_REGEX, CUSTOM_EMOJI_ID_ATTRIBUTE, CUSTOM_EMOJI_NAME_ATTRIBUTE, DEFAULT_ALLOWED_ATTRIBUTES, DEFAULT_ALLOWED_SCHEMES, DEFAULT_ALLOWED_TAGS, DEFAULT_COMPRESSION_LEVEL, DEFAULT_FACET_SCORE, DEFAULT_LINK_ATTRIBUTES, DEFAULT_SOURCE_SCORE, DEFAULT_TEXT_CHARSET, DEFAULT_TYPE_SCORE, ESCAPED_ATTRIBUTE_CHARACTERS_REGEX, ESCAPED_TEXT_CHARACTERS_REGEX, FacetScoreMap, ForbiddenError, GIBIBYTE, HTML_NAMESPACE, ID_SEPARATOR, IMPORTANT_REGEX, InvalidOperationError, ItemMetadata, JSON_POINTER_REGEX, JsonPatchOperationType, KIBIBYTE, MAX_NESTING_DEPTH, MAX_READ_LIMIT, MAX_WINDOW_LOG, MEDIA_TYPE_REGEX, MENTION_EVERYONE_ID, MENTION_HERE_ID, MENTION_ID_ATTRIBUTE, MENTION_ITEM_TYPE_ATTRIBUTE, MENTION_LABEL_ATTRIBUTE, MENTION_SELECTOR, MENTION_TYPE, MENTION_TYPE_ATTRIBUTE, MILLISECONDS_PER_SECOND, MIN_WINDOW_LOG, MentionType, NON_TEXT_TAGS, NotFoundError, NotInitializedError, ObjectMethod, Operation, PATH_SEPARATOR_REGEX, RoutePath, SANITIZER_ADVISORY_WATCH_SINCE, SITE_NAME, SPOILER_ATTRIBUTE, SPOILER_SELECTOR, SRCSET_ATTRIBUTE, SRCSET_DESCRIPTOR_REGEX, Serializable, SourceScoreMap, TEXT_MEDIA_TYPE_REGEX, TypeScoreMap, TypedEventEmitter, URL_ATTRIBUTES, UUIDV4_REGEX, VOID_TAGS, WordFilteredError, addJsonValue, applyItemMetadataMixin, applyPatch, applyPatches, capitalize, charset, checkContainsProfanity, checkIsAllowedUrl, checkIsCustomMethod, checkIsDeepEqual, checkIsNestedControl, checkIsNestedInteraction, checkIsPlainObject, checkIsSameBytes, checkIsSameValueZero, checkIsServer, checkIsUnsafeUrlCharacter, checkIsWhitespaceCharacter, chunk, chunkBySerializedSize, clonePlainDeep, collectText, contentType, createEvictingPromiseCache, createHistory, createItemEntityTypeSchema, createNormalizedStringSchema, createUniqueArraySchema, css, dedent, downloadFile, downloadUrl, encodeUrlSubDelimiters, englishProfaneWords, escapeAttribute, escapeCharacters, escapeText, exhaustiveGuard, extension, filterAttributes, filterClasses, filterHtml, filterSrcset, filterStyle, getChildNodes, getDecodedUriComponent, getEndOfDay, getEnumerableKeys, getExtensionMimeTypeMap, getMediaType, getMentions, getMimeScore, getMimeTypeEntryMap, getOrCreate, getPropertyNames, getRawData, getRequestError, getResult, getResultAsync, getSynchronizedFunction, getTransactionDone, getTransactionObjectStore, getWindowLog, getZonedDateTime, hrtime, html, jsonDateParse, lookup, matchesClassPattern, mergeObjectsStrict, noop, normalizeString, now, omitDeep, openDatabase, parseArrayIndex, parseJsonPointer, pushHistory, readJsonValue, redoHistory, removeJsonValue, renderNode, reportFinalizerError, requestToPromise, sanitizeHtml, sanitizeTextHtml, settleAll, sleep, streamToText, takeOne, takeRandom, toAppError, toJsonPointer, toKebabCase, toRawDeep, truncate, uncapitalize, undoHistory, updateJsonValue, waitForSynchronizedFunctions, withFinalizer, withFinalizerAsync, wrapDatabase, wrapIndex, wrapObjectStore, wrapTransaction, wrapUpgradeDatabase, wrapUpgradeTransaction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esposter/shared",
-  "version": "4.1.2",
+  "version": "4.3.1",
   "description": "A library that contains shared typescript code.",
   "keywords": [
     "error-handling",
@@ -40,8 +40,6 @@
   },
   "scripts": {
     "build": "tsdown",
-    "format": "oxfmt",
-    "format:check": "oxfmt --check",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
     "test": "vitest",
@@ -50,20 +48,17 @@
   "dependencies": {
     "mime-db": "^1.54.0",
     "neverthrow": "^8.2.0",
-    "node-html-parser": "^9.0.4",
+    "node-html-parser": "^9.0.5",
     "parse5": "^8.0.1"
   },
   "devDependencies": {
-    "@arethetypeswrong/core": "^0.18.5",
     "@azure/data-tables": "^13.3.2",
-    "@esposter/configuration": "4.1.2",
+    "@esposter/configuration": "4.3.1",
     "@types/node": "^26.6.5",
-    "fake-indexeddb": "^6.2.5",
-    "happy-dom": "^21.0.1",
-    "publint": "^0.3.25",
+    "fake-indexeddb": "^6.2.6",
+    "happy-dom": "^21.0.4",
     "tsdown": "^0.23.1",
     "type-fest": "^5.10.0",
-    "vitest": "^5.0.4",
     "vue": "^3.5.44"
   },
   "peerDependencies": {
@@ -72,5 +67,5 @@
   "inlinedDependencies": {
     "type-fest": "5.10.0"
   },
-  "gitHead": "144e3f98570b015e3181bfbc6cb70d346ce826b5"
+  "gitHead": "777a39636b789c13af33ed13370246ccf6dbaf31"
 }