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

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.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect, vi } from 'vitest';
-import { GetGlobalObjectStore, CleanJSON, SafeJSONParse, CleanAndParseJSON, CopyScalarsAndArrays, convertCamelCaseToHaveSpaces, createDisplayName, generatePluralName, getIrregularPlural, stripWhitespace, uuidv4, stripTrailingChars, replaceAllSpaces, IsOnlyTimezoneShift, EscapeHTML, HighlightSearchMatches, } from '../util.js';
+import { GetGlobalObjectStore, CleanJSON, SafeJSONParse, CleanAndParseJSON, CopyScalarsAndArrays, convertCamelCaseToHaveSpaces, createDisplayName, generatePluralName, getIrregularPlural, stripWhitespace, uuidv4, stripTrailingChars, replaceAllSpaces, IsOnlyTimezoneShift, EscapeHTML, EscapeSQLString, HighlightSearchMatches, } from '../util.js';
 describe('GetGlobalObjectStore', () => {
     it('should return a non-null object in Node environment', () => {
         const store = GetGlobalObjectStore();
@@ -18,6 +18,49 @@ describe('GetGlobalObjectStore', () => {
             delete store[testKey];
         }
     });
+    // The three cases above predate the memoised `typeof` probe and pass either way: they assert
+    // the result is non-null, defined, and writable. The ones below pin what actually changed.
+    it('resolves to Node\'s global object, not merely something non-null', () => {
+        expect(GetGlobalObjectStore()).toBe(global);
+    });
+    it('is memoised — every call returns the identical reference', () => {
+        const first = GetGlobalObjectStore();
+        const second = GetGlobalObjectStore();
+        expect(second).toBe(first);
+        expect(GetGlobalObjectStore()).toBe(first);
+    });
+    it('answers from the memo after the environment changes, by design', async () => {
+        // The environment is fixed at startup, which is what makes memoising sound. Stated as a test
+        // because it is the one surprise the memo introduces: a caller that installs a `window`
+        // mid-process still gets the answer computed on first call. If this ever needs to change,
+        // it is a deliberate decision, not an accident.
+        const before = GetGlobalObjectStore();
+        const g = globalThis;
+        g.window = { installed: 'later' };
+        try {
+            expect(GetGlobalObjectStore()).toBe(before);
+        }
+        finally {
+            delete g.window;
+        }
+    });
+    it('treats a declared-but-null window as absent and falls through to global', async () => {
+        // `typeof null === 'object'`, so a bare `typeof window !== 'undefined'` probe would accept a
+        // null window and memoise it as the store — permanently, for the life of the process. SSR
+        // shims that null out `window` exist in the wild, and MJ is embedded by callers whose
+        // environment we do not control. Needs a fresh module so the memo is unset.
+        const g = globalThis;
+        g.window = null;
+        vi.resetModules();
+        try {
+            const fresh = await import('../util.js');
+            expect(fresh.GetGlobalObjectStore()).toBe(global);
+        }
+        finally {
+            delete g.window;
+            vi.resetModules();
+        }
+    });
 });
 describe('CleanJSON', () => {
     it('should return null for null input', () => {
@@ -561,4 +604,22 @@ describe('HighlightSearchMatches', () => {
         expect(HighlightSearchMatches('<i>x</i>', '   ')).toBe('&lt;i&gt;x&lt;/i&gt;');
     });
 });
+describe('EscapeSQLString', () => {
+    it('escapes single quotes by doubling them', () => {
+        expect(EscapeSQLString("O'Brien")).toBe("O''Brien");
+        expect(EscapeSQLString("user's 'name'")).toBe("user''s ''name''");
+    });
+    it('strips null bytes to prevent injection', () => {
+        expect(EscapeSQLString("test\0injection")).toBe("testinjection");
+        expect(EscapeSQLString("user\0' OR '1'='1")).toBe("user'' OR ''1''=''1");
+    });
+    it('handles null and undefined safely', () => {
+        expect(EscapeSQLString(null)).toBe('');
+        expect(EscapeSQLString(undefined)).toBe('');
+    });
+    it('handles empty string and clean strings', () => {
+        expect(EscapeSQLString('')).toBe('');
+        expect(EscapeSQLString('plain.email@example.com')).toBe('plain.email@example.com');
+    });
+});
 //# sourceMappingURL=util.test.js.map