@untemps/user-permissions-utils 1.2.5 → 1.3.1

package/README.md

@@ -54,25 +54,62 @@ controller.abort()
 
 `getUserMediaStream`:
 
-Returns a promise resolved when the permission is granted and the stream is retrieved
+Returns a promise resolved when the permission is granted and the stream is retrieved. Accepts an optional `signal` to cancel the entire operation.
+
+The `permissionName` and `mediaStreamConstraints` must match the same media device:
+
+| `permissionName` | `mediaStreamConstraints` |
+|---|---|
+| `'microphone'` | `{ audio: true }` |
+| `'camera'` | `{ video: true }` |
+
+```javascript
+import { getUserMediaStream } from '@untemps/user-permissions-utils'
+
+// Microphone
+const init = async () => {
+    try {
+        const stream = await getUserMediaStream('microphone', { audio: true })
+        const audioContext = new AudioContext()
+        const streamNode = audioContext.createMediaStreamSource(stream)
+        ...
+    } catch (error) {
+        console.error(error)
+    }
+}
+
+// Camera
+const initCamera = async () => {
+    try {
+        const stream = await getUserMediaStream('camera', { video: true })
+        const videoElement = document.querySelector('video')
+        videoElement.srcObject = stream
+        ...
+    } catch (error) {
+        console.error(error)
+    }
+}
+```
+
+To cancel a pending stream acquisition:
 
 ```javascript
 import { getUserMediaStream } from '@untemps/user-permissions-utils'
 
+const controller = new AbortController()
+
 const init = async () => {
     try {
-    	const stream = await getUserMediaStream('microphone', { audio: true })
-    	if(!!stream) {
-    	    const audioContext = new AudioContext()
-    	    const streamNode = audioContext.createMediaStreamSource(stream)
-            ...
-    	} else {
-    	    console.error('Stream is not available')
-    	}
+        const stream = await getUserMediaStream('microphone', { audio: true }, { signal: controller.signal })
+        ...
     } catch (error) {
+        if (error.name === 'AbortError') return
         console.error(error)
     }
 }
+
+// Cancel the operation at any point (permission wait or stream acquisition)
+controller.abort()
 ```
 
 `isNavigatorPermissionsSupported`:

package/dist/index.d.ts

@@ -4,7 +4,8 @@ export declare function getPermission(
 ): Promise<'granted'>
 export declare function getUserMediaStream(
 	permissionName: PermissionName,
-	constraints: MediaStreamConstraints
+	constraints: MediaStreamConstraints,
+	options?: { signal?: AbortSignal }
 ): Promise<MediaStream>
 export declare function isNavigatorPermissionsSupported(): boolean
 export declare function isNavigatorMediaDevicesSupported(): boolean

package/dist/index.es.js

@@ -20,9 +20,10 @@ var e = () => !!navigator.permissions, t = () => !!navigator.mediaDevices, n = a
 }, r = (e) => {
 	if (e === "denied") throw new DOMException("Permission denied", "NOT_ALLOWED_ERR");
 	return e;
-}, i = async (r, i) => {
+}, i = async (n, r, { signal: i } = {}) => {
 	if (!e() || !t()) throw new DOMException("Navigator API: permissions or Navigator API: mediaDevices not supported", "NOT_SUPPORTED_ERR");
-	return await n(r), navigator.mediaDevices.getUserMedia(i);
+	if (i?.throwIfAborted(), (await navigator.permissions.query({ name: n })).state === "denied") throw new DOMException("Permission denied", "NOT_ALLOWED_ERR");
+	return i?.throwIfAborted(), navigator.mediaDevices.getUserMedia(r);
 };
 //#endregion
 export { n as getPermission, i as getUserMediaStream, t as isNavigatorMediaDevicesSupported, e as isNavigatorPermissionsSupported };

