@memberjunction/global 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/index.js

@@ -12,6 +12,7 @@ export * from './ClassUtils.js';
 export * from './util/PatternUtils.js';
 export * from './util/ResourcePatternUtils.js';
 export * from './util/UUIDUtils.js';
+export * from './util/UUIDCollections.js';
 export * from './util/CronUtils.js';
 export * from './util/SerializationUtils.js';
 export * from './util/BinaryEncoding.js';
@@ -19,6 +20,7 @@ export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.js';
 export * from './fieldRules/index.js';
+export * from './SQLScreeningScanner.js';
 export * from './SQLExpressionValidator.js';
 export * from './warningManager.js';
 export * from './EncryptionUtils.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAEtC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,CAAA;AAE7C,6DAA6D;AAC7D,oCAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AAEtC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,CAAA;AAE7C,6DAA6D;AAC7D,oCAAoC"}

package/dist/util/UUIDCollections.d.ts

@@ -0,0 +1,111 @@
+/** A UUID as it arrives from data: possibly upper-case, padded, or missing. */
+export type UUIDInput = string | null | undefined;
+/** Reads the UUID used to match an item. */
+export type UUIDSelector<T> = (item: T) => UUIDInput;
+/**
+ * A `Set` of UUIDs that matches case- and whitespace-insensitively. Every ID is normalized on
+ * insert and on lookup, so `Has('A1B2…')` finds an ID added as `'a1b2…'`. Iterates normalized IDs.
+ *
+ * @example
+ * const selected = new UUIDSet(selectedIds);
+ * const picked = rows.filter(r => selected.Has(r.ID));
+ */
+export declare class UUIDSet implements Iterable<string> {
+    private readonly ids;
+    constructor(ids?: Iterable<UUIDInput>);
+    /** Adds an ID. Returns this set, for chaining. */
+    Add(id: UUIDInput): this;
+    /** True when the ID is in the set, ignoring case and surrounding whitespace. */
+    Has(id: UUIDInput): boolean;
+    /** Removes an ID. Returns true when it was present. */
+    Delete(id: UUIDInput): boolean;
+    Clear(): void;
+    /** Number of distinct IDs (case variants of one ID count once). */
+    get Size(): number;
+    [Symbol.iterator](): Iterator<string>;
+}
+/**
+ * A `Map` keyed by UUID that matches case- and whitespace-insensitively. Every key is normalized
+ * on insert and on lookup, so a value stored under `'a1b2…'` is found with `Get('A1B2…')`.
+ * Iterates `[normalizedKey, value]` pairs.
+ *
+ * @example
+ * const roleNames = new UUIDMap(roles.map(r => [r.ID, r.Name]));
+ * const name = roleNames.Get(permission.RoleID);
+ */
+export declare class UUIDMap<V> implements Iterable<[string, V]> {
+    private readonly entries;
+    constructor(entries?: Iterable<readonly [UUIDInput, V]>);
+    /** The value stored for the ID, or undefined. */
+    Get(id: UUIDInput): V | undefined;
+    /** Stores a value for the ID, replacing any value stored under a case variant of it. */
+    Set(id: UUIDInput, value: V): this;
+    Has(id: UUIDInput): boolean;
+    Delete(id: UUIDInput): boolean;
+    Clear(): void;
+    get Size(): number;
+    /** Normalized keys. */
+    Keys(): IterableIterator<string>;
+    Values(): IterableIterator<V>;
+    [Symbol.iterator](): Iterator<[string, V]>;
+}
+/**
+ * The items whose ID appears in `ids`, in `items` order. Linear: builds one {@link UUIDSet}
+ * (or reuses the one passed) instead of scanning `ids` once per item.
+ *
+ * @example
+ * const moved = FilterByUUIDs(this.Dashboards, droppedIds);
+ * const pending = FilterByUUIDs(artifacts, loadedIds, a => a.artifactId);
+ */
+export declare function FilterByUUIDs<T extends {
+    ID: UUIDInput;
+}>(items: readonly T[], ids: Iterable<UUIDInput> | UUIDSet): T[];
+export declare function FilterByUUIDs<T>(items: readonly T[], ids: Iterable<UUIDInput> | UUIDSet, getId: UUIDSelector<T>): T[];
+/**
+ * The items whose ID does NOT appear in `ids`, in `items` order. The complement of
+ * {@link FilterByUUIDs}, with the same linear cost.
+ *
+ * @example
+ * const withoutPermission = ExcludeByUUIDs(roles, existingPermissions.map(p => p.RoleID));
+ */
+export declare function ExcludeByUUIDs<T extends {
+    ID: UUIDInput;
+}>(items: readonly T[], ids: Iterable<UUIDInput> | UUIDSet): T[];
+export declare function ExcludeByUUIDs<T>(items: readonly T[], ids: Iterable<UUIDInput> | UUIDSet, getId: UUIDSelector<T>): T[];
+/**
+ * How many items share each ID. Look a count up with `.Get(id) ?? 0`; any casing works.
+ *
+ * @example
+ * const perEntity = CountByUUID(relationships, r => r.RelatedEntityID);
+ * const shared = (perEntity.Get(rel.RelatedEntityID) ?? 0) > 1;
+ */
+export declare function CountByUUID<T extends {
+    ID: UUIDInput;
+}>(items: Iterable<T>): UUIDMap<number>;
+export declare function CountByUUID<T>(items: Iterable<T>, getId: UUIDSelector<T>): UUIDMap<number>;
+/**
+ * The items grouped by ID, each group in `items` order. Look a group up with `.Get(id) ?? []`;
+ * any casing works. Linear, where `items.filter(x => UUIDsEqual(x.ParentID, id))` run once per
+ * `id` scans the whole list every time.
+ *
+ * @example
+ * const rolesByUser = GroupByUUID(userRoles, r => r.UserID);
+ * const roles = rolesByUser.Get(user.ID) ?? [];
+ */
+export declare function GroupByUUID<T extends {
+    ID: UUIDInput;
+}>(items: Iterable<T>): UUIDMap<T[]>;
+export declare function GroupByUUID<T>(items: Iterable<T>, getId: UUIDSelector<T>): UUIDMap<T[]>;
+/**
+ * The items keyed by ID, for repeated lookups. When two items share an ID, the FIRST one wins —
+ * the same answer `items.find(x => UUIDsEqual(x.ID, id))` would give.
+ *
+ * @example
+ * const usersByID = IndexByUUID(this.users);
+ * const owner = usersByID.Get(record.OwnerID);
+ */
+export declare function IndexByUUID<T extends {
+    ID: UUIDInput;
+}>(items: Iterable<T>): UUIDMap<T>;
+export declare function IndexByUUID<T>(items: Iterable<T>, getId: UUIDSelector<T>): UUIDMap<T>;
+//# sourceMappingURL=UUIDCollections.d.ts.map

