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

package/README.es.md

@@ -45,6 +45,9 @@ Paquete de servicios Angular para acceder de forma estructurada y segura a Brows
 - `IdleDetectorService` - Detectar estado idle del usuario y bloqueo de pantalla
 - `GamepadService` - Polling de entrada de controladores de juego
 - `WebAudioService` - Contexto de audio, osciladores y analizadores
+- `WebLocksService` - Coordinacion de locks entre pestanas
+- `StorageManagerService` - Cuotas y persistencia de almacenamiento
+- `CompressionService` - Streams de compresion gzip/deflate
 
 ### APIs de red
 
@@ -706,6 +709,88 @@ export class MyComponent {
 }
 ```
 
+### injectClipboard
+
+```typescript
+import { injectClipboard } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly cb = injectClipboard();
+
+  // cb.text()        → string | null (ultimo texto copiado)
+  // cb.error()       → string | null
+  // cb.busy()        → boolean
+  // cb.isSupported() → boolean
+
+  async copy(text: string) {
+    await this.cb.writeText(text);
+  }
+}
+```
+
+### injectGeolocation
+
+```typescript
+import { injectGeolocation } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly geo = injectGeolocation({ watch: true });
+
+  // geo.position()    → GeolocationPosition | null
+  // geo.error()       → GeolocationPositionError | null
+  // geo.watching()    → boolean
+  // geo.isSupported() → boolean
+
+  stopWatching() {
+    this.geo.stop();
+  }
+}
+```
+
+### injectBattery
+
+```typescript
+import { injectBattery } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly battery = injectBattery();
+
+  // battery.info()        → BatteryInfo | null (nivel, carga, tiempos)
+  // battery.error()       → string | null
+  // battery.isSupported() → boolean
+
+  async refresh() {
+    await this.battery.refresh();
+  }
+}
+```
+
+### injectWakeLock
+
+```typescript
+import { injectWakeLock } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly wakeLock = injectWakeLock();
+
+  // wakeLock.active()      → boolean
+  // wakeLock.error()       → string | null
+  // wakeLock.isSupported() → boolean
+
+  async toggle() {
+    if (this.wakeLock.active()) {
+      await this.wakeLock.release();
+    } else {
+      await this.wakeLock.request();
+    }
+  }
+}
+```
+
 ### Tipo ElementInput
 
 Tanto `injectResizeObserver` como `injectIntersectionObserver` aceptan el tipo `ElementInput`:

package/README.md

@@ -45,6 +45,9 @@ Angular services package for a structured and secure access layer over browser W
 - `IdleDetectorService` - Detect user idle state and screen lock
 - `GamepadService` - Game controller input polling
 - `WebAudioService` - Audio context, oscillators, and analysers
+- `WebLocksService` - Cross-tab resource locking coordination
+- `StorageManagerService` - Storage quotas and persistence
+- `CompressionService` - Gzip/deflate compression streams
 
 ### Network APIs
 
@@ -64,21 +67,9 @@ Angular services package for a structured and secure access layer over browser W
 
 - `WebWorkerService` - Web Worker management
 
-### Device APIs
-
-- `WebBluetoothService` - Bluetooth Low Energy device communication
-- `WebUsbService` - USB device I/O from the browser
-- `WebNfcService` - NFC tag reading and writing
-
 ### Detection APIs
 
 - `EyeDropperService` - Screen color picker
-- `BarcodeDetectorService` - QR code and barcode scanning
-
-### Commerce & Identity APIs
-
-- `PaymentRequestService` - Native payment flows
-- `CredentialManagementService` - Passwords, passkeys (WebAuthn)
 
 ### Security & Capabilities
 
@@ -92,7 +83,7 @@ Angular services package for a structured and secure access layer over browser W
 ## Installation
 
 ```bash
-npm install @angular-helpers/browser-web-apis
+pnpm add @angular-helpers/browser-web-apis
 ```
 
 ## Quick Setup
@@ -101,13 +92,21 @@ npm install @angular-helpers/browser-web-apis
 
 ```typescript
 import { provideBrowserWebApis } from '@angular-helpers/browser-web-apis';
