@adtrackify/at-service-common 5.0.7 → 5.1.2

package/dist/esm/__tests__/clients/cross-platform-compression.spec.js

@@ -1,330 +1,331 @@
-import * as zlib from 'zlib';
-import { promisify } from 'util';
-import { unbundleRecords } from '../../clients/generic/sqs-unbundle';
-import { decompressFromBase64 } from '../../utils/compression';
-import { CompressionAlgorithm } from '../../clients/generic/sqs-bundled-client.types';
-const gzip = promisify(zlib.gzip);
-const gunzip = promisify(zlib.gunzip);
-async function cfWorkerCompress(data) {
-    const stream = new CompressionStream('gzip');
-    const writer = stream.writable.getWriter();
-    await writer.write(data);
-    await writer.close();
-    const chunks = [];
-    const reader = stream.readable.getReader();
-    for (;;) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        chunks.push(value);
-    }
-    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-        result.set(chunk, offset);
-        offset += chunk.length;
-    }
-    return result;
-}
-function cfWorkerToBase64(bytes) {
-    let binary = '';
-    for (let i = 0; i < bytes.length; i++) {
-        binary += String.fromCharCode(bytes[i]);
-    }
-    return btoa(binary);
-}
-async function createCfWorkerBundledMessage(messageType, items) {
-    const json = JSON.stringify(items);
-    const encoder = new TextEncoder();
-    const uncompressed = encoder.encode(json);
-    const compressed = await cfWorkerCompress(uncompressed);
-    const base64 = cfWorkerToBase64(compressed);
-    const envelope = {
-        v: 1,
-        c: 'gzip',
-        n: items.length,
-        p: base64,
-        s: json.length,
-    };
-    return {
-        messageId: crypto.randomUUID(),
-        messageType,
-        messageTime: new Date().toISOString(),
-        messageBody: envelope,
-    };
-}
-function createSQSRecord(body, messageId) {
-    return {
-        messageId: messageId ?? crypto.randomUUID(),
-        receiptHandle: 'test-receipt-handle',
-        body,
-        attributes: {
-            ApproximateReceiveCount: '1',
-            SentTimestamp: Date.now().toString(),
-            SenderId: 'test-sender',
-            ApproximateFirstReceiveTimestamp: Date.now().toString(),
-        },
-        messageAttributes: {},
-        md5OfBody: 'test-md5',
-        eventSource: 'aws:sqs',
-        eventSourceARN: 'arn:aws:sqs:us-east-1:123456789:test-queue',
-        awsRegion: 'us-east-1',
-    };
-}
-const GOLDEN_ITEMS = [
-    { pixelId: 'px_golden_001', event: 'page_view', data: { url: 'https://example.com/test' } },
-    { pixelId: 'px_golden_002', event: 'purchase', data: { amount: 99.99, currency: 'USD' } },
-];
-const GOLDEN_GZIP_BASE64 = 'H4sIAAAAAAAACnXMvQrDIBhG4Xt5Z4lpN527dC6dShHRjyTgH0ZTS/DeS7YsXc+B57UjLY3c3UIiNTVFZymocbyAgTYK5eh6IrUt9AGD1UVD7qjZQWIuJa2Sc2raJ0eDiZ4XWgt6Z//k61mu2cx6pROsfazHE2IQgsHUnCmYLySejxt6f/8AfIEZO7MAAAA=';
-describe('Cross-Platform Compression Compatibility', () => {
-    describe('CompressionStream (CF Worker) → zlib.gunzip (Lambda)', () => {
-        it('basic payload round-trips correctly', async () => {
-            const originalData = { pixelId: 'px_test', event: 'page_view' };
-            const json = JSON.stringify([originalData]);
-            const compressed = await cfWorkerCompress(new TextEncoder().encode(json));
-            expect(compressed[0]).toBe(0x1f);
-            expect(compressed[1]).toBe(0x8b);
-            const decompressed = await gunzip(Buffer.from(compressed));
-            const parsed = JSON.parse(decompressed.toString('utf8'));
-            expect(parsed).toEqual([originalData]);
-        });
-        it('CompressionStream output is valid GZIP decompressible by at-service-common', async () => {
-            const items = [{ pixelId: 'px_001' }, { pixelId: 'px_002' }];
-            const json = JSON.stringify(items);
-            const compressed = await cfWorkerCompress(new TextEncoder().encode(json));
-            const base64 = cfWorkerToBase64(compressed);
-            const result = await decompressFromBase64(base64, CompressionAlgorithm.GZIP);
-            expect(result).toEqual(items);
-        });
-        it('unbundleRecords handles CF Worker compressed messages', async () => {
-            const items = [
-                { pixelId: 'px_cfworker_001', event: 'PageView' },
-                { pixelId: 'px_cfworker_002', event: 'AddToCart' },
-            ];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toHaveLength(2);
-            expect(result.failedMessageIds).toHaveLength(0);
-            expect(result.items).toEqual(items);
-        });
-    });
-    describe('Node zlib.gzip → zlib.gunzip (baseline)', () => {
-        it('Node gzip/gunzip round-trips correctly', async () => {
-            const original = { test: 'data', number: 123 };
-            const json = JSON.stringify(original);
-            const compressed = await gzip(Buffer.from(json, 'utf8'));
-            const decompressed = await gunzip(compressed);
-            expect(JSON.parse(decompressed.toString('utf8'))).toEqual(original);
-        });
-        it('Node gzip output is decompressible by at-service-common', async () => {
-            const items = [{ id: 1 }, { id: 2 }];
-            const json = JSON.stringify(items);
-            const compressed = await gzip(Buffer.from(json, 'utf8'));
-            const base64 = compressed.toString('base64');
-            const result = await decompressFromBase64(base64, CompressionAlgorithm.GZIP);
-            expect(result).toEqual(items);
-        });
-    });
-    describe('Golden Payload Compatibility', () => {
-        it('golden payload from at-cf-tracking-api is decompressible', async () => {
-            const result = await decompressFromBase64(GOLDEN_GZIP_BASE64, CompressionAlgorithm.GZIP);
-            expect(result).toEqual(GOLDEN_ITEMS);
-        });
-        it('golden payload works through full unbundleRecords path', async () => {
-            const envelope = {
-                v: 1,
-                c: 'gzip',
-                n: GOLDEN_ITEMS.length,
-                p: GOLDEN_GZIP_BASE64,
-                s: 179,
-            };
-            const wrapped = {
-                messageId: 'golden-test-id',
-                messageType: 'TRACKING_EVENT_COLLECT',
-                messageTime: new Date().toISOString(),
-                messageBody: envelope,
-            };
-            const sqsRecord = createSQSRecord(JSON.stringify(wrapped));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toEqual(GOLDEN_ITEMS);
-            expect(result.stats.bundledSqsRecords).toBe(1);
-        });
-        it('CompressionStream output matches zlib output content', async () => {
-            const json = JSON.stringify(GOLDEN_ITEMS);
-            const cfCompressed = await cfWorkerCompress(new TextEncoder().encode(json));
-            const nodeCompressed = await gzip(Buffer.from(json, 'utf8'));
-            const cfDecompressed = await gunzip(Buffer.from(cfCompressed));
-            const nodeDecompressed = await gunzip(nodeCompressed);
-            expect(cfDecompressed.toString('utf8')).toBe(json);
-            expect(nodeDecompressed.toString('utf8')).toBe(json);
-            expect(cfDecompressed.toString('utf8')).toBe(nodeDecompressed.toString('utf8'));
-        });
-    });
-    describe('Unicode and Special Characters', () => {
-        it('emoji and CJK characters survive CF Worker compression round-trip', async () => {
-            const unicodeItems = [
-                { pixelId: 'px_emoji', event: '🎉_celebration', data: { message: 'Success! 🚀✨' } },
-                { pixelId: 'px_cjk', event: 'page_view', data: { title: '中文页面标题', description: '日本語の説明' } },
-                { pixelId: 'px_rtl', event: 'page_view', data: { title: 'مرحبا بالعالم', content: 'שלום עולם' } },
-            ];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', unicodeItems);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toHaveLength(3);
-            expect(result.items).toEqual(unicodeItems);
-            const item0 = result.items[0];
-            const item1 = result.items[1];
-            const item2 = result.items[2];
-            expect(item0.event).toBe('🎉_celebration');
-            expect(item0.data.message).toBe('Success! 🚀✨');
-            expect(item1.data.title).toBe('中文页面标题');
-            expect(item2.data.title).toBe('مرحبا بالعالم');
-        });
-        it('special characters in JSON survive round-trip', async () => {
-            const specialItems = [
-                { pixelId: 'px_special', data: { name: 'O\'Brien & Co.', note: 'Line1\nLine2\tTabbed' } },
-                { pixelId: 'px_quotes', data: { text: 'He said "hello"', escaped: '\\backslash' } },
-            ];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', specialItems);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toEqual(specialItems);
-        });
-    });
-    describe('Large Payload Handling', () => {
-        it('100 items compressed by CF Worker decompresses correctly', async () => {
-            const items = Array.from({ length: 100 }, (_, i) => ({
-                pixelId: `px_${i.toString().padStart(4, '0')}`,
-                event: i % 2 === 0 ? 'page_view' : 'purchase',
-                timestamp: new Date(Date.now() - i * 1000).toISOString(),
-            }));
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toHaveLength(100);
-            expect(result.items).toEqual(items);
-        });
-        it('deeply nested objects survive compression', async () => {
-            const nestedItems = [
-                {
-                    pixelId: 'px_nested',
-                    data: {
-                        level1: {
-                            level2: {
-                                level3: {
-                                    level4: {
-                                        value: 'deep value',
-                                        array: [1, 2, 3, { nested: true }],
-                                    },
-                                },
-                            },
-                        },
-                    },
-                },
-            ];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', nestedItems);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toEqual(nestedItems);
-            const item = result.items[0];
-            expect(item.data.level1.level2.level3.level4.value).toBe('deep value');
-        });
-    });
-    describe('Edge Cases', () => {
-        it('empty array compresses/decompresses correctly', async () => {
-            const items = [];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toHaveLength(0);
-            expect(result.failedMessageIds).toHaveLength(0);
-        });
-        it('single item compresses/decompresses correctly', async () => {
-            const items = [{ pixelId: 'px_single' }];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toEqual(items);
-        });
-        it('null and undefined values in objects preserved', async () => {
-            const items = [
-                { pixelId: 'px_nulls', value: null, nested: { alsoNull: null } },
-                { pixelId: 'px_zero', count: 0, price: 0.0 },
-                { pixelId: 'px_empty', name: '', items: [] },
-                { pixelId: 'px_bool', enabled: false, disabled: true },
-            ];
-            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
-            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
-            const result = await unbundleRecords([sqsRecord]);
-            expect(result.items).toEqual(items);
-            const item0 = result.items[0];
-            const item1 = result.items[1];
-            const item2 = result.items[2];
-            const item3 = result.items[3];
-            expect(item0.value).toBeNull();
-            expect(item0?.nested?.alsoNull).toBeNull();
-            expect(item1.count).toBe(0);
-            expect(item1.price).toBe(0.0);
-            expect(item2.name).toBe('');
-            expect(item2.items).toEqual([]);
-            expect(item3.enabled).toBe(false);
-            expect(item3.disabled).toBe(true);
-        });
-    });
-    describe('GZIP Header Validation', () => {
-        it('CF Worker compression produces valid GZIP header', async () => {
-            const data = new TextEncoder().encode('test data');
-            const compressed = await cfWorkerCompress(data);
-            expect(compressed[0]).toBe(0x1f);
-            expect(compressed[1]).toBe(0x8b);
-            expect(compressed[2]).toBe(8);
-        });
-        it('Node zlib compression produces valid GZIP header', async () => {
-            const compressed = await gzip(Buffer.from('test data', 'utf8'));
-            expect(compressed[0]).toBe(0x1f);
-            expect(compressed[1]).toBe(0x8b);
-            expect(compressed[2]).toBe(8);
-        });
-    });
-    describe('Mixed Batch Processing', () => {
-        it('handles mix of CF Worker compressed and Node compressed records', async () => {
-            const cfItems = [{ pixelId: 'px_cf_001' }, { pixelId: 'px_cf_002' }];
-            const cfMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', cfItems);
-            const nodeItems = [{ pixelId: 'px_node_001' }];
-            const nodeJson = JSON.stringify(nodeItems);
-            const nodeCompressed = await gzip(Buffer.from(nodeJson, 'utf8'));
-            const nodeEnvelope = {
-                v: 1,
-                c: 'gzip',
-                n: 1,
-                p: nodeCompressed.toString('base64'),
-                s: nodeJson.length,
-            };
-            const nodeMessage = {
-                messageId: crypto.randomUUID(),
-                messageType: 'TRACKING_EVENT_COLLECT',
-                messageTime: new Date().toISOString(),
-                messageBody: nodeEnvelope,
-            };
-            const legacyItem = { pixelId: 'px_legacy' };
-            const records = [
-                createSQSRecord(JSON.stringify(cfMessage), 'msg-cf'),
-                createSQSRecord(JSON.stringify(nodeMessage), 'msg-node'),
-                createSQSRecord(JSON.stringify(legacyItem), 'msg-legacy'),
-            ];
-            const result = await unbundleRecords(records);
-            expect(result.items).toHaveLength(4);
-            expect(result.failedMessageIds).toHaveLength(0);
-            expect(result.stats.bundledSqsRecords).toBe(2);
-            expect(result.stats.legacySqsRecords).toBe(1);
-            const pixelIds = result.items.map((item) => item.pixelId);
-            expect(pixelIds).toContain('px_cf_001');
-            expect(pixelIds).toContain('px_cf_002');
-            expect(pixelIds).toContain('px_node_001');
-            expect(pixelIds).toContain('px_legacy');
-        });
-    });
-});
+import { describe, it, expect } from 'vitest';
+import * as zlib from 'zlib';
+import { promisify } from 'util';
+import { unbundleRecords } from '../../clients/generic/sqs-unbundle';
+import { decompressFromBase64 } from '../../utils/compression';
+import { CompressionAlgorithm } from '../../clients/generic/sqs-bundled-client.types';
+const gzip = promisify(zlib.gzip);
+const gunzip = promisify(zlib.gunzip);
+async function cfWorkerCompress(data) {
+    const stream = new CompressionStream('gzip');
+    const writer = stream.writable.getWriter();
+    await writer.write(data);
+    await writer.close();
+    const chunks = [];
+    const reader = stream.readable.getReader();
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+    }
+    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+function cfWorkerToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+async function createCfWorkerBundledMessage(messageType, items) {
+    const json = JSON.stringify(items);
+    const encoder = new TextEncoder();
+    const uncompressed = encoder.encode(json);
+    const compressed = await cfWorkerCompress(uncompressed);
+    const base64 = cfWorkerToBase64(compressed);
+    const envelope = {
+        v: 1,
+        c: 'gzip',
+        n: items.length,
+        p: base64,
+        s: json.length,
+    };
+    return {
+        messageId: crypto.randomUUID(),
+        messageType,
+        messageTime: new Date().toISOString(),
+        messageBody: envelope,
+    };
+}
+function createSQSRecord(body, messageId) {
+    return {
+        messageId: messageId ?? crypto.randomUUID(),
+        receiptHandle: 'test-receipt-handle',
+        body,
+        attributes: {
+            ApproximateReceiveCount: '1',
+            SentTimestamp: Date.now().toString(),
+            SenderId: 'test-sender',
+            ApproximateFirstReceiveTimestamp: Date.now().toString(),
+        },
+        messageAttributes: {},
+        md5OfBody: 'test-md5',
+        eventSource: 'aws:sqs',
+        eventSourceARN: 'arn:aws:sqs:us-east-1:123456789:test-queue',
+        awsRegion: 'us-east-1',
+    };
+}
+const GOLDEN_ITEMS = [
+    { pixelId: 'px_golden_001', event: 'page_view', data: { url: 'https://example.com/test' } },
+    { pixelId: 'px_golden_002', event: 'purchase', data: { amount: 99.99, currency: 'USD' } },
+];
+const GOLDEN_GZIP_BASE64 = 'H4sIAAAAAAAACnXMvQrDIBhG4Xt5Z4lpN527dC6dShHRjyTgH0ZTS/DeS7YsXc+B57UjLY3c3UIiNTVFZymocbyAgTYK5eh6IrUt9AGD1UVD7qjZQWIuJa2Sc2raJ0eDiZ4XWgt6Z//k61mu2cx6pROsfazHE2IQgsHUnCmYLySejxt6f/8AfIEZO7MAAAA=';
+describe('Cross-Platform Compression Compatibility', () => {
+    describe('CompressionStream (CF Worker) → zlib.gunzip (Lambda)', () => {
+        it('basic payload round-trips correctly', async () => {
+            const originalData = { pixelId: 'px_test', event: 'page_view' };
+            const json = JSON.stringify([originalData]);
+            const compressed = await cfWorkerCompress(new TextEncoder().encode(json));
+            expect(compressed[0]).toBe(0x1f);
+            expect(compressed[1]).toBe(0x8b);
+            const decompressed = await gunzip(Buffer.from(compressed));
+            const parsed = JSON.parse(decompressed.toString('utf8'));
+            expect(parsed).toEqual([originalData]);
+        });
+        it('CompressionStream output is valid GZIP decompressible by at-service-common', async () => {
+            const items = [{ pixelId: 'px_001' }, { pixelId: 'px_002' }];
+            const json = JSON.stringify(items);
+            const compressed = await cfWorkerCompress(new TextEncoder().encode(json));
+            const base64 = cfWorkerToBase64(compressed);
+            const result = await decompressFromBase64(base64, CompressionAlgorithm.GZIP);
+            expect(result).toEqual(items);
+        });
+        it('unbundleRecords handles CF Worker compressed messages', async () => {
+            const items = [
+                { pixelId: 'px_cfworker_001', event: 'PageView' },
+                { pixelId: 'px_cfworker_002', event: 'AddToCart' },
+            ];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toHaveLength(2);
+            expect(result.failedMessageIds).toHaveLength(0);
+            expect(result.items).toEqual(items);
+        });
+    });
+    describe('Node zlib.gzip → zlib.gunzip (baseline)', () => {
+        it('Node gzip/gunzip round-trips correctly', async () => {
+            const original = { test: 'data', number: 123 };
+            const json = JSON.stringify(original);
+            const compressed = await gzip(Buffer.from(json, 'utf8'));
+            const decompressed = await gunzip(compressed);
+            expect(JSON.parse(decompressed.toString('utf8'))).toEqual(original);
+        });
+        it('Node gzip output is decompressible by at-service-common', async () => {
+            const items = [{ id: 1 }, { id: 2 }];
+            const json = JSON.stringify(items);
+            const compressed = await gzip(Buffer.from(json, 'utf8'));
+            const base64 = compressed.toString('base64');
+            const result = await decompressFromBase64(base64, CompressionAlgorithm.GZIP);
+            expect(result).toEqual(items);
+        });
+    });
+    describe('Golden Payload Compatibility', () => {
+        it('golden payload from at-cf-tracking-api is decompressible', async () => {
+            const result = await decompressFromBase64(GOLDEN_GZIP_BASE64, CompressionAlgorithm.GZIP);
+            expect(result).toEqual(GOLDEN_ITEMS);
+        });
+        it('golden payload works through full unbundleRecords path', async () => {
+            const envelope = {
+                v: 1,
+                c: 'gzip',
+                n: GOLDEN_ITEMS.length,
+                p: GOLDEN_GZIP_BASE64,
+                s: 179,
+            };
+            const wrapped = {
+                messageId: 'golden-test-id',
+                messageType: 'TRACKING_EVENT_COLLECT',
+                messageTime: new Date().toISOString(),
+                messageBody: envelope,
+            };
+            const sqsRecord = createSQSRecord(JSON.stringify(wrapped));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toEqual(GOLDEN_ITEMS);
+            expect(result.stats.bundledSqsRecords).toBe(1);
+        });
+        it('CompressionStream output matches zlib output content', async () => {
+            const json = JSON.stringify(GOLDEN_ITEMS);
+            const cfCompressed = await cfWorkerCompress(new TextEncoder().encode(json));
+            const nodeCompressed = await gzip(Buffer.from(json, 'utf8'));
+            const cfDecompressed = await gunzip(Buffer.from(cfCompressed));
+            const nodeDecompressed = await gunzip(nodeCompressed);
+            expect(cfDecompressed.toString('utf8')).toBe(json);
+            expect(nodeDecompressed.toString('utf8')).toBe(json);
+            expect(cfDecompressed.toString('utf8')).toBe(nodeDecompressed.toString('utf8'));
+        });
+    });
+    describe('Unicode and Special Characters', () => {
+        it('emoji and CJK characters survive CF Worker compression round-trip', async () => {
+            const unicodeItems = [
+                { pixelId: 'px_emoji', event: '🎉_celebration', data: { message: 'Success! 🚀✨' } },
+                { pixelId: 'px_cjk', event: 'page_view', data: { title: '中文页面标题', description: '日本語の説明' } },
+                { pixelId: 'px_rtl', event: 'page_view', data: { title: 'مرحبا بالعالم', content: 'שלום עולם' } },
+            ];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', unicodeItems);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toHaveLength(3);
+            expect(result.items).toEqual(unicodeItems);
+            const item0 = result.items[0];
+            const item1 = result.items[1];
+            const item2 = result.items[2];
+            expect(item0.event).toBe('🎉_celebration');
+            expect(item0.data.message).toBe('Success! 🚀✨');
+            expect(item1.data.title).toBe('中文页面标题');
+            expect(item2.data.title).toBe('مرحبا بالعالم');
+        });
+        it('special characters in JSON survive round-trip', async () => {
+            const specialItems = [
+                { pixelId: 'px_special', data: { name: 'O\'Brien & Co.', note: 'Line1\nLine2\tTabbed' } },
+                { pixelId: 'px_quotes', data: { text: 'He said "hello"', escaped: '\\backslash' } },
+            ];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', specialItems);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toEqual(specialItems);
+        });
+    });
+    describe('Large Payload Handling', () => {
+        it('100 items compressed by CF Worker decompresses correctly', async () => {
+            const items = Array.from({ length: 100 }, (_, i) => ({
+                pixelId: `px_${i.toString().padStart(4, '0')}`,
+                event: i % 2 === 0 ? 'page_view' : 'purchase',
+                timestamp: new Date(Date.now() - i * 1000).toISOString(),
+            }));
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toHaveLength(100);
+            expect(result.items).toEqual(items);
+        });
+        it('deeply nested objects survive compression', async () => {
+            const nestedItems = [
+                {
+                    pixelId: 'px_nested',
+                    data: {
+                        level1: {
+                            level2: {
+                                level3: {
+                                    level4: {
+                                        value: 'deep value',
+                                        array: [1, 2, 3, { nested: true }],
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            ];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', nestedItems);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toEqual(nestedItems);
+            const item = result.items[0];
+            expect(item.data.level1.level2.level3.level4.value).toBe('deep value');
+        });
+    });
+    describe('Edge Cases', () => {
+        it('empty array compresses/decompresses correctly', async () => {
+            const items = [];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toHaveLength(0);
+            expect(result.failedMessageIds).toHaveLength(0);
+        });
+        it('single item compresses/decompresses correctly', async () => {
+            const items = [{ pixelId: 'px_single' }];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toEqual(items);
+        });
+        it('null and undefined values in objects preserved', async () => {
+            const items = [
+                { pixelId: 'px_nulls', value: null, nested: { alsoNull: null } },
+                { pixelId: 'px_zero', count: 0, price: 0.0 },
+                { pixelId: 'px_empty', name: '', items: [] },
+                { pixelId: 'px_bool', enabled: false, disabled: true },
+            ];
+            const bundledMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', items);
+            const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
+            const result = await unbundleRecords([sqsRecord]);
+            expect(result.items).toEqual(items);
+            const item0 = result.items[0];
+            const item1 = result.items[1];
+            const item2 = result.items[2];
+            const item3 = result.items[3];
+            expect(item0.value).toBeNull();
+            expect(item0?.nested?.alsoNull).toBeNull();
+            expect(item1.count).toBe(0);
+            expect(item1.price).toBe(0.0);
+            expect(item2.name).toBe('');
+            expect(item2.items).toEqual([]);
+            expect(item3.enabled).toBe(false);
+            expect(item3.disabled).toBe(true);
+        });
+    });
+    describe('GZIP Header Validation', () => {
+        it('CF Worker compression produces valid GZIP header', async () => {
+            const data = new TextEncoder().encode('test data');
+            const compressed = await cfWorkerCompress(data);
+            expect(compressed[0]).toBe(0x1f);
+            expect(compressed[1]).toBe(0x8b);
+            expect(compressed[2]).toBe(8);
+        });
+        it('Node zlib compression produces valid GZIP header', async () => {
+            const compressed = await gzip(Buffer.from('test data', 'utf8'));
+            expect(compressed[0]).toBe(0x1f);
+            expect(compressed[1]).toBe(0x8b);
+            expect(compressed[2]).toBe(8);
+        });
+    });
+    describe('Mixed Batch Processing', () => {
+        it('handles mix of CF Worker compressed and Node compressed records', async () => {
+            const cfItems = [{ pixelId: 'px_cf_001' }, { pixelId: 'px_cf_002' }];
+            const cfMessage = await createCfWorkerBundledMessage('TRACKING_EVENT_COLLECT', cfItems);
+            const nodeItems = [{ pixelId: 'px_node_001' }];
+            const nodeJson = JSON.stringify(nodeItems);
+            const nodeCompressed = await gzip(Buffer.from(nodeJson, 'utf8'));
+            const nodeEnvelope = {
+                v: 1,
+                c: 'gzip',
+                n: 1,
+                p: nodeCompressed.toString('base64'),
+                s: nodeJson.length,
+            };
+            const nodeMessage = {
+                messageId: crypto.randomUUID(),
+                messageType: 'TRACKING_EVENT_COLLECT',
+                messageTime: new Date().toISOString(),
+                messageBody: nodeEnvelope,
+            };
+            const legacyItem = { pixelId: 'px_legacy' };
+            const records = [
+                createSQSRecord(JSON.stringify(cfMessage), 'msg-cf'),
+                createSQSRecord(JSON.stringify(nodeMessage), 'msg-node'),
+                createSQSRecord(JSON.stringify(legacyItem), 'msg-legacy'),
+            ];
+            const result = await unbundleRecords(records);
+            expect(result.items).toHaveLength(4);
+            expect(result.failedMessageIds).toHaveLength(0);
+            expect(result.stats.bundledSqsRecords).toBe(2);
+            expect(result.stats.legacySqsRecords).toBe(1);
+            const pixelIds = result.items.map((item) => item.pixelId);
+            expect(pixelIds).toContain('px_cf_001');
+            expect(pixelIds).toContain('px_cf_002');
+            expect(pixelIds).toContain('px_node_001');
+            expect(pixelIds).toContain('px_legacy');
+        });
+    });
+});
 //# sourceMappingURL=cross-platform-compression.spec.js.map