@walkeros/collector 0.4.2 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 <p align="left">
-  <a href="https://elbwalker.com">
-    <img title="elbwalker" src="https://www.elbwalker.com/img/elbwalker_logo.png" width="256px"/>
+  <a href="https://www.walkeros.io">
+    <img title="elbwalker" src="https://www.walkeros.io/img/elbwalker_logo.png" width="256px"/>
   </a>
 </p>
 
@@ -75,7 +75,7 @@ action by space the collector won't process it.
 npm install @walkeros/collector
 ```
 
-## Setup
+## Quick Start
 
 ### Basic setup
 
@@ -108,27 +108,38 @@ const { collector, elb } = await startFlow({
   destinations: [
     // add your event destinations
   ],
-  verbose: true,
-  onError: (error: unknown) => {
-    console.error('Collector error:', error);
-  },
-  onLog: (message: string, level: 'debug' | 'info' | 'warn' | 'error') => {
-    console.log(`[${level}] ${message}`);
+  logger: {
+    level: 'debug', // 'debug' | 'info' | 'warn' | 'error'
+    handler: (message, level) => {
+      console.log(`[${level}] ${message}`);
+    },
   },
 });
 ```
 
 ## Configuration
 
-| Name           | Type       | Description                                                    | Required | Example                                    |
-| -------------- | ---------- | -------------------------------------------------------------- | -------- | ------------------------------------------ |
-| `run`          | `boolean`  | Automatically start the collector pipeline on initialization   | No       | `true`                                     |
-| `sources`      | `array`    | Configurations for sources providing events to the collector   | No       | `[{ source, config }]`                     |
-| `destinations` | `array`    | Configurations for destinations receiving processed events     | No       | `[{ destination, config }]`                |
-| `consent`      | `object`   | Initial consent state to control routing of events             | No       | `{ analytics: true, marketing: false }`    |
-| `verbose`      | `boolean`  | Enable verbose logging for debugging                           | No       | `false`                                    |
-| `onError`      | `function` | Error handler triggered when the collector encounters failures | No       | `(error) => console.error(error)`          |
-| `onLog`        | `function` | Custom log handler for collector messages                      | No       | `(message, level) => console.log(message)` |
+| Name           | Type      | Description                                                  | Required | Example                                 |
+| -------------- | --------- | ------------------------------------------------------------ | -------- | --------------------------------------- |
+| `run`          | `boolean` | Automatically start the collector pipeline on initialization | No       | `true`                                  |
+| `sources`      | `array`   | Configurations for sources providing events to the collector | No       | `[{ source, config }]`                  |
+| `destinations` | `array`   | Configurations for destinations receiving processed events   | No       | `[{ destination, config }]`             |
+| `consent`      | `object`  | Initial consent state to control routing of events           | No       | `{ analytics: true, marketing: false }` |
+| `logger`       | `object`  | Logger configuration with level and custom handler           | No       | `{ level: 'info', handler: fn }`        |
+
+## Type Definitions
+
+See [src/types/](./src/types/) for TypeScript interfaces:
+
+- [flow.ts](./src/types/flow.ts) - Flow configuration
+- [collector.ts](./src/types/collector.ts) - Collector interface
+
+## Related
+
+- [Website Documentation](https://www.walkeros.io/docs/getting-started/flow/)
+- [Core Package](../core/) - Types and utilities
+- [Web Sources](../web/sources/) - Browser event sources
+- [Server Sources](../server/sources/) - Node.js event sources
 
 ## Contribute
 

package/dist/__tests__/auto-run.test.d.ts

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

package/dist/__tests__/auto-run.test.d.ts.map

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

package/dist/__tests__/auto-run.test.js

@@ -0,0 +1,102 @@
+import { startFlow } from '..';
+describe('Auto-run functionality', () => {
+    describe('startFlow auto-run behavior', () => {
+        test('auto-runs by default (collector.allowed should be true)', async () => {
+            const { collector } = await startFlow();
+            // Default behavior should auto-run and set allowed to true
+            expect(collector.allowed).toBe(true);
+            expect(collector.config.run).toBe(true);
+        });
+        test('auto-runs when explicitly set to true (collector.allowed should be true)', async () => {
+            const { collector } = await startFlow({ run: true });
+            // Explicitly setting run: true should auto-run and set allowed to true
+            expect(collector.allowed).toBe(true);
+            expect(collector.config.run).toBe(true);
+        });
+        test('does not auto-run when set to false (collector.allowed should be false)', async () => {
+            const { collector } = await startFlow({ run: false });
+            // Setting run: false should NOT auto-run and allowed should stay false
+            expect(collector.allowed).toBe(false);
+            expect(collector.config.run).toBe(false);
+        });
+        test('manual run after initialization with run: false should set allowed to true', async () => {
+            const { collector, elb } = await startFlow({ run: false });
+            // Initially should not be allowed
+            expect(collector.allowed).toBe(false);
+            // Manual run should set allowed to true
+            await elb('walker run');
+            expect(collector.allowed).toBe(true);
+        });
+        test('config state is preserved correctly for different run values', async () => {
+            // Test with run: true
+            const collectorTrue = await startFlow({ run: true });
+            expect(collectorTrue.collector.config.run).toBe(true);
+            expect(collectorTrue.collector.allowed).toBe(true);
+            // Test with run: false
+            const collectorFalse = await startFlow({
+                run: false,
+            });
+            expect(collectorFalse.collector.config.run).toBe(false);
+            expect(collectorFalse.collector.allowed).toBe(false);
+        });
+    });
+    describe('auto-run with additional configuration', () => {
+        test('applies consent during auto-run', async () => {
+            const testConsent = { functional: true, marketing: false };
+            const { collector } = await startFlow({
+                run: true,
+                consent: testConsent,
+            });
+            expect(collector.allowed).toBe(true);
+            expect(collector.consent).toEqual(testConsent);
+        });
+        test('applies user data during auto-run', async () => {
+            const testUser = { id: 'test-user-123', custom: { type: 'premium' } };
+            const { collector } = await startFlow({
+                run: true,
+                user: testUser,
+            });
+            expect(collector.allowed).toBe(true);
+            expect(collector.user).toEqual(testUser);
+        });
+        test('applies globals during auto-run', async () => {
+            const testGlobals = { page_title: 'Test Page', environment: 'test' };
+            const { collector } = await startFlow({
+                run: true,
+                globals: testGlobals,
+            });
+            expect(collector.allowed).toBe(true);
+            expect(collector.globals).toEqual(expect.objectContaining(testGlobals));
+        });
+        test('applies custom data during auto-run', async () => {
+            const testCustom = { tracking_id: 'GTM-12345', debug: true };
+            const { collector } = await startFlow({
+                run: true,
+                custom: testCustom,
+            });
+            expect(collector.allowed).toBe(true);
+            expect(collector.custom).toEqual(testCustom);
+        });
+        test('does not apply additional config when run: false', async () => {
+            const testConsent = { functional: true, marketing: false };
+            const testUser = { id: 'test-user-123' };
+            const testGlobals = { page_title: 'Test Page' };
+            const testCustom = { tracking_id: 'GTM-12345' };
+            const { collector } = await startFlow({
+                run: false,
+                consent: testConsent,
+                user: testUser,
+                globals: testGlobals,
+                custom: testCustom,
+            });
+            // Should not be allowed since we didn't run
+            expect(collector.allowed).toBe(false);
+            // But the config should still be stored for potential later use
+            expect(collector.consent).toEqual(testConsent);
+            expect(collector.user).toEqual(testUser);
+            expect(collector.globals).toEqual(expect.objectContaining(testGlobals));
+            expect(collector.custom).toEqual(testCustom);
+        });
+    });
+});
+//# sourceMappingURL=auto-run.test.js.map

package/dist/__tests__/auto-run.test.js.map

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

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

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

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

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

package/dist/__tests__/consent.test.js

@@ -0,0 +1,21 @@
+import { getGrantedConsent } from '@walkeros/core';
+describe('consent', () => {
+    test('nothing required', () => {
+        expect(getGrantedConsent(undefined, { foo: true })).toStrictEqual({
+            foo: true,
+        });
+    });
+    test('denied', () => {
+        expect(getGrantedConsent({ marketing: true }, { functional: true, marketing: false })).toBeFalsy();
+    });
+    test('granted by destination', () => {
+        expect(getGrantedConsent({ functional: true }, { functional: true })).toStrictEqual({ functional: true });
+    });
+    test('granted individually', () => {
+        expect(getGrantedConsent({ marketing: true }, { marketing: false }, { marketing: true })).toStrictEqual({ marketing: true });
+    });
+    test('granted states', () => {
+        expect(getGrantedConsent({ foo: true }, { foo: true }, { bar: true })).toStrictEqual({ foo: true, bar: true });
+    });
+});
+//# sourceMappingURL=consent.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consent.test.js","sourceRoot":"","sources":["../../src/__tests__/consent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;YAChE,GAAG,EAAE,IAAI;SACV,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;QAClB,MAAM,CACJ,iBAAiB,CACf,EAAE,SAAS,EAAE,IAAI,EAAE,EACnB,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CACvC,CACF,CAAC,SAAS,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAClC,MAAM,CACJ,iBAAiB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAC9D,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAChC,MAAM,CACJ,iBAAiB,CACf,EAAE,SAAS,EAAE,IAAI,EAAE,EACnB,EAAE,SAAS,EAAE,KAAK,EAAE,EACpB,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CACF,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC1B,MAAM,CACJ,iBAAiB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAC/D,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/create-flow.test.d.ts

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

package/dist/__tests__/create-flow.test.d.ts.map

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

package/dist/__tests__/create-flow.test.js

@@ -0,0 +1,69 @@
+import { startFlow } from '../flow';
+describe('Source Create Flow Integration', () => {
+    it('should initialize complete setup from flow config', async () => {
+        const mockPushCalls = [];
+        const mockSource = async (config, env) => {
+            expect(config).toEqual({
+                settings: {
+                    test: 'value',
+                },
+            });
+            expect(env).toMatchObject({
+                push: expect.any(Function),
+                command: expect.any(Function),
+                sources: expect.any(Object),
+                elb: expect.any(Function),
+                foo: 'bar',
+            });
+            return {
+                type: 'mock',
+                config: {
+                    settings: config.settings || {},
+                },
+                push: env.push, // Required push method
+            };
+        };
+        const { collector, elb } = await startFlow({
+            sources: {
+                mockSource: {
+                    code: mockSource,
+                    config: {
+                        settings: {
+                            test: 'value',
+                        },
+                    },
+                    env: {
+                        foo: 'bar',
+                        // elb will be injected by collector
+                    },
+                },
+            },
+            destinations: {
+                test: {
+                    code: {
+                        type: 'test',
+                        config: {},
+                        push: (event) => {
+                            mockPushCalls.push(event);
+                        },
+                    },
+                },
+            },
+        });
+        expect(collector.sources.mockSource).toEqual({
+            type: 'mock',
+            config: {
+                settings: { test: 'value' },
+            },
+            push: expect.any(Function),
+        });
+        expect(collector.sources.elb).toBeDefined();
+        await elb({ name: 'manual event', data: { test: 'data' } });
+        expect(mockPushCalls).toHaveLength(1);
+        expect(mockPushCalls[0]).toMatchObject({
+            name: 'manual event',
+            data: { test: 'data' },
+        });
+    });
+});
+//# sourceMappingURL=create-flow.test.js.map

package/dist/__tests__/create-flow.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-flow.test.js","sourceRoot":"","sources":["../../src/__tests__/create-flow.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,aAAa,GAAqB,EAAE,CAAC;QAE3C,MAAM,UAAU,GAAgB,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YACpD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;iBACd;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;gBACxB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC1B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC7B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC3B,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,GAAG,EAAE,KAAK;aACX,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE;oBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;iBAChC;gBACD,IAAI,EAAE,GAAI,CAAC,IAAc,EAAE,uBAAuB;aACnD,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,SAAS,CAAC;YACzC,OAAO,EAAE;gBACP,UAAU,EAAE;oBACV,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE;wBACN,QAAQ,EAAE;4BACR,IAAI,EAAE,OAAO;yBACd;qBACF;oBACD,GAAG,EAAE;wBACH,GAAG,EAAE,KAAK;wBACV,oCAAoC;qBACrC;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE;oBACJ,IAAI,EAAE;wBACJ,IAAI,EAAE,MAAM;wBACZ,MAAM,EAAE,EAAE;wBACV,IAAI,EAAE,CAAC,KAAqB,EAAE,EAAE;4BAC9B,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBAC5B,CAAC;qBACF;iBACF;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;YAC3C,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE;gBACN,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;aAC5B;YACD,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAE5C,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAE5D,MAAM,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACrC,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/destination-code.test.d.ts

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

package/dist/__tests__/destination-code.test.d.ts.map

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

package/dist/__tests__/destination-code.test.js

@@ -0,0 +1,323 @@
+import { createEvent, createMockLogger } from '@walkeros/core';
+import { destinationCode } from '../destination-code';
+import { initDestinations } from '../destination';
+describe('destinationCode', () => {
+    const createMockCollector = () => ({
+        consent: {},
+        destinations: {},
+        sources: {},
+        queue: [],
+        hooks: {},
+        on: {},
+        globals: {},
+        user: {},
+        allowed: true,
+        config: {},
+        count: 0,
+        logger: createMockLogger(),
+        push: jest.fn(),
+    });
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe('basic properties', () => {
+        it('should have correct type', () => {
+            expect(destinationCode.type).toBe('code');
+        });
+        it('should have empty default config', () => {
+            expect(destinationCode.config).toEqual({});
+        });
+    });
+    describe('init', () => {
+        it('executes init code string', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        init: "context.logger.info('initialized')",
+                    },
+                },
+                env: {},
+                logger: mockLogger,
+            };
+            destinationCode.init(context);
+            expect(mockLogger.info).toHaveBeenCalledWith('initialized');
+        });
+        it('handles missing init code gracefully', () => {
+            const context = {
+                collector: createMockCollector(),
+                config: { settings: {} },
+                env: {},
+                logger: createMockLogger(),
+            };
+            expect(() => destinationCode.init(context)).not.toThrow();
+        });
+        it('catches and logs errors in init code', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        init: "throw new Error('test error')",
+                    },
+                },
+                env: {},
+                logger: mockLogger,
+            };
+            destinationCode.init(context);
+            expect(mockLogger.error).toHaveBeenCalled();
+        });
+    });
+    describe('push', () => {
+        it('executes push code from mapping', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {},
+                data: { transformed: true },
+                env: {},
+                logger: mockLogger,
+                mapping: {
+                    push: 'context.logger.info(event.name, context.data)',
+                },
+            };
+            destinationCode.push(createEvent({ name: 'product view' }), context);
+            expect(mockLogger.info).toHaveBeenCalledWith('product view', {
+                transformed: true,
+            });
+        });
+        it('falls back to settings.push when mapping.push is missing', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        push: "context.logger.info('settings fallback')",
+                    },
+                },
+                data: {},
+                env: {},
+                logger: mockLogger,
+                mapping: {},
+            };
+            destinationCode.push(createEvent({ name: 'product view' }), context);
+            expect(mockLogger.info).toHaveBeenCalledWith('settings fallback');
+        });
+        it('prefers mapping.push over settings.push', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        push: "context.logger.info('from settings')",
+                    },
+                },
+                data: {},
+                env: {},
+                logger: mockLogger,
+                mapping: {
+                    push: "context.logger.info('from mapping')",
+                },
+            };
+            destinationCode.push(createEvent({ name: 'product view' }), context);
+            expect(mockLogger.info).toHaveBeenCalledWith('from mapping');
+            expect(mockLogger.info).not.toHaveBeenCalledWith('from settings');
+        });
+        it('handles missing push code gracefully', () => {
+            const context = {
+                collector: createMockCollector(),
+                config: {},
+                env: {},
+                logger: createMockLogger(),
+                mapping: {},
+                data: {},
+            };
+            expect(() => destinationCode.push(createEvent({ name: 'product view' }), context)).not.toThrow();
+        });
+        it('catches and logs errors in push code', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {},
+                env: {},
+                logger: mockLogger,
+                mapping: {
+                    push: "throw new Error('test error')",
+                },
+                data: {},
+            };
+            destinationCode.push(createEvent({ name: 'product view' }), context);
+            expect(mockLogger.error).toHaveBeenCalled();
+        });
+    });
+    describe('pushBatch', () => {
+        it('executes pushBatch code from mapping', () => {
+            const mockLogger = createMockLogger();
+            const batch = {
+                key: 'product view',
+                events: [
+                    createEvent({ name: 'product view', id: '1' }),
+                    createEvent({ name: 'product view', id: '2' }),
+                ],
+                data: [{ id: '1' }, { id: '2' }],
+            };
+            const context = {
+                collector: createMockCollector(),
+                config: {},
+                env: {},
+                logger: mockLogger,
+                mapping: {
+                    pushBatch: "context.logger.info('batch size:', batch.events.length)",
+                },
+            };
+            destinationCode.pushBatch(batch, context);
+            expect(mockLogger.info).toHaveBeenCalledWith('batch size:', 2);
+        });
+        it('falls back to settings.pushBatch when mapping.pushBatch is missing', () => {
+            const mockLogger = createMockLogger();
+            const batch = {
+                key: 'test',
+                events: [],
+                data: [],
+            };
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        pushBatch: "context.logger.info('batch settings fallback')",
+                    },
+                },
+                env: {},
+                logger: mockLogger,
+                mapping: {},
+            };
+            destinationCode.pushBatch(batch, context);
+            expect(mockLogger.info).toHaveBeenCalledWith('batch settings fallback');
+        });
+        it('handles missing pushBatch code gracefully', () => {
+            const batch = {
+                key: 'test',
+                events: [],
+                data: [],
+            };
+            const context = {
+                collector: createMockCollector(),
+                config: {},
+                env: {},
+                logger: createMockLogger(),
+                mapping: {},
+            };
+            expect(() => destinationCode.pushBatch(batch, context)).not.toThrow();
+        });
+        it('catches and logs errors in pushBatch code', () => {
+            const mockLogger = createMockLogger();
+            const batch = {
+                key: 'test',
+                events: [],
+                data: [],
+            };
+            const context = {
+                collector: createMockCollector(),
+                config: {},
+                env: {},
+                logger: mockLogger,
+                mapping: {
+                    pushBatch: "throw new Error('test error')",
+                },
+            };
+            destinationCode.pushBatch(batch, context);
+            expect(mockLogger.error).toHaveBeenCalled();
+        });
+    });
+    describe('on', () => {
+        it('executes on code string', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        on: "if (type === 'consent') context.logger.info('consent:', context.data)",
+                    },
+                },
+                data: { marketing: true },
+                env: {},
+                logger: mockLogger,
+            };
+            destinationCode.on('consent', context);
+            expect(mockLogger.info).toHaveBeenCalledWith('consent:', {
+                marketing: true,
+            });
+        });
+        it('handles missing on code gracefully', () => {
+            const context = {
+                collector: createMockCollector(),
+                config: { settings: {} },
+                env: {},
+                logger: createMockLogger(),
+            };
+            expect(() => destinationCode.on('consent', context)).not.toThrow();
+        });
+        it('catches and logs errors in on code', () => {
+            const mockLogger = createMockLogger();
+            const context = {
+                collector: createMockCollector(),
+                config: {
+                    settings: {
+                        on: "throw new Error('test error')",
+                    },
+                },
+                env: {},
+                logger: mockLogger,
+            };
+            destinationCode.on('consent', context);
+            expect(mockLogger.error).toHaveBeenCalled();
+        });
+    });
+});
+describe('code: true initialization', () => {
+    it('uses built-in destinationCode when code is true', async () => {
+        const collector = {
+            logger: createMockLogger(),
+        };
+        const destinations = await initDestinations(collector, {
+            myCodeDest: {
+                code: true,
+                config: {
+                    settings: {
+                        init: "context.logger.info('ready')",
+                    },
+                },
+            },
+        });
+        expect(destinations.myCodeDest).toBeDefined();
+        expect(destinations.myCodeDest.type).toBe('code');
+        expect(destinations.myCodeDest.init).toBeDefined();
+        expect(destinations.myCodeDest.push).toBeDefined();
+    });
+    it('preserves provided config with code: true', async () => {
+        const collector = {
+            logger: createMockLogger(),
+        };
+        const destinations = await initDestinations(collector, {
+            myCodeDest: {
+                code: true,
+                config: {
+                    settings: {
+                        init: "context.logger.info('custom init')",
+                        push: "context.logger.info('custom push')",
+                    },
+                    consent: { functional: true },
+                },
+            },
+        });
+        expect(destinations.myCodeDest.config.settings).toEqual({
+            init: "context.logger.info('custom init')",
+            push: "context.logger.info('custom push')",
+        });
+        expect(destinations.myCodeDest.config.consent).toEqual({
+            functional: true,
+        });
+    });
+});
+//# sourceMappingURL=destination-code.test.js.map