@chipmobilesdk/rn-core 0.1.0 → 0.2.0

package/lib/module/scheduler/index.js

@@ -0,0 +1,203 @@
+"use strict";
+
+/**
+ * Time, retries, concurrency and bounds, shared by every package (CORE-04,
+ * CORE-05).
+ *
+ * rn-ads and rn-payment each had their own copy of these, and the copies had
+ * drifted: one validated a backoff and the other did not, one reported a retry
+ * policy out of bounds under a timeout's error code. Packages keep their domain
+ * defaults and bounds; the mechanism lives here, and bounds checks take a `fail`
+ * callback so each package raises its own error with its own code.
+ */
+import { reportAsynchronously } from "../listeners/index.js";
+
+/**
+ * How timers are scheduled. Injectable so a test drives backoff and expiry by
+ * moving a clock instead of waiting.
+ */
+
+export const realScheduler = {
+  setTimeout: (callback, ms) => setTimeout(callback, ms),
+  clearTimeout: handle => clearTimeout(handle)
+};
+
+/**
+ * Every timer an owner started, so disposing it can prove nothing is left: a
+ * leaked timer is otherwise invisible until it fires into a disposed consumer.
+ */
+
+export function createTimerSet(scheduler = realScheduler) {
+  const handles = new Set();
+  return {
+    after(ms, callback) {
+      const handle = scheduler.setTimeout(() => {
+        handles.delete(handle);
+        callback();
+      }, ms);
+      handles.add(handle);
+      let cleared = false;
+      return () => {
+        if (cleared) return;
+        cleared = true;
+        scheduler.clearTimeout(handle);
+        handles.delete(handle);
+      };
+    },
+    clearAll() {
+      for (const handle of handles) scheduler.clearTimeout(handle);
+      handles.clear();
+    },
+    size: () => handles.size
+  };
+}
+/** Delay before `attempt`, 1-based: initial × factor^(attempt−1), capped, maybe jittered. */
+export function computeBackoff(attempt, spec, random = Math.random) {
+  const raw = spec.initialDelayMs * Math.pow(spec.factor ?? 2, Math.max(0, attempt - 1));
+  const capped = Math.min(raw, spec.maxDelayMs);
+  return spec.jitter === 'full' ? Math.floor(capped * random()) : capped;
+}
+/** Runs `attempt` now, then on the backoff schedule until it succeeds, is cancelled or runs out. */
+export function runWithRetry(options) {
+  const {
+    spec,
+    attempt,
+    onExhausted
+  } = options;
+  const scheduler = options.scheduler ?? realScheduler;
+  const random = options.random ?? Math.random;
+  let count = 0;
+  let cancelled = false;
+  let pending;
+  const run = async () => {
+    if (cancelled) return;
+    count += 1;
+    let succeeded = false;
+    try {
+      succeeded = await attempt(count);
+    } catch {
+      // A throwing attempt is a failed attempt; letting it escape would
+      // abandon the schedule.
+      succeeded = false;
+    }
+    if (cancelled || succeeded) return;
+    if (count >= spec.maxAttempts) {
+      onExhausted?.(count);
+      return;
+    }
+    pending = scheduler.setTimeout(() => {
+      pending = undefined;
+      start();
+    }, computeBackoff(count + 1, spec, random));
+  };
+  // Only `onExhausted` can throw past `run`; that is reported, not swallowed.
+  const start = () => {
+    run().catch(reportAsynchronously);
+  };
+  start();
+  return {
+    cancel() {
+      cancelled = true;
+      if (pending !== undefined) {
+        scheduler.clearTimeout(pending);
+        pending = undefined;
+      }
+    },
+    attempts: () => count,
+    exhausted: () => count >= spec.maxAttempts
+  };
+}
+
+/**
+ * Joins concurrent callers onto one in-flight operation. Once it settles the
+ * slot clears, so a later call starts fresh: de-duplication, not caching.
+ */
+export function createSingleFlight() {
+  let current;
+  return {
+    run(operation) {
+      if (current) return current;
+      const flight = operation().finally(() => {
+        if (current === flight) current = undefined;
+      });
+      current = flight;
+      return flight;
+    },
+    inFlight: () => current !== undefined
+  };
+}
+
+/** Distinguishes "refused because busy" from any other failure, without throwing. */
+
+/** Admits one operation at a time and refuses the rest, rather than queueing them. */
+export function createExclusive() {
+  let held = false;
+  return {
+    async run(operation) {
+      if (held) return {
+        acquired: false
+      };
+      held = true;
+      try {
+        return {
+          acquired: true,
+          value: await operation()
+        };
+      } finally {
+        held = false;
+      }
+    },
+    busy: () => held
+  };
+}
+
+/** Admits at most one call per `minIntervalMs`; a refused call is dropped, not deferred. */
+export function createRateLimiter(minIntervalMs, now = Date.now) {
+  let lastAt;
+  return {
+    tryAcquire() {
+      const at = now();
+      if (lastAt !== undefined && at - lastAt < minIntervalMs) return false;
+      lastAt = at;
+      return true;
+    },
+    reset() {
+      lastAt = undefined;
+    }
+  };
+}
+
+/**
+ * Rejects with `onTimeout()` after `ms`. Always clears its timer, including when
+ * the promise wins, so no operation leaks one.
+ */
+export function withTimeout(promise, ms, onTimeout, scheduler = realScheduler) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = scheduler.setTimeout(() => reject(onTimeout()), ms);
+  });
+  return Promise.race([promise, timeout]).finally(() => {
+    if (timer !== undefined) scheduler.clearTimeout(timer);
+  });
+}
+/**
+ * `value` when it is a finite number inside `range`; otherwise throws what `fail`
+ * builds. Out-of-range values are rejected, never clamped: clamping tells an app
+ * it configured something it did not.
+ */
+export function checkRange(label, value, range, fail, unit = '') {
+  if (!Number.isFinite(value) || value < range.min || value > range.max) {
+    throw fail(`${label} must be between ${range.min}${unit} and ${range.max}${unit}; received ${value}`);
+  }
+  return value;
+}
+
+/** As `checkRange`, and a whole number. */
+export function checkInteger(label, value, range, fail) {
+  checkRange(label, value, range, fail);
+  if (!Number.isInteger(value)) {
+    throw fail(`${label} must be a whole number; received ${value}`);
+  }
+  return value;
+}
+//# sourceMappingURL=index.js.map

package/lib/module/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["reportAsynchronously","realScheduler","setTimeout","callback","ms","clearTimeout","handle","createTimerSet","scheduler","handles","Set","after","delete","add","cleared","clearAll","clear","size","computeBackoff","attempt","spec","random","Math","raw","initialDelayMs","pow","factor","max","capped","min","maxDelayMs","jitter","floor","runWithRetry","options","onExhausted","count","cancelled","pending","run","succeeded","maxAttempts","undefined","start","catch","cancel","attempts","exhausted","createSingleFlight","current","operation","flight","finally","inFlight","createExclusive","held","acquired","value","busy","createRateLimiter","minIntervalMs","now","Date","lastAt","tryAcquire","at","reset","withTimeout","promise","onTimeout","timer","timeout","Promise","_","reject","race","checkRange","label","range","fail","unit","Number","isFinite","checkInteger","isInteger"],"sourceRoot":"../../../src","sources":["scheduler/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/store/index.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/**
+ * A store whose snapshot keeps its identity until the state actually changes,
+ * which is what `useSyncExternalStore` needs (CORE-07). No React here: a package's
+ * pure core can hold its state in one, and its hooks read it through
+ * `@chipmobilesdk/rn-core/react`.
+ */
+import { createListenerSet } from "../listeners/index.js";
+export function createStore(initial, isEqual = Object.is) {
+  let snapshot = initial;
+  const listeners = createListenerSet();
+  return {
+    getSnapshot: () => snapshot,
+    setState(next) {
+      const value = typeof next === 'function' ? next(snapshot) : next;
+      if (isEqual(snapshot, value)) return;
+      snapshot = value;
+      listeners.notify();
+    },
+    subscribe: listener => listeners.add(listener)
+  };
+}
+
+/** Same keys, and each value `Object.is` the other's. */
+export function shallowEqual(a, b) {
+  if (Object.is(a, b)) return true;
+  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;
+  const keysA = Object.keys(a);
+  if (keysA.length !== Object.keys(b).length) return false;
+  return keysA.every(key => Object.prototype.hasOwnProperty.call(b, key) && Object.is(a[key], b[key]));
+}
+//# sourceMappingURL=index.js.map

package/lib/module/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createListenerSet","createStore","initial","isEqual","Object","is","snapshot","listeners","getSnapshot","setState","next","value","notify","subscribe","listener","add","shallowEqual","a","b","keysA","keys","length","every","key","prototype","hasOwnProperty","call"],"sourceRoot":"../../../src","sources":["store/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,iBAAiB,QAA0B,uBAAc;AAUlE,OAAO,SAASC,WAAWA,CAAIC,OAAU,EAAEC,OAAgC,GAAGC,MAAM,CAACC,EAAE,EAAY;EAClG,IAAIC,QAAQ,GAAGJ,OAAO;EACtB,MAAMK,SAAS,GAAGP,iBAAiB,CAAK,CAAC;EACzC,OAAO;IACNQ,WAAW,EAAEA,CAAA,KAAMF,QAAQ;IAC3BG,QAAQA,CAACC,IAAI,EAAE;MACd,MAAMC,KAAK,GAAG,OAAOD,IAAI,KAAK,UAAU,GAAIA,IAAI,CAAwBJ,QAAQ,CAAC,GAAGI,IAAI;MACxF,IAAIP,OAAO,CAACG,QAAQ,EAAEK,KAAK,CAAC,EAAE;MAC9BL,QAAQ,GAAGK,KAAK;MAChBJ,SAAS,CAACK,MAAM,CAAC,CAAC;IACnB,CAAC;IACDC,SAAS,EAAEC,QAAQ,IAAIP,SAAS,CAACQ,GAAG,CAACD,QAAQ;EAC9C,CAAC;AACF;;AAEA;AACA,OAAO,SAASE,YAAYA,CAAIC,CAAI,EAAEC,CAAI,EAAW;EACpD,IAAId,MAAM,CAACC,EAAE,CAACY,CAAC,EAAEC,CAAC,CAAC,EAAE,OAAO,IAAI;EAChC,IAAI,OAAOD,CAAC,KAAK,QAAQ,IAAI,OAAOC,CAAC,KAAK,QAAQ,IAAID,CAAC,KAAK,IAAI,IAAIC,CAAC,KAAK,IAAI,EAAE,OAAO,KAAK;EAC5F,MAAMC,KAAK,GAAGf,MAAM,CAACgB,IAAI,CAACH,CAAC,CAAC;EAC5B,IAAIE,KAAK,CAACE,MAAM,KAAKjB,MAAM,CAACgB,IAAI,CAACF,CAAC,CAAC,CAACG,MAAM,EAAE,OAAO,KAAK;EACxD,OAAOF,KAAK,CAACG,KAAK,CACjBC,GAAG,IACFnB,MAAM,CAACoB,SAAS,CAACC,cAAc,CAACC,IAAI,CAACR,CAAC,EAAEK,GAAG,CAAC,IAC5CnB,MAAM,CAACC,EAAE,CAAEY,CAAC,CAA6BM,GAAG,CAAC,EAAGL,CAAC,CAA6BK,GAAG,CAAC,CACpF,CAAC;AACF","ignoreList":[]}

package/lib/module/testing/conformance.js

@@ -0,0 +1,72 @@
+"use strict";
+
+/**
+ * A conformance harness that runs in Jest and on a device alike (CORE-13, IOS-12).
+ *
+ * A package describes what any implementation of one of its ports must do as a
+ * list of checks. The same list runs against the fake its tests use and against
+ * the real adapter (with the native module mocked in Jest, or for real in a demo
+ * screen), so the fake cannot drift from the adapter it stands in for. A report
+ * is plain data; `expectConformance` turns a failing one into a Jest failure.
+ */
+
+/** Runs every check against a fresh subject, so no check depends on another's leftovers. */
+export async function runChecks(makeSubject, checks) {
+  const failures = [];
+  for (const check of checks) {
+    try {
+      await check.run(await makeSubject());
+    } catch (error) {
+      failures.push({
+        check: check.name,
+        detail: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return {
+    passed: failures.length === 0,
+    checks: checks.length,
+    failures
+  };
+}
+
+/** Throws one error listing every failed check, for a test runner to report. */
+export function expectConformance(report, subject = 'implementation') {
+  if (report.passed) return;
+  const lines = report.failures.map(failure => `  - ${failure.check}: ${failure.detail}`);
+  throw new Error(`${subject} failed ${report.failures.length} of ${report.checks} checks:\n${lines.join('\n')}`);
+}
+
+/** A failed expectation inside a check. */
+export function ensure(condition, message) {
+  if (!condition) throw new Error(message);
+}
+/**
+ * Deterministic fault injection: a fake or an adapter calls `throwIfFaulted` at its
+ * named points, and a test arms the ones it wants to fail (CORE-13, NOT-22).
+ */
+export function createFaultRegistry() {
+  const armed = new Map();
+  const fired = new Set();
+  return {
+    arm(point, fault, times = 1) {
+      armed.set(point, {
+        fault,
+        remaining: times
+      });
+    },
+    disarm(point) {
+      if (point === undefined) armed.clear();else armed.delete(point);
+    },
+    throwIfFaulted(point) {
+      const entry = armed.get(point);
+      if (!entry) return;
+      entry.remaining -= 1;
+      if (entry.remaining <= 0) armed.delete(point);
+      fired.add(point);
+      throw entry.fault();
+    },
+    fired: () => [...fired]
+  };
+}
+//# sourceMappingURL=conformance.js.map

package/lib/module/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["runChecks","makeSubject","checks","failures","check","run","error","push","name","detail","Error","message","String","passed","length","expectConformance","report","subject","lines","map","failure","join","ensure","condition","createFaultRegistry","armed","Map","fired","Set","arm","point","fault","times","set","remaining","disarm","undefined","clear","delete","throwIfFaulted","entry","get","add"],"sourceRoot":"../../../src","sources":["testing/conformance.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA,OAAO,eAAeA,SAASA,CAC9BC,WAA6C,EAC7CC,MAAiC,EACJ;EAC7B,MAAMC,QAA8B,GAAG,EAAE;EACzC,KAAK,MAAMC,KAAK,IAAIF,MAAM,EAAE;IAC3B,IAAI;MACH,MAAME,KAAK,CAACC,GAAG,CAAC,MAAMJ,WAAW,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,OAAOK,KAAK,EAAE;MACfH,QAAQ,CAACI,IAAI,CAAC;QACbH,KAAK,EAAEA,KAAK,CAACI,IAAI;QACjBC,MAAM,EAAEH,KAAK,YAAYI,KAAK,GAAGJ,KAAK,CAACK,OAAO,GAAGC,MAAM,CAACN,KAAK;MAC9D,CAAC,CAAC;IACH;EACD;EACA,OAAO;IAAEO,MAAM,EAAEV,QAAQ,CAACW,MAAM,KAAK,CAAC;IAAEZ,MAAM,EAAEA,MAAM,CAACY,MAAM;IAAEX;EAAS,CAAC;AAC1E;;AAEA;AACA,OAAO,SAASY,iBAAiBA,CAACC,MAAyB,EAAEC,OAAO,GAAG,gBAAgB,EAAQ;EAC9F,IAAID,MAAM,CAACH,MAAM,EAAE;EACnB,MAAMK,KAAK,GAAGF,MAAM,CAACb,QAAQ,CAACgB,GAAG,CAACC,OAAO,IAAI,OAAOA,OAAO,CAAChB,KAAK,KAAKgB,OAAO,CAACX,MAAM,EAAE,CAAC;EACvF,MAAM,IAAIC,KAAK,CACd,GAAGO,OAAO,WAAWD,MAAM,CAACb,QAAQ,CAACW,MAAM,OAAOE,MAAM,CAACd,MAAM,aAAagB,KAAK,CAACG,IAAI,CAAC,IAAI,CAAC,EAC7F,CAAC;AACF;;AAEA;AACA,OAAO,SAASC,MAAMA,CAACC,SAAkB,EAAEZ,OAAe,EAAqB;EAC9E,IAAI,CAACY,SAAS,EAAE,MAAM,IAAIb,KAAK,CAACC,OAAO,CAAC;AACzC;AAYA;AACA;AACA;AACA;AACA,OAAO,SAASa,mBAAmBA,CAAA,EAA+C;EACjF,MAAMC,KAAK,GAAG,IAAIC,GAAG,CAAmD,CAAC;EACzE,MAAMC,KAAK,GAAG,IAAIC,GAAG,CAAQ,CAAC;EAC9B,OAAO;IACNC,GAAGA,CAACC,KAAK,EAAEC,KAAK,EAAEC,KAAK,GAAG,CAAC,EAAE;MAC5BP,KAAK,CAACQ,GAAG,CAACH,KAAK,EAAE;QAAEC,KAAK;QAAEG,SAAS,EAAEF;MAAM,CAAC,CAAC;IAC9C,CAAC;IACDG,MAAMA,CAACL,KAAK,EAAE;MACb,IAAIA,KAAK,KAAKM,SAAS,EAAEX,KAAK,CAACY,KAAK,CAAC,CAAC,CAAC,KAClCZ,KAAK,CAACa,MAAM,CAACR,KAAK,CAAC;IACzB,CAAC;IACDS,cAAcA,CAACT,KAAK,EAAE;MACrB,MAAMU,KAAK,GAAGf,KAAK,CAACgB,GAAG,CAACX,KAAK,CAAC;MAC9B,IAAI,CAACU,KAAK,EAAE;MACZA,KAAK,CAACN,SAAS,IAAI,CAAC;MACpB,IAAIM,KAAK,CAACN,SAAS,IAAI,CAAC,EAAET,KAAK,CAACa,MAAM,CAACR,KAAK,CAAC;MAC7CH,KAAK,CAACe,GAAG,CAACZ,KAAK,CAAC;MAChB,MAAMU,KAAK,CAACT,KAAK,CAAC,CAAC;IACpB,CAAC;IACDJ,KAAK,EAAEA,CAAA,KAAM,CAAC,GAAGA,KAAK;EACvB,CAAC;AACF","ignoreList":[]}

package/lib/module/testing/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+/**
+ * Test helpers shared by every package: conformance suites that return plain
+ * reports, so they run in Jest and on a device alike. Production code never
+ * imports this entrypoint.
+ */
+export { REDACTION_PROBES, redactionConformance } from "./redaction.js";
+export { createManualScheduler } from "./scheduler.js";
+export { createFaultRegistry, ensure, expectConformance, runChecks } from "./conformance.js";
+export { createManualLifecycle } from "./lifecycle.js";
+//# sourceMappingURL=index.js.map

package/lib/module/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["REDACTION_PROBES","redactionConformance","createManualScheduler","createFaultRegistry","ensure","expectConformance","runChecks","createManualLifecycle"],"sourceRoot":"../../../src","sources":["testing/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,SACCA,gBAAgB,EAChBC,oBAAoB,QAId,gBAAa;AACpB,SAASC,qBAAqB,QAA8B,gBAAa;AACzE,SACCC,mBAAmB,EACnBC,MAAM,EACNC,iBAAiB,EACjBC,SAAS,QAGH,kBAAe;AACtB,SAASC,qBAAqB,QAA8B,gBAAa","ignoreList":[]}

package/lib/module/testing/lifecycle.js

@@ -0,0 +1,32 @@
+"use strict";
+
+/**
+ * A lifecycle a test moves by hand (CORE-14). It runs the real port over a scripted
+ * `AppState`, so transitions, de-duplication and reference counting behave exactly
+ * as they do on a device.
+ */
+import { createAppLifecycle } from "../runtime/lifecycle.js";
+export function createManualLifecycle(initial = 'active') {
+  let state = initial;
+  const handlers = new Set();
+  const source = {
+    get currentState() {
+      return state;
+    },
+    addEventListener(_type, handler) {
+      handlers.add(handler);
+      return {
+        remove: () => handlers.delete(handler)
+      };
+    }
+  };
+  return {
+    port: createAppLifecycle(() => source),
+    set(next) {
+      state = next;
+      for (const handler of [...handlers]) handler(next);
+    },
+    isSubscribed: () => handlers.size > 0
+  };
+}
+//# sourceMappingURL=lifecycle.js.map

package/lib/module/testing/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createAppLifecycle","createManualLifecycle","initial","state","handlers","Set","source","currentState","addEventListener","_type","handler","add","remove","delete","port","set","next","isSubscribed","size"],"sourceRoot":"../../../src","sources":["testing/lifecycle.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,SACCA,kBAAkB,QAIZ,yBAAsB;AAU7B,OAAO,SAASC,qBAAqBA,CAACC,OAA0B,GAAG,QAAQ,EAAmB;EAC7F,IAAIC,KAAwB,GAAGD,OAAO;EACtC,MAAME,QAAQ,GAAG,IAAIC,GAAG,CAAwB,CAAC;EACjD,MAAMC,MAAsB,GAAG;IAC9B,IAAIC,YAAYA,CAAA,EAAG;MAClB,OAAOJ,KAAK;IACb,CAAC;IACDK,gBAAgBA,CAACC,KAAK,EAAEC,OAAO,EAAE;MAChCN,QAAQ,CAACO,GAAG,CAACD,OAAO,CAAC;MACrB,OAAO;QAAEE,MAAM,EAAEA,CAAA,KAAMR,QAAQ,CAACS,MAAM,CAACH,OAAO;MAAE,CAAC;IAClD;EACD,CAAC;EACD,OAAO;IACNI,IAAI,EAAEd,kBAAkB,CAAC,MAAMM,MAAM,CAAC;IACtCS,GAAGA,CAACC,IAAI,EAAE;MACTb,KAAK,GAAGa,IAAI;MACZ,KAAK,MAAMN,OAAO,IAAI,CAAC,GAAGN,QAAQ,CAAC,EAAEM,OAAO,CAACM,IAAI,CAAC;IACnD,CAAC;IACDC,YAAY,EAAEA,CAAA,KAAMb,QAAQ,CAACc,IAAI,GAAG;EACrC,CAAC;AACF","ignoreList":[]}

package/lib/module/testing/redaction.js

@@ -0,0 +1,113 @@
+"use strict";
+
+/**
+ * One set of secrets every package's redaction must remove (CORE-02).
+ *
+ * Packages redact with different policies (identifier-only, pattern-based,
+ * key-based), but none of them may let one of these through. Each package runs
+ * this against every redaction entrypoint it has; the report is plain data, so it
+ * runs in Jest and on a device alike.
+ */
+
+const JWT_PAYLOAD = 'eyJzdWIiOiJ1c2VyLTEyMzQ1Njc4OTAiLCJlbWFpbCI6ImFAYi5jbyJ9';
+const JWT = `eyJhbGciOiJIUzI1NiJ9.${JWT_PAYLOAD}.c2lnbmF0dXJlLXZhbHVl`;
+const URL_TOKEN = 'tok3nV4lue9x';
+const EMAIL = 'jane.doe+chip@example.com';
+const UUID = '3f2b8c1e-9a4d-4e6f-8b2a-1c3d5e7f9a0b';
+const PAYLOAD = 'QmFzZTY0UGF5bG9hZFRoYXRJc0xvbmdFbm91Z2hUb0JlQVNlY3JldEJsb2JYWVo';
+export const REDACTION_PROBES = Object.freeze([{
+  name: 'a JWT',
+  input: `token rejected: ${JWT}`,
+  secret: JWT_PAYLOAD
+}, {
+  name: 'a URL carrying a token',
+  input: `GET https://api.example.com/v1/chat?access_token=${URL_TOKEN} failed`,
+  secret: URL_TOKEN
+}, {
+  name: 'an e-mail address',
+  input: `no account for ${EMAIL}`,
+  secret: EMAIL
+}, {
+  name: 'a UUID',
+  input: `device ${UUID} refused`,
+  secret: UUID
+}, {
+  name: 'a base64 payload',
+  input: `body=${PAYLOAD}`,
+  secret: PAYLOAD
+}, {
+  name: 'an Error whose message carries a token',
+  input: new Error(`request failed: ${JWT}`),
+  secret: JWT_PAYLOAD
+}, {
+  name: 'an object carrying a JWT under an innocent key',
+  input: {
+    reason: `expired ${JWT}`
+  },
+  secret: JWT_PAYLOAD,
+  structured: true
+}, {
+  name: 'a nested object carrying an e-mail address',
+  input: {
+    request: {
+      owner: EMAIL
+    }
+  },
+  secret: EMAIL,
+  structured: true
+}]);
+/**
+ * Everything a log line could show. An Error goes in with its message and its own
+ * fields: JSON.stringify renders one as `{}`, which would pass any secret.
+ */
+function serialize(value) {
+  if (typeof value === 'string') return value;
+  try {
+    if (value instanceof Error) {
+      return `${value.name}: ${value.message} ${JSON.stringify({
+        ...value
+      })}`;
+    }
+    // JSON.stringify returns undefined for undefined and functions at run time.
+    const json = JSON.stringify(value, (_key, inner) => inner instanceof Error ? `${inner.name}: ${inner.message}` : inner);
+    return json ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+
+/**
+ * Runs every probe through `redact` and reports each secret that survived.
+ * `stringsOnly` is for a redactor that only accepts text (rn-auth's `redact`).
+ */
+export function redactionConformance(redact, options = {}) {
+  const failures = [];
+  let checks = 0;
+  for (const probe of REDACTION_PROBES) {
+    if (options.stringsOnly && typeof probe.input !== 'string') continue;
+    if (probe.structured && options.stringsOnly) continue;
+    checks += 1;
+    let output;
+    try {
+      output = serialize(redact(probe.input));
+    } catch (error) {
+      failures.push({
+        check: probe.name,
+        detail: `redactor threw: ${String(error)}`
+      });
+      continue;
+    }
+    if (output.includes(probe.secret)) {
+      failures.push({
+        check: probe.name,
+        detail: 'the secret survived redaction'
+      });
+    }
+  }
+  return {
+    passed: failures.length === 0,
+    checks,
+    failures
+  };
+}
+//# sourceMappingURL=redaction.js.map

package/lib/module/testing/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["JWT_PAYLOAD","JWT","URL_TOKEN","EMAIL","UUID","PAYLOAD","REDACTION_PROBES","Object","freeze","name","input","secret","Error","reason","structured","request","owner","serialize","value","message","JSON","stringify","json","_key","inner","String","redactionConformance","redact","options","failures","checks","probe","stringsOnly","output","error","push","check","detail","includes","passed","length"],"sourceRoot":"../../../src","sources":["testing/redaction.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/testing/scheduler.js

@@ -0,0 +1,47 @@
+"use strict";
+
+/**
+ * A scheduler a test drives by hand: nothing fires until `advance` moves the
+ * clock past it, so timing assertions are exact and instant.
+ */
+
+export function createManualScheduler(startMs = 0) {
+  let clock = startMs;
+  let nextId = 1;
+  const timers = new Map();
+  return {
+    setTimeout(callback, ms) {
+      const id = nextId++;
+      timers.set(id, {
+        at: clock + Math.max(0, ms),
+        callback
+      });
+      return id;
+    },
+    clearTimeout(handle) {
+      timers.delete(handle);
+    },
+    now: () => clock,
+    advance(ms) {
+      const target = clock + ms;
+      for (;;) {
+        let dueId;
+        let dueAt = Infinity;
+        for (const [id, timer] of timers) {
+          if (timer.at <= target && timer.at < dueAt) {
+            dueId = id;
+            dueAt = timer.at;
+          }
+        }
+        if (dueId === undefined) break;
+        const timer = timers.get(dueId);
+        timers.delete(dueId);
+        clock = dueAt;
+        timer?.callback();
+      }
+      clock = target;
+    },
+    pending: () => timers.size
+  };
+}
+//# sourceMappingURL=scheduler.js.map

package/lib/module/testing/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createManualScheduler","startMs","clock","nextId","timers","Map","setTimeout","callback","ms","id","set","at","Math","max","clearTimeout","handle","delete","now","advance","target","dueId","dueAt","Infinity","timer","undefined","get","pending","size"],"sourceRoot":"../../../src","sources":["testing/scheduler.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAYA,OAAO,SAASA,qBAAqBA,CAACC,OAAO,GAAG,CAAC,EAAmB;EACnE,IAAIC,KAAK,GAAGD,OAAO;EACnB,IAAIE,MAAM,GAAG,CAAC;EACd,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAA+C,CAAC;EAEtE,OAAO;IACNC,UAAUA,CAACC,QAAQ,EAAEC,EAAE,EAAE;MACxB,MAAMC,EAAE,GAAGN,MAAM,EAAE;MACnBC,MAAM,CAACM,GAAG,CAACD,EAAE,EAAE;QAAEE,EAAE,EAAET,KAAK,GAAGU,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEL,EAAE,CAAC;QAAED;MAAS,CAAC,CAAC;MACzD,OAAOE,EAAE;IACV,CAAC;IACDK,YAAYA,CAACC,MAAM,EAAE;MACpBX,MAAM,CAACY,MAAM,CAACD,MAAgB,CAAC;IAChC,CAAC;IACDE,GAAG,EAAEA,CAAA,KAAMf,KAAK;IAChBgB,OAAOA,CAACV,EAAE,EAAE;MACX,MAAMW,MAAM,GAAGjB,KAAK,GAAGM,EAAE;MACzB,SAAS;QACR,IAAIY,KAAyB;QAC7B,IAAIC,KAAK,GAAGC,QAAQ;QACpB,KAAK,MAAM,CAACb,EAAE,EAAEc,KAAK,CAAC,IAAInB,MAAM,EAAE;UACjC,IAAImB,KAAK,CAACZ,EAAE,IAAIQ,MAAM,IAAII,KAAK,CAACZ,EAAE,GAAGU,KAAK,EAAE;YAC3CD,KAAK,GAAGX,EAAE;YACVY,KAAK,GAAGE,KAAK,CAACZ,EAAE;UACjB;QACD;QACA,IAAIS,KAAK,KAAKI,SAAS,EAAE;QACzB,MAAMD,KAAK,GAAGnB,MAAM,CAACqB,GAAG,CAACL,KAAK,CAAC;QAC/BhB,MAAM,CAACY,MAAM,CAACI,KAAK,CAAC;QACpBlB,KAAK,GAAGmB,KAAK;QACbE,KAAK,EAAEhB,QAAQ,CAAC,CAAC;MAClB;MACAL,KAAK,GAAGiB,MAAM;IACf,CAAC;IACDO,OAAO,EAAEA,CAAA,KAAMtB,MAAM,CAACuB;EACvB,CAAC;AACF","ignoreList":[]}

package/lib/typescript/commonjs/diagnostics/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * One diagnostic stream for every package (CORE-08).
+ *
+ * Each package keeps its own typed events (`AdEvent`, `PaymentEvent`...), and also
+ * reports what it observed as an `SdkDiagnostic` through a channel. An app installs
+ * one `DiagnosticSink` and receives every package's diagnostics in one shape, so
+ * wiring crash reporting or analytics is one adapter rather than ten.
+ *
+ * Sinks live in a registry anchored on `Symbol.for`, so a sink installed through
+ * one copy of rn-core also receives diagnostics from packages bundling another.
+ * Every context passes through a redactor before any sink sees it.
+ */
+import type { Unsubscribe } from '../listeners';
+import { type Redactor } from '../redact';
+export type DiagnosticSeverity = 'debug' | 'info' | 'warn' | 'error';
+export interface SdkDiagnostic<Code extends string = string> {
+    /** The package that reported it, e.g. `rn-payment`. */
+    readonly pkg: string;
+    /** That package's stable diagnostic or event code. */
+    readonly code: Code;
+    readonly severity: DiagnosticSeverity;
+    /** Epoch milliseconds. */
+    readonly at: number;
+    /** Ties together everything reported within one operation, when the package has one. */
+    readonly correlationId?: string;
+    /** Already redacted. */
+    readonly context?: Readonly<Record<string, unknown>>;
+}
+export type DiagnosticSink = (diagnostic: SdkDiagnostic) => void;
+/**
+ * Sends every package's diagnostics to `sink` until the returned function is
+ * called. A sink that throws is reported on a fresh task and never affects the
+ * package that emitted.
+ */
+export declare function installSdkSink(sink: DiagnosticSink): Unsubscribe;
+/** Whether any sink is installed, for a package that would do extra work only to feed one. */
+export declare function hasSdkSinks(): boolean;
+export interface DiagnosticChannelOptions {
+    /** A package-level sink, in addition to every installed one. */
+    readonly sink?: DiagnosticSink | undefined;
+    /** Defaults to rn-core's identifier-only redactor. */
+    readonly redactor?: Redactor | undefined;
+    readonly now?: (() => number) | undefined;
+}
+export interface DiagnosticChannel<Code extends string> {
+    emit(code: Code, severity: DiagnosticSeverity, context?: Readonly<Record<string, unknown>>, correlationId?: string): void;
+}
+export declare function createDiagnosticChannel<Code extends string = string>(pkg: string, options?: DiagnosticChannelOptions): DiagnosticChannel<Code>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IAC1D,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;AAUjE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAShE;AAED,8FAA8F;AAC9F,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,MAAM,WAAW,wBAAwB;IACxC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI,SAAS,MAAM;IACrD,IAAI,CACH,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,aAAa,CAAC,EAAE,MAAM,GACpB,IAAI,CAAC;CACR;AAED,wBAAgB,uBAAuB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EACnE,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACpC,iBAAiB,CAAC,IAAI,CAAC,CA0BzB"}