@usergist/feedback-react-native 0.1.0

package/dist/Provider.js

@@ -0,0 +1,300 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// <UserGistProvider> — mounts host views that listen for internal showPrompt /
+// showSurvey events and render the appropriate modal.
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Linking } from 'react-native';
+import { UserGist } from './UserGist.js';
+import { PromptSheet } from './ui/PromptSheet.js';
+import { SurveyView } from './ui/SurveyView.js';
+import { InAppMessageView } from './ui/InAppMessageView.js';
+import { RequestsHost } from './ui/requests/RequestsHost.js';
+import { createModalQueue } from './internal/modal-queue.js';
+import { INAPP_AUTO_DISMISSED_EVENT_NAME, INAPP_CTA_CLICKED_EVENT_NAME, INAPP_DISMISSED_EVENT_NAME, INAPP_SHOWN_EVENT_NAME, } from '@usergist/sdk-core/mobile';
+function safeInAppHandlers() {
+    try {
+        return UserGist.__internal_inAppHandlers();
+    }
+    catch {
+        return {};
+    }
+}
+function safeSurveyHandlers() {
+    try {
+        return UserGist.__internal_surveyHandlers();
+    }
+    catch {
+        return {};
+    }
+}
+function safeTrack(event, props) {
+    try {
+        UserGist.track(event, props);
+    }
+    catch {
+        // best-effort — never throw out of a UI side-effect
+    }
+}
+export function UserGistProvider({ children }) {
+    const [payload, setPayload] = useState(null);
+    const currentRef = useRef(null);
+    const [surveyState, setSurveyState] = useState(null);
+    const [inAppMessage, setInAppMessage] = useState(null);
+    const modalQueueRef = useRef(createModalQueue());
+    const promptReleaseRef = useRef(null);
+    const surveyReleaseRef = useRef(null);
+    const inAppReleaseRef = useRef(null);
+    function enqueueModal(task) {
+        modalQueueRef.current.enqueue(task);
+    }
+    function releasePrompt() {
+        const release = promptReleaseRef.current;
+        promptReleaseRef.current = null;
+        release?.();
+    }
+    function releaseSurvey() {
+        const release = surveyReleaseRef.current;
+        surveyReleaseRef.current = null;
+        release?.();
+    }
+    function releaseInApp() {
+        const release = inAppReleaseRef.current;
+        inAppReleaseRef.current = null;
+        release?.();
+    }
+    useEffect(() => {
+        let unsubShow = null;
+        let unsubDismiss = null;
+        let unsubShowSurvey = null;
+        let unsubInvite = null;
+        let unsubShowInApp = null;
+        let unsubResetSurfaces = null;
+        let retryTimer = null;
+        function attach() {
+            try {
+                const bus = UserGist.__internal_events();
+                unsubShow = bus.on('showPrompt', (p) => {
+                    enqueueModal((release) => {
+                        promptReleaseRef.current = release;
+                        currentRef.current = p;
+                        setPayload(p);
+                        safeTrack('$feedback_prompt_shown', { prompt_id: p.prompt.id });
+                        bus.emit('promptShown', p);
+                    });
+                });
+                unsubDismiss = bus.on('dismissPrompt', () => {
+                    currentRef.current = null;
+                    setPayload(null);
+                    releasePrompt();
+                });
+                unsubShowSurvey = bus.on('showSurvey', (payload) => {
+                    enqueueModal((release) => {
+                        surveyReleaseRef.current = release;
+                        void openSurvey(payload.surveyId, payload.source, payload.language).then((shown) => {
+                            if (!shown)
+                                releaseSurvey();
+                        });
+                    });
+                });
+                unsubShowInApp = bus.on('showInAppMessage', (p) => {
+                    enqueueModal((release) => {
+                        inAppReleaseRef.current = release;
+                        setInAppMessage(p.message);
+                        // Track impression so analytics + cross-pillar caps see it —
+                        // the analytics endpoint pivots on properties.message_id.
+                        safeTrack(INAPP_SHOWN_EVENT_NAME, { message_id: p.messageId });
+                        safeInAppHandlers().onShow?.(p.messageId);
+                    });
+                });
+                unsubResetSurfaces = bus.on('resetSurfaces', () => {
+                    modalQueueRef.current.clearPending();
+                    currentRef.current = null;
+                    setPayload(null);
+                    setSurveyState(null);
+                    setInAppMessage(null);
+                    releasePrompt();
+                    releaseSurvey();
+                    releaseInApp();
+                });
+                unsubInvite = bus.on('surveyInvite', (invite) => {
+                    // If host registered onInvite, defer rendering to them. Otherwise
+                    // auto-open — convenient for dev, sensible default for simple apps.
+                    const handlers = (() => {
+                        try {
+                            return UserGist.__internal_surveyHandlers();
+                        }
+                        catch {
+                            return {};
+                        }
+                    })();
+                    if (handlers.onInvite) {
+                        handlers.onInvite({
+                            surveyId: invite.surveyId,
+                            name: invite.name,
+                            source: invite.source,
+                        });
+                        return;
+                    }
+                    enqueueModal((release) => {
+                        surveyReleaseRef.current = release;
+                        void openSurvey(invite.surveyId, invite.source).then((shown) => {
+                            if (!shown)
+                                releaseSurvey();
+                        });
+                    });
+                });
+            }
+            catch {
+                retryTimer = setTimeout(attach, 250);
+            }
+        }
+        attach();
+        return () => {
+            if (retryTimer)
+                clearTimeout(retryTimer);
+            if (unsubShow)
+                unsubShow();
+            if (unsubDismiss)
+                unsubDismiss();
+            if (unsubShowSurvey)
+                unsubShowSurvey();
+            if (unsubInvite)
+                unsubInvite();
+            if (unsubShowInApp)
+                unsubShowInApp();
+            if (unsubResetSurfaces)
+                unsubResetSurfaces();
+            modalQueueRef.current.clearPending();
+        };
+    }, []);
+    const openSurvey = useCallback(async (surveyId, source, language) => {
+        try {
+            // Local-fire fast-path: when the survey-matcher just fired,
+            // the full survey content is already in the SDK's cache. Use
+            // it instead of round-tripping to the server. Falls back to
+            // a fetch for offer-ledger / on-demand opens that arrive
+            // through the polling path.
+            const cached = language ? null : UserGist.__internal_armedSurveyById(surveyId);
+            const survey = cached ?? (await UserGist.__internal_fetchSurvey(surveyId, language));
+            if (!survey)
+                return false;
+            const attempt = await UserGist.__internal_createAttempt(surveyId, source, language);
+            if (!attempt)
+                return false;
+            setSurveyState({
+                survey,
+                attemptId: attempt.attemptId,
+                source,
+                initialQuestionId: attempt.currentQuestionId ?? attempt.startQuestionId,
+                initialSnapshot: attempt.snapshot ?? {},
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }, []);
+    async function handleSubmit(r) {
+        const p = currentRef.current;
+        if (p) {
+            await UserGist.__internal_submitResponse(r, p.triggerEventName);
+            currentRef.current = null;
+            setPayload(null);
+            releasePrompt();
+        }
+    }
+    async function handleDismiss(r) {
+        const p = currentRef.current;
+        if (p) {
+            await UserGist.__internal_submitResponse(r, p.triggerEventName);
+            currentRef.current = null;
+            setPayload(null);
+            releasePrompt();
+        }
+    }
+    function handleInAppDismiss(reason) {
+        const m = inAppMessage;
+        setInAppMessage(null);
+        releaseInApp();
+        if (!m)
+            return;
+        safeTrack(reason === 'auto'
+            ? INAPP_AUTO_DISMISSED_EVENT_NAME
+            : INAPP_DISMISSED_EVENT_NAME, { message_id: m.messageId, dismiss_reason: reason });
+        safeInAppHandlers().onDismiss?.(m.messageId, reason);
+    }
+    function handleInAppCta(cta, index) {
+        const m = inAppMessage;
+        if (!m)
+            return;
+        safeTrack(INAPP_CTA_CLICKED_EVENT_NAME, {
+            message_id: m.messageId,
+            cta_index: index,
+            cta_action: cta.action,
+            cta_label: cta.label,
+        });
+        try {
+            safeInAppHandlers().onCtaClick?.({
+                messageId: m.messageId,
+                action: cta.action,
+                target: cta.target,
+                actionJson: cta.actionJson,
+                label: cta.label,
+                index,
+            });
+        }
+        catch {
+            // Host callbacks cannot interrupt SDK action dispatch or cleanup.
+        }
+        if (cta.action === 'custom_event' && cta.target) {
+            safeTrack(cta.target, {
+                message_id: m.messageId,
+                cta_index: index,
+                cta_label: cta.label,
+            });
+        }
+        else if ((cta.action === 'open_url' || cta.action === 'deep_link') && cta.target) {
+            void Linking.openURL(cta.target).catch(() => undefined);
+        }
+        else if (cta.action === 'json' && cta.actionJson) {
+            try {
+                safeInAppHandlers().onJsonAction?.(cta.actionJson, {
+                    source: 'in_app',
+                    messageId: m.messageId,
+                    label: cta.label,
+                    index,
+                });
+            }
+            catch {
+                // Host action executors are isolated from the SDK UI lifecycle.
+            }
+        }
+        // CTA tap implicitly closes the message.
+        setInAppMessage(null);
+        releaseInApp();
+    }
+    const themeOverride = (() => {
+        try {
+            return UserGist.__internal_theme();
+        }
+        catch {
+            return null;
+        }
+    })();
+    const handleSurveyShow = useCallback((surveyId) => {
+        UserGist.__internal_reportSurveyShown(surveyId);
+        safeSurveyHandlers().onShow?.(surveyId);
+    }, []);
+    const handleSurveyComplete = useCallback((surveyId, attemptId) => {
+        safeSurveyHandlers().onComplete?.(surveyId, attemptId);
+    }, []);
+    const handleSurveyAbandon = useCallback((surveyId, attemptId) => {
+        safeSurveyHandlers().onAbandon?.(surveyId, attemptId);
+        setSurveyState(null);
+        releaseSurvey();
+    }, []);
+    return (_jsxs(_Fragment, { children: [children, _jsx(PromptSheet, { payload: payload, themeOverride: themeOverride ?? undefined, onSubmit: handleSubmit, onDismiss: handleDismiss }), _jsx(SurveyView, { survey: surveyState?.survey ?? null, attemptId: surveyState?.attemptId ?? null, initialSnapshot: surveyState?.initialSnapshot ?? {}, initialQuestionId: surveyState?.initialQuestionId ?? null, source: surveyState?.source ?? 'on_demand', themeOverride: themeOverride, onSaveProgress: (attemptId, qid, snap) => UserGist.__internal_saveProgress(attemptId, qid, snap), onCompleteAttempt: (attemptId, answers) => UserGist.__internal_completeAttempt(attemptId, answers), onAbandonAttempt: (attemptId) => UserGist.__internal_abandonAttempt(attemptId), onDismissRequest: () => {
+                    setSurveyState(null);
+                    releaseSurvey();
+                }, onShow: handleSurveyShow, onComplete: handleSurveyComplete, onAbandon: handleSurveyAbandon }), _jsx(InAppMessageView, { message: inAppMessage, themeOverride: themeOverride, onCtaPress: handleInAppCta, onDismiss: handleInAppDismiss }), _jsx(RequestsHost, {})] }));
+}
+//# sourceMappingURL=Provider.js.map

package/dist/Provider.js.map

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

package/dist/Push.d.ts

@@ -0,0 +1,103 @@
+/**
+ * UserGist Push — React Native public surface.
+ *
+ * `UserGist.enablePush()` installs the bundled APNs / FCM integration. Host
+ * apps that already own those delegates can disable proxying and forward
+ * tokens and message payloads through this surface instead.
+ *
+ * Includes the "under the hood" primitives:
+ *  • Silent reachability ping detection + ack
+ *  • Real delivered / displayed / dismissed beacons
+ *  • Channel registry fetch (Android NotificationChannel registration)
+ *  • App-open beacon for adaptive ping policy
+ *  • Token rebind on identify
+ */
+import { type JsonAction, type PushActionButton, type PushChannelDef } from '@usergist/sdk-core/mobile';
+export type PushPermissionStatus = 'not_determined' | 'denied' | 'granted' | 'provisional' | 'ephemeral';
+export interface UserGistPushMessage {
+    readonly campaignId?: string;
+    readonly variantId?: string;
+    readonly deliveryId?: string;
+    readonly language?: string;
+    readonly deepLink?: string;
+    readonly title?: string;
+    readonly body?: string;
+    readonly imageUrl?: string;
+    readonly androidChannelId?: string;
+    readonly actionButtons: ReadonlyArray<PushActionButton>;
+}
+export interface PushHandlers {
+    readonly onReceive?: (message: UserGistPushMessage, raw: Record<string, unknown>) => void;
+    readonly onOpen?: (message: UserGistPushMessage) => void;
+    readonly onAction?: (message: UserGistPushMessage, actionButton: string) => void;
+    /** Executes host-defined structured actions after the button tap is tracked. */
+    readonly onJsonAction?: (action: JsonAction, context: {
+        readonly source: 'push';
+        readonly message: UserGistPushMessage;
+        readonly actionButton: string;
+    }) => void;
+    readonly onDismiss?: (message: UserGistPushMessage) => void;
+    readonly onSilent?: (pingId: string) => void;
+}
+export declare function jsonActionForButton(buttons: ReadonlyArray<PushActionButton>, actionIdentifier: string): JsonAction | undefined;
+export declare function parseIosPayload(userInfo: Record<string, unknown>): UserGistPushMessage | null;
+export declare function parseFcmData(data: Record<string, string>, notification?: {
+    title?: string;
+    body?: string;
+}): UserGistPushMessage | null;
+interface PushHandlerArgs {
+    readonly userInfo?: Record<string, unknown>;
+    readonly data?: Record<string, string>;
+    readonly notification?: {
+        title?: string;
+        body?: string;
+    };
+}
+export declare const Push: {
+    setHandlers(h: PushHandlers): void;
+    registerDeviceToken(token: string, platform: "ios" | "android", opts?: {
+        environment?: "production" | "sandbox";
+    }): Promise<void>;
+    invalidateDeviceToken(token: string): Promise<void>;
+    /**
+     * Forwarded by the host app's `applicationDidBecomeActive` /
+     * `onResume`. Powers the adaptive reachability policy — recently-active
+     * users skip silent-ping cycles entirely.
+     */
+    appDidBecomeActive(): Promise<void>;
+    /**
+     * Pull the per-app channel registry and let the host (or Android SDK
+     * native module) create/update notification channels at app launch.
+     * Required on Android 8+: notifications without a registered channel
+     * are silently dropped.
+     */
+    fetchChannels(): Promise<ReadonlyArray<PushChannelDef>>;
+    setChannelSubscription(channelId: string, subscribed: boolean): Promise<void>;
+    /**
+     * Recognize and ack a silent reachability push. Called by the host's
+     * notification handler before any UI work. Returns true if the
+     * payload was a silent ping (the host should NOT show anything).
+     */
+    handleSilentIfPresent(args: {
+        userInfo?: Record<string, unknown>;
+        data?: Record<string, string>;
+    }): Promise<boolean>;
+    /**
+     * Beacon: device received the push (NSE / Android FCM data handler).
+     * Distinct from $push_received (which is emitted when the SDK first
+     * sees the payload in user-facing code paths).
+     */
+    beaconDelivered(deliveryId: string): Promise<void>;
+    /** Beacon: SDK rendered a local notification (Android data-only path). */
+    beaconDisplayed(deliveryId: string): Promise<void>;
+    /** Beacon: user dismissed the notification without opening. */
+    beaconDismissed(deliveryId: string): Promise<void>;
+    handleReceived(args: PushHandlerArgs): void;
+    handleDisplayed(args: PushHandlerArgs): void;
+    handleDismissed(args: PushHandlerArgs): void;
+    handleOpened(args: PushHandlerArgs & {
+        actionIdentifier?: string;
+    }): void;
+};
+export {};
+//# sourceMappingURL=Push.d.ts.map

package/dist/Push.d.ts.map

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

package/dist/Push.js

@@ -0,0 +1,225 @@
+/**
+ * UserGist Push — React Native public surface.
+ *
+ * `UserGist.enablePush()` installs the bundled APNs / FCM integration. Host
+ * apps that already own those delegates can disable proxying and forward
+ * tokens and message payloads through this surface instead.
+ *
+ * Includes the "under the hood" primitives:
+ *  • Silent reachability ping detection + ack
+ *  • Real delivered / displayed / dismissed beacons
+ *  • Channel registry fetch (Android NotificationChannel registration)
+ *  • App-open beacon for adaptive ping policy
+ *  • Token rebind on identify
+ */
+import { isSilentPushPayload, } from '@usergist/sdk-core/mobile';
+import { UserGist } from './UserGist.js';
+let handlers = {};
+function parseActionButtons(value) {
+    let candidate = value;
+    if (typeof candidate === 'string') {
+        try {
+            candidate = JSON.parse(candidate);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (!Array.isArray(candidate))
+        return [];
+    return candidate.filter((button) => {
+        if (typeof button !== 'object' || button === null)
+            return false;
+        const record = button;
+        return typeof record.label === 'string' && typeof record.action === 'string';
+    });
+}
+export function jsonActionForButton(buttons, actionIdentifier) {
+    const indexed = /^usergist_action_(\d+)$/.exec(actionIdentifier);
+    const byIndex = indexed ? buttons[Number(indexed[1])] : undefined;
+    const button = byIndex ?? buttons.find((candidate) => candidate.label === actionIdentifier);
+    return button?.action === 'json' ? button.actionJson : undefined;
+}
+export function parseIosPayload(userInfo) {
+    const usergist = userInfo?.['usergist'];
+    if (!usergist)
+        return null;
+    const aps = userInfo?.['aps'];
+    const alert = aps?.['alert'];
+    const extra = usergist['extra'];
+    return {
+        campaignId: usergist['campaignId'],
+        variantId: usergist['variantId'],
+        deliveryId: usergist['deliveryId'],
+        language: usergist['language'],
+        deepLink: usergist['deepLink'],
+        title: alert?.['title'],
+        body: alert?.['body'],
+        imageUrl: extra?.['imageUrl'],
+        actionButtons: parseActionButtons(usergist['actionButtons']),
+    };
+}
+export function parseFcmData(data, notification) {
+    if (!data.usergist_campaign_id)
+        return null;
+    return {
+        campaignId: data.usergist_campaign_id,
+        variantId: data.usergist_variant_id,
+        deliveryId: data.usergist_delivery_id,
+        language: data.usergist_language,
+        deepLink: data.usergist_deep_link,
+        title: notification?.title ?? data.usergist_title,
+        body: notification?.body ?? data.usergist_body,
+        imageUrl: data.usergist_image_url,
+        androidChannelId: data.usergist_channel_id,
+        actionButtons: parseActionButtons(data.usergist_actions),
+    };
+}
+function emitEvent(name, msg, extra) {
+    const props = {
+        campaign_id: msg.campaignId ?? null,
+        variant_id: msg.variantId ?? null,
+        delivery_id: msg.deliveryId ?? null,
+        language: msg.language ?? null,
+        ...(extra ?? {}),
+    };
+    UserGist.track(name, props);
+    // Also surface to host-app subscribers (e.g. Amplitude / Mixpanel /
+    // Segment) via the public `onPushEvent` API. Analytics-tool agnostic
+    // — the host plumbs to whichever stack they use.
+    UserGist._notifyPushEvent(name, props);
+}
+function parsePushArgs(args) {
+    if (args.userInfo !== undefined)
+        return parseIosPayload(args.userInfo);
+    if (args.data)
+        return parseFcmData(args.data, args.notification);
+    return null;
+}
+export const Push = {
+    setHandlers(h) {
+        handlers = h;
+    },
+    async registerDeviceToken(token, platform, opts) {
+        if (!token)
+            return;
+        await UserGist.registerPushToken(token, platform, opts);
+    },
+    async invalidateDeviceToken(token) {
+        await UserGist.invalidatePushToken(token);
+    },
+    /**
+     * Forwarded by the host app's `applicationDidBecomeActive` /
+     * `onResume`. Powers the adaptive reachability policy — recently-active
+     * users skip silent-ping cycles entirely.
+     */
+    async appDidBecomeActive() {
+        await UserGist.pushAppOpen();
+    },
+    /**
+     * Pull the per-app channel registry and let the host (or Android SDK
+     * native module) create/update notification channels at app launch.
+     * Required on Android 8+: notifications without a registered channel
+     * are silently dropped.
+     */
+    async fetchChannels() {
+        return UserGist.pushFetchChannels();
+    },
+    async setChannelSubscription(channelId, subscribed) {
+        await UserGist.pushSetChannelSubscription(channelId, subscribed);
+    },
+    /**
+     * Recognize and ack a silent reachability push. Called by the host's
+     * notification handler before any UI work. Returns true if the
+     * payload was a silent ping (the host should NOT show anything).
+     */
+    async handleSilentIfPresent(args) {
+        const raw = (args.userInfo ?? args.data ?? {});
+        if (!isSilentPushPayload(raw))
+            return false;
+        const pingId = String(raw.usergist_ping_id ?? '');
+        if (!pingId)
+            return true;
+        handlers.onSilent?.(pingId);
+        await UserGist.pushAckSilent(pingId);
+        return true;
+    },
+    /**
+     * Beacon: device received the push (NSE / Android FCM data handler).
+     * Distinct from $push_received (which is emitted when the SDK first
+     * sees the payload in user-facing code paths).
+     */
+    async beaconDelivered(deliveryId) {
+        if (!deliveryId)
+            return;
+        await UserGist.pushBeacon('delivered', deliveryId);
+    },
+    /** Beacon: SDK rendered a local notification (Android data-only path). */
+    async beaconDisplayed(deliveryId) {
+        if (!deliveryId)
+            return;
+        await UserGist.pushBeacon('displayed', deliveryId);
+    },
+    /** Beacon: user dismissed the notification without opening. */
+    async beaconDismissed(deliveryId) {
+        if (!deliveryId)
+            return;
+        await UserGist.pushBeacon('dismissed', deliveryId);
+    },
+    handleReceived(args) {
+        const msg = parsePushArgs(args);
+        if (!msg)
+            return;
+        emitEvent('$push_received', msg);
+        handlers.onReceive?.(msg, (args.userInfo ?? args.data ?? {}));
+    },
+    handleDisplayed(args) {
+        const msg = parsePushArgs(args);
+        if (!msg)
+            return;
+        emitEvent('$push_displayed', msg);
+        if (msg.deliveryId)
+            void UserGist.pushBeacon('displayed', msg.deliveryId);
+    },
+    handleDismissed(args) {
+        const msg = parsePushArgs(args);
+        if (!msg)
+            return;
+        emitEvent('$push_dismissed', msg);
+        if (msg.deliveryId)
+            void UserGist.pushBeacon('dismissed', msg.deliveryId);
+        handlers.onDismiss?.(msg);
+    },
+    handleOpened(args) {
+        const msg = parsePushArgs(args);
+        if (!msg)
+            return;
+        if (args.actionIdentifier) {
+            emitEvent('$push_action_clicked', msg, { action_button: args.actionIdentifier });
+            try {
+                handlers.onAction?.(msg, args.actionIdentifier);
+            }
+            catch {
+                // A host observer cannot prevent the configured action from running.
+            }
+            const actionJson = jsonActionForButton(msg.actionButtons, args.actionIdentifier);
+            if (actionJson) {
+                try {
+                    handlers.onJsonAction?.(actionJson, {
+                        source: 'push',
+                        message: msg,
+                        actionButton: args.actionIdentifier,
+                    });
+                }
+                catch {
+                    // Host action executors must not throw across the SDK boundary.
+                }
+            }
+        }
+        else {
+            emitEvent('$push_opened', msg);
+            handlers.onOpen?.(msg);
+        }
+    },
+};
+//# sourceMappingURL=Push.js.map

package/dist/Push.js.map

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