hadron-type-checker 7.4.27 → 7.5.0

package/dist/index.d.ts

@@ -1,3 +1,2 @@
-export { default } from './type-checker';
-export type { TypeCastMap, TypeCastTypes } from './type-checker';
+export { default, UUID_REGEX, uuidHexToString, reverseJavaUUIDBytes, reverseCSharpUUIDBytes, convertBinaryUUID, type BSONTypeTag, getBsonType, type TypeCastMap, type TypeCastTypes, } from './type-checker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,WAAW,EAChB,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -3,7 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = void 0;
+exports.getBsonType = exports.convertBinaryUUID = exports.reverseCSharpUUIDBytes = exports.reverseJavaUUIDBytes = exports.uuidHexToString = exports.UUID_REGEX = exports.default = void 0;
 var type_checker_1 = require("./type-checker");
 Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(type_checker_1).default; } });
+Object.defineProperty(exports, "UUID_REGEX", { enumerable: true, get: function () { return type_checker_1.UUID_REGEX; } });
+Object.defineProperty(exports, "uuidHexToString", { enumerable: true, get: function () { return type_checker_1.uuidHexToString; } });
+Object.defineProperty(exports, "reverseJavaUUIDBytes", { enumerable: true, get: function () { return type_checker_1.reverseJavaUUIDBytes; } });
+Object.defineProperty(exports, "reverseCSharpUUIDBytes", { enumerable: true, get: function () { return type_checker_1.reverseCSharpUUIDBytes; } });
+Object.defineProperty(exports, "convertBinaryUUID", { enumerable: true, get: function () { return type_checker_1.convertBinaryUUID; } });
+Object.defineProperty(exports, "getBsonType", { enumerable: true, get: function () { return type_checker_1.getBsonType; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,+CAAyC;AAAhC,wHAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,+CAWwB;AAVtB,wHAAA,OAAO,OAAA;AACP,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA;AACf,oHAAA,oBAAoB,OAAA;AACpB,sHAAA,sBAAsB,OAAA;AACtB,iHAAA,iBAAiB,OAAA;AAEjB,2GAAA,WAAW,OAAA"}

package/dist/type-checker.d.ts

@@ -1,4 +1,6 @@
-import { ObjectId, MinKey, MaxKey, Long, Double, Int32, Decimal128, Binary, BSONRegExp, Code, BSONSymbol, Timestamp } from 'bson';
+import { ObjectId, MinKey, MaxKey, Long, Double, Int32, Decimal128, Binary, BSONRegExp, Code, BSONSymbol, Timestamp, bsonType, type BSONTypeTag } from 'bson';
+export { bsonType, type BSONTypeTag };
+export declare function getBsonType(value: any): BSONTypeTag | undefined;
 export type TypeCastMap = {
     Array: unknown[];
     Binary: Binary;
@@ -19,8 +21,50 @@ export type TypeCastMap = {
     BSONSymbol: BSONSymbol;
     Timestamp: Timestamp;
     Undefined: undefined;
+    UUID: Binary;
+    LegacyJavaUUID: Binary;
+    LegacyCSharpUUID: Binary;
+    LegacyPythonUUID: Binary;
 };
 export type TypeCastTypes = keyof TypeCastMap;
+/**
+ * UUID regex pattern for validation (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
+ */
+export declare const UUID_REGEX: RegExp;
+/**
+ * Converts a hex string (without hyphens) to UUID format with hyphens.
+ */
+export declare const uuidHexToString: (hex: string) => string;
+/**
+ * Reverses byte order for Java legacy UUID format (both MSB and LSB).
+ * Takes a 32-char hex string and returns a 32-char hex string with reversed byte order.
+ *
+ * This function is an involution (self-inverse), meaning applying it twice returns
+ * the original value. It can be used both to:
+ * - Convert from Java legacy binary format to standard UUID hex (for display)
+ * - Convert from standard UUID hex to Java legacy binary format (for storage)
+ */
+export declare const reverseJavaUUIDBytes: (hex: string) => string;
+/**
+ * Reverses byte order for C# legacy UUID format (first 3 groups only).
+ * Takes a 32-char hex string and returns a 32-char hex string with reversed byte order.
+ *
+ * This function is an involution (self-inverse), meaning applying it twice returns
+ * the original value. It can be used both to:
+ * - Convert from C# legacy binary format to standard UUID hex (for display)
+ * - Convert from standard UUID hex to C# legacy binary format (for storage)
+ */
+export declare const reverseCSharpUUIDBytes: (hex: string) => string;
+/**
+ * Converts a Binary UUID from one encoding to another.
+ * This is used when changing between UUID types in the document editor.
+ *
+ * @param binary - The source Binary UUID
+ * @param sourceType - The source UUID type (e.g., 'LegacyCSharpUUID')
+ * @param targetType - The target UUID type (e.g., 'LegacyJavaUUID')
+ * @returns A new Binary with the same UUID value but different encoding
+ */
+export declare const convertBinaryUUID: (binary: Binary, sourceType: string, targetType: string) => Binary;
 /**
  * Checks the types of objects and returns them as readable strings.
  */
@@ -31,8 +75,11 @@ declare class TypeChecker {
     cast<O = unknown, T extends string = string>(object: O, type: T): T extends TypeCastTypes ? TypeCastMap[T] : O;
     /**
      * Get the type for the object.
+     * @param legacyUUIDEncoding - Optional encoding for legacy UUID (subtype 3).
+     *   If provided and the object is a Binary with subtype 3, returns the specific legacy UUID type.
+     *   Valid values: 'LegacyJavaUUID', 'LegacyCSharpUUID', 'LegacyPythonUUID'
      */
-    type(object: unknown): TypeCastTypes;
+    type(object: unknown, legacyUUIDEncoding?: 'LegacyJavaUUID' | 'LegacyCSharpUUID' | 'LegacyPythonUUID'): TypeCastTypes;
     /**
      * Get a list of types the object can be cast to.
      */

package/dist/type-checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-checker.d.ts","sourceRoot":"","sources":["../src/type-checker.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,EACL,UAAU,EACV,MAAM,EACN,UAAU,EACV,IAAI,EACJ,UAAU,EACV,SAAS,EACV,MAAM,MAAM,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC;AAyS9C;;GAEG;AACH,cAAM,WAAW;IACf;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACzC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,GACN,CAAC,SAAS,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAW/C;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa;IA4BpC;;OAEG;IACH,aAAa,CAAC,oBAAoB,UAAQ,GAAG,aAAa,EAAE;CAM7D;;AAED,wBAAiC"}
+{"version":3,"file":"type-checker.d.ts","sourceRoot":"","sources":["../src/type-checker.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,IAAI,EACJ,MAAM,EACN,KAAK,EACL,UAAU,EACV,MAAM,EACN,UAAU,EACV,IAAI,EACJ,UAAU,EACV,SAAS,EAET,QAAQ,EACR,KAAK,WAAW,EACjB,MAAM,MAAM,CAAC;AAEd,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,CAAC;AACtC,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,WAAW,GAAG,SAAS,CAE/D;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC;AAsM9C;;GAEG;AACH,eAAO,MAAM,UAAU,QAC4C,CAAC;AAoBpE;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAY7C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAsBlD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,MAUpD,CAAC;AA0EF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,YAAY,MAAM,EAClB,YAAY,MAAM,KACjB,MA4BF,CAAC;AAoKF;;GAEG;AACH,cAAM,WAAW;IACf;;OAEG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACzC,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,CAAC,GACN,CAAC,SAAS,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC;IAW/C;;;;;OAKG;IACH,IAAI,CACF,MAAM,EAAE,OAAO,EACf,kBAAkB,CAAC,EACf,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GACrB,aAAa;IAoChB;;OAEG;IACH,aAAa,CAAC,oBAAoB,UAAQ,GAAG,aAAa,EAAE;CAM7D;;AAED,wBAAiC"}

package/dist/type-checker.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertBinaryUUID = exports.reverseCSharpUUIDBytes = exports.reverseJavaUUIDBytes = exports.uuidHexToString = exports.UUID_REGEX = exports.bsonType = void 0;
+exports.getBsonType = getBsonType;
 const lodash_1 = require("lodash");
 const bson_1 = require("bson");
+Object.defineProperty(exports, "bsonType", { enumerable: true, get: function () { return bson_1.bsonType; } });
+function getBsonType(value) {
+    return value?.[bson_1.bsonType];
+}
 /**
  * The object string.
  */
@@ -28,12 +34,6 @@ const DOUBLE = 'Double';
 const DECIMAL_128 = 'Decimal128';
 const OBJECT_TYPE = '[object Object]';
 const EMPTY = '';
-const OBJECT_ID = 'ObjectID';
-const SYMBOL = 'Symbol';
-/**
- * The bson type field.
- */
-const BSON_TYPE = '_bsontype';
 /**
  * The match regex.
  */
@@ -148,11 +148,10 @@ const toDecimal128 = (object) => {
     /*
      If converting a BSON Object, extract the value before converting to a string.
      */
-    if ((0, lodash_1.hasIn)(object, BSON_TYPE) &&
-        NUMBER_TYPES.includes(object._bsontype)) {
+    if (NUMBER_TYPES.includes(getBsonType(object))) {
         const bsonObj = object;
         object =
-            bsonObj._bsontype === LONG ? bsonObj.toString() : bsonObj.valueOf();
+            getBsonType(object) === LONG ? bsonObj.toString() : bsonObj.valueOf();
     }
     return bson_1.Decimal128.fromString((0, lodash_1.toString)(object));
 };
@@ -168,6 +167,244 @@ const toBinary = (object) => {
         : Buffer.from((0, lodash_1.toString)(object), 'utf8');
     return new bson_1.Binary(buffer, bson_1.Binary.SUBTYPE_DEFAULT);
 };
+/**
+ * UUID regex pattern for validation (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
+ */
+exports.UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Validates a UUID string format.
+ */
+const validateUUIDString = (uuidString) => {
+    if (!exports.UUID_REGEX.test(uuidString)) {
+        throw new Error(`'${uuidString}' is not a valid UUID string (expected format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)`);
+    }
+};
+/**
+ * Converts a UUID string (with hyphens) to a hex string (without hyphens).
+ */
+const uuidStringToHex = (uuidString) => {
+    return uuidString.replace(/-/g, '');
+};
+/**
+ * Converts a hex string (without hyphens) to UUID format with hyphens.
+ */
+const uuidHexToString = (hex) => {
+    return (hex.substring(0, 8) +
+        '-' +
+        hex.substring(8, 12) +
+        '-' +
+        hex.substring(12, 16) +
+        '-' +
+        hex.substring(16, 20) +
+        '-' +
+        hex.substring(20, 32));
+};
+exports.uuidHexToString = uuidHexToString;
+/**
+ * Reverses byte order for Java legacy UUID format (both MSB and LSB).
+ * Takes a 32-char hex string and returns a 32-char hex string with reversed byte order.
+ *
+ * This function is an involution (self-inverse), meaning applying it twice returns
+ * the original value. It can be used both to:
+ * - Convert from Java legacy binary format to standard UUID hex (for display)
+ * - Convert from standard UUID hex to Java legacy binary format (for storage)
+ */
+const reverseJavaUUIDBytes = (hex) => {
+    let msb = hex.substring(0, 16);
+    let lsb = hex.substring(16, 32);
+    msb =
+        msb.substring(14, 16) +
+            msb.substring(12, 14) +
+            msb.substring(10, 12) +
+            msb.substring(8, 10) +
+            msb.substring(6, 8) +
+            msb.substring(4, 6) +
+            msb.substring(2, 4) +
+            msb.substring(0, 2);
+    lsb =
+        lsb.substring(14, 16) +
+            lsb.substring(12, 14) +
+            lsb.substring(10, 12) +
+            lsb.substring(8, 10) +
+            lsb.substring(6, 8) +
+            lsb.substring(4, 6) +
+            lsb.substring(2, 4) +
+            lsb.substring(0, 2);
+    return msb + lsb;
+};
+exports.reverseJavaUUIDBytes = reverseJavaUUIDBytes;
+/**
+ * Reverses byte order for C# legacy UUID format (first 3 groups only).
+ * Takes a 32-char hex string and returns a 32-char hex string with reversed byte order.
+ *
+ * This function is an involution (self-inverse), meaning applying it twice returns
+ * the original value. It can be used both to:
+ * - Convert from C# legacy binary format to standard UUID hex (for display)
+ * - Convert from standard UUID hex to C# legacy binary format (for storage)
+ */
+const reverseCSharpUUIDBytes = (hex) => {
+    const a = hex.substring(6, 8) +
+        hex.substring(4, 6) +
+        hex.substring(2, 4) +
+        hex.substring(0, 2);
+    const b = hex.substring(10, 12) + hex.substring(8, 10);
+    const c = hex.substring(14, 16) + hex.substring(12, 14);
+    const d = hex.substring(16, 32);
+    return a + b + c + d;
+};
+exports.reverseCSharpUUIDBytes = reverseCSharpUUIDBytes;
+/**
+ * Generates a random UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ */
+const generateRandomUUID = () => {
+    return new bson_1.UUID().toString();
+};
+/**
+ * Converts a Binary UUID to a standard UUID string, accounting for its encoding.
+ * For subtype 4 (standard UUID), returns the hex directly as UUID format.
+ * For subtype 3 (legacy UUID), we need to know the original encoding to reverse the bytes.
+ * If sourceEncoding is not provided, assumes Python encoding (no reversal).
+ */
+const binaryToUUIDStringWithEncoding = (binary, sourceEncoding) => {
+    const hex = binary.toString('hex');
+    // For standard UUID (subtype 4), no byte reversal needed
+    if (binary.sub_type === bson_1.Binary.SUBTYPE_UUID) {
+        return (0, exports.uuidHexToString)(hex);
+    }
+    // For legacy UUID (subtype 3), reverse bytes based on source encoding
+    switch (sourceEncoding) {
+        case 'Java':
+            // Reverse Java encoding to get standard UUID
+            return (0, exports.uuidHexToString)((0, exports.reverseJavaUUIDBytes)(hex));
+        case 'CSharp':
+            // Reverse C# encoding to get standard UUID
+            return (0, exports.uuidHexToString)((0, exports.reverseCSharpUUIDBytes)(hex));
+        case 'Python':
+        default:
+            // Python uses standard byte order, no reversal needed
+            return (0, exports.uuidHexToString)(hex);
+    }
+};
+/**
+ * Gets the UUID string from an object, handling Binary inputs specially.
+ * For Binary inputs, extracts and converts to UUID string format.
+ * For string inputs, returns as-is after trimming.
+ */
+const getUUIDStringFromObject = (object, sourceEncoding) => {
+    if (object instanceof bson_1.Binary) {
+        if (object.sub_type === bson_1.Binary.SUBTYPE_UUID ||
+            object.sub_type === bson_1.Binary.SUBTYPE_UUID_OLD) {
+            return binaryToUUIDStringWithEncoding(object, sourceEncoding);
+        }
+    }
+    return (0, lodash_1.toString)(object).trim();
+};
+/**
+ * Mapping from UUID type names to encoding names.
+ */
+const UUID_TYPE_TO_ENCODING = Object.assign(Object.create(null), {
+    UUID: undefined,
+    LegacyJavaUUID: 'Java',
+    LegacyCSharpUUID: 'CSharp',
+    LegacyPythonUUID: 'Python',
+});
+/**
+ * Converts a Binary UUID from one encoding to another.
+ * This is used when changing between UUID types in the document editor.
+ *
+ * @param binary - The source Binary UUID
+ * @param sourceType - The source UUID type (e.g., 'LegacyCSharpUUID')
+ * @param targetType - The target UUID type (e.g., 'LegacyJavaUUID')
+ * @returns A new Binary with the same UUID value but different encoding
+ */
+const convertBinaryUUID = (binary, sourceType, targetType) => {
+    // Get the source encoding to decode the binary
+    const sourceEncoding = UUID_TYPE_TO_ENCODING[sourceType];
+    // Convert binary to standard UUID string using source encoding
+    const uuidString = binaryToUUIDStringWithEncoding(binary, sourceEncoding);
+    // Convert UUID string to binary using target encoding
+    const hex = uuidStringToHex(uuidString);
+    switch (targetType) {
+        case 'UUID':
+            return bson_1.Binary.createFromHexString(hex, bson_1.Binary.SUBTYPE_UUID);
+        case 'LegacyJavaUUID':
+            return bson_1.Binary.createFromHexString((0, exports.reverseJavaUUIDBytes)(hex), bson_1.Binary.SUBTYPE_UUID_OLD);
+        case 'LegacyCSharpUUID':
+            return bson_1.Binary.createFromHexString((0, exports.reverseCSharpUUIDBytes)(hex), bson_1.Binary.SUBTYPE_UUID_OLD);
+        case 'LegacyPythonUUID':
+            return bson_1.Binary.createFromHexString(hex, bson_1.Binary.SUBTYPE_UUID_OLD);
+        default:
+            throw new Error(`Unknown UUID type: ${targetType}`);
+    }
+};
+exports.convertBinaryUUID = convertBinaryUUID;
+/**
+ * Converts to UUID (Binary subtype 4).
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toUUID = (object) => {
+    const uuidString = getUUIDStringFromObject(object);
+    if (!uuidString) {
+        return new bson_1.UUID().toBinary();
+    }
+    validateUUIDString(uuidString);
+    const hex = uuidStringToHex(uuidString);
+    return bson_1.Binary.createFromHexString(hex, bson_1.Binary.SUBTYPE_UUID);
+};
+/**
+ * Converts to Legacy Java UUID (Binary subtype 3).
+ * Java legacy format reverses byte order for both MSB and LSB.
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toLegacyJavaUUID = (object) => {
+    let uuidString = getUUIDStringFromObject(object, 'Java');
+    if (!uuidString) {
+        uuidString = generateRandomUUID();
+    }
+    else {
+        validateUUIDString(uuidString);
+    }
+    const hex = uuidStringToHex(uuidString);
+    const reversedHex = (0, exports.reverseJavaUUIDBytes)(hex);
+    return bson_1.Binary.createFromHexString(reversedHex, bson_1.Binary.SUBTYPE_UUID_OLD);
+};
+/**
+ * Converts to Legacy C# UUID (Binary subtype 3).
+ * C# legacy format reverses byte order for first 3 groups only.
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toLegacyCSharpUUID = (object) => {
+    let uuidString = getUUIDStringFromObject(object, 'CSharp');
+    if (!uuidString) {
+        uuidString = generateRandomUUID();
+    }
+    else {
+        validateUUIDString(uuidString);
+    }
+    const hex = uuidStringToHex(uuidString);
+    const reversedHex = (0, exports.reverseCSharpUUIDBytes)(hex);
+    return bson_1.Binary.createFromHexString(reversedHex, bson_1.Binary.SUBTYPE_UUID_OLD);
+};
+/**
+ * Converts to Legacy Python UUID (Binary subtype 3).
+ * Python legacy format uses direct byte order (no reversal).
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toLegacyPythonUUID = (object) => {
+    let uuidString = getUUIDStringFromObject(object, 'Python');
+    if (!uuidString) {
+        uuidString = generateRandomUUID();
+    }
+    else {
+        validateUUIDString(uuidString);
+    }
+    const hex = uuidStringToHex(uuidString);
+    return bson_1.Binary.createFromHexString(hex, bson_1.Binary.SUBTYPE_UUID_OLD);
+};
 const toRegex = (object) => {
     return new bson_1.BSONRegExp((0, lodash_1.toString)(object));
 };
@@ -204,6 +441,10 @@ const CASTERS = {
     BSONSymbol: toSymbol,
     Timestamp: toTimestamp,
     Undefined: toUndefined,
+    UUID: toUUID,
+    LegacyJavaUUID: toLegacyJavaUUID,
+    LegacyCSharpUUID: toLegacyCSharpUUID,
+    LegacyPythonUUID: toLegacyPythonUUID,
 };
 /**
  * An array of all bson types.
@@ -264,20 +505,29 @@ class TypeChecker {
     }
     /**
      * Get the type for the object.
+     * @param legacyUUIDEncoding - Optional encoding for legacy UUID (subtype 3).
+     *   If provided and the object is a Binary with subtype 3, returns the specific legacy UUID type.
+     *   Valid values: 'LegacyJavaUUID', 'LegacyCSharpUUID', 'LegacyPythonUUID'
      */
-    type(object) {
-        if ((0, lodash_1.hasIn)(object, BSON_TYPE)) {
-            const bsonObj = object;
-            if (bsonObj._bsontype === LONG) {
+    type(object, legacyUUIDEncoding) {
+        const bsonType = getBsonType(object);
+        if (bsonType) {
+            if (bsonType === LONG) {
                 return INT_64;
             }
-            if (bsonObj._bsontype === OBJECT_ID) {
-                return 'ObjectId';
-            }
-            if (bsonObj._bsontype === SYMBOL) {
-                return 'BSONSymbol';
+            // Handle Binary UUID subtypes
+            if (bsonType === 'Binary') {
+                const binary = object;
+                if (binary.sub_type === bson_1.Binary.SUBTYPE_UUID) {
+                    return 'UUID';
+                }
+                if (binary.sub_type === bson_1.Binary.SUBTYPE_UUID_OLD &&
+                    binary.buffer.length === 16 &&
+                    legacyUUIDEncoding) {
+                    return legacyUUIDEncoding;
+                }
             }
-            return bsonObj._bsontype;
+            return bsonType;
         }
         if ((0, lodash_1.isNumber)(object)) {
             return numberToBsonType(object);

package/dist/type-checker.js.map

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

package/package.json

@@ -10,7 +10,7 @@
     "email": "compass@mongodb.com"
   },
   "homepage": "https://github.com/mongodb-js/compass",
-  "version": "7.4.27",
+  "version": "7.5.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/mongodb-js/compass.git"
@@ -46,14 +46,14 @@
     "reformat": "npm run eslint . -- --fix && npm run prettier -- --write ."
   },
   "dependencies": {
-    "bson": "^6.10.4",
+    "bson": "^7.2.0",
     "lodash": "^4.17.21"
   },
   "devDependencies": {
-    "@mongodb-js/eslint-config-compass": "^1.4.16",
+    "@mongodb-js/eslint-config-compass": "^1.4.17",
     "@mongodb-js/mocha-config-compass": "^1.7.5",
     "@mongodb-js/prettier-config-compass": "^1.2.9",
-    "@mongodb-js/tsconfig-compass": "^1.2.13",
+    "@mongodb-js/tsconfig-compass": "^1.2.14",
     "@types/chai": "^4.2.21",
     "@types/mocha": "^9.0.0",
     "chai": "^4.2.0",
@@ -62,5 +62,5 @@
     "nyc": "^15.1.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "2211ea4f5fa2c86601f60070e41f8705ee24ae54"
+  "gitHead": "3473b2aeed26412f25423caf7f1f7ca848665e34"
 }

package/src/index.ts

@@ -1,2 +1,12 @@
-export { default } from './type-checker';
-export type { TypeCastMap, TypeCastTypes } from './type-checker';
+export {
+  default,
+  UUID_REGEX,
+  uuidHexToString,
+  reverseJavaUUIDBytes,
+  reverseCSharpUUIDBytes,
+  convertBinaryUUID,
+  type BSONTypeTag,
+  getBsonType,
+  type TypeCastMap,
+  type TypeCastTypes,
+} from './type-checker';

package/src/type-checker.ts

@@ -3,7 +3,6 @@ import {
   isArray,
   isString,
   isNumber,
-  hasIn,
   keys,
   without,
   toNumber,
@@ -23,8 +22,16 @@ import {
   Code,
   BSONSymbol,
   Timestamp,
+  UUID,
+  bsonType,
+  type BSONTypeTag,
 } from 'bson';
 
+export { bsonType, type BSONTypeTag };
+export function getBsonType(value: any): BSONTypeTag | undefined {
+  return value?.[bsonType];
+}
+
 export type TypeCastMap = {
   Array: unknown[];
   Binary: Binary;
@@ -45,6 +52,10 @@ export type TypeCastMap = {
   BSONSymbol: BSONSymbol;
   Timestamp: Timestamp;
   Undefined: undefined;
+  UUID: Binary;
+  LegacyJavaUUID: Binary;
+  LegacyCSharpUUID: Binary;
+  LegacyPythonUUID: Binary;
 };
 
 export type TypeCastTypes = keyof TypeCastMap;
@@ -79,13 +90,6 @@ const DOUBLE = 'Double';
 const DECIMAL_128 = 'Decimal128';
 const OBJECT_TYPE = '[object Object]';
 const EMPTY = '';
-const OBJECT_ID = 'ObjectID';
-const SYMBOL = 'Symbol';
-
-/**
- * The bson type field.
- */
-const BSON_TYPE = '_bsontype';
 
 /**
  * The match regex.
@@ -218,7 +222,6 @@ const toDouble = (object: unknown): Double => {
 };
 
 type BSONObject = {
-  _bsontype: string;
   toString(): string;
   valueOf(): number | string;
 };
@@ -228,14 +231,13 @@ const toDecimal128 = (object: unknown): Decimal128 => {
    If converting a BSON Object, extract the value before converting to a string.
    */
   if (
-    hasIn(object, BSON_TYPE) &&
-    NUMBER_TYPES.includes(
-      (object as BSONObject)._bsontype as (typeof NUMBER_TYPES)[number]
+    (NUMBER_TYPES as readonly (BSONTypeTag | undefined)[]).includes(
+      getBsonType(object)
     )
   ) {
     const bsonObj = object as BSONObject;
     object =
-      bsonObj._bsontype === LONG ? bsonObj.toString() : bsonObj.valueOf();
+      getBsonType(object) === LONG ? bsonObj.toString() : bsonObj.valueOf();
   }
   return Decimal128.fromString(toString(object));
 };
@@ -254,6 +256,284 @@ const toBinary = (object: unknown): Binary => {
   return new Binary(buffer, Binary.SUBTYPE_DEFAULT);
 };
 
+/**
+ * UUID regex pattern for validation (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
+ */
+export const UUID_REGEX =
+  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+/**
+ * Validates a UUID string format.
+ */
+const validateUUIDString = (uuidString: string): void => {
+  if (!UUID_REGEX.test(uuidString)) {
+    throw new Error(
+      `'${uuidString}' is not a valid UUID string (expected format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)`
+    );
+  }
+};
+
+/**
+ * Converts a UUID string (with hyphens) to a hex string (without hyphens).
+ */
+const uuidStringToHex = (uuidString: string): string => {
+  return uuidString.replace(/-/g, '');
+};
+
+/**
+ * Converts a hex string (without hyphens) to UUID format with hyphens.
+ */
+export const uuidHexToString = (hex: string): string => {
+  return (
+    hex.substring(0, 8) +
+    '-' +
+    hex.substring(8, 12) +
+    '-' +
+    hex.substring(12, 16) +
+    '-' +
+    hex.substring(16, 20) +
+    '-' +
+    hex.substring(20, 32)
+  );
+};
+
+/**
+ * Reverses byte order for Java legacy UUID format (both MSB and LSB).
+ * Takes a 32-char hex string and returns a 32-char hex string with reversed byte order.
+ *
+ * This function is an involution (self-inverse), meaning applying it twice returns
+ * the original value. It can be used both to:
+ * - Convert from Java legacy binary format to standard UUID hex (for display)
+ * - Convert from standard UUID hex to Java legacy binary format (for storage)
+ */
+export const reverseJavaUUIDBytes = (hex: string): string => {
+  let msb = hex.substring(0, 16);
+  let lsb = hex.substring(16, 32);
+  msb =
+    msb.substring(14, 16) +
+    msb.substring(12, 14) +
+    msb.substring(10, 12) +
+    msb.substring(8, 10) +
+    msb.substring(6, 8) +
+    msb.substring(4, 6) +
+    msb.substring(2, 4) +
+    msb.substring(0, 2);
+  lsb =
+    lsb.substring(14, 16) +
+    lsb.substring(12, 14) +
+    lsb.substring(10, 12) +
+    lsb.substring(8, 10) +
+    lsb.substring(6, 8) +
+    lsb.substring(4, 6) +
+    lsb.substring(2, 4) +
+    lsb.substring(0, 2);
+  return msb + lsb;
+};
+
+/**
+ * Reverses byte order for C# legacy UUID format (first 3 groups only).
+ * Takes a 32-char hex string and returns a 32-char hex string with reversed byte order.
+ *
+ * This function is an involution (self-inverse), meaning applying it twice returns
+ * the original value. It can be used both to:
+ * - Convert from C# legacy binary format to standard UUID hex (for display)
+ * - Convert from standard UUID hex to C# legacy binary format (for storage)
+ */
+export const reverseCSharpUUIDBytes = (hex: string): string => {
+  const a =
+    hex.substring(6, 8) +
+    hex.substring(4, 6) +
+    hex.substring(2, 4) +
+    hex.substring(0, 2);
+  const b = hex.substring(10, 12) + hex.substring(8, 10);
+  const c = hex.substring(14, 16) + hex.substring(12, 14);
+  const d = hex.substring(16, 32);
+  return a + b + c + d;
+};
+
+/**
+ * Generates a random UUID string in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
+ */
+const generateRandomUUID = (): string => {
+  return new UUID().toString();
+};
+
+/**
+ * Converts a Binary UUID to a standard UUID string, accounting for its encoding.
+ * For subtype 4 (standard UUID), returns the hex directly as UUID format.
+ * For subtype 3 (legacy UUID), we need to know the original encoding to reverse the bytes.
+ * If sourceEncoding is not provided, assumes Python encoding (no reversal).
+ */
+const binaryToUUIDStringWithEncoding = (
+  binary: Binary,
+  sourceEncoding?: 'Java' | 'CSharp' | 'Python'
+): string => {
+  const hex = binary.toString('hex');
+
+  // For standard UUID (subtype 4), no byte reversal needed
+  if (binary.sub_type === Binary.SUBTYPE_UUID) {
+    return uuidHexToString(hex);
+  }
+
+  // For legacy UUID (subtype 3), reverse bytes based on source encoding
+  switch (sourceEncoding) {
+    case 'Java':
+      // Reverse Java encoding to get standard UUID
+      return uuidHexToString(reverseJavaUUIDBytes(hex));
+    case 'CSharp':
+      // Reverse C# encoding to get standard UUID
+      return uuidHexToString(reverseCSharpUUIDBytes(hex));
+    case 'Python':
+    default:
+      // Python uses standard byte order, no reversal needed
+      return uuidHexToString(hex);
+  }
+};
+
+/**
+ * Gets the UUID string from an object, handling Binary inputs specially.
+ * For Binary inputs, extracts and converts to UUID string format.
+ * For string inputs, returns as-is after trimming.
+ */
+const getUUIDStringFromObject = (
+  object: unknown,
+  sourceEncoding?: 'Java' | 'CSharp' | 'Python'
+): string => {
+  if (object instanceof Binary) {
+    if (
+      object.sub_type === Binary.SUBTYPE_UUID ||
+      object.sub_type === Binary.SUBTYPE_UUID_OLD
+    ) {
+      return binaryToUUIDStringWithEncoding(object, sourceEncoding);
+    }
+  }
+  return toString(object).trim();
+};
+
+/**
+ * Mapping from UUID type names to encoding names.
+ */
+const UUID_TYPE_TO_ENCODING: Record<
+  string,
+  'Java' | 'CSharp' | 'Python' | undefined
+> = Object.assign(Object.create(null), {
+  UUID: undefined,
+  LegacyJavaUUID: 'Java',
+  LegacyCSharpUUID: 'CSharp',
+  LegacyPythonUUID: 'Python',
+});
+
+/**
+ * Converts a Binary UUID from one encoding to another.
+ * This is used when changing between UUID types in the document editor.
+ *
+ * @param binary - The source Binary UUID
+ * @param sourceType - The source UUID type (e.g., 'LegacyCSharpUUID')
+ * @param targetType - The target UUID type (e.g., 'LegacyJavaUUID')
+ * @returns A new Binary with the same UUID value but different encoding
+ */
+export const convertBinaryUUID = (
+  binary: Binary,
+  sourceType: string,
+  targetType: string
+): Binary => {
+  // Get the source encoding to decode the binary
+  const sourceEncoding = UUID_TYPE_TO_ENCODING[sourceType];
+
+  // Convert binary to standard UUID string using source encoding
+  const uuidString = binaryToUUIDStringWithEncoding(binary, sourceEncoding);
+
+  // Convert UUID string to binary using target encoding
+  const hex = uuidStringToHex(uuidString);
+
+  switch (targetType) {
+    case 'UUID':
+      return Binary.createFromHexString(hex, Binary.SUBTYPE_UUID);
+    case 'LegacyJavaUUID':
+      return Binary.createFromHexString(
+        reverseJavaUUIDBytes(hex),
+        Binary.SUBTYPE_UUID_OLD
+      );
+    case 'LegacyCSharpUUID':
+      return Binary.createFromHexString(
+        reverseCSharpUUIDBytes(hex),
+        Binary.SUBTYPE_UUID_OLD
+      );
+    case 'LegacyPythonUUID':
+      return Binary.createFromHexString(hex, Binary.SUBTYPE_UUID_OLD);
+    default:
+      throw new Error(`Unknown UUID type: ${targetType}`);
+  }
+};
+
+/**
+ * Converts to UUID (Binary subtype 4).
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toUUID = (object: unknown): Binary => {
+  const uuidString = getUUIDStringFromObject(object);
+  if (!uuidString) {
+    return new UUID().toBinary();
+  }
+  validateUUIDString(uuidString);
+  const hex = uuidStringToHex(uuidString);
+  return Binary.createFromHexString(hex, Binary.SUBTYPE_UUID);
+};
+
+/**
+ * Converts to Legacy Java UUID (Binary subtype 3).
+ * Java legacy format reverses byte order for both MSB and LSB.
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toLegacyJavaUUID = (object: unknown): Binary => {
+  let uuidString = getUUIDStringFromObject(object, 'Java');
+  if (!uuidString) {
+    uuidString = generateRandomUUID();
+  } else {
+    validateUUIDString(uuidString);
+  }
+  const hex = uuidStringToHex(uuidString);
+  const reversedHex = reverseJavaUUIDBytes(hex);
+  return Binary.createFromHexString(reversedHex, Binary.SUBTYPE_UUID_OLD);
+};
+
+/**
+ * Converts to Legacy C# UUID (Binary subtype 3).
+ * C# legacy format reverses byte order for first 3 groups only.
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toLegacyCSharpUUID = (object: unknown): Binary => {
+  let uuidString = getUUIDStringFromObject(object, 'CSharp');
+  if (!uuidString) {
+    uuidString = generateRandomUUID();
+  } else {
+    validateUUIDString(uuidString);
+  }
+  const hex = uuidStringToHex(uuidString);
+  const reversedHex = reverseCSharpUUIDBytes(hex);
+  return Binary.createFromHexString(reversedHex, Binary.SUBTYPE_UUID_OLD);
+};
+
+/**
+ * Converts to Legacy Python UUID (Binary subtype 3).
+ * Python legacy format uses direct byte order (no reversal).
+ * If the input is empty, generates a random UUID.
+ * If the input is a Binary, extracts the UUID from it.
+ */
+const toLegacyPythonUUID = (object: unknown): Binary => {
+  let uuidString = getUUIDStringFromObject(object, 'Python');
+  if (!uuidString) {
+    uuidString = generateRandomUUID();
+  } else {
+    validateUUIDString(uuidString);
+  }
+  const hex = uuidStringToHex(uuidString);
+  return Binary.createFromHexString(hex, Binary.SUBTYPE_UUID_OLD);
+};
+
 const toRegex = (object: unknown): BSONRegExp => {
   return new BSONRegExp(toString(object));
 };
@@ -296,6 +576,10 @@ const CASTERS: {
   BSONSymbol: toSymbol,
   Timestamp: toTimestamp,
   Undefined: toUndefined,
+  UUID: toUUID,
+  LegacyJavaUUID: toLegacyJavaUUID,
+  LegacyCSharpUUID: toLegacyCSharpUUID,
+  LegacyPythonUUID: toLegacyPythonUUID,
 };
 
 /**
@@ -367,20 +651,37 @@ class TypeChecker {
 
   /**
    * Get the type for the object.
+   * @param legacyUUIDEncoding - Optional encoding for legacy UUID (subtype 3).
+   *   If provided and the object is a Binary with subtype 3, returns the specific legacy UUID type.
+   *   Valid values: 'LegacyJavaUUID', 'LegacyCSharpUUID', 'LegacyPythonUUID'
    */
-  type(object: unknown): TypeCastTypes {
-    if (hasIn(object, BSON_TYPE)) {
-      const bsonObj = object as { _bsontype: string };
-      if (bsonObj._bsontype === LONG) {
+  type(
+    object: unknown,
+    legacyUUIDEncoding?:
+      | 'LegacyJavaUUID'
+      | 'LegacyCSharpUUID'
+      | 'LegacyPythonUUID'
+  ): TypeCastTypes {
+    const bsonType = getBsonType(object);
+    if (bsonType) {
+      if (bsonType === LONG) {
         return INT_64;
       }
-      if (bsonObj._bsontype === OBJECT_ID) {
-        return 'ObjectId';
-      }
-      if (bsonObj._bsontype === SYMBOL) {
-        return 'BSONSymbol';
+      // Handle Binary UUID subtypes
+      if (bsonType === 'Binary') {
+        const binary = object as Binary;
+        if (binary.sub_type === Binary.SUBTYPE_UUID) {
+          return 'UUID';
+        }
+        if (
+          binary.sub_type === Binary.SUBTYPE_UUID_OLD &&
+          binary.buffer.length === 16 &&
+          legacyUUIDEncoding
+        ) {
+          return legacyUUIDEncoding;
+        }
       }
-      return bsonObj._bsontype as TypeCastTypes;
+      return bsonType as TypeCastTypes;
     }
     if (isNumber(object)) {
       return numberToBsonType(object);