@mongrov/core 0.5.1 → 0.7.0

package/README.md

@@ -96,11 +96,18 @@ In-memory circular buffer. Default size: 1000 entries. No persistence.
 
 ### File Transport
 
-Rolling daily log files. JSONL format.
+JSONL files, one per UTC hour (`logs-YYYY-MM-DDTHH-NNN.txt`), with a new `NNN`
+when a file passes `maxFileSizeKB`. On expo-file-system 19+ every batch is a true
+append (the file is never read to be written), so a kill mid-write can cut at most
+the last line. Older expo-file-system falls back to read + rewrite. Cleanup deletes
+whole files only: past `retentionDays`, then oldest first until under `maxSizeMB`;
+the file being written is never touched. `LoggingProvider` flushes when the app
+goes to the background. `exportFileLogs()` returns every retained line, oldest first,
+including pre-0.7 `logs-YYYY-MM-DD.txt` day files.
 
 ```typescript
-{ file: true }                          // defaults
-{ file: { maxSizeMB: 10, retentionDays: 14 } }
+{ file: true }                          // defaults: 5 MB, 7 days, 1024 KB per file
+{ file: { maxSizeMB: 10, retentionDays: 14, maxFileSizeKB: 512 } }
 ```
 
 ### Webhook Transport

package/dist/context/logging-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging-provider.d.ts","sourceRoot":"","sources":["../../src/context/logging-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,UAAU,oBAAoB;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,oBAAoB,2CAqCzE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAMlC"}
+{"version":3,"file":"logging-provider.d.ts","sourceRoot":"","sources":["../../src/context/logging-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAQ9B,UAAU,oBAAoB;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,oBAAoB,2CA0EzE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAMlC"}

package/dist/context/logging-provider.js

@@ -1,14 +1,30 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useEffect, useMemo, useRef } from 'react';
+import { createContext, useContext, useEffect, useRef, useState } from 'react';
+import { AppState } from 'react-native';
 import { createLogger } from '../logger';
