@angular-helpers/browser-web-apis 21.9.0 → 21.11.0

package/fesm2022/angular-helpers-browser-web-apis.mjs

@@ -1,22 +1,66 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Injectable, inject, DestroyRef, PLATFORM_ID, signal, computed, isSignal, effect, ElementRef, makeEnvironmentProviders } from '@angular/core';
+import { InjectionToken, isDevMode, inject, Injectable, DestroyRef, PLATFORM_ID, signal, computed, isSignal, effect, ElementRef, makeEnvironmentProviders } from '@angular/core';
 import { isPlatformBrowser, isPlatformServer } from '@angular/common';
 import { Observable, fromEvent, Subject, of, map as map$1 } from 'rxjs';
 import { toObservable, takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { filter, map, distinctUntilChanged } from 'rxjs/operators';
 import { Router } from '@angular/router';
 
+const LEVEL_RANK = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 100,
+};
+/**
+ * Global log level for `BROWSER_API_LOGGER`. Defaults to `'debug'` in dev mode and
+ * `'warn'` in production. Override via `provideBrowserApiLogLevel('silent')` etc.
+ */
+const BROWSER_API_LOG_LEVEL = new InjectionToken('BROWSER_API_LOG_LEVEL', {
+    providedIn: 'root',
+    factory: () => (isDevMode() ? 'debug' : 'warn'),
+});
 const BROWSER_API_LOGGER = new InjectionToken('BROWSER_API_LOGGER', {
     providedIn: 'root',
-    factory: () => ({
-        // oxlint-disable-next-line no-console
-        info: (message) => console.info(message),
-        // oxlint-disable-next-line no-console
-        warn: (message) => console.warn(message),
-        // oxlint-disable-next-line no-console
-        error: (message, error) => console.error(message, error),
-    }),
+    factory: () => {
+        const level = inject(BROWSER_API_LOG_LEVEL);
+        return createLevelGatedLogger(level);
+    },
 });
+function createLevelGatedLogger(level) {
+    const min = LEVEL_RANK[level];
+    return {
+        debug: (message) => {
+            if (LEVEL_RANK.debug < min)
+                return;
+            // oxlint-disable-next-line no-console
+            console.debug(message);
+        },
+        info: (message) => {
+            if (LEVEL_RANK.info < min)
+                return;
+            // oxlint-disable-next-line no-console
+            console.info(message);
+        },
+        warn: (message) => {
+            if (LEVEL_RANK.warn < min)
+                return;
+            // oxlint-disable-next-line no-console
+            console.warn(message);
+        },
+        error: (message, error) => {
+            if (LEVEL_RANK.error < min)
+                return;
+            // oxlint-disable-next-line no-console
+            console.error(message, error);
+        },
+    };
+}
+/** Log level helper provider. Overrides the default `BROWSER_API_LOG_LEVEL`. */
+function provideBrowserApiLogLevel(level) {
+    return { provide: BROWSER_API_LOG_LEVEL, useValue: level };
+}
 
 const BROWSER_CAPABILITIES = [
     { id: 'permissions', label: 'Permissions API', requiresSecureContext: false },
@@ -56,6 +100,9 @@ const BROWSER_CAPABILITIES = [
     { id: 'webNfc', label: 'Web NFC API', requiresSecureContext: true },
     { id: 'paymentRequest', label: 'Payment Request API', requiresSecureContext: true },
     { id: 'credentialManagement', label: 'Credential Management API', requiresSecureContext: true },
+    { id: 'webLocks', label: 'Web Locks API', requiresSecureContext: true },
+    { id: 'storageManager', label: 'Storage Manager API', requiresSecureContext: true },
+    { id: 'compressionStreams', label: 'Compression Streams API', requiresSecureContext: false },
 ];
 class BrowserCapabilityService {
     getCapabilities() {
@@ -140,6 +187,14 @@ class BrowserCapabilityService {
                 return typeof window !== 'undefined' && 'PaymentRequest' in window;
             case 'credentialManagement':
                 return typeof navigator !== 'undefined' && 'credentials' in navigator;
+            case 'webLocks':
+                return typeof navigator !== 'undefined' && 'locks' in navigator;
+            case 'storageManager':
+                return (typeof navigator !== 'undefined' &&
+                    'storage' in navigator &&
+                    typeof navigator.storage.estimate === 'function');
+            case 'compressionStreams':
+                return (typeof CompressionStream !== 'undefined' && typeof DecompressionStream !== 'undefined');
             default:
                 return false;
         }
@@ -256,6 +311,9 @@ class BrowserApiBaseService {
     logInfo(message) {
         this.logger.info(`[${this.getApiName()}] ${message}`);
     }
+    logDebug(message) {
+        this.logger.debug?.(`[${this.getApiName()}] ${message}`);
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: BrowserApiBaseService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: BrowserApiBaseService });
 }
@@ -3087,6 +3145,222 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
             type: Injectable
         }] });
 