+import {
+  CameraService,
+  GeolocationService,
+  NotificationService,
+} from '@angular-helpers/browser-web-apis';
 
 bootstrapApplication(AppComponent, {
   providers: [
     provideBrowserWebApis({
-      enableCamera: true,
-      enableGeolocation: true,
-      enableNotifications: true,
+      services: [
+        CameraService,
+        GeolocationService,
+        NotificationService,
+        // Add more services as needed
+      ],
     }),
   ],
 });
@@ -146,25 +145,49 @@ Every service has a matching `provideX()` function:
 | `provideWebSocket()`            | `WebSocketService`                          |
 | `provideWebWorker()`            | `WebWorkerService`                          |
 | `provideBattery()`              | `BatteryService`                            |
+| `provideWebShare()`             | `WebShareService`                           |
 | `provideIntersectionObserver()` | `IntersectionObserverService`               |
 | `provideResizeObserver()`       | `ResizeObserverService`                     |
 | `provideMutationObserver()`     | `MutationObserverService`                   |
 | `providePerformanceObserver()`  | `PerformanceObserverService`                |
 | `providePageVisibility()`       | `PageVisibilityService`                     |
 | `provideNetworkInformation()`   | `NetworkInformationService`                 |
-| …and 22 more                    | See `src/providers/`                        |
+| `provideScreenWakeLock()`       | `ScreenWakeLockService`                     |
+| `provideScreenOrientation()`    | `ScreenOrientationService`                  |
+| `provideFullscreen()`           | `FullscreenService`                         |
+| `provideFileSystemAccess()`     | `FileSystemAccessService`                   |
+| `provideMediaRecorder()`        | `MediaRecorderService`                      |
+| `provideBroadcastChannel()`     | `BroadcastChannelService`                   |
+| `provideServerSentEvents()`     | `ServerSentEventsService`                   |
+| `provideVibration()`            | `VibrationService`                          |
+| `provideSpeechSynthesis()`      | `SpeechSynthesisService`                    |
+| `provideWebAudio()`             | `WebAudioService`                           |
+| `provideGamepad()`              | `GamepadService`                            |
+| `provideWebLocks()`             | `WebLocksService`                           |
+| `provideStorageManager()`       | `StorageManagerService`                     |
+| `provideCompression()`          | `CompressionService`                        |
+| `provideEyeDropper()`           | `EyeDropperService`                         |
+| `provideIdleDetector()`         | `IdleDetectorService`                       |
+| `providePermissions()`          | `PermissionsService`                        |
 
 ### Combo providers
 
 Convenience functions that bundle related services:
 
 ```typescript
-import { provideMediaApis, provideStorageApis } from '@angular-helpers/browser-web-apis';
+import {
+  provideMediaApis,
+  provideLocationApis,
+  provideStorageApis,
+  provideCommunicationApis,
+} from '@angular-helpers/browser-web-apis';
 
 bootstrapApplication(AppComponent, {
   providers: [
     provideMediaApis(), // Camera + MediaDevices + Permissions
+    provideLocationApis(), // Geolocation + Permissions
     provideStorageApis(), // Clipboard + WebStorage + Permissions
+    provideCommunicationApis(), // Notification + WebShare + WebSocket + Permissions
   ],
 });
 ```