+import { setNetworkStateLogger } from '../network-state';
 const LoggerContext = createContext(null);
 export function LoggingProvider({ config, children }) {
-    // Stable ref to config so the effect doesn't re-run on every render
+    // The config is read when a logger is created; later changes to it are not
+    // applied to a live logger.
     const configRef = useRef(config);
     configRef.current = config;
-    // Create logger once, re-create if destroyed by Strict Mode remount
-    const logger = useMemo(() => createLogger(configRef.current), []);
+    const [logger, setLogger] = useState(() => createLogger(config));
+    // Set by the effect cleanup. A cleanup is not always a real unmount: Strict
+    // Mode and Fast Refresh run cleanup then the effect again on the SAME
+    // component, which used to keep handing out a destroyed logger (webhook
+    // timer stopped, offline queue gone). A re-run that finds the logger
+    // destroyed replaces it.
+    const destroyedRef = useRef(false);
     useEffect(() => {
+        if (destroyedRef.current) {
+            destroyedRef.current = false;
+            // eslint-disable-next-line react-hooks-extra/no-direct-set-state-in-use-effect -- replacing a destroyed logger is the point of this branch
+            setLogger(createLogger(configRef.current));
+            return;
+        }
+        // Connectivity changes and polling failures land in this logger.
+        setNetworkStateLogger(logger);
         // Try to track screen via expo-router
         let unsubscribe;
         try {
@@ -23,13 +39,33 @@ export function LoggingProvider({ config, children }) {
             }
         }
         catch {
-            // expo-router not available — screen tracking disabled
+            // expected: expo-router not available — screen tracking disabled
         }
         return () => {
             unsubscribe?.();
-            logger.destroy();
+            destroyedRef.current = true;
+            setNetworkStateLogger(null);
+            logger.destroy().catch((error) => {
+                // The logger is going away; its last batch may not reach the webhook.
+                if (__DEV__)
+                    console.warn('[Logger] destroy failed', String(error));
+            });
         };
     }, [logger]);
+    // iOS may suspend or kill a backgrounded app at any moment (a BLE sync
+    // wakes it, then it is gone), so whatever is still batched goes to disk on
+    // the way out rather than with the next line.
+    useEffect(() => {
+        const subscription = AppState.addEventListener('change', (state) => {
+            if (state !== 'background' && state !== 'inactive')
+                return;
+            logger.flush().catch((error) => {
+                if (__DEV__)
+                    console.warn('[Logger] flush on background failed', String(error));
+            });
+        });
+        return () => subscription.remove();
+    }, [logger]);
     return (_jsx(LoggerContext.Provider, { value: logger, children: children }));
 }
 export function useLogger() {

package/dist/context/logging-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"logging-provider.js","sourceRoot":"","sources":["../../src/context/logging-provider.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAExC,MAAM,aAAa,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAA;AAOxD,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAwB;IACxE,oEAAoE;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAA;IAE1B,oEAAoE;IACpE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,sCAAsC;QACtC,IAAI,WAAqC,CAAA;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;YACzC,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;gBACrD,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAA2C,EAAE,EAAE;oBAC7E,IAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;wBAC1B,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;wBAC1D,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;oBACrC,CAAC;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,MAAM,CAAC;YACL,uDAAuD;QACzD,CAAC;QAED,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,EAAE,CAAA;YACf,MAAM,CAAC,OAAO,EAAE,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,OAAO,CACL,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAClC,QAAQ,GACc,CAC1B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"logging-provider.js","sourceRoot":"","sources":["../../src/context/logging-provider.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 export { LoggingProvider, useLogger } from './context/logging-provider';
+export type { InternalLogger } from './internal-log';
 export { createLogger } from './logger';
 export type { Logger } from './logger';
-export { addNetworkStateListener, getNetworkState, useNetworkState } from './network-state';
+export { addNetworkStateListener, getNetworkState, setNetworkStateLogger, useNetworkState } from './network-state';
 export { OfflineQueue } from './offline-queue';
+export { defaultRedact, REDACTED } from './redact';
 export { FileTransport } from './transports/file';
 export { RingBufferTransport } from './transports/ring-buffer';
 export { WebhookTransport } from './transports/webhook';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGtC,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAE3F,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGvD,YAAY,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAEvE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGlH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGvD,YAAY,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -3,9 +3,11 @@ export { LoggingProvider, useLogger } from './context/logging-provider';
 // Logger
 export { createLogger } from './logger';
 // Network (used internally, exported for convenience)
-export { addNetworkStateListener, getNetworkState, useNetworkState } from './network-state';
+export { addNetworkStateListener, getNetworkState, setNetworkStateLogger, useNetworkState } from './network-state';
 // Offline queue (exported for advanced usage)
 export { OfflineQueue } from './offline-queue';
+// Redaction (the default `LoggerConfig.redact`, for composing app rules)
+export { defaultRedact, REDACTED } from './redact';
 export { FileTransport } from './transports/file';
 // Transports (for custom composition)
 export { RingBufferTransport } from './transports/ring-buffer';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AACvE,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAIvC,sDAAsD;AACtD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC3F,8CAA8C;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,sCAAsC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAGvE,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,sDAAsD;AACtD,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElH,8CAA8C;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,yEAAyE;AACzE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,sCAAsC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/internal-log.d.ts

@@ -0,0 +1,31 @@
+/**
+ * How core's own parts (transports, offline queue, network state) report
+ * their failures. `createLogger` hands each part a logger that writes to every
+ * transport EXCEPT the one reporting — so a failing file write lands in the
+ * ring buffer instead of failing again and reporting again.
+ */
+export interface InternalLogger {
+    debug: (message: string, data?: Record<string, unknown>) => void;
+    info: (message: string, data?: Record<string, unknown>) => void;
+    warn: (message: string, data?: Record<string, unknown>) => void;
+    error: (message: string, data?: Record<string, unknown>) => void;
+}
+/**
+ * Fallback for a part used on its own, outside `createLogger`: failures to
+ * the dev console only (release has no reader for console output).
+ */
+export declare function devConsoleLogger(): InternalLogger;
+/**
+ * Collapses a run of identical failures into one report at its start and one
+ * at its end. A dead disk or a webhook answering 401 fails on every batch;
+ * reporting each would flood the ring buffer with the same line.
+ */
+export declare class FailureGate {
+    private failures;
+    /** True on the first failure of a run — the one worth reporting. */
+    fail(): boolean;
+    /** Failures in the run that just ended (0 if none). */
+    recover(): number;
+    get failing(): boolean;
+}
+//# sourceMappingURL=internal-log.d.ts.map

package/dist/internal-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-log.d.ts","sourceRoot":"","sources":["../src/internal-log.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACjE;AAWD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAajD;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAI;IAEpB,oEAAoE;IACpE,IAAI,IAAI,OAAO;IAKf,uDAAuD;IACvD,OAAO,IAAI,MAAM;IAMjB,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}

package/dist/internal-log.js

@@ -0,0 +1,50 @@
+function isDev() {
+    try {
+        return typeof __DEV__ !== 'undefined' ? __DEV__ : false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Fallback for a part used on its own, outside `createLogger`: failures to
+ * the dev console only (release has no reader for console output).
+ */
+export function devConsoleLogger() {
+    const out = (fn) => (message, data) => {
+        if (isDev())
+            fn(message, data ?? '');
+    };
+    const none = () => { };
+    return {
+        debug: none,
+        info: none,
+        warn: out(console.warn),
+        error: out(console.error),
+    };
+}
+/**
+ * Collapses a run of identical failures into one report at its start and one
+ * at its end. A dead disk or a webhook answering 401 fails on every batch;
+ * reporting each would flood the ring buffer with the same line.
+ */
+export class FailureGate {
+    constructor() {
+        this.failures = 0;
+    }
+    /** True on the first failure of a run — the one worth reporting. */
+    fail() {
+        this.failures++;
+        return this.failures === 1;
+    }
+    /** Failures in the run that just ended (0 if none). */
+    recover() {
+        const n = this.failures;
+        this.failures = 0;
+        return n;
+    }
+    get failing() {
+        return this.failures > 0;
+    }
+}
+//# sourceMappingURL=internal-log.js.map

package/dist/internal-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-log.js","sourceRoot":"","sources":["../src/internal-log.ts"],"names":[],"mappings":"AAaA,SAAS,KAAK;IACZ,IAAI,CAAC;QACH,OAAO,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;IACzD,CAAC;IACD,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,CAAC,EAAgC,EAAE,EAAE,CAC/C,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;QAClD,IAAI,KAAK,EAAE;YACT,EAAE,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;IAC3B,CAAC,CAAA;IACH,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;IACrB,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;QACvB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;KAC1B,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAAxB;QACU,aAAQ,GAAG,CAAC,CAAA;IAkBtB,CAAC;IAhBC,oEAAoE;IACpE,IAAI;QACF,IAAI,CAAC,QAAQ,EAAE,CAAA;QACf,OAAO,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,uDAAuD;IACvD,OAAO;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;QACjB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IAC1B,CAAC;CACF"}

package/dist/logger.d.ts

@@ -1,4 +1,13 @@
 import type { LogEntry, LogFilter, LoggerConfig } from './types';
+/**
+ * A JSON-safe snapshot of `data`, taken when the line is logged.
+ *
+ * Entries used to hold the caller's object by reference, so the export showed
+ * whatever it had been mutated into later; an `Error` exported as `{}` (its
+ * fields are non-enumerable); and one circular reference or BigInt made
+ * `exportLogs` throw, which emptied the whole export.
+ */
+export declare function sanitizeLogData(data?: Record<string, unknown>): Record<string, unknown> | undefined;
 export interface Logger {
     debug: (message: string, data?: Record<string, unknown>) => void;
     info: (message: string, data?: Record<string, unknown>) => void;
@@ -10,6 +19,12 @@ export interface Logger {
     setContext: (key: string, value: string) => void;
     getLogs: (filter?: LogFilter) => LogEntry[];
     exportLogs: (filter?: LogFilter) => string;
+    /**
+     * Every line the file transport has kept (all retained days, oldest first,
+     * one JSON entry per line). Survives restarts and crashes, unlike the ring
+     * buffer. Rejects when the file transport is not configured.
+     */
+    exportFileLogs: () => Promise<string>;
     flush: () => Promise<void>;
     destroy: () => Promise<void>;
 }

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,QAAQ,EACR,SAAS,EACT,YAAY,EAIb,MAAM,SAAS,CAAA;AAwChB,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAE3E,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEhD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,QAAQ,EAAE,CAAA;IAC3C,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,MAAM,CAAA;IAE1C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgJzD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,QAAQ,EACR,SAAS,EACT,YAAY,EAIb,MAAM,SAAS,CAAA;AAgHhB;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYnG;AAsDD,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC/D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAChE,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAE3E,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAEhD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,QAAQ,EAAE,CAAA;IAC3C,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,MAAM,CAAA;IAC1C;;;;OAIG;IACH,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAErC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgPzD"}

package/dist/logger.js

@@ -1,3 +1,5 @@
+import { FailureGate } from './internal-log';
+import { defaultRedact } from './redact';
 import { FileTransport } from './transports/file';
 import { RingBufferTransport } from './transports/ring-buffer';
 import { WebhookTransport } from './transports/webhook';
@@ -7,6 +9,142 @@ const LEVEL_ORDER = {
     warn: 2,
     error: 3,
 };
+function isLogLevel(value) {
+    return typeof value === 'string' && value in LEVEL_ORDER;
+}
+/**
+ * `minLevel` arrives from env in practice (`EXPO_PUBLIC_LOG_LEVEL`), where
+ * `'INFO'` or a typo is easy. An unknown level used to index LEVEL_ORDER to
+ * `undefined`, every comparison came out false, and nothing was filtered.
+ */
+function resolveMinLevel(configured, fallback) {
+    if (configured == null || configured === '')
+        return fallback;
+    const normalized = typeof configured === 'string' ? configured.trim().toLowerCase() : configured;
+    if (isLogLevel(normalized))
+        return normalized;
+    if (isDev())
+        console.warn(`[Logger] unknown minLevel ${JSON.stringify(configured)}; using '${fallback}'`);
+    return fallback;
+}
+const MAX_DEPTH = 6;
+const MAX_CAUSE_DEPTH = 3;
+// One logged readings array or document used to land in full in the file and
+// the webhook. Entries are capped instead; the marker says how much was cut.
+const MAX_STRING_LENGTH = 2000;
+const MAX_STACK_LENGTH = 8000;
+const MAX_ARRAY_ITEMS = 50;
+function capString(text, max = MAX_STRING_LENGTH) {
+    return text.length > max ? `${text.slice(0, max)}…[+${text.length - max} chars]` : text;
+}
+function serializeError(error, seen, depth, causeDepth) {
+    const out = { name: error.name, message: capString(error.message) };
+    if (error.stack)
+        out.stack = capString(error.stack, MAX_STACK_LENGTH);
+    // Own enumerable fields (`code`, `status`, ...) carry the useful detail on
+    // native and DB errors.
+    for (const [key, value] of Object.entries(error)) {
+        if (!(key in out))
+            out[key] = sanitizeValue(value, seen, depth + 1);
+    }
+    const cause = error.cause;
+    if (cause !== undefined) {
+        out.cause = causeDepth >= MAX_CAUSE_DEPTH
+            ? '[Cause depth exceeded]'
+            : cause instanceof Error
+                ? serializeError(cause, seen, depth + 1, causeDepth + 1)
+                : sanitizeValue(cause, seen, depth + 1);
+    }
+    return out;
+}
+function sanitizeValue(value, seen, depth) {
+    if (value === null || value === undefined)
+        return value;
+    switch (typeof value) {
+        case 'string':
+            return capString(value);
+        case 'number':
+        case 'boolean':
+            return value;
+        case 'bigint':
+            return value.toString();
+        case 'function':
+            return `[Function ${value.name || 'anonymous'}]`;
+        case 'symbol':
+            return value.toString();
+    }
+    const obj = value;
+    if (seen.has(obj))
+        return '[Circular]';
+    if (depth >= MAX_DEPTH)
+        return '[Depth exceeded]';
+    seen.add(obj);
+    try {
+        if (obj instanceof Error)
+            return serializeError(obj, seen, depth, 0);
+        if (obj instanceof Date)
+            return Number.isNaN(obj.getTime()) ? 'Invalid Date' : obj.toISOString();
+        if (Array.isArray(obj)) {
+            const items = obj.slice(0, MAX_ARRAY_ITEMS).map(item => sanitizeValue(item, seen, depth + 1));
+            if (obj.length > MAX_ARRAY_ITEMS)
+                items.push(`[+${obj.length - MAX_ARRAY_ITEMS} more]`);
+            return items;
+        }
+        const out = {};
+        for (const [key, item] of Object.entries(obj))
+            out[key] = sanitizeValue(item, seen, depth + 1);
+        return out;
+    }
+    finally {
+        // Only ancestors count as circular; the same object twice side by side
+        // is a repeat, not a cycle.
+        seen.delete(obj);
+    }
+}
+/**
+ * A JSON-safe snapshot of `data`, taken when the line is logged.
+ *
+ * Entries used to hold the caller's object by reference, so the export showed
+ * whatever it had been mutated into later; an `Error` exported as `{}` (its
+ * fields are non-enumerable); and one circular reference or BigInt made
+ * `exportLogs` throw, which emptied the whole export.
+ */
+export function sanitizeLogData(data) {
+    if (data === undefined || data === null)
+        return undefined;
+    try {
+        const out = sanitizeValue(data, new WeakSet(), 0);
+        return out !== null && typeof out === 'object' && !Array.isArray(out)
+            ? out
+            : { value: out };
+    }
+    catch (error) {
+        return { unserializable: String(error) };
+    }
+}
+function stringifyEntries(entries) {
+    try {
+        return JSON.stringify(entries, null, 2);
+    }
+    catch {
+        // Per entry, so one bad line cannot empty the export.
+        const parts = entries.map((entry) => {
+            try {
+                return JSON.stringify(entry, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    id: entry.id,
+                    timestamp: entry.timestamp,
+                    level: entry.level,
+                    message: entry.message,
+                    data: { unserializable: String(error) },
+                }, null, 2);
+            }
+        });
+        return `[\n${parts.join(',\n')}\n]`;
+    }
+}
 let counter = 0;
 function generateId() {
     return `${Date.now()}-${++counter}`;
@@ -33,10 +171,11 @@ function isDev() {
 }
 export function createLogger(config) {
     const dev = isDev();
-    const minLevel = config.minLevel ?? (dev ? 'debug' : 'info');
+    const minLevel = resolveMinLevel(config.minLevel, dev ? 'debug' : 'info');
     const minLevelNum = LEVEL_ORDER[minLevel];
     const sessionId = generateSessionId();
     const platform = getPlatform();
+    const redact = config.redact === false ? null : config.redact ?? defaultRedact;
     // Mutable context
     const ctx = {
         sessionId,
@@ -45,10 +184,19 @@ export function createLogger(config) {
         platform,
     };
     const extraContext = {};
+    // Per-transport failure runs, so a transport that rejects every entry
+    // reports once rather than once per line.
+    const sendFailures = new Map();
+    // Set while a core part's report is being routed. A report raised from
+    // inside another report is dropped: core must never log about logging in
+    // a loop.
+    let reporting = false;
     // Initialize transports
     const transports = [];
     let ringBuffer = null;
+    let fileTransport = null;
     let webhookTransport = null;
+    let fileUnavailable = null;
     // Ring buffer
     if (config.ringBuffer) {
         const rbConfig = typeof config.ringBuffer === 'boolean' ? {} : config.ringBuffer;
@@ -58,62 +206,134 @@ export function createLogger(config) {
     // File transport
     if (config.file) {
         const fileConfig = typeof config.file === 'boolean' ? {} : config.file;
-        transports.push(new FileTransport(fileConfig));
+        try {
+            fileTransport = new FileTransport(fileConfig, internalLogger('file'));
+            transports.push(fileTransport);
+        }
+        catch (error) {
+            // expo-file-system missing: logging still works without the file.
+            // Reported once the other transports exist (below).
+            fileUnavailable = String(error);
+        }
     }
     // Webhook transport
     if (config.webhook) {
-        webhookTransport = new WebhookTransport(config.webhook);
+        webhookTransport = new WebhookTransport(config.webhook, internalLogger('webhook'));
         transports.push(webhookTransport);
     }
     // Custom transports
     if (config.transports) {
         transports.push(...config.transports);
     }
+    if (fileUnavailable !== null)
+        log('warn', '[Logger] file transport unavailable; file log disabled', { error: fileUnavailable });
     function buildEntry(level, message, data) {
-        return {
+        const entry = {
             id: generateId(),
             timestamp: new Date().toISOString(),
             level,
-            message,
-            data,
+            message: capString(String(message)),
+            data: sanitizeLogData(data),
             context: { ...ctx, ...extraContext },
         };
+        if (!redact)
+            return entry;
+        try {
+            return redact(entry);
+        }
+        catch (error) {
+            // A throwing app hook must not leak the line it failed on, nor throw
+            // into the caller: fall back to the default rules and say so.
+            const safe = defaultRedact(entry);
+            return { ...safe, data: { ...safe.data, redactFailed: String(error) } };
+        }
+    }
+    function route(entry, skip) {
+        for (const transport of transports) {
+            if (transport.name === skip)
+                continue;
+            transport.send([entry]).then(() => {
+                const failed = sendFailures.get(transport.name)?.recover() ?? 0;
+                if (failed > 0)
+                    report(transport.name, 'info', '[Logger] transport recovered', { transport: transport.name, failedSends: failed });
+            }, (error) => {
+                let gate = sendFailures.get(transport.name);
+                if (!gate) {
+                    gate = new FailureGate();
+                    sendFailures.set(transport.name, gate);
+                }
+                if (gate.fail())
+                    report(transport.name, 'error', '[Logger] transport send failed', { transport: transport.name, error: String(error) });
+            });
+        }
+    }
+    function toConsole(level, message, data) {
+        const consoleFn = level === 'error'
+            ? console.error
+            : level === 'warn'
+                ? console.warn
+                : level === 'debug'
+                    ? console.debug
+                    : console.log;
+        consoleFn(`[${level.toUpperCase()}] ${message}`, data ?? '');
     }
-    function log(level, message, data) {
-        if (LEVEL_ORDER[level] < minLevelNum)
+    /**
+     * `force` skips the `minLevel` filter. `error` is never filtered either:
+     * it is the top level, and stays recorded whatever the config says.
+     */
+    function log(level, message, data, force = false) {
+        if (!force && level !== 'error' && LEVEL_ORDER[level] < minLevelNum)
             return;
         const entry = buildEntry(level, message, data);
-        // Console output in dev
-        if (dev) {
-            const consoleFn = level === 'error'
-                ? console.error
-                : level === 'warn'
-                    ? console.warn
-                    : level === 'debug'
-                        ? console.debug
-                        : console.log;
-            consoleFn(`[${level.toUpperCase()}] ${message}`, data ?? '');
+        if (dev)
+            toConsole(level, entry.message, entry.data);
+        route(entry);
+    }
+    /** A report from core's own `source` transport: routed everywhere else. */
+    function report(source, level, message, data) {
+        if (reporting || LEVEL_ORDER[level] < minLevelNum)
+            return;
+        reporting = true;
+        try {
+            const entry = buildEntry(level, message, data);
+            if (dev)
+                toConsole(level, entry.message, entry.data);
+            route(entry, source);
         }
-        // Route to all transports (non-blocking)
-        for (const transport of transports) {
-            transport.send([entry]).catch(() => {
-                // Transport errors are non-fatal
-            });
+        finally {
+            reporting = false;
         }
     }
+    function internalLogger(source) {
+        return {
+            debug: (message, data) => report(source, 'debug', message, data),
+            info: (message, data) => report(source, 'info', message, data),
+            warn: (message, data) => report(source, 'warn', message, data),
+            error: (message, data) => report(source, 'error', message, data),
+        };
+    }
     const logger = {
         debug: (message, data) => log('debug', message, data),
         info: (message, data) => log('info', message, data),
         warn: (message, data) => log('warn', message, data),
         error: (message, data) => log('error', message, data),
         captureException(error, context) {
-            log('error', error.message, {
-                stack: error.stack,
-                name: error.name,
+            // JS callers hand over whatever was thrown; a non-Error must not turn
+            // into an `undefined` message.
+            const err = error instanceof Error ? error : new Error(String(error));
+            // Recorded whatever `minLevel` says.
+            log('error', err.message, {
+                stack: err.stack,
+                name: err.name,
                 ...context,
-            });
+            }, true);
             if (config.onException) {
-                config.onException(error, context);
+                try {
+                    config.onException(err, context);
+                }
+                catch (hookError) {
+                    log('error', '[Logger] onException hook threw', { error: String(hookError) }, true);
+                }
             }
         },
         setUser(userId) {
@@ -136,10 +356,16 @@ export function createLogger(config) {
             if (!ringBuffer) {
                 throw new Error('Ring buffer not configured. Enable ringBuffer in LoggerConfig.');
             }
-            const entries = ringBuffer.getEntries(filter);
-            return JSON.stringify(entries, null, 2);
+            return stringifyEntries(ringBuffer.getEntries(filter));
+        },
+        async exportFileLogs() {
+            if (!fileTransport) {
+                throw new Error('File transport not configured. Enable file in LoggerConfig.');
+            }
+            return fileTransport.readAll();
         },
         async flush() {
+            await fileTransport?.flush();
             if (webhookTransport) {
                 await webhookTransport.flush();
             }