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

package/README.md

@@ -515,6 +515,32 @@ IsValueEncrypted('plain text');                                    // false
 IsEncryptedSentinel('[!ENCRYPTED$]');                              // true
 ```
 
+### Binary Encoding
+
+Above the database, MemberJunction represents a binary column (`varbinary` / `binary` / `image`, PostgreSQL `bytea`) as a **base64 string** — in `BaseEntity` fields, caches, `RunView` rows and GraphQL alike. These helpers convert and validate it. The codec is picked once per process from the fastest the host offers (native `Uint8Array.fromBase64`/`toBase64`, Node `Buffer`, then `atob`/`btoa`); every codec accepts and produces the same strings. See the [Binary Fields Guide](../../guides/BINARY_FIELDS_GUIDE.md).
+
+| Function | Description |
+|---|---|
+| `BytesToBase64(bytes)` | Bytes to standard, padded base64 |
+| `Base64ToBytes(b64)` | Base64 to bytes; throws on invalid input |
+| `TryBase64ToBytes(b64)` | Same, but returns `null` for null/undefined or invalid input |
+| `IsValidBase64(value)` | Canonical base64 only: standard alphabet, optional padding, no whitespace, data-URI prefix or URL-safe alphabet |
+| `HasValidBase64Shape(value)` | Length/padding shape check only |
+| `Base64DecodedByteLength(b64)` | Decoded byte count without decoding (for size checks) |
+| `IsByteArray(value)` | True for a `Uint8Array` (including a Node `Buffer`) |
+| `ReplaceByteArraysWithBase64(row)` | Replaces top-level byte arrays in a row with base64; copy-on-write, never mutates the input |
+| `Float32VectorToBytes(values)` / `BytesToFloat32Vector(bytes)` | A vector as little-endian float32 bytes (4 per value, no header); decode returns `null` for empty or misaligned input |
+| `Float32VectorToBase64(values)` / `Base64ToFloat32Vector(b64)` | The same, as the base64 value stored in a binary vector field such as `VectorBinary` |
+| `GetBase64Codec()` / `Base64Codecs` | The codec in use / every available codec (diagnostics and tests) |
+
+```typescript
+import { Float32VectorToBase64, Base64ToFloat32Vector, TryBase64ToBytes } from '@memberjunction/global';
+
+doc.VectorBinary = Float32VectorToBase64(embedding);        // write
+const vector = Base64ToFloat32Vector(doc.VectorBinary);     // Float32Array | null
+const bytes = TryBase64ToBytes(file.Content);               // Uint8Array | null
+```
+
 ### String and JSON Utilities
 
 A collection of utility functions for common string and JSON operations.

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

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

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

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

package/dist/__tests__/BinaryEncoding.test.js

@@ -0,0 +1,244 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { BINARY_CHANGE_VALUE_PREFIX, FormatBinaryChangeValue, IsBinaryChangeValue, Base64Codecs, Base64ToBytes, Base64ToFloat32Vector, BytesToBase64, BytesToFloat32Vector, Float32VectorCodecs, Float32VectorToBase64, Float32VectorToBytes, GetBase64Codec, IsByteArray, IsValidBase64, TryBase64ToBytes, } from '../util/BinaryEncoding.js';
+/** Deterministic pseudo-random bytes, so failures reproduce. */
+function bytesOf(length, seed = 7) {
+    const out = new Uint8Array(length);
+    let s = seed;
+    for (let i = 0; i < length; i++) {
+        s = (s * 16807) % 2147483647;
+        out[i] = s & 0xff;
+    }
+    return out;
+}
+const [nativeCodec, nodeCodec, portableCodec] = Base64Codecs;
+/**
+ * Installs a stand-in for the TC39 `Uint8Array.fromBase64` / `toBase64` API (absent in Node 22)
+ * that records how it was called, so the native implementation can be exercised.
+ */
+function installNativeBase64() {
+    const calls = [];
+    const statics = Uint8Array;
+    const proto = Uint8Array.prototype;
+    statics.fromBase64 = (input, options) => {
+        calls.push(`fromBase64:${options?.lastChunkHandling ?? 'none'}`);
+        return new Uint8Array(Buffer.from(input, 'base64'));
+    };
+    proto.toBase64 = function () {
+        calls.push('toBase64');
+        return Buffer.from(this.buffer, this.byteOffset, this.byteLength).toString('base64');
+    };
+    return {
+        calls,
+        restore: () => {
+            delete statics.fromBase64;
+            delete proto.toBase64;
+        },
+    };
+}
+describe('IsValidBase64', () => {
+    it.each(['', 'AA==', 'AAA=', 'AAAA', 'AAAAAA', 'AQID', '+/+/', 'aGVsbG8='])('accepts %j', value => {
+        expect(IsValidBase64(value)).toBe(true);
+    });
+    it.each([
+        ['a single dangling character', 'A'],
+        ['five characters (one dangling)', 'AAAAA'],
+        ['whitespace', 'AA AA'],
+        ['a line break', 'AAAA\nAAAA'],
+        ['the URL-safe alphabet', 'AA-_'],
+        ['a data URI', 'data:image/png;base64,AAAA'],
+        ['padding before the end', 'AA=A'],
+        ['three padding characters', 'A==='],
+        ['padding on a partial quantum', 'AAAAA='],
+        ['non-ASCII', 'AAÀA'],
+    ])('rejects %s', (_label, value) => {
+        expect(IsValidBase64(value)).toBe(false);
+    });
+});
+describe('base64 implementations', () => {
+    afterEach(() => {
+        // Defensive: a failed test must not leave the stand-in installed for the next one.
+        delete Uint8Array.fromBase64;
+        delete Uint8Array.prototype.toBase64;
+    });
+    it('lists the native API first, then Node Buffer, then atob/btoa', () => {
+        expect(Base64Codecs.map(c => c.Name)).toEqual([
+            'Uint8Array.fromBase64 / toBase64',
+            'Node Buffer',
+            'atob / btoa',
+        ]);
+    });
+    it('detects the native API by duck typing', () => {
+        expect(nativeCodec.IsAvailable()).toBe(false); // Node 22 has no Uint8Array.fromBase64
+        const native = installNativeBase64();
+        expect(nativeCodec.IsAvailable()).toBe(true);
+        native.restore();
+        expect(nativeCodec.IsAvailable()).toBe(false);
+    });
+    it('selects Node Buffer on Node, and keeps that choice for the life of the process', () => {
+        expect(GetBase64Codec()).toBe(nodeCodec);
+        const native = installNativeBase64();
+        expect(GetBase64Codec()).toBe(nodeCodec); // selection is cached, not re-evaluated
+        native.restore();
+    });
+    it('calls the native API with loose final-chunk handling, so unpadded input decodes', () => {
+        const native = installNativeBase64();
+        expect(Array.from(nativeCodec.Decode('AQI'))).toEqual([1, 2]);
+        expect(nativeCodec.Encode(new Uint8Array([1, 2]))).toBe('AQI=');
+        expect(native.calls).toEqual(['fromBase64:loose', 'toBase64']);
+        native.restore();
+    });
+    it.each([0, 1, 2, 3, 4, 5, 255, 256, 1536 * 4, 0x8000 - 1, 0x8000, 0x8000 + 1, 200_000])('produces identical strings and bytes in every implementation for %i bytes', length => {
+        const native = installNativeBase64();
+        const bytes = bytesOf(length, length + 1);
+        const expected = Buffer.from(bytes).toString('base64');
+        for (const codec of Base64Codecs) {
+            expect(codec.Encode(bytes), codec.Name).toBe(expected);
+            expect(Array.from(codec.Decode(expected)), codec.Name).toEqual(Array.from(bytes));
+        }
+        native.restore();
+    });
+    it('encodes only the viewed range of a subarray in every implementation', () => {
+        const native = installNativeBase64();
+        const backing = bytesOf(64);
+        const view = backing.subarray(5, 21);
+        const expected = Buffer.from(view).toString('base64');
+        for (const codec of Base64Codecs)
+            expect(codec.Encode(view), codec.Name).toBe(expected);
+        native.restore();
+    });
+    it('returns bytes that own their buffer from the Node implementation, never a pooled view', () => {
+        const decoded = nodeCodec.Decode('AQID');
+        expect(decoded.byteOffset).toBe(0);
+        expect(decoded.buffer.byteLength).toBe(3);
+        expect(Buffer.isBuffer(decoded)).toBe(false);
+    });
+    it('reports the portable implementation as available wherever atob and btoa exist', () => {
+        expect(portableCodec.IsAvailable()).toBe(true);
+    });
+});
+describe('BytesToBase64 / Base64ToBytes', () => {
+    it('round-trips every byte value', () => {
+        const all = new Uint8Array(256).map((_, i) => i);
+        expect(Array.from(Base64ToBytes(BytesToBase64(all)))).toEqual(Array.from(all));
+    });
+    it('maps zero bytes to the empty string and back', () => {
+        expect(BytesToBase64(new Uint8Array(0))).toBe('');
+        expect(Base64ToBytes('').length).toBe(0);
+    });
+    it('accepts a Node Buffer as input', () => {
+        expect(BytesToBase64(Buffer.from([1, 2, 3]))).toBe('AQID');
+    });
+    it('decodes unpadded input the same as padded input', () => {
+        expect(Array.from(Base64ToBytes('AQI'))).toEqual(Array.from(Base64ToBytes('AQI=')));
+    });
+    it('throws on invalid input instead of guessing, unlike a lenient Buffer.from', () => {
+        expect(Buffer.from('AA AA', 'base64').length).toBeGreaterThan(0); // Node alone would accept this
+        expect(() => Base64ToBytes('AA AA')).toThrow('Invalid base64 value (length 5)');
+        expect(() => Base64ToBytes('A')).toThrow('Invalid base64');
+    });
+    it('returns null from TryBase64ToBytes for missing or invalid input', () => {
+        expect(TryBase64ToBytes(null)).toBeNull();
+        expect(TryBase64ToBytes(undefined)).toBeNull();
+        expect(TryBase64ToBytes('not base64!')).toBeNull();
+        expect(TryBase64ToBytes('')?.length).toBe(0);
+        expect(Array.from(TryBase64ToBytes('AQID') ?? [])).toEqual([1, 2, 3]);
+    });
+});
+describe('IsByteArray', () => {
+    it('recognises Uint8Array and Node Buffer, and nothing else', () => {
+        expect(IsByteArray(new Uint8Array(1))).toBe(true);
+        expect(IsByteArray(Buffer.from('x'))).toBe(true);
+        expect(IsByteArray('AQID')).toBe(false);
+        expect(IsByteArray(new Uint16Array(1))).toBe(false);
+        expect(IsByteArray(new ArrayBuffer(4))).toBe(false);
+        expect(IsByteArray(null)).toBe(false);
+        expect(IsByteArray({ type: 'Buffer', data: [1] })).toBe(false);
+    });
+});
+describe('float32 vectors', () => {
+    const sample = [0, 1, -1, 0.5, -2.25, 3.4028234663852886e38, 1e-45, Math.PI];
+    it('writes little-endian IEEE-754 single precision, 4 bytes per value, no header', () => {
+        const bytes = Float32VectorToBytes([1, -2]);
+        // 1.0f = 0x3F800000, -2.0f = 0xC0000000, least significant byte first
+        expect(Array.from(bytes)).toEqual([0x00, 0x00, 0x80, 0x3f, 0x00, 0x00, 0x00, 0xc0]);
+    });
+    it('produces identical bytes and values in both implementations', () => {
+        const [typedArray, dataView] = Float32VectorCodecs;
+        const expected = typedArray.Encode(sample);
+        expect(Array.from(dataView.Encode(sample))).toEqual(Array.from(expected));
+        expect(Array.from(dataView.Decode(expected))).toEqual(Array.from(typedArray.Decode(expected)));
+    });
+    it('round-trips through bytes and through base64, rounding to single precision', () => {
+        const expected = Array.from(Float32Array.from(sample));
+        expect(Array.from(BytesToFloat32Vector(Float32VectorToBytes(sample)) ?? [])).toEqual(expected);
+        expect(Array.from(Base64ToFloat32Vector(Float32VectorToBase64(sample)) ?? [])).toEqual(expected);
+        expect(Base64ToFloat32Vector(Float32VectorToBase64([0.1]))?.[0]).toBe(Math.fround(0.1));
+    });
+    it('accepts a Float32Array as input', () => {
+        const source = Float32Array.from([1.5, 2.5]);
+        expect(Array.from(BytesToFloat32Vector(Float32VectorToBytes(source)) ?? [])).toEqual([1.5, 2.5]);
+    });
+    it('preserves NaN and infinities, leaving validation to the caller', () => {
+        const decoded = Base64ToFloat32Vector(Float32VectorToBase64([NaN, Infinity, -Infinity]));
+        expect(Number.isNaN(decoded?.[0])).toBe(true);
+        expect(decoded?.[1]).toBe(Infinity);
+        expect(decoded?.[2]).toBe(-Infinity);
+    });
+    it('decodes from a misaligned view, such as a pooled Node Buffer, in both implementations', () => {
+        const encoded = Float32VectorToBytes([1, 2, 3]);
+        const backing = new Uint8Array(encoded.length + 1);
+        backing.set(encoded, 1);
+        const misaligned = backing.subarray(1); // byteOffset 1: a Float32Array view over it would throw
+        for (const codec of Float32VectorCodecs) {
+            expect(Array.from(codec.Decode(misaligned)), codec.Name).toEqual([1, 2, 3]);
+        }
+        expect(Array.from(BytesToFloat32Vector(misaligned) ?? [])).toEqual([1, 2, 3]);
+    });
+    it('returns a vector that owns its memory, so later writes to the source do not leak in', () => {
+        const bytes = Float32VectorToBytes([1, 2]);
+        const decoded = BytesToFloat32Vector(bytes);
+        bytes.fill(0);
+        expect(Array.from(decoded ?? [])).toEqual([1, 2]);
+    });
+    it.each([
+        ['null', null],
+        ['undefined', undefined],
+        ['zero bytes', new Uint8Array(0)],
+        ['6 bytes (not a whole number of values)', new Uint8Array(6)],
+        ['1 byte', new Uint8Array(1)],
+    ])('returns null for %s', (_label, bytes) => {
+        expect(BytesToFloat32Vector(bytes)).toBeNull();
+    });
+    it('returns null for a missing, invalid or truncated base64 vector', () => {
+        expect(Base64ToFloat32Vector(null)).toBeNull();
+        expect(Base64ToFloat32Vector('')).toBeNull();
+        expect(Base64ToFloat32Vector('%%%%')).toBeNull();
+        expect(Base64ToFloat32Vector(Buffer.from([1, 2, 3, 4, 5, 6]).toString('base64'))).toBeNull();
+    });
+    it('encodes an empty vector as zero bytes', () => {
+        expect(Float32VectorToBytes([]).length).toBe(0);
+        expect(Float32VectorToBase64([])).toBe('');
+    });
+});
+describe('FormatBinaryChangeValue / IsBinaryChangeValue (change-log text for a binary value)', () => {
+    it('reports the decoded size with a thousands separator, never the content', () => {
+        expect(FormatBinaryChangeValue('AQID')).toBe('[binary: 3 bytes]');
+        expect(FormatBinaryChangeValue('AQIDBA==')).toBe('[binary: 4 bytes]');
+        expect(FormatBinaryChangeValue('A'.repeat(8192))).toBe('[binary: 6,144 bytes]');
+        expect(FormatBinaryChangeValue('')).toBe('[binary: 0 bytes]');
+    });
+    it('reports invalid base64 as such instead of throwing', () => {
+        expect(FormatBinaryChangeValue('not base64!')).toBe('[binary: invalid base64]');
+        expect(FormatBinaryChangeValue('data:image/png;base64,AAAA')).toBe('[binary: invalid base64]');
+    });
+    it('recognises its own output and nothing else', () => {
+        expect(IsBinaryChangeValue(FormatBinaryChangeValue('AQID'))).toBe(true);
+        expect(IsBinaryChangeValue('[binary: invalid base64]')).toBe(true);
+        expect(IsBinaryChangeValue('AQID')).toBe(false);
+        expect(IsBinaryChangeValue('[binary')).toBe(false);
+        expect(IsBinaryChangeValue(null)).toBe(false);
+        expect(IsBinaryChangeValue(42)).toBe(false);
+        expect(FormatBinaryChangeValue('AQID').startsWith(BINARY_CHANGE_VALUE_PREFIX)).toBe(true);
+    });
+});
+//# sourceMappingURL=BinaryEncoding.test.js.map

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

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

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

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

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

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

package/dist/__tests__/BinaryEncodingRows.test.js

@@ -0,0 +1,146 @@
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import { Base64DecodedByteLength, Base64ToBytes, BytesToBase64, Float32VectorCodecs, FLOAT32_VECTOR_BYTES_PER_VALUE, ReplaceByteArraysWithBase64, } from '../util/BinaryEncoding.js';
+describe('Base64DecodedByteLength', () => {
+    it.each([
+        ['', 0],
+        ['AA==', 1],
+        ['AAA=', 2],
+        ['AAAA', 3],
+        ['AQID', 3],
+        ['AAAAAA==', 4],
+        ['aGVsbG8=', 5],
+    ])('reports %j as %i bytes', (value, expected) => {
+        expect(Base64DecodedByteLength(value)).toBe(expected);
+    });
+    it.each([
+        ['AA', 1],
+        ['AAA', 2],
+        ['AQI', 2],
+        ['AAAAAA', 4],
+    ])('handles unpadded %j as %i bytes', (value, expected) => {
+        expect(Base64DecodedByteLength(value)).toBe(expected);
+    });
+    it('agrees with the actual decoded length for every size 0..64, padded and unpadded', () => {
+        for (let length = 0; length <= 64; length++) {
+            const bytes = new Uint8Array(length).map((_, i) => (i * 31) & 0xff);
+            const padded = BytesToBase64(bytes);
+            const unpadded = padded.replace(/=+$/, '');
+            expect(Base64DecodedByteLength(padded), `padded ${length}`).toBe(length);
+            expect(Base64DecodedByteLength(unpadded), `unpadded ${length}`).toBe(length);
+            expect(Base64ToBytes(unpadded).length).toBe(length);
+        }
+    });
+    it('agrees with the decoded length of a large value without decoding it', () => {
+        const bytes = new Uint8Array(100_001);
+        expect(Base64DecodedByteLength(BytesToBase64(bytes))).toBe(100_001);
+    });
+});
+describe('ReplaceByteArraysWithBase64', () => {
+    it('returns the same object when the row has no byte arrays', () => {
+        const row = { ID: 'a', Name: 'x', Count: 3, Data: 'AQID', Missing: null, Nested: { inner: new Uint8Array([1]) } };
+        expect(ReplaceByteArraysWithBase64(row)).toBe(row);
+    });
+    it('returns the same object for an empty row', () => {
+        const row = {};
+        expect(ReplaceByteArraysWithBase64(row)).toBe(row);
+    });
+    it('replaces a Uint8Array value with base64 in a shallow copy', () => {
+        const bytes = new Uint8Array([1, 2, 3]);
+        const row = { ID: 'a', Data: bytes };
+        const result = ReplaceByteArraysWithBase64(row);
+        expect(result).not.toBe(row);
+        expect(result).toEqual({ ID: 'a', Data: 'AQID' });
+        expect(row.Data).toBe(bytes); // input untouched
+    });
+    it('replaces a Node Buffer value', () => {
+        const row = { Data: Buffer.from([1, 2, 3]) };
+        expect(ReplaceByteArraysWithBase64(row)).toEqual({ Data: 'AQID' });
+    });
+    it('replaces every byte array, copying only once, and keeps other values by reference', () => {
+        const nested = { a: 1 };
+        const row = {
+            First: new Uint8Array([255]),
+            Text: 'hello',
+            Nested: nested,
+            Second: Buffer.from([0, 0, 0]),
+            Empty: new Uint8Array(0),
+        };
+        const result = ReplaceByteArraysWithBase64(row);
+        expect(result).toEqual({ First: '/w==', Text: 'hello', Nested: nested, Second: 'AAAA', Empty: '' });
+        expect(result.Nested).toBe(nested);
+        expect(IsUint8(row.First)).toBe(true);
+        expect(IsUint8(row.Second)).toBe(true);
+    });
+    it('does not convert other typed arrays or ArrayBuffers', () => {
+        const u16 = new Uint16Array([1]);
+        const ab = new ArrayBuffer(2);
+        const row = { A: u16, B: ab };
+        expect(ReplaceByteArraysWithBase64(row)).toBe(row);
+    });
+    it('never mutates a frozen cache entry', () => {
+        const row = Object.freeze({ ID: 'x', Data: new Uint8Array([1, 2]) });
+        const result = ReplaceByteArraysWithBase64(row);
+        expect(result).toEqual({ ID: 'x', Data: 'AQI=' });
+        expect(Object.isFrozen(row)).toBe(true);
+        expect(row.Data).toBeInstanceOf(Uint8Array);
+        expect(Object.isFrozen(result)).toBe(false);
+    });
+    it('encodes only the viewed range of a subarray value', () => {
+        const backing = new Uint8Array([9, 1, 2, 3, 9]);
+        const row = { Data: backing.subarray(1, 4) };
+        expect(ReplaceByteArraysWithBase64(row).Data).toBe('AQID');
+    });
+    it('produces a value that survives JSON serialization as a string', () => {
+        const row = { Data: Buffer.from('hi') };
+        expect(JSON.parse(JSON.stringify(ReplaceByteArraysWithBase64(row)))).toEqual({ Data: 'aGk=' });
+    });
+});
+function IsUint8(value) {
+    return value instanceof Uint8Array;
+}
+describe('float32 vector codecs', () => {
+    it('uses 4 bytes per value', () => {
+        expect(FLOAT32_VECTOR_BYTES_PER_VALUE).toBe(4);
+    });
+    it('DataView implementation writes little-endian bytes explicitly', () => {
+        const dataView = Float32VectorCodecs[1];
+        expect(dataView.Name).toBe('DataView (any host)');
+        expect(Array.from(dataView.Encode([1, -2]))).toEqual([0x00, 0x00, 0x80, 0x3f, 0x00, 0x00, 0x00, 0xc0]);
+        expect(Array.from(dataView.Encode([]))).toEqual([]);
+    });
+    it('both implementations decode an empty-but-aligned buffer to an empty vector', () => {
+        for (const codec of Float32VectorCodecs) {
+            expect(codec.Decode(new Uint8Array(0)).length, codec.Name).toBe(0);
+        }
+    });
+});
+describe('GetBase64Codec selection on a bare host', () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.resetModules();
+    });
+    it('falls back to atob/btoa when Buffer is absent', async () => {
+        vi.stubGlobal('Buffer', undefined);
+        vi.resetModules();
+        // A fresh module instance is needed because the codec choice is cached per process.
+        const fresh = await import('../util/BinaryEncoding.js');
+        expect(fresh.GetBase64Codec().Name).toBe('atob / btoa');
+        expect(fresh.BytesToBase64(new Uint8Array([1, 2, 3]))).toBe('AQID');
+        expect(Array.from(fresh.Base64ToBytes('AQI'))).toEqual([1, 2]);
+        expect(fresh.ReplaceByteArraysWithBase64({ D: new Uint8Array([255]) })).toEqual({ D: '/w==' });
+    });
+    it('throws when the host offers no base64 implementation', async () => {
+        vi.stubGlobal('Buffer', undefined);
+        vi.stubGlobal('atob', undefined);
+        vi.stubGlobal('btoa', undefined);
+        vi.resetModules();
+        const fresh = await import('../util/BinaryEncoding.js');
+        expect(() => fresh.GetBase64Codec()).toThrow('No base64 implementation is available on this host');
+        expect(() => fresh.BytesToBase64(new Uint8Array([1]))).toThrow('No base64 implementation');
+        // Zero bytes and invalid input never reach a codec.
+        expect(fresh.BytesToBase64(new Uint8Array(0))).toBe('');
+        expect(fresh.Base64ToBytes('').length).toBe(0);
+        expect(fresh.TryBase64ToBytes('!!')).toBeNull();
+    });
+});
+//# sourceMappingURL=BinaryEncodingRows.test.js.map

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

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

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

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

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

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

package/dist/__tests__/BinaryEncodingValidation.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect } from 'vitest';
+import { Base64Codecs, BytesToBase64, HasValidBase64Shape, IsValidBase64 } from '../util/BinaryEncoding.js';
+/**
+ * Strict validation is enforced twice: by `IsValidBase64` (a character scan, used by codecs without a
+ * fused decoder) and by the Node codec's `TryDecode` (decode, then compare lengths — about five times
+ * cheaper). The two must agree on EVERY input, or the same value would be accepted on one host and
+ * refused on another. These tests pin that agreement, mostly by fuzzing.
+ */
+const nodeCodec = Base64Codecs.find(c => c.Name === 'Node Buffer');
+if (!nodeCodec?.TryDecode)
+    throw new Error('the Node Buffer codec must expose TryDecode');
+const tryDecode = (value) => nodeCodec.TryDecode(value);
+/** Deterministic PRNG so a failing fuzz case reproduces. */
+function mulberry32(seed) {
+    let a = seed;
+    return () => {
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+/** Characters a corrupted or foreign value might contain — URL-safe, whitespace, punctuation, non-ASCII. */
+const HOSTILE = ['=', '-', '_', ' ', '\n', '\t', '\r', '.', '!', '*', '"', '\\', 'é', '€', '\u0000', '😀'];
+describe('base64 validation: Node fused decode agrees with IsValidBase64', () => {
+    it.each([
+        ['', true],
+        ['AA==', true],
+        ['AAA=', true],
+        ['AAAA', true],
+        ['AAAAAA', true],
+        ['AAAAAAA', true],
+        ['A', false],
+        ['A===', false],
+        ['AA=', false],
+        ['=AAA', false],
+        ['AA==AAAA', false],
+        ['AA-A', false],
+        ['AA_A', false],
+        ['AA A', false],
+        ['AA\nA', false],
+        ['AAAA\n', false],
+        ['AAéA', false],
+        ['data:AAAA', false],
+    ])('%j → %s', (value, expected) => {
+        expect(IsValidBase64(value)).toBe(expected);
+        expect(tryDecode(value) !== null).toBe(expected);
+    });
+    it('decodes valid input to the same bytes the input encoded', () => {
+        const rand = mulberry32(7);
+        for (let n = 0; n < 300; n++) {
+            const bytes = Uint8Array.from({ length: n }, () => Math.floor(rand() * 256));
+            const encoded = BytesToBase64(bytes);
+            expect(Array.from(tryDecode(encoded) ?? [])).toEqual(Array.from(bytes));
+            expect(Array.from(tryDecode(encoded.replace(/=+$/, '')) ?? [])).toEqual(Array.from(bytes)); // unpadded
+        }
+    });
+    it('agrees on 20,000 random strings mixing valid and hostile characters', () => {
+        const rand = mulberry32(42);
+        let accepted = 0;
+        for (let n = 0; n < 20000; n++) {
+            const length = Math.floor(rand() * 24);
+            let value = '';
+            for (let i = 0; i < length; i++) {
+                value += rand() < 0.9 ? ALPHABET[Math.floor(rand() * ALPHABET.length)] : HOSTILE[Math.floor(rand() * HOSTILE.length)];
+            }
+            if (rand() < 0.3)
+                value += rand() < 0.5 ? '=' : '==';
+            const strict = IsValidBase64(value);
+            if (strict)
+                accepted++;
+            expect({ value, fused: tryDecode(value) !== null }).toEqual({ value, fused: strict });
+        }
+        expect(accepted).toBeGreaterThan(1000); // the corpus exercises the accept path too
+    });
+    it('agrees when one character of a valid string is corrupted, at every position', () => {
+        const encoded = BytesToBase64(Uint8Array.from({ length: 30 }, (_, i) => (i * 37) & 0xff));
+        for (let i = 0; i < encoded.length; i++) {
+            for (const bad of HOSTILE) {
+                const value = encoded.slice(0, i) + bad + encoded.slice(i + 1);
+                expect({ value, fused: tryDecode(value) !== null }).toEqual({ value, fused: IsValidBase64(value) });
+            }
+        }
+    });
+});
+describe('HasValidBase64Shape', () => {
+    it.each([
+        ['', true], ['AA', true], ['AAA', true], ['AAAA', true], ['AA==', true], ['AAA=', true],
+        ['A', false], ['AAAAA', false], ['AA=', false], ['A=', false],
+    ])('%j → %s (length and padding only, characters ignored)', (value, expected) => {
+        expect(HasValidBase64Shape(value)).toBe(expected);
+    });
+    it('does not inspect characters', () => {
+        expect(HasValidBase64Shape('!!!!')).toBe(true);
+    });
+});
+//# sourceMappingURL=BinaryEncodingValidation.test.js.map

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

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

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from './util/ResourcePatternUtils.js';
 export * from './util/UUIDUtils.js';
 export * from './util/CronUtils.js';
 export * from './util/SerializationUtils.js';
+export * from './util/BinaryEncoding.js';
 export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,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;AACtC,cAAc,wBAAwB,CAAA;AACtC,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,uBAAuB,CAAC;AACtC,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;AACtC,cAAc,wBAAwB,CAAA;AACtC,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

@@ -14,6 +14,7 @@ export * from './util/ResourcePatternUtils.js';
 export * from './util/UUIDUtils.js';
 export * from './util/CronUtils.js';
 export * from './util/SerializationUtils.js';
+export * from './util/BinaryEncoding.js';
 export * from './ValidationTypes.js';
 export * from './JSONValidator.js';
 export * from './SafeExpressionEvaluator.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAChE,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,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;AACtC,cAAc,wBAAwB,CAAA;AACtC,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,uBAAuB,CAAC;AACtC,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;AACtC,cAAc,wBAAwB,CAAA;AACtC,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/BinaryEncoding.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Binary encoding primitives shared by every MemberJunction tier.
+ *
+ * MemberJunction stores binary database columns (SQL Server `binary` / `varbinary` / `image`,
+ * PostgreSQL `bytea`) in `BaseEntity` and on the wire as **base64 strings**. A string keeps the
+ * value JSON-safe, so dirty tracking, Record Changes, the RunView caches, GraphQL and remote
+ * invalidation broadcasts all handle it without special cases. Code that needs the actual bytes
+ * converts at the edge with the functions in this module.
+ *
+ * Everything here is dependency-free and runs unchanged in browsers, Node and workers. Each
+ * conversion picks the fastest implementation the host offers:
+ *
+ * | Host | base64 → bytes | bytes → base64 |
+ * |---|---|---|
+ * | Browsers with the TC39 base64 API (Chrome 140+, Firefox 133+, Safari 18.2+) | `Uint8Array.fromBase64` | `Uint8Array.prototype.toBase64` |
+ * | Node.js | `Buffer.from(s, 'base64')` | `Buffer#toString('base64')` |
+ * | Anything else | `atob` | `btoa` (chunked) |
+ *
+ * The fast paths are detected by duck typing, once per process, so older browsers keep working.
+ * All three implementations accept and produce exactly the same strings, and the decoders
+ * validate input identically, so a value never decodes on one tier and fails on another.
+ *
+ * @module BinaryEncoding
+ */
+/**
+ * One way of converting between bytes and base64. Every implementation must accept and produce
+ * the same strings; {@link Base64Codecs} lists them so tests can prove that.
+ */
+export interface Base64Codec {
+    /** Human-readable name, used in diagnostics and tests. */
+    readonly Name: string;
+    /** True when the host supports this implementation. */
+    IsAvailable(): boolean;
+    /** Encodes bytes as standard, padded base64 (RFC 4648 §4). */
+    Encode(bytes: Uint8Array): string;
+    /**
+     * Decodes base64 that has already passed {@link IsValidBase64}. Implementations may assume
+     * valid input; the public functions validate first so every implementation fails the same way.
+     */
+    Decode(base64: string): Uint8Array;
+    /**
+     * Optional fused validate-and-decode: returns the bytes when `base64` passes
+     * {@link IsValidBase64}, else `null` — exactly the same accept/reject decision, made more cheaply
+     * than a separate character scan. Codecs without it are validated with {@link IsValidBase64}.
+     */
+    TryDecode?(base64: string): Uint8Array | null;
+}
+/**
+ * Every base64 implementation, fastest first. Exposed so tests can prove the implementations are
+ * interchangeable; application code should call {@link BytesToBase64} / {@link Base64ToBytes}.
+ */
+export declare const Base64Codecs: readonly Base64Codec[];
+/**
+ * Returns the fastest base64 implementation this host supports. The choice is made once and
+ * cached; it cannot change during a process's life.
+ *
+ * @throws Error when the host offers none of the implementations (no JavaScript host MJ supports).
+ */
+export declare function GetBase64Codec(): Base64Codec;
+/**
+ * True when `value` is canonical base64: the standard alphabet (`A–Z a–z 0–9 + /`), optional
+ * `=` padding, no whitespace, and a length that can encode whole bytes. The empty string is valid
+ * and decodes to zero bytes.
+ *
+ * @param value - The string to check.
+ */
+export declare function IsValidBase64(value: string): boolean;
+/**
+ * The length rules of canonical base64, without looking at the characters: a length that can
+ * encode whole bytes, and padding only on a full final quantum ("xx==" or "xxx="), never on a bare
+ * remainder. Part of {@link IsValidBase64}; exposed so a codec's fused validate-and-decode
+ * ({@link Base64Codec.TryDecode}) applies the same rules.
+ *
+ * @param value - The string to check.
+ */
+export declare function HasValidBase64Shape(value: string): boolean;
+/**
+ * Returns how many bytes a base64 string decodes to, without decoding it. Useful for size checks
+ * on large values. The input is assumed to be valid (see {@link IsValidBase64}); padding is
+ * optional.
+ *
+ * @param base64 - Canonical base64.
+ */
+export declare function Base64DecodedByteLength(base64: string): number;
+/** Prefix of the text recorded in a change log in place of a binary value. See {@link FormatBinaryChangeValue}. */
+export declare const BINARY_CHANGE_VALUE_PREFIX = "[binary:";
+/**
+ * The text a change log records, and change history shows, in place of a binary field's base64
+ * value: `[binary: 6,144 bytes]`. The bytes themselves stay in the record snapshot
+ * (`FullRecordJSON`), which restore reads; only the per-field diff (`ChangesJSON`) and its
+ * on-screen rendering use this, so a change to an embedding or a file is visible without carrying
+ * the content twice more per save. Invalid base64 is reported as such rather than thrown on.
+ *
+ * @param base64 - The field's value as held above the database.
+ */
+export declare function FormatBinaryChangeValue(base64: string): string;
+/** Whether `value` is text produced by {@link FormatBinaryChangeValue}, so it is shown as-is and never decoded. */
+export declare function IsBinaryChangeValue(value: unknown): value is string;
+/**
+ * Encodes bytes as standard, padded base64 using the fastest implementation the host offers.
+ *
+ * @param bytes - The bytes to encode. Any `Uint8Array` works, including a Node `Buffer` or a view
+ *   into a larger buffer; only the viewed range is encoded.
+ * @returns The base64 string; `''` for zero bytes.
+ */
+export declare function BytesToBase64(bytes: Uint8Array): string;
+/**
+ * Decodes base64 into a new `Uint8Array` that owns its own `ArrayBuffer` (offset 0, never a view
+ * into a shared pool), using the fastest implementation the host offers.
+ *
+ * @param base64 - Canonical base64 (see {@link IsValidBase64}); padding may be omitted.
+ * @returns The decoded bytes.
+ * @throws Error when `base64` is not valid base64. Use {@link TryBase64ToBytes} to get `null` instead.
+ */
+export declare function Base64ToBytes(base64: string): Uint8Array;
+/**
+ * Like {@link Base64ToBytes}, but returns `null` instead of throwing when the input is not a
+ * string or not valid base64. Convenient for reading a nullable binary entity field.
+ *
+ * @param base64 - The value to decode, typically a binary entity field (`string | null`).
+ */
+export declare function TryBase64ToBytes(base64: string | null | undefined): Uint8Array | null;
+/**
+ * True when `value` is a byte array: a `Uint8Array`, which includes a Node `Buffer`. Database
+ * drivers return binary columns this way; use it at the provider boundary to recognise values
+ * that must be converted to base64 before they reach a `BaseEntity`.
+ *
+ * @param value - Any value.
+ */
+export declare function IsByteArray(value: unknown): value is Uint8Array;
+/**
+ * Returns `row` with every top-level byte-array value replaced by its base64 string.
+ *
+ * Copy-on-write: when the row holds no byte arrays (the normal case, since the database providers
+ * already convert binary columns) the same object is returned untouched; otherwise a shallow copy
+ * is returned and the original — which may be a frozen cache entry — is never modified.
+ *
+ * Use it as a safety net wherever rows are serialized for a transport: `JSON.stringify` turns a
+ * Node `Buffer` into `{"type":"Buffer","data":[...]}` and GraphQL's `String` scalar rejects it.
+ *
+ * @param row - A data row.
+ */
+export declare function ReplaceByteArraysWithBase64<T extends Record<string, unknown>>(row: T): T;
+/**
+ * The byte layout MemberJunction uses for persisted embedding vectors: consecutive
+ * IEEE-754 single-precision values, little-endian, 4 bytes each, no header. The dimension count
+ * is `byteLength / 4`. This is the layout of a `Float32Array` on every little-endian host, which
+ * is every platform MemberJunction runs on; big-endian hosts are still handled correctly.
+ */
+export declare const FLOAT32_VECTOR_BYTES_PER_VALUE = 4;
+/**
+ * Converts between numbers and the {@link FLOAT32_VECTOR_BYTES_PER_VALUE little-endian float32}
+ * layout. Two implementations exist so the result is correct on any host:
+ * a typed-array copy (little-endian hosts) and an explicit `DataView` (any host).
+ */
+export interface Float32VectorCodec {
+    /** Human-readable name, used in tests. */
+    readonly Name: string;
+    /** Writes `values` as little-endian float32 bytes into a new array. */
+    Encode(values: ArrayLike<number>): Uint8Array;
+    /** Reads little-endian float32 bytes (length already checked to be a positive multiple of 4). */
+    Decode(bytes: Uint8Array): Float32Array;
+}
+/** Both float32 vector implementations. Exposed for tests; use the functions below instead. */
+export declare const Float32VectorCodecs: readonly Float32VectorCodec[];
+/**
+ * Encodes a vector as little-endian float32 bytes. Values are rounded to single precision, which
+ * is the precision embedding models produce; `NaN` and infinities are stored as-is.
+ *
+ * @param values - The vector, e.g. a `number[]` or a `Float32Array`.
+ * @returns A new byte array of `values.length × 4` bytes.
+ */
+export declare function Float32VectorToBytes(values: ArrayLike<number>): Uint8Array;
+/**
+ * Decodes little-endian float32 bytes into a new `Float32Array` that owns its memory.
+ *
+ * @param bytes - Bytes in the {@link FLOAT32_VECTOR_BYTES_PER_VALUE persisted vector layout}.
+ * @returns The vector, or `null` when `bytes` is empty or not a whole number of float32 values,
+ *   so a truncated or foreign value is treated as missing rather than misread.
+ */
+export declare function BytesToFloat32Vector(bytes: Uint8Array | null | undefined): Float32Array | null;
+/**
+ * Encodes a vector as base64 of its little-endian float32 bytes: the value stored in a binary
+ * vector entity field such as `VectorBinary`.
+ *
+ * @param values - The vector.
+ */
+export declare function Float32VectorToBase64(values: ArrayLike<number>): string;
+/**
+ * Decodes a binary vector entity field (base64 of little-endian float32 bytes).
+ *
+ * @param base64 - The field value; `null` / `undefined` are allowed.
+ * @returns The vector, or `null` when the value is missing, not valid base64, empty, or not a
+ *   whole number of float32 values. Callers usually fall back to a JSON copy of the vector.
+ */
+export declare function Base64ToFloat32Vector(base64: string | null | undefined): Float32Array | null;
+//# sourceMappingURL=BinaryEncoding.d.ts.map

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

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

