@amplytools/react-native-amply-sdk 0.14.0 → 0.15.1

package/dist/src/__tests__/gateRegistrationLifecycle.test.js

@@ -1,215 +0,0 @@
-import * as Amply from '../index';
-import { __setNativeModule } from '../nativeModule';
-async function flushMicrotasks() {
-    for (let i = 0; i < 5; i++) {
-        await Promise.resolve();
-    }
-}
-/**
- * The registration lifecycle of a gate: who receives a presentation, what withdrawal
- * actually withdraws, and what happens to a registration made before the SDK is up.
- *
- * All three were found on 2026-07-31 — the first two by reading the bridge after a field
- * report on Happens, the third by the field report itself. They share one cause: the JS side
- * keeps its own record of what is registered natively, and that record was written
- * optimistically and never reconciled.
- *
- * Trello: gate eviction https://trello.com/c/Gq589zwz, withdrawal
- * https://trello.com/c/saf8I9c6, pre-init registration https://trello.com/c/TZCixnYi
- */
-describe('gate registration lifecycle', () => {
-    /** Every listener currently attached to the shared onCampaignPresent channel. */
-    let emitters;
-    const mockNativeModule = {
-        initialize: jest.fn(),
-        isInitialized: jest.fn(() => true),
-        track: jest.fn(),
-        trackGated: jest.fn(),
-        resolveCampaign: jest.fn(),
-        getRecentEvents: jest.fn(),
-        getDataSetSnapshot: jest.fn(),
-        registerDeepLinkListener: jest.fn(),
-        registerGate: jest.fn(),
-        unregisterGate: jest.fn(),
-        addListener: jest.fn(),
-        removeListeners: jest.fn(),
-        onSystemEvent: jest.fn(),
-        onDeepLink: jest.fn(),
-        onCampaignPresent: jest.fn(),
-        setCustomProperties: jest.fn(),
-        getCustomProperty: jest.fn(),
-        removeCustomProperty: jest.fn(),
-        clearCustomProperties: jest.fn(),
-    };
-    beforeEach(() => {
-        emitters = [];
-        mockNativeModule.isInitialized.mockReturnValue(true);
-        mockNativeModule.onCampaignPresent.mockImplementation((listener) => {
-            emitters.push(listener);
-            // `remove` must actually detach, as a real RN subscription does — otherwise this
-            // harness reports a listener as live after it was removed, and every eviction and
-            // withdrawal assertion below would be measuring the mock rather than the code.
-            const remove = jest.fn(() => {
-                const at = emitters.indexOf(listener);
-                if (at >= 0) {
-                    emitters.splice(at, 1);
-                }
-            });
-            return { remove };
-        });
-        mockNativeModule.onDeepLink.mockReturnValue({ remove: jest.fn() });
-        __setNativeModule(mockNativeModule);
-    });
-    afterEach(() => {
-        Amply.removeAllListeners();
-        jest.clearAllMocks();
-        __setNativeModule(null);
-    });
-    /** Delivers one presentation to every listener currently subscribed to the channel. */
-    function emitPresentation(mediationId = 'm1') {
-        const event = {
-            url: 'stillframe://ad?adUnit=main',
-            params: { adUnit: 'main' },
-            info: { campaignId: 'c1' },
-            mediationId,
-        };
-        emitters.forEach(emit => emit(event));
-    }
-    describe('a second registration on the same baseUrl (Gq589zwz)', () => {
-        it('leaves exactly one live presenter, not two', async () => {
-            const first = jest.fn((_p, _i, r) => r.completed());
-            const second = jest.fn((_p, _i, r) => r.completed());
-            await Amply.registerGate('stillframe://ad', first);
-            await Amply.registerGate('stillframe://ad', second);
-            emitPresentation();
-            await flushMicrotasks();
-            // Both presenters showing UI for one presentation is the defect: the outcome is then
-            // decided by whichever reported first, and the loser's UI is orphaned on screen.
-            expect(second).toHaveBeenCalledTimes(1);
-            expect(first).not.toHaveBeenCalled();
-        });
-        it('applies the options of the newest registration', async () => {
-            await Amply.registerGate('stillframe://ad', jest.fn(), {
-                onAbort: 'cancel',
-                timeoutMs: 1000,
-            });
-            await Amply.registerGate('stillframe://ad', jest.fn(), {
-                onAbort: 'proceed',
-                timeoutMs: 8000,
-            });
-            // Previously the second call was a no-op natively, so its onAbort and timeout were
-            // silently discarded and the gate kept running under the first call's policy.
-            expect(mockNativeModule.registerGate).toHaveBeenLastCalledWith('stillframe://ad', 'proceed', 8000);
-        });
-        it('keeps gates on different baseUrls independent', async () => {
-            const ad = jest.fn((_p, _i, r) => r.completed());
-            const paywall = jest.fn((_p, _i, r) => r.completed());
-            await Amply.registerGate('stillframe://ad', ad);
-            await Amply.registerGate('stillframe://paywall', paywall);
-            emitPresentation();
-            await flushMicrotasks();
-            // Only the URL-matching presenter runs; evicting by baseUrl must not evict a sibling.
-            expect(ad).toHaveBeenCalledTimes(1);
-            expect(paywall).not.toHaveBeenCalled();
-        });
-    });
-    describe('withdrawal (saf8I9c6)', () => {
-        it('withdraws the native gate, not just the JS subscription', async () => {
-            const unsubscribe = await Amply.registerGate('stillframe://ad', jest.fn());
-            unsubscribe();
-            // Without this the gate outlives its presenter and parks the next gated call on that
-            // URL for the whole fail-open timeout — silently, with no crash and no console trace.
-            expect(mockNativeModule.unregisterGate).toHaveBeenCalledWith('stillframe://ad');
-        });
-        it('lets the same baseUrl be registered again after withdrawal', async () => {
-            const unsubscribe = await Amply.registerGate('stillframe://ad', jest.fn());
-            unsubscribe();
-            const presenter = jest.fn((_p, _i, r) => r.completed());
-            await Amply.registerGate('stillframe://ad', presenter);
-            emitPresentation();
-            await flushMicrotasks();
-            expect(presenter).toHaveBeenCalledTimes(1);
-        });
-        /**
-         * Found by codex, not by me. Withdrawal was keyed by URL alone, so an unsubscribe handed
-         * out for a registration that has since been evicted still withdrew whatever holds that
-         * URL now — killing its replacement. A stale handle must be inert, not destructive.
-         */
-        it('an evicted registration\'s unsubscribe does not withdraw its replacement', async () => {
-            const withdrawFirst = await Amply.registerGate('stillframe://ad', jest.fn());
-            const second = jest.fn((_p, _i, r) => r.completed());
-            await Amply.registerGate('stillframe://ad', second);
-            mockNativeModule.unregisterGate.mockClear();
-            withdrawFirst();
-            expect(mockNativeModule.unregisterGate).not.toHaveBeenCalled();
-            emitPresentation();
-            await flushMicrotasks();
-            expect(second).toHaveBeenCalledTimes(1);
-        });
-        it('is idempotent — a second call withdraws nothing further', async () => {
-            const unsubscribe = await Amply.registerGate('stillframe://ad', jest.fn());
-            unsubscribe();
-            unsubscribe();
-            expect(mockNativeModule.unregisterGate).toHaveBeenCalledTimes(1);
-        });
-        it('removeAllListeners withdraws every native gate too', async () => {
-            await Amply.registerGate('stillframe://ad', jest.fn());
-            await Amply.registerGate('stillframe://paywall', jest.fn());
-            Amply.removeAllListeners();
-            // It used to clear the JS bookkeeping only, leaving JS believing nothing was
-            // registered while both gates were still live natively.
-            expect(mockNativeModule.unregisterGate).toHaveBeenCalledWith('stillframe://ad');
-            expect(mockNativeModule.unregisterGate).toHaveBeenCalledWith('stillframe://paywall');
-        });
-    });
-    describe('registration before initialize (TZCixnYi)', () => {
-        it('replays a gate registration once the SDK is up', async () => {
-            mockNativeModule.isInitialized.mockReturnValue(false);
-            const presenter = jest.fn((_p, _i, r) => r.completed());
-            await Amply.registerGate('stillframe://ad', presenter);
-            // Native refuses while uninitialised; JS must not record that as done.
-            expect(mockNativeModule.registerGate).not.toHaveBeenCalled();
-            mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
-            expect(mockNativeModule.registerGate).toHaveBeenCalledWith('stillframe://ad', 'cancel', 0);
-            emitPresentation();
-            await flushMicrotasks();
-            expect(presenter).toHaveBeenCalledTimes(1);
-        });
-        it('replays a deeplink listener once the SDK is up', async () => {
-            mockNativeModule.isInitialized.mockReturnValue(false);
-            await Amply.addDeepLinkListener(jest.fn());
-            expect(mockNativeModule.registerDeepLinkListener).not.toHaveBeenCalled();
-            mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
-            expect(mockNativeModule.registerDeepLinkListener).toHaveBeenCalledTimes(1);
-        });
-        /**
-         * Found by self-review, not by the original pass. Eviction ran at `registerGate()` time,
-         * but a queued registration is not in the registry yet, so there was nothing to evict —
-         * both attached at replay and the second overwrote the map entry without removing the
-         * first subscription. That is the duplicate-presenter defect again, on the pre-init path.
-         */
-        it('two registrations on one baseUrl before init still leave one live presenter', async () => {
-            mockNativeModule.isInitialized.mockReturnValue(false);
-            const first = jest.fn((_p, _i, r) => r.completed());
-            const second = jest.fn((_p, _i, r) => r.completed());
-            await Amply.registerGate('stillframe://ad', first);
-            await Amply.registerGate('stillframe://ad', second);
-            mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
-            emitPresentation();
-            await flushMicrotasks();
-            expect(second).toHaveBeenCalledTimes(1);
-            expect(first).not.toHaveBeenCalled();
-        });
-        it('withdrawing a queued gate cancels it instead of replaying it', async () => {
-            mockNativeModule.isInitialized.mockReturnValue(false);
-            const unsubscribe = await Amply.registerGate('stillframe://ad', jest.fn());
-            unsubscribe();
-            mockNativeModule.isInitialized.mockReturnValue(true);
-            await Amply.initialize({ appId: 'a', apiKeyPublic: 'k', apiKeySecret: 's' });
-            expect(mockNativeModule.registerGate).not.toHaveBeenCalled();
-        });
-    });
-});