package/dist/util/UUIDCollections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDCollections.d.ts","sourceRoot":"","sources":["../../src/util/UUIDCollections.ts"],"names":[],"mappings":"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"}

package/dist/util/UUIDCollections.js

@@ -0,0 +1,163 @@
+/**
+ * @fileoverview UUID-keyed collections and set-based helpers for MemberJunction
+ *
+ * `UUIDsEqual` compares two IDs, so code that matches one list of records against another list of
+ * IDs tends to be written as a nested scan — for every item, `.some(id => UUIDsEqual(...))` over the
+ * other list. That is O(n x m), and every mismatched comparison lowercases both strings.
+ *
+ * The collections here normalize on every insert and every lookup (via {@link NormalizeUUID}), so
+ * they can be used exactly like a native `Set` / `Map` without anyone having to remember to
+ * normalize both sides. The helpers cover the five operations those nested scans actually perform:
+ * keep matches, drop matches, count per ID, group per ID, and look up by ID.
+ *
+ * Normalization follows `NormalizeUUID` exactly, including its handling of `null` / `undefined`
+ * (both normalize to `''`).
+ *
+ * @module @memberjunction/global/UUIDCollections
+ */
+import { NormalizeUUID } from './UUIDUtils.js';
+/**
+ * A `Set` of UUIDs that matches case- and whitespace-insensitively. Every ID is normalized on
+ * insert and on lookup, so `Has('A1B2…')` finds an ID added as `'a1b2…'`. Iterates normalized IDs.
+ *
+ * @example
+ * const selected = new UUIDSet(selectedIds);
+ * const picked = rows.filter(r => selected.Has(r.ID));
+ */
+export class UUIDSet {
+    constructor(ids) {
+        this.ids = new Set();
+        if (ids) {
+            for (const id of ids)
+                this.ids.add(NormalizeUUID(id));
+        }
+    }
+    /** Adds an ID. Returns this set, for chaining. */
+    Add(id) {
+        this.ids.add(NormalizeUUID(id));
+        return this;
+    }
+    /** True when the ID is in the set, ignoring case and surrounding whitespace. */
+    Has(id) {
+        return this.ids.has(NormalizeUUID(id));
+    }
+    /** Removes an ID. Returns true when it was present. */
+    Delete(id) {
+        return this.ids.delete(NormalizeUUID(id));
+    }
+    Clear() {
+        this.ids.clear();
+    }
+    /** Number of distinct IDs (case variants of one ID count once). */
+    get Size() {
+        return this.ids.size;
+    }
+    [Symbol.iterator]() {
+        return this.ids.values();
+    }
+}
+/**
+ * A `Map` keyed by UUID that matches case- and whitespace-insensitively. Every key is normalized
+ * on insert and on lookup, so a value stored under `'a1b2…'` is found with `Get('A1B2…')`.
+ * Iterates `[normalizedKey, value]` pairs.
+ *
+ * @example
+ * const roleNames = new UUIDMap(roles.map(r => [r.ID, r.Name]));
+ * const name = roleNames.Get(permission.RoleID);
+ */
+export class UUIDMap {
+    constructor(entries) {
+        this.entries = new Map();
+        if (entries) {
+            for (const [id, value] of entries)
+                this.entries.set(NormalizeUUID(id), value);
+        }
+    }
+    /** The value stored for the ID, or undefined. */
+    Get(id) {
+        return this.entries.get(NormalizeUUID(id));
+    }
+    /** Stores a value for the ID, replacing any value stored under a case variant of it. */
+    Set(id, value) {
+        this.entries.set(NormalizeUUID(id), value);
+        return this;
+    }
+    Has(id) {
+        return this.entries.has(NormalizeUUID(id));
+    }
+    Delete(id) {
+        return this.entries.delete(NormalizeUUID(id));
+    }
+    Clear() {
+        this.entries.clear();
+    }
+    get Size() {
+        return this.entries.size;
+    }
+    /** Normalized keys. */
+    Keys() {
+        return this.entries.keys();
+    }
+    Values() {
+        return this.entries.values();
+    }
+    [Symbol.iterator]() {
+        return this.entries.entries();
+    }
+}
+/**
+ * The default selector: an item's `ID`. The overloads guarantee callers that omit `getId` pass items
+ * with an `ID`; this narrows instead of casting, so anything else reads as "no ID" rather than crashing.
+ */
+function readID(item) {
+    if (typeof item !== 'object' || item === null || !('ID' in item))
+        return undefined;
+    const id = item.ID;
+    return typeof id === 'string' ? id : undefined;
+}
+function asUUIDSet(ids) {
+    return ids instanceof UUIDSet ? ids : new UUIDSet(ids);
+}
+export function FilterByUUIDs(items, ids, getId) {
+    const wanted = asUUIDSet(ids);
+    const idOf = getId ?? readID;
+    return items.filter((item) => wanted.Has(idOf(item)));
+}
+export function ExcludeByUUIDs(items, ids, getId) {
+    const unwanted = asUUIDSet(ids);
+    const idOf = getId ?? readID;
+    return items.filter((item) => !unwanted.Has(idOf(item)));
+}
+export function CountByUUID(items, getId) {
+    const idOf = getId ?? readID;
+    const counts = new UUIDMap();
+    for (const item of items) {
+        const id = idOf(item);
+        counts.Set(id, (counts.Get(id) ?? 0) + 1);
+    }
+    return counts;
+}
+export function GroupByUUID(items, getId) {
+    const idOf = getId ?? readID;
+    const groups = new UUIDMap();
+    for (const item of items) {
+        const id = idOf(item);
+        const group = groups.Get(id);
+        if (group)
+            group.push(item);
+        else
+            groups.Set(id, [item]);
+    }
+    return groups;
+}
+export function IndexByUUID(items, getId) {
+    const idOf = getId ?? readID;
+    const index = new UUIDMap();
+    for (const item of items) {
+        const id = idOf(item);
+        if (!index.Has(id))
+            index.Set(id, item);
+    }
+    return index;
+}
+//# sourceMappingURL=UUIDCollections.js.map