package/dist/util/BinaryEncoding.js

@@ -0,0 +1,388 @@
+/**
+ * Binary encoding primitives shared by every MemberJunction tier.
+ *
+ * MemberJunction stores binary database columns (SQL Server `binary` / `varbinary` / `image`,
+ * PostgreSQL `bytea`) in `BaseEntity` and on the wire as **base64 strings**. A string keeps the
+ * value JSON-safe, so dirty tracking, Record Changes, the RunView caches, GraphQL and remote
+ * invalidation broadcasts all handle it without special cases. Code that needs the actual bytes
+ * converts at the edge with the functions in this module.
+ *
+ * Everything here is dependency-free and runs unchanged in browsers, Node and workers. Each
+ * conversion picks the fastest implementation the host offers:
+ *
+ * | Host | base64 → bytes | bytes → base64 |
+ * |---|---|---|
+ * | Browsers with the TC39 base64 API (Chrome 140+, Firefox 133+, Safari 18.2+) | `Uint8Array.fromBase64` | `Uint8Array.prototype.toBase64` |
+ * | Node.js | `Buffer.from(s, 'base64')` | `Buffer#toString('base64')` |
+ * | Anything else | `atob` | `btoa` (chunked) |
+ *
+ * The fast paths are detected by duck typing, once per process, so older browsers keep working.
+ * All three implementations accept and produce exactly the same strings, and the decoders
+ * validate input identically, so a value never decodes on one tier and fails on another.
+ *
+ * @module BinaryEncoding
+ */
+/**
+ * Lookup table over every UTF-16 code unit (64 KB, so the scan needs no range check): 1 for the standard base64 alphabet (`A–Z a–z 0–9 + /`),
+ * 0 otherwise. Data URIs, URL-safe base64 and MIME line breaks are deliberately rejected: binary
+ * columns only ever carry canonical base64. A table scan is used instead of a regular expression
+ * because validation runs on every decode, and on an 8 KB vector a regex costs about five times
+ * as much as the decode itself.
+ */
+/** Char code of the base64 padding character `=`. */
+const EQUALS_CODE = 0x3d;
+const BASE64_ALPHABET = (() => {
+    const table = new Uint8Array(0x10000);
+    const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+    for (let i = 0; i < alphabet.length; i++)
+        table[alphabet.charCodeAt(i)] = 1;
+    return table;
+})();
+/** `String.fromCharCode` argument count per call when building a binary string for `btoa`. */
+const BTOA_CHUNK = 0x8000;
+/** Reads a global by name without assuming any particular host typings. */
+function readGlobal(name) {
+    return Reflect.get(globalThis, name);
+}
+/** Native TC39 base64 support on `Uint8Array`, detected by duck typing. */
+const NativeCodec = {
+    Name: 'Uint8Array.fromBase64 / toBase64',
+    IsAvailable() {
+        return typeof Reflect.get(Uint8Array, 'fromBase64') === 'function'
+            && typeof Reflect.get(Uint8Array.prototype, 'toBase64') === 'function';
+    },
+    Encode(bytes) {
+        return bytes.toBase64();
+    },
+    Decode(base64) {
+        const fromBase64 = Reflect.get(Uint8Array, 'fromBase64');
+        return fromBase64.call(Uint8Array, base64, { lastChunkHandling: 'loose' });
+    },
+};
+/** Node's `Buffer`, which encodes and decodes in native code. */
+const NodeBufferCodec = {
+    Name: 'Node Buffer',
+    IsAvailable() {
+        return typeof readGlobal('Buffer')?.from === 'function';
+    },
+    Encode(bytes) {
+        const nodeBuffer = readGlobal('Buffer');
+        return nodeBuffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('base64');
+    },
+    Decode(base64) {
+        const nodeBuffer = readGlobal('Buffer');
+        const decoded = nodeBuffer.from(base64, 'base64');
+        // Copy out of Node's shared allocation pool: a pooled Buffer views a larger ArrayBuffer at
+        // an arbitrary offset, which typed-array views and transfers would otherwise trip over.
+        return new Uint8Array(decoded);
+    },
+    /**
+     * Validates by decoding. Node's decoder silently SKIPS characters outside the alphabet
+     * (whitespace, punctuation, non-ASCII) and stops at an early `=`, so any such character makes the
+     * output shorter than a canonical string of the same length decodes to — the length check rejects
+     * it. The one thing it accepts that canonical base64 does not is the URL-safe alphabet (`-`, `_`),
+     * rejected separately with a native `indexOf`. About five times cheaper than a JavaScript
+     * character scan on vector-sized values; fuzz-tested against {@link IsValidBase64}.
+     */
+    TryDecode(base64) {
+        if (!HasValidBase64Shape(base64))
+            return null;
+        if (base64.indexOf('-') !== -1 || base64.indexOf('_') !== -1)
+            return null;
+        if (base64.length === 0)
+            return new Uint8Array(0);
+        const decoded = this.Decode(base64);
+        return decoded.length === Base64DecodedByteLength(base64) ? decoded : null;
+    },
+};
+/** `atob` / `btoa`, available in every browser, worker and modern Node. */
+const PortableCodec = {
+    Name: 'atob / btoa',
+    IsAvailable() {
+        return typeof readGlobal('atob') === 'function' && typeof readGlobal('btoa') === 'function';
+    },
+    Encode(bytes) {
+        let binary = '';
+        for (let start = 0; start < bytes.length; start += BTOA_CHUNK) {
+            const chunk = bytes.subarray(start, Math.min(start + BTOA_CHUNK, bytes.length));
+            binary += String.fromCharCode(...chunk);
+        }
+        return btoa(binary);
+    },
+    Decode(base64) {
+        const binary = atob(base64);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++)
+            bytes[i] = binary.charCodeAt(i);
+        return bytes;
+    },
+};
+/**
+ * Every base64 implementation, fastest first. Exposed so tests can prove the implementations are
+ * interchangeable; application code should call {@link BytesToBase64} / {@link Base64ToBytes}.
+ */
+export const Base64Codecs = [NativeCodec, NodeBufferCodec, PortableCodec];
+let selectedCodec;
+/**
+ * Returns the fastest base64 implementation this host supports. The choice is made once and
+ * cached; it cannot change during a process's life.
+ *
+ * @throws Error when the host offers none of the implementations (no JavaScript host MJ supports).
+ */
+export function GetBase64Codec() {
+    const codec = findBase64Codec();
+    if (!codec)
+        throw new Error('No base64 implementation is available on this host');
+    return codec;
+}
+/** The selected codec, choosing it on first use; `undefined` when the host offers none. */
+function findBase64Codec() {
+    selectedCodec ??= Base64Codecs.find(codec => codec.IsAvailable());
+    return selectedCodec;
+}
+/**
+ * True when `value` is canonical base64: the standard alphabet (`A–Z a–z 0–9 + /`), optional
+ * `=` padding, no whitespace, and a length that can encode whole bytes. The empty string is valid
+ * and decodes to zero bytes.
+ *
+ * @param value - The string to check.
+ */
+export function IsValidBase64(value) {
+    if (!HasValidBase64Shape(value))
+        return false;
+    const dataLength = value.length - trailingPadding(value);
+    for (let i = 0; i < dataLength; i++) {
+        if (BASE64_ALPHABET[value.charCodeAt(i)] === 0)
+            return false;
+    }
+    return true;
+}
+/** Number of trailing `=` characters, counting at most two. */
+function trailingPadding(value) {
+    const length = value.length;
+    if (length === 0 || value.charCodeAt(length - 1) !== EQUALS_CODE)
+        return 0;
+    return length > 1 && value.charCodeAt(length - 2) === EQUALS_CODE ? 2 : 1;
+}
+/**
+ * The length rules of canonical base64, without looking at the characters: a length that can
+ * encode whole bytes, and padding only on a full final quantum ("xx==" or "xxx="), never on a bare
+ * remainder. Part of {@link IsValidBase64}; exposed so a codec's fused validate-and-decode
+ * ({@link Base64Codec.TryDecode}) applies the same rules.
+ *
+ * @param value - The string to check.
+ */
+export function HasValidBase64Shape(value) {
+    const length = value.length;
+    if (length % 4 === 1)
+        return false;
+    return trailingPadding(value) === 0 || length % 4 === 0;
+}
+/**
+ * Returns how many bytes a base64 string decodes to, without decoding it. Useful for size checks
+ * on large values. The input is assumed to be valid (see {@link IsValidBase64}); padding is
+ * optional.
+ *
+ * @param base64 - Canonical base64.
+ */
+export function Base64DecodedByteLength(base64) {
+    const padding = base64.endsWith('==') ? 2 : base64.endsWith('=') ? 1 : 0;
+    const dataChars = base64.length - padding;
+    return Math.floor((dataChars * 3) / 4);
+}
+/** Prefix of the text recorded in a change log in place of a binary value. See {@link FormatBinaryChangeValue}. */
+export const BINARY_CHANGE_VALUE_PREFIX = '[binary:';
+/**
+ * The text a change log records, and change history shows, in place of a binary field's base64
+ * value: `[binary: 6,144 bytes]`. The bytes themselves stay in the record snapshot
+ * (`FullRecordJSON`), which restore reads; only the per-field diff (`ChangesJSON`) and its
+ * on-screen rendering use this, so a change to an embedding or a file is visible without carrying
+ * the content twice more per save. Invalid base64 is reported as such rather than thrown on.
+ *
+ * @param base64 - The field's value as held above the database.
+ */
+export function FormatBinaryChangeValue(base64) {
+    if (!IsValidBase64(base64))
+        return `${BINARY_CHANGE_VALUE_PREFIX} invalid base64]`;
+    return `${BINARY_CHANGE_VALUE_PREFIX} ${Base64DecodedByteLength(base64).toLocaleString('en-US')} bytes]`;
+}
+/** Whether `value` is text produced by {@link FormatBinaryChangeValue}, so it is shown as-is and never decoded. */
+export function IsBinaryChangeValue(value) {
+    return typeof value === 'string' && value.startsWith(BINARY_CHANGE_VALUE_PREFIX) && value.endsWith(']');
+}
+/**
+ * Encodes bytes as standard, padded base64 using the fastest implementation the host offers.
+ *
+ * @param bytes - The bytes to encode. Any `Uint8Array` works, including a Node `Buffer` or a view
+ *   into a larger buffer; only the viewed range is encoded.
+ * @returns The base64 string; `''` for zero bytes.
+ */
+export function BytesToBase64(bytes) {
+    if (bytes.length === 0)
+        return '';
+    return GetBase64Codec().Encode(bytes);
+}
+/**
+ * Decodes base64 into a new `Uint8Array` that owns its own `ArrayBuffer` (offset 0, never a view
+ * into a shared pool), using the fastest implementation the host offers.
+ *
+ * @param base64 - Canonical base64 (see {@link IsValidBase64}); padding may be omitted.
+ * @returns The decoded bytes.
+ * @throws Error when `base64` is not valid base64. Use {@link TryBase64ToBytes} to get `null` instead.
+ */
+export function Base64ToBytes(base64) {
+    const bytes = decodeValidated(base64);
+    if (!bytes) {
+        throw new Error(`Invalid base64 value (length ${base64.length})`);
+    }
+    return bytes;
+}
+/**
+ * Validates and decodes in one step: the codec's fused {@link Base64Codec.TryDecode} when it has
+ * one, else {@link IsValidBase64} followed by a plain decode. `null` when invalid.
+ */
+function decodeValidated(base64) {
+    if (base64.length === 0)
+        return new Uint8Array(0);
+    const codec = findBase64Codec();
+    if (codec?.TryDecode)
+        return codec.TryDecode(base64);
+    // No fused decoder — or no codec at all, in which case invalid input still answers null and
+    // only a valid value reaches GetBase64Codec() and its "no implementation" error.
+    if (!IsValidBase64(base64))
+        return null;
+    return (codec ?? GetBase64Codec()).Decode(base64);
+}
+/**
+ * Like {@link Base64ToBytes}, but returns `null` instead of throwing when the input is not a
+ * string or not valid base64. Convenient for reading a nullable binary entity field.
+ *
+ * @param base64 - The value to decode, typically a binary entity field (`string | null`).
+ */
+export function TryBase64ToBytes(base64) {
+    return typeof base64 === 'string' ? decodeValidated(base64) : null;
+}
+/**
+ * True when `value` is a byte array: a `Uint8Array`, which includes a Node `Buffer`. Database
+ * drivers return binary columns this way; use it at the provider boundary to recognise values
+ * that must be converted to base64 before they reach a `BaseEntity`.
+ *
+ * @param value - Any value.
+ */
+export function IsByteArray(value) {
+    return value instanceof Uint8Array;
+}
+/**
+ * Returns `row` with every top-level byte-array value replaced by its base64 string.
+ *
+ * Copy-on-write: when the row holds no byte arrays (the normal case, since the database providers
+ * already convert binary columns) the same object is returned untouched; otherwise a shallow copy
+ * is returned and the original — which may be a frozen cache entry — is never modified.
+ *
+ * Use it as a safety net wherever rows are serialized for a transport: `JSON.stringify` turns a
+ * Node `Buffer` into `{"type":"Buffer","data":[...]}` and GraphQL's `String` scalar rejects it.
+ *
+ * @param row - A data row.
+ */
+export function ReplaceByteArraysWithBase64(row) {
+    let copy = null;
+    for (const key of Object.keys(row)) {
+        const value = row[key];
+        if (IsByteArray(value)) {
+            if (!copy)
+                copy = { ...row };
+            copy[key] = BytesToBase64(value);
+        }
+    }
+    return (copy ?? row);
+}
+/* ------------------------------------------------------------------------------------------ */
+/* Float32 vectors                                                                             */
+/* ------------------------------------------------------------------------------------------ */
+/**
+ * The byte layout MemberJunction uses for persisted embedding vectors: consecutive
+ * IEEE-754 single-precision values, little-endian, 4 bytes each, no header. The dimension count
+ * is `byteLength / 4`. This is the layout of a `Float32Array` on every little-endian host, which
+ * is every platform MemberJunction runs on; big-endian hosts are still handled correctly.
+ */
+export const FLOAT32_VECTOR_BYTES_PER_VALUE = 4;
+/** True when this host stores multi-byte numbers little-endian. */
+function hostIsLittleEndian() {
+    return new Uint8Array(new Uint32Array([1]).buffer)[0] === 1;
+}
+/** Typed-array copy; correct only on little-endian hosts. */
+const TypedArrayFloat32Codec = {
+    Name: 'typed array (little-endian host)',
+    Encode(values) {
+        return new Uint8Array(Float32Array.from(values).buffer);
+    },
+    Decode(bytes) {
+        // Copy first: the source may be a misaligned view (e.g. a pooled Node Buffer), and a
+        // Float32Array over it would also alias memory the caller does not own.
+        return new Float32Array(bytes.slice().buffer);
+    },
+};
+/** Explicit little-endian reads and writes; correct on every host. */
+const DataViewFloat32Codec = {
+    Name: 'DataView (any host)',
+    Encode(values) {
+        const bytes = new Uint8Array(values.length * FLOAT32_VECTOR_BYTES_PER_VALUE);
+        const view = new DataView(bytes.buffer);
+        for (let i = 0; i < values.length; i++)
+            view.setFloat32(i * FLOAT32_VECTOR_BYTES_PER_VALUE, values[i], true);
+        return bytes;
+    },
+    Decode(bytes) {
+        const count = bytes.byteLength / FLOAT32_VECTOR_BYTES_PER_VALUE;
+        const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+        const values = new Float32Array(count);
+        for (let i = 0; i < count; i++)
+            values[i] = view.getFloat32(i * FLOAT32_VECTOR_BYTES_PER_VALUE, true);
+        return values;
+    },
+};
+/** Both float32 vector implementations. Exposed for tests; use the functions below instead. */
+export const Float32VectorCodecs = [TypedArrayFloat32Codec, DataViewFloat32Codec];
+const float32Codec = hostIsLittleEndian() ? TypedArrayFloat32Codec : DataViewFloat32Codec;
+/**
+ * Encodes a vector as little-endian float32 bytes. Values are rounded to single precision, which
+ * is the precision embedding models produce; `NaN` and infinities are stored as-is.
+ *
+ * @param values - The vector, e.g. a `number[]` or a `Float32Array`.
+ * @returns A new byte array of `values.length × 4` bytes.
+ */
+export function Float32VectorToBytes(values) {
+    return float32Codec.Encode(values);
+}
+/**
+ * Decodes little-endian float32 bytes into a new `Float32Array` that owns its memory.
+ *
+ * @param bytes - Bytes in the {@link FLOAT32_VECTOR_BYTES_PER_VALUE persisted vector layout}.
+ * @returns The vector, or `null` when `bytes` is empty or not a whole number of float32 values,
+ *   so a truncated or foreign value is treated as missing rather than misread.
+ */
+export function BytesToFloat32Vector(bytes) {
+    if (!bytes || bytes.byteLength === 0 || bytes.byteLength % FLOAT32_VECTOR_BYTES_PER_VALUE !== 0)
+        return null;
+    return float32Codec.Decode(bytes);
+}
+/**
+ * Encodes a vector as base64 of its little-endian float32 bytes: the value stored in a binary
+ * vector entity field such as `VectorBinary`.
+ *
+ * @param values - The vector.
+ */
+export function Float32VectorToBase64(values) {
+    return BytesToBase64(Float32VectorToBytes(values));
+}
+/**
+ * Decodes a binary vector entity field (base64 of little-endian float32 bytes).
+ *
+ * @param base64 - The field value; `null` / `undefined` are allowed.
+ * @returns The vector, or `null` when the value is missing, not valid base64, empty, or not a
+ *   whole number of float32 values. Callers usually fall back to a JSON copy of the vector.
+ */
+export function Base64ToFloat32Vector(base64) {
+    return BytesToFloat32Vector(TryBase64ToBytes(base64));
+}
+//# sourceMappingURL=BinaryEncoding.js.map

package/dist/util/BinaryEncoding.js.map

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

package/package.json

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