joopjs 2.0.0

package/dist/network-monitor-BIwPSXme.d.mts

@@ -0,0 +1,179 @@
+import { e as JoopKeyVaultAdapter, f as JoopBiometricAdapter, g as JoopPushAdapter, h as JoopPushPayload, i as JoopLifecycleAdapter, J as JoopAppState, j as JoopNetworkAdapter, a as JoopNetworkState, b as JoopNetworkType } from './adapters-B6slG6hQ.mjs';
+import { J as JoopObservable } from './index-Dz0gOur2.mjs';
+
+interface JoopDeviceInfo {
+    fingerprint: string;
+    userAgent: string;
+    language: string;
+    timezone: string;
+    screenResolution: string;
+    colorDepth: number;
+    platform: string;
+    hardwareConcurrency: number;
+    maxTouchPoints: number;
+}
+declare class JoopDeviceFingerprintService {
+    collect(): Omit<JoopDeviceInfo, 'fingerprint'>;
+    generate(): Promise<string>;
+    getStableId(): Promise<string>;
+}
+
+interface JoopKeyVaultConfig {
+    /** AES-GCM encryption password. If omitted, values are base64-encoded only (no encryption). */
+    encryptionKey?: string;
+    /** localStorage key prefix. Default: 'joop_vault_' */
+    prefix?: string;
+    /** Override platform adapter (e.g. react-native-keychain wrapper) */
+    adapter?: JoopKeyVaultAdapter;
+}
+declare class JoopKeyVault {
+    private _prefix;
+    private _encKey;
+    private _adapter;
+    private _cryptoKey;
+    constructor(config?: JoopKeyVaultConfig);
+    /** Store a secret. On web: AES-GCM encrypted if `encryptionKey` was provided. */
+    set(key: string, value: string): Promise<void>;
+    /** Retrieve a secret, or null if not found. */
+    get(key: string): Promise<string | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /** Rotate the encryption key: re-encrypts all known entries with a new key. */
+    rotateKey(newEncryptionKey: string, keys: string[]): Promise<void>;
+    private _key;
+}
+
+interface JoopBiometricConfig {
+    /** WebAuthn relying-party ID (default: current hostname) */
+    rpId?: string;
+    /** WebAuthn relying-party name */
+    rpName?: string;
+    /** Override platform adapter (e.g. react-native-biometrics wrapper) */
+    adapter?: JoopBiometricAdapter;
+}
+interface JoopEnrollResult {
+    credentialId: string;
+    publicKey?: string;
+}
+interface JoopAuthenticateOptions {
+    credentialId?: string;
+    reason?: string;
+    timeout?: number;
+}
+declare class JoopBiometricAuth {
+    private _rpId;
+    private _rpName;
+    private _adapter;
+    constructor(config?: JoopBiometricConfig);
+    /** True when a platform authenticator is available. */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Enroll a new credential for the given user.
+     * Web: creates a WebAuthn passkey via navigator.credentials.create().
+     * React Native: delegates to the injected adapter.
+     */
+    enroll(userId: string, displayName: string): Promise<JoopEnrollResult>;
+    /**
+     * Verify identity against an existing credential.
+     * Web: navigator.credentials.get() with WebAuthn assertion.
+     * React Native: delegates to the injected adapter.
+     */
+    authenticate(options?: JoopAuthenticateOptions): Promise<boolean>;
+    /**
+     * Quick check — asks the platform if biometrics can be used right now.
+     * Does not prompt the user.
+     */
+    canAuthenticate(): Promise<boolean>;
+}
+
+type JoopPushPermission = 'granted' | 'denied' | 'default' | 'unsupported';
+interface JoopPushConfig {
+    /** VAPID public key (base64url) for web push subscription */
+    vapidPublicKey?: string;
+    /** Path to the service worker file (default: '/sw.js') */
+    serviceWorkerPath?: string;
+    /** Override platform adapter (e.g. FCM / APNs wrapper) */
+    adapter?: JoopPushAdapter;
+}
+interface JoopPushSubscriptionInfo {
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+}
+declare class JoopPushService {
+    private _cfg;
+    private _adapter;
+    private _messageHandlers;
+    private _adapterUnsub;
+    constructor(config?: JoopPushConfig);
+    /** Request push notification permission from the user. */
+    requestPermission(): Promise<JoopPushPermission>;
+    /** Get the current permission status without prompting. */
+    getPermission(): JoopPushPermission;
+    /**
+     * Subscribe to web push and return subscription info to send to your server.
+     * Requires a service worker and a VAPID key.
+     */
+    subscribe(options?: {
+        vapidPublicKey?: string;
+    }): Promise<JoopPushSubscriptionInfo | null>;
+    /** Unsubscribe from web push. */
+    unsubscribe(): Promise<boolean>;
+    /** Display an immediate local notification (no server push required). */
+    show(payload: JoopPushPayload): Promise<void>;
+    /** Set the app badge count (mobile only via adapter). */
+    setBadgeCount(count: number): Promise<void>;
+    /** Clear the app badge. */
+    clearBadge(): Promise<void>;
+    /** Register a handler for incoming push payloads (foreground messages). */
+    onMessage(handler: (payload: JoopPushPayload) => void): () => void;
+    destroy(): void;
+    private _emit;
+}
+
+interface JoopLifecycleConfig {
+    /** Override platform adapter (e.g. RN AppState wrapper) */
+    adapter?: JoopLifecycleAdapter;
+}
+declare class JoopAppLifecycle {
+    private _state$;
+    private _cleanup;
+    private _adapter;
+    constructor(config?: JoopLifecycleConfig);
+    private _init;
+    getState(): JoopAppState;
+    state$(): JoopObservable<JoopAppState>;
+    isActive(): boolean;
+    /** Call fn each time the app comes to the foreground (background → active). */
+    onForeground(fn: () => void): () => void;
+    /** Call fn each time the app goes to the background (active → background). */
+    onBackground(fn: () => void): () => void;
+    destroy(): void;
+}
+
+interface JoopNetworkMonitorConfig {
+    /** Override platform adapter (e.g. RN NetInfo wrapper) */
+    adapter?: JoopNetworkAdapter;
+}
+declare class JoopNetworkMonitor {
+    private _adapter;
+    private _state$;
+    private _cleanup;
+    constructor(config?: JoopNetworkMonitorConfig);
+    private _init;
+    private _read;
+    getState(): JoopNetworkState;
+    state$(): JoopObservable<JoopNetworkState>;
+    isOnline(): boolean;
+    isMetered(): boolean;
+    /** Call fn when connectivity is regained. */
+    onOnline(fn: () => void): () => void;
+    /** Call fn when connectivity is lost. */
+    onOffline(fn: () => void): () => void;
+    /** Call fn when the connection type changes (e.g. wifi → cellular). */
+    onTypeChange(fn: (type: JoopNetworkType) => void): () => void;
+    destroy(): void;
+}
+
+export { JoopNetworkMonitor as J, JoopKeyVault as a, JoopDeviceFingerprintService as b, JoopBiometricAuth as c, JoopPushService as d, JoopAppLifecycle as e, type JoopAuthenticateOptions as f, type JoopBiometricConfig as g, type JoopDeviceInfo as h, type JoopEnrollResult as i, type JoopKeyVaultConfig as j, type JoopLifecycleConfig as k, type JoopNetworkMonitorConfig as l, type JoopPushConfig as m, type JoopPushPermission as n, type JoopPushSubscriptionInfo as o };