+/**
+ * Service wrapping `navigator.locks` (Web Locks API). Coordinates exclusive or
+ * shared access to a named resource across tabs and workers.
+ *
+ * ```ts
+ * const locks = inject(WebLocksService);
+ * await locks.acquire('user-cache', async () => {
+ *   // critical section — no other tab is in this block at the same time
+ * });
+ * ```
+ */
+class WebLocksService extends BrowserApiBaseService {
+    getApiName() {
+        return 'web-locks';
+    }
+    isSupported() {
+        if (!this.isBrowserEnvironment())
+            return false;
+        return !!navigator.locks;
+    }
+    /**
+     * Acquire a lock and run the callback while holding it. The lock is released
+     * automatically when the callback resolves or rejects.
+     */
+    acquire(name, callback, options = {}) {
+        this.ensureSupported();
+        const nav = navigator;
+        if (Object.keys(options).length === 0) {
+            return nav.locks.request(name, () => callback());
+        }
+        return nav.locks.request(name, options, () => callback());
+    }
+    /**
+     * Query the current lock state. Useful for diagnostics and tests; do not gate
+     * critical-section logic on this — it's a snapshot, not a reservation.
+     */
+    query() {
+        this.ensureSupported();
+        return navigator.locks.query();
+    }
+    ensureSupported() {
+        super.ensureSupported();
+        if (!this.isSupported()) {
+            throw new Error('Web Locks API not supported in this browser');
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebLocksService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebLocksService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebLocksService, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * Service wrapping `navigator.storage` (StorageManager API). Exposes:
+ * - `estimate()`: how much origin storage is in use vs available
+ * - `persist()`: ask the browser to make storage persistent (eviction-protected)
+ * - `persisted()`: check whether storage is currently persistent
+ */
+class StorageManagerService extends BrowserApiBaseService {
+    getApiName() {
+        return 'storage-manager';
+    }
+    isSupported() {
+        if (!this.isBrowserEnvironment())
+            return false;
+        const sm = navigator.storage;
+        return !!sm && typeof sm.estimate === 'function';
+    }
+    async estimate() {
+        this.ensureSupported();
+        const sm = navigator.storage;
+        const result = await sm.estimate();
+        return {
+            usage: result.usage ?? 0,
+            quota: result.quota ?? 0,
+            usageDetails: result
+                .usageDetails,
+        };
+    }
+    async persist() {
+        this.ensureSupported();
+        const sm = navigator.storage;
+        if (typeof sm.persist !== 'function')
+            return false;
+        return sm.persist();
+    }
+    async persisted() {
+        this.ensureSupported();
+        const sm = navigator.storage;
+        if (typeof sm.persisted !== 'function')
+            return false;
+        return sm.persisted();
+    }
+    ensureSupported() {
+        super.ensureSupported();
+        if (!this.isSupported()) {
+            throw new Error('StorageManager API not supported in this browser');
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: StorageManagerService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: StorageManagerService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: StorageManagerService, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * Service wrapping `CompressionStream` and `DecompressionStream`.
+ *
+ * ```ts
+ * const cmp = inject(CompressionService);
+ * const compressed = await cmp.compress(jsonBytes, 'gzip');
+ * const original = await cmp.decompress(compressed, 'gzip');
+ * ```
+ */
+class CompressionService extends BrowserApiBaseService {
+    getApiName() {
+        return 'compression-streams';
+    }
+    isSupported() {
+        if (!this.isBrowserEnvironment())
+            return false;
+        const g = globalThis;
+        return typeof g.CompressionStream === 'function' && typeof g.DecompressionStream === 'function';
+    }
+    /** Compress a `Uint8Array`/`ArrayBuffer` using the given format. */
+    async compress(data, format = 'gzip') {
+        this.ensureSupported();
+        const g = globalThis;
+        const stream = new g.CompressionStream(format);
+        return this.runStream(data, stream);
+    }
+    /** Decompress a `Uint8Array`/`ArrayBuffer` using the given format. */
+    async decompress(data, format = 'gzip') {
+        this.ensureSupported();
+        const g = globalThis;
+        const stream = new g.DecompressionStream(format);
+        return this.runStream(data, stream);
+    }
+    /** Convenience: compress a UTF-8 string and return the compressed bytes. */
+    async compressString(value, format = 'gzip') {
+        return this.compress(new TextEncoder().encode(value), format);
+    }
+    /** Convenience: decompress bytes into a UTF-8 string. */
+    async decompressString(data, format = 'gzip') {
+        const bytes = await this.decompress(data, format);
+        return new TextDecoder().decode(bytes);
+    }
+    ensureSupported() {
+        super.ensureSupported();
+        if (!this.isSupported()) {
+            throw new Error('Compression Streams API not supported in this browser');
+        }
+    }
+    async runStream(data, stream) {
+        const writer = stream.writable.getWriter();
+        const writePromise = writer.write(data instanceof Uint8Array ? data : new Uint8Array(data));
+        const closePromise = writer.close();
+        const reader = stream.readable.getReader();
+        const chunks = [];
+        let total = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = value;
+            chunks.push(chunk);
+            total += chunk.byteLength;
+        }
+        await writePromise;
+        await closePromise;
+        const result = new Uint8Array(total);
+        let offset = 0;
+        for (const chunk of chunks) {
+            result.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return result;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: CompressionService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: CompressionService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: CompressionService, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * When set to `true`, suppresses the one-time runtime warning that experimental
+ * services emit on first use. Default is `false` (warnings emitted).
+ */
+const BROWSER_API_EXPERIMENTAL_SILENT = new InjectionToken('BROWSER_API_EXPERIMENTAL_SILENT', {
+    providedIn: 'root',
+    factory: () => false,
+});
+const warned = new Set();
+/**
+ * Emit a one-time runtime warning explaining that the API is experimental and
+ * subject to breaking changes. No-op after the first call for a given key, or if
+ * the consumer has provided `BROWSER_API_EXPERIMENTAL_SILENT` as `true`.
+ */
+function warnExperimental(key, context) {
+    if (context.silent)
+        return;
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    context.logger.warn(`[browser-web-apis:experimental] "${key}" is part of the experimental surface ` +
+        'and may change without a major bump. Provide BROWSER_API_EXPERIMENTAL_SILENT=true ' +
+        'to suppress this warning.');
+}
+/** Test-only: reset the in-memory dedup set. */
+function resetExperimentalWarnings() {
+    warned.clear();
+}
+
 // Common types for browser APIs
 
 function injectPageVisibility() {
@@ -3743,6 +4017,18 @@ function provideGamepad() {
     return makeEnvironmentProviders([GamepadService]);
 }
 
+function provideWebLocks() {
+    return makeEnvironmentProviders([WebLocksService]);
+}
+
+function provideStorageManager() {
+    return makeEnvironmentProviders([StorageManagerService]);
+}
+
+function provideCompression() {
+    return makeEnvironmentProviders([CompressionService]);
+}
+
 function provideMediaApis() {
     return makeEnvironmentProviders([PermissionsService, CameraService, MediaDevicesService]);
 }
@@ -3790,9 +4076,33 @@ const defaultBrowserWebApisConfig = {
     enableWebAudio: false,
     enableGamepad: false,
 };
+let legacyFlagsDeprecationLogged = false;
 function provideBrowserWebApis(config = {}) {
-    const mergedConfig = { ...defaultBrowserWebApisConfig, ...config };
+    const { services, ...flagConfig } = config;
+    // Composition-first path: only `services` provided, no flags.
+    if (services && Object.keys(flagConfig).length === 0) {
+        return makeEnvironmentProviders([
+            PermissionsService,
+            ...services.flatMap((env) => env.ɵproviders ?? []),
+        ]);
+    }
+    // Legacy flag-bag path. Log deprecation once if any enableX is set.
+    if (Object.keys(flagConfig).length > 0 && !legacyFlagsDeprecationLogged) {
+        legacyFlagsDeprecationLogged = true;
+        // oxlint-disable-next-line no-console
+        console.warn('[browser-web-apis] provideBrowserWebApis(enableX flags) is deprecated. ' +
+            'Pass `{ services: [provideCamera(), ...] }` instead. The flag-bag form will be ' +
+            'removed in v22.');
+    }
+    const mergedConfig = { ...defaultBrowserWebApisConfig, ...flagConfig };
     const providers = [PermissionsService];
+    if (services) {
+        for (const env of services) {
+            const inner = env.ɵproviders;
+            if (inner)
+                providers.push(...inner);
+        }
+    }
     const conditionalProviders = [
         [mergedConfig.enableCamera, CameraService],
         [mergedConfig.enableGeolocation, GeolocationService],
@@ -3838,4 +4148,4 @@ const version = '0.1.0';
  * Generated bundle index. Do not edit.
  */
 
-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, injectBattery, injectClipboard, injectGamepad, injectGeolocation, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, injectWakeLock, 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 { BROWSER_API_EXPERIMENTAL_SILENT, BROWSER_API_LOGGER, BROWSER_API_LOG_LEVEL, BatteryService, BroadcastChannelService, BrowserApiBaseService, BrowserCapabilityService, BrowserSupportUtil, CameraService, ClipboardService, CompressionService, ConnectionRegistryBaseService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PerformanceObserverService, PermissionsService, ResizeObserverService, ScreenOrientationService, ScreenWakeLockService, ServerSentEventsService, SpeechSynthesisService, StorageManagerService, VibrationService, WebAudioService, WebLocksService, WebShareService, WebSocketClient, WebSocketService, WebStorageService, WebWorkerService, permissionGuard as createPermissionGuard, defaultBrowserWebApisConfig, injectBattery, injectClipboard, injectGamepad, injectGeolocation, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, injectWakeLock, permissionGuard, provideBattery, provideBroadcastChannel, provideBrowserApiLogLevel, provideBrowserWebApis, provideCamera, provideClipboard, provideCommunicationApis, provideCompression, provideFileSystemAccess, provideFullscreen, provideGamepad, provideGeolocation, provideIntersectionObserver, provideLocationApis, provideMediaApis, provideMediaDevices, provideMediaRecorder, provideMutationObserver, provideNetworkInformation, provideNotifications, providePageVisibility, providePerformanceObserver, providePermissions, provideResizeObserver, provideScreenOrientation, provideScreenWakeLock, provideServerSentEvents, provideSpeechSynthesis, provideStorageApis, provideStorageManager, provideVibration, provideWebAudio, provideWebLocks, provideWebShare, provideWebSocket, provideWebStorage, provideWebWorker, version, warnExperimental };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-helpers/browser-web-apis",
-  "version": "21.9.0",
+  "version": "21.11.0",
   "description": "Sistema de servicios Angular para acceso formalizado a Browser Web APIs (cámara, permisos, geolocalización, etc.)",
   "homepage": "https://gaspar1992.github.io/angular-helpers/docs/browser-web-apis",
   "repository": {

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

@@ -3,7 +3,7 @@ import * as i0 from '@angular/core';
 import { DestroyRef, ElementRef, Signal, InjectionToken, EnvironmentProviders } from '@angular/core';
 import { CanActivateFn } from '@angular/router';
 
-type BrowserCapabilityId = 'permissions' | 'geolocation' | 'clipboard' | 'notification' | 'mediaDevices' | 'camera' | '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';
+type BrowserCapabilityId = 'permissions' | 'geolocation' | 'clipboard' | 'notification' | 'mediaDevices' | 'camera' | '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' | 'webLocks' | 'storageManager' | 'compressionStreams';
 declare class BrowserCapabilityService {
     getCapabilities(): readonly [{
         readonly id: "permissions";
@@ -153,12 +153,24 @@ declare class BrowserCapabilityService {
         readonly id: "credentialManagement";
         readonly label: "Credential Management API";
         readonly requiresSecureContext: true;
+    }, {
+        readonly id: "webLocks";
+        readonly label: "Web Locks API";
+        readonly requiresSecureContext: true;
+    }, {
+        readonly id: "storageManager";
+        readonly label: "Storage Manager API";
+        readonly requiresSecureContext: true;
+    }, {
+        readonly id: "compressionStreams";
+        readonly label: "Compression Streams API";
+        readonly requiresSecureContext: false;
     }];
     isSecureContext(): boolean;
     isSupported(capability: BrowserCapabilityId): boolean;
     getAllStatuses(): {
-        id: "permissions" | "geolocation" | "clipboard" | "notification" | "mediaDevices" | "camera" | "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";
+        id: "permissions" | "geolocation" | "clipboard" | "notification" | "mediaDevices" | "camera" | "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" | "webLocks" | "storageManager" | "compressionStreams";
+        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" | "Web Locks API" | "Storage Manager API" | "Compression Streams API";
         supported: boolean;
         secureContext: boolean;
         requiresSecureContext: boolean;
@@ -218,6 +230,7 @@ declare abstract class BrowserApiBaseService {
     protected logError(message: string, error?: unknown): void;
     protected logWarn(message: string): void;
     protected logInfo(message: string): void;
+    protected logDebug(message: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BrowserApiBaseService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<BrowserApiBaseService>;
 }
@@ -380,12 +393,24 @@ type ErrorCallback = (error: BrowserError) => void;
  */
 type ElementInput = Element | ElementRef<Element> | Signal<Element | ElementRef<Element> | undefined>;
 
+type BrowserApiLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
 interface BrowserApiLogger {
+    debug?(message: string): void;
     info(message: string): void;
     warn(message: string): void;
     error(message: string, error?: unknown): void;
 }
+/**
+ * Global log level for `BROWSER_API_LOGGER`. Defaults to `'debug'` in dev mode and
+ * `'warn'` in production. Override via `provideBrowserApiLogLevel('silent')` etc.
+ */
+declare const BROWSER_API_LOG_LEVEL: InjectionToken<BrowserApiLogLevel>;
 declare const BROWSER_API_LOGGER: InjectionToken<BrowserApiLogger>;
+/** Log level helper provider. Overrides the default `BROWSER_API_LOG_LEVEL`. */
+declare function provideBrowserApiLogLevel(level: BrowserApiLogLevel): {
+    provide: InjectionToken<BrowserApiLogLevel>;
+    useValue: BrowserApiLogLevel;
+};
 
 interface StorageOptions {
     /** Optional prefix used to namespace keys (e.g. `app:` -> `app:userId`). */
@@ -1134,6 +1159,120 @@ declare class GamepadService extends BrowserApiBaseService {
     static ɵprov: i0.ɵɵInjectableDeclaration<GamepadService>;
 }
 
+interface LockOptionsLike {
+    mode?: 'exclusive' | 'shared';
+    ifAvailable?: boolean;
+    steal?: boolean;
+    signal?: AbortSignal;
+}
+interface LockInfoLike {
+    name: string;
+    mode: 'exclusive' | 'shared';
+    clientId: string;
+}
+interface LockManagerSnapshot {
+    held: LockInfoLike[];
+    pending: LockInfoLike[];
+}
+/**
+ * Service wrapping `navigator.locks` (Web Locks API). Coordinates exclusive or
+ * shared access to a named resource across tabs and workers.
+ *
+ * ```ts
+ * const locks = inject(WebLocksService);
+ * await locks.acquire('user-cache', async () => {
+ *   // critical section — no other tab is in this block at the same time
+ * });
+ * ```
+ */
+declare class WebLocksService extends BrowserApiBaseService {
+    protected getApiName(): string;
+    isSupported(): boolean;
+    /**
+     * Acquire a lock and run the callback while holding it. The lock is released
+     * automatically when the callback resolves or rejects.
+     */
+    acquire<T>(name: string, callback: () => Promise<T> | T, options?: LockOptionsLike): Promise<T>;
+    /**
+     * Query the current lock state. Useful for diagnostics and tests; do not gate
+     * critical-section logic on this — it's a snapshot, not a reservation.
+     */
+    query(): Promise<LockManagerSnapshot>;
+    protected ensureSupported(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WebLocksService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WebLocksService>;
+}
+
+interface StorageQuotaEstimate {
+    /** Bytes currently used by the origin (best-effort). */
+    usage: number;
+    /** Maximum bytes the origin may use (best-effort). */
+    quota: number;
+    /** Per-storage-type breakdown, when the browser provides it. */
+    usageDetails?: Record<string, number>;
+}
+/**
+ * Service wrapping `navigator.storage` (StorageManager API). Exposes:
+ * - `estimate()`: how much origin storage is in use vs available
+ * - `persist()`: ask the browser to make storage persistent (eviction-protected)
+ * - `persisted()`: check whether storage is currently persistent
+ */
+declare class StorageManagerService extends BrowserApiBaseService {
+    protected getApiName(): string;
+    isSupported(): boolean;
+    estimate(): Promise<StorageQuotaEstimate>;
+    persist(): Promise<boolean>;
+    persisted(): Promise<boolean>;
+    protected ensureSupported(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<StorageManagerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<StorageManagerService>;
+}
+
+type CompressionFormat = 'gzip' | 'deflate' | 'deflate-raw';
+/**
+ * Service wrapping `CompressionStream` and `DecompressionStream`.
+ *
+ * ```ts
+ * const cmp = inject(CompressionService);
+ * const compressed = await cmp.compress(jsonBytes, 'gzip');
+ * const original = await cmp.decompress(compressed, 'gzip');
+ * ```
+ */
+declare class CompressionService extends BrowserApiBaseService {
+    protected getApiName(): string;
+    isSupported(): boolean;
+    /** Compress a `Uint8Array`/`ArrayBuffer` using the given format. */
+    compress(data: Uint8Array | ArrayBuffer, format?: CompressionFormat): Promise<Uint8Array>;
+    /** Decompress a `Uint8Array`/`ArrayBuffer` using the given format. */
+    decompress(data: Uint8Array | ArrayBuffer, format?: CompressionFormat): Promise<Uint8Array>;
+    /** Convenience: compress a UTF-8 string and return the compressed bytes. */
+    compressString(value: string, format?: CompressionFormat): Promise<Uint8Array>;
+    /** Convenience: decompress bytes into a UTF-8 string. */
+    decompressString(data: Uint8Array | ArrayBuffer, format?: CompressionFormat): Promise<string>;
+    protected ensureSupported(): void;
+    private runStream;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CompressionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CompressionService>;
+}
+
+/**
+ * When set to `true`, suppresses the one-time runtime warning that experimental
+ * services emit on first use. Default is `false` (warnings emitted).
+ */
+declare const BROWSER_API_EXPERIMENTAL_SILENT: InjectionToken<boolean>;
+interface ExperimentalWarnContext {
+    silent: boolean;
+    logger: {
+        warn: (message: string) => void;
+    };
+}
+/**
+ * Emit a one-time runtime warning explaining that the API is experimental and
+ * subject to breaking changes. No-op after the first call for a given key, or if
+ * the consumer has provided `BROWSER_API_EXPERIMENTAL_SILENT` as `true`.
+ */
+declare function warnExperimental(key: string, context: ExperimentalWarnContext): void;
+
 interface MediaDevice {
     deviceId: string;
     groupId: string;
@@ -1428,12 +1567,31 @@ declare function provideWebAudio(): EnvironmentProviders;
 
 declare function provideGamepad(): EnvironmentProviders;
 
+declare function provideWebLocks(): EnvironmentProviders;
+
+declare function provideStorageManager(): EnvironmentProviders;
+
+declare function provideCompression(): EnvironmentProviders;
+
 declare function provideMediaApis(): EnvironmentProviders;
 declare function provideLocationApis(): EnvironmentProviders;
 declare function provideStorageApis(): EnvironmentProviders;
 declare function provideCommunicationApis(): EnvironmentProviders;
 
-interface BrowserWebApisConfig {
+/**
+ * Composition-first config: pass an array of `provide*()` calls and we merge them
+ * into a single `EnvironmentProviders`. Preferred over the `enableX` flag bag.
+ *
+ * ```ts
+ * provideBrowserWebApis({
+ *   services: [provideCamera(), provideClipboard(), provideMediaApis()],
+ * })
+ * ```
+ */
+interface BrowserWebApisCompositionConfig {
+    services?: EnvironmentProviders[];
+}
+interface BrowserWebApisConfig extends BrowserWebApisCompositionConfig {
     enableCamera?: boolean;
     enableGeolocation?: boolean;
     enableNotifications?: boolean;
@@ -1467,5 +1625,5 @@ declare function provideBrowserWebApis(config?: BrowserWebApisConfig): Environme
 
 declare const version = "0.1.0";
 
-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, injectBattery, injectClipboard, injectGamepad, injectGeolocation, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, injectWakeLock, 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, BatteryRef, BrowserApiLogger, BrowserCapabilityId, BrowserError, BrowserPermissions, BrowserWebApisConfig, CameraCapabilities, CameraInfo, ClipboardRef, ConnectionType, EffectiveConnectionType, ElementInput, ElementSize, ErrorCallback, EventHandler, FileOpenOptions, FileSaveOptions, GamepadRef, GamepadState, GeolocationCoordinates, GeolocationError, GeolocationOptions, GeolocationPosition$1 as GeolocationPosition, GeolocationRef, 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, StorageNamespace, StorageOptions, StorageValue, VibrationPattern, VibrationPreset, VisibilityState, WakeLockRef, WakeLockStatus, WakeLockType, WebSocketClientConfig, WebSocketConfig, WebSocketMessage, WebSocketRequestOptions, WebSocketState, WebSocketStatus, WebSocketStatusV2, WorkerMessage, WorkerRequestOptions, WorkerStatus, WorkerTask };
+export { BROWSER_API_EXPERIMENTAL_SILENT, BROWSER_API_LOGGER, BROWSER_API_LOG_LEVEL, BatteryService, BroadcastChannelService, BrowserApiBaseService, BrowserCapabilityService, BrowserSupportUtil, CameraService, ClipboardService, CompressionService, ConnectionRegistryBaseService, FileSystemAccessService, FullscreenService, GamepadService, GeolocationService, IntersectionObserverService, MediaDevicesService, MediaRecorderService, MutationObserverService, NetworkInformationService, NotificationService, PageVisibilityService, PerformanceObserverService, PermissionsService, ResizeObserverService, ScreenOrientationService, ScreenWakeLockService, ServerSentEventsService, SpeechSynthesisService, StorageManagerService, VibrationService, WebAudioService, WebLocksService, WebShareService, WebSocketClient, WebSocketService, WebStorageService, WebWorkerService, permissionGuard as createPermissionGuard, defaultBrowserWebApisConfig, injectBattery, injectClipboard, injectGamepad, injectGeolocation, injectIntersectionObserver, injectMutationObserver, injectNetworkInformation, injectPageVisibility, injectPerformanceObserver, injectResizeObserver, injectScreenOrientation, injectWakeLock, permissionGuard, provideBattery, provideBroadcastChannel, provideBrowserApiLogLevel, provideBrowserWebApis, provideCamera, provideClipboard, provideCommunicationApis, provideCompression, provideFileSystemAccess, provideFullscreen, provideGamepad, provideGeolocation, provideIntersectionObserver, provideLocationApis, provideMediaApis, provideMediaDevices, provideMediaRecorder, provideMutationObserver, provideNetworkInformation, provideNotifications, providePageVisibility, providePerformanceObserver, providePermissions, provideResizeObserver, provideScreenOrientation, provideScreenWakeLock, provideServerSentEvents, provideSpeechSynthesis, provideStorageApis, provideStorageManager, provideVibration, provideWebAudio, provideWebLocks, provideWebShare, provideWebSocket, provideWebStorage, provideWebWorker, version, warnExperimental };
+export type { AudioAnalyserData, AudioContextState, BatteryInfo, BatteryManager, BatteryRef, BrowserApiLogLevel, BrowserApiLogger, BrowserCapabilityId, BrowserError, BrowserPermissions, BrowserWebApisCompositionConfig, BrowserWebApisConfig, CameraCapabilities, CameraInfo, ClipboardRef, CompressionFormat, ConnectionType, EffectiveConnectionType, ElementInput, ElementSize, ErrorCallback, EventHandler, ExperimentalWarnContext, FileOpenOptions, FileSaveOptions, GamepadRef, GamepadState, GeolocationCoordinates, GeolocationError, GeolocationOptions, GeolocationPosition$1 as GeolocationPosition, GeolocationRef, 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, StorageNamespace, StorageOptions, StorageQuotaEstimate, StorageValue, VibrationPattern, VibrationPreset, VisibilityState, WakeLockRef, WakeLockStatus, WakeLockType, WebSocketClientConfig, WebSocketConfig, WebSocketMessage, WebSocketRequestOptions, WebSocketState, WebSocketStatus, WebSocketStatusV2, WorkerMessage, WorkerRequestOptions, WorkerStatus, WorkerTask };