@angular-helpers/browser-web-apis 21.3.0 → 21.5.0

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

@@ -1,67 +1,84 @@
 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
+ * Base class for all Browser Web API services.
  * Provides common functionality for:
- * - Support checking
- * - Permission management
- * - Error handling
+ * - Platform detection (browser vs server)
+ * - Support assertion via Template Method
+ * - Error creation with cause chaining
+ * - Structured logging via injectable BROWSER_API_LOGGER token
  * - Lifecycle management with destroyRef
- * - Logging
+ *
+ * Services that also need permission querying should extend
+ * `PermissionAwareBrowserApiBaseService` instead.
  */
 declare abstract class BrowserApiBaseService {
-    protected permissionsService: PermissionsService;
     protected destroyRef: DestroyRef;
     protected platformId: Object;
+    private readonly logger;
     /**
-     * Abstract method that must be implemented by child services
-     * Returns the API name for support checking
+     * Abstract method that must be implemented by child services.
+     * Returns the API name used in log messages and error strings.
      */
     protected abstract getApiName(): string;
     /**
-     * Check if running in browser environment using Angular's platform detection
+     * Check if running in browser environment using Angular's platform detection.
      */
     protected isBrowserEnvironment(): boolean;
     /**
-     * Check if running in server environment using Angular's platform detection
+     * Check if running in server environment using Angular's platform detection.
      */
     protected isServerEnvironment(): boolean;
     /**
-     * Request a permission
+     * Template Method: asserts the service can run in the current environment.
+     * Subclasses must call super.ensureSupported() and then add their own API check.
      */
-    protected requestPermission(permission: PermissionNameExt): Promise<boolean>;
+    protected ensureSupported(): void;
     /**
-     * Create an error with proper cause chaining
+     * Create an error with proper cause chaining.
      */
     protected createError(message: string, cause?: unknown): Error;
+    /**
+     * Log an error through the injected BROWSER_API_LOGGER (default: console).
+     */
+    protected logError(message: string, error?: unknown): void;
+    /**
+     * 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>;
 }
 
+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 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>;
@@ -76,7 +93,7 @@ declare class CameraService extends BrowserApiBaseService {
 
 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;
@@ -91,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>;
@@ -108,8 +125,8 @@ 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>;
@@ -118,10 +135,9 @@ declare class NotificationService extends BrowserApiBaseService {
 
 declare class ClipboardService extends BrowserApiBaseService {
     protected getApiName(): string;
-    private ensureClipboardPermission;
+    protected ensureSupported(): void;
     writeText(text: string): Promise<void>;
     readText(): Promise<string>;
-    writeTextSecure(text: string): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ClipboardService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ClipboardService>;
 }
@@ -280,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;
@@ -320,11 +336,10 @@ 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>;
-    private setupEventListeners;
     getNativeBatteryManager(): BatteryManager;
     isCharging(): boolean;
     getLevel(): number;
@@ -340,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;
@@ -368,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;
@@ -429,19 +444,20 @@ declare class WebSocketService extends BrowserApiBaseService {
     private reconnectAttempts;
     private reconnectTimer;
     private heartbeatTimer;
+    private readonly _cleanup;
     protected getApiName(): string;
-    private ensureWebSocketSupport;
+    protected ensureSupported(): void;
     connect(config: WebSocketConfig): Observable<WebSocketStatus>;
     disconnect(): void;
     send<T>(message: WebSocketMessage<T>): void;
     sendRaw(data: string): void;
     getStatus(): Observable<WebSocketStatus>;
     getMessages<T = unknown>(): Observable<WebSocketMessage<T>>;
+    getMessagesByType<T = unknown>(type: string): Observable<WebSocketMessage<T>>;
     private setupWebSocketHandlers;
     private startHeartbeat;
     private attemptReconnect;
     private updateStatus;
-    private getCurrentStatus;
     getNativeWebSocket(): WebSocket | null;
     isConnected(): boolean;
     getReadyState(): number;
@@ -468,13 +484,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;
@@ -497,8 +513,8 @@ interface IntersectionObserverOptions {
     rootMargin?: string;
     threshold?: number | number[];
 }
-declare class IntersectionObserverService {
-    private readonly platformId;
+declare class IntersectionObserverService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     observe(element: Element, options?: IntersectionObserverOptions): Observable<IntersectionObserverEntry[]>;
     observeVisibility(element: Element, options?: IntersectionObserverOptions): Observable<boolean>;
@@ -515,8 +531,8 @@ interface ElementSize {
     inlineSize: number;
     blockSize: number;
 }
-declare class ResizeObserverService {
-    private readonly platformId;
+declare class ResizeObserverService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     observe(element: Element, options?: ResizeObserverOptions): Observable<ResizeObserverEntry[]>;
     observeSize(element: Element, options?: ResizeObserverOptions): Observable<ElementSize>;
@@ -525,8 +541,8 @@ declare class ResizeObserverService {
 }
 
 type VisibilityState = 'visible' | 'hidden' | 'prerender';
-declare class PageVisibilityService {
-    private readonly platformId;
+declare class PageVisibilityService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     get isHidden(): boolean;
     get visibilityState(): VisibilityState;
@@ -536,12 +552,46 @@ declare class PageVisibilityService {
     static ɵprov: i0.ɵɵInjectableDeclaration<PageVisibilityService>;
 }
 
-declare class BroadcastChannelService {
-    private readonly destroyRef;
-    private readonly platformId;
-    private channels;
+/**
+ * Base class for services that manage a named registry of persistent
+ * connections (e.g. BroadcastChannel, EventSource, WebSocket pools).
+ *
+ * Implements the Template Method pattern: subclasses define how a single
+ * native connection is closed via `closeNativeConnection()`, while this
+ * class handles the Map lifecycle (remove, closeAll, getActiveKeys).
+ *
+ * Public-facing method names (`close`, `disconnect`, `getOpenChannels`, etc.)
+ * remain the responsibility of the concrete service to preserve the public API.
+ */
+declare abstract class ConnectionRegistryBaseService<T> extends BrowserApiBaseService {
+    protected readonly connections: Map<string, T>;
+    /**
+     * Template Method: close a single native connection.
+     * Implemented by each concrete service.
+     */
+    protected abstract closeNativeConnection(connection: T): void;
+    /**
+     * Remove and close the connection registered under `key`.
+     * Safe to call even if the key does not exist.
+     */
+    protected removeConnection(key: string): void;
+    /**
+     * Close all registered connections and clear the registry.
+     */
+    protected closeAllConnections(): void;
+    /**
+     * Return the keys of all currently open connections.
+     */
+    protected getConnectionKeys(): string[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConnectionRegistryBaseService<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ConnectionRegistryBaseService<any>>;
+}
+
+declare class BroadcastChannelService extends ConnectionRegistryBaseService<BroadcastChannel> {
+    protected getApiName(): string;
+    protected closeNativeConnection(channel: BroadcastChannel): void;
     isSupported(): boolean;
-    private ensureSupport;
+    private ensureBroadcastChannelSupported;
     open<T = unknown>(name: string): Observable<T>;
     post<T = unknown>(name: string, data: T): void;
     close(name: string): void;
@@ -562,8 +612,8 @@ interface NetworkInformation {
     saveData?: boolean;
     online: boolean;
 }
-declare class NetworkInformationService {
-    private readonly platformId;
+declare class NetworkInformationService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     getSnapshot(): NetworkInformation;
     watch(): Observable<NetworkInformation>;
@@ -596,8 +646,8 @@ interface OrientationInfo {
     type: OrientationType;
     angle: number;
 }
-declare class ScreenOrientationService {
-    private readonly platformId;
+declare class ScreenOrientationService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     getSnapshot(): OrientationInfo;
     get isPortrait(): boolean;
@@ -609,9 +659,8 @@ declare class ScreenOrientationService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ScreenOrientationService>;
 }
 
-declare class FullscreenService {
-    private readonly destroyRef;
-    private readonly platformId;
+declare class FullscreenService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     get isFullscreen(): boolean;
     get fullscreenElement(): Element | null;
@@ -643,7 +692,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?: {
@@ -703,12 +752,11 @@ interface SSEConfig {
     withCredentials?: boolean;
     eventTypes?: string[];
 }
-declare class ServerSentEventsService {
-    private readonly destroyRef;
-    private readonly platformId;
-    private sources;
+declare class ServerSentEventsService extends ConnectionRegistryBaseService<EventSource> {
+    protected getApiName(): string;
+    protected closeNativeConnection(source: EventSource): void;
     isSupported(): boolean;
-    private ensureSupport;
+    private ensureSSESupported;
     connect<T = unknown>(url: string, config?: SSEConfig): Observable<SSEMessage<T>>;
     disconnect(url: string): void;
     disconnectAll(): void;
@@ -725,8 +773,8 @@ interface VibrationPreset {
     notification: VibrationPattern;
     doubleTap: VibrationPattern;
 }
-declare class VibrationService {
-    private readonly platformId;
+declare class VibrationService extends BrowserApiBaseService {
+    protected getApiName(): string;
     readonly presets: VibrationPreset;
     isSupported(): boolean;
     vibrate(pattern?: VibrationPattern): boolean;
@@ -747,11 +795,10 @@ interface SpeechOptions {
     rate?: number;
     pitch?: number;
 }
-declare class SpeechSynthesisService {
-    private readonly destroyRef;
-    private readonly platformId;
+declare class SpeechSynthesisService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
-    private ensureSupport;
+    private ensureSpeechSynthesisSupported;
     get state(): SpeechState;
     get isPending(): boolean;
     getVoices(): SpeechSynthesisVoice[];
@@ -774,8 +821,8 @@ interface MutationObserverOptions {
     attributeFilter?: string[];
 }
 
-declare class MutationObserverService {
-    private readonly platformId;
+declare class MutationObserverService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     observe(target: Node, options?: MutationObserverOptions): Observable<MutationRecord[]>;
     static ɵfac: i0.ɵɵFactoryDeclaration<MutationObserverService, never>;
@@ -789,8 +836,8 @@ interface PerformanceObserverConfig {
     buffered?: boolean;
 }
 
-declare class PerformanceObserverService {
-    private readonly platformId;
+declare class PerformanceObserverService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     observe(config: PerformanceObserverConfig): Observable<PerformanceEntryList>;
     observeByType(type: PerformanceEntryType, buffered?: boolean): Observable<PerformanceEntryList>;
@@ -808,8 +855,8 @@ interface IdleState {
 interface IdleDetectorOptions {
     threshold?: number;
 }
-declare class IdleDetectorService {
-    private readonly platformId;
+declare class IdleDetectorService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     requestPermission(): Promise<PermissionState>;
     watch(options?: IdleDetectorOptions): Observable<IdleState>;
@@ -820,8 +867,8 @@ declare class IdleDetectorService {
 interface ColorSelectionResult {
     sRGBHex: string;
 }
-declare class EyeDropperService {
-    private readonly platformId;
+declare class EyeDropperService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     open(signal?: AbortSignal): Promise<ColorSelectionResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<EyeDropperService, never>;
@@ -838,8 +885,8 @@ interface DetectedBarcode {
     format: BarcodeFormat;
     rawValue: string;
 }
-declare class BarcodeDetectorService {
-    private readonly platformId;
+declare class BarcodeDetectorService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     getSupportedFormats(): Promise<BarcodeFormat[]>;
     detect(image: ImageBitmapSource, formats?: BarcodeFormat[]): Promise<DetectedBarcode[]>;
@@ -852,9 +899,8 @@ interface AudioAnalyserData {
     frequencyData: Uint8Array;
     timeDomainData: Uint8Array;
 }
-declare class WebAudioService {
-    private readonly platformId;
-    private readonly destroyRef;
+declare class WebAudioService extends BrowserApiBaseService {
+    protected getApiName(): string;
     private context;
     isSupported(): boolean;
     getContext(): AudioContext;
@@ -883,8 +929,8 @@ interface GamepadState {
     timestamp: number;
 }
 
-declare class GamepadService {
-    private readonly platformId;
+declare class GamepadService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     getSnapshot(index: number): GamepadState | null;
     getConnectedGamepads(): GamepadState[];
@@ -980,8 +1026,8 @@ interface BluetoothDeviceInfo {
     name: string | undefined;
     connected: boolean;
 }
-declare class WebBluetoothService {
-    private readonly platformId;
+declare class WebBluetoothService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     requestDevice(options?: BluetoothRequestDeviceOptions): Promise<BluetoothDeviceRef>;
     connect(device: BluetoothDeviceRef): Promise<BluetoothRemoteGATTServer>;
@@ -1002,8 +1048,8 @@ interface UsbDeviceInfo {
     serialNumber: string | undefined;
     opened: boolean;
 }
-declare class WebUsbService {
-    private readonly platformId;
+declare class WebUsbService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     requestDevice(filters?: UsbDeviceFilterDef[]): Promise<UsbDeviceRef>;
     getDevices(): Promise<UsbDeviceRef[]>;
@@ -1023,8 +1069,8 @@ declare class WebUsbService {
     static ɵprov: i0.ɵɵInjectableDeclaration<WebUsbService>;
 }
 
-declare class WebNfcService {
-    private readonly platformId;
+declare class WebNfcService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     scan(): Observable<NdefReadingEvent>;
     write(message: NdefMessage | string, options?: NdefWriteOptions): Promise<void>;
@@ -1065,8 +1111,8 @@ interface PaymentResult {
     payerEmail: string | null;
     payerPhone: string | null;
 }
-declare class PaymentRequestService {
-    private readonly platformId;
+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>;
@@ -1104,8 +1150,8 @@ interface CredentialResult {
     id: string;
     type: string;
 }
-declare class CredentialManagementService {
-    private readonly platformId;
+declare class CredentialManagementService extends BrowserApiBaseService {
+    protected getApiName(): string;
     isSupported(): boolean;
     isPublicKeySupported(): boolean;
     get(options?: CredentialRequestOptions): Promise<Credential | null>;
@@ -1118,6 +1164,13 @@ declare class CredentialManagementService {
     static ɵprov: i0.ɵɵInjectableDeclaration<CredentialManagementService>;
 }
 
+interface BrowserApiLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string, error?: unknown): void;
+}
+declare const BROWSER_API_LOGGER: InjectionToken<BrowserApiLogger>;
+
 interface MediaDevice {
     deviceId: string;
     groupId: string;
@@ -1309,6 +1362,83 @@ 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 provideIdleDetector(): 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 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 function provideMediaApis(): EnvironmentProviders;
+declare function provideLocationApis(): EnvironmentProviders;
+declare function provideStorageApis(): EnvironmentProviders;
+declare function provideCommunicationApis(): EnvironmentProviders;
+
 interface BrowserWebApisConfig {
     enableCamera?: boolean;
     enableGeolocation?: boolean;
@@ -1348,48 +1478,8 @@ interface BrowserWebApisConfig {
 }
 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, CredentialManagementService, EyeDropperService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IdleDetectorService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PaymentRequestService, PerformanceObserverService, 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, 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, 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, BrowserApiLogger, 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 };