@@ -755,6 +778,111 @@ export class MyComponent {
 }
 ```
 
+### injectClipboard
+
+```typescript
+import { injectClipboard } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly cb = injectClipboard();
+
+  // cb.text()        → string | null (last copied text)
+  // cb.error()       → string | null
+  // cb.busy()        → boolean
+  // cb.isSupported() → boolean
+
+  async copy(text: string) {
+    await this.cb.writeText(text);
+  }
+}
+```
+
+### injectGeolocation
+
+```typescript
+import { injectGeolocation } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly geo = injectGeolocation({ watch: true });
+
+  // geo.position()  → GeolocationPosition | null
+  // geo.error()     → GeolocationPositionError | null
+  // geo.watching()  → boolean
+  // geo.isSupported() → boolean
+
+  stopWatching() {
+    this.geo.stop();
+  }
+}
+```
+
+### injectBattery
+
+```typescript
+import { injectBattery } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly battery = injectBattery();
+
+  // battery.info()        → BatteryInfo | null (level, charging, times)
+  // battery.error()       → string | null
+  // battery.isSupported() → boolean
+
+  async refresh() {
+    await this.battery.refresh();
+  }
+}
+```
+
+### injectWakeLock
+
+```typescript
+import { injectWakeLock } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly wakeLock = injectWakeLock();
+
+  // wakeLock.active()      → boolean
+  // wakeLock.error()       → string | null
+  // wakeLock.isSupported() → boolean
+
+  async toggle() {
+    if (this.wakeLock.active()) {
+      await this.wakeLock.release();
+    } else {
+      await this.wakeLock.request();
+    }
+  }
+}
+```
+
+### injectEyeDropper
+
+```typescript
+import { injectEyeDropper } from '@angular-helpers/browser-web-apis';
+
+@Component({...})
+export class MyComponent {
+  readonly dropper = injectEyeDropper();
+
+  // dropper.color()       → Signal<string | null> (sRGBHex)
+  // dropper.isOpening()   → Signal<boolean>
+  // dropper.error()       → Signal<Error | null>
+  // dropper.isSupported() → Signal<boolean>
+
+  async pickColor() {
+    const result = await this.dropper.open();
+    if (result) {
+      console.log('Selected color:', result.sRGBHex);
+    }
+  }
+}
+```
+
 ### ElementInput type
 
 Both `injectResizeObserver` and `injectIntersectionObserver` accept the `ElementInput` type:

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

@@ -42,10 +42,10 @@ class IdleDetectorService extends BrowserApiBaseService {
             return () => abortController.abort();
         });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: IdleDetectorService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: IdleDetectorService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: IdleDetectorService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: IdleDetectorService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: IdleDetectorService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: IdleDetectorService, decorators: [{
             type: Injectable
         }] });
 
@@ -66,10 +66,10 @@ class EyeDropperService extends BrowserApiBaseService {
         const eyeDropper = new (getEyeDropperClass())();
         return eyeDropper.open();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: EyeDropperService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: EyeDropperService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: EyeDropperService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: EyeDropperService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: EyeDropperService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: EyeDropperService, decorators: [{
             type: Injectable
         }] });
 
@@ -128,10 +128,10 @@ class BarcodeDetectorService extends BrowserApiBaseService {
             };
         });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: BarcodeDetectorService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: BarcodeDetectorService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: BarcodeDetectorService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: BarcodeDetectorService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: BarcodeDetectorService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: BarcodeDetectorService, decorators: [{
             type: Injectable
         }] });
 
@@ -164,10 +164,10 @@ class WebBluetoothService extends BrowserApiBaseService {
             subscriber.complete();
         });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebBluetoothService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebBluetoothService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebBluetoothService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebBluetoothService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebBluetoothService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebBluetoothService, decorators: [{
             type: Injectable
         }] });
 
@@ -220,10 +220,10 @@ class WebUsbService extends BrowserApiBaseService {
             opened: device.opened,
         };
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebUsbService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebUsbService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebUsbService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebUsbService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebUsbService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebUsbService, decorators: [{
             type: Injectable
         }] });
 
@@ -269,10 +269,10 @@ class WebNfcService extends BrowserApiBaseService {
         const reader = new (getNdefReaderClass())();
         await reader.write(message, options);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebNfcService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebNfcService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebNfcService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebNfcService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: WebNfcService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: WebNfcService, decorators: [{
             type: Injectable
         }] });
 
@@ -311,10 +311,10 @@ class PaymentRequestService extends BrowserApiBaseService {
         const request = new PaymentRequest(methods, details);
         await request.abort();
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: PaymentRequestService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: PaymentRequestService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: PaymentRequestService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: PaymentRequestService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: PaymentRequestService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: PaymentRequestService, decorators: [{
             type: Injectable
         }] });
 
@@ -369,10 +369,10 @@ class CredentialManagementService extends BrowserApiBaseService {
         }
         return false;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: CredentialManagementService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: CredentialManagementService });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: CredentialManagementService, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: CredentialManagementService });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImport: i0, type: CredentialManagementService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.13", ngImport: i0, type: CredentialManagementService, decorators: [{
             type: Injectable
         }] });