pulse-updates 1.0.14 → 1.0.16

package/lib/module/config.js

@@ -0,0 +1,342 @@
+/**
+ * Pulse Config — the client half of the Firebase Remote Config replacement.
+ *
+ * Why this exists: from 2026-09-01 Firebase bills every Remote Config fetch above
+ * 100k/day and throttles projects that stay on the free plan. Worse than the bill is
+ * the failure mode — the Firebase SDK yields the type's zero value for a key it does
+ * not hold, so a throttled fetch reads as "every flag is false" and, for an ads
+ * config, quietly turns the revenue off.
+ *
+ * The shape here deliberately mirrors what the apps already do with Remote Config —
+ * defaults, fetch, activate, typed getters — so swapping the source is a change of
+ * adapter, not of every call site. Three things are different on purpose:
+ *
+ *  1. A missing key falls back to the registered default, never to false/0. That is
+ *     the exact bug this replaces.
+ *  2. The last good values are persisted and reloaded at boot, so a failed fetch
+ *     degrades to yesterday's config rather than to nothing.
+ *  3. Fetching is cheap (our server, no per-request price), so it happens on launch,
+ *     on every return from foreground, and on a timer — with ETag, so an unchanged
+ *     config costs a 304 with no body.
+ */
+
+/**
+ * Everything the server may ever want to target on. Sent on every request even when
+ * no rule uses it yet: the client can only start sending a new field with a store
+ * build, so a contract that is incomplete today cannot be completed for months.
+ */
+
+const STORAGE_KEY = 'pulse.config.v1';
+const DEFAULT_POLL_MS = 5 * 60 * 1000;
+const DEFAULT_TIMEOUT_MS = 10_000;
+let options = null;
+let defaults = {};
+let values = {};
+let etag = null;
+let fetchedAt = 0;
+let source = 'defaults';
+let pending = null;
+let inFlight = null;
+let pollTimer = null;
+const listeners = new Set();
+
+/**
+ * Registers defaults and reloads the last good payload from storage, synchronously,
+ * so the very first read at boot already has real values instead of a blank config
+ * while the network call is in flight.
+ */
+export function configureConfig(opts) {
+  options = opts;
+  defaults = {
+    ...(opts.defaults ?? {})
+  };
+  const cached = readCache(opts.storage);
+  if (cached) {
+    values = cached.values;
+    etag = cached.etag;
+    fetchedAt = cached.fetchedAt;
+    source = 'cache';
+  }
+}
+
+/** Merge more defaults after configure (a late-loading module registering its own). */
+export function setConfigDefaults(more) {
+  defaults = {
+    ...defaults,
+    ...more
+  };
+}
+
+/**
+ * Fetch, and adopt the payload if it changed. Returns true when new values were
+ * applied — false for "nothing changed" (304) and false for a failure, which are
+ * deliberately indistinguishable to callers: in both cases the current values stand.
+ * Errors surface through onError instead of rejecting, because no caller should have
+ * to wrap a config refresh in a try/catch to keep the app running.
+ */
+export async function fetchConfig() {
+  if (!options) return false;
+  // Collapse concurrent calls (launch + resume can land together) onto one request.
+  if (inFlight) return inFlight;
+  const minInterval = options.minimumFetchIntervalMs ?? 0;
+  if (minInterval > 0 && fetchedAt > 0 && Date.now() - fetchedAt < minInterval) {
+    return false;
+  }
+  inFlight = (async () => {
+    const opts = options;
+    const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+    const timer = controller ? setTimeout(() => controller.abort(), opts.timeoutMs ?? DEFAULT_TIMEOUT_MS) : null;
+    try {
+      const response = await fetch(opts.url, {
+        method: 'GET',
+        headers: buildHeaders(opts, etag),
+        signal: controller?.signal
+      });
+      if (response.status === 304) return false;
+      if (!response.ok) throw new Error(`Pulse config HTTP ${response.status}`);
+      const payload = await response.json();
+      const nextValues = payload?.values;
+      // A payload without a values object is a broken response, not "no keys": adopting
+      // it would blank every flag at once.
+      if (!nextValues || typeof nextValues !== 'object' || Array.isArray(nextValues)) {
+        throw new Error('Pulse config: malformed payload');
+      }
+      etag = response.headers?.get?.('etag') ?? null;
+      fetchedAt = Date.now();
+      if (opts.activateOnFetch === false) {
+        pending = nextValues;
+        return false;
+      }
+      return applyValues(nextValues, opts);
+    } catch (error) {
+      // A failed refresh must never clear what we have: the whole point of the cache
+      // is that an unreachable server degrades to the last good config.
+      opts.onError?.(error);
+      return false;
+    } finally {
+      if (timer) clearTimeout(timer);
+      inFlight = null;
+    }
+  })();
+  return inFlight;
+}
+
+/**
+ * Swap in the values from the last fetch made with activateOnFetch: false.
+ * Returns true when something actually changed.
+ */
+export function activateConfig() {
+  if (!pending || !options) return false;
+  const next = pending;
+  pending = null;
+  return applyValues(next, options);
+}
+
+/** Whether a fetched-but-not-yet-applied payload is waiting. */
+export function hasPendingConfig() {
+  return pending !== null;
+}
+
+/**
+ * Fetch on launch, on every return to the foreground, and on a timer.
+ * Returns a function that stops both.
+ */
+export function startConfigAutoRefresh(appState) {
+  void fetchConfig();
+  const subscription = appState?.addEventListener('change', state => {
+    if (state === 'active') void fetchConfig();
+  });
+  const interval = options?.pollIntervalMs ?? DEFAULT_POLL_MS;
+  if (interval > 0) {
+    stopPolling();
+    pollTimer = setInterval(() => void fetchConfig(), interval);
+  }
+  return () => {
+    subscription?.remove();
+    stopPolling();
+  };
+}
+function applyValues(next, opts) {
+  const changed = !shallowEqual(values, next);
+  values = next;
+  source = 'remote';
+  writeCache(opts.storage, {
+    values,
+    etag,
+    fetchedAt
+  });
+
+  // Listeners drive re-renders and gate re-evaluation: firing them for an identical
+  // payload is pure churn, and the 200-with-same-content case is common enough
+  // (a proxy that drops the ETag) to be worth checking.
+  if (changed) notify();
+  return changed;
+}
+function shallowEqual(a, b) {
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  return aKeys.every(k => {
+    const av = a[k];
+    const bv = b[k];
+    if (av !== null && bv !== null && typeof av === 'object' && typeof bv === 'object') {
+      return JSON.stringify(av) === JSON.stringify(bv);
+    }
+    return av === bv;
+  });
+}
+function stopPolling() {
+  if (pollTimer) {
+    clearInterval(pollTimer);
+    pollTimer = null;
+  }
+}
+
+// ─── Reads ────────────────────────────────────────────────────────────────────
+
+/** The served value, or the registered default. Never a type's zero value. */
+export function getConfigValue(key) {
+  if (Object.prototype.hasOwnProperty.call(values, key) && values[key] !== null) {
+    return values[key];
+  }
+  const fallback = defaults[key];
+  return fallback === undefined ? null : fallback;
+}
+export function getConfigBoolean(key) {
+  const value = getConfigValue(key);
+  if (typeof value === 'boolean') return value;
+  // A server that sends "true" as a string must not read as false.
+  if (typeof value === 'string') return value.toLowerCase() === 'true';
+  if (typeof value === 'number') return value !== 0;
+  return false;
+}
+export function getConfigNumber(key) {
+  const value = getConfigValue(key);
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') {
+    const parsed = Number(value);
+    if (!Number.isNaN(parsed)) return parsed;
+  }
+  return 0;
+}
+export function getConfigString(key) {
+  const value = getConfigValue(key);
+  if (typeof value === 'string') return value;
+  if (value === null || value === undefined) return '';
+  return String(value);
+}
+
+/** Defaults first, then everything the server sent — what a caller would see key by key. */
+export function getAllConfig() {
+  return {
+    ...defaults,
+    ...values
+  };
+}
+
+/** Parsed object/array value, or the default. Null when neither is usable. */
+export function getConfigJson(key) {
+  const value = getConfigValue(key);
+  if (value === null || value === undefined) return null;
+  if (typeof value === 'object') return value;
+  if (typeof value === 'string') {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/** Where this key's value came from — the answer to "why is this flag off?". */
+export function getConfigSource(key) {
+  if (Object.prototype.hasOwnProperty.call(values, key) && values[key] !== null) return 'remote';
+  if (Object.prototype.hasOwnProperty.call(defaults, key)) return 'default';
+  return 'missing';
+}
+export function getConfigKeys() {
+  return Object.keys(getAllConfig()).sort();
+}
+export function onConfigChange(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+
+/** For diagnostics: where the current values came from and how old they are. */
+export function getConfigInfo() {
+  return {
+    source,
+    fetchedAt,
+    etag,
+    keyCount: Object.keys(getAllConfig()).length
+  };
+}
+
+/** Test seam: drops every piece of module state. */
+export function resetConfigForTests() {
+  options = null;
+  defaults = {};
+  values = {};
+  etag = null;
+  fetchedAt = 0;
+  source = 'defaults';
+  inFlight = null;
+  pending = null;
+  listeners.clear();
+  stopPolling();
+}
+
+// ─── Internals ────────────────────────────────────────────────────────────────
+
+function buildHeaders(opts, currentEtag) {
+  const ctx = opts.getContext?.() ?? {};
+  const headers = {
+    Accept: 'application/json'
+  };
+  if (ctx.platform) headers['X-Pulse-Platform'] = ctx.platform;
+  if (ctx.appVersion) headers['X-Pulse-App-Version'] = ctx.appVersion;
+  if (ctx.osVersion) headers['X-Pulse-Os-Version'] = ctx.osVersion;
+  if (ctx.language) headers['X-Pulse-Language'] = ctx.language;
+  if (ctx.deviceId) headers['Pulse-Device-Id'] = ctx.deviceId;
+  if (ctx.userAttributes && Object.keys(ctx.userAttributes).length > 0) {
+    headers['X-Pulse-User-Attributes'] = JSON.stringify(ctx.userAttributes);
+  }
+  // Country is deliberately absent: the server reads it from the edge, which a client
+  // header cannot spoof to opt into a targeted rollout.
+
+  if (currentEtag) headers['If-None-Match'] = currentEtag;
+  return headers;
+}
+function readCache(storage) {
+  if (!storage) return null;
+  try {
+    const raw = storage.getString(STORAGE_KEY);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || !parsed.values) return null;
+    return parsed;
+  } catch {
+    // A corrupt cache is not worth a crash at boot: fall back to defaults.
+    return null;
+  }
+}
+function writeCache(storage, payload) {
+  if (!storage) return;
+  try {
+    storage.set(STORAGE_KEY, JSON.stringify(payload));
+  } catch {
+    // Persistence is an optimisation; failing to write must not fail the fetch.
+  }
+}
+function notify() {
+  const snapshot = getAllConfig();
+  listeners.forEach(listener => {
+    try {
+      listener(snapshot);
+    } catch {
+      // One bad listener must not stop the others from being told.
+    }
+  });
+}
+//# sourceMappingURL=config.js.map

package/lib/module/config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORAGE_KEY","DEFAULT_POLL_MS","DEFAULT_TIMEOUT_MS","options","defaults","values","etag","fetchedAt","source","pending","inFlight","pollTimer","listeners","Set","configureConfig","opts","cached","readCache","storage","setConfigDefaults","more","fetchConfig","minInterval","minimumFetchIntervalMs","Date","now","controller","AbortController","timer","setTimeout","abort","timeoutMs","response","fetch","url","method","headers","buildHeaders","signal","status","ok","Error","payload","json","nextValues","Array","isArray","get","activateOnFetch","applyValues","error","onError","clearTimeout","activateConfig","next","hasPendingConfig","startConfigAutoRefresh","appState","subscription","addEventListener","state","interval","pollIntervalMs","stopPolling","setInterval","remove","changed","shallowEqual","writeCache","notify","a","b","aKeys","Object","keys","bKeys","length","every","k","av","bv","JSON","stringify","clearInterval","getConfigValue","key","prototype","hasOwnProperty","call","fallback","undefined","getConfigBoolean","value","toLowerCase","getConfigNumber","parsed","Number","isNaN","getConfigString","String","getAllConfig","getConfigJson","parse","getConfigSource","getConfigKeys","sort","onConfigChange","listener","add","delete","getConfigInfo","keyCount","resetConfigForTests","clear","currentEtag","ctx","getContext","Accept","platform","appVersion","osVersion","language","deviceId","userAttributes","raw","getString","set","snapshot","forEach"],"sourceRoot":"../../src","sources":["config.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -2,4 +2,5 @@ export * from './PulseUpdates';
 export * from './types';
 export { usePulseUpdates } from './usePulseUpdates';
 export { initializeAssetResolver, updateLocalAssets } from './assetResolver';
+export * from './config';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["usePulseUpdates","initializeAssetResolver","updateLocalAssets"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA,cAAc,gBAAgB;AAC9B,cAAc,SAAS;AACvB,SAASA,eAAe,QAAQ,mBAAmB;AACnD,SAASC,uBAAuB,EAAEC,iBAAiB,QAAQ,iBAAiB","ignoreList":[]}
+{"version":3,"names":["usePulseUpdates","initializeAssetResolver","updateLocalAssets"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA,cAAc,gBAAgB;AAC9B,cAAc,SAAS;AACvB,SAASA,eAAe,QAAQ,mBAAmB;AACnD,SAASC,uBAAuB,EAAEC,iBAAiB,QAAQ,iBAAiB;AAC5E,cAAc,UAAU","ignoreList":[]}

package/lib/typescript/config.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Pulse Config — the client half of the Firebase Remote Config replacement.
+ *
+ * Why this exists: from 2026-09-01 Firebase bills every Remote Config fetch above
+ * 100k/day and throttles projects that stay on the free plan. Worse than the bill is
+ * the failure mode — the Firebase SDK yields the type's zero value for a key it does
+ * not hold, so a throttled fetch reads as "every flag is false" and, for an ads
+ * config, quietly turns the revenue off.
+ *
+ * The shape here deliberately mirrors what the apps already do with Remote Config —
+ * defaults, fetch, activate, typed getters — so swapping the source is a change of
+ * adapter, not of every call site. Three things are different on purpose:
+ *
+ *  1. A missing key falls back to the registered default, never to false/0. That is
+ *     the exact bug this replaces.
+ *  2. The last good values are persisted and reloaded at boot, so a failed fetch
+ *     degrades to yesterday's config rather than to nothing.
+ *  3. Fetching is cheap (our server, no per-request price), so it happens on launch,
+ *     on every return from foreground, and on a timer — with ETag, so an unchanged
+ *     config costs a 304 with no body.
+ */
+export type ConfigValue = boolean | number | string | null | object;
+export interface ConfigStorage {
+    getString(key: string): string | null | undefined;
+    set(key: string, value: string): void;
+}
+/**
+ * Everything the server may ever want to target on. Sent on every request even when
+ * no rule uses it yet: the client can only start sending a new field with a store
+ * build, so a contract that is incomplete today cannot be completed for months.
+ */
+export interface ConfigContext {
+    platform?: string;
+    appVersion?: string;
+    osVersion?: string;
+    language?: string;
+    deviceId?: string;
+    /** Free-form user attributes a rule can compare (registration date, plan, counters). */
+    userAttributes?: Record<string, string>;
+}
+export interface ConfigOptions {
+    /** Full manifest-style URL, e.g. https://pulse.example.com/pulse/config/esound */
+    url: string;
+    /** Values used when the server has never been reached, or has no such key. */
+    defaults?: Record<string, ConfigValue>;
+    /** Persistence for the last good payload. Without it the cache is memory-only. */
+    storage?: ConfigStorage;
+    /** Read fresh on every request: the country or plan can change between launches. */
+    getContext?: () => ConfigContext;
+    /** Foreground poll interval. 0 disables polling (launch + resume still fetch). */
+    pollIntervalMs?: number;
+    /**
+     * Skip a fetch that lands within this window of the last successful one. 0 (the
+     * default) means never skip: unlike Firebase there is no per-request price, so the
+     * throttle exists only for callers who want it.
+     */
+    minimumFetchIntervalMs?: number;
+    /**
+     * When false, a fetch stores the payload without applying it — call activateConfig()
+     * to swap it in. Mirrors Firebase's fetch/activate split, and matters here because
+     * the foreground poll would otherwise flip a flag under a user mid-session: an ad
+     * gate or a playback engine changing while a track plays is worse than being a few
+     * minutes stale. Default true, matching fetchAndActivate.
+     */
+    activateOnFetch?: boolean;
+    /** Network timeout per request. */
+    timeoutMs?: number;
+    onError?: (error: unknown) => void;
+}
+/**
+ * Registers defaults and reloads the last good payload from storage, synchronously,
+ * so the very first read at boot already has real values instead of a blank config
+ * while the network call is in flight.
+ */
+export declare function configureConfig(opts: ConfigOptions): void;
+/** Merge more defaults after configure (a late-loading module registering its own). */
+export declare function setConfigDefaults(more: Record<string, ConfigValue>): void;
+/**
+ * Fetch, and adopt the payload if it changed. Returns true when new values were
+ * applied — false for "nothing changed" (304) and false for a failure, which are
+ * deliberately indistinguishable to callers: in both cases the current values stand.
+ * Errors surface through onError instead of rejecting, because no caller should have
+ * to wrap a config refresh in a try/catch to keep the app running.
+ */
+export declare function fetchConfig(): Promise<boolean>;
+/**
+ * Swap in the values from the last fetch made with activateOnFetch: false.
+ * Returns true when something actually changed.
+ */
+export declare function activateConfig(): boolean;
+/** Whether a fetched-but-not-yet-applied payload is waiting. */
+export declare function hasPendingConfig(): boolean;
+/**
+ * Fetch on launch, on every return to the foreground, and on a timer.
+ * Returns a function that stops both.
+ */
+export declare function startConfigAutoRefresh(appState?: {
+    addEventListener: (type: 'change', handler: (state: string) => void) => {
+        remove: () => void;
+    };
+}): () => void;
+/** The served value, or the registered default. Never a type's zero value. */
+export declare function getConfigValue(key: string): ConfigValue;
+export declare function getConfigBoolean(key: string): boolean;
+export declare function getConfigNumber(key: string): number;
+export declare function getConfigString(key: string): string;
+/** Defaults first, then everything the server sent — what a caller would see key by key. */
+export declare function getAllConfig(): Record<string, ConfigValue>;
+/** Parsed object/array value, or the default. Null when neither is usable. */
+export declare function getConfigJson<T = unknown>(key: string): T | null;
+/** Where this key's value came from — the answer to "why is this flag off?". */
+export declare function getConfigSource(key: string): 'remote' | 'default' | 'missing';
+export declare function getConfigKeys(): string[];
+export declare function onConfigChange(listener: (values: Record<string, ConfigValue>) => void): () => void;
+/** For diagnostics: where the current values came from and how old they are. */
+export declare function getConfigInfo(): {
+    source: 'defaults' | 'cache' | 'remote';
+    fetchedAt: number;
+    etag: string | null;
+    keyCount: number;
+};
+/** Test seam: drops every piece of module state. */
+export declare function resetConfigForTests(): void;
+//# sourceMappingURL=config.d.ts.map

package/lib/typescript/config.d.ts.map

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

package/lib/typescript/index.d.ts

@@ -2,4 +2,5 @@ export * from './PulseUpdates';
 export * from './types';
 export { usePulseUpdates } from './usePulseUpdates';
 export { initializeAssetResolver, updateLocalAssets } from './assetResolver';
+export * from './config';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulse-updates",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "OTA updates for React Native - lightweight alternative to expo-updates",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",