@memberjunction/global 5.4.0 → 5.5.0

package/dist/__tests__/UUIDCompliance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UUIDCompliance.test.d.ts.map

package/dist/__tests__/UUIDCompliance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDCompliance.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/UUIDCompliance.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/UUIDCompliance.test.js

@@ -0,0 +1,137 @@
+/**
+ * UUID Compliance Tests
+ *
+ * These tests scan the MemberJunction source tree for direct UUID comparison
+ * patterns (=== / !==) that should use UUIDsEqual() or NormalizeUUID() instead.
+ *
+ * PostgreSQL returns UUIDs in lowercase while SQL Server returns uppercase.
+ * Direct string comparisons break cross-database compatibility.
+ *
+ * If this test fails, it means new code introduced a direct UUID comparison.
+ * Fix by replacing `x.ID === y` with `UUIDsEqual(x.ID, y)`.
+ */
+import { describe, it, expect } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+/** Directories that should never contain UUID comparison anti-patterns */
+const SCAN_ROOT = path.resolve(__dirname, '..', '..', '..'); // packages/
+/** Patterns that indicate direct UUID comparison (anti-patterns) */
+const ANTI_PATTERNS = [
+    /\.ID\s*===\s*(?!['"]|true|false|null|undefined|0\b)/, // .ID === someVar (not string literals or primitives)
+    /===\s*\w+\.ID\b/, // something === x.ID
+    /\.ID\s*!==\s*(?!['"]|true|false|null|undefined|0\b)/, // .ID !== someVar
+    /!==\s*\w+\.ID\b/, // something !== x.ID
+    /\.includes\(\w+\.ID\b\)/, // array.includes(x.ID) — uses === internally
+];
+/** Files/directories to exclude from scanning */
+const EXCLUDE_PATTERNS = [
+    /node_modules/,
+    /\/dist\//,
+    /\/generated\//,
+    /\.test\.ts$/,
+    /\.spec\.ts$/,
+    /__tests__/,
+    /UUIDUtils\.ts$/, // The utility itself
+    /\.js$/, // Only scan TypeScript source
+    /\.d\.ts$/, // Skip declaration files
+    /\.map$/, // Skip source maps
+    /package-lock\.json$/,
+];
+/** Known exceptions — files where .ID === is comparing non-UUID values (e.g., numeric IDs, string enum values) */
+const KNOWN_EXCEPTIONS = {
+// Add file paths (relative to packages/) and the reason they're excepted
+// Example: 'SomePackage/src/file.ts': ['Uses numeric IDs, not UUIDs'],
+};
+function shouldScanFile(filePath) {
+    if (!filePath.endsWith('.ts'))
+        return false;
+    return !EXCLUDE_PATTERNS.some(pattern => pattern.test(filePath));
+}
+function findTsFiles(dir) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name === '.git') {
+                continue; // Skip these directories entirely for performance
+            }
+            results.push(...findTsFiles(fullPath));
+        }
+        else if (shouldScanFile(fullPath)) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+function scanFileForViolations(filePath) {
+    const violations = [];
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n');
+    // Check if file is in known exceptions
+    const relativePath = path.relative(SCAN_ROOT, filePath);
+    if (KNOWN_EXCEPTIONS[relativePath]) {
+        return [];
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Skip comments
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) {
+            continue;
+        }
+        // Skip import lines
+        if (trimmed.startsWith('import ')) {
+            continue;
+        }
+        for (const pattern of ANTI_PATTERNS) {
+            if (pattern.test(line)) {
+                // Additional filter: skip comparisons with empty string '', string literals, null, undefined, or type checks
+                if (/\.ID\s*[!=]==?\s*''/.test(line) || /[!=]==?\s*''/.test(line))
+                    continue; // Comparing to empty string
+                if (/\.ID\s*[!=]==?\s*['"]/.test(line))
+                    continue; // Comparing to any string literal
+                if (/[!=]==?\s*['"]/.test(line) && /\.ID\b/.test(line))
+                    continue; // String literal comparison involving .ID
+                if (/typeof\s+\w+\.ID\s*===/.test(line))
+                    continue; // typeof check
+                if (/\.ID\s*===\s*null\b/.test(line) || /\.ID\s*===\s*undefined\b/.test(line))
+                    continue; // null/undefined check
+                if (/\.ID\s*!==\s*null\b/.test(line) || /\.ID\s*!==\s*undefined\b/.test(line))
+                    continue; // negated null/undefined check
+                violations.push({
+                    file: relativePath,
+                    line: i + 1,
+                    content: trimmed.substring(0, 120),
+                    pattern: pattern.source,
+                });
+                break; // One violation per line is enough
+            }
+        }
+    }
+    return violations;
+}
+describe('UUID Comparison Compliance', () => {
+    it('should not have direct UUID comparisons (=== / !==) in source files', () => {
+        const tsFiles = findTsFiles(SCAN_ROOT);
+        const allViolations = [];
+        for (const file of tsFiles) {
+            allViolations.push(...scanFileForViolations(file));
+        }
+        if (allViolations.length > 0) {
+            const report = allViolations
+                .map(v => `  ${v.file}:${v.line}: ${v.content}`)
+                .join('\n');
+            expect.fail(`Found ${allViolations.length} direct UUID comparison(s) that should use UUIDsEqual():\n${report}\n\n` +
+                `Fix by replacing:\n` +
+                `  - 'x.ID === y' with 'UUIDsEqual(x.ID, y)'\n` +
+                `  - 'x.ID !== y' with '!UUIDsEqual(x.ID, y)'\n` +
+                `  - 'arr.includes(x.ID)' with 'arr.some(id => UUIDsEqual(id, x.ID))'\n` +
+                `Import UUIDsEqual from '@memberjunction/global'.\n` +
+                `If a comparison is NOT a UUID (e.g., numeric ID), add it to KNOWN_EXCEPTIONS in this test file.`);
+        }
+    });
+});
+//# sourceMappingURL=UUIDCompliance.test.js.map

package/dist/__tests__/UUIDCompliance.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDCompliance.test.js","sourceRoot":"","sources":["../../src/__tests__/UUIDCompliance.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,0EAA0E;AAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,YAAY;AAEzE,oEAAoE;AACpE,MAAM,aAAa,GAAG;IAClB,qDAAqD,EAAM,sDAAsD;IACjH,iBAAiB,EAA2C,qBAAqB;IACjF,qDAAqD,EAAM,kBAAkB;IAC7E,iBAAiB,EAA2C,qBAAqB;IACjF,yBAAyB,EAAoC,6CAA6C;CAC7G,CAAC;AAEF,iDAAiD;AACjD,MAAM,gBAAgB,GAAG;IACrB,cAAc;IACd,UAAU;IACV,eAAe;IACf,aAAa;IACb,aAAa;IACb,WAAW;IACX,gBAAgB,EAAY,qBAAqB;IACjD,OAAO,EAAqB,8BAA8B;IAC1D,UAAU,EAAkB,yBAAyB;IACrD,QAAQ,EAAoB,mBAAmB;IAC/C,qBAAqB;CACxB,CAAC;AAEF,kHAAkH;AAClH,MAAM,gBAAgB,GAA6B;AAC/C,yEAAyE;AACzE,uEAAuE;CAC1E,CAAC;AAEF,SAAS,cAAc,CAAC,QAAgB;IACpC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAClF,SAAS,CAAC,kDAAkD;YAChE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AASD,SAAS,qBAAqB,CAAC,QAAgB;IAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,uCAAuC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,gBAAgB;QAChB,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAClF,SAAS;QACb,CAAC;QAED,oBAAoB;QACpB,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,SAAS;QACb,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,6GAA6G;gBAC7G,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAO,4BAA4B;gBAC/G,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAmC,kCAAkC;gBACtH,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAoB,0CAA0C;gBAC/H,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAkC,eAAe;gBACnG,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAE,uBAAuB;gBACjH,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAE,+BAA+B;gBAEzH,UAAU,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;oBAClC,OAAO,EAAE,OAAO,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,MAAM,CAAC,mCAAmC;YAC9C,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC3E,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,aAAa,GAAgB,EAAE,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,aAAa;iBACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,MAAM,CAAC,IAAI,CACP,SAAS,aAAa,CAAC,MAAM,6DAA6D,MAAM,MAAM;gBACtG,qBAAqB;gBACrB,+CAA+C;gBAC/C,gDAAgD;gBAChD,wEAAwE;gBACxE,oDAAoD;gBACpD,iGAAiG,CACpG,CAAC;QACN,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/__tests__/UUIDUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=UUIDUtils.test.d.ts.map

package/dist/__tests__/UUIDUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UUIDUtils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/UUIDUtils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/UUIDUtils.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect } from 'vitest';
+import { NormalizeUUID, UUIDsEqual } from '../util/UUIDUtils.js';
+describe('NormalizeUUID', () => {
+    it('should lowercase an uppercase UUID (SQL Server format)', () => {
+        expect(NormalizeUUID('A1B2C3D4-E5F6-7890-ABCD-EF1234567890'))
+            .toBe('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
+    });
+    it('should pass through a lowercase UUID unchanged (PostgreSQL format)', () => {
+        expect(NormalizeUUID('a1b2c3d4-e5f6-7890-abcd-ef1234567890'))
+            .toBe('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
+    });
+    it('should handle mixed-case UUIDs', () => {
+        expect(NormalizeUUID('A1b2C3d4-E5f6-7890-AbCd-Ef1234567890'))
+            .toBe('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
+    });
+    it('should trim whitespace', () => {
+        expect(NormalizeUUID('  A1B2C3D4  ')).toBe('a1b2c3d4');
+    });
+    it('should return empty string for null', () => {
+        expect(NormalizeUUID(null)).toBe('');
+    });
+    it('should return empty string for undefined', () => {
+        expect(NormalizeUUID(undefined)).toBe('');
+    });
+    it('should return empty string for whitespace-only input', () => {
+        expect(NormalizeUUID('   ')).toBe('');
+    });
+    it('should handle empty string', () => {
+        expect(NormalizeUUID('')).toBe('');
+    });
+});
+describe('UUIDsEqual', () => {
+    const upperUUID = 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890';
+    const lowerUUID = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
+    it('should consider SQL Server (uppercase) and PostgreSQL (lowercase) UUIDs equal', () => {
+        expect(UUIDsEqual(upperUUID, lowerUUID)).toBe(true);
+    });
+    it('should consider identical uppercase UUIDs equal', () => {
+        expect(UUIDsEqual(upperUUID, upperUUID)).toBe(true);
+    });
+    it('should consider identical lowercase UUIDs equal', () => {
+        expect(UUIDsEqual(lowerUUID, lowerUUID)).toBe(true);
+    });
+    it('should return false for different UUIDs', () => {
+        expect(UUIDsEqual('A1B2C3D4-0000-0000-0000-000000000000', 'A1B2C3D4-0000-0000-0000-000000000001')).toBe(false);
+    });
+    it('should consider two nulls equal', () => {
+        expect(UUIDsEqual(null, null)).toBe(true);
+    });
+    it('should consider two undefineds equal', () => {
+        expect(UUIDsEqual(undefined, undefined)).toBe(true);
+    });
+    it('should consider null and undefined equal', () => {
+        expect(UUIDsEqual(null, undefined)).toBe(true);
+    });
+    it('should return false for null vs non-null', () => {
+        expect(UUIDsEqual(null, lowerUUID)).toBe(false);
+    });
+    it('should return false for non-null vs null', () => {
+        expect(UUIDsEqual(upperUUID, null)).toBe(false);
+    });
+    it('should return false for undefined vs non-undefined', () => {
+        expect(UUIDsEqual(undefined, lowerUUID)).toBe(false);
+    });
+    it('should handle UUIDs with surrounding whitespace', () => {
+        expect(UUIDsEqual('  ' + upperUUID + '  ', lowerUUID)).toBe(true);
+    });
+    it('should handle mixed-case comparison', () => {
+        expect(UUIDsEqual('AbCd1234', 'aBcD1234')).toBe(true);
+    });
+    it('should handle empty strings as equal', () => {
+        expect(UUIDsEqual('', '')).toBe(true);
+    });
+});
+//# sourceMappingURL=UUIDUtils.test.js.map

package/dist/__tests__/UUIDUtils.test.js.map

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

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './BaseSingleton.js';
 export * from './DeepDiff.js';
 export * from './ClassUtils.js';
 export * from './util/PatternUtils.js';
+export * from './util/UUIDUtils.js';
 export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAMjC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAMjC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA"}

package/dist/index.js

@@ -7,6 +7,7 @@ export * from './BaseSingleton.js';
 export * from './DeepDiff.js';
 export * from './ClassUtils.js';
 export * from './util/PatternUtils.js';
+export * from './util/UUIDUtils.js';
 export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.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,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAEtC,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,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAEjC,2DAA2D;AAC3D,oCAAoC;AAEpC,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AAEtC,6DAA6D;AAC7D,oCAAoC"}

package/dist/util/UUIDUtils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview UUID comparison utility functions for MemberJunction
+ *
+ * Provides case-insensitive UUID comparison to handle the difference between
+ * SQL Server (returns UUIDs in UPPERCASE) and PostgreSQL (returns UUIDs in lowercase).
+ * These utilities ensure consistent UUID handling across all database platforms.
+ *
+ * @module @memberjunction/global/UUIDUtils
+ */
+/**
+ * Normalizes a UUID string for consistent comparison by trimming whitespace
+ * and converting to lowercase. Returns an empty string for null/undefined input.
+ *
+ * @param uuid - The UUID string to normalize
+ * @returns The normalized (lowercased, trimmed) UUID string, or empty string if input is nullish
+ *
+ * @example
+ * NormalizeUUID('A1B2C3D4-E5F6-7890-ABCD-EF1234567890')
+ * // Returns: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+ *
+ * NormalizeUUID(null) // Returns: ''
+ * NormalizeUUID('  A1B2C3D4  ') // Returns: 'a1b2c3d4'
+ */
+export declare function NormalizeUUID(uuid: string | null | undefined): string;
+/**
+ * Performs a case-insensitive comparison of two UUID strings.
+ * Handles null/undefined gracefully — two nullish values are considered equal,
+ * but a nullish value is never equal to a non-nullish value.
+ *
+ * @param uuid1 - First UUID to compare
+ * @param uuid2 - Second UUID to compare
+ * @returns true if the UUIDs are equal (case-insensitive), false otherwise
+ *
+ * @example
+ * // Cross-platform comparison (SQL Server uppercase vs PostgreSQL lowercase)
+ * UUIDsEqual('A1B2C3D4-E5F6-7890-ABCD-EF1234567890',
+ *            'a1b2c3d4-e5f6-7890-abcd-ef1234567890') // true
+ *
+ * UUIDsEqual(null, null) // true
+ * UUIDsEqual(null, 'some-id') // false
+ * UUIDsEqual('abc', 'ABC') // true
+ */
+export declare function UUIDsEqual(uuid1: string | null | undefined, uuid2: string | null | undefined): boolean;
+//# sourceMappingURL=UUIDUtils.d.ts.map

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

@@ -0,0 +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,CAItG"}

package/dist/util/UUIDUtils.js

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview UUID comparison utility functions for MemberJunction
+ *
+ * Provides case-insensitive UUID comparison to handle the difference between
+ * SQL Server (returns UUIDs in UPPERCASE) and PostgreSQL (returns UUIDs in lowercase).
+ * These utilities ensure consistent UUID handling across all database platforms.
+ *
+ * @module @memberjunction/global/UUIDUtils
+ */
+/**
+ * Normalizes a UUID string for consistent comparison by trimming whitespace
+ * and converting to lowercase. Returns an empty string for null/undefined input.
+ *
+ * @param uuid - The UUID string to normalize
+ * @returns The normalized (lowercased, trimmed) UUID string, or empty string if input is nullish
+ *
+ * @example
+ * NormalizeUUID('A1B2C3D4-E5F6-7890-ABCD-EF1234567890')
+ * // Returns: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+ *
+ * NormalizeUUID(null) // Returns: ''
+ * NormalizeUUID('  A1B2C3D4  ') // Returns: 'a1b2c3d4'
+ */
+export function NormalizeUUID(uuid) {
+    if (uuid == null)
+        return '';
+    return uuid.trim().toLowerCase();
+}
+/**
+ * Performs a case-insensitive comparison of two UUID strings.
+ * Handles null/undefined gracefully — two nullish values are considered equal,
+ * but a nullish value is never equal to a non-nullish value.
+ *
+ * @param uuid1 - First UUID to compare
+ * @param uuid2 - Second UUID to compare
+ * @returns true if the UUIDs are equal (case-insensitive), false otherwise
+ *
+ * @example
+ * // Cross-platform comparison (SQL Server uppercase vs PostgreSQL lowercase)
+ * UUIDsEqual('A1B2C3D4-E5F6-7890-ABCD-EF1234567890',
+ *            'a1b2c3d4-e5f6-7890-abcd-ef1234567890') // true
+ *
+ * UUIDsEqual(null, null) // true
+ * UUIDsEqual(null, 'some-id') // false
+ * UUIDsEqual('abc', 'ABC') // true
+ */
+export function UUIDsEqual(uuid1, uuid2) {
+    if (uuid1 == null && uuid2 == null)
+        return true;
+    if (uuid1 == null || uuid2 == null)
+        return false;
+    return uuid1.trim().toLowerCase() === uuid2.trim().toLowerCase();
+}
+//# sourceMappingURL=UUIDUtils.js.map

package/dist/util/UUIDUtils.js.map

@@ -0,0 +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,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/global",
   "type": "module",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "description": "MemberJunction: Global Object - Needed for ALL other MJ components",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",