@webority/mobile-core 0.14.2 → 0.16.0

package/lib/typescript/module/logger/index.d.ts

@@ -1,8 +1,8 @@
 import { type LogLevel } from '../config/index.js';
 type LogFn = (message: string, ...optionalParams: unknown[]) => void;
 /**
- * Optional remote sink. Apps wire this via `setRemoteLogger()` to forward errors
- * and breadcrumbs to Crashlytics, Sentry, Bugsnag, etc. — without making the
+ * Remote sink. Apps pass one to `initWebority({ remoteLogger })` to forward errors
+ * and breadcrumbs to Crashlytics, Sentry, Bugsnag, etc., without making the
  * library depend on any of them.
  *
  * Every method is optional; the library calls only what the adapter implements.
@@ -20,10 +20,7 @@ export interface RemoteLogger {
     /** Forward a leveled console message. */
     log?: (level: LogLevel, message: string, optionalParams: unknown[]) => void;
 }
-/**
- * Inject a remote logger adapter (e.g. Firebase Crashlytics, Sentry).
- * Pass `null` to detach. Safe to call before or after `initWebority`.
- */
+/** Set by `initWebority`; `null` detaches. Not part of the package's public API. */
 export declare const setRemoteLogger: (impl: RemoteLogger | null) => void;
 /**
  * Device / app context attached once at boot (platform, OS version, app version,
@@ -47,6 +44,12 @@ export interface DeviceContext {
  */
 export declare const setDeviceContext: (context: DeviceContext | null) => void;
 export declare const getDeviceContext: () => DeviceContext | null;
+export interface LoggerBreadcrumb {
+    message: string;
+    data?: Record<string, unknown>;
+    /** When it was recorded, ISO 8601 in UTC. */
+    timestampUtc: string;
+}
 /** Tuning knobs for screen history and duplicate-error suppression. */
 export interface LoggerOptions {
     /** Identical errors within this window are collapsed. Default 5000ms. 0 disables dedupe. */
@@ -55,8 +58,15 @@ export interface LoggerOptions {
     dedupeMaxPerWindow?: number;
     /** Cap on tracked screen history. Default 20. */
     screenHistoryLimit?: number;
+    /** Extra keys masked in logs, added to the built-in list. */
+    redactKeys?: string[];
+    /** Breadcrumbs kept for Logger.getBreadcrumbs(). Default 50. */
+    breadcrumbLimit?: number;
 }
-/** Configure dedupe window/threshold and screen history size. Merges with current options. */
+/**
+ * Configure dedupe, screen history, breadcrumbs and redaction. Merges with current options;
+ * a `redactKeys` list replaces the app keys given before, and omitting it keeps them.
+ */
 export declare const configureLogger: (options: LoggerOptions) => void;
 /** What `Logger.requestFailed` is told about the call beside the error itself. */
 export interface RequestFailedContext {
@@ -76,7 +86,7 @@ export interface LoggerType {
     info: LogFn;
     warn: LogFn;
     error: LogFn;
-    /** Append a breadcrumb to the remote sink (and log at info level). */
+    /** Append a breadcrumb to the ring and the remote sink (and log at info level). Data is redacted before it is kept. */
     breadcrumb: (message: string, data?: Record<string, unknown>) => void;
     /** Record a non-fatal error with optional context. */
     recordError: (error: unknown, context?: Record<string, unknown>) => void;
@@ -92,6 +102,8 @@ export interface LoggerType {
     getCurrentScreen: () => string | null;
     /** Bounded history of tracked screen names, oldest first. */
     getScreenHistory: () => string[];
+    /** Copy of the breadcrumb ring, oldest first, capped at configureLogger({ breadcrumbLimit }). */
+    getBreadcrumbs: () => LoggerBreadcrumb[];
 }
 export declare const Logger: LoggerType;
 export {};

package/lib/typescript/module/logger/redact.d.ts

@@ -1,3 +1,5 @@
+/** Rebuilds the masking rules from the built-in list plus `extraKeys`. Replaces any earlier extras. */
+export declare const configureRedaction: (extraKeys: readonly string[]) => void;
 export declare const redactString: (input: string) => string;
 /** Returns a copy with secrets masked; Errors are masked in place so identity and stack survive. */
 export declare const redact: <T>(value: T) => T;

package/lib/typescript/module/push/push.d.ts

@@ -14,6 +14,8 @@ export interface PushDevice {
      * (the simulator), so the server falls back to its own setting.
      */
     apnsEnvironment: PushApnsEnvironment | null;
+    /** The device's IANA time zone, such as `Europe/London`. Null when the platform cannot name it. */
+    timeZone: string | null;
 }
 /** A notification that arrived while the app was open. */
 export interface PushReceived {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webority/mobile-core",
-  "version": "0.14.2",
+  "version": "0.16.0",
   "description": "Platform layer for Webority React Native apps: HTTP clients, auth/token storage, config, logging, formatters, validators, network status, permissions, storage, version checks and over-the-air updates. No UI.",
   "keywords": [
     "react-native",