package/dist/network-monitor-Bqp2hvZr.d.ts

@@ -0,0 +1,179 @@
+import { e as JoopKeyVaultAdapter, f as JoopBiometricAdapter, g as JoopPushAdapter, h as JoopPushPayload, i as JoopLifecycleAdapter, J as JoopAppState, j as JoopNetworkAdapter, a as JoopNetworkState, b as JoopNetworkType } from './adapters-B6slG6hQ.js';
+import { J as JoopObservable } from './index-Dz0gOur2.js';
+
+interface JoopDeviceInfo {
+    fingerprint: string;
+    userAgent: string;
+    language: string;
+    timezone: string;
+    screenResolution: string;
+    colorDepth: number;
+    platform: string;
+    hardwareConcurrency: number;
+    maxTouchPoints: number;
+}
+declare class JoopDeviceFingerprintService {
+    collect(): Omit<JoopDeviceInfo, 'fingerprint'>;
+    generate(): Promise<string>;
+    getStableId(): Promise<string>;
+}
+
+interface JoopKeyVaultConfig {
+    /** AES-GCM encryption password. If omitted, values are base64-encoded only (no encryption). */
+    encryptionKey?: string;
+    /** localStorage key prefix. Default: 'joop_vault_' */
+    prefix?: string;
+    /** Override platform adapter (e.g. react-native-keychain wrapper) */
+    adapter?: JoopKeyVaultAdapter;
+}
+declare class JoopKeyVault {
+    private _prefix;
+    private _encKey;
+    private _adapter;
+    private _cryptoKey;
+    constructor(config?: JoopKeyVaultConfig);
+    /** Store a secret. On web: AES-GCM encrypted if `encryptionKey` was provided. */
+    set(key: string, value: string): Promise<void>;
+    /** Retrieve a secret, or null if not found. */
+    get(key: string): Promise<string | null>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /** Rotate the encryption key: re-encrypts all known entries with a new key. */
+    rotateKey(newEncryptionKey: string, keys: string[]): Promise<void>;
+    private _key;
+}
+
+interface JoopBiometricConfig {
+    /** WebAuthn relying-party ID (default: current hostname) */
+    rpId?: string;
+    /** WebAuthn relying-party name */
+    rpName?: string;
+    /** Override platform adapter (e.g. react-native-biometrics wrapper) */
+    adapter?: JoopBiometricAdapter;
+}
+interface JoopEnrollResult {
+    credentialId: string;
+    publicKey?: string;
+}
+interface JoopAuthenticateOptions {
+    credentialId?: string;
+    reason?: string;
+    timeout?: number;
+}
+declare class JoopBiometricAuth {
+    private _rpId;
+    private _rpName;
+    private _adapter;
+    constructor(config?: JoopBiometricConfig);
+    /** True when a platform authenticator is available. */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Enroll a new credential for the given user.
+     * Web: creates a WebAuthn passkey via navigator.credentials.create().
+     * React Native: delegates to the injected adapter.
+     */
+    enroll(userId: string, displayName: string): Promise<JoopEnrollResult>;
+    /**
+     * Verify identity against an existing credential.
+     * Web: navigator.credentials.get() with WebAuthn assertion.
+     * React Native: delegates to the injected adapter.
+     */
+    authenticate(options?: JoopAuthenticateOptions): Promise<boolean>;
+    /**
+     * Quick check — asks the platform if biometrics can be used right now.
+     * Does not prompt the user.
+     */
+    canAuthenticate(): Promise<boolean>;
+}
+
+type JoopPushPermission = 'granted' | 'denied' | 'default' | 'unsupported';
+interface JoopPushConfig {
+    /** VAPID public key (base64url) for web push subscription */
+    vapidPublicKey?: string;
+    /** Path to the service worker file (default: '/sw.js') */
+    serviceWorkerPath?: string;
+    /** Override platform adapter (e.g. FCM / APNs wrapper) */
+    adapter?: JoopPushAdapter;
+}
+interface JoopPushSubscriptionInfo {
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+}
+declare class JoopPushService {
+    private _cfg;
+    private _adapter;
+    private _messageHandlers;
+    private _adapterUnsub;
+    constructor(config?: JoopPushConfig);
+    /** Request push notification permission from the user. */
+    requestPermission(): Promise<JoopPushPermission>;
+    /** Get the current permission status without prompting. */
+    getPermission(): JoopPushPermission;
+    /**
+     * Subscribe to web push and return subscription info to send to your server.
+     * Requires a service worker and a VAPID key.
+     */
+    subscribe(options?: {
+        vapidPublicKey?: string;
+    }): Promise<JoopPushSubscriptionInfo | null>;
+    /** Unsubscribe from web push. */
+    unsubscribe(): Promise<boolean>;
+    /** Display an immediate local notification (no server push required). */
+    show(payload: JoopPushPayload): Promise<void>;
+    /** Set the app badge count (mobile only via adapter). */
+    setBadgeCount(count: number): Promise<void>;
+    /** Clear the app badge. */
+    clearBadge(): Promise<void>;
+    /** Register a handler for incoming push payloads (foreground messages). */
+    onMessage(handler: (payload: JoopPushPayload) => void): () => void;
+    destroy(): void;
+    private _emit;
+}
+
+interface JoopLifecycleConfig {
+    /** Override platform adapter (e.g. RN AppState wrapper) */
+    adapter?: JoopLifecycleAdapter;
+}
+declare class JoopAppLifecycle {
+    private _state$;
+    private _cleanup;
+    private _adapter;
+    constructor(config?: JoopLifecycleConfig);
+    private _init;
+    getState(): JoopAppState;
+    state$(): JoopObservable<JoopAppState>;
+    isActive(): boolean;
+    /** Call fn each time the app comes to the foreground (background → active). */
+    onForeground(fn: () => void): () => void;
+    /** Call fn each time the app goes to the background (active → background). */
+    onBackground(fn: () => void): () => void;
+    destroy(): void;
+}
+
+interface JoopNetworkMonitorConfig {
+    /** Override platform adapter (e.g. RN NetInfo wrapper) */
+    adapter?: JoopNetworkAdapter;
+}
+declare class JoopNetworkMonitor {
+    private _adapter;
+    private _state$;
+    private _cleanup;
+    constructor(config?: JoopNetworkMonitorConfig);
+    private _init;
+    private _read;
+    getState(): JoopNetworkState;
+    state$(): JoopObservable<JoopNetworkState>;
+    isOnline(): boolean;
+    isMetered(): boolean;
+    /** Call fn when connectivity is regained. */
+    onOnline(fn: () => void): () => void;
+    /** Call fn when connectivity is lost. */
+    onOffline(fn: () => void): () => void;
+    /** Call fn when the connection type changes (e.g. wifi → cellular). */
+    onTypeChange(fn: (type: JoopNetworkType) => void): () => void;
+    destroy(): void;
+}
+
+export { JoopNetworkMonitor as J, JoopKeyVault as a, JoopDeviceFingerprintService as b, JoopBiometricAuth as c, JoopPushService as d, JoopAppLifecycle as e, type JoopAuthenticateOptions as f, type JoopBiometricConfig as g, type JoopDeviceInfo as h, type JoopEnrollResult as i, type JoopKeyVaultConfig as j, type JoopLifecycleConfig as k, type JoopNetworkMonitorConfig as l, type JoopPushConfig as m, type JoopPushPermission as n, type JoopPushSubscriptionInfo as o };

package/dist/notification.service-Dm4fvfZf.d.mts

@@ -0,0 +1,25 @@
+import { J as JoopObservable } from './index-Dz0gOur2.mjs';
+
+type JoopNotificationPermission = 'default' | 'granted' | 'denied';
+interface JoopNotificationOptions extends NotificationOptions {
+    tag?: string;
+    requireInteraction?: boolean;
+}
+declare class JoopNotificationService {
+    private _permission$;
+    private _messageHandlers;
+    private _swReg;
+    isSupported(): boolean;
+    getPermission(): JoopNotificationPermission;
+    permission$(): JoopObservable<JoopNotificationPermission>;
+    requestPermission(): Promise<JoopNotificationPermission>;
+    show(title: string, options?: JoopNotificationOptions): Promise<Notification | null>;
+    setServiceWorker(reg: ServiceWorkerRegistration): Promise<void>;
+    subscribe(vapidPublicKey: string): Promise<PushSubscription | null>;
+    unsubscribe(): Promise<boolean>;
+    getSubscription(): Promise<PushSubscription | null>;
+    onMessage(handler: (event: MessageEvent) => void): () => void;
+    destroy(): void;
+}
+
+export { JoopNotificationService as J, type JoopNotificationOptions as a, type JoopNotificationPermission as b };

package/dist/notification.service-tEMKatWJ.d.ts

@@ -0,0 +1,25 @@
+import { J as JoopObservable } from './index-Dz0gOur2.js';
+
+type JoopNotificationPermission = 'default' | 'granted' | 'denied';
+interface JoopNotificationOptions extends NotificationOptions {
+    tag?: string;
+    requireInteraction?: boolean;
+}
+declare class JoopNotificationService {
+    private _permission$;
+    private _messageHandlers;
+    private _swReg;
+    isSupported(): boolean;
+    getPermission(): JoopNotificationPermission;
+    permission$(): JoopObservable<JoopNotificationPermission>;
+    requestPermission(): Promise<JoopNotificationPermission>;
+    show(title: string, options?: JoopNotificationOptions): Promise<Notification | null>;
+    setServiceWorker(reg: ServiceWorkerRegistration): Promise<void>;
+    subscribe(vapidPublicKey: string): Promise<PushSubscription | null>;
+    unsubscribe(): Promise<boolean>;
+    getSubscription(): Promise<PushSubscription | null>;
+    onMessage(handler: (event: MessageEvent) => void): () => void;
+    destroy(): void;
+}
+
+export { JoopNotificationService as J, type JoopNotificationOptions as a, type JoopNotificationPermission as b };

