@memberjunction/global 6.1.0-edge.2 → 6.1.0-edge.3

package/dist/__tests__/SafeExpressionEvaluator.test.js

@@ -0,0 +1,355 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { SafeExpressionEvaluator, defaultExpressionEvaluator, } from '../SafeExpressionEvaluator.js';
+/**
+ * Functional tests for SafeExpressionEvaluator.
+ *
+ * These exercise the documented contract: evaluate a boolean expression against a
+ * context object, returning an {@link ExpressionEvaluationResult}. Adversarial /
+ * sandbox-escape scenarios live in SafeExpressionEvaluator.security.test.ts.
+ */
+describe('SafeExpressionEvaluator', () => {
+    let evaluator;
+    beforeEach(() => {
+        evaluator = new SafeExpressionEvaluator();
+    });
+    // ---------------------------------------------------------------
+    // Simple comparisons over context data
+    // ---------------------------------------------------------------
+    describe('comparison operators', () => {
+        it('should evaluate == to true when values match', () => {
+            const r = evaluator.evaluate("status == 'active'", { status: 'active' });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+        it('should evaluate == to false when values differ', () => {
+            const r = evaluator.evaluate("status == 'active'", { status: 'inactive' });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(false);
+        });
+        it('should evaluate strict === correctly', () => {
+            expect(evaluator.evaluate('count === 5', { count: 5 }).value).toBe(true);
+            expect(evaluator.evaluate('count === 5', { count: 6 }).value).toBe(false);
+        });
+        it('should evaluate != and !==', () => {
+            expect(evaluator.evaluate('count != 5', { count: 6 }).value).toBe(true);
+            expect(evaluator.evaluate('count !== 5', { count: 5 }).value).toBe(false);
+        });
+        it('should evaluate <, >, <=, >=', () => {
+            expect(evaluator.evaluate('n < 10', { n: 5 }).value).toBe(true);
+            expect(evaluator.evaluate('n > 10', { n: 5 }).value).toBe(false);
+            expect(evaluator.evaluate('n <= 5', { n: 5 }).value).toBe(true);
+            expect(evaluator.evaluate('n >= 6', { n: 5 }).value).toBe(false);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Logical operators
+    // ---------------------------------------------------------------
+    describe('logical operators', () => {
+        it('should evaluate && (AND)', () => {
+            const ctx = { a: true, b: false };
+            expect(evaluator.evaluate('a && b', ctx).value).toBe(false);
+            expect(evaluator.evaluate('a && !b', ctx).value).toBe(true);
+        });
+        it('should evaluate || (OR)', () => {
+            const ctx = { a: false, b: true };
+            expect(evaluator.evaluate('a || b', ctx).value).toBe(true);
+            expect(evaluator.evaluate('a || false', ctx).value).toBe(false);
+        });
+        it('should evaluate ! (NOT)', () => {
+            expect(evaluator.evaluate('!isActive', { isActive: false }).value).toBe(true);
+            expect(evaluator.evaluate('!isActive', { isActive: true }).value).toBe(false);
+        });
+        it('should combine comparisons with logical operators', () => {
+            const ctx = { tier: 'premium', total: 1500 };
+            const r = evaluator.evaluate("tier == 'premium' && total > 1000", ctx);
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Nested property + array access
+    // ---------------------------------------------------------------
+    describe('property and array access', () => {
+        it('should resolve nested dot-notation properties', () => {
+            const ctx = {
+                payload: { customer: { tier: 'premium' }, order: { total: 1500 } },
+            };
+            const r = evaluator.evaluate("payload.customer.tier == 'premium' && payload.order.total > 1000", ctx);
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+        it('should resolve array index access', () => {
+            const ctx = { items: [10, 20, 30] };
+            expect(evaluator.evaluate('items[0] == 10', ctx).value).toBe(true);
+            expect(evaluator.evaluate('items[2] > items[0]', ctx).value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Safe methods
+    // ---------------------------------------------------------------
+    describe('safe string/array methods', () => {
+        it('should support .length', () => {
+            expect(evaluator.evaluate('name.length > 3', { name: 'Alice' }).value).toBe(true);
+            expect(evaluator.evaluate('name.length > 3', { name: 'Al' }).value).toBe(false);
+        });
+        it('should support .includes()', () => {
+            expect(evaluator.evaluate("tags.includes('urgent')", { tags: ['work', 'urgent'] }).value).toBe(true);
+        });
+        it('should support .startsWith() and .endsWith()', () => {
+            const ctx = { code: 'AB-123' };
+            expect(evaluator.evaluate("code.startsWith('AB')", ctx).value).toBe(true);
+            expect(evaluator.evaluate("code.endsWith('123')", ctx).value).toBe(true);
+        });
+        it('should support .toLowerCase() in a comparison', () => {
+            const r = evaluator.evaluate("name.toLowerCase() == 'alice'", { name: 'ALICE' });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Array higher-order methods
+    // ---------------------------------------------------------------
+    describe('array higher-order methods', () => {
+        it('should support .some()', () => {
+            const ctx = { items: [{ price: 50 }, { price: 150 }] };
+            const r = evaluator.evaluate('items.some(item => item.price > 100)', ctx);
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+        it('should support .every()', () => {
+            const ctx = { items: [{ price: 50 }, { price: 150 }] };
+            expect(evaluator.evaluate('items.every(item => item.price > 0)', ctx).value).toBe(true);
+            expect(evaluator.evaluate('items.every(item => item.price > 100)', ctx).value).toBe(false);
+        });
+        it('should support .filter().length', () => {
+            const ctx = {
+                items: [{ price: 50 }, { price: 150 }, { price: 200 }],
+            };
+            const r = evaluator.evaluate('items.filter(item => item.price > 100).length == 2', ctx);
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // typeof
+    // ---------------------------------------------------------------
+    describe('typeof', () => {
+        it('should evaluate typeof checks', () => {
+            expect(evaluator.evaluate("typeof name == 'string'", { name: 'x' }).value).toBe(true);
+            expect(evaluator.evaluate("typeof count == 'number'", { count: 5 }).value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Edge values: null / undefined / empty
+    // ---------------------------------------------------------------
+    describe('edge values', () => {
+        it('should compare against null', () => {
+            expect(evaluator.evaluate('x == null', { x: null }).value).toBe(true);
+            expect(evaluator.evaluate('x === null', { x: null }).value).toBe(true);
+        });
+        it('should treat missing property (undefined) loosely equal to null', () => {
+            const ctx = { obj: {} };
+            // obj.missing is undefined; undefined == null is true in JS
+            expect(evaluator.evaluate('obj.missing == null', ctx).value).toBe(true);
+        });
+        it('should coerce a truthy non-boolean result via Boolean()', () => {
+            // The evaluator wraps the expression in Boolean(...): a bare truthy string yields true
+            const r = evaluator.evaluate('name', { name: 'non-empty' });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+        it('should coerce an empty-string result to false', () => {
+            const r = evaluator.evaluate('name', { name: '' });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(false);
+        });
+        it('should handle an empty context object with a self-contained expression', () => {
+            const r = evaluator.evaluate('1 < 2', {});
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Error paths for malformed / invalid input
+    // ---------------------------------------------------------------
+    describe('error handling', () => {
+        it('should fail on an empty expression', () => {
+            const r = evaluator.evaluate('', { a: 1 });
+            expect(r.success).toBe(false);
+            expect(r.error).toContain('non-empty string');
+        });
+        it('should evaluate a whitespace-only expression to false (Boolean() of no argument)', () => {
+            // A non-empty but whitespace-only string passes validation and compiles to
+            // `Boolean(   )`, which is Boolean() === false — so it succeeds with value false.
+            const r = evaluator.evaluate('   ', { a: 1 });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(false);
+        });
+        it('should fail on unbalanced parentheses', () => {
+            const r = evaluator.evaluate('(a > 1', { a: 5 });
+            expect(r.success).toBe(false);
+            expect(r.error).toContain('Unbalanced parentheses');
+        });
+        it('should fail on a closing paren before an opening paren', () => {
+            const r = evaluator.evaluate('a > 1)', { a: 5 });
+            expect(r.success).toBe(false);
+            expect(r.error).toContain('Unbalanced parentheses');
+        });
+        it('should fail on a syntactically malformed expression', () => {
+            const r = evaluator.evaluate('a ===', { a: 1 });
+            expect(r.success).toBe(false);
+            expect(r.error).toBeDefined();
+        });
+        it('should fail when referencing an unknown identifier not in context', () => {
+            const r = evaluator.evaluate('missingVar > 1', { a: 1 });
+            expect(r.success).toBe(false);
+            expect(r.error).toContain('Expression evaluation failed');
+        });
+        it('should fail when the expression exceeds the 1000-character limit', () => {
+            const long = '1 == 1 && '.repeat(200) + '1 == 1'; // well over 1000 chars
+            const r = evaluator.evaluate(long, {});
+            expect(r.success).toBe(false);
+            expect(r.error).toContain('maximum length');
+        });
+        it('should fail when a context key is not a valid JS identifier', () => {
+            // Context keys become Function parameter names; "my-key" is not a valid identifier.
+            const ctx = { 'my-key': 1 };
+            const r = evaluator.evaluate('1 == 1', ctx);
+            expect(r.success).toBe(false);
+            expect(r.error).toBeDefined();
+        });
+    });
+    // ---------------------------------------------------------------
+    // Diagnostics
+    // ---------------------------------------------------------------
+    describe('diagnostics', () => {
+        it('should omit diagnostics by default', () => {
+            const r = evaluator.evaluate('a == 1', { a: 1 });
+            expect(r.diagnostics).toBeUndefined();
+        });
+        it('should include diagnostics when enabled on success', () => {
+            const r = evaluator.evaluate('a == 1', { a: 1 }, true);
+            expect(r.diagnostics).toBeDefined();
+            expect(r.diagnostics?.expression).toBe('a == 1');
+            expect(r.diagnostics?.context).toEqual({ a: 1 });
+            expect(typeof r.diagnostics?.evaluationTime).toBe('number');
+        });
+        it('should include diagnostics when enabled on failure', () => {
+            const r = evaluator.evaluate('', { a: 1 }, true);
+            expect(r.success).toBe(false);
+            expect(r.diagnostics).toBeDefined();
+            expect(r.diagnostics?.expression).toBe('');
+        });
+    });
+    // ---------------------------------------------------------------
+    // Caching behaviour (observable: repeated evals stay consistent)
+    // ---------------------------------------------------------------
+    describe('compiled-expression cache', () => {
+        it('should return consistent results across repeated evaluations of the same expression', () => {
+            const first = evaluator.evaluate('a > 1', { a: 5 });
+            const second = evaluator.evaluate('a > 1', { a: 5 });
+            expect(first.value).toBe(true);
+            expect(second.value).toBe(true);
+        });
+        it('should honour different context values on a cached expression', () => {
+            // Same expression + same context keys -> cache hit, but different values must still be applied
+            expect(evaluator.evaluate('a > 1', { a: 5 }).value).toBe(true);
+            expect(evaluator.evaluate('a > 1', { a: 0 }).value).toBe(false);
+        });
+    });
+    // ---------------------------------------------------------------
+    // evaluateMultiple
+    // ---------------------------------------------------------------
+    describe('evaluateMultiple', () => {
+        it('should evaluate several named expressions against one context', () => {
+            const results = evaluator.evaluateMultiple([
+                { expression: 'a > 1', name: 'aPositive' },
+                { expression: "b == 'x'", name: 'bIsX' },
+            ], { a: 5, b: 'x' });
+            expect(results.aPositive.value).toBe(true);
+            expect(results.bIsX.value).toBe(true);
+        });
+        it('should key unnamed expressions by index', () => {
+            const results = evaluator.evaluateMultiple([{ expression: 'a > 1' }], { a: 5 });
+            expect(results.expression_0.value).toBe(true);
+        });
+        it('should report per-expression failures independently', () => {
+            const results = evaluator.evaluateMultiple([
+                { expression: 'a > 1', name: 'ok' },
+                { expression: 'a ===', name: 'broken' },
+            ], { a: 5 });
+            expect(results.ok.success).toBe(true);
+            expect(results.broken.success).toBe(false);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Safe globals — the shapes authored specs write
+    // ---------------------------------------------------------------
+    describe('safe global calls', () => {
+        // `condition-roots.ts` blesses these twelve names at the task-graph door, and
+        // `1efc248ac5` shipped that decision precisely because refusing them rejects specs
+        // that run correctly. Receiver and method are both fixed identifiers, so nothing
+        // here is reachable by string assembly.
+        const ctx = { payload: { count: 4, raw: '7', id: 42 }, output: { delta: -3 } };
+        it.each([
+            ['Math.abs(output.delta) < 5', true],
+            ['Math.max(payload.count, 9) === 9', true],
+            ['Number(payload.count) > 3', true],
+            ['String(payload.id).length > 0', true],
+            ['Boolean(payload.count) === true', true],
+            ['Array.isArray(output) === false', true],
+            ['Object.keys(payload).length > 0', true],
+            ["JSON.stringify(payload) !== ''", true],
+            ['Date.now() > 0', true],
+            ['parseInt(payload.raw) > 0', true],
+            ['parseFloat(payload.raw) === 7', true],
+            ['isNaN(payload.count) === false', true],
+            ['isFinite(payload.count) === true', true],
+            ['Number.isInteger(payload.count)', true],
+        ])('should evaluate %s', (expression, expected) => {
+            const r = evaluator.evaluate(expression, ctx);
+            expect(r.error).toBeUndefined();
+            expect(r.value).toBe(expected);
+        });
+        it('should reject a namespace method that is not on the list', () => {
+            // Mutators stay out even on an allowed namespace.
+            const r = evaluator.evaluate('Object.assign(payload) !== null', ctx);
+            expect(r.success).toBe(false);
+            expect(r.error).toContain('forbidden construct');
+        });
+        it('should reject a global that is not on the list', () => {
+            expect(evaluator.evaluate('Symbol("x") !== null', {}).success).toBe(false);
+            expect(evaluator.evaluate('fetch("/x") !== null', {}).success).toBe(false);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Optional chaining
+    // ---------------------------------------------------------------
+    describe('optional chaining', () => {
+        it('should read through a present chain', () => {
+            const r = evaluator.evaluate("payload?.customer?.tier == 'premium'", {
+                payload: { customer: { tier: 'premium' } },
+            });
+            expect(r.value).toBe(true);
+        });
+        it('should short-circuit on an absent link rather than throwing', () => {
+            const r = evaluator.evaluate("payload?.customer?.tier == 'premium'", { payload: {} });
+            expect(r.success).toBe(true);
+            expect(r.value).toBe(false);
+        });
+        it('should apply the same rules to an optional index and an optional call', () => {
+            expect(evaluator.evaluate('items?.[0]?.price > 100', { items: [{ price: 150 }] }).value).toBe(true);
+            expect(evaluator.evaluate("name?.toLowerCase() == 'ada'", { name: 'Ada' }).value).toBe(true);
+        });
+    });
+    // ---------------------------------------------------------------
+    // Default exported instance
+    // ---------------------------------------------------------------
+    describe('defaultExpressionEvaluator', () => {
+        it('should be a usable SafeExpressionEvaluator instance', () => {
+            expect(defaultExpressionEvaluator).toBeInstanceOf(SafeExpressionEvaluator);
+            expect(defaultExpressionEvaluator.evaluate('1 == 1', {}).value).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=SafeExpressionEvaluator.test.js.map

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

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

package/dist/__tests__/SafeExpressionEvaluator.validateSyntax.test.d.ts

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

package/dist/__tests__/SafeExpressionEvaluator.validateSyntax.test.d.ts.map

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

package/dist/__tests__/SafeExpressionEvaluator.validateSyntax.test.js

@@ -0,0 +1,62 @@
+/**
+ * `validateSyntax` — checking that an expression *could* run, without running it.
+ *
+ * The distinction this draws is the whole point. `evaluate` reports two unrelated problems the same
+ * way: given an empty context, `payload.x > 1` fails with "payload is not defined" exactly as
+ * `payload.x >` fails with "Unexpected token". One is a typo; the other is a perfectly good
+ * condition that simply has no data yet. Anything built on `evaluate` to check authoring-time
+ * correctness therefore refuses every legitimate reference — which is the bug this method exists to
+ * make impossible.
+ *
+ * So the accept-list below matters more than the refuse-list: each entry is a shape somebody has
+ * already written, and over-refusing breaks saving work that runs fine.
+ */
+import { describe, it, expect } from 'vitest';
+import { SafeExpressionEvaluator } from '../SafeExpressionEvaluator.js';
+const evaluator = new SafeExpressionEvaluator();
+describe('validateSyntax — parses without evaluating', () => {
+    it.each([
+        ['payload.x > 1', 'an identifier that will only exist at runtime'],
+        ['payload.x.y === \'a\'', 'a chain one property deeper than the envelope'],
+        ['payload.title.includes(\'x\')', 'a method call on a value we cannot see yet'],
+        ['stepResult.step === \'Success\'', 'the flow dialect'],
+        ['unknownVar === 1', 'an identifier in no dialect at all — D2 may yet add it'],
+        ['succeeded', 'the shortest legal condition there is'],
+        ['output.count > 0 && !failed', 'operators either dialect uses'],
+    ])('accepts %s (%s)', (expression) => {
+        expect(evaluator.validateSyntax(expression)).toEqual({ Valid: true });
+    });
+    it.each([
+        ['payload.x >', 'a comparison with nothing on the right'],
+        ['foo(', 'an unclosed call'],
+        ['(payload.x > 1', 'unbalanced parentheses'],
+        ['payload.x > 1)', 'a stray closer'],
+        ['a ==== b', 'an operator that does not exist'],
+    ])('refuses %s (%s)', (expression) => {
+        const verdict = evaluator.validateSyntax(expression);
+        expect(verdict.Valid).toBe(false);
+        expect(verdict.Error).toBeTruthy();
+    });
+    it('refuses what the runtime would refuse anyway, rather than letting it hold forever', () => {
+        // These are policy, not grammar — but the evaluator rejects them at run time, so the edge
+        // would hold on every poll for the life of the graph. Better said now.
+        expect(evaluator.validateSyntax('a; b').Valid).toBe(false);
+        expect(evaluator.validateSyntax('this.x').Valid).toBe(false);
+        expect(evaluator.validateSyntax('x.constructor').Valid).toBe(false);
+    });
+    it('never runs the expression it is checking', () => {
+        // The guarantee that makes compile-don't-execute safe. If validation invoked the body, a
+        // condition would have side effects at SAVE time — on somebody else's machine.
+        let touched = false;
+        const globalScope = globalThis;
+        globalScope.__mjConditionProbe = () => { touched = true; return true; };
+        try {
+            evaluator.validateSyntax('__mjConditionProbe()');
+            expect(touched).toBe(false);
+        }
+        finally {
+            delete globalScope.__mjConditionProbe;
+        }
+    });
+});
+//# sourceMappingURL=SafeExpressionEvaluator.validateSyntax.test.js.map

package/dist/__tests__/SafeExpressionEvaluator.validateSyntax.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafeExpressionEvaluator.validateSyntax.test.js","sourceRoot":"","sources":["../../src/__tests__/SafeExpressionEvaluator.validateSyntax.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,SAAS,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAEhD,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACxD,EAAE,CAAC,IAAI,CAAC;QACJ,CAAC,eAAe,EAAE,+CAA+C,CAAC;QAClE,CAAC,uBAAuB,EAAE,+CAA+C,CAAC;QAC1E,CAAC,+BAA+B,EAAE,4CAA4C,CAAC;QAC/E,CAAC,iCAAiC,EAAE,kBAAkB,CAAC;QACvD,CAAC,kBAAkB,EAAE,wDAAwD,CAAC;QAC9E,CAAC,WAAW,EAAE,uCAAuC,CAAC;QACtD,CAAC,6BAA6B,EAAE,+BAA+B,CAAC;KACnE,CAAC,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,EAAE;QACjC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC;QACJ,CAAC,aAAa,EAAE,wCAAwC,CAAC;QACzD,CAAC,MAAM,EAAE,kBAAkB,CAAC;QAC5B,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;QAC5C,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;QACpC,CAAC,UAAU,EAAE,iCAAiC,CAAC;KAClD,CAAC,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QACzF,0FAA0F;QAC1F,uEAAuE;QACvE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAChD,yFAAyF;QACzF,+EAA+E;QAC/E,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,WAAW,GAAG,UAAgD,CAAC;QACrE,WAAW,CAAC,kBAAkB,GAAG,GAAG,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC;YACD,SAAS,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC;YACjD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACP,OAAO,WAAW,CAAC,kBAAkB,CAAC;QAC1C,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/__tests__/util.toEpochMs.test.d.ts

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

package/dist/__tests__/util.toEpochMs.test.d.ts.map

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

package/dist/__tests__/util.toEpochMs.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect } from 'vitest';
+import { ToEpochMs } from '../util.js';
+/**
+ * `ToEpochMs` is the shared guard behind every framework date comparator, so its contract
+ * is pinned directly here rather than only through those call sites.
+ *
+ * The contract that matters to a comparator: ALWAYS return a finite number. A comparator that
+ * can return `NaN` is incoherent — `sort` gets inconsistent orderings from it — which is the
+ * subtle half of the bug the old `?? 0` / `|| 0` patterns left open.
+ */
+describe('ToEpochMs', () => {
+    const ISO = '2026-08-01T00:00:00.000Z';
+    const EPOCH = Date.UTC(2026, 7, 1);
+    it('returns getTime() for a Date', () => {
+        expect(ToEpochMs(new Date(ISO))).toBe(EPOCH);
+    });
+    it('parses an ISO string — the poisoned-cache shape that used to throw', () => {
+        expect(ToEpochMs(ISO)).toBe(EPOCH);
+    });
+    it('accepts a numeric timestamp', () => {
+        expect(ToEpochMs(EPOCH)).toBe(EPOCH);
+    });
+    it('returns 0 for null and undefined', () => {
+        expect(ToEpochMs(null)).toBe(0);
+        expect(ToEpochMs(undefined)).toBe(0);
+    });
+    it('returns 0 for an unparseable string rather than NaN', () => {
+        expect(ToEpochMs('not-a-date')).toBe(0);
+    });
+    it('returns 0 for an Invalid Date rather than NaN', () => {
+        // The case `?? 0` could not catch: Invalid Date's getTime() is NaN, and NaN is not
+        // nullish, so the old form propagated NaN straight into the comparator.
+        expect(ToEpochMs(new Date('garbage'))).toBe(0);
+    });
+    it('returns 0 for an empty string', () => {
+        expect(ToEpochMs('')).toBe(0);
+    });
+    it('never returns NaN for any of the above', () => {
+        const inputs = [
+            new Date(ISO), ISO, EPOCH, null, undefined, 'not-a-date', new Date('garbage'), '', 0,
+        ];
+        for (const input of inputs) {
+            expect(Number.isNaN(ToEpochMs(input))).toBe(false);
+        }
+    });
+    it('orders correctly when used as a descending comparator over mixed shapes', () => {
+        const rows = [
+            { id: 'missing', at: null },
+            { id: 'old', at: '2026-08-01T00:00:00.000Z' },
+            { id: 'new', at: new Date('2026-08-03T00:00:00.000Z') },
+            { id: 'mid', at: Date.UTC(2026, 7, 2) },
+        ];
+        const sorted = [...rows].sort((a, b) => ToEpochMs(b.at) - ToEpochMs(a.at));
+        expect(sorted.map((r) => r.id)).toEqual(['new', 'mid', 'old', 'missing']);
+    });
+});
+//# sourceMappingURL=util.toEpochMs.test.js.map

package/dist/__tests__/util.toEpochMs.test.js.map

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

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from './ShutdownRegistry.js';
 export * from './DeepDiff.js';
 export * from './ClassUtils.js';
 export * from './util/PatternUtils.js';
+export * from './util/ResourcePatternUtils.js';
 export * from './util/UUIDUtils.js';
 export * from './util/CronUtils.js';
 export * from './util/SerializationUtils.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,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,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,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;AAMtC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,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,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,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;AAMtC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,+BAA+B,CAAA"}

package/dist/index.js

@@ -10,6 +10,7 @@ export * from './ShutdownRegistry.js';
 export * from './DeepDiff.js';
 export * from './ClassUtils.js';
 export * from './util/PatternUtils.js';
+export * from './util/ResourcePatternUtils.js';
 export * from './util/UUIDUtils.js';
 export * from './util/CronUtils.js';
 export * from './util/SerializationUtils.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,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,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;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,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,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;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/ResourcePatternUtils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview Resolution of API scope-rule `ResourcePattern` values to a single entity target.
+ *
+ * Lives here, in the one package every consumer already depends on, because the rule has to be
+ * IDENTICAL in two places that cannot import each other: CodeGenLib's mint/drift materialization
+ * gates (`ManageMetadataBase.loadAPIKeyRowFilterTargets`) and the runtime refresher's Leak-1 gate
+ * (`MaterializationRefresher.loadAPIKeyRowFilterTargets`). Those gates decide whether an entity is
+ * row-restricted; a copy that drifts open in one of them silently re-opens the leak the other one
+ * closes, and nothing in the build would notice.
+ *
+ * @module @memberjunction/global/ResourcePatternUtils
+ */
+/**
+ * Resolves an API scope rule's `ResourcePattern` to the single entity name it targets, normalized for
+ * lookup (trimmed and lowercased), or `null` when it cannot be resolved to exactly one entity.
+ *
+ * `null` is the FAIL-CLOSED answer, and callers must treat it as "this rule may name any entity"
+ * rather than "this rule names nothing" — a pattern we cannot map may well name the very entity the
+ * caller is about to mirror into an unscoped snapshot. Refusing to materialize is recoverable and
+ * loud; mirroring restricted rows is neither.
+ *
+ * Normalization matches the way scope rules are authored and resolved: `IsExactResourceName` gates
+ * the pattern at save time and `Metadata.EntityByName` resolves it, both case-insensitively.
+ *
+ * @param pattern the rule's raw `ResourcePattern` (null/undefined/blank all resolve to `null`).
+ * @returns the trimmed, lowercased entity name, or `null` when the pattern is not a single exact name.
+ *
+ * @example
+ * ResolveSingleEntityResourceTarget('  Salaries ')   // 'salaries'
+ * ResolveSingleEntityResourceTarget('MJ: AI Agents') // 'mj: ai agents'
+ * ResolveSingleEntityResourceTarget('Sk?p')          // null  (would otherwise fence nothing)
+ * ResolveSingleEntityResourceTarget('A,B')           // null
+ */
+export declare function ResolveSingleEntityResourceTarget(pattern: string | null | undefined): string | null;
+//# sourceMappingURL=ResourcePatternUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResourcePatternUtils.d.ts","sourceRoot":"","sources":["../../src/util/ResourcePatternUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASnG"}