@esposter/shared 4.3.3 → 4.5.0

package/README.md

@@ -5,27 +5,29 @@
 [![NPM downloads][badge-npm-downloads]][url-npm]
 [![NPM Unpacked Size (with version)][badge-npm-unpacked-size]][url-npm]
 
-Shared TypeScript utilities, types, and error classes for the Esposter platform. Works in both browser and server environments.
+Provides shared TypeScript utilities, types and error classes for the Esposter platform.
+
+Design notes live in [the specs](https://github.com/Esposter/Esposter/tree/main/openspec/specs/shared).
 
 ## Table of Contents
 
 - 🚀 [Getting Started](#getting-started)
-- 📖 [Documentation](#documentation)
+- 🧩 [Key Exports](#key-exports)
 - ⚖️ [License](#license)
 
 ---
 
 ## <a name="getting-started">🚀 Getting Started</a>
 
+Install the package and zod.
+
 ```bash
 pnpm i @esposter/shared zod
 ```
 
-## <a name="documentation">📖 Documentation</a>
+The package works in browser and server environments.
 
-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
+## <a name="key-exports">🧩 Key Exports</a>
 
 #### Error Classes
 
@@ -40,7 +42,7 @@ throw new InvalidOperationError(Operation.Read, file.name, zodError.message);
 ```ts
 import { takeOne } from "@esposter/shared";
 
-// Safe index access — throws on out-of-bounds instead of returning undefined
+// The first item, typed without `undefined`; an out-of-bounds index still yields `undefined` at runtime
 const first = takeOne(items);
 ```
 
@@ -49,7 +51,7 @@ const first = takeOne(items);
 ```ts
 import type { ToData, DeepOmit, GetPaths } from "@esposter/shared";
 
-// ToData<T> — strips class methods, returns plain data shape
+// ToData<T> — the plain data shape of T, with its `toJSON` method removed at every depth
 type RawColumn = ToData<Column>;
 ```
 
@@ -74,17 +76,6 @@ import { capitalize, truncate, toKebabCase } from "@esposter/shared";
 import { getResult, getResultAsync, withFinalizer } from "@esposter/shared";
 ```
 
-### Commands
-
-Run from `packages/shared/`:
-
-```bash
-pnpm build        # compile to dist/
-pnpm test         # vitest watch mode (coverage is run from the repo root)
-pnpm lint:fix     # auto-fix lint
-pnpm typecheck    # type check
-```
-
 ## <a name="license">⚖️ License</a>
 
 This project is licensed under the [Apache-2.0 license](https://github.com/Esposter/Esposter/blob/main/LICENSE).

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { Result, ResultAsync } from "neverthrow";
-import { HTMLElement } from "node-html-parser";
+import { HTMLElement as HTMLElement$1 } from "node-html-parser";
 import { DefaultTreeAdapterTypes, html as html$1 } from "parse5";
 export declare class ForbiddenError extends Error {
   constructor(message: string);
@@ -139,6 +139,150 @@ export declare enum ObjectMethod {
   ToString = "toString",
   ValueOf = "valueOf"
 }
+export interface PanzoomEventDetail {
+  isSVG: boolean;
+  originalEvent?: Event;
+  scale: number;
+  x: number;
+  y: number;
+}
+export declare enum PanzoomContain {
+  Automatic = "automatic",
+  Inside = "inside",
+  Outside = "outside"
+}
+export type PanzoomStartScale = "fit" | number;
+export interface PanzoomOptions {
+  animate?: boolean;
+  canvas?: boolean;
+  contain?: PanzoomContain;
+  cursor?: string;
+  disablePan?: boolean;
+  disableXAxis?: boolean;
+  disableYAxis?: boolean;
+  disableZoom?: boolean;
+  duration?: number;
+  easing?: string;
+  exclude?: Element[];
+  excludeClass?: string;
+  filter?: (event: PointerEvent) => boolean;
+  handleStartEvent?: (event: Event) => void;
+  maxScale?: number;
+  minScale?: number;
+  noBind?: boolean;
+  overflow?: string;
+  panCursor?: string;
+  panOnlyWhenZoomed?: boolean;
+  panThreshold?: number;
+  pinchAndPan?: boolean;
+  relative?: boolean;
+  roundPixels?: boolean;
+  setTransform?: (element: HTMLElement | SVGElement, detail: Pick<PanzoomEventDetail, "isSVG" | "scale" | "x" | "y">) => void;
+  silent?: boolean;
+  startScale?: PanzoomStartScale;
+  startX?: number;
+  startY?: number;
+  step?: number;
+  touchAction?: string;
+}
+export interface PanzoomPanOptions extends PanzoomOptions {
+  force?: boolean;
+}
+export interface PanzoomPoint {
+  x: number;
+  y: number;
+}
+export interface PanzoomZoomOptions extends PanzoomPanOptions {
+  focal?: PanzoomPoint;
+}
+export interface Panzoom {
+  bind: () => void;
+  destroy: () => void;
+  fit: (fitOptions?: PanzoomPanOptions) => PanzoomEventDetail;
+  getOptions: () => PanzoomOptions;
+  getPan: () => PanzoomPoint;
+  getScale: () => number;
+  pan: (x: number, y: number, panOptions?: PanzoomPanOptions) => PanzoomEventDetail;
+  reset: (resetOptions?: PanzoomPanOptions) => PanzoomEventDetail;
+  resetStyle: () => void;
+  setOptions: (options?: PanzoomOptions) => void;
+  zoom: (scale: number, zoomOptions?: PanzoomZoomOptions) => PanzoomEventDetail;
+  zoomIn: (zoomOptions?: PanzoomZoomOptions) => PanzoomEventDetail;
+  zoomOut: (zoomOptions?: PanzoomZoomOptions) => PanzoomEventDetail;
+  zoomToPoint: (scale: number, point: Pick<MouseEvent, "clientX" | "clientY">, zoomOptions?: PanzoomZoomOptions, originalEvent?: Event) => PanzoomEventDetail;
+  zoomWithWheel: (event: WheelEvent, zoomOptions?: PanzoomZoomOptions) => PanzoomEventDetail;
+}
+export interface PanzoomAxis {
+  center: number;
+  length: number;
+  parentLength: number;
+  parentStart: number;
+}
+export interface PanzoomBox {
+  height: number;
+  left: number;
+  top: number;
+  width: number;
+}
+export interface PanzoomDrag {
+  anchorPan: PanzoomPoint;
+  anchorPoint: PanzoomPoint;
+  downPoint: PanzoomPoint;
+  isDragging: boolean;
+}
+export type PanzoomElement = HTMLElement | SVGElement;
+export interface PanzoomPinch {
+  midpoint: PanzoomPoint;
+  startDistance: number;
+  startScale: number;
+}
+export interface PanzoomState {
+  scale: number;
+  x: number;
+  y: number;
+}
+export interface PanzoomContext {
+  drag?: PanzoomDrag;
+  element: PanzoomElement;
+  isClickSuppressed: boolean;
+  isDestroyed: boolean;
+  options: PanzoomOptions;
+  parent: PanzoomElement;
+  pinch?: PanzoomPinch;
+  pointers: Map<number, PanzoomPoint>;
+  state: PanzoomState;
+  styles: Map<PanzoomElement, Map<string, string>>;
+}
+export declare enum PanzoomDeltaMode {
+  Pixel = 0,
+  Line = 1,
+  Page = 2
+}
+export declare enum PanzoomEventName {
+  Change = "panzoomchange",
+  End = "panzoomend",
+  Pan = "panzoompan",
+  Reset = "panzoomreset",
+  Start = "panzoomstart",
+  Zoom = "panzoomzoom"
+}
+export interface PanzoomSize {
+  height: number;
+  width: number;
+}
+export interface PanzoomMeasure {
+  center: PanzoomPoint;
+  parent: PanzoomBox;
+  size: PanzoomSize;
+}
+export interface PanzoomPinchFrame {
+  distance: number;
+  midpoint: PanzoomPoint;
+}
+export declare enum PanzoomZoomDirection {
+  In = "in",
+  Out = "out"
+}
 export interface ProfanityOptions {
   isWholeWord: boolean;
 }
@@ -188,6 +332,7 @@ export type AttributesTransformer = (attributes: Record<string, string>) => Reco
 export interface SanitizeHtmlOptions {
   allowedAttributes?: Record<string, string[]>;
   allowedClasses?: Record<string, string[]>;
+  allowedSources?: Record<string, Record<string, RegExp[]>>;
   allowedStyles?: Record<string, Record<string, RegExp[]>>;
   allowedTags?: string[];
   transformAttributes?: Record<string, AttributesTransformer>;
@@ -196,10 +341,12 @@ export interface SanitizePolicy {
   allowedAttributes: Record<string, string[]>;
   allowedClasses: Record<string, string[]>;
   allowedSchemes: string[];
+  allowedSources: Record<string, Record<string, RegExp[]>>;
   allowedStyles: Record<string, Record<string, RegExp[]>>;
   allowedTags: string[];
   transformAttributes: Record<string, AttributesTransformer>;
 }
+export type TextHtmlAllowance = Pick<SanitizeHtmlOptions, "allowedAttributes" | "allowedSources" | "allowedTags">;
 export interface ItemEntityType<T extends string> {
   type: T;
 }
@@ -1870,6 +2017,29 @@ export interface ItemMetadataClass<TBase extends Class<object>> {
   new (...args: ConstructorParameters<TBase>): InstanceType<TBase> & ItemMetadata;
   prototype: InstanceType<TBase> & ItemMetadata;
 }
+export type GetArrayProps<T extends unknown[], P extends string, D extends unknown[], R extends boolean> = (D extends [unknown, ...infer Rest] ? GetProperties<T[number], R extends true ? `${P}[number]` : `${P}.[number]`, Rest, false> : never) | {
+  path: R extends true ? "length" : `${P}.length`;
+  value: T["length"];
+};
+export type FunctionLike = ((...args: never) => unknown) | (abstract new (...args: never) => unknown);
+export type KnownKeys<T> = { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K]; };
+export type GetObjectProps<T, P extends string, D extends unknown[], R extends boolean> = { [K in keyof KnownKeys<T> & (number | string)]: K extends `${number}` ? never : NonNullable<T[K]> extends FunctionLike ? never : (D extends [unknown, ...infer Rest] ? GetProperties<T[K], R extends true ? `${K}` : `${P}.${K}`, Rest, false> : never) | {
+  path: R extends true ? `${K}` : `${P}.${K}`;
+  value: T[K];
+}; }[keyof KnownKeys<T> & (number | string)];
+export type GetPrimitiveProps<T, P extends string, D extends unknown[], R extends boolean> = T extends string ? {
+  path: R extends true ? "length" : `${P}.length`;
+  value: number;
+} : T extends symbol ? (D extends [unknown, ...infer Rest] ? GetProperties<string | undefined, R extends true ? "description" : `${P}.description`, Rest, false> : never) | {
+  path: R extends true ? "description" : `${P}.description`;
+  value: string | undefined;
+} : never;
+export type GetProperties<T, P extends string = "", D extends unknown[] = [unknown, unknown, unknown, unknown, unknown], R extends boolean = true> = [T] extends [never] ? never : D extends [] ? never : NonNullable<T> extends (infer O) ? O extends unknown[] ? GetArrayProps<O, P, D, R> : O extends object ? GetObjectProps<O, P, D, R> : GetPrimitiveProps<O, P, D, R> : never;
+export type GetPaths<T> = GetProperties<T> extends (infer U) ? (U extends {
+  path: infer Path;
+} ? Path : never) : never;
+export type PropertyNames<T> = { [P in GetPaths<T>]: P; };
+export declare const ItemMetadataPropertyNames: PropertyNames<ItemMetadata>;
 export declare abstract class Serializable {
   toJSON(): this;
 }
@@ -1877,7 +2047,6 @@ export interface TakeOne {
   <T extends readonly unknown[]>(values: T, index?: number): T[number];
   <T extends object>(values: T, index: keyof T): T[keyof T];
 }
-export type FunctionLike = ((...args: never) => unknown) | (abstract new (...args: never) => unknown);
 export type DeepOmit<T, TKey extends PropertyKey> = T extends DeepOmitKeptValue ? T : T extends readonly unknown[] ? { [K in keyof T]: DeepOmit<T[K], TKey>; } : T extends object ? [keyof T] extends [never] ? T : { [P in keyof T as P extends symbol ? never : P extends TKey ? never : P]: DeepOmit<T[P], TKey>; } : T;
 type DeepOmitKeptValue = ArrayBufferView | Blob | Date | FunctionLike | Map<unknown, unknown> | Primitive | Promise<unknown> | RegExp | Set<unknown>;
 export type DeepOptionalUndefined<T> = T extends Date | FunctionLike | Primitive ? T : T extends unknown[] ? { [K in keyof T]: DeepOptionalUndefined<T[K]>; } : T extends object ? { [K in keyof T as undefined extends T[K] ? K : never]?: DeepOptionalUndefined<T[K]>; } & { [K in keyof T as undefined extends T[K] ? never : K]: DeepOptionalUndefined<T[K]>; } extends (infer O) ? { [K in keyof O]: O[K]; } : never : T;
@@ -1941,7 +2110,9 @@ export declare const CUSTOM_EMOJI_ID_ATTRIBUTE = "data-custom-emoji-id";
 export declare const CUSTOM_EMOJI_NAME_ATTRIBUTE = "data-custom-emoji-name";
 export declare const SPOILER_ATTRIBUTE = "data-spoiler";
 export declare const SPOILER_SELECTOR: string;
-export declare const getMentions: (message: string) => HTMLElement[];
+export declare const checkIsOnlyReactor: (userIds: string[], userId: string) => boolean;
+export declare const getUpdatedUserIds: (userIds: string[], newUserId: string) => string[];
+export declare const getMentions: (message: string) => HTMLElement$1[];
 export declare const charset: (type: string) => false | string;
 export declare const MEDIA_TYPE_REGEX: RegExp;
 export declare const PATH_SEPARATOR_REGEX: RegExp;
@@ -1961,11 +2132,74 @@ export declare const getMediaType: (value: string) => string;
 export declare const getMimeScore: (mimeType: string, source?: string) => number;
 export declare const getMimeTypeEntryMap: () => ReadonlyMap<string, MimeDatabaseEntry>;
 export declare const lookup: (path: string) => false | string;
+export declare const applyPanzoomStyles: (context: PanzoomContext) => void;
+export declare const bindPanzoom: (context: PanzoomContext, signal: AbortSignal) => void;
+export declare const checkIsContainableLength: (length: number) => boolean;
+export declare const checkIsPanzoomElement: (value: Element) => value is PanzoomElement;
+export declare const checkIsPanzoomExcluded: (target: Element, { exclude, excludeClass }: Pick<PanzoomOptions, "exclude" | "excludeClass">) => boolean;
+export declare const checkIsZoomRefused: ({ disableZoom, force }: PanzoomZoomOptions) => boolean;
+export declare const PANZOOM_DEFAULT_MAX_SCALE = 4;
+export declare const PANZOOM_DEFAULT_MIN_SCALE = .125;
+export declare const PANZOOM_DEFAULT_START_SCALE = 1;
+export declare const PANZOOM_DEFAULT_STEP = .3;
+export declare const PANZOOM_WHEEL_STEP_DIVISOR = 3;
+export declare const PANZOOM_WHEEL_NOTCH_PIXELS = 100;
+export declare const PANZOOM_PIXELS_PER_LINE = 16;
+export declare const PANZOOM_PRIMARY_BUTTON = 0;
+export declare const PANZOOM_DEFAULT_CURSOR = "move";
+export declare const PANZOOM_DEFAULT_DURATION = 200;
+export declare const PANZOOM_DEFAULT_EASING = "ease-in-out";
+export declare const PANZOOM_DEFAULT_EXCLUDE_CLASS = "panzoom-exclude";
+export declare const PANZOOM_DEFAULT_OVERFLOW = "hidden";
+export declare const PANZOOM_DEFAULT_PAN_THRESHOLD = 0;
+export declare const PANZOOM_DEFAULT_START_PAN = 0;
+export declare const PANZOOM_DEFAULT_TOUCH_ACTION = "none";
+export declare const PANZOOM_TRANSFORM_ORIGIN = "50% 50%";
+export declare const PANZOOM_SVG_NAMESPACE = "http://www.w3.org/2000/svg";
+export declare const PANZOOM_DEFAULT_OPTIONS: Readonly<PanzoomOptions>;
+export declare const constrainPanzoomAxis: (value: number, axis: PanzoomAxis, scale: number, contain?: PanzoomContain) => number;
+export declare const constrainPanzoomPan: (current: PanzoomState, requested: PanzoomPoint, toScale: number, measure: PanzoomMeasure, options: PanzoomPanOptions) => PanzoomPoint;
+export declare const constrainPanzoomScale: (scale: number, measure: PanzoomMeasure, { contain, maxScale, minScale }: Pick<PanzoomOptions, "contain" | "maxScale" | "minScale">) => number;
+export declare const createPanzoom: (element: PanzoomElement, options?: PanzoomOptions) => Panzoom;
+export declare const dispatchPanzoomChange: (context: Pick<PanzoomContext, "element" | "isDestroyed">, name: PanzoomEventName, detail: PanzoomEventDetail, options: Pick<PanzoomOptions, "silent">) => void;
+export declare const dispatchPanzoomEvent: ({ element, isDestroyed }: Pick<PanzoomContext, "element" | "isDestroyed">, name: PanzoomEventName, detail: PanzoomEventDetail, { silent }: Pick<PanzoomOptions, "silent">) => void;
+export declare const endPanzoomGesture: (context: PanzoomContext, event: PointerEvent) => void;
+export declare const fitPanzoom: (context: PanzoomContext, callOptions: PanzoomZoomOptions) => PanzoomEventDetail;
+export declare const getPanzoomCallOptions: ({ options }: PanzoomContext, callOptions: PanzoomZoomOptions) => PanzoomZoomOptions;
+export declare const getPanzoomCentredPan: (scale: number, measure: PanzoomMeasure) => PanzoomPoint;
+export declare const getPanzoomCoverScale: (measure: PanzoomMeasure) => number;
+export declare const getPanzoomDrag: (state: PanzoomState, point: PanzoomPoint) => PanzoomDrag;
+export declare const getPanzoomEventDetail: ({ element, state }: PanzoomContext, originalEvent?: Event) => PanzoomEventDetail;
+export declare const getPanzoomFitScale: ({ parent, size }: PanzoomMeasure) => number;
+export declare const getPanzoomFocalPan: (current: PanzoomState, toScale: number, point: PanzoomPoint, measure: PanzoomMeasure) => PanzoomPoint;
+export declare const getPanzoomMeasure: (element: PanzoomElement, parent: PanzoomElement, state: PanzoomState) => PanzoomMeasure;
+export declare const getPanzoomParent: (element: PanzoomElement) => null | PanzoomElement;
+export declare const getPanzoomPinchFrame: (pointers: Map<number, PanzoomPoint>) => PanzoomPinchFrame;
+export declare const getPanzoomPinchScale: (startScale: number, startDistance: number, distance: number) => number;
+export declare const getPanzoomStartScale: (measure: PanzoomMeasure, options: Pick<PanzoomPanOptions, "contain" | "maxScale" | "minScale" | "startScale">) => number;
+export declare const getPanzoomStartState: (state: PanzoomState, measure: PanzoomMeasure, options: PanzoomPanOptions) => PanzoomState;
+export declare const getPanzoomStepScale: (scale: number, direction: PanzoomZoomDirection, step?: number) => number;
+export declare const getPanzoomTarget: ({ element, options, parent }: PanzoomContext) => PanzoomElement;
+export declare const getPanzoomWheelScale: (scale: number, { deltaMode, deltaX, deltaY }: Pick<WheelEvent, "deltaMode" | "deltaX" | "deltaY">, step?: number) => number;
+export declare const getPanzoomZoomedState: (state: PanzoomState, measure: PanzoomMeasure, options: PanzoomPanOptions, scale: number, focal?: PanzoomPoint) => PanzoomState;
+export declare const movePanzoomDrag: (context: PanzoomContext, drag: PanzoomDrag, point: PanzoomPoint, event: PointerEvent) => void;
+export declare const movePanzoomGesture: (context: PanzoomContext, event: PointerEvent) => void;
+export declare const movePanzoomPinch: (context: PanzoomContext, pinch: PanzoomPinch, event: PointerEvent) => void;
+export declare const panPanzoom: (context: PanzoomContext, point: PanzoomPoint, callOptions: PanzoomZoomOptions, originalEvent?: Event) => PanzoomEventDetail;
+export declare const reanchorPanzoomDrag: ({ drag, pointers, state }: PanzoomContext) => void;
+export declare const resetPanzoom: (context: PanzoomContext, callOptions: PanzoomZoomOptions) => PanzoomEventDetail;
+export declare const restorePanzoomStyles: ({ styles }: PanzoomContext, properties?: readonly string[]) => void;
+export declare const startPanzoomGesture: (context: PanzoomContext, event: PointerEvent) => void;
+export declare const writePanzoomState: (context: PanzoomContext, state: PanzoomState, { animate, duration, easing, setTransform }: PanzoomPanOptions) => void;
+export declare const writePanzoomStyle: ({ isDestroyed, styles }: PanzoomContext, element: PanzoomElement, property: string, value: string) => void;
+export declare const zoomPanzoom: (context: PanzoomContext, scale: number, callOptions: PanzoomZoomOptions, originalEvent?: Event) => PanzoomEventDetail;
+export declare const zoomPanzoomStep: (context: PanzoomContext, direction: PanzoomZoomDirection, zoomOptions: PanzoomZoomOptions) => PanzoomEventDetail;
 export declare const css: typeof String.raw;
 export declare const html: typeof String.raw;
 export declare const checkContainsProfanity: (text: unknown, { isWholeWord }?: Partial<ProfanityOptions>) => boolean;
 export declare const englishProfaneWords: readonly string[];
 export declare const checkIsAllowedUrl: (url: string, allowedSchemes: string[]) => boolean;
+export declare const checkIsSourceAllowed: (element: DefaultTreeAdapterTypes.Element, allowedSources: SanitizePolicy["allowedSources"]) => boolean;
 export declare const checkIsUnsafeUrlCharacter: (character: string) => boolean;
 export declare const checkIsWhitespaceCharacter: (character: string) => boolean;
 export declare const collectText: (nodes: DefaultTreeAdapterTypes.ChildNode[], depth: number) => string;
@@ -1983,7 +2217,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-21";
+export declare const SANITIZER_ADVISORY_WATCH_SINCE = "2026-10-23";
 export declare const escapeAttribute: (value: string) => string;
 export declare const escapeCharacters: (value: string, charactersRegex: RegExp, entities: Record<string, string>) => string;
 export declare const escapeText: (text: string) => string;
@@ -1993,12 +2227,14 @@ export declare const filterHtml: (html: string, policy: SanitizePolicy) => strin
 export declare const filterSrcset: (value: string, allowedSchemes: string[]) => string | undefined;
 export declare const filterStyle: (value: string, rules: Record<string, RegExp[]> | undefined) => string | undefined;
 export declare const getChildNodes: (element: DefaultTreeAdapterTypes.Element) => DefaultTreeAdapterTypes.ChildNode[];
+export declare const getTagPolicy: <T>(tagPolicies: Record<string, T>, tagName: string) => T | undefined;
 export declare const matchesClassPattern: (className: string, pattern: string) => boolean;
 export declare const renderNode: (node: DefaultTreeAdapterTypes.ChildNode, policy: SanitizePolicy, depth: number) => string;
 export declare const sanitizeHtml: (html: string, options?: SanitizeHtmlOptions) => string;
-export declare const sanitizeTextHtml: (html: string) => string;
+export declare const sanitizeTextHtml: (html: string, allowance?: TextHtmlAllowance) => string;
 export declare const applyItemMetadataMixin: <TBase extends Class<object>>(Base: TBase) => ItemMetadataClass<TBase>;
 export declare const createNormalizedStringSchema: (maxLength: number, schema?: z.ZodString) => z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
+export declare const createRecordSchema: <TKey extends z.core.$ZodRecordKey, TValue extends z.core.SomeType>(keySchema: TKey, valueSchema: TValue, maxEntries: number) => z.ZodRecord<TKey, TValue>;
 export declare const createUniqueArraySchema: CreateUniqueArraySchema;
 export declare const DEFAULT_COMPRESSION_LEVEL = 12;
 export declare const MIN_WINDOW_LOG = 10;
@@ -2032,33 +2268,13 @@ export declare const checkIsSameBytes: (first: ArrayBuffer | ArrayBufferView | S
 export declare const checkIsSameValueZero: (first: unknown, second: unknown) => boolean;
 export declare const clonePlainDeep: <T>(data: T) => T;
 export declare const getEnumerableKeys: (value: object) => PropertyKey[];
-export type GetArrayProps<T extends unknown[], P extends string, D extends unknown[], R extends boolean> = (D extends [unknown, ...infer Rest] ? GetProperties<T[number], R extends true ? `${P}[number]` : `${P}.[number]`, Rest, false> : never) | {
-  path: R extends true ? "length" : `${P}.length`;
-  value: T["length"];
-};
-export type KnownKeys<T> = { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K]; };
-export type GetObjectProps<T, P extends string, D extends unknown[], R extends boolean> = { [K in keyof KnownKeys<T> & (number | string)]: K extends `${number}` ? never : NonNullable<T[K]> extends FunctionLike ? never : (D extends [unknown, ...infer Rest] ? GetProperties<T[K], R extends true ? `${K}` : `${P}.${K}`, Rest, false> : never) | {
-  path: R extends true ? `${K}` : `${P}.${K}`;
-  value: T[K];
-}; }[keyof KnownKeys<T> & (number | string)];
-export type GetPrimitiveProps<T, P extends string, D extends unknown[], R extends boolean> = T extends string ? {
-  path: R extends true ? "length" : `${P}.length`;
-  value: number;
-} : T extends symbol ? (D extends [unknown, ...infer Rest] ? GetProperties<string | undefined, R extends true ? "description" : `${P}.description`, Rest, false> : never) | {
-  path: R extends true ? "description" : `${P}.description`;
-  value: string | undefined;
-} : never;
-export type GetProperties<T, P extends string = "", D extends unknown[] = [unknown, unknown, unknown, unknown, unknown], R extends boolean = true> = [T] extends [never] ? never : D extends [] ? never : NonNullable<T> extends (infer O) ? O extends unknown[] ? GetArrayProps<O, P, D, R> : O extends object ? GetObjectProps<O, P, D, R> : GetPrimitiveProps<O, P, D, R> : never;
-export type GetPaths<T> = GetProperties<T> extends (infer U) ? (U extends {
-  path: infer Path;
-} ? Path : never) : never;
-export type PropertyNames<T> = { [P in GetPaths<T>]: P; };
 export declare const getPropertyNames: <T>() => PropertyNames<T>;
 export declare const jsonDateParse: <T = any>(text: string) => T;
 export type MergeObjectsStrict<T extends object[]> = T extends [infer TFirst, infer TSecond, ...infer TRemaining] ? TSecond extends { [K in keyof TSecond]: K extends keyof TFirst ? never : TSecond[K]; } ? TRemaining extends object[] ? MergeObjectsStrict<[TSecond, ...TRemaining]> & TFirst : TFirst & TSecond : never : T extends [infer TFirst] ? TFirst : never;
 export declare const mergeObjectsStrict: <T extends object[]>(...objects: T) => MergeObjectsStrict<T>;
 export declare const omitDeep: <T, TKey extends string>(value: T, ...keys: TKey[]) => DeepOmit<T, TKey>;
 export declare const createEvictingPromiseCache: <TArguments extends unknown[], TValue>(getKey: (...args: TArguments) => string, load: (...args: TArguments) => Promise<TValue>) => ((...args: TArguments) => Promise<TValue>);
+export declare const rethrowRejections: (reasons: unknown[]) => void;
 export declare const settleAll: <T>(tasks: (() => Promise<T>)[], concurrencyLimit?: number) => Promise<T[]>;
 export declare const getRawData: <T>(data: T) => T;
 export declare const toRawDeep: <T extends object>(data: T) => T;
@@ -2067,12 +2283,14 @@ export declare const dedent: Dedent;
 export declare const encodeUrlSubDelimiters: (value: string) => string;
 export declare const getDecodedUriComponent: (value: string, fallback: string) => string;
 export declare const normalizeString: (value: string | undefined) => string;
+export declare const padWithZeros: (value: number, length: number) => string;
 export declare const streamToText: (readable: NodeJS.ReadableStream) => Promise<string>;
 export declare const toKebabCase: <T extends string>(string: T) => KebabCase<T>;
 export declare const truncate: (string: string, length: number) => string;
 export declare const uncapitalize: <T extends string>(string: T) => Uncapitalize<T>;
 export declare const MILLISECONDS_PER_SECOND = 1e3;
-export declare const hrtime: (previousHrTime?: [number, number]) => [number, number];
+export declare const createExponentialBackoff: (baseDelayMs: number, maxDelayMs: number) => (<T>(operation: () => Promise<T>) => Promise<T>);
+export declare const getExponentialBackoffDelayMs: (attempt: number, baseDelayMs: number, maxDelayMs: number) => number;
 export declare const now: () => string;
 export declare const sleep: (durationMs: number) => Promise<void>;
 export declare const exhaustiveGuard: (value: never) => never;