@angular-helpers/browser-web-apis 21.4.0 → 21.6.0

package/types/angular-helpers-browser-web-apis.d.ts

@@ -1,32 +1,15 @@
 import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { DestroyRef, ElementRef, Signal, EnvironmentProviders } from '@angular/core';
+import { DestroyRef, ElementRef, Signal, InjectionToken, EnvironmentProviders } from '@angular/core';
 import { CanActivateFn } from '@angular/router';
 
-type PermissionNameExt = PermissionName | 'clipboard-read' | 'clipboard-write';
-interface PermissionRequest {
-    name: PermissionNameExt;
-    state: PermissionState;
-}
-interface BrowserPermissions {
-    query(descriptor: PermissionDescriptor): Promise<PermissionStatus>;
-    isSupported(): boolean;
-}
-
-declare class PermissionsService implements BrowserPermissions {
-    query(descriptor: PermissionDescriptor): Promise<PermissionStatus>;
-    isSupported(): boolean;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PermissionsService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PermissionsService>;
-}
-
 /**
  * Base class for all Browser Web API services.
  * Provides common functionality for:
  * - Platform detection (browser vs server)
  * - Support assertion via Template Method
  * - Error creation with cause chaining
- * - Structured logging
+ * - Structured logging via injectable BROWSER_API_LOGGER token
  * - Lifecycle management with destroyRef
  *
  * Services that also need permission querying should extend
@@ -35,6 +18,7 @@ declare class PermissionsService implements BrowserPermissions {
 declare abstract class BrowserApiBaseService {
     protected destroyRef: DestroyRef;
     protected platformId: Object;
+    private readonly logger;
     /**
      * Abstract method that must be implemented by child services.
      * Returns the API name used in log messages and error strings.
@@ -49,8 +33,8 @@ declare abstract class BrowserApiBaseService {
      */
     protected isServerEnvironment(): boolean;
     /**
-     * Template Method: throws a standard error when the API is not available.
-     * Uses getApiName() to produce consistent error messages.
+     * Template Method: asserts the service can run in the current environment.
+     * Subclasses must call super.ensureSupported() and then add their own API check.
      */
     protected ensureSupported(): void;
     /**
@@ -58,40 +42,43 @@ declare abstract class BrowserApiBaseService {
      */
     protected createError(message: string, cause?: unknown): Error;
     /**
-     * Log an error with the service name as prefix.
+     * Log an error through the injected BROWSER_API_LOGGER (default: console).
      */
     protected logError(message: string, error?: unknown): void;
     /**
-     * Log an informational message with the service name as prefix.
+     * Log a warning through the injected BROWSER_API_LOGGER (default: console).
+     */
+    protected logWarn(message: string): void;
+    /**
+     * Log an informational message through the injected BROWSER_API_LOGGER (default: console).
      */
     protected logInfo(message: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BrowserApiBaseService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<BrowserApiBaseService>;
 }
 