package/dist/index.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=()=>!!navigator.permissions,t=()=>!!navigator.mediaDevices,n=async(t,{signal:n}={})=>{if(!e())throw new DOMException(`Navigator API: permissions not supported`,`NOT_SUPPORTED_ERR`);n?.throwIfAborted();let i=await navigator.permissions.query({name:t});return i.state===`prompt`?new Promise((e,t)=>{n?.throwIfAborted();let a=s=>{i.removeEventListener(`change`,a),n?.removeEventListener(`abort`,o);try{e(r(s.target.state))}catch(e){t(e)}},o=()=>{i.removeEventListener(`change`,a),t(n.reason)};i.addEventListener(`change`,a),n?.addEventListener(`abort`,o,{once:!0})}):r(i.state)},r=e=>{if(e===`denied`)throw new DOMException(`Permission denied`,`NOT_ALLOWED_ERR`);return e},i=async(r,i)=>{if(!e()||!t())throw new DOMException(`Navigator API: permissions or Navigator API: mediaDevices not supported`,`NOT_SUPPORTED_ERR`);return await n(r),navigator.mediaDevices.getUserMedia(i)};exports.getPermission=n,exports.getUserMediaStream=i,exports.isNavigatorMediaDevicesSupported=t,exports.isNavigatorPermissionsSupported=e;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=()=>!!navigator.permissions,t=()=>!!navigator.mediaDevices,n=async(t,{signal:n}={})=>{if(!e())throw new DOMException(`Navigator API: permissions not supported`,`NOT_SUPPORTED_ERR`);n?.throwIfAborted();let i=await navigator.permissions.query({name:t});return i.state===`prompt`?new Promise((e,t)=>{n?.throwIfAborted();let a=s=>{i.removeEventListener(`change`,a),n?.removeEventListener(`abort`,o);try{e(r(s.target.state))}catch(e){t(e)}},o=()=>{i.removeEventListener(`change`,a),t(n.reason)};i.addEventListener(`change`,a),n?.addEventListener(`abort`,o,{once:!0})}):r(i.state)},r=e=>{if(e===`denied`)throw new DOMException(`Permission denied`,`NOT_ALLOWED_ERR`);return e},i=async(n,r,{signal:i}={})=>{if(!e()||!t())throw new DOMException(`Navigator API: permissions or Navigator API: mediaDevices not supported`,`NOT_SUPPORTED_ERR`);if(i?.throwIfAborted(),(await navigator.permissions.query({name:n})).state===`denied`)throw new DOMException(`Permission denied`,`NOT_ALLOWED_ERR`);return i?.throwIfAborted(),navigator.mediaDevices.getUserMedia(r)};exports.getPermission=n,exports.getUserMediaStream=i,exports.isNavigatorMediaDevicesSupported=t,exports.isNavigatorPermissionsSupported=e;

package/dist/index.umd.js

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports):typeof define==`function`&&define.amd?define([`exports`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.UserPermissionsUtils={}))})(this,function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=()=>!!navigator.permissions,n=()=>!!navigator.mediaDevices,r=async(e,{signal:n}={})=>{if(!t())throw new DOMException(`Navigator API: permissions not supported`,`NOT_SUPPORTED_ERR`);n?.throwIfAborted();let r=await navigator.permissions.query({name:e});return r.state===`prompt`?new Promise((e,t)=>{n?.throwIfAborted();let a=s=>{r.removeEventListener(`change`,a),n?.removeEventListener(`abort`,o);try{e(i(s.target.state))}catch(e){t(e)}},o=()=>{r.removeEventListener(`change`,a),t(n.reason)};r.addEventListener(`change`,a),n?.addEventListener(`abort`,o,{once:!0})}):i(r.state)},i=e=>{if(e===`denied`)throw new DOMException(`Permission denied`,`NOT_ALLOWED_ERR`);return e};e.getPermission=r,e.getUserMediaStream=async(e,i)=>{if(!t()||!n())throw new DOMException(`Navigator API: permissions or Navigator API: mediaDevices not supported`,`NOT_SUPPORTED_ERR`);return await r(e),navigator.mediaDevices.getUserMedia(i)},e.isNavigatorMediaDevicesSupported=n,e.isNavigatorPermissionsSupported=t});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports):typeof define==`function`&&define.amd?define([`exports`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.UserPermissionsUtils={}))})(this,function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=()=>!!navigator.permissions,n=()=>!!navigator.mediaDevices,r=async(e,{signal:n}={})=>{if(!t())throw new DOMException(`Navigator API: permissions not supported`,`NOT_SUPPORTED_ERR`);n?.throwIfAborted();let r=await navigator.permissions.query({name:e});return r.state===`prompt`?new Promise((e,t)=>{n?.throwIfAborted();let a=s=>{r.removeEventListener(`change`,a),n?.removeEventListener(`abort`,o);try{e(i(s.target.state))}catch(e){t(e)}},o=()=>{r.removeEventListener(`change`,a),t(n.reason)};r.addEventListener(`change`,a),n?.addEventListener(`abort`,o,{once:!0})}):i(r.state)},i=e=>{if(e===`denied`)throw new DOMException(`Permission denied`,`NOT_ALLOWED_ERR`);return e};e.getPermission=r,e.getUserMediaStream=async(e,r,{signal:i}={})=>{if(!t()||!n())throw new DOMException(`Navigator API: permissions or Navigator API: mediaDevices not supported`,`NOT_SUPPORTED_ERR`);if(i?.throwIfAborted(),(await navigator.permissions.query({name:e})).state===`denied`)throw new DOMException(`Permission denied`,`NOT_ALLOWED_ERR`);return i?.throwIfAborted(),navigator.mediaDevices.getUserMedia(r)},e.isNavigatorMediaDevicesSupported=n,e.isNavigatorPermissionsSupported=t});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@untemps/user-permissions-utils",
-	"version": "1.2.5",
+	"version": "1.3.1",
 	"description": "Collection of utility functions to manage user permissions",
 	"repository": "git@github.com:untemps/user-permissions-utils.git",
 	"keywords": [