package/dist/src/__tests__/index.test.d.ts

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

package/dist/src/__tests__/index.test.d.ts.map

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

package/dist/src/__tests__/index.test.js

@@ -1,204 +0,0 @@
-import * as Amply from '../index';
-import { __setNativeModule } from '../nativeModule';
-const mockNativeModule = {
-    initialize: jest.fn(),
-    isInitialized: jest.fn(() => true),
-    track: jest.fn(),
-    getRecentEvents: jest.fn(),
-    getDataSetSnapshot: jest.fn(),
-    registerDeepLinkListener: jest.fn(),
-    addListener: jest.fn(),
-    removeListeners: jest.fn(),
-    onSystemEvent: jest.fn(),
-    onDeepLink: jest.fn(),
-    setCustomProperties: jest.fn(),
-    getCustomProperty: jest.fn(),
-    removeCustomProperty: jest.fn(),
-    clearCustomProperties: jest.fn(),
-};
-describe('Amply JS API', () => {
-    afterEach(() => {
-        jest.clearAllMocks();
-        __setNativeModule(null);
-    });
-    beforeEach(() => {
-        __setNativeModule(mockNativeModule);
-    });
-    it('initializes the native module', async () => {
-        await Amply.initialize({ appId: 'id', apiKeyPublic: 'public', apiKeySecret: 'secret' });
-        expect(mockNativeModule.initialize).toHaveBeenCalledWith(expect.objectContaining({ appId: 'id', apiKeyPublic: 'public' }));
-    });
-    // A missing key used to reach the native SDK, whose config builder threw an exception that
-    // crossed into Objective-C uncaught and aborted the host app — no JS try/catch could stop it.
-    // Bad keys must cost the app its Amply, never its process.
-    describe.each([
-        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public' }],
-        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public', apiKeySecret: '' }],
-        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public', apiKeySecret: '   ' }],
-        ['apiKeySecret', { appId: 'id', apiKeyPublic: 'public', apiKeySecret: null }],
-        ['apiKeyPublic', { appId: 'id', apiKeyPublic: '', apiKeySecret: 'secret' }],
-        ['appId', { appId: '', apiKeyPublic: 'public', apiKeySecret: 'secret' }],
-    ])('when %s is missing (%j)', (field, config) => {
-        it('rejects with AMP_INVALID_CONFIG, names the field and never calls the native module', async () => {
-            const error = jest.spyOn(console, 'error').mockImplementation(() => { });
-            await expect(Amply.initialize(config)).rejects.toMatchObject({
-                code: 'AMP_INVALID_CONFIG',
-                message: expect.stringContaining(field),
-            });
-            expect(mockNativeModule.initialize).not.toHaveBeenCalled();
-            expect(error).toHaveBeenCalledWith(expect.stringContaining(field));
-            error.mockRestore();
-        });
-    });
-    it('passes the base-URL overrides through to the native layer', async () => {
-        await Amply.initialize({
-            appId: 'id',
-            apiKeyPublic: 'public',
-            apiKeySecret: 'secret',
-            configBaseUrl: 'https://config-staging.example.com',
-            backendBaseUrl: 'https://api-staging.example.com',
-        });
-        expect(mockNativeModule.initialize).toHaveBeenCalledWith(expect.objectContaining({
-            configBaseUrl: 'https://config-staging.example.com',
-            backendBaseUrl: 'https://api-staging.example.com',
-        }));
-    });
-    // `endpoint` is the older single-URL spelling. It stays accepted so existing
-    // callers keep working, but it only ever meant the backend host — the campaign
-    // manifest is served from a different one.
-    it('still accepts the legacy endpoint spelling', async () => {
-        await Amply.initialize({
-            appId: 'id',
-            apiKeyPublic: 'public',
-            apiKeySecret: 'secret',
-            endpoint: 'https://api-staging.example.com',
-        });
-        expect(mockNativeModule.initialize).toHaveBeenCalledWith(expect.objectContaining({ endpoint: 'https://api-staging.example.com' }));
-    });
-    it('tracks events through the native layer', async () => {
-        await Amply.track({ name: 'Test Event', properties: { foo: 'bar' } });
-        expect(mockNativeModule.track).toHaveBeenCalledWith({
-            name: 'Test Event',
-            properties: { foo: 'bar' },
-        });
-    });
-    it('reads recent events', async () => {
-        const events = [{ name: 'e1' }];
-        mockNativeModule.getRecentEvents.mockResolvedValueOnce(events);
-        const result = await Amply.getRecentEvents(3);
-        expect(mockNativeModule.getRecentEvents).toHaveBeenCalledWith(3);
-        expect(result).toBe(events);
-    });
-    it('requests dataset snapshots', async () => {
-        const snapshot = { foo: 'bar' };
-        mockNativeModule.getDataSetSnapshot.mockResolvedValueOnce(snapshot);
-        const type = { kind: '@device' };
-        const result = await Amply.getDataSetSnapshot(type);
-        expect(mockNativeModule.getDataSetSnapshot).toHaveBeenCalledWith(type);
-        expect(result).toBe(snapshot);
-    });
-    it.each([
-        ['singleton @device', { kind: '@device' }],
-        ['singleton @user', { kind: '@user' }],
-        ['singleton @custom', { kind: '@custom' }],
-        ['singleton @session', { kind: '@session' }],
-        [
-            '@triggeredEvent with global strategy',
-            {
-                kind: '@triggeredEvent',
-                data: {
-                    countStrategy: 'global',
-                    params: [{ name: 'level', value: 5 }],
-                    eventName: 'LevelComplete',
-                },
-            },
-        ],
-        [
-            '@triggeredEvent with session strategy and no eventName',
-            {
-                kind: '@triggeredEvent',
-                data: {
-                    countStrategy: 'session',
-                    params: [],
-                },
-            },
-        ],
-        [
-            '@events with mixed event types',
-            {
-                kind: '@events',
-                data: [
-                    { name: 'Purchase', type: 'custom', params: [{ name: 'sku', value: 'ABC' }] },
-                    { name: 'SessionStarted', type: 'system', params: [] },
-                ],
-            },
-        ],
-    ])('passes %s to the native bridge unchanged', async (_label, type) => {
-        mockNativeModule.getDataSetSnapshot.mockResolvedValueOnce({});
-        await Amply.getDataSetSnapshot(type);
-        expect(mockNativeModule.getDataSetSnapshot).toHaveBeenCalledWith(type);
-    });
-    it('subscribes to system events through the TurboModule emitter', async () => {
-        const remove = jest.fn();
-        mockNativeModule.onSystemEvent.mockReturnValueOnce({ remove });
-        const listener = jest.fn();
-        const unsubscribe = await Amply.addSystemEventListener(listener);
-        expect(mockNativeModule.onSystemEvent).toHaveBeenCalledTimes(1);
-        // The native listener is a wrapper that filters DebugLog events
-        const nativeListener = mockNativeModule.onSystemEvent.mock.calls[0][0];
-        // DebugLog events should be filtered out
-        nativeListener({ name: 'DebugLog', type: 'log', timestamp: 1, properties: {} });
-        expect(listener).not.toHaveBeenCalled();
-        // Other events should pass through
-        const systemEvent = { name: 'SessionStart', type: 'system', timestamp: 2, properties: {} };
-        nativeListener(systemEvent);
-        expect(listener).toHaveBeenCalledWith(systemEvent);
-        unsubscribe();
-        expect(remove).toHaveBeenCalledTimes(1);
-    });
-    it('sets a single custom property via setCustomProperties', () => {
-        Amply.setCustomProperty('plan', 'premium');
-        expect(mockNativeModule.setCustomProperties).toHaveBeenCalledWith({
-            plan: 'premium',
-        });
-    });
-    it('sets multiple custom properties at once', () => {
-        Amply.setCustomProperties({ plan: 'premium', age: 25, active: true });
-        expect(mockNativeModule.setCustomProperties).toHaveBeenCalledWith({
-            plan: 'premium',
-            age: 25,
-            active: true,
-        });
-    });
-    it('gets a custom property value', async () => {
-        mockNativeModule.getCustomProperty.mockResolvedValueOnce({ value: 'premium' });
-        const result = await Amply.getCustomProperty('plan');
-        expect(mockNativeModule.getCustomProperty).toHaveBeenCalledWith('plan');
-        expect(result).toBe('premium');
-    });
-    it('returns null for a missing custom property', async () => {
-        mockNativeModule.getCustomProperty.mockResolvedValueOnce({});
-        const result = await Amply.getCustomProperty('nonexistent');
-        expect(result).toBeNull();
-    });
-    it('removes a custom property', () => {
-        Amply.removeCustomProperty('plan');
-        expect(mockNativeModule.removeCustomProperty).toHaveBeenCalledWith('plan');
-    });
-    it('clears all custom properties', () => {
-        Amply.clearCustomProperties();
-        expect(mockNativeModule.clearCustomProperties).toHaveBeenCalled();
-    });
-    it('registers deep links once and subscribes via the TurboModule emitter', async () => {
-        const remove = jest.fn();
-        mockNativeModule.onDeepLink.mockReturnValue({ remove });
-        const listener = jest.fn();
-        const unsubscribe = await Amply.addDeepLinkListener(listener);
-        expect(mockNativeModule.registerDeepLinkListener).toHaveBeenCalledTimes(1);
-        expect(mockNativeModule.onDeepLink).toHaveBeenCalledWith(listener);
-        await Amply.addDeepLinkListener(() => { });
-        expect(mockNativeModule.registerDeepLinkListener).toHaveBeenCalledTimes(1);
-        unsubscribe();
-        expect(remove).toHaveBeenCalledTimes(1);
-    });
-});

package/dist/src/__tests__/systemEventUtils.test.d.ts

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

package/dist/src/__tests__/systemEventUtils.test.d.ts.map

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

package/dist/src/__tests__/systemEventUtils.test.js

@@ -1,56 +0,0 @@
-import { formatSystemEventLabel } from '../systemEventUtils';
-function makeEvent(name, properties = {}) {
-    return { name, type: 'system', timestamp: Date.now(), properties };
-}
-describe('formatSystemEventLabel', () => {
-    describe('SessionStarted', () => {
-        it('returns "Session started (cold)" for cold start', () => {
-            const event = makeEvent('SessionStarted', { type: 'cold' });
-            expect(formatSystemEventLabel(event)).toBe('Session started (cold)');
-        });
-        it('returns "Session started (warm)" for warm start', () => {
-            const event = makeEvent('SessionStarted', { type: 'warm' });
-            expect(formatSystemEventLabel(event)).toBe('Session started (warm)');
-        });
-        it('returns "Session started" when type is absent', () => {
-            const event = makeEvent('SessionStarted');
-            expect(formatSystemEventLabel(event)).toBe('Session started');
-        });
-        it('handles unexpected type values gracefully', () => {
-            const event = makeEvent('SessionStarted', { type: 'unknown' });
-            expect(formatSystemEventLabel(event)).toBe('Session started (unknown)');
-        });
-    });
-    describe('other events', () => {
-        it('formats CampaignShown with campaignId and source', () => {
-            const event = makeEvent('CampaignShown', {
-                campaignId: 'abc',
-                source: 'click',
-            });
-            expect(formatSystemEventLabel(event)).toBe('Campaign shown (abc) via click');
-        });
-        it('formats EventTriggered with source event', () => {
-            const event = makeEvent('EventTriggered', { sourceEvent: 'purchase' });
-            expect(formatSystemEventLabel(event)).toBe('Event triggered (purchase)');
-        });
-        it('formats ConfigFetchFinished with campaign count', () => {
-            const event = makeEvent('ConfigFetchFinished', {
-                success: true,
-                campaignCount: 3,
-            });
-            expect(formatSystemEventLabel(event)).toBe('Config fetch finished (3 campaigns)');
-        });
-        it('formats ConfigFetchFinished failure', () => {
-            const event = makeEvent('ConfigFetchFinished', { success: false });
-            expect(formatSystemEventLabel(event)).toBe('Config fetch failed');
-        });
-        it('returns default label for SessionFinished', () => {
-            const event = makeEvent('SessionFinished');
-            expect(formatSystemEventLabel(event)).toBe('Session finished');
-        });
-        it('returns fallback for unknown events', () => {
-            const event = makeEvent('UnknownEvent');
-            expect(formatSystemEventLabel(event)).toBe('System event UnknownEvent');
-        });
-    });
-});