package/dist/util/UUIDCollections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDCollections.js","sourceRoot":"","sources":["../../src/util/UUIDCollections.ts"],"names":[],"mappings":"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"}

package/dist/util/UUIDUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UUIDUtils.d.ts","sourceRoot":"","sources":["../../src/util/UUIDUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAQtG;AASD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpE"}
+{"version":3,"file":"UUIDUtils.d.ts","sourceRoot":"","sources":["../../src/util/UUIDUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAatG;AAsDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpE"}

package/dist/util/UUIDUtils.js

@@ -49,13 +49,68 @@ export function UUIDsEqual(uuid1, uuid2) {
         return true;
     if (uuid1 == null || uuid2 == null)
         return false;
-    // Fast path: identical references / already-equal strings (same value, same platform casing)
-    // are the overwhelmingly common case in tight `.find()`/`.some()` loops. Short-circuit before
-    // allocating two normalized copies via trim().toLowerCase().
+    // Fast path: identical references / already-equal strings (same value, same platform casing).
     if (uuid1 === uuid2)
         return true;
+    // Compare without allocating. `trim().toLowerCase()` on both sides built two new strings per
+    // call, and most calls in a `.filter`/`.some` scan are MISMATCHES, which the `===` path above
+    // never catches. The ASCII compare below settles every UUID-shaped input; anything it cannot
+    // settle exactly (a non-ASCII character) falls back to the original expression, so the
+    // result is identical to `uuid1.trim().toLowerCase() === uuid2.trim().toLowerCase()`.
+    const settled = compareTrimmedAsciiCaseInsensitive(uuid1, uuid2);
+    if (settled !== undefined)
+        return settled;
     return uuid1.trim().toLowerCase() === uuid2.trim().toLowerCase();
 }
+/** Characters `String.prototype.trim` removes: ECMAScript WhiteSpace plus LineTerminator. */
+function isTrimmable(code) {
+    return (code === 0x20 || (code >= 0x09 && code <= 0x0d) || code === 0xa0 || code === 0x1680 ||
+        (code >= 0x2000 && code <= 0x200a) || code === 0x2028 || code === 0x2029 || code === 0x202f ||
+        code === 0x205f || code === 0x3000 || code === 0xfeff);
+}
+function hasNonAscii(value, start, end) {
+    for (let i = start; i < end; i++) {
+        if (value.charCodeAt(i) > 0x7f)
+            return true;
+    }
+    return false;
+}
+/**
+ * Compares the trimmed ranges of `a` and `b`, folding ASCII A-Z to a-z, without allocating.
+ * Returns the answer when ASCII rules decide it, or `undefined` when a non-ASCII character is
+ * involved (Unicode lower-casing can change a string's length or map outside ASCII, so only the
+ * original `toLowerCase()` path can answer those exactly).
+ */
+function compareTrimmedAsciiCaseInsensitive(a, b) {
+    let aStart = 0, aEnd = a.length, bStart = 0, bEnd = b.length;
+    while (aStart < aEnd && isTrimmable(a.charCodeAt(aStart)))
+        aStart++;
+    while (aEnd > aStart && isTrimmable(a.charCodeAt(aEnd - 1)))
+        aEnd--;
+    while (bStart < bEnd && isTrimmable(b.charCodeAt(bStart)))
+        bStart++;
+    while (bEnd > bStart && isTrimmable(b.charCodeAt(bEnd - 1)))
+        bEnd--;
+    const length = aEnd - aStart;
+    if (length !== bEnd - bStart) {
+        return hasNonAscii(a, aStart, aEnd) || hasNonAscii(b, bStart, bEnd) ? undefined : false;
+    }
+    for (let i = 0; i < length; i++) {
+        let x = a.charCodeAt(aStart + i);
+        let y = b.charCodeAt(bStart + i);
+        if (x === y)
+            continue;
+        if (x > 0x7f || y > 0x7f)
+            return undefined;
+        if (x >= 0x41 && x <= 0x5a)
+            x += 0x20;
+        if (y >= 0x41 && y <= 0x5a)
+            y += 0x20;
+        if (x !== y)
+            return false;
+    }
+    return true;
+}
 /**
  * Canonical UUID format (8-4-4-4-12 hex groups). Case-insensitive; the version/variant digits are
  * NOT constrained, so this validates SHAPE rather than RFC version — which is exactly what is needed

package/dist/util/UUIDUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"UUIDUtils.js","sourceRoot":"","sources":["../../src/util/UUIDUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,IAA+B;IACzD,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgC,EAAE,KAAgC;IACzF,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACjD,6FAA6F;IAC7F,8FAA8F;IAC9F,6DAA6D;IAC7D,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,iEAAiE,CAAC;AAEtF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,IAA+B;IACvD,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"UUIDUtils.js","sourceRoot":"","sources":["../../src/util/UUIDUtils.ts"],"names":[],"mappings":"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"}

package/dist/util.d.ts

@@ -348,6 +348,20 @@ export declare function adjustCasing(word: string, options?: {
 export declare function StripTrailingChars(s: string, charsToStrip: string, skipIfExactMatch: boolean): string;
 /** @deprecated Use {@link StripTrailingChars}. */
 export declare function stripTrailingChars(s: string, charsToStrip: string, skipIfExactMatch: boolean): string;
+/**
+ * Removes every trailing `/` from a string, typically a base URL before a path is joined onto it.
+ *
+ * Linear in the length of the input. The regex `/\/+$/` is not: on a string holding many slashes that
+ * are NOT at the end, it backtracks quadratically, which makes it a denial-of-service vector on any
+ * caller-supplied URL.
+ *
+ * @example
+ * ```typescript
+ * TrimTrailingSlashes('http://localhost:4000///'); // 'http://localhost:4000'
+ * TrimTrailingSlashes('/');                        // ''
+ * ```
+ */
+export declare function TrimTrailingSlashes(s: string): string;
 /**
  * Recursively removes all spaces from a given string.
  *
@@ -562,6 +576,31 @@ export declare function IsOnlyTimezoneShift(date1: Date, date2: Date): boolean;
  * call in that case — `"…"?.getTime` is `undefined`, and calling it throws.
  */
 export declare function ToEpochMs(value: Date | string | number | null | undefined): number;
+/**
+ * Compares two values for equality, including cross-representation `Date` comparisons
+ * where one or both values may be `Date` instances, ISO date strings, or numeric epoch
+ * timestamps (e.g., comparing in-memory entity field values before and after database or
+ * JSON wire serialization).
+ *
+ * Returns `true` when:
+ * - `a === b` (strict identity for primitives and references)
+ * - Both `a` and `b` are `Date` instances with identical `.getTime()` epoch milliseconds
+ * - One side is a `Date` and the other is a `string` or `number` that parses to the same
+ *   epoch milliseconds as the `Date`
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns `true` if the values are equal, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * ValuesEqual(42, 42); // true
+ * ValuesEqual(new Date('2026-08-01T00:00:00.000Z'), new Date('2026-08-01T00:00:00.000Z')); // true
+ * ValuesEqual(new Date('2026-08-01T00:00:00.000Z'), '2026-08-01T00:00:00.000Z'); // true
+ * ValuesEqual('a', 'b'); // false
+ * ```
+ */
+export declare function ValuesEqual(a: unknown, b: unknown): boolean;
 /**
  * Locale-independent total order on strings (UTF-16 code units). Use for every sort whose
  * result is EMITTED (generated code, SQL, file names, migration captures). Not for UI display —

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/dist/util.js

@@ -1322,6 +1322,26 @@ export function StripTrailingChars(s, charsToStrip, skipIfExactMatch) {
 export function stripTrailingChars(s, charsToStrip, skipIfExactMatch) {
     return StripTrailingChars(s, charsToStrip, skipIfExactMatch);
 }
+/**
+ * Removes every trailing `/` from a string, typically a base URL before a path is joined onto it.
+ *
+ * Linear in the length of the input. The regex `/\/+$/` is not: on a string holding many slashes that
+ * are NOT at the end, it backtracks quadratically, which makes it a denial-of-service vector on any
+ * caller-supplied URL.
+ *
+ * @example
+ * ```typescript
+ * TrimTrailingSlashes('http://localhost:4000///'); // 'http://localhost:4000'
+ * TrimTrailingSlashes('/');                        // ''
+ * ```
+ */
+export function TrimTrailingSlashes(s) {
+    let end = s.length;
+    while (end > 0 && s.charCodeAt(end - 1) === 47 /* '/' */) {
+        end--;
+    }
+    return end === s.length ? s : s.substring(0, end);
+}
 /**
  * Recursively removes all spaces from a given string.
  *
@@ -1831,6 +1851,44 @@ export function ToEpochMs(value) {
     const ms = value instanceof Date ? value.getTime() : new Date(value).getTime();
     return Number.isNaN(ms) ? 0 : ms;
 }
+/**
+ * Compares two values for equality, including cross-representation `Date` comparisons
+ * where one or both values may be `Date` instances, ISO date strings, or numeric epoch
+ * timestamps (e.g., comparing in-memory entity field values before and after database or
+ * JSON wire serialization).
+ *
+ * Returns `true` when:
+ * - `a === b` (strict identity for primitives and references)
+ * - Both `a` and `b` are `Date` instances with identical `.getTime()` epoch milliseconds
+ * - One side is a `Date` and the other is a `string` or `number` that parses to the same
+ *   epoch milliseconds as the `Date`
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns `true` if the values are equal, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * ValuesEqual(42, 42); // true
+ * ValuesEqual(new Date('2026-08-01T00:00:00.000Z'), new Date('2026-08-01T00:00:00.000Z')); // true
+ * ValuesEqual(new Date('2026-08-01T00:00:00.000Z'), '2026-08-01T00:00:00.000Z'); // true
+ * ValuesEqual('a', 'b'); // false
+ * ```
+ */
+export function ValuesEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a instanceof Date && b instanceof Date) {
+        return a.getTime() === b.getTime();
+    }
+    if (a instanceof Date && (typeof b === 'string' || typeof b === 'number')) {
+        return a.getTime() === new Date(b).getTime();
+    }
+    if (b instanceof Date && (typeof a === 'string' || typeof a === 'number')) {
+        return new Date(a).getTime() === b.getTime();
+    }
+    return false;
+}
 /**
  * Locale-independent total order on strings (UTF-16 code units). Use for every sort whose
  * result is EMITTED (generated code, SQL, file names, migration captures). Not for UI display —