package/dist/observability/index.d.mts

@@ -0,0 +1,179 @@
+import { J as JoopObservable } from '../index-Dz0gOur2.mjs';
+
+declare class JoopCorrelationService {
+    private _correlationId;
+    private _requestId;
+    newCorrelation(): string;
+    newRequest(): string;
+    getCorrelationId(): string;
+    getRequestId(): string;
+    headers(): Record<string, string>;
+    clear(): void;
+}
+
+type JoopAuditAction = 'login' | 'logout' | 'session-timeout' | 'session-extended' | 'transfer-initiated' | 'transfer-confirmed' | 'transfer-failed' | 'profile-updated' | 'password-changed' | 'settings-changed' | 'document-viewed' | 'statement-downloaded' | 'otp-sent' | 'otp-verified' | 'biometric-registered' | 'biometric-authenticated' | string;
+interface JoopAuditEntry {
+    id: string;
+    action: JoopAuditAction;
+    timestamp: number;
+    userId?: string;
+    sessionId?: string;
+    correlationId?: string;
+    metadata?: Record<string, unknown>;
+    success: boolean;
+}
+type JoopAuditListener = (entry: JoopAuditEntry) => void;
+declare class JoopAuditLog {
+    private _maxEntries;
+    private _entries;
+    private _listeners;
+    constructor(_maxEntries?: number);
+    record(action: JoopAuditAction, options?: {
+        userId?: string;
+        sessionId?: string;
+        correlationId?: string;
+        metadata?: Record<string, unknown>;
+        success?: boolean;
+    }): JoopAuditEntry;
+    getAll(): JoopAuditEntry[];
+    getByAction(action: JoopAuditAction): JoopAuditEntry[];
+    getBySession(sessionId: string): JoopAuditEntry[];
+    getByUser(userId: string): JoopAuditEntry[];
+    onRecord(listener: JoopAuditListener): () => void;
+    clear(): void;
+    export(): string;
+}
+
+interface JoopPerfMark {
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    metadata?: Record<string, unknown>;
+}
+declare class JoopPerformanceService {
+    private _marks;
+    private _completed;
+    mark(name: string, metadata?: Record<string, unknown>): void;
+    measure(name: string): JoopPerfMark | null;
+    timeAsync<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    timeSync<T>(name: string, fn: () => T): T;
+    getCompleted(): JoopPerfMark[];
+    getByName(name: string): JoopPerfMark[];
+    getAverage(name: string): number | null;
+    clear(): void;
+}
+
+interface JoopErrorReport {
+    id: string;
+    message: string;
+    stack?: string;
+    context?: Record<string, unknown>;
+    timestamp: number;
+    userId?: string;
+    sessionId?: string;
+}
+type JoopErrorHandler = (report: JoopErrorReport) => void | Promise<void>;
+declare class JoopErrorReporter {
+    private _handlers;
+    private _userId;
+    private _sessionId;
+    private _context;
+    setUser(userId: string): void;
+    setSession(sessionId: string): void;
+    setContext(ctx: Record<string, unknown>): void;
+    addHandler(handler: JoopErrorHandler): () => void;
+    capture(error: unknown, extra?: Record<string, unknown>): JoopErrorReport;
+    captureMessage(message: string, extra?: Record<string, unknown>): JoopErrorReport;
+    clear(): void;
+}
+
+interface JoopVitalsSnapshot {
+    lcp: number | null;
+    fid: number | null;
+    inp: number | null;
+    cls: number | null;
+    ttfb: number | null;
+    fcp: number | null;
+    capturedAt: number;
+}
+interface JoopVitalUpdate {
+    metric: keyof Omit<JoopVitalsSnapshot, 'capturedAt'>;
+    value: number;
+    rating: 'good' | 'needs-improvement' | 'poor';
+}
+declare class JoopWebVitals {
+    private _vitals;
+    private _vitals$;
+    private _snapshot$;
+    private _observers;
+    private _running;
+    start(): void;
+    stop(): void;
+    snapshot(): JoopVitalsSnapshot;
+    vitals$(): JoopObservable<JoopVitalUpdate>;
+    snapshot$(): JoopObservable<JoopVitalsSnapshot>;
+    getLCP(): number | null;
+    getCLS(): number | null;
+    getINP(): number | null;
+    getTTFB(): number | null;
+    getFCP(): number | null;
+    getFID(): number | null;
+    getRating(metric: string): 'good' | 'needs-improvement' | 'poor';
+    private _record;
+    private _observe;
+    private _observeLCP;
+    private _observeFID;
+    private _observeINP;
+    private _observeCLS;
+    private _observeTTFB;
+    private _observeFCP;
+    private _buildSnapshot;
+}
+
+type JoopRecordedEventType = 'dom-mutation' | 'click' | 'input' | 'scroll' | 'resize' | 'navigation' | 'custom';
+interface JoopRecordedEvent {
+    type: JoopRecordedEventType;
+    timestamp: number;
+    selector?: string;
+    value?: string;
+    data?: Record<string, unknown>;
+}
+interface JoopSessionRecord {
+    startedAt: number;
+    stoppedAt: number;
+    events: JoopRecordedEvent[];
+    url: string;
+    userAgent: string;
+}
+interface JoopSessionRecorderOptions {
+    maskSelectors?: string[];
+    ignoreSelectors?: string[];
+    redactInputs?: boolean;
+    maxEvents?: number;
+    captureScroll?: boolean;
+    captureResize?: boolean;
+}
+declare class JoopSessionRecorder {
+    private _events;
+    private _running;
+    private _paused;
+    private _startedAt;
+    private _opts;
+    private _cleanup;
+    private _mutationObserver;
+    private _scrollTimer;
+    start(options?: JoopSessionRecorderOptions): void;
+    pause(): void;
+    resume(): void;
+    stop(): JoopSessionRecord;
+    events(): JoopRecordedEvent[];
+    export(format?: 'json' | 'compressed'): string;
+    addEvent(type: JoopRecordedEventType, data?: Record<string, unknown>): void;
+    private _push;
+    private _attachListeners;
+    private _detach;
+    private _shouldIgnore;
+}
+
+export { type JoopAuditAction, type JoopAuditEntry, type JoopAuditListener, JoopAuditLog, JoopCorrelationService, type JoopErrorHandler, type JoopErrorReport, JoopErrorReporter, type JoopPerfMark, JoopPerformanceService, type JoopRecordedEvent, type JoopSessionRecord, JoopSessionRecorder, type JoopSessionRecorderOptions, type JoopVitalUpdate, type JoopVitalsSnapshot, JoopWebVitals };