@chipmobilesdk/rn-core 0.0.0 → 0.2.0

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

@@ -0,0 +1,59 @@
+/**
+ * One error model for every @chipmobilesdk package (CORE-11).
+ *
+ * Each package keeps its own public error class and code union (`AdsError`,
+ * `PaymentError`...); those classes extend `SdkError`, so an app can handle any
+ * package's failure the same way: a code, whether retrying can help, and a cause
+ * that has already been through redaction.
+ *
+ * `isSdkError` checks a brand rather than `instanceof`, so it holds when an app
+ * ends up with two copies of this package (two versions in node_modules), which
+ * would make `instanceof SdkError` false for half its errors.
+ */
+export interface SdkErrorOptions {
+    /** A message the package wrote itself. Foreign text belongs in `redactedCause`. */
+    readonly message?: string | undefined;
+    /** Whether the same call can succeed if retried. Defaults to false. */
+    readonly retryable?: boolean | undefined;
+    /** The underlying failure, already reduced to text that is safe to log. */
+    readonly redactedCause?: string | undefined;
+}
+export declare class SdkError<Code extends string = string> extends Error {
+    /** The package that raised the error, e.g. `rn-ads`. */
+    readonly pkg: string;
+    readonly code: Code;
+    readonly retryable: boolean;
+    readonly redactedCause?: string | undefined;
+    constructor(pkg: string, code: Code, options?: SdkErrorOptions);
+}
+/** True for an error raised by any @chipmobilesdk package, from any copy of this one. */
+export declare function isSdkError(value: unknown): value is SdkError;
+export interface ErrorCodes<Code extends string> {
+    readonly codes: readonly Code[];
+    /** Narrows an arbitrary string to the package's code union. */
+    is(value: unknown): value is Code;
+    isRetryable(code: Code): boolean;
+}
+/**
+ * A package's closed code set and which of its codes are retryable, declared
+ * once instead of a union, an array and a `Set` kept in step by hand.
+ */
+export declare function defineErrorCodes<const Code extends string>(codes: readonly Code[], options?: {
+    readonly retryable?: readonly NoInfer<Code>[];
+}): ErrorCodes<Code>;
+export interface ConfigIssue {
+    /** Where in the config, e.g. `placements.home.adUnitId`. */
+    readonly path: string;
+    readonly message: string;
+}
+/**
+ * Collects every problem in a config before throwing, so an app sees all of them
+ * at once rather than one per fix-and-restart cycle.
+ */
+export declare function createIssueCollector(): {
+    add(path: string, message: string): void;
+    readonly issues: readonly ConfigIssue[];
+    /** Throws what `toError` builds from the issues, when there are any. */
+    throwIfAny(toError: (issues: readonly ConfigIssue[]) => Error): void;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,eAAe;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,qBAAa,QAAQ,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAChE,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEhC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,eAAoB;CAYlE;AAID,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAI5D;AAED,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,MAAM;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,+DAA+D;IAC/D,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC;IAClC,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzD,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,GAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;CAAO,GAC7D,UAAU,CAAC,IAAI,CAAC,CAQlB;AAED,MAAM,WAAW,WAAW;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB;cAGxB,MAAM,WAAW,MAAM,GAAG,IAAI;qBAG1B,SAAS,WAAW,EAAE;IAGpC,wEAAwE;wBACpD,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,KAAK,KAAK,GAAG,IAAI;EAMrE"}

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

@@ -0,0 +1,22 @@
+/**
+ * @chipmobilesdk/rn-core — the shared foundation of the @chipmobilesdk packages:
+ * one error model, one redaction mechanism, one way to notify listeners and one
+ * diagnostic stream, so every package behaves the same way. Pure TypeScript, no
+ * native code.
+ *
+ * Each module is also its own entrypoint (`@chipmobilesdk/rn-core/errors`,
+ * `/redact`, `/listeners`, `/diagnostics`); test helpers are only at
+ * `@chipmobilesdk/rn-core/testing`.
+ */
+export { SdkError, createIssueCollector, defineErrorCodes, isSdkError, type ConfigIssue, type ErrorCodes, type SdkErrorOptions, } from './errors';
+export { COMMON_PATTERNS, PATH_PATTERN, REDACTED, createRedactor, describeShape, leadingIdentifier, pickAllowed, redactPatterns, type RedactPolicy, type Redactor, } from './redact';
+export { createEmitter, createListenerSet, reportAsynchronously, type DedupeOptions, type Emitter, type EmitterOptions, type ListenerErrorOptions, type ListenerSet, type Unsubscribe, } from './listeners';
+export { createDiagnosticChannel, hasSdkSinks, installSdkSink, type DiagnosticChannel, type DiagnosticChannelOptions, type DiagnosticSeverity, type DiagnosticSink, type SdkDiagnostic, } from './diagnostics';
+export { checkInteger, checkRange, computeBackoff, createExclusive, createRateLimiter, createSingleFlight, createTimerSet, realScheduler, runWithRetry, withTimeout, type BackoffSpec, type ExclusiveOutcome, type Range, type RetryHandle, type RetryOptions, type Scheduler, type TimerSet, } from './scheduler';
+export { lazyPeer, type LazyPeer, type PeerResult } from './lazy';
+export { createMemoryKeyValue, fromMmkvLike, namespaced, openDurable, type KeyValuePort, type MmkvLike, } from './kv';
+export { appLifecycle, byPlatform, createAppLifecycle, currentPlatform, isDevBuild, onForeground, setPlatformOverride, type AppLifecyclePort, type AppLifecycleState, type AppStateSource, type BuildEnvironment, type RuntimePlatform, } from './runtime';
+export { createStore, shallowEqual, type Store } from './store';
+export { clearIntlCaches, getDateTimeFormat, getNumberFormat, isValidTimeZone } from './intl';
+export { defineMessages, formatMessage, type CatalogOf, type MessageAudience, type MessageCatalog, type MessageSet, type MessageVars, } from './messages';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACN,QAAQ,EACR,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,QAAQ,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,uBAAuB,EACvB,WAAW,EACX,cAAc,EACd,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,QAAQ,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAClE,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,GACb,MAAM,MAAM,CAAC;AACd,OAAO,EACN,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9F,OAAO,EACN,cAAc,EACd,aAAa,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Cached `Intl` formatters (PERF-01, PERF-08, I18N-03, NOT-20).
+ *
+ * Constructing an `Intl.DateTimeFormat` or `Intl.NumberFormat` is expensive on
+ * Hermes, and rn-notification built one per time-zone calculation (thousands in a
+ * recurrence expansion) while rn-i18n built one per formatted value. Formatters
+ * are immutable once built, so one per (locale, options) is shared. Each cache is
+ * a small LRU: the working set is a few locales and zones, and an app that cycles
+ * through many still holds a bounded number.
+ */
+/**
+ * A shared `Intl.NumberFormat`. Throws what the constructor throws (an unknown
+ * currency, say): callers decide how a bad option is reported.
+ */
+export declare function getNumberFormat(locale: string | undefined, options?: Intl.NumberFormatOptions): Intl.NumberFormat;
+/** A shared `Intl.DateTimeFormat`. Throws what the constructor throws. */
+export declare function getDateTimeFormat(locale: string | undefined, options?: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+/**
+ * Whether `Intl` accepts the IANA zone, memoized. Hermes raises a hard error for
+ * an unknown zone, so a stored zone is checked here before it reaches `Intl`.
+ */
+export declare function isValidTimeZone(timeZone: string): boolean;
+/** Test seam: drops every cached formatter and zone check. */
+export declare function clearIntlCaches(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/intl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0CH;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAChC,IAAI,CAAC,YAAY,CAEnB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAClC,IAAI,CAAC,cAAc,CAKrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAczD;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,IAAI,IAAI,CAItC"}

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

@@ -0,0 +1,38 @@
+/**
+ * A synchronous key-value port (DEP-09, NOT-15, PERF-09).
+ *
+ * rn-payment and rn-notification each wrapped MMKV themselves, and one of them
+ * fell back to memory without telling anyone. Here the port says whether it is
+ * `durable`, and `openDurable` reports the fallback through `onDegraded`, so a
+ * package can emit its own diagnostic instead of silently losing state.
+ *
+ * rn-core never requires a storage peer itself: the package opens MMKV (or any
+ * store with the same shape) and hands it over as an `MmkvLike`.
+ */
+export interface KeyValuePort {
+    getString(key: string): string | undefined;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    keys(): string[];
+    clearAll(): void;
+    /** False when writes do not survive a restart: the memory fallback. */
+    readonly durable: boolean;
+}
+/** The slice of a react-native-mmkv v4 instance the port uses. */
+export interface MmkvLike {
+    getString(key: string): string | undefined;
+    set(key: string, value: string): void;
+    remove(key: string): unknown;
+    getAllKeys(): string[];
+    clearAll(): void;
+}
+export declare function createMemoryKeyValue(): KeyValuePort;
+export declare function fromMmkvLike(store: MmkvLike): KeyValuePort;
+/**
+ * Opens the durable store, or falls back to memory and says so: `onDegraded`
+ * receives the reason once, and the returned port reports `durable: false`.
+ */
+export declare function openDurable(open: () => MmkvLike, onDegraded?: (cause: unknown) => void): KeyValuePort;
+/** Keys under `prefix:` only, so several owners can share one store. */
+export declare function namespaced(port: KeyValuePort, prefix: string): KeyValuePort;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/kv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,QAAQ,IAAI,IAAI,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACxB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,UAAU,IAAI,MAAM,EAAE,CAAC;IACvB,QAAQ,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAcnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CAW1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,QAAQ,EACpB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACnC,YAAY,CAOd;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAoB3E"}

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

@@ -0,0 +1,36 @@
+/**
+ * Lazy native peers (CORE-06).
+ *
+ * Every package loads its native peer on first use, so importing a package where
+ * the peer is absent (an unsupported platform, a build that excludes it) costs
+ * nothing and crashes nothing. There were 18 hand-written `require()` sites with
+ * four different failure policies, some silent. Here, one: the load runs once,
+ * its result (module or failure) is cached, and a missing peer is a typed result
+ * the package maps to its own error code.
+ *
+ * The `load` thunk must contain the literal `require('peer-name')` and live in the
+ * package that depends on the peer, so Metro sees and bundles it there.
+ */
+export type PeerResult<T> = {
+    readonly ok: true;
+    readonly module: T;
+} | {
+    readonly ok: false;
+    readonly peer: string;
+    readonly cause: unknown;
+};
+export interface LazyPeer<T> {
+    readonly name: string;
+    /** Loads on the first call and caches the outcome. Never throws. */
+    get(): PeerResult<T>;
+    /** The module, or throws what `fail` builds: the package's own "peer missing" error. */
+    require(fail: (peer: string, cause: unknown) => Error): T;
+    isAvailable(): boolean;
+    /**
+     * Test seam: a fake module, `null` to simulate the peer being absent, or
+     * `undefined` to go back to really loading it.
+     */
+    override(fake: T | null | undefined): void;
+}
+export declare function lazyPeer<T>(name: string, load: () => T): LazyPeer<T>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lazy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,CAAC,CAAC,IACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACzC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,QAAQ,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACrB,wFAAwF;IACxF,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC;IAC1D,WAAW,IAAI,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAkCpE"}

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

@@ -0,0 +1,61 @@
+/**
+ * Listener sets and event emitters (CORE-03, CORE-08, CORE-12).
+ *
+ * Every package used to keep its own `Set<listener>` and loop over it. Three of
+ * them let a throwing subscriber escape into the code that was notifying, which
+ * left a state machine half-updated. Here, once:
+ *
+ * - `notify` iterates a snapshot: a listener added during a round waits for the
+ *   next one, and a listener removed during a round is not called, so a consumer
+ *   that unsubscribed (an unmounted component) is never reached;
+ * - each listener runs in its own try/catch, so one throwing subscriber neither
+ *   stops the others nor reaches the caller;
+ * - a listener's error is reported, never swallowed: to `onListenerError` when
+ *   given, otherwise rethrown on a fresh task, where the app's global error
+ *   handler and crash reporter see it;
+ * - unsubscribing twice is a no-op.
+ */
+export type Unsubscribe = () => void;
+export interface ListenerErrorOptions {
+    /**
+     * Receives an error a listener threw. Errors raised while this handler runs
+     * (say, by a listener it notifies) are dropped rather than reported again, so
+     * a failing reporter cannot recurse forever.
+     */
+    readonly onListenerError?: ((error: unknown) => void) | undefined;
+}
+/** Rethrows on a fresh task: outside every caller, inside the app's error handler. */
+export declare function reportAsynchronously(error: unknown): void;
+export interface ListenerSet<Args extends unknown[]> {
+    /** Adds a listener; the returned function removes it, once. */
+    add(listener: (...args: Args) => void): Unsubscribe;
+    /** Calls every listener present when the call starts, each in isolation. */
+    notify(...args: Args): void;
+    readonly size: number;
+    clear(): void;
+}
+export declare function createListenerSet<Args extends unknown[] = []>(options?: ListenerErrorOptions): ListenerSet<Args>;
+export interface DedupeOptions<Event> {
+    /** The identity of an event that must reach listeners at most once; undefined to never dedupe. */
+    readonly key: (event: Event) => string | undefined;
+    /**
+     * How many keys are remembered. The oldest is forgotten first, so memory stays
+     * bounded however long the emitter lives (CORE-12).
+     */
+    readonly capacity: number;
+}
+export interface EmitterOptions<Event> extends ListenerErrorOptions {
+    readonly dedupe?: DedupeOptions<Event> | undefined;
+}
+export interface Emitter<Event> {
+    /** Delivers the event; false when it was a duplicate or the emitter is disposed. */
+    emit(event: Event): boolean;
+    subscribe(listener: (event: Event) => void): Unsubscribe;
+    /** Forgets the dedupe keys `matches` selects, e.g. when a cycle ends. */
+    forget(matches: (key: string) => boolean): void;
+    /** Drops every listener and dedupe key; later emits do nothing. */
+    dispose(): void;
+    listenerCount(): number;
+}
+export declare function createEmitter<Event>(options?: EmitterOptions<Event>): Emitter<Event>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/listeners/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAClE;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAIzD;AAED,MAAM,WAAW,WAAW,CAAC,IAAI,SAAS,OAAO,EAAE;IAClD,+DAA+D;IAC/D,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,WAAW,CAAC;IACpD,4EAA4E;IAC5E,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,EAC5D,OAAO,GAAE,oBAAyB,GAChC,WAAW,CAAC,IAAI,CAAC,CA4CnB;AAED,MAAM,WAAW,aAAa,CAAC,KAAK;IACnC,kGAAkG;IAClG,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,CAAE,SAAQ,oBAAoB;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,OAAO,CAAC,KAAK;IAC7B,oFAAoF;IACpF,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,WAAW,CAAC;IACzD,yEAAyE;IACzE,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAChD,mEAAmE;IACnE,OAAO,IAAI,IAAI,CAAC;IAChB,aAAa,IAAI,MAAM,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAE,cAAc,CAAC,KAAK,CAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAkCxF"}

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

@@ -0,0 +1,39 @@
+/**
+ * Message catalogs (CORE-15, I18N-13, AUTH-16, AI-15).
+ *
+ * rn-ai, rn-auth and rn-payment each kept their copy keys in a different shape.
+ * One shape now: a catalog of default texts split by audience. `user` copy may
+ * reach an end user; `developer` copy describes a configuration fault and must
+ * never be shown to one. A catalog is plain data (`key -> default text`), so rn-i18n
+ * can register any package's catalog in one call and translate it like app copy.
+ */
+/** Message key to default text. `{name}` marks a variable. */
+export type MessageCatalog = Readonly<Record<string, string>>;
+export type MessageAudience = 'user' | 'developer';
+/** Any object whose every key maps to a string; interfaces qualify, unlike an index signature. */
+export type CatalogOf<T> = {
+    readonly [K in keyof T]: string;
+};
+export interface MessageSet<User extends CatalogOf<User>, Developer extends CatalogOf<Developer>> {
+    /** Every default text, both audiences. */
+    readonly defaults: Readonly<User & Developer>;
+    /** The copy that may reach an end user: what an app registers for translation. */
+    readonly user: Readonly<User>;
+    /** Configuration-fault copy for developers; never shown to an end user. */
+    readonly developer: Readonly<Developer>;
+    readonly userKeys: readonly (keyof User & string)[];
+    readonly developerKeys: readonly (keyof Developer & string)[];
+    /** The defaults with the app's own texts laid over them. */
+    resolve(overrides?: Partial<User & Developer>): User & Developer;
+    audienceOf(key: keyof User | keyof Developer): MessageAudience;
+    /** A key's default text with `{name}` variables filled in. */
+    format(key: keyof User | keyof Developer, vars?: MessageVars): string;
+}
+export type MessageVars = Readonly<Record<string, string | number>>;
+/** Fills `{name}` placeholders; a placeholder with no value is left as written. */
+export declare function formatMessage(template: string, vars?: MessageVars): string;
+export declare function defineMessages<User extends CatalogOf<User>, Developer extends CatalogOf<Developer> = Record<never, string>>(catalog: {
+    readonly user: User;
+    readonly developer?: Developer;
+}): MessageSet<User, Developer>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnD,kGAAkG;AAClG,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAC;AAE/D,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC;IAC/F,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9D,4DAA4D;IAC5D,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACjE,UAAU,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,MAAM,SAAS,GAAG,eAAe,CAAC;IAC/D,8DAA8D;IAC9D,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;CACtE;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAEpE,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CAK1E;AAED,wBAAgB,cAAc,CAC7B,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,EAC5B,SAAS,SAAS,SAAS,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAC7D,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAiB/F"}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

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

@@ -0,0 +1,38 @@
+/**
+ * React glue every package shares (CORE-07, PERF-04).
+ *
+ * Packages used to mirror their state into `useState` from a `useEffect`
+ * subscription: one render late, a tearing risk under concurrent rendering, and
+ * every consumer re-rendered on every change. Here, one way:
+ * `useSyncExternalStore` over a store whose snapshot keeps its identity until it
+ * actually changes, with a selector so a component re-renders only when the part
+ * it reads changes.
+ *
+ * `react` is an optional peer of rn-core, needed only for this entrypoint.
+ */
+import { type ReactNode } from 'react';
+import type { Unsubscribe } from '../listeners';
+/**
+ * Reads an external store. With `select`, the component re-renders only when the
+ * selected value changes by `isEqual` (default `Object.is`), however often the
+ * store itself changes.
+ */
+export declare function useExternalStore<Snapshot, Selected = Snapshot>(subscribe: (listener: () => void) => Unsubscribe, getSnapshot: () => Snapshot, select?: (snapshot: Snapshot) => Selected, isEqual?: (a: Selected, b: Selected) => boolean): Selected;
+/**
+ * A callback whose identity never changes but which always calls the latest
+ * `fn`, for listeners an app passes inline that must not re-run an effect.
+ */
+export declare function useLatestCallback<Args extends unknown[], Result>(fn: (...args: Args) => Result): (...args: Args) => Result;
+/**
+ * A context with a Provider and a hook that throws a clear error outside it,
+ * instead of returning `undefined` for a missing provider.
+ */
+export declare function createSdkContext<T>(name: string): {
+    Context: import("react").Context<T | null>;
+    Provider: ({ value, children }: {
+        value: T;
+        children?: ReactNode;
+    }) => import("react").FunctionComponentElement<import("react").ProviderProps<T | null>>;
+    use: () => T;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAON,KAAK,SAAS,EACd,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAC7D,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,WAAW,EAChD,WAAW,EAAE,MAAM,QAAQ,EAC3B,MAAM,GAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAuD,EACvF,OAAO,GAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,KAAK,OAAmB,GACxD,QAAQ,CAeV;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC/D,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,GAC3B,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,MAAM,CAI3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM;;oCAIR;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;KAAE;eAIzD,CAAC;EASjB"}

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

@@ -0,0 +1,47 @@
+export declare const REDACTED = "[redacted]";
+/**
+ * Shapes that are a secret or an identifier wherever they appear. Order matters:
+ * a URL is replaced whole before its parts could match anything narrower.
+ */
+export declare const COMMON_PATTERNS: readonly RegExp[];
+/** File paths: file URIs are URLs already; this adds POSIX and Windows paths. */
+export declare const PATH_PATTERN: RegExp;
+/** Replaces every match of every pattern with `[redacted]`. */
+export declare function redactPatterns(text: string, patterns?: readonly RegExp[]): string;
+/**
+ * Reduces text this package did not write to a leading engine identifier, or to
+ * `[redacted]`. No shape test separates prose describing a failure from prose
+ * describing a person, so prose never survives.
+ */
+export declare function leadingIdentifier(text: string): string;
+/** A value's shape without its content: `[string:12]`, `[array:3]`, `[object:2]`. */
+export declare function describeShape(value: unknown): string;
+/** Keeps only allowlisted keys, and only their primitive values. */
+export declare function pickAllowed(detail: Readonly<Record<string, unknown>> | undefined, allow: ReadonlySet<string>): Record<string, string | number | boolean> | undefined;
+export interface RedactPolicy {
+    /**
+     * How free text is reduced. `identifier` (the default) keeps only a leading
+     * engine constant; `patterns` keeps prose and replaces secret-shaped runs.
+     */
+    readonly text?: 'identifier' | 'patterns' | undefined;
+    /** Patterns for `patterns` text, applied after `COMMON_PATTERNS`. */
+    readonly patterns?: readonly RegExp[] | undefined;
+    /** Keys whose values are dropped wholesale when an object is rendered. */
+    readonly dropKeys?: Iterable<string> | undefined;
+    /** Keys `detail()` lets through. */
+    readonly allowDetailKeys?: Iterable<string> | undefined;
+    /** Keys whose values `context()` replaces by their shape. */
+    readonly shapeKeys?: Iterable<string> | undefined;
+    /** How deep objects are rendered or walked. Defaults to 2 for text, 6 for context. */
+    readonly maxDepth?: number | undefined;
+}
+export interface Redactor {
+    /** Any value as one safe string. An SDK error becomes its code. */
+    text(value: unknown): string;
+    /** A diagnostic detail reduced to its allowlisted primitive values. */
+    detail(detail: Readonly<Record<string, unknown>> | undefined): Record<string, string | number | boolean> | undefined;
+    /** A diagnostic context with content replaced by shape and strings redacted. */
+    context(context: Readonly<Record<string, unknown>> | undefined): Readonly<Record<string, unknown>> | undefined;
+}
+export declare function createRedactor(policy?: RedactPolicy): Redactor;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/redact/index.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAW3C,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,YAAY,QAAyD,CAAC;AAInF,+DAA+D;AAC/D,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,SAAS,MAAM,EAAoB,GAC3C,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOpD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACrD,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAYvD;AAED,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAClD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,oCAAoC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACxD,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,QAAQ;IACxB,mEAAmE;IACnE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,uEAAuE;IACvE,MAAM,CACL,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACnD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC;IACzD,gFAAgF;IAChF,OAAO,CACN,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GACpD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjD;AAED,wBAAgB,cAAc,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAoDlE"}

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

@@ -0,0 +1,21 @@
+export type RuntimePlatform = 'android' | 'ios' | 'unsupported';
+/** What a build is for. A package may refuse production configuration elsewhere. */
+export type BuildEnvironment = 'development' | 'test' | 'production';
+/** The OS the app runs on, or `unsupported` (web, Node, a platform with no adapter). */
+export declare function currentPlatform(): RuntimePlatform;
+/** Test seam: pins `currentPlatform()`; `undefined` goes back to the real one. */
+export declare function setPlatformOverride(platform: RuntimePlatform | undefined): void;
+/** Picks a value for the current platform, falling back to `default`. */
+export declare function byPlatform<T>(values: {
+    readonly android?: T;
+    readonly ios?: T;
+    readonly default: T;
+}): T;
+/**
+ * Whether this is a development build: React Native's `__DEV__`, or, where that
+ * global does not exist (plain Node, some test runners), `NODE_ENV` not being
+ * `production`.
+ */
+export declare function isDevBuild(): boolean;
+export { appLifecycle, createAppLifecycle, onForeground, type AppLifecyclePort, type AppLifecycleState, type AppStateSource, } from './lifecycle';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/index.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC;AAEhE,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,MAAM,GAAG,YAAY,CAAC;AAarE,wFAAwF;AACxF,wBAAgB,eAAe,IAAI,eAAe,CAKjD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAE/E;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;CACpB,GAAG,CAAC,CAKJ;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAIpC;AAED,OAAO,EACN,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC"}

package/lib/typescript/commonjs/runtime/lifecycle.d.ts

@@ -0,0 +1,34 @@
+import { type Unsubscribe } from '../listeners';
+export type AppLifecycleState = 'active' | 'inactive' | 'background';
+export interface AppLifecyclePort {
+    /** The state now. */
+    current(): AppLifecycleState;
+    /**
+     * Called on every change of state, with the state before it. Repeated reports
+     * of the same state are not changes. The returned function removes the
+     * listener, once.
+     */
+    subscribe(listener: (state: AppLifecycleState, previous: AppLifecycleState) => void): Unsubscribe;
+    /** How many listeners are attached; the native subscription lives while this is above zero. */
+    readonly listenerCount: number;
+}
+/** The slice of React Native's `AppState` the port reads. */
+export interface AppStateSource {
+    readonly currentState?: string | null;
+    addEventListener(type: 'change', listener: (state: string) => void): {
+        remove(): void;
+    };
+}
+/**
+ * A lifecycle port over `source`, React Native's `AppState` by default. Packages use
+ * the shared `appLifecycle()`; this is for tests and for an app with its own source.
+ */
+export declare function createAppLifecycle(source?: () => AppStateSource | undefined): AppLifecyclePort;
+/** The app's lifecycle, shared by every package so there is one native subscription. */
+export declare function appLifecycle(): AppLifecyclePort;
+/**
+ * Calls `listener` each time the app comes back from the background. A trip through
+ * `inactive` alone (iOS Control Center, an incoming-call banner) is not a return.
+ */
+export declare function onForeground(listener: () => void, port?: AppLifecyclePort): Unsubscribe;
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/typescript/commonjs/runtime/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lifecycle.ts"],"names":[],"mappings":"AAaA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAChC,qBAAqB;IACrB,OAAO,IAAI,iBAAiB,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GAAG,WAAW,CAAC;IAClG,+FAA+F;IAC/F,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,CAAC;CACxF;AAwBD;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,GAAE,MAAM,cAAc,GAAG,SAAyB,GACtD,gBAAgB,CAyClB;AAID,wFAAwF;AACxF,wBAAgB,YAAY,IAAI,gBAAgB,CAG/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,IAAI,EACpB,IAAI,GAAE,gBAAiC,GACrC,WAAW,CAUb"}

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

@@ -0,0 +1,108 @@
+/**
+ * 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 { type Unsubscribe } from '../listeners';
+/**
+ * How timers are scheduled. Injectable so a test drives backoff and expiry by
+ * moving a clock instead of waiting.
+ */
+export interface Scheduler {
+    setTimeout(callback: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export declare const realScheduler: Scheduler;
+/**
+ * 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 interface TimerSet {
+    after(ms: number, callback: () => void): Unsubscribe;
+    clearAll(): void;
+    size(): number;
+}
+export declare function createTimerSet(scheduler?: Scheduler): TimerSet;
+export interface BackoffSpec {
+    readonly initialDelayMs: number;
+    readonly maxDelayMs: number;
+    /** Growth per attempt. Defaults to 2. */
+    readonly factor?: number | undefined;
+    /**
+     * `none` keeps a schedule exact (one device retrying its own request has no
+     * herd to avoid); `full` spreads it over [0, delay] so a fleet that failed at
+     * once does not retry in lockstep. Defaults to `none`.
+     */
+    readonly jitter?: 'none' | 'full' | undefined;
+}
+/** Delay before `attempt`, 1-based: initial × factor^(attempt−1), capped, maybe jittered. */
+export declare function computeBackoff(attempt: number, spec: BackoffSpec, random?: () => number): number;
+export interface RetryHandle {
+    /** Cancels any pending attempt. Idempotent. */
+    cancel(): void;
+    /** Attempts made so far. */
+    attempts(): number;
+    /** True once `maxAttempts` were made without success. */
+    exhausted(): boolean;
+}
+export interface RetryOptions {
+    readonly spec: BackoffSpec & {
+        readonly maxAttempts: number;
+    };
+    /** Resolves true when the attempt succeeded. A throw counts as a failed attempt. */
+    readonly attempt: (attemptNumber: number) => Promise<boolean>;
+    /** Called once every attempt failed. Exhaustion is reported, never thrown. */
+    readonly onExhausted?: ((attempts: number) => void) | undefined;
+    readonly scheduler?: Scheduler | undefined;
+    readonly random?: (() => number) | undefined;
+}
+/** Runs `attempt` now, then on the backoff schedule until it succeeds, is cancelled or runs out. */
+export declare function runWithRetry(options: RetryOptions): RetryHandle;
+/**
+ * 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 declare function createSingleFlight<T>(): {
+    run(operation: () => Promise<T>): Promise<T>;
+    inFlight(): boolean;
+};
+/** Distinguishes "refused because busy" from any other failure, without throwing. */
+export type ExclusiveOutcome<T> = {
+    acquired: true;
+    value: T;
+} | {
+    acquired: false;
+};
+/** Admits one operation at a time and refuses the rest, rather than queueing them. */
+export declare function createExclusive(): {
+    run<T>(operation: () => Promise<T>): Promise<ExclusiveOutcome<T>>;
+    busy(): boolean;
+};
+/** Admits at most one call per `minIntervalMs`; a refused call is dropped, not deferred. */
+export declare function createRateLimiter(minIntervalMs: number, now?: () => number): {
+    tryAcquire(): boolean;
+    reset(): void;
+};
+/**
+ * Rejects with `onTimeout()` after `ms`. Always clears its timer, including when
+ * the promise wins, so no operation leaks one.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, onTimeout: () => Error, scheduler?: Scheduler): Promise<T>;
+export interface Range {
+    readonly min: number;
+    readonly max: number;
+}
+/**
+ * `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 declare function checkRange(label: string, value: number, range: Range, fail: (message: string) => Error, unit?: string): number;
+/** As `checkRange`, and a whole number. */
+export declare function checkInteger(label: string, value: number, range: Range, fail: (message: string) => Error): number;
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * 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 { type Unsubscribe } from '../listeners';
+export interface Store<T> {
+    /** The current snapshot: the same object until the state actually changes. */
+    getSnapshot(): T;
+    /** Replaces the state; listeners hear about it only when `isEqual` says it changed. */
+    setState(next: T | ((previous: T) => T)): void;
+    subscribe(listener: () => void): Unsubscribe;
+}
+export declare function createStore<T>(initial: T, isEqual?: (a: T, b: T) => boolean): Store<T>;
+/** Same keys, and each value `Object.is` the other's. */
+export declare function shallowEqual<T>(a: T, b: T): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,WAAW,KAAK,CAAC,CAAC;IACvB,8EAA8E;IAC9E,WAAW,IAAI,CAAC,CAAC;IACjB,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;CAC7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAmB,GAAG,KAAK,CAAC,CAAC,CAAC,CAajG;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAUnD"}