@amplytools/react-native-amply-sdk 0.4.1 → 0.5.1

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

@@ -11,12 +11,12 @@ const mockNativeModule = {
     initialize: jest.fn(),
     isInitialized: jest.fn(() => true),
     track: jest.fn(),
-    trackEventGated: jest.fn(),
+    trackGated: jest.fn(),
     resolveCampaign: jest.fn(),
     getRecentEvents: jest.fn(),
     getDataSetSnapshot: jest.fn(),
     registerDeepLinkListener: jest.fn(),
-    registerCampaignPresenter: jest.fn(),
+    registerGate: jest.fn(),
     addListener: jest.fn(),
     removeListeners: jest.fn(),
     onSystemEvent: jest.fn(),
@@ -27,97 +27,129 @@ const mockNativeModule = {
     removeCustomProperty: jest.fn(),
     clearCustomProperties: jest.fn(),
 };
-describe('Amply CampaignResolved present/resolve/result API', () => {
+describe('Amply gate API (trackGated + registerGate)', () => {
     afterEach(() => {
         jest.clearAllMocks();
+        Amply.removeAllListeners();
         __setNativeModule(null);
     });
     beforeEach(() => {
         __setNativeModule(mockNativeModule);
     });
-    describe('trackEvent continuation overload', () => {
-        it('calls fire-and-forget track when no callbacks are supplied', async () => {
+    describe('trackEvent (fire-and-forget)', () => {
+        it('forwards to native track and never gates', async () => {
             await Amply.trackEvent('SaveTapped', { foo: 'bar' });
             expect(mockNativeModule.track).toHaveBeenCalledWith({
                 name: 'SaveTapped',
                 properties: { foo: 'bar' },
             });
-            expect(mockNativeModule.trackEventGated).not.toHaveBeenCalled();
+            expect(mockNativeModule.trackGated).not.toHaveBeenCalled();
         });
-        it('routes a "complete" resolution to onProceed', async () => {
-            mockNativeModule.trackEventGated.mockResolvedValueOnce('complete');
-            const onProceed = jest.fn();
-            const onCancel = jest.fn();
-            await Amply.trackEvent('SaveTapped', { foo: 'bar' }, { onProceed, onCancel });
-            expect(mockNativeModule.trackEventGated).toHaveBeenCalledWith('SaveTapped', {
+        it('defaults missing properties to an empty object', async () => {
+            await Amply.trackEvent('Ping');
+            expect(mockNativeModule.track).toHaveBeenCalledWith({
+                name: 'Ping',
+                properties: {},
+            });
+        });
+    });
+    describe('trackGated', () => {
+        it('resolves proceed/completed when the gate is satisfied', async () => {
+            mockNativeModule.trackGated.mockResolvedValueOnce({
+                outcome: 'proceed',
+                reason: 'completed',
+            });
+            const decision = await Amply.trackGated('SaveTapped', { foo: 'bar' });
+            expect(mockNativeModule.trackGated).toHaveBeenCalledWith('SaveTapped', {
                 foo: 'bar',
             });
-            expect(onProceed).toHaveBeenCalledTimes(1);
-            expect(onCancel).not.toHaveBeenCalled();
+            expect(decision).toEqual({ outcome: 'proceed', reason: 'completed' });
+        });
+        it('resolves proceed/failOpen when the native layer reports fail-open', async () => {
+            mockNativeModule.trackGated.mockResolvedValueOnce({
+                outcome: 'proceed',
+                reason: 'failOpen',
+            });
+            const decision = await Amply.trackGated('SaveTapped', {});
+            expect(decision).toEqual({ outcome: 'proceed', reason: 'failOpen' });
         });
-        it('routes a "cancel" resolution to onCancel', async () => {
-            mockNativeModule.trackEventGated.mockResolvedValueOnce('cancel');
-            const onProceed = jest.fn();
-            const onCancel = jest.fn();
-            await Amply.trackEvent('SaveTapped', undefined, { onProceed, onCancel });
-            expect(mockNativeModule.trackEventGated).toHaveBeenCalledWith('SaveTapped', {});
-            expect(onCancel).toHaveBeenCalledTimes(1);
-            expect(onProceed).not.toHaveBeenCalled();
+        it('resolves cancelled on a user dismiss under onAbort=cancel', async () => {
+            mockNativeModule.trackGated.mockResolvedValueOnce({ outcome: 'cancelled' });
+            const decision = await Amply.trackGated('SaveTapped', undefined);
+            expect(mockNativeModule.trackGated).toHaveBeenCalledWith('SaveTapped', {});
+            expect(decision).toEqual({ outcome: 'cancelled' });
         });
-        it('fails open to onProceed when the native call rejects', async () => {
-            mockNativeModule.trackEventGated.mockRejectedValueOnce(new Error('boom'));
-            const onProceed = jest.fn();
-            const onCancel = jest.fn();
-            await Amply.trackEvent('SaveTapped', {}, { onProceed, onCancel });
-            expect(onProceed).toHaveBeenCalledTimes(1);
-            expect(onCancel).not.toHaveBeenCalled();
+        it('never rejects — fails open to proceed/failOpen when native rejects', async () => {
+            mockNativeModule.trackGated.mockRejectedValueOnce(new Error('boom'));
+            const decision = await Amply.trackGated('SaveTapped', {});
+            expect(decision).toEqual({ outcome: 'proceed', reason: 'failOpen' });
         });
-        it('runs onProceed (not onCancel) for "cancel" when no onCancel is supplied', async () => {
-            mockNativeModule.trackEventGated.mockResolvedValueOnce('cancel');
-            const onProceed = jest.fn();
-            await Amply.trackEvent('SaveTapped', {}, { onProceed });
-            // The raw result is never exposed; a "cancel" with no onCancel hook is a no-op
-            // for the continuation. onProceed must not fire on a cancel.
-            expect(onProceed).not.toHaveBeenCalled();
+        it('fails open on an unexpected/malformed native decision', async () => {
+            mockNativeModule.trackGated.mockResolvedValueOnce({ outcome: 'wat' });
+            const decision = await Amply.trackGated('SaveTapped', {});
+            expect(decision).toEqual({ outcome: 'proceed', reason: 'failOpen' });
+        });
+        it('normalizes an unknown proceed reason to failOpen', async () => {
+            mockNativeModule.trackGated.mockResolvedValueOnce({
+                outcome: 'proceed',
+                reason: 'something-else',
+            });
+            const decision = await Amply.trackGated('SaveTapped', {});
+            expect(decision).toEqual({ outcome: 'proceed', reason: 'failOpen' });
         });
     });
-    describe('registerCampaignPresenter', () => {
-        it('registers once on the native module and subscribes to onCampaignPresent', async () => {
+    describe('registerGate', () => {
+        it('registers once on the native module per baseUrl and subscribes to onCampaignPresent', async () => {
             const remove = jest.fn();
             mockNativeModule.onCampaignPresent.mockReturnValue({ remove });
-            const presenter = jest.fn(() => 'Completed');
-            const unsubscribe = await Amply.registerCampaignPresenter(presenter);
-            expect(mockNativeModule.registerCampaignPresenter).toHaveBeenCalledTimes(1);
+            const presenter = jest.fn();
+            const unsubscribe = await Amply.registerGate('stillframe://ad', presenter);
+            expect(mockNativeModule.registerGate).toHaveBeenCalledTimes(1);
+            expect(mockNativeModule.registerGate).toHaveBeenCalledWith('stillframe://ad', 'cancel', 0);
             expect(mockNativeModule.onCampaignPresent).toHaveBeenCalledTimes(1);
+            // Second registration of the same baseUrl re-subscribes but does NOT re-register.
+            await Amply.registerGate('stillframe://ad', jest.fn());
+            expect(mockNativeModule.registerGate).toHaveBeenCalledTimes(1);
             unsubscribe();
             expect(remove).toHaveBeenCalledTimes(1);
         });
-        it('forwards a synchronous result to resolveCampaign', async () => {
+        it('passes through onAbort and timeoutMs options', async () => {
+            mockNativeModule.onCampaignPresent.mockReturnValue({ remove: jest.fn() });
+            await Amply.registerGate('stillframe://ad', jest.fn(), {
+                onAbort: 'proceed',
+                timeoutMs: 8000,
+            });
+            expect(mockNativeModule.registerGate).toHaveBeenCalledWith('stillframe://ad', 'proceed', 8000);
+        });
+        it('delivers params + info to the presenter and forwards completed', async () => {
             let emit;
             mockNativeModule.onCampaignPresent.mockImplementation((listener) => {
                 emit = listener;
                 return { remove: jest.fn() };
             });
-            const presenter = jest.fn(() => 'Dismissed');
-            await Amply.registerCampaignPresenter(presenter);
+            const presenter = jest.fn((_params, _info, resolution) => resolution.completed());
+            await Amply.registerGate('stillframe://ad', presenter);
             expect(emit).toBeDefined();
-            emit({ url: 'stillframe://ad', info: { campaignId: 'c1' }, mediationId: 'm1' });
-            // allow the (possibly async) presenter resolution to flush
+            emit({
+                url: 'stillframe://ad?adUnit=rewarded_main',
+                params: { adUnit: 'rewarded_main' },
+                info: { campaignId: 'c1' },
+                mediationId: 'm1',
+            });
             await flushMicrotasks();
-            expect(presenter).toHaveBeenCalledWith('stillframe://ad', { campaignId: 'c1' });
-            expect(mockNativeModule.resolveCampaign).toHaveBeenCalledWith('m1', 'Dismissed');
+            expect(presenter).toHaveBeenCalledWith({ adUnit: 'rewarded_main' }, { campaignId: 'c1' }, expect.any(Object));
+            expect(mockNativeModule.resolveCampaign).toHaveBeenCalledWith('m1', 'Completed');
         });
-        it('forwards a promise-resolved result to resolveCampaign', async () => {
+        it('forwards a dismissed resolution', async () => {
             let emit;
             mockNativeModule.onCampaignPresent.mockImplementation((listener) => {
                 emit = listener;
                 return { remove: jest.fn() };
             });
-            const presenter = jest.fn(async () => 'Unavailable');
-            await Amply.registerCampaignPresenter(presenter);
-            emit({ url: 'stillframe://ad', info: {}, mediationId: 'm2' });
+            await Amply.registerGate('stillframe://ad', (_p, _i, resolution) => resolution.dismissed());
+            emit({ url: 'stillframe://ad', params: {}, info: {}, mediationId: 'm2' });
             await flushMicrotasks();
-            expect(mockNativeModule.resolveCampaign).toHaveBeenCalledWith('m2', 'Unavailable');
+            expect(mockNativeModule.resolveCampaign).toHaveBeenCalledWith('m2', 'Dismissed');
         });
         it('reports Unavailable (fail-open) when the presenter throws', async () => {
             let emit;
@@ -125,13 +157,40 @@ describe('Amply CampaignResolved present/resolve/result API', () => {
                 emit = listener;
                 return { remove: jest.fn() };
             });
-            const presenter = jest.fn(() => {
+            await Amply.registerGate('stillframe://ad', () => {
                 throw new Error('presenter blew up');
             });
-            await Amply.registerCampaignPresenter(presenter);
-            emit({ url: 'stillframe://ad', info: {}, mediationId: 'm3' });
+            emit({ url: 'stillframe://ad', params: {}, info: {}, mediationId: 'm3' });
             await flushMicrotasks();
             expect(mockNativeModule.resolveCampaign).toHaveBeenCalledWith('m3', 'Unavailable');
         });
+        it('resolves at most once even if the presenter reports twice', async () => {
+            let emit;
+            mockNativeModule.onCampaignPresent.mockImplementation((listener) => {
+                emit = listener;
+                return { remove: jest.fn() };
+            });
+            await Amply.registerGate('stillframe://ad', (_p, _i, resolution) => {
+                resolution.completed();
+                resolution.dismissed();
+            });
+            emit({ url: 'stillframe://ad', params: {}, info: {}, mediationId: 'm4' });
+            await flushMicrotasks();
+            expect(mockNativeModule.resolveCampaign).toHaveBeenCalledTimes(1);
+            expect(mockNativeModule.resolveCampaign).toHaveBeenCalledWith('m4', 'Completed');
+        });
+        it('ignores dispatches whose url does not match the registered baseUrl', async () => {
+            let emit;
+            mockNativeModule.onCampaignPresent.mockImplementation((listener) => {
+                emit = listener;
+                return { remove: jest.fn() };
+            });
+            const presenter = jest.fn();
+            await Amply.registerGate('stillframe://ad', presenter);
+            emit({ url: 'other://thing', params: {}, info: {}, mediationId: 'm5' });
+            await flushMicrotasks();
+            expect(presenter).not.toHaveBeenCalled();
+            expect(mockNativeModule.resolveCampaign).not.toHaveBeenCalled();
+        });
     });
 });

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
 export { useAmplySystemEvents } from './hooks/useAmplySystemEvents';
 export { formatSystemEventLabel } from './systemEventUtils';
 export type { FormatOptions } from './systemEventUtils';
-import type { CampaignResult, AmplyInitializationConfig, DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload } from './nativeSpecs/NativeAmplyModule';
+import type { CampaignResult, GateDecision, AmplyInitializationConfig, DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload } from './nativeSpecs/NativeAmplyModule';
 export declare function initialize(config: AmplyInitializationConfig): Promise<void>;
 /**
  * Set the user ID for analytics. Pass null to clear.
@@ -21,58 +21,81 @@ export declare function getLogLevel(): LogLevel;
 export declare function isInitialized(): boolean;
 export declare function track(payload: TrackEventPayload): Promise<void>;
 /**
- * Continuation hooks for the gating form of {@link trackEvent}.
- *
- * `onProceed` is "what to do next" (run exactly once when the gate resolves in
- * favor of proceeding). `onCancel` is an OPTIONAL local-UI cleanup hook, invoked
- * only when a campaign's blocking action is user-dismissed under an `onAbort=cancel`
- * policy. Never put business logic in `onCancel`.
- *
- * The raw campaign result is deliberately not exposed — app code must never branch
- * on which action ran or how it resolved.
+ * Possible results a gate presenter can report. Re-exported from the
+ * native spec for app presenters.
+ */
+export type { CampaignResult, GateDecision };
+/**
+ * Outcome of a gate presenter's presentation, reported back via {@link GateResolution}.
  */
-export type TrackEventContinuation = {
-    onProceed: () => void;
-    onCancel?: () => void;
+export type GatePresenterResult = CampaignResult;
+/**
+ * Resolution token handed to a {@link GatePresenter}. The presenter MUST report
+ * exactly one terminal result. Convenience helpers map to the underlying
+ * {@link CampaignResult}.
+ */
+export type GateResolution = {
+    /** The gate condition was satisfied (e.g. rewarded ad watched to completion). */
+    completed: () => void;
+    /** The user deliberately dismissed without satisfying the condition. */
+    dismissed: () => void;
+    /** Any non-user failure (no-fill, not-ready, failed-to-show). Fails open. */
+    unavailable: () => void;
 };
 /**
- * Possible results a campaign presenter can report. Re-exported from the
- * native spec for app presenters.
+ * A capability presenter for a gate (blocking) action, registered via
+ * {@link registerGate} and keyed by the gate's `baseUrl`. Receives the parsed query
+ * `params`, the enriched `info`, and a {@link GateResolution} token it must resolve
+ * exactly once. Throwing synchronously is treated as `unavailable` (fail-open).
  */
-export type { CampaignResult };
+export type GatePresenter = (params: Record<string, unknown>, info: Record<string, unknown>, resolution: GateResolution) => void;
 /**
- * A capability presenter for a campaign present (blocking) action. Keyed by deeplink
- * URL semantics, NOT by event — the app is a registry of capabilities. Returns (or
- * resolves) the terminal {@link CampaignResult}. Throwing / rejecting is treated as
- * `'Unavailable'` (fail-open).
+ * Options for {@link registerGate}.
  */
-export type CampaignPresenter = (url: string, info: Record<string, unknown>) => CampaignResult | Promise<CampaignResult>;
+export type RegisterGateOptions = {
+    /**
+     * Abort policy when the user dismisses the gate without satisfying it.
+     * - `'cancel'` → {@link trackGated} resolves `{ outcome: 'cancelled' }`.
+     * - `'proceed'` → {@link trackGated} resolves `{ outcome: 'proceed', reason: 'failOpen' }`.
+     * Defaults to `'cancel'`.
+     */
+    onAbort?: 'cancel' | 'proceed';
+    /**
+     * Max time (ms) the gate waits for a presenter result before failing open.
+     * Defaults to the SDK's gate default.
+     */
+    timeoutMs?: number;
+};
 /**
  * Fire-and-forget analytics track. Records the event and lets any matching NORMAL
- * campaign action dispatch as usual. A blocking action matched here will NOT fire —
- * there is no continuation to gate.
+ * campaign action dispatch as usual. A gate action matched here will NOT block —
+ * there is no caller to gate. Use {@link trackGated} to await a gate.
  */
 export declare function trackEvent(event: string, properties?: Record<string, unknown> | null): Promise<void>;
 /**
- * Continuation (gating) form. Records the event; if a blocking campaign action
- * matches AND a presenter is registered, the SDK dispatches it and awaits its result
- * before resolving the continuation:
- * - proceed (completed / unavailable / timeout / dismissed+proceed) → `onProceed`
- * - user dismiss against an `onAbort=cancel` action → `onCancel`
+ * Gated track. Records the event; if a gate action matches AND a presenter is
+ * registered for its `baseUrl`, the SDK dispatches the presentation and awaits its
+ * outcome before resolving:
+ * - `{ outcome: 'proceed', reason: 'completed' }` — the presenter satisfied the gate.
+ * - `{ outcome: 'proceed', reason: 'failOpen' }` — no gate matched, not initialized,
+ *   timeout, unavailable, infra failure, or dismiss under `onAbort=proceed`.
+ * - `{ outcome: 'cancelled' }` — user dismiss under an `onAbort=cancel` gate.
  *
- * Fails open: any error path runs `onProceed`. Passing a continuation is the gating
- * switch — the same event tracked elsewhere without one is a valid, non-gating call.
+ * This NEVER rejects: any infra failure resolves to `{ outcome: 'proceed', reason:
+ * 'failOpen' }` so the caller is never stranded.
  */
-export declare function trackEvent(event: string, properties: Record<string, unknown> | null | undefined, continuation: TrackEventContinuation): Promise<void>;
+export declare function trackGated(event: string, properties?: Record<string, unknown> | null): Promise<GateDecision>;
 /**
- * Register a capability presenter for campaign present (blocking) actions. The presenter
- * is invoked when a blocking action is dispatched; it must report a terminal
- * {@link CampaignResult} (returned or resolved). The SDK collapses multi-step ad
- * lifecycles into the single result you report. Throwing/rejecting → `'Unavailable'`.
+ * Register a gate presenter for a gate (blocking) action, keyed by its `baseUrl`.
+ * The presenter is invoked when a matching gate is dispatched; it receives the parsed
+ * query `params`, the enriched `info`, and a {@link GateResolution} it must resolve
+ * exactly once (`completed`/`dismissed`/`unavailable`). The SDK collapses multi-step
+ * ad lifecycles into the single result you report. A synchronous throw → `unavailable`
+ * (fail-open).
  *
  * @returns an unsubscribe function.
  */
-export declare function registerCampaignPresenter(presenter: CampaignPresenter): Promise<() => void>;
+export declare function registerGate(baseUrl: string, presenter: GatePresenter, opts?: RegisterGateOptions): Promise<() => void>;
 export declare function getRecentEvents(limit: number): Promise<EventRecord[]>;
 export declare function getDataSetSnapshot(type: DataSetType): Promise<DataSetSnapshot>;
 export declare function addDeepLinkListener(listener: (event: DeepLinkEvent) => void): Promise<() => void>;
@@ -118,7 +141,8 @@ declare const _default: {
     isInitialized: typeof isInitialized;
     track: typeof track;
     trackEvent: typeof trackEvent;
-    registerCampaignPresenter: typeof registerCampaignPresenter;
+    trackGated: typeof trackGated;
+    registerGate: typeof registerGate;
     getRecentEvents: typeof getRecentEvents;
     getDataSetSnapshot: typeof getDataSetSnapshot;
     addDeepLinkListener: typeof addDeepLinkListener;

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

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

package/dist/src/index.js

@@ -4,7 +4,7 @@ export { useAmplySystemEvents } from './hooks/useAmplySystemEvents';
 export { formatSystemEventLabel } from './systemEventUtils';
 let deepLinkRegistered = false;
 let debugLogListenerRegistered = false;
-let campaignPresenterRegistered = false;
+const registeredGates = new Set();
 const deepLinkSubscriptions = new Set();
 const campaignPresenterSubscriptions = new Set();
 /**
@@ -109,36 +109,45 @@ export function isInitialized() {
 export async function track(payload) {
     await getNativeModule().track(payload);
 }
-export async function trackEvent(event, properties, continuation) {
-    var _a;
+/**
+ * Fire-and-forget analytics track. Records the event and lets any matching NORMAL
+ * campaign action dispatch as usual. A gate action matched here will NOT block —
+ * there is no caller to gate. Use {@link trackGated} to await a gate.
+ */
+export async function trackEvent(event, properties) {
+    await getNativeModule().track({ name: event, properties: properties !== null && properties !== void 0 ? properties : {} });
+}
+/**
+ * Gated track. Records the event; if a gate action matches AND a presenter is
+ * registered for its `baseUrl`, the SDK dispatches the presentation and awaits its
+ * outcome before resolving:
+ * - `{ outcome: 'proceed', reason: 'completed' }` — the presenter satisfied the gate.
+ * - `{ outcome: 'proceed', reason: 'failOpen' }` — no gate matched, not initialized,
+ *   timeout, unavailable, infra failure, or dismiss under `onAbort=proceed`.
+ * - `{ outcome: 'cancelled' }` — user dismiss under an `onAbort=cancel` gate.
+ *
+ * This NEVER rejects: any infra failure resolves to `{ outcome: 'proceed', reason:
+ * 'failOpen' }` so the caller is never stranded.
+ */
+export async function trackGated(event, properties) {
     const props = properties !== null && properties !== void 0 ? properties : {};
-    if (!continuation) {
-        await getNativeModule().track({ name: event, properties: props });
-        return;
-    }
-    let decision;
     try {
-        decision = await getNativeModule().trackEventGated(event, props);
+        const decision = (await getNativeModule().trackGated(event, props));
+        if (decision && decision.outcome === 'cancelled') {
+            return { outcome: 'cancelled' };
+        }
+        if (decision && decision.outcome === 'proceed') {
+            const reason = decision.reason === 'completed' ? 'completed' : 'failOpen';
+            return { outcome: 'proceed', reason };
+        }
+        // Unexpected/malformed payload: fail open.
+        console.warn('[Amply] trackGated returned an unexpected decision; failing open', decision);
+        return { outcome: 'proceed', reason: 'failOpen' };
     }
     catch (error) {
-        // Fail open: any bridge/SDK failure must proceed, never strand the app.
-        console.warn('[Amply] trackEvent continuation failed; proceeding (fail-open)', error);
-        continuation.onProceed();
-        return;
-    }
-    if (decision === 'cancel') {
-        // A deliberate user-dismiss under an onAbort=cancel action. Only the local-UI
-        // cleanup hook runs; the continuation is suppressed.
-        (_a = continuation.onCancel) === null || _a === void 0 ? void 0 : _a.call(continuation);
-        return;
-    }
-    // 'complete' and any unexpected value fail open to onProceed.
-    continuation.onProceed();
-}
-async function ensureCampaignPresenterRegistration() {
-    if (!campaignPresenterRegistered) {
-        getNativeModule().registerCampaignPresenter();
-        campaignPresenterRegistered = true;
+        // Fail open: any bridge/SDK failure must proceed, never strand the caller.
+        console.warn('[Amply] trackGated failed; proceeding (fail-open)', error);
+        return { outcome: 'proceed', reason: 'failOpen' };
     }
 }
 function trackCampaignPresenterSubscription(subscription) {
@@ -156,27 +165,52 @@ function trackCampaignPresenterSubscription(subscription) {
     return unsubscribe;
 }
 /**
- * Register a capability presenter for campaign present (blocking) actions. The presenter
- * is invoked when a blocking action is dispatched; it must report a terminal
- * {@link CampaignResult} (returned or resolved). The SDK collapses multi-step ad
- * lifecycles into the single result you report. Throwing/rejecting → `'Unavailable'`.
+ * Register a gate presenter for a gate (blocking) action, keyed by its `baseUrl`.
+ * The presenter is invoked when a matching gate is dispatched; it receives the parsed
+ * query `params`, the enriched `info`, and a {@link GateResolution} it must resolve
+ * exactly once (`completed`/`dismissed`/`unavailable`). The SDK collapses multi-step
+ * ad lifecycles into the single result you report. A synchronous throw → `unavailable`
+ * (fail-open).
  *
  * @returns an unsubscribe function.
  */
-export async function registerCampaignPresenter(presenter) {
-    await ensureCampaignPresenterRegistration();
+export async function registerGate(baseUrl, presenter, opts) {
+    var _a, _b;
+    const onAbort = (_a = opts === null || opts === void 0 ? void 0 : opts.onAbort) !== null && _a !== void 0 ? _a : 'cancel';
+    const timeoutMs = (_b = opts === null || opts === void 0 ? void 0 : opts.timeoutMs) !== null && _b !== void 0 ? _b : 0;
+    if (!registeredGates.has(baseUrl)) {
+        getNativeModule().registerGate(baseUrl, onAbort, timeoutMs);
+        registeredGates.add(baseUrl);
+    }
     const nativeModule = getNativeModule();
     const subscription = nativeModule.onCampaignPresent((event) => {
-        const { url, info, mediationId } = event;
-        void Promise.resolve()
-            .then(() => presenter(url, info))
-            .then(result => {
+        const { url, params, info, mediationId } = event;
+        // The native side routes by baseUrl, but guard here too in case multiple gates
+        // share the single onCampaignPresent channel.
+        if (baseUrl && url && !url.startsWith(baseUrl)) {
+            return;
+        }
+        let settled = false;
+        const report = (result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
             nativeModule.resolveCampaign(mediationId, result);
-        }, error => {
+        };
+        const resolution = {
+            completed: () => report('Completed'),
+            dismissed: () => report('Dismissed'),
+            unavailable: () => report('Unavailable'),
+        };
+        try {
+            presenter((params !== null && params !== void 0 ? params : {}), info, resolution);
+        }
+        catch (error) {
             // Presenter failure is an infra failure, never a user dismiss → Unavailable.
-            console.warn('[Amply] campaign presenter failed; reporting Unavailable', error);
-            nativeModule.resolveCampaign(mediationId, 'Unavailable');
-        });
+            console.warn('[Amply] gate presenter threw; reporting Unavailable (fail-open)', error);
+            report('Unavailable');
+        }
     });
     return trackCampaignPresenterSubscription(subscription);
 }
@@ -248,10 +282,11 @@ export function removeAllListeners() {
             unsubscribe();
         }
         catch (error) {
-            console.warn('[Amply] Failed to remove campaign presenter', error);
+            console.warn('[Amply] Failed to remove gate presenter', error);
         }
     });
     campaignPresenterSubscriptions.clear();
+    registeredGates.clear();
 }
 export function addSystemEventsListener(listener) {
     return addSystemEventListener(listener);
@@ -264,7 +299,8 @@ export default {
     isInitialized,
     track,
     trackEvent,
-    registerCampaignPresenter,
+    trackGated,
+    registerGate,
     getRecentEvents,
     getDataSetSnapshot,
     addDeepLinkListener,