@usergist/feedback-react-native 0.1.0

package/dist/internal/storage.js

@@ -0,0 +1,213 @@
+// AsyncStorage wrapper with:
+//  - Lazy require (no hard dep at import time)
+//  - Per-writeKey key prefix (multi-app safety on the same device)
+//  - JSON (de)serialization with graceful corruption handling
+//
+// We accept that AsyncStorage is a peer dep; if the host app hasn't installed
+// it, the SDK degrades to an in-memory store so `track()` still works but
+// nothing persists across launches.
+import { reportError } from './debug.js';
+let cached = null;
+let checked = false;
+let customAdapter = null;
+/** Configure a host-owned encrypted key/value backend before `init()`. */
+export function configureStorageAdapter(adapter) {
+    customAdapter = adapter;
+}
+function loadAsyncStorage() {
+    if (checked)
+        return cached;
+    checked = true;
+    try {
+        const mod = require('@react-native-async-storage/async-storage');
+        const impl = (mod && 'default' in mod ? mod.default : mod) ?? undefined;
+        cached = impl ?? null;
+    }
+    catch {
+        cached = null;
+    }
+    return cached;
+}
+// Small in-memory fallback
+const memoryStore = new Map();
+const memoryImpl = {
+    getItem: async (k) => memoryStore.get(k) ?? null,
+    setItem: async (k, v) => {
+        memoryStore.set(k, v);
+    },
+    removeItem: async (k) => {
+        memoryStore.delete(k);
+    },
+    multiRemove: async (keys) => {
+        for (const k of keys)
+            memoryStore.delete(k);
+    },
+};
+// Credential-bearing values must never silently degrade to AsyncStorage.
+// When the native module is unavailable (for example Expo Go), keep them only
+// in process memory and report the loss of relaunch durability.
+const secureMemoryStore = new Map();
+const secureMemoryImpl = {
+    getItem: async (k) => secureMemoryStore.get(k) ?? null,
+    setItem: async (k, v) => { secureMemoryStore.set(k, v); },
+    removeItem: async (k) => { secureMemoryStore.delete(k); },
+    multiRemove: async (keys) => { for (const k of keys)
+        secureMemoryStore.delete(k); },
+};
+let nativeSecureChecked = false;
+let nativeSecure = null;
+let warnedSecureFallback = false;
+function loadNativeSecureStorage() {
+    if (nativeSecureChecked)
+        return nativeSecure;
+    nativeSecureChecked = true;
+    try {
+        const rn = require('react-native');
+        const module = rn.NativeModules?.UserGistPush;
+        if (!module?.secureGetItem || !module.secureSetItem || !module.secureRemoveItem) {
+            return null;
+        }
+        nativeSecure = {
+            getItem: (key) => module.secureGetItem(key),
+            setItem: (key, value) => module.secureSetItem(key, value),
+            removeItem: (key) => module.secureRemoveItem(key),
+            multiRemove: (keys) => module.secureMultiRemove(keys),
+        };
+    }
+    catch {
+        nativeSecure = null;
+    }
+    return nativeSecure;
+}
+function credentialBackend() {
+    if (customAdapter)
+        return customAdapter;
+    const native = loadNativeSecureStorage();
+    if (native)
+        return native;
+    if (!warnedSecureFallback) {
+        warnedSecureFallback = true;
+        reportError('native secure storage unavailable; subject credentials are memory-only until the app is rebuilt with the UserGist native module');
+    }
+    return secureMemoryImpl;
+}
+function backend() {
+    return customAdapter ?? loadAsyncStorage() ?? memoryImpl;
+}
+// Non-crypto stable hash of the writeKey → short prefix
+function hashKey(input) {
+    let h = 5381;
+    for (let i = 0; i < input.length; i++) {
+        h = ((h * 33) ^ input.charCodeAt(i)) >>> 0;
+    }
+    return h.toString(36);
+}
+export function createStorageScope(writeKey) {
+    const prefix = `@usergist/${hashKey(writeKey)}/`;
+    const key = (suffix) => `${prefix}${suffix}`;
+    const isCredential = (suffix) => suffix === STORAGE_KEYS.subjectToken || suffix === STORAGE_KEYS.mutationQueue;
+    const implementation = (suffix) => isCredential(suffix) ? credentialBackend() : backend();
+    return {
+        key,
+        async getJson(suffix) {
+            try {
+                const impl = implementation(suffix);
+                let raw = await impl.getItem(key(suffix));
+                // One-time migration from older SDK builds that stored credentials in
+                // AsyncStorage. Always remove the plaintext copy, even if a native
+                // secure-store write fails, so migration cannot preserve credentials
+                // in an unencrypted backend.
+                if (raw == null && isCredential(suffix) && !customAdapter) {
+                    const legacy = loadAsyncStorage();
+                    const old = await legacy?.getItem(key(suffix));
+                    if (old != null) {
+                        try {
+                            await impl.setItem(key(suffix), old);
+                        }
+                        finally {
+                            await legacy?.removeItem(key(suffix));
+                        }
+                        raw = old;
+                    }
+                }
+                if (raw == null)
+                    return null;
+                return JSON.parse(raw);
+            }
+            catch (e) {
+                reportError('storage.getJson failed', e);
+                return null;
+            }
+        },
+        async setJson(suffix, value) {
+            try {
+                await implementation(suffix).setItem(key(suffix), JSON.stringify(value));
+            }
+            catch (e) {
+                reportError('storage.setJson failed', e);
+            }
+        },
+        async setJsonStrict(suffix, value) {
+            await implementation(suffix).setItem(key(suffix), JSON.stringify(value));
+        },
+        async remove(suffix) {
+            try {
+                await implementation(suffix).removeItem(key(suffix));
+                if (isCredential(suffix) && !customAdapter) {
+                    await loadAsyncStorage()?.removeItem(key(suffix));
+                }
+            }
+            catch (e) {
+                reportError('storage.remove failed', e);
+            }
+        },
+        async clearAll(suffixes) {
+            try {
+                const normal = suffixes.filter((suffix) => !isCredential(suffix)).map(key);
+                const credentials = suffixes.filter(isCredential).map(key);
+                const normalImpl = backend();
+                const credentialImpl = credentialBackend();
+                if (normal.length > 0) {
+                    if (normalImpl.multiRemove)
+                        await normalImpl.multiRemove(normal);
+                    else
+                        await Promise.all(normal.map((k) => normalImpl.removeItem(k)));
+                }
+                if (credentials.length > 0) {
+                    if (credentialImpl.multiRemove)
+                        await credentialImpl.multiRemove(credentials);
+                    else
+                        await Promise.all(credentials.map((k) => credentialImpl.removeItem(k)));
+                    if (!customAdapter) {
+                        const legacy = loadAsyncStorage();
+                        if (legacy?.multiRemove)
+                            await legacy.multiRemove(credentials);
+                        else
+                            await Promise.all(credentials.map((k) => legacy?.removeItem(k)));
+                    }
+                }
+            }
+            catch (e) {
+                reportError('storage.clearAll failed', e);
+            }
+        },
+    };
+}
+export const STORAGE_KEYS = {
+    identity: 'identity',
+    consent: 'consent',
+    queue: 'queue',
+    rulesCache: 'rulesCache',
+    surveyRulesCache: 'surveyRulesCache',
+    inAppRulesCache: 'inAppRulesCache',
+    frequencyCaps: 'frequencyCaps',
+    userProperties: 'userProperties',
+    eventHistory: 'eventHistory',
+    subjectToken: 'subjectToken',
+    mutationQueue: 'mutationQueue',
+    instructionCursor: 'instructionCursor',
+    seenInstructions: 'seenInstructions',
+    localInstructionDedupe: 'localInstructionDedupe',
+    appVersion: 'appVersion',
+};
+//# sourceMappingURL=storage.js.map

package/dist/internal/storage.js.map

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

package/dist/internal/survey-completion.d.ts

@@ -0,0 +1,10 @@
+import type { MutationQueue } from './mutation-queue.js';
+import type { MutationFlushResult } from './engine.js';
+export type SurveyCompletionOutcome = 'delivered' | 'deferred' | 'rejected';
+/**
+ * A durably queued completion is accepted by the SDK even when the network
+ * cannot deliver it immediately. Only a permanent server rejection should
+ * keep the survey on its final question.
+ */
+export declare function surveyCompletionOutcome(mutationId: string, mutations: Pick<MutationQueue, 'has'>, result: MutationFlushResult): SurveyCompletionOutcome;
+//# sourceMappingURL=survey-completion.d.ts.map

package/dist/internal/survey-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey-completion.d.ts","sourceRoot":"","sources":["../../src/internal/survey-completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAA;AAE3E;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EACrC,MAAM,EAAE,mBAAmB,GAC1B,uBAAuB,CAGzB"}

package/dist/internal/survey-completion.js

@@ -0,0 +1,11 @@
+/**
+ * A durably queued completion is accepted by the SDK even when the network
+ * cannot deliver it immediately. Only a permanent server rejection should
+ * keep the survey on its final question.
+ */
+export function surveyCompletionOutcome(mutationId, mutations, result) {
+    if (result.permanentlyRejectedIds.has(mutationId))
+        return 'rejected';
+    return mutations.has(mutationId) ? 'deferred' : 'delivered';
+}
+//# sourceMappingURL=survey-completion.js.map

package/dist/internal/survey-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey-completion.js","sourceRoot":"","sources":["../../src/internal/survey-completion.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,SAAqC,EACrC,MAA2B;IAE3B,IAAI,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAA;IACpE,OAAO,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAA;AAC7D,CAAC"}

package/dist/internal/survey-matcher.d.ts

@@ -0,0 +1,21 @@
+import type { SurveyRulesCache } from './survey-rules-cache.js';
+import type { FrequencyCapManager } from './frequency-cap.js';
+import type { UserStateStore } from './user-state.js';
+import type { ConsentManager } from './consent.js';
+import type { EventBus } from './events.js';
+export interface SurveyMatcher {
+    /** Returns the locally rendered survey id, or null when the server decides. */
+    readonly evaluate: (eventName: string) => string | null;
+    /** Commits cap/cooldown state after the survey route actually appears. */
+    readonly recordShown: (campaignId: string, at?: number) => void;
+    /** Releases process-local reservations during reset. */
+    readonly resetPending: () => void;
+}
+export declare function createSurveyMatcher(params: {
+    readonly rulesCache: SurveyRulesCache;
+    readonly frequencyCaps: FrequencyCapManager;
+    readonly userState: UserStateStore;
+    readonly consent: ConsentManager;
+    readonly events: EventBus;
+}): SurveyMatcher;
+//# sourceMappingURL=survey-matcher.d.ts.map

package/dist/internal/survey-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey-matcher.d.ts","sourceRoot":"","sources":["../../src/internal/survey-matcher.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACvD,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/D,wDAAwD;IACxD,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAA;CAClC;AA6BD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAA;IAC3C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAC1B,GAAG,aAAa,CAmGhB"}

package/dist/internal/survey-matcher.js

@@ -0,0 +1,139 @@
+// Client-side survey matcher. Mirror of trigger-matcher.ts for the
+// survey pillar. Runs synchronously on every `track()`.
+//
+// Pipeline:
+//   1. Look up armed surveys for eventName.
+//   2. Check survey consent.
+//   3. Evaluate segment locally via sdk-core.evaluateSerializedSegmentRules.
+//   4. Check local frequency cap (re-using the per-prompt manager —
+//      campaign id stands in for prompt id).
+//   5. Check cooldown against last shown time.
+//   6. If all pass: emit `surveyInvite` (Provider opens it via the
+//      already-cached survey content) + record cap + cooldown.
+//
+// Server reconciles asynchronously (the offer-ledger insert from the
+// trigger-engine still runs for analytics correctness).
+import { evaluateSerializedSegmentRules } from '@usergist/sdk-core/mobile';
+import { logTrace } from './debug.js';
+// Translate the survey-side PushFrequencyCap shape into the prompt-
+// style { perPromptDays, perUserDays } shape that frequency-cap
+// understands. perCampaignDays = "this survey only", perPillarDays =
+// "any survey".
+function toPromptCaps(cap) {
+    return {
+        perPromptDays: cap.perCampaignDays,
+        perUserDays: cap.perPillarDays,
+    };
+}
+// In-memory cooldown ledger. Survey cooldownSeconds is finer-grained
+// than the day-based per-prompt cap, so we track lastShown locally.
+// Resets on app restart — that's fine; the server-side cooldown is
+// still authoritative on submit.
+const cooldownByCampaign = new Map();
+function passesCooldown(campaignId, cooldownSeconds) {
+    if (!cooldownSeconds || cooldownSeconds <= 0)
+        return true;
+    const last = cooldownByCampaign.get(campaignId);
+    if (!last)
+        return true;
+    return Date.now() - last >= cooldownSeconds * 1000;
+}
+export function createSurveyMatcher(params) {
+    const { rulesCache, frequencyCaps, userState, consent, events } = params;
+    const pendingCampaignIds = new Set();
+    function tryFire(armed, eventName) {
+        if (armed.clientSideEligible === false) {
+            logTrace({
+                eventName,
+                promptId: armed.campaignId,
+                outcome: 'blocked-no-trigger',
+                reason: 'server-authoritative',
+                at: new Date().toISOString(),
+            });
+            return false;
+        }
+        if (!consent.allowsSurvey()) {
+            logTrace({
+                eventName,
+                promptId: armed.campaignId,
+                outcome: 'blocked-by-consent',
+                at: new Date().toISOString(),
+            });
+            return false;
+        }
+        const user = userState.buildForEval();
+        if (!evaluateSerializedSegmentRules(armed.segmentRules ?? null, user)) {
+            logTrace({
+                eventName,
+                promptId: armed.campaignId,
+                outcome: 'blocked-by-segment',
+                at: new Date().toISOString(),
+            });
+            return false;
+        }
+        if (pendingCampaignIds.has(armed.campaignId))
+            return false;
+        const cap = frequencyCaps.canShow(`survey:${armed.campaignId}`, toPromptCaps(armed.frequencyCap));
+        if (!cap.ok) {
+            logTrace({
+                eventName,
+                promptId: armed.campaignId,
+                outcome: 'blocked-by-cap',
+                reason: cap.reason,
+                at: new Date().toISOString(),
+            });
+            return false;
+        }
+        if (!passesCooldown(armed.campaignId, armed.cooldownSeconds)) {
+            logTrace({
+                eventName,
+                promptId: armed.campaignId,
+                outcome: 'blocked-by-cap',
+                reason: 'per-prompt',
+                at: new Date().toISOString(),
+            });
+            return false;
+        }
+        // Fire — emit `surveyInvite` so the existing Provider invite
+        // pipeline opens it. The Provider's openSurvey first hits the
+        // cache (via __internal_armedSurveyById) so there's no follow-up
+        // server fetch for survey content.
+        pendingCampaignIds.add(armed.campaignId);
+        events.emit('surveyInvite', {
+            surveyId: armed.campaignId,
+            name: armed.survey.name,
+            source: 'triggered',
+        });
+        logTrace({
+            eventName,
+            promptId: armed.campaignId,
+            outcome: 'fired',
+            at: new Date().toISOString(),
+        });
+        return true;
+    }
+    return {
+        evaluate(eventName) {
+            const candidates = rulesCache.getForEvent(eventName);
+            if (candidates.length === 0)
+                return null;
+            // Fire the first matching survey (one survey at a time, like
+            // feedback's one-prompt-at-a-time rule).
+            for (const armed of candidates) {
+                if (tryFire(armed, eventName))
+                    return armed.campaignId;
+            }
+            return null;
+        },
+        recordShown(campaignId, at = Date.now()) {
+            pendingCampaignIds.delete(campaignId);
+            frequencyCaps.recordShown(`survey:${campaignId}`, at);
+            cooldownByCampaign.set(campaignId, at);
+        },
+        resetPending() {
+            pendingCampaignIds.clear();
+            cooldownByCampaign.clear();
+        },
+    };
+}
+//# sourceMappingURL=survey-matcher.js.map

package/dist/internal/survey-matcher.js.map

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

package/dist/internal/survey-rules-cache.d.ts

@@ -0,0 +1,17 @@
+import type { ArmedSurvey } from '@usergist/sdk-core/mobile';
+import { type StorageScope } from './storage.js';
+import type { Transport } from './transport.js';
+export interface SurveyRulesCache {
+    readonly hydrate: () => Promise<void>;
+    readonly refresh: (params: {
+        readonly anonymousId: string;
+        readonly externalId: string | null;
+        readonly force?: boolean;
+    }) => Promise<ReadonlyArray<ArmedSurvey>>;
+    readonly getForEvent: (eventName: string) => ReadonlyArray<ArmedSurvey>;
+    readonly getById: (campaignId: string) => ArmedSurvey | undefined;
+    readonly all: () => ReadonlyArray<ArmedSurvey>;
+    readonly clear: () => Promise<void>;
+}
+export declare function createSurveyRulesCache(storage: StorageScope, transport: Transport, defaultSyncMs: number): SurveyRulesCache;
+//# sourceMappingURL=survey-rules-cache.d.ts.map

package/dist/internal/survey-rules-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey-rules-cache.d.ts","sourceRoot":"","sources":["../../src/internal/survey-rules-cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;QACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;QAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KACzB,KAAK,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,CAAC,WAAW,CAAC,CAAA;IACvE,QAAQ,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,aAAa,CAAC,WAAW,CAAC,CAAA;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAiFlB"}

package/dist/internal/survey-rules-cache.js

@@ -0,0 +1,91 @@
+// Armed-surveys cache (the survey-side mirror of rules-cache).
+// - Pulled on app foreground, every 5 min while foregrounded, and on-demand.
+// - Persisted to AsyncStorage.
+// - The survey-matcher reads from here synchronously (no I/O on track()).
+import { STORAGE_KEYS } from './storage.js';
+import { reportError, debugLog } from './debug.js';
+export function createSurveyRulesCache(storage, transport, defaultSyncMs) {
+    let surveys = [];
+    let byEvent = {};
+    let byId = {};
+    let fetchedAt = 0;
+    let hydrated = false;
+    let inflight = null;
+    function reindex(list) {
+        const event = {};
+        const id = {};
+        for (const s of list) {
+            const bucket = event[s.eventName] ?? [];
+            bucket.push(s);
+            event[s.eventName] = bucket;
+            id[s.campaignId] = s;
+        }
+        const eventOut = {};
+        for (const k of Object.keys(event))
+            eventOut[k] = event[k] ?? [];
+        byEvent = eventOut;
+        byId = id;
+    }
+    return {
+        async hydrate() {
+            if (hydrated)
+                return;
+            try {
+                const stored = await storage.getJson(STORAGE_KEYS.surveyRulesCache);
+                if (stored?.surveys) {
+                    surveys = stored.surveys;
+                    reindex(surveys);
+                    fetchedAt = Date.parse(stored.fetchedAt);
+                }
+            }
+            catch (e) {
+                reportError('surveyRulesCache.hydrate failed', e);
+            }
+            hydrated = true;
+        },
+        async refresh({ anonymousId, externalId, force }) {
+            const now = Date.now();
+            if (!force && now - fetchedAt < defaultSyncMs && surveys.length > 0) {
+                return surveys;
+            }
+            if (inflight)
+                return inflight;
+            inflight = (async () => {
+                try {
+                    const res = await transport.armedSurveys({ anonymousId, externalId });
+                    surveys = res.surveys;
+                    reindex(surveys);
+                    fetchedAt = Date.now();
+                    const cache = {
+                        surveys,
+                        fetchedAt: new Date(fetchedAt).toISOString(),
+                        serverTime: res.serverTime,
+                        nextSyncMs: res.nextSyncMs,
+                    };
+                    await storage.setJson(STORAGE_KEYS.surveyRulesCache, cache);
+                    debugLog('surveyRulesCache refreshed', { count: surveys.length });
+                    return surveys;
+                }
+                catch (e) {
+                    reportError('surveyRulesCache.refresh failed', e);
+                    return surveys;
+                }
+                finally {
+                    inflight = null;
+                }
+            })();
+            return inflight;
+        },
+        getForEvent: (eventName) => byEvent[eventName] ?? [],
+        getById: (campaignId) => byId[campaignId],
+        all: () => surveys,
+        async clear() {
+            surveys = [];
+            byEvent = {};
+            byId = {};
+            fetchedAt = 0;
+            await storage.remove(STORAGE_KEYS.surveyRulesCache);
+        },
+    };
+}
+//# sourceMappingURL=survey-rules-cache.js.map

package/dist/internal/survey-rules-cache.js.map

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

package/dist/internal/survey-store.d.ts

@@ -0,0 +1,19 @@
+import type { SurveyAnswerRecord } from '@usergist/sdk-core/mobile';
+export interface PendingAttempt {
+    readonly surveyId: string;
+    readonly attemptId: string;
+    readonly startedAt: number;
+    readonly currentQuestionId: string | null;
+    readonly snapshot: SurveyAnswerRecord;
+    readonly language: string | null;
+}
+export interface SurveyStore {
+    readonly list: () => Promise<ReadonlyArray<PendingAttempt>>;
+    readonly upsert: (attempt: PendingAttempt) => Promise<void>;
+    readonly remove: (attemptId: string) => Promise<void>;
+    readonly updateProgress: (attemptId: string, currentQuestionId: string | null, snapshot: SurveyAnswerRecord) => Promise<void>;
+    readonly findForSurvey: (surveyId: string) => Promise<PendingAttempt | null>;
+    readonly clear: () => Promise<void>;
+}
+export declare function createSurveyStore(writeKey: string): SurveyStore;
+//# sourceMappingURL=survey-store.d.ts.map

package/dist/internal/survey-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"survey-store.d.ts","sourceRoot":"","sources":["../../src/internal/survey-store.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAInE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,QAAQ,CAAC,cAAc,EAAE,CACvB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,QAAQ,EAAE,kBAAkB,KACzB,OAAO,CAAC,IAAI,CAAC,CAAA;IAClB,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA4C/D"}

package/dist/internal/survey-store.js

@@ -0,0 +1,59 @@
+// Per-user, per-survey local cache of in-flight attempts.
+// Used to surface the "Continue your last survey?" prompt on app resume and to
+// keep an attempt recoverable when the network is flaky.
+import { createStorageScope } from './storage.js';
+import { reportError } from './debug.js';
+const PENDING_KEY = 'surveys:pending';
+export function createSurveyStore(writeKey) {
+    const scope = createStorageScope(writeKey);
+    async function list() {
+        try {
+            const arr = await scope.getJson(PENDING_KEY);
+            if (!Array.isArray(arr))
+                return [];
+            return arr.filter(isPending);
+        }
+        catch (err) {
+            reportError('survey-store.list failed', err);
+            return [];
+        }
+    }
+    return {
+        list,
+        async upsert(attempt) {
+            const existing = await list();
+            const filtered = existing.filter((a) => a.attemptId !== attempt.attemptId);
+            await scope.setJson(PENDING_KEY, [...filtered, attempt]);
+        },
+        async remove(attemptId) {
+            const existing = await list();
+            const next = existing.filter((a) => a.attemptId !== attemptId);
+            await scope.setJson(PENDING_KEY, next);
+        },
+        async updateProgress(attemptId, currentQuestionId, snapshot) {
+            const existing = await list();
+            const target = existing.find((attempt) => attempt.attemptId === attemptId);
+            if (!target)
+                return;
+            await scope.setJson(PENDING_KEY, existing.map((attempt) => attempt.attemptId === attemptId
+                ? { ...attempt, currentQuestionId, snapshot }
+                : attempt));
+        },
+        async findForSurvey(surveyId) {
+            const all = await list();
+            return all.find((a) => a.surveyId === surveyId) ?? null;
+        },
+        async clear() {
+            await scope.remove(PENDING_KEY);
+        },
+    };
+}
+function isPending(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const x = v;
+    return (typeof x.surveyId === 'string' &&
+        typeof x.attemptId === 'string' &&
+        typeof x.startedAt === 'number');
+}
+//# sourceMappingURL=survey-store.js.map

package/dist/internal/survey-store.js.map

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