---
url: https://docs.moqtail.dev/ts/api/client/type-aliases/MOQtailRequest.md
---
# Type Alias: MOQtailRequest

> **MOQtailRequest** = [`PublishRequest`](../classes/PublishRequest.md) | [`PublishNamespaceRequest`](../classes/PublishNamespaceRequest.md) | [`SubscribeNamespaceRequest`](../classes/SubscribeNamespaceRequest.md) | [`FetchRequest`](../classes/FetchRequest.md) | [`SubscribeRequest`](../classes/SubscribeRequest.md) | [`TrackStatusRequest`](../classes/TrackStatusRequest.md)

Discriminated union of every in‑flight MOQ‑tail control request tracked by the [MOQtailClient](../classes/MOQtailClient.md).

Each concrete request type encapsulates the original control message plus coordination primitives
(e.g. a [Promise](https://developer.mozilla.org/docs/Web/API/Promise) facade / stream controller) that resolve when a terminal protocol response
(OK / ERROR / CANCEL) is received.

Used internally in maps like `MOQtailClient.requests` to look up state by request id without needing
multiple heterogeneous collections.

Variants:

* [PublishNamespaceRequest](../classes/PublishNamespaceRequest.md) – pending PUBLISH_NAMESPACE / PUBLISH_NAMESPACE_OK / PUBLISH_NAMESPACE_ERROR.
* [SubscribeNamespaceRequest](../classes/SubscribeNamespaceRequest.md) – pending SUBSCRIBE_NAMESPACE sequence.
* [FetchRequest](../classes/FetchRequest.md) – pending FETCH handshake producing a data stream.
* [SubscribeRequest](../classes/SubscribeRequest.md) – pending SUBSCRIBE producing subgroup object streams.

## Example

**Looking up a request by id**

```ts
function isActive(requests: Map<bigint, MOQtailRequest>, id: bigint) {
  const req = requests.get(id)
  if (!req) return false
  // Narrow by instanceof, e.g. FetchRequest
  if (req instanceof FetchRequest) {
    console.log('Fetch still pending for', req.message.requestId)
  }
  return true
}
```