-/**
- * Extension of `BrowserApiBaseService` for services that need to query
- * browser permissions via the Permissions API.
- *
- * Only services that actively call `requestPermission()` should extend this
- * class. All other services should extend `BrowserApiBaseService` directly
- * to avoid carrying an unnecessary PermissionsService dependency.
- */
-declare abstract class PermissionAwareBrowserApiBaseService extends BrowserApiBaseService {
-    protected permissionsService: PermissionsService;
-    /**
-     * Query the Permissions API for the given permission name.
-     * Returns `true` if the permission state is `'granted'`.
-     */
-    protected requestPermission(permission: PermissionNameExt): Promise<boolean>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PermissionAwareBrowserApiBaseService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PermissionAwareBrowserApiBaseService>;
+type PermissionNameExt = PermissionName | 'clipboard-read' | 'clipboard-write';
+interface PermissionRequest {
+    name: PermissionNameExt;
+    state: PermissionState;
+}
+interface BrowserPermissions {
+    query(descriptor: PermissionDescriptor): Promise<PermissionStatus>;
+    isSupported(): boolean;
 }
 
-declare class CameraService extends PermissionAwareBrowserApiBaseService {
+declare class PermissionsService extends BrowserApiBaseService implements BrowserPermissions {
+    protected getApiName(): string;
+    query(descriptor: PermissionDescriptor): Promise<PermissionStatus>;
+    isSupported(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PermissionsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PermissionsService>;
+}
+
+declare class CameraService extends BrowserApiBaseService {
     private currentStream;
     protected getApiName(): string;
-    private ensureCameraSupport;
+    protected ensureSupported(): void;
     startCamera(constraints?: MediaStreamConstraints): Promise<MediaStream>;
     stopCamera(): void;
     switchCamera(deviceId: string, constraints?: MediaStreamConstraints): Promise<MediaStream>;
@@ -106,7 +93,7 @@ declare class CameraService extends PermissionAwareBrowserApiBaseService {
 
 declare class GeolocationService extends BrowserApiBaseService {
     protected getApiName(): string;
-    private ensureGeolocationSupport;
+    protected ensureSupported(): void;
     getCurrentPosition(options?: PositionOptions): Promise<GeolocationPosition>;
     watchPosition(options?: PositionOptions): Observable<GeolocationPosition>;
     clearWatch(watchId: number): void;
@@ -121,7 +108,7 @@ interface DisplayMediaConstraints {
 }
 declare class MediaDevicesService extends BrowserApiBaseService {
     protected getApiName(): string;
-    private ensureMediaDevicesSupport;
+    protected ensureSupported(): void;
     getDevices(): Promise<MediaDeviceInfo[]>;
     getUserMedia(constraints?: MediaStreamConstraints): Promise<MediaStream>;
     getDisplayMedia(constraints?: DisplayMediaConstraints): Promise<MediaStream>;
@@ -138,17 +125,17 @@ declare class MediaDevicesService extends BrowserApiBaseService {
 
 declare class NotificationService extends BrowserApiBaseService {
     protected getApiName(): string;
+    protected ensureSupported(): void;
     get permission(): NotificationPermission;
-    isSupported(): boolean;
     requestNotificationPermission(): Promise<NotificationPermission>;
     showNotification(title: string, options?: NotificationOptions): Promise<Notification>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NotificationService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NotificationService>;
 }
 
-declare class ClipboardService extends PermissionAwareBrowserApiBaseService {
+declare class ClipboardService extends BrowserApiBaseService {
     protected getApiName(): string;
-    private ensureClipboardPermission;
+    protected ensureSupported(): void;
     writeText(text: string): Promise<void>;
     readText(): Promise<string>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClipboardService, never>;
@@ -309,7 +296,7 @@ declare class BrowserCapabilityService {
     isSecureContext(): boolean;
     isSupported(capability: BrowserCapabilityId): boolean;
     getAllStatuses(): {
-        id: "camera" | "geolocation" | "permissions" | "mediaDevices" | "clipboard" | "notification" | "webWorker" | "regexSecurity" | "webStorage" | "webShare" | "battery" | "webSocket" | "intersectionObserver" | "resizeObserver" | "pageVisibility" | "broadcastChannel" | "networkInformation" | "screenWakeLock" | "screenOrientation" | "fullscreen" | "fileSystemAccess" | "mediaRecorder" | "serverSentEvents" | "vibration" | "speechSynthesis" | "mutationObserver" | "performanceObserver" | "idleDetector" | "eyeDropper" | "barcodeDetector" | "webAudio" | "gamepad" | "webBluetooth" | "webUsb" | "webNfc" | "paymentRequest" | "credentialManagement";
+        id: "camera" | "geolocation" | "permissions" | "clipboard" | "notification" | "mediaDevices" | "webWorker" | "regexSecurity" | "webStorage" | "webShare" | "battery" | "webSocket" | "intersectionObserver" | "resizeObserver" | "pageVisibility" | "broadcastChannel" | "networkInformation" | "screenWakeLock" | "screenOrientation" | "fullscreen" | "fileSystemAccess" | "mediaRecorder" | "serverSentEvents" | "vibration" | "speechSynthesis" | "mutationObserver" | "performanceObserver" | "idleDetector" | "eyeDropper" | "barcodeDetector" | "webAudio" | "gamepad" | "webBluetooth" | "webUsb" | "webNfc" | "paymentRequest" | "credentialManagement";
         label: "Permissions API" | "Geolocation API" | "Clipboard API" | "Notification API" | "MediaDevices API" | "Camera API" | "Web Worker API" | "Regex Security" | "Web Storage" | "Web Share" | "Battery API" | "WebSocket API" | "Intersection Observer" | "Resize Observer" | "Page Visibility API" | "Broadcast Channel API" | "Network Information API" | "Screen Wake Lock API" | "Screen Orientation API" | "Fullscreen API" | "File System Access API" | "MediaRecorder API" | "Server-Sent Events" | "Vibration API" | "Speech Synthesis API" | "Mutation Observer" | "Performance Observer" | "Idle Detection API" | "EyeDropper API" | "Barcode Detection API" | "Web Audio API" | "Gamepad API" | "Web Bluetooth API" | "WebUSB API" | "Web NFC API" | "Payment Request API" | "Credential Management API";
         supported: boolean;
         secureContext: boolean;
@@ -349,7 +336,7 @@ declare global {
 declare class BatteryService extends BrowserApiBaseService {
     private batteryManager;
     protected getApiName(): string;
-    private ensureBatterySupport;
+    protected ensureSupported(): void;
     initialize(): Promise<BatteryInfo>;
     getBatteryInfo(): BatteryInfo;
     watchBatteryInfo(): Observable<BatteryInfo>;
@@ -368,7 +355,7 @@ interface ShareResult {
 }
 declare class WebShareService extends BrowserApiBaseService {
     protected getApiName(): string;
-    private ensureWebShareSupport;
+    protected ensureSupported(): void;
     share(data: ShareData): Promise<ShareResult>;
     canShare(): boolean;
     canShareFiles(): boolean;
@@ -396,21 +383,21 @@ interface StorageOptions {
     deserialize?: (value: string) => StorageValue;
 }
 interface StorageEvent {
-    key: string;
+    key: string | null;
     newValue: StorageValue | null;
     oldValue: StorageValue | null;
     storageArea: 'localStorage' | 'sessionStorage';
 }
 declare class WebStorageService extends BrowserApiBaseService {
     private storageEvents;
-    protected destroyRef: DestroyRef;
     constructor();
     protected getApiName(): string;
-    private ensureStorageSupport;
+    protected ensureSupported(): void;
     private setupEventListeners;
     private serializeValue;
     private deserializeValue;
     private getKey;
+    private emitStorageChange;
     setLocalStorage<T extends StorageValue>(key: string, value: T, options?: StorageOptions): boolean;
     getLocalStorage<T extends StorageValue>(key: string, defaultValue?: T | null, options?: StorageOptions): T | null;
     removeLocalStorage(key: string, options?: StorageOptions): boolean;
@@ -430,19 +417,112 @@ declare class WebStorageService extends BrowserApiBaseService {
     static ɵprov: i0.ɵɵInjectableDeclaration<WebStorageService>;
 }
 
-interface WebSocketConfig {
+interface BrowserApiLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string, error?: unknown): void;
+}
+declare const BROWSER_API_LOGGER: InjectionToken<BrowserApiLogger>;
+
+/**
+ * Configuration for a single WebSocket connection.
+ */
+interface WebSocketClientConfig {
     url: string;
     protocols?: string | string[];
+    /**
+     * Initial reconnect delay in milliseconds. Used as the base for exponential backoff.
+     * Set to `0` or omit to disable automatic reconnection.
+     */
     reconnectInterval?: number;
+    /** Maximum number of automatic reconnect attempts. Defaults to `0` (disabled). */
     maxReconnectAttempts?: number;
+    /** Hard cap for reconnect delay in milliseconds. Defaults to `30_000`. */
+    maxReconnectDelay?: number;
+    /** Heartbeat interval in milliseconds. */
     heartbeatInterval?: number;
+    /** Payload sent on every heartbeat tick when `heartbeatInterval` is set. */
     heartbeatMessage?: unknown;
 }
 interface WebSocketMessage<T = unknown> {
+    /** Message identifier. Auto-generated when omitted. */
+    id?: string;
     type: string;
     data: T;
+    /** Server-assigned correlation id (used by `request()` to match responses). */
+    correlationId?: string;
     timestamp?: number;
 }
+type WebSocketState = 'idle' | 'connecting' | 'open' | 'closing' | 'closed' | 'reconnecting';
+interface WebSocketStatusV2 {
+    readonly state: WebSocketState;
+    readonly reconnectAttempts: number;
+    readonly error: string | null;
+}
+interface WebSocketRequestOptions {
+    /** Timeout in milliseconds. Defaults to `30_000`. */
+    timeout?: number;
+}
+/**
+ * Stateful WebSocket client wrapping a single connection. One instance per logical
+ * connection (do NOT share between `connect()` calls).
+ *
+ * Surfaces:
+ * - `status`: signal of the current connection state.
+ * - `messages$`: stream of every received message (parsed JSON).
+ * - `send` / `sendRaw`: outbound traffic.
+ * - `request<T>(type, data)`: round-trip with id correlation and timeout.
+ * - `close`: idempotent disposal.
+ *
+ * Reconnect uses exponential backoff with jitter, capped by `maxReconnectDelay`.
+ */
+declare class WebSocketClient {
+    private readonly config;
+    private readonly logger;
+    private socket;
+    private reconnectTimer;
+    private heartbeatTimer;
+    private readonly _status;
+    private readonly _messages$;
+    private readonly pendingRequests;
+    private disposed;
+    private reconnectAttempts;
+    constructor(config: WebSocketClientConfig, logger: BrowserApiLogger, destroyRef?: DestroyRef);
+    get status(): Signal<WebSocketStatusV2>;
+    get messages$(): Observable<WebSocketMessage>;
+    messagesByType<T = unknown>(type: string): Observable<WebSocketMessage<T>>;
+    send<T>(message: WebSocketMessage<T>): void;
+    sendRaw(data: string): void;
+    /**
+     * Send a message and await a correlated response. The server MUST echo back the
+     * `correlationId` from the request as `correlationId` on the response message.
+     */
+    request<TRes = unknown, TReq = unknown>(type: string, data: TReq, opts?: WebSocketRequestOptions): Promise<TRes>;
+    close(): void;
+    /** Internal handle for tests and advanced usage. */
+    getNativeSocket(): WebSocket | null;
+    private openSocket;
+    private attachHandlers;
+    private handleIncoming;
+    private scheduleReconnect;
+    /**
+     * Exponential backoff with full jitter:
+     *   baseDelay = min(maxDelay, interval * 2^(attempt - 1))
+     *   delay     = random(0, baseDelay)
+     */
+    static computeBackoffDelay(attempt: number, interval: number, maxDelay: number): number;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private clearTimers;
+    private rejectAllPending;
+    private updateStatus;
+    private generateId;
+}
+
+/**
+ * @deprecated Use `WebSocketStatusV2` (via `WebSocketClient.status`).
+ * Kept for backward compatibility — will be removed in v22.
+ */
 interface WebSocketStatus {
     connected: boolean;
     connecting: boolean;
@@ -450,29 +530,70 @@ interface WebSocketStatus {
     error?: string;
     reconnectAttempts: number;
 }
+/**
+ * @deprecated Use `WebSocketClientConfig`. Kept as alias for backward compatibility.
+ */
+type WebSocketConfig = WebSocketClientConfig & {
+    /** @deprecated Use `heartbeatMessage` directly. */
+    heartbeatMessage?: unknown;
+};
+
+/**
+ * Service that creates and tracks `WebSocketClient` instances.
+ *
+ * Preferred usage:
+ * ```ts
+ * const ws = inject(WebSocketService);
+ * const client = ws.createClient({ url: 'wss://...' });
+ * effect(() => console.log(client.status()));
+ * await client.request('ping', {});
+ * ```
+ *
+ * Legacy usage (`connect()` returning Observable) is preserved for one minor cycle
+ * and will be removed in v22.
+ */
 declare class WebSocketService extends BrowserApiBaseService {
-    private webSocket;
-    private statusSubject;
-    private messageSubject;
-    private reconnectAttempts;
-    private reconnectTimer;
-    private heartbeatTimer;
+    private readonly wsLogger;
+    private readonly clients;
+    private readonly _cleanup;
+    /** Legacy single-connection holder used by deprecated `connect()`/`send()` API. */
+    private legacyClient;
     protected getApiName(): string;
-    private ensureWebSocketSupport;
+    protected ensureSupported(): void;
+    /**
+     * Create a new WebSocket client. The client owns one connection and is the recommended
+     * surface for all interactions (status signal, request/response, reconnect, etc.).
+     *
+     * The returned client is automatically disposed when the host injector is destroyed.
+     */
+    createClient(config: WebSocketClientConfig): WebSocketClient;
+    /** Dispose every client created via `createClient()` (also called automatically on destroy). */
+    disposeAll(): void;
+    /**
+     * @deprecated Use {@link createClient} which returns a `WebSocketClient` exposing a
+     * status signal, request/response, and proper reconnect. This wrapper will be removed
+     * in v22.
+     */
     connect(config: WebSocketConfig): Observable<WebSocketStatus>;
+    /** @deprecated Use {@link createClient} and call `client.close()`. */
     disconnect(): void;
+    /** @deprecated Use the client returned by {@link createClient}. */
     send<T>(message: WebSocketMessage<T>): void;
+    /** @deprecated Use the client returned by {@link createClient}. */
     sendRaw(data: string): void;
+    /** @deprecated Use `client.status` from {@link createClient}. */
     getStatus(): Observable<WebSocketStatus>;
+    /** @deprecated Use `client.messages$` from {@link createClient}. */
     getMessages<T = unknown>(): Observable<WebSocketMessage<T>>;
-    private setupWebSocketHandlers;
-    private startHeartbeat;
-    private attemptReconnect;
-    private updateStatus;
-    private getCurrentStatus;
+    /** @deprecated Use `client.messagesByType()` from {@link createClient}. */
+    getMessagesByType<T = unknown>(type: string): Observable<WebSocketMessage<T>>;
+    /** @deprecated Use the client returned by {@link createClient}. */
     getNativeWebSocket(): WebSocket | null;
+    /** @deprecated Use `client.status()` from {@link createClient}. */
     isConnected(): boolean;
+    /** @deprecated Use the native socket via `client.getNativeSocket()`. */
     getReadyState(): number;
+    private warnLegacyOnce;
     static ɵfac: i0.ɵɵFactoryDeclaration<WebSocketService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<WebSocketService>;
 }
@@ -496,13 +617,13 @@ interface WorkerTask<T = unknown> {
     transferable?: Transferable[];
 }
 declare class WebWorkerService extends BrowserApiBaseService {
-    protected destroyRef: DestroyRef;
     private workers;
     private workerStatuses;
     private workerMessages;
     private currentWorkerStatuses;
+    private readonly _cleanup;
     protected getApiName(): string;
-    private ensureWorkerSupport;
+    protected ensureSupported(): void;
     createWorker(name: string, scriptUrl: string): Observable<WorkerStatus>;
     terminateWorker(name: string): void;
     terminateAllWorkers(): void;
@@ -704,7 +825,7 @@ declare class FileSystemAccessService extends BrowserApiBaseService {
     protected getApiName(): string;
     isSupported(): boolean;
     private get win();
-    private ensureSupport;
+    protected ensureSupported(): void;
     openFile(options?: FileOpenOptions): Promise<File[]>;
     saveFile(content: string | Blob, options?: FileSaveOptions): Promise<void>;
     openDirectory(options?: {
@@ -858,54 +979,6 @@ declare class PerformanceObserverService extends BrowserApiBaseService {
     static ɵprov: i0.ɵɵInjectableDeclaration<PerformanceObserverService>;
 }
 
-type UserIdleState = 'active' | 'idle';
-type ScreenIdleState = 'locked' | 'unlocked';
-interface IdleState {
-    user: UserIdleState;
-    screen: ScreenIdleState;
-}
-interface IdleDetectorOptions {
-    threshold?: number;
-}
-declare class IdleDetectorService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    requestPermission(): Promise<PermissionState>;
-    watch(options?: IdleDetectorOptions): Observable<IdleState>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<IdleDetectorService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<IdleDetectorService>;
-}
-
-interface ColorSelectionResult {
-    sRGBHex: string;
-}
-declare class EyeDropperService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    open(signal?: AbortSignal): Promise<ColorSelectionResult>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EyeDropperService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<EyeDropperService>;
-}
-
-type BarcodeFormat = 'aztec' | 'code_128' | 'code_39' | 'code_93' | 'codabar' | 'data_matrix' | 'ean_13' | 'ean_8' | 'itf' | 'pdf417' | 'qr_code' | 'upc_a' | 'upc_e' | 'unknown';
-interface DetectedBarcode {
-    boundingBox: DOMRectReadOnly;
-    cornerPoints: ReadonlyArray<{
-        x: number;
-        y: number;
-    }>;
-    format: BarcodeFormat;
-    rawValue: string;
-}
-declare class BarcodeDetectorService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    getSupportedFormats(): Promise<BarcodeFormat[]>;
-    detect(image: ImageBitmapSource, formats?: BarcodeFormat[]): Promise<DetectedBarcode[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<BarcodeDetectorService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<BarcodeDetectorService>;
-}
-
 type AudioContextState = 'suspended' | 'running' | 'closed';
 interface AudioAnalyserData {
     frequencyData: Uint8Array;
@@ -955,227 +1028,6 @@ declare class GamepadService extends BrowserApiBaseService {
     static ɵprov: i0.ɵɵInjectableDeclaration<GamepadService>;
 }
 
-interface BluetoothRequestDeviceOptions {
-    filters?: Array<{
-        services?: string[];
-        name?: string;
-        namePrefix?: string;
-    }>;
-    optionalServices?: string[];
-    acceptAllDevices?: boolean;
-}
-interface BluetoothRemoteGATTServer {
-    readonly connected: boolean;
-    readonly device: BluetoothDeviceRef;
-    connect(): Promise<BluetoothRemoteGATTServer>;
-    disconnect(): void;
-    getPrimaryService(service: string): Promise<BluetoothRemoteGATTService>;
-}
-interface BluetoothRemoteGATTService {
-    getCharacteristic(characteristic: string): Promise<BluetoothRemoteGATTCharacteristic>;
-}
-interface BluetoothRemoteGATTCharacteristic extends EventTarget {
-    readonly value: DataView | null;
-    readValue(): Promise<DataView>;
-    writeValue(value: BufferSource): Promise<void>;
-    startNotifications(): Promise<BluetoothRemoteGATTCharacteristic>;
-    stopNotifications(): Promise<BluetoothRemoteGATTCharacteristic>;
-}
-interface BluetoothDeviceRef extends EventTarget {
-    readonly id: string;
-    readonly name: string | undefined;
-    readonly gatt: BluetoothRemoteGATTServer | undefined;
-}
-interface UsbDeviceRef {
-    readonly vendorId: number;
-    readonly productId: number;
-    readonly productName: string | undefined;
-    readonly manufacturerName: string | undefined;
-    readonly serialNumber: string | undefined;
-    readonly opened: boolean;
-    open(): Promise<void>;
-    close(): Promise<void>;
-    selectConfiguration(configurationValue: number): Promise<void>;
-    claimInterface(interfaceNumber: number): Promise<void>;
-    releaseInterface(interfaceNumber: number): Promise<void>;
-    transferIn(endpointNumber: number, length: number): Promise<UsbTransferResult>;
-    transferOut(endpointNumber: number, data: BufferSource): Promise<UsbTransferResult>;
-}
-interface UsbTransferResult {
-    readonly data: DataView | undefined;
-    readonly status: 'ok' | 'stall' | 'babble';
-}
-interface UsbDeviceFilterDef {
-    vendorId?: number;
-    productId?: number;
-    classCode?: number;
-    subclassCode?: number;
-    protocolCode?: number;
-    serialNumber?: string;
-}
-interface NdefMessage {
-    records: NdefRecord[];
-}
-interface NdefRecord {
-    recordType: string;
-    mediaType?: string;
-    id?: string;
-    data?: DataView;
-    encoding?: string;
-    lang?: string;
-}
-interface NdefReadingEvent {
-    serialNumber: string;
-    message: NdefMessage;
-}
-interface NdefWriteOptions {
-    overwrite?: boolean;
-    signal?: AbortSignal;
-}
-
-interface BluetoothDeviceInfo {
-    id: string;
-    name: string | undefined;
-    connected: boolean;
-}
-declare class WebBluetoothService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    requestDevice(options?: BluetoothRequestDeviceOptions): Promise<BluetoothDeviceRef>;
-    connect(device: BluetoothDeviceRef): Promise<BluetoothRemoteGATTServer>;
-    disconnect(device: BluetoothDeviceRef): void;
-    watchDisconnection(device: BluetoothDeviceRef): Observable<void>;
-    readCharacteristic(server: BluetoothRemoteGATTServer, serviceUuid: string, characteristicUuid: string): Promise<DataView>;
-    writeCharacteristic(server: BluetoothRemoteGATTServer, serviceUuid: string, characteristicUuid: string, value: BufferSource): Promise<void>;
-    watchCharacteristic(server: BluetoothRemoteGATTServer, serviceUuid: string, characteristicUuid: string): Observable<DataView>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WebBluetoothService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WebBluetoothService>;
-}
-
-interface UsbDeviceInfo {
-    vendorId: number;
-    productId: number;
-    productName: string | undefined;
-    manufacturerName: string | undefined;
-    serialNumber: string | undefined;
-    opened: boolean;
-}
-declare class WebUsbService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    requestDevice(filters?: UsbDeviceFilterDef[]): Promise<UsbDeviceRef>;
-    getDevices(): Promise<UsbDeviceRef[]>;
-    open(device: UsbDeviceRef): Promise<void>;
-    close(device: UsbDeviceRef): Promise<void>;
-    selectConfiguration(device: UsbDeviceRef, configurationValue: number): Promise<void>;
-    claimInterface(device: UsbDeviceRef, interfaceNumber: number): Promise<void>;
-    releaseInterface(device: UsbDeviceRef, interfaceNumber: number): Promise<void>;
-    transferIn(device: UsbDeviceRef, endpointNumber: number, length: number): Promise<UsbTransferResult>;
-    transferOut(device: UsbDeviceRef, endpointNumber: number, data: BufferSource): Promise<UsbTransferResult>;
-    watchConnection(): Observable<{
-        device: UsbDeviceRef;
-        type: 'connect' | 'disconnect';
-    }>;
-    getDeviceInfo(device: UsbDeviceRef): UsbDeviceInfo;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WebUsbService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WebUsbService>;
-}
-
-declare class WebNfcService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    scan(): Observable<NdefReadingEvent>;
-    write(message: NdefMessage | string, options?: NdefWriteOptions): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<WebNfcService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<WebNfcService>;
-}
-
-interface PaymentMethodConfig {
-    supportedMethods: string;
-    data?: Record<string, unknown>;
-}
-interface PaymentDetailsInit {
-    total: {
-        label: string;
-        amount: {
-            currency: string;
-            value: string;
-        };
-    };
-    displayItems?: Array<{
-        label: string;
-        amount: {
-            currency: string;
-            value: string;
-        };
-    }>;
-}
-interface PaymentOptionsConfig {
-    requestPayerName?: boolean;
-    requestPayerEmail?: boolean;
-    requestPayerPhone?: boolean;
-    requestShipping?: boolean;
-}
-interface PaymentResult {
-    methodName: string;
-    details: Record<string, unknown>;
-    payerName: string | null;
-    payerEmail: string | null;
-    payerPhone: string | null;
-}
-declare class PaymentRequestService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    canMakePayment(methods: PaymentMethodConfig[], details: PaymentDetailsInit): Promise<boolean>;
-    show(methods: PaymentMethodConfig[], details: PaymentDetailsInit, options?: PaymentOptionsConfig): Promise<PaymentResult>;
-    abort(methods: PaymentMethodConfig[], details: PaymentDetailsInit): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PaymentRequestService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PaymentRequestService>;
-}
-
-interface PasswordCredentialData {
-    id: string;
-    password: string;
-    name?: string;
-    iconURL?: string;
-}
-interface PublicKeyCredentialOptions {
-    challenge: BufferSource;
-    rp: {
-        name: string;
-        id?: string;
-    };
-    user: {
-        id: BufferSource;
-        name: string;
-        displayName: string;
-    };
-    pubKeyCredParams: Array<{
-        type: 'public-key';
-        alg: number;
-    }>;
-    timeout?: number;
-    attestation?: AttestationConveyancePreference;
-    authenticatorSelection?: AuthenticatorSelectionCriteria;
-}
-interface CredentialResult {
-    id: string;
-    type: string;
-}
-declare class CredentialManagementService extends BrowserApiBaseService {
-    protected getApiName(): string;
-    isSupported(): boolean;
-    isPublicKeySupported(): boolean;
-    get(options?: CredentialRequestOptions): Promise<Credential | null>;
-    store(credential: Credential): Promise<void>;
-    createPasswordCredential(data: PasswordCredentialData): Promise<Credential>;
-    createPublicKeyCredential(options: PublicKeyCredentialOptions): Promise<Credential | null>;
-    preventSilentAccess(): Promise<void>;
-    isConditionalMediationAvailable(): Promise<boolean>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CredentialManagementService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<CredentialManagementService>;
-}
-
 interface MediaDevice {
     deviceId: string;
     groupId: string;
@@ -1322,15 +1174,6 @@ interface PerformanceObserverRef {
 }
 declare function injectPerformanceObserver(config: PerformanceObserverConfig): PerformanceObserverRef;
 
-interface IdleDetectorRef {
-    readonly state: Signal<IdleState>;
-    readonly userState: Signal<UserIdleState>;
-    readonly screenState: Signal<ScreenIdleState>;
-    readonly isUserIdle: Signal<boolean>;
-    readonly isScreenLocked: Signal<boolean>;
-}
-declare function injectIdleDetector(options?: IdleDetectorOptions): IdleDetectorRef;
-
 interface GamepadRef {
     readonly state: Signal<GamepadState | null>;
     readonly connected: Signal<boolean>;
@@ -1367,6 +1210,67 @@ declare class BrowserSupportUtil {
  */
 declare const permissionGuard: (permission: PermissionNameExt) => CanActivateFn;
 
+declare function providePermissions(): EnvironmentProviders;
+
+declare function provideCamera(): EnvironmentProviders;
+
+declare function provideGeolocation(): EnvironmentProviders;
+
+declare function provideNotifications(): EnvironmentProviders;
+
+declare function provideClipboard(): EnvironmentProviders;
+
+declare function provideMediaDevices(): EnvironmentProviders;
+
+declare function provideScreenWakeLock(): EnvironmentProviders;
+
+declare function provideFileSystemAccess(): EnvironmentProviders;
+
+declare function provideMediaRecorder(): EnvironmentProviders;
+
+declare function provideBattery(): EnvironmentProviders;
+
+declare function provideWebShare(): EnvironmentProviders;
+
+declare function provideWebStorage(): EnvironmentProviders;
+
+declare function provideWebSocket(): EnvironmentProviders;
+
+declare function provideWebWorker(): EnvironmentProviders;
+
+declare function provideIntersectionObserver(): EnvironmentProviders;
+
+declare function provideResizeObserver(): EnvironmentProviders;
+
+declare function providePageVisibility(): EnvironmentProviders;
+
+declare function provideBroadcastChannel(): EnvironmentProviders;
+
+declare function provideNetworkInformation(): EnvironmentProviders;
+
+declare function provideScreenOrientation(): EnvironmentProviders;
+
+declare function provideFullscreen(): EnvironmentProviders;
+
+declare function provideServerSentEvents(): EnvironmentProviders;
+
+declare function provideVibration(): EnvironmentProviders;
+
+declare function provideSpeechSynthesis(): EnvironmentProviders;
+
+declare function provideMutationObserver(): EnvironmentProviders;
+
+declare function providePerformanceObserver(): EnvironmentProviders;
+
+declare function provideWebAudio(): EnvironmentProviders;
+
+declare function provideGamepad(): EnvironmentProviders;
+
+declare function provideMediaApis(): EnvironmentProviders;
+declare function provideLocationApis(): EnvironmentProviders;
+declare function provideStorageApis(): EnvironmentProviders;
+declare function provideCommunicationApis(): EnvironmentProviders;
+
 interface BrowserWebApisConfig {
     enableCamera?: boolean;
     enableGeolocation?: boolean;
@@ -1393,61 +1297,13 @@ interface BrowserWebApisConfig {
     enableSpeechSynthesis?: boolean;
     enableMutationObserver?: boolean;
     enablePerformanceObserver?: boolean;
-    enableIdleDetector?: boolean;
-    enableEyeDropper?: boolean;
-    enableBarcodeDetector?: boolean;
     enableWebAudio?: boolean;
     enableGamepad?: boolean;
-    enableWebBluetooth?: boolean;
-    enableWebUsb?: boolean;
-    enableWebNfc?: boolean;
-    enablePaymentRequest?: boolean;
-    enableCredentialManagement?: boolean;
 }
 declare const defaultBrowserWebApisConfig: BrowserWebApisConfig;
 declare function provideBrowserWebApis(config?: BrowserWebApisConfig): EnvironmentProviders;
-declare function provideCamera(): EnvironmentProviders;
-declare function provideGeolocation(): EnvironmentProviders;
-declare function provideNotifications(): EnvironmentProviders;
-declare function provideClipboard(): EnvironmentProviders;
-declare function provideMediaDevices(): EnvironmentProviders;
-declare function provideBattery(): EnvironmentProviders;
-declare function provideWebShare(): EnvironmentProviders;
-declare function provideWebStorage(): EnvironmentProviders;
-declare function provideWebSocket(): EnvironmentProviders;
-declare function provideWebWorker(): EnvironmentProviders;
-declare function providePermissions(): EnvironmentProviders;
-declare function provideMediaApis(): EnvironmentProviders;
-declare function provideLocationApis(): EnvironmentProviders;
-declare function provideStorageApis(): EnvironmentProviders;
-declare function provideCommunicationApis(): EnvironmentProviders;
-declare function provideIntersectionObserver(): EnvironmentProviders;
-declare function provideResizeObserver(): EnvironmentProviders;
-declare function providePageVisibility(): EnvironmentProviders;
-declare function provideBroadcastChannel(): EnvironmentProviders;
-declare function provideNetworkInformation(): EnvironmentProviders;
-declare function provideScreenWakeLock(): EnvironmentProviders;
-declare function provideScreenOrientation(): EnvironmentProviders;
-declare function provideFullscreen(): EnvironmentProviders;
-declare function provideFileSystemAccess(): EnvironmentProviders;
-declare function provideMediaRecorder(): EnvironmentProviders;
-declare function provideServerSentEvents(): EnvironmentProviders;
-declare function provideVibration(): EnvironmentProviders;
-declare function provideSpeechSynthesis(): EnvironmentProviders;
-declare function provideMutationObserver(): EnvironmentProviders;
-declare function providePerformanceObserver(): EnvironmentProviders;
-declare function provideIdleDetector(): EnvironmentProviders;
-declare function provideEyeDropper(): EnvironmentProviders;
-declare function provideBarcodeDetector(): EnvironmentProviders;
-declare function provideWebAudio(): EnvironmentProviders;
-declare function provideGamepad(): EnvironmentProviders;
-declare function provideWebBluetooth(): EnvironmentProviders;
-declare function provideWebUsb(): EnvironmentProviders;
-declare function provideWebNfc(): EnvironmentProviders;
-declare function providePaymentRequest(): EnvironmentProviders;
-declare function provideCredentialManagement(): EnvironmentProviders;
 
 declare const version = "0.1.0";
 
-export { BarcodeDetectorService, BatteryService, BroadcastChannelService, BrowserApiBaseService, BrowserCapabilityService, BrowserSupportUtil, CameraService, ClipboardService, ConnectionRegistryBaseService, CredentialManagementService, EyeDropperService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IdleDetectorService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PaymentRequestService, PerformanceObserverService, PermissionAwareBrowserApiBaseService, PermissionsService, ResizeObserverService, ScreenOrientationService, ScreenWakeLockService, ServerSentEventsService, SpeechSynthesisService, VibrationService, WebAudioService, WebBluetoothService, WebNfcService, WebShareService, WebSocketService, WebStorageService, WebUsbService, WebWorkerService, permissionGuard as createPermissionGuard, defaultBrowserWebApisConfig, injectGamepad, injectIdleDetector, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, permissionGuard, provideBarcodeDetector, provideBattery, provideBroadcastChannel, provideBrowserWebApis, provideCamera, provideClipboard, provideCommunicationApis, provideCredentialManagement, provideEyeDropper, provideFileSystemAccess, provideFullscreen, provideGamepad, provideGeolocation, provideIdleDetector, provideIntersectionObserver, provideLocationApis, provideMediaApis, provideMediaDevices, provideMediaRecorder, provideMutationObserver, provideNetworkInformation, provideNotifications, providePageVisibility, providePaymentRequest, providePerformanceObserver, providePermissions, provideResizeObserver, provideScreenOrientation, provideScreenWakeLock, provideServerSentEvents, provideSpeechSynthesis, provideStorageApis, provideVibration, provideWebAudio, provideWebBluetooth, provideWebNfc, provideWebShare, provideWebSocket, provideWebStorage, provideWebUsb, provideWebWorker, version };
-export type { AudioAnalyserData, AudioContextState, BarcodeFormat, BatteryInfo, BatteryManager, BluetoothDeviceInfo, BluetoothDeviceRef, BluetoothRequestDeviceOptions, BrowserCapabilityId, BrowserError, BrowserPermissions, BrowserWebApisConfig, CameraCapabilities, CameraInfo, ColorSelectionResult, ConnectionType, CredentialResult, DetectedBarcode, EffectiveConnectionType, ElementInput, ElementSize, ErrorCallback, EventHandler, FileOpenOptions, FileSaveOptions, GamepadRef, GamepadState, GeolocationCoordinates, GeolocationError, GeolocationOptions, GeolocationPosition$1 as GeolocationPosition, GeolocationWatchOptions, IdleDetectorOptions, IdleDetectorRef, IdleState, IntersectionObserverOptions, IntersectionRef, MediaDevice, MediaDeviceKind, MediaDevicesInfo, MediaStreamConstraints$1 as MediaStreamConstraints, MediaTrackConstraints$1 as MediaTrackConstraints, MutationObserverOptions, MutationRef, NdefMessage, NdefReadingEvent, NdefWriteOptions, NetworkInformation, NetworkInformationRef, OrientationInfo, OrientationLockType, OrientationType, PageVisibilityRef, PasswordCredentialData, PaymentDetailsInit, PaymentMethodConfig, PaymentOptionsConfig, PaymentResult, PerformanceEntryType, PerformanceObserverConfig, PerformanceObserverRef, PermissionNameExt, PermissionRequest, PublicKeyCredentialOptions, RecordingOptions, RecordingResult, RecordingState, ResizeObserverOptions, ResizeRef, SSEConfig, SSEConnectionState, SSEMessage, ScreenIdleState, ScreenOrientationRef, SpeechOptions, SpeechState, StorageEvent, StorageOptions, StorageValue, UsbDeviceFilterDef, UsbDeviceInfo, UsbDeviceRef, UserIdleState, VibrationPattern, VibrationPreset, VisibilityState, WakeLockStatus, WakeLockType, WebSocketConfig, WebSocketMessage, WebSocketStatus, WorkerMessage, WorkerStatus, WorkerTask };
+export { BROWSER_API_LOGGER, BatteryService, BroadcastChannelService, BrowserApiBaseService, BrowserCapabilityService, BrowserSupportUtil, CameraService, ClipboardService, ConnectionRegistryBaseService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PerformanceObserverService, PermissionsService, ResizeObserverService, ScreenOrientationService, ScreenWakeLockService, ServerSentEventsService, SpeechSynthesisService, VibrationService, WebAudioService, WebShareService, WebSocketClient, WebSocketService, WebStorageService, WebWorkerService, permissionGuard as createPermissionGuard, defaultBrowserWebApisConfig, injectGamepad, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, permissionGuard, provideBattery, provideBroadcastChannel, provideBrowserWebApis, provideCamera, provideClipboard, provideCommunicationApis, provideFileSystemAccess, provideFullscreen, provideGamepad, provideGeolocation, provideIntersectionObserver, provideLocationApis, provideMediaApis, provideMediaDevices, provideMediaRecorder, provideMutationObserver, provideNetworkInformation, provideNotifications, providePageVisibility, providePerformanceObserver, providePermissions, provideResizeObserver, provideScreenOrientation, provideScreenWakeLock, provideServerSentEvents, provideSpeechSynthesis, provideStorageApis, provideVibration, provideWebAudio, provideWebShare, provideWebSocket, provideWebStorage, provideWebWorker, version };
+export type { AudioAnalyserData, AudioContextState, BatteryInfo, BatteryManager, BrowserApiLogger, BrowserCapabilityId, BrowserError, BrowserPermissions, BrowserWebApisConfig, CameraCapabilities, CameraInfo, ConnectionType, EffectiveConnectionType, ElementInput, ElementSize, ErrorCallback, EventHandler, FileOpenOptions, FileSaveOptions, GamepadRef, GamepadState, GeolocationCoordinates, GeolocationError, GeolocationOptions, GeolocationPosition$1 as GeolocationPosition, GeolocationWatchOptions, IntersectionObserverOptions, IntersectionRef, MediaDevice, MediaDeviceKind, MediaDevicesInfo, MediaStreamConstraints$1 as MediaStreamConstraints, MediaTrackConstraints$1 as MediaTrackConstraints, MutationObserverOptions, MutationRef, NetworkInformation, NetworkInformationRef, OrientationInfo, OrientationLockType, OrientationType, PageVisibilityRef, PerformanceEntryType, PerformanceObserverConfig, PerformanceObserverRef, PermissionNameExt, PermissionRequest, RecordingOptions, RecordingResult, RecordingState, ResizeObserverOptions, ResizeRef, SSEConfig, SSEConnectionState, SSEMessage, ScreenOrientationRef, SpeechOptions, SpeechState, StorageEvent, StorageOptions, StorageValue, VibrationPattern, VibrationPreset, VisibilityState, WakeLockStatus, WakeLockType, WebSocketClientConfig, WebSocketConfig, WebSocketMessage, WebSocketRequestOptions, WebSocketState, WebSocketStatus, WebSocketStatusV2, WorkerMessage, WorkerStatus, WorkerTask };