@pexip/media 20.3.3 → 20.3.5

package/api-docs/type-aliases/Process.mdx

@@ -0,0 +1,19 @@
+```ts
+type Process<T> = (a) => Promise<MediaTrack>;
+```
+
+## Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T` |
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `a` | `T` |
+
+## Returns
+
+`Promise`\<[`MediaTrack`](../interfaces/MediaTrack.mdx)\>

package/api-docs/type-aliases/Segmenters.mdx

@@ -0,0 +1,3 @@
+```ts
+type Segmenters = { [Property in SegmentationModel]: Segmenter };
+```

package/api-docs/type-aliases/TrackProcessor.mdx

@@ -0,0 +1,3 @@
+```ts
+type TrackProcessor = Process<MediaTrack>;
+```

package/api-docs/type-aliases/Unsubscribe.mdx

@@ -0,0 +1,7 @@
+```ts
+type Unsubscribe = () => void;
+```
+
+## Returns
+
+`void`

package/api-docs/type-aliases/UserMediaValidator.mdx

@@ -0,0 +1,13 @@
+```ts
+type UserMediaValidator = (status) => boolean;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `status` | [`UserMediaStatus`](../enumerations/UserMediaStatus.mdx) |
+
+## Returns
+
+`boolean`

package/api-docs/type-aliases/VideoContentHint.mdx

@@ -0,0 +1,3 @@
+```ts
+type VideoContentHint = typeof VIDEO_CONTENT_HINTS[keyof typeof VIDEO_CONTENT_HINTS];
+```

package/api-docs/type-aliases/VideoRenderParams.mdx

@@ -0,0 +1,15 @@
+```ts
+type VideoRenderParams = Omit<RendererOptions, "effects"> & object;
+```
+
+## Type Declaration
+
+| Name | Type | Description |
+| ------ | ------ | ------ |
+| `frameRate` | `number` | Target frame rate for the video segmentation |
+| `width` | `number` | Render Effects |
+| `height` | `number` | - |
+| `videoSegmentation` | `RenderEffects` | - |
+| `pan?` | `boolean` | - |
+| `tilt?` | `boolean` | - |
+| `zoom?` | `boolean` | - |

package/api-docs/type-aliases/VideoStreamTrackProcessorAPIs.mdx

@@ -0,0 +1,7 @@
+```ts
+type VideoStreamTrackProcessorAPIs = "stream" | "canvas";
+```
+
+Use which processor API to process the stream track
+`stream` - Use `MediaStreamTrackProcessor`, when available
+`canvas` - Use Canvas

package/api-docs/variables/AUDIO_CONTENT_HINTS.mdx

@@ -0,0 +1,17 @@
+```ts
+const AUDIO_CONTENT_HINTS: object;
+```
+
+Audio content hints are only applicable when the MediaStreamTrack contains an
+audio track
+
+[https://www.w3.org/TR/mst-content-hint/#audio-content-hints](https://www.w3.org/TR/mst-content-hint/#audio-content-hints)
+
+## Type Declaration
+
+| Name | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| <a id="nohint"></a> `NoHint` | `""` | `''` | No hint has been provided, the implementation should make its best-informed guess on how to handle contained audio data. This may be inferred from how the track was opened or by doing content analysis |
+| <a id="speech"></a> `Speech` | `"speech"` | `'speech'` | The track should be treated as if it contains speech data. Consuming this signal it may be appropriate to apply noise suppression or boost intelligibility of the incoming signal. |
+| <a id="speechrecognition"></a> `SpeechRecognition` | `"speech-recognition"` | `'speech-recognition'` | The track should be treated as if it contains data for the purpose of speech recognition by a machine. Consuming this signal it may be appropriate to boost intelligibility of the incoming signal for transcription and turn off audio-processing components that are used for human consumption. |
+| <a id="music"></a> `Music` | `"music"` | `'music'` | The track should be treated as if it contains music data. Generally this might imply tuning or turning off audio-processing components that are used to process speech data to prevent the audio from being distorted. |

package/api-docs/variables/REQUIRED_SIGNAL_KEYS.mdx

@@ -0,0 +1,3 @@
+```ts
+const REQUIRED_SIGNAL_KEYS: readonly ["onMediaChanged", "onVAD", "onSilentDetected"];
+```

package/api-docs/variables/VIDEO_CONTENT_HINTS.mdx

@@ -0,0 +1,17 @@
+```ts
+const VIDEO_CONTENT_HINTS: object;
+```
+
+Video content hints are only applicable when the MediaStreamTrack contains a
+video track.
+
+[https://www.w3.org/TR/mst-content-hint/#video-content-hints](https://www.w3.org/TR/mst-content-hint/#video-content-hints)
+
+## Type Declaration
+
+| Name | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| <a id="nohint"></a> `NoHint` | `""` | `''` | No hint has been provided, the implementation should make its best-informed guess on how contained video content should be treated. This can for example be inferred from how the track was opened or by doing content analysis. |
+| <a id="motion"></a> `Motion` | `"motion"` | `'motion'` | The track should be treated as if it contains video where motion is important. This is normally webcam video, movies or video games. Quantization artefacts and downscaling are acceptable in order to preserve motion as well as possible while still retaining target bitrates. During low bitrates when compromises have to be made, more effort is spent on preserving frame rate than edge quality and details. |
+| <a id="detail"></a> `Detail` | `"detail"` | `'detail'` | The track should be treated as if video details are extra important. This is generally applicable to presentations or web pages with text content, painting or line art. This setting would normally optimize for detail in the resulting individual frames rather than smooth playback. Artefacts from quantization or downscaling that make small text or line art unintelligible should be avoided. |
+| <a id="text"></a> `Text` | `"text"` | `'text'` | The track should be treated as if video details are extra important, and that significant sharp edges and areas of consistent color can occur frequently. This is generally applicable to presentations or web pages with text content. This setting would normally optimize for detail in the resulting individual frames rather than smooth playback, and may take advantage of encoder tools that optimize for text rendering. Artefacts from quantization or downscaling that make small text or line art unintelligible should be avoided. |

package/api-docs/variables/areBothGranted.mdx

@@ -0,0 +1,3 @@
+```ts
+const areBothGranted: UserMediaValidator;
+```

package/api-docs/variables/hasNoAudioDevices.mdx

@@ -0,0 +1,3 @@
+```ts
+const hasNoAudioDevices: UserMediaValidator;
+```

package/api-docs/variables/hasNoDevice.mdx

@@ -0,0 +1,3 @@
+```ts
+const hasNoDevice: UserMediaValidator;
+```

package/api-docs/variables/hasNoVideoDevices.mdx

@@ -0,0 +1,3 @@
+```ts
+const hasNoVideoDevices: UserMediaValidator;
+```

package/api-docs/variables/internalSignals.mdx

@@ -0,0 +1,13 @@
+```ts
+const internalSignals: object;
+```
+
+**`Internal`**
+
+Internal signals
+
+## Type Declaration
+
+| Name | Type |
+| ------ | ------ |
+| <a id="ondeviceschanged"></a> `onDevicesChanged` | `Signal`\<`IndexedDevices`, `IndexedDevices`\> |

package/api-docs/variables/isAudioDeviceInUse.mdx

@@ -0,0 +1,3 @@
+```ts
+const isAudioDeviceInUse: UserMediaValidator;
+```

package/api-docs/variables/isDeviceInUse.mdx

@@ -0,0 +1,3 @@
+```ts
+const isDeviceInUse: UserMediaValidator;
+```

package/api-docs/variables/isDevicesInUse.mdx

@@ -0,0 +1,3 @@
+```ts
+const isDevicesInUse: UserMediaValidator;
+```

package/api-docs/variables/isFallback.mdx

@@ -0,0 +1,3 @@
+```ts
+const isFallback: UserMediaValidator;
+```

package/api-docs/variables/isFallbackAudio.mdx

@@ -0,0 +1,3 @@
+```ts
+const isFallbackAudio: UserMediaValidator;
+```

package/api-docs/variables/isFallbackVideo.mdx

@@ -0,0 +1,3 @@
+```ts
+const isFallbackVideo: UserMediaValidator;
+```

package/api-docs/variables/isGranted.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGranted: UserMediaValidator;
+```

package/api-docs/variables/isGrantedAudio.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGrantedAudio: UserMediaValidator;
+```

package/api-docs/variables/isGrantedOnlyAudio.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGrantedOnlyAudio: UserMediaValidator;
+```

package/api-docs/variables/isGrantedOnlyAudioNoVideoDevices.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGrantedOnlyAudioNoVideoDevices: UserMediaValidator;
+```

package/api-docs/variables/isGrantedOnlyVideo.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGrantedOnlyVideo: UserMediaValidator;
+```

package/api-docs/variables/isGrantedOnlyVideoNoAudioDevices.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGrantedOnlyVideoNoAudioDevices: UserMediaValidator;
+```

package/api-docs/variables/isGrantedVideo.mdx

@@ -0,0 +1,3 @@
+```ts
+const isGrantedVideo: UserMediaValidator;
+```

package/api-docs/variables/isInitial.mdx

@@ -0,0 +1,3 @@
+```ts
+const isInitial: UserMediaValidator;
+```

package/api-docs/variables/isInitialPermissions.mdx

@@ -0,0 +1,3 @@
+```ts
+const isInitialPermissions: UserMediaValidator;
+```

package/api-docs/variables/isInitialPermissionsGranted.mdx

@@ -0,0 +1,3 @@
+```ts
+const isInitialPermissionsGranted: UserMediaValidator;
+```

package/api-docs/variables/isInitialPermissionsNotGranted.mdx

@@ -0,0 +1,3 @@
+```ts
+const isInitialPermissionsNotGranted: UserMediaValidator;
+```

package/api-docs/variables/isOnlyAudioError.mdx

@@ -0,0 +1,3 @@
+```ts
+const isOnlyAudioError: UserMediaValidator;
+```

package/api-docs/variables/isOnlyVideoError.mdx

@@ -0,0 +1,3 @@
+```ts
+const isOnlyVideoError: UserMediaValidator;
+```

package/api-docs/variables/isOverConstrained.mdx

@@ -0,0 +1,3 @@
+```ts
+const isOverConstrained: UserMediaValidator;
+```

package/api-docs/variables/isPromptAudio.mdx

@@ -0,0 +1,3 @@
+```ts
+const isPromptAudio: UserMediaValidator;
+```

package/api-docs/variables/isPromptVideo.mdx

@@ -0,0 +1,3 @@
+```ts
+const isPromptVideo: UserMediaValidator;
+```

package/api-docs/variables/isRejected.mdx

@@ -0,0 +1,3 @@
+```ts
+const isRejected: UserMediaValidator;
+```

package/api-docs/variables/isRejectedOnlyAudio.mdx

@@ -0,0 +1,3 @@
+```ts
+const isRejectedOnlyAudio: UserMediaValidator;
+```

package/api-docs/variables/isRejectedOnlyVideo.mdx

@@ -0,0 +1,3 @@
+```ts
+const isRejectedOnlyVideo: UserMediaValidator;
+```

package/api-docs/variables/isRequestPermissionNeeded.mdx

@@ -0,0 +1,3 @@
+```ts
+const isRequestPermissionNeeded: UserMediaValidator;
+```

package/api-docs/variables/isUnknownError.mdx

@@ -0,0 +1,3 @@
+```ts
+const isUnknownError: UserMediaValidator;
+```

package/api-docs/variables/isVideoDeviceInUse.mdx

@@ -0,0 +1,3 @@
+```ts
+const isVideoDeviceInUse: UserMediaValidator;
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pexip/media",
-  "version": "20.3.3",
+  "version": "20.3.5",
   "description": "Home for media related stuff",
   "homepage": "https://gitlab.com/pexip/zoo",
   "bugs": "https://gitlab.com/pexip/zoo/issues",
@@ -26,37 +26,42 @@
   },
   "directories": {
     "lib": "lib",
-    "test": "__tests__"
+    "test": "__tests__",
+    "doc": "api-docs"
   },
   "files": [
-    "dist"
+    "dist",
+    "api-docs"
   ],
   "scripts": {
-    "build": "pexip-bundler build",
-    "build:sourcemap": "pexip-bundler build --sourcemap",
-    "clean": "rm -fr dist",
+    "build": "pexip-bundler build && yarn docs",
+    "build:sourcemap": "pexip-bundler build --sourcemap && yarn docs",
+    "clean": "rm -fr dist api-docs",
     "dev": "pexip-bundler dev",
     "prepack": "yarn clean && yarn build",
     "test": "jest",
     "check-format": "prettier --ignore-path=../../.prettierignore --check .",
     "format": "prettier --ignore-path=../../.prettierignore --write .",
     "lint": "yarn run -T biome lint",
-    "typecheck": "yarn tsc --noEmit -p ."
+    "typecheck": "yarn tsc --noEmit -p .",
+    "docs": "typedoc"
   },
   "dependencies": {
-    "@pexip/media-control": "20.3.3",
-    "@pexip/media-processor": "20.3.3",
-    "@pexip/signal": "16.9.2",
-    "@pexip/utils": "17.1.1"
+    "@pexip/media-control": "20.3.5",
+    "@pexip/media-processor": "20.3.5",
+    "@pexip/signal": "16.9.3",
+    "@pexip/utils": "17.1.3"
   },
   "devDependencies": {
     "@jest/globals": "^30.2.0",
-    "@pexip/bundler": "18.1.2",
+    "@pexip/bundler": "18.2.0",
     "@swc/core": "^1.10.12",
     "@swc/jest": "^0.2.39",
     "jest": "^29.5.12",
     "jest-junit": "^16.0.0",
     "prettier": "^3.2.5",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "~5.7.3"
   },
   "publishConfig": {