@memberjunction/global 6.1.0-edge.1 → 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__/TokenEndpointErrors.test.d.ts

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

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

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

package/dist/__tests__/TokenEndpointErrors.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect } from 'vitest';
+import { DescribeTokenEndpointFailure } from '../TokenEndpointErrors.js';
+/** Credentials a token endpoint could echo back in an error body. */
+const ACCESS_TOKEN = 'ya29.LIVE-ACCESS-TOKEN';
+const CLIENT_SECRET = 'cs-LIVE-CLIENT-SECRET';
+const REFRESH_TOKEN = 'rt-LIVE-REFRESH-TOKEN';
+describe('DescribeTokenEndpointFailure', () => {
+    describe('withholds credentials the body may carry', () => {
+        it('withholds a body that is a bare token response', () => {
+            // Reached when a caller guards `!response.ok || !parsed.access_token` and the
+            // token was nested somewhere the parser did not look — the body IS the token.
+            const out = DescribeTokenEndpointFailure(JSON.stringify({ data: { access_token: ACCESS_TOKEN } }));
+            expect(out).not.toContain(ACCESS_TOKEN);
+            expect(out).toBe(' — response body withheld (may contain credentials)');
+        });
+        it('withholds an echoed request carrying client_secret', () => {
+            // The common real-world case: the endpoint echoes the failing request.
+            const out = DescribeTokenEndpointFailure(JSON.stringify({ request: { client_secret: CLIENT_SECRET, refresh_token: REFRESH_TOKEN } }));
+            expect(out).not.toContain(CLIENT_SECRET);
+            expect(out).not.toContain(REFRESH_TOKEN);
+        });
+        it('withholds a body that is not JSON at all', () => {
+            const out = DescribeTokenEndpointFailure(`<html>error: token=${ACCESS_TOKEN}</html>`);
+            expect(out).not.toContain(ACCESS_TOKEN);
+            expect(out).toBe(' — response body withheld (may contain credentials)');
+        });
+        it('withholds a JSON body carrying only non-standard fields', () => {
+            const out = DescribeTokenEndpointFailure(JSON.stringify({ detail: ACCESS_TOKEN }));
+            expect(out).not.toContain(ACCESS_TOKEN);
+        });
+    });
+    describe('surfaces the RFC 6749 §5.2 fields, which carry no credentials', () => {
+        it('returns both error and error_description when present', () => {
+            const out = DescribeTokenEndpointFailure(JSON.stringify({ error: 'invalid_client', error_description: 'Client authentication failed' }));
+            expect(out).toBe(' — invalid_client: Client authentication failed');
+        });
+        it('returns error alone when there is no description', () => {
+            expect(DescribeTokenEndpointFailure(JSON.stringify({ error: 'invalid_grant' })))
+                .toBe(' — invalid_grant');
+        });
+        it('returns the description alone when there is no code', () => {
+            expect(DescribeTokenEndpointFailure(JSON.stringify({ error_description: 'Token expired' })))
+                .toBe(' — Token expired');
+        });
+        it('ignores the rest of the body while surfacing the safe fields', () => {
+            const out = DescribeTokenEndpointFailure(JSON.stringify({ error: 'invalid_grant', access_token: ACCESS_TOKEN }));
+            expect(out).toBe(' — invalid_grant');
+            expect(out).not.toContain(ACCESS_TOKEN);
+        });
+    });
+    describe('is defensive about hostile or absent input', () => {
+        it('returns empty string for an absent body', () => {
+            expect(DescribeTokenEndpointFailure(undefined)).toBe('');
+            expect(DescribeTokenEndpointFailure(null)).toBe('');
+            expect(DescribeTokenEndpointFailure('')).toBe('');
+        });
+        it('caps an over-long description so a hostile endpoint cannot flood the log', () => {
+            const out = DescribeTokenEndpointFailure(JSON.stringify({ error_description: 'x'.repeat(5000) }));
+            expect(out.length).toBeLessThan(300);
+            expect(out.endsWith('…')).toBe(true);
+        });
+        it('withholds when the JSON body is not an object', () => {
+            expect(DescribeTokenEndpointFailure(JSON.stringify(ACCESS_TOKEN))).not.toContain(ACCESS_TOKEN);
+            expect(DescribeTokenEndpointFailure('null')).toBe(' — response body withheld (may contain credentials)');
+        });
+        it('ignores non-string error fields rather than coercing them', () => {
+            expect(DescribeTokenEndpointFailure(JSON.stringify({ error: { nested: ACCESS_TOKEN } })))
+                .not.toContain(ACCESS_TOKEN);
+        });
+    });
+});
+//# sourceMappingURL=TokenEndpointErrors.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TokenEndpointErrors.test.js","sourceRoot":"","sources":["../../src/__tests__/TokenEndpointErrors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE,qEAAqE;AACrE,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAC9C,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAC9C,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC1C,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACtD,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACtD,8EAA8E;YAC9E,8EAA8E;YAC9E,MAAM,GAAG,GAAG,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;YACnG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC1D,uEAAuE;YACvE,MAAM,GAAG,GAAG,4BAA4B,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,CAAC,CAC9F,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAChD,MAAM,GAAG,GAAG,4BAA4B,CAAC,sBAAsB,YAAY,SAAS,CAAC,CAAC;YACtF,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YAC/D,MAAM,GAAG,GAAG,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YACnF,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,+DAA+D,EAAE,GAAG,EAAE;QAC3E,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC7D,MAAM,GAAG,GAAG,4BAA4B,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,CAAC,CACjG,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;iBAC3E,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC3D,MAAM,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;iBACvF,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;YACpE,MAAM,GAAG,GAAG,4BAA4B,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CACzE,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACxD,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,4BAA4B,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,MAAM,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpD,MAAM,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;YAChF,MAAM,GAAG,GAAG,4BAA4B,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAC1D,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC/F,MAAM,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QAC7G,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACjE,MAAM,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;iBACpF,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACP,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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"}