@chipmobilesdk/rn-core 0.1.0 → 0.2.0

package/lib/typescript/commonjs/testing/conformance.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+import type { ConformanceReport } from './redaction';
+export interface Check<Subject> {
+    readonly name: string;
+    run(subject: Subject): void | Promise<void>;
+}
+/** Runs every check against a fresh subject, so no check depends on another's leftovers. */
+export declare function runChecks<Subject>(makeSubject: () => Subject | Promise<Subject>, checks: readonly Check<Subject>[]): Promise<ConformanceReport>;
+/** Throws one error listing every failed check, for a test runner to report. */
+export declare function expectConformance(report: ConformanceReport, subject?: string): void;
+/** A failed expectation inside a check. */
+export declare function ensure(condition: unknown, message: string): asserts condition;
+export interface FaultRegistry<Point extends string> {
+    /** The next `times` calls at `point` throw what `fault` builds. */
+    arm(point: Point, fault: () => Error, times?: number): void;
+    disarm(point?: Point): void;
+    /** Throws if `point` is armed; called by the code under test at that point. */
+    throwIfFaulted(point: Point): void;
+    /** Points that have fired at least once, so a test can prove its fault was reached. */
+    fired(): readonly Point[];
+}
+/**
+ * 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 declare function createFaultRegistry<Point extends string>(): FaultRegistry<Point>;
+//# sourceMappingURL=conformance.d.ts.map

package/lib/typescript/commonjs/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../../src/testing/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,KAAK,CAAC,OAAO;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,4FAA4F;AAC5F,wBAAsB,SAAS,CAAC,OAAO,EACtC,WAAW,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC7C,MAAM,EAAE,SAAS,KAAK,CAAC,OAAO,CAAC,EAAE,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAa5B;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,SAAmB,GAAG,IAAI,CAM7F;AAED,2CAA2C;AAC3C,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAE7E;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM;IAClD,mEAAmE;IACnE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACnC,uFAAuF;IACvF,KAAK,IAAI,SAAS,KAAK,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,KAAK,aAAa,CAAC,KAAK,CAAC,CAqBhF"}

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

@@ -0,0 +1,10 @@
+/**
+ * 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, type ConformanceFailure, type ConformanceReport, type RedactionProbe, } from './redaction';
+export { createManualScheduler, type ManualScheduler } from './scheduler';
+export { createFaultRegistry, ensure, expectConformance, runChecks, type Check, type FaultRegistry, } from './conformance';
+export { createManualLifecycle, type ManualLifecycle } from './lifecycle';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACN,mBAAmB,EACnB,MAAM,EACN,iBAAiB,EACjB,SAAS,EACT,KAAK,KAAK,EACV,KAAK,aAAa,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * 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 { type AppLifecyclePort, type AppLifecycleState } from '../runtime/lifecycle';
+export interface ManualLifecycle {
+    readonly port: AppLifecyclePort;
+    /** Moves the app to `state`, as the OS would. Reporting the current state again is a no-op. */
+    set(state: AppLifecycleState): void;
+    /** Whether the port holds its (scripted) native subscription. */
+    isSubscribed(): boolean;
+}
+export declare function createManualLifecycle(initial?: AppLifecycleState): ManualLifecycle;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/testing/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAEtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,+FAA+F;IAC/F,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,iEAAiE;IACjE,YAAY,IAAI,OAAO,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,iBAA4B,GAAG,eAAe,CAoB5F"}

package/lib/typescript/commonjs/testing/redaction.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+export interface RedactionProbe {
+    readonly name: string;
+    /** What is handed to the redactor. */
+    readonly input: unknown;
+    /** The part that must not appear anywhere in the output. */
+    readonly secret: string;
+    /** Probes that need key-aware redaction; a string-only redactor skips them. */
+    readonly structured?: boolean;
+}
+export declare const REDACTION_PROBES: readonly RedactionProbe[];
+export interface ConformanceFailure {
+    readonly check: string;
+    readonly detail: string;
+}
+export interface ConformanceReport {
+    readonly passed: boolean;
+    readonly checks: number;
+    readonly failures: readonly ConformanceFailure[];
+}
+/**
+ * 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 declare function redactionConformance(redact: (value: unknown) => unknown, options?: {
+    readonly stringsOnly?: boolean;
+}): ConformanceReport;
+//# sourceMappingURL=redaction.d.ts.map

package/lib/typescript/commonjs/testing/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../../../src/testing/redaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC9B;AASD,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EA2BpD,CAAC;AAEH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD;AAsBD;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,EACnC,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,iBAAiB,CAmBnB"}

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

@@ -0,0 +1,15 @@
+/**
+ * A scheduler a test drives by hand: nothing fires until `advance` moves the
+ * clock past it, so timing assertions are exact and instant.
+ */
+import type { Scheduler } from '../scheduler';
+export interface ManualScheduler extends Scheduler {
+    /** The scheduler's clock, in milliseconds since it was created at `startMs`. */
+    now(): number;
+    /** Moves the clock forward, firing every timer that falls due, in order. */
+    advance(ms: number): void;
+    /** Timers scheduled and not yet fired or cleared. */
+    pending(): number;
+}
+export declare function createManualScheduler(startMs?: number): ManualScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../../src/testing/scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,eAAgB,SAAQ,SAAS;IACjD,gFAAgF;IAChF,GAAG,IAAI,MAAM,CAAC;IACd,4EAA4E;IAC5E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,OAAO,IAAI,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,SAAI,GAAG,eAAe,CAoClE"}

package/lib/typescript/module/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/index.js';
+import { type Redactor } from '../redact/index.js';
+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/module/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,uBAAc,CAAC;AAEhD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,oBAAW,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"}

package/lib/typescript/module/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/module/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/module/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/index.js';
+export { COMMON_PATTERNS, PATH_PATTERN, REDACTED, createRedactor, describeShape, leadingIdentifier, pickAllowed, redactPatterns, type RedactPolicy, type Redactor, } from './redact/index.js';
+export { createEmitter, createListenerSet, reportAsynchronously, type DedupeOptions, type Emitter, type EmitterOptions, type ListenerErrorOptions, type ListenerSet, type Unsubscribe, } from './listeners/index.js';
+export { createDiagnosticChannel, hasSdkSinks, installSdkSink, type DiagnosticChannel, type DiagnosticChannelOptions, type DiagnosticSeverity, type DiagnosticSink, type SdkDiagnostic, } from './diagnostics/index.js';
+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/index.js';
+export { lazyPeer, type LazyPeer, type PeerResult } from './lazy/index.js';
+export { createMemoryKeyValue, fromMmkvLike, namespaced, openDurable, type KeyValuePort, type MmkvLike, } from './kv/index.js';
+export { appLifecycle, byPlatform, createAppLifecycle, currentPlatform, isDevBuild, onForeground, setPlatformOverride, type AppLifecyclePort, type AppLifecycleState, type AppStateSource, type BuildEnvironment, type RuntimePlatform, } from './runtime/index.js';
+export { createStore, shallowEqual, type Store } from './store/index.js';
+export { clearIntlCaches, getDateTimeFormat, getNumberFormat, isValidTimeZone } from './intl/index.js';
+export { defineMessages, formatMessage, type CatalogOf, type MessageAudience, type MessageCatalog, type MessageSet, type MessageVars, } from './messages/index.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/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,mBAAU,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,mBAAU,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,sBAAa,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,wBAAe,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,sBAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAQ,CAAC;AAClE,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,GACb,MAAM,eAAM,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,oBAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAS,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAQ,CAAC;AAC9F,OAAO,EACN,cAAc,EACd,aAAa,EACb,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,qBAAY,CAAC"}

package/lib/typescript/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/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/module/package.json

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

package/lib/typescript/module/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/index.js';
+/**
+ * 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/module/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,uBAAc,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/module/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/module/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"}