moqtail 0.7.0 → 0.8.1

package/dist/client/index.d.cts

@@ -1,5 +1,5 @@
-import { w as ControlMessage, U as SubscribeOk, Q as SubscribeError, S as Subscribe, V as SubscribeUpdate, q as PublishDoneStatusCode, x as Fetch, b as PublishNamespaceOk, a as PublishNamespaceError, P as PublishNamespace, A as FetchOk, z as FetchError, J as SubscribeNamespaceOk, I as SubscribeNamespaceError, H as SubscribeNamespace, a5 as SetupParameters, G as GroupOrder, F as FilterType, a7 as VersionSpecificParameters, h as FetchType, a2 as RequestIdMap, Z as PublishNamespaceDone, B as GoAway, a1 as SubgroupHeader, a0 as FetchHeader, E as ServerSetup, c as PublishNamespaceCancel, $ as UnsubscribeNamespace, a3 as Header } from '../version_parameter-DCE9_itC.cjs';
-import { n as MoqtObject, L as Location, m as FullTrackName, f as ObjectForwardingPreference, K as KeyValuePair, D as DatagramObject, h as DatagramStatus, c as Tuple, o as SubgroupObject, j as FetchObject } from '../byte_buffer-BOK6VPTF.cjs';
+import { n as MoqtObject, L as Location, m as FullTrackName, f as ObjectForwardingPreference, K as KeyValuePair, D as DatagramObject, h as DatagramStatus, c as Tuple, o as SubgroupObject, j as FetchObject } from '../byte_buffer-BM4uNj4n.cjs';
+import { w as ControlMessage, S as Subscribe, q as PublishDoneStatusCode, V as SubscribeUpdate, x as Fetch, L as Publish, b as PublishNamespaceOk, a as PublishNamespaceError, P as PublishNamespace, A as FetchOk, z as FetchError, U as SubscribeOk, Q as SubscribeError, J as SubscribeNamespaceOk, I as SubscribeNamespaceError, H as SubscribeNamespace, O as PublishOk, N as PublishError, a5 as SetupParameters, G as GroupOrder, F as FilterType, a7 as VersionSpecificParameters, h as FetchType, a2 as RequestIdMap, Z as PublishNamespaceDone, B as GoAway, a1 as SubgroupHeader, a0 as FetchHeader, E as ServerSetup, c as PublishNamespaceCancel, $ as UnsubscribeNamespace, a3 as Header } from '../version_parameter-BpmuiMQj.cjs';
 
 /**
  * Copyright 2025 The MOQtail Authors
@@ -263,48 +263,6 @@ type Track = {
     trackAlias?: bigint;
 };
 
-/**
- * Copyright 2025 The MOQtail Authors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeError> {
-    #private;
-    requestId: bigint;
-    fullTrackName: FullTrackName;
-    isCanceled: boolean;
-    startLocation: Location | undefined;
-    endGroup: bigint | undefined;
-    priority: number;
-    forward: boolean;
-    subscribeParameters: KeyValuePair[];
-    largestLocation: Location | undefined;
-    streamsAccepted: bigint;
-    expectedStreams: bigint | undefined;
-    readonly controller: ReadableStreamDefaultController<MoqtObject>;
-    readonly stream: ReadableStream<MoqtObject>;
-    constructor(msg: Subscribe);
-    update(msg: SubscribeUpdate): void;
-    switch(newTrackName: FullTrackName, newParameters: KeyValuePair[]): void;
-    unsubscribe(): void;
-    resolve(value: SubscribeOk | SubscribeError | PromiseLike<SubscribeOk | SubscribeError>): void;
-    reject(reason?: any): void;
-    then<TResult1 = SubscribeOk | SubscribeError, TResult2 = never>(onfulfilled?: ((value: SubscribeOk | SubscribeError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeOk | SubscribeError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeOk | SubscribeError>;
-}
-
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -390,6 +348,56 @@ declare class FetchPublication {
     publish(): Promise<void>;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @public
+ * Manages the proactive publication of MOQT objects from a publisher to the relay.
+ * Handles live object streaming and stream management.
+ */
+declare class PublishPublication {
+    #private;
+    private readonly client;
+    readonly track: Track;
+    private readonly publishMsg;
+    /**
+     * The latest location that was published to the relay.
+     */
+    latestLocation: Location | undefined;
+    /**
+     * Creates a new PublishPublication instance.
+     * @param client - The MOQT client managing the connection.
+     * @param track - The track being proactively published.
+     * @param publishMsg - The publish message that initiated this session.
+     */
+    constructor(client: MOQtailClient, track: Track, publishMsg: Publish);
+    /**
+     * Cancels the publication and cleans up resources.
+     * Removes the publication from the client's publication map.
+     */
+    cancel(): void;
+    /**
+     * Publishes MOQT objects to the relay as they become available.
+     * Handles stream creation, object writing, and stream closure.
+     * @throws :{@link InternalError} If the track does not support live content.
+     */
+    publishToRelay(): Promise<void>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -454,6 +462,48 @@ declare class FetchRequest implements PromiseLike<FetchOk | FetchError> {
     finally(onfinally?: (() => void) | undefined | null): Promise<FetchOk | FetchError>;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeError> {
+    #private;
+    requestId: bigint;
+    fullTrackName: FullTrackName;
+    isCanceled: boolean;
+    startLocation: Location | undefined;
+    endGroup: bigint | undefined;
+    priority: number;
+    forward: boolean;
+    subscribeParameters: KeyValuePair[];
+    largestLocation: Location | undefined;
+    streamsAccepted: bigint;
+    expectedStreams: bigint | undefined;
+    readonly controller: ReadableStreamDefaultController<MoqtObject>;
+    readonly stream: ReadableStream<MoqtObject>;
+    constructor(msg: Subscribe);
+    update(msg: SubscribeUpdate): void;
+    switch(newTrackName: FullTrackName, newParameters: KeyValuePair[]): void;
+    unsubscribe(): void;
+    resolve(value: SubscribeOk | SubscribeError | PromiseLike<SubscribeOk | SubscribeError>): void;
+    reject(reason?: any): void;
+    then<TResult1 = SubscribeOk | SubscribeError, TResult2 = never>(onfulfilled?: ((value: SubscribeOk | SubscribeError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeOk | SubscribeError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeOk | SubscribeError>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -476,7 +526,7 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
     private _resolve;
     private _reject;
     private promise;
-    constructor(requestId: bigint, message: SubscribeNamespace);
+    constructor(msg: SubscribeNamespace);
     resolve(value: SubscribeNamespaceOk | SubscribeNamespaceError | PromiseLike<SubscribeNamespaceOk | SubscribeNamespaceError>): void;
     reject(reason?: any): void;
     then<TResult1 = SubscribeNamespaceOk | SubscribeNamespaceError, TResult2 = never>(onfulfilled?: ((value: SubscribeNamespaceOk | SubscribeNamespaceError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
@@ -484,6 +534,36 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
     finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeNamespaceOk | SubscribeNamespaceError>;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class PublishRequest implements PromiseLike<PublishOk | PublishError> {
+    readonly requestId: bigint;
+    readonly message: Publish;
+    private _resolve;
+    private _reject;
+    private promise;
+    constructor(msg: Publish);
+    resolve(value: PublishOk | PublishError | PromiseLike<PublishOk | PublishError>): void;
+    reject(reason?: any): void;
+    then<TResult1 = PublishOk | PublishError, TResult2 = never>(onfulfilled?: ((value: PublishOk | PublishError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<PublishOk | PublishError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<PublishOk | PublishError>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -530,7 +610,7 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
  * }
  * ```
  */
-type MOQtailRequest = PublishNamespaceRequest | SubscribeNamespaceRequest | FetchRequest | SubscribeRequest;
+type MOQtailRequest = PublishRequest | PublishNamespaceRequest | SubscribeNamespaceRequest | FetchRequest | SubscribeRequest;
 /**
  * Options for {@link MOQtailClient.new} controlling connection target, protocol negotiation, timeouts,
  * and lifecycle callbacks.
@@ -572,7 +652,7 @@ type MOQtailClientOptions = {
     /** Control stream read timeout in milliseconds. */
     controlStreamTimeoutMs?: number;
     /** If true, enables datagram support for the session. */
-    enableDatagrams: boolean;
+    enableDatagrams?: boolean;
     /** callbacks for observability and logging purposes: */
     callbacks?: {
         /** Called after a control message is successfully written to the {@link ControlStream}. */
@@ -864,22 +944,6 @@ declare class RecvDatagramStream {
     releaseLock(): void;
 }
 
-/**
- * Copyright 2025 The MOQtail Authors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
 /**
  * @public
  * Represents a Media Over QUIC Transport (MOQT) client session.
@@ -954,12 +1018,12 @@ declare class MOQtailClient {
      * Active publications (SUBSCRIBE or FETCH) keyed by requestId to manage object stream controllers and lifecycle.
      * Subset / specialization view of `requests`.
      */
-    readonly publications: Map<bigint, SubscribePublication | FetchPublication>;
+    readonly publications: Map<bigint, SubscribePublication | FetchPublication | PublishPublication>;
     /**
      * Active SUBSCRIBE request wrappers keyed by track alias for rapid alias -\> subscription resolution during
      * incoming unidirectional data handling.
      */
-    readonly subscriptions: Map<bigint, SubscribeRequest>;
+    readonly subscriptions: Map<bigint, any>;
     /**
      * Bidirectional track alias \<-\> subscription requestId mapping
      */
@@ -1052,6 +1116,10 @@ declare class MOQtailClient {
     onDatagramReceived?: (data: DatagramObject | DatagramStatus) => void;
     /** Invoked after enqueuing each outbound datagram object/status. */
     onDatagramSent?: (data: DatagramObject | DatagramStatus) => void;
+    /** Fired when an inbound PUBLISH control message is received. */
+    onPeerPublish?: (msg: Publish, stream: ReadableStream<MoqtObject>) => void;
+    /** Fired when an inbound SUBSCRIBE_NAMESPACE control message is received. */
+    onPeerSubscribeNamespace?: (msg: SubscribeNamespace) => void;
     /**
      * Stream of all received MoqtObjects from datagrams across all tracks
      * Consumer should filter by fullTrackName as needed
@@ -1060,6 +1128,10 @@ declare class MOQtailClient {
      * use subscribeToTrackDatagrams() instead
      */
     readonly receivedDatagramObjects: ReadableStream<MoqtObject>;
+    /**
+     * Generates a safe, sequential local request ID for tracking pushed/incoming tracks.
+     */
+    allocatePseudoRequestId(): bigint;
     /**
      * Gets the current server setup configuration.
      *
@@ -1520,6 +1592,20 @@ declare class MOQtailClient {
      * ```
      */
     fetchCancel(requestId: bigint | number): Promise<void>;
+    /**
+     * Proactively push a track to the relay/peer.
+     */
+    publish(fullTrackName: FullTrackName, forward: boolean, trackAlias: bigint, parameters?: VersionSpecificParameters): Promise<PublishError | {
+        requestId: bigint;
+        trackAlias: bigint;
+    }>;
+    /**
+     * Registers an incoming PUBLISH announcement as a valid data receiver.
+     * This prepares the client to ingest pushed data streams matching the published alias.
+     * * @param msg - The incoming Publish control message
+     * @returns - A stream of MoqtObjects being pushed by the publisher
+     */
+    acceptPushedTrack(msg: Publish): ReadableStream<MoqtObject>;
     /**
      * Declare (publish) a track namespace to the peer so subscribers using matching prefixes (via {@link MOQtailClient.subscribeNamespace})
      * can discover and begin subscribing/fetching its tracks.
@@ -1624,7 +1710,7 @@ declare class MOQtailClient {
      * ```
      */
     publishNamespaceCancel(msg: PublishNamespaceCancel): Promise<void>;
-    subscribeNamespace(msg: SubscribeNamespace): Promise<void>;
+    subscribeNamespace(trackNamespacePrefix: Tuple, parameters?: VersionSpecificParameters): Promise<SubscribeNamespaceError | SubscribeNamespaceOk>;
     unsubscribeNamespace(msg: UnsubscribeNamespace): Promise<void>;
 }
 
@@ -1662,4 +1748,4 @@ declare class RecvStream {
     static new(readStream: ReadableStream<Uint8Array>, partialDataTimeout?: number, onDataReceived?: (data: SubgroupObject | SubgroupHeader | FetchObject | FetchHeader) => void): Promise<RecvStream>;
 }
 
-export { ControlStream, type FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, type LiveObjectSource, LiveTrackSource, MOQtailClient, type MOQtailClientOptions, type MOQtailRequest, MemoryObjectCache, type ObjectCache, type PastObjectSource, PublishNamespaceRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, type SubscribeOptions, SubscribePublication, SubscribeRequest, type SubscribeUpdateOptions, type SwitchOptions, type Track, type TrackSource };
+export { ControlStream, type FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, type LiveObjectSource, LiveTrackSource, MOQtailClient, type MOQtailClientOptions, type MOQtailRequest, MemoryObjectCache, type ObjectCache, type PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, type SubscribeOptions, SubscribePublication, SubscribeRequest, type SubscribeUpdateOptions, type SwitchOptions, type Track, type TrackSource };

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
-import { w as ControlMessage, U as SubscribeOk, Q as SubscribeError, S as Subscribe, V as SubscribeUpdate, q as PublishDoneStatusCode, x as Fetch, b as PublishNamespaceOk, a as PublishNamespaceError, P as PublishNamespace, A as FetchOk, z as FetchError, J as SubscribeNamespaceOk, I as SubscribeNamespaceError, H as SubscribeNamespace, a5 as SetupParameters, G as GroupOrder, F as FilterType, a7 as VersionSpecificParameters, h as FetchType, a2 as RequestIdMap, Z as PublishNamespaceDone, B as GoAway, a1 as SubgroupHeader, a0 as FetchHeader, E as ServerSetup, c as PublishNamespaceCancel, $ as UnsubscribeNamespace, a3 as Header } from '../version_parameter-CgEPNuUt.js';
-import { n as MoqtObject, L as Location, m as FullTrackName, f as ObjectForwardingPreference, K as KeyValuePair, D as DatagramObject, h as DatagramStatus, c as Tuple, o as SubgroupObject, j as FetchObject } from '../byte_buffer-BOK6VPTF.js';
+import { n as MoqtObject, L as Location, m as FullTrackName, f as ObjectForwardingPreference, K as KeyValuePair, D as DatagramObject, h as DatagramStatus, c as Tuple, o as SubgroupObject, j as FetchObject } from '../byte_buffer-BM4uNj4n.js';
+import { w as ControlMessage, S as Subscribe, q as PublishDoneStatusCode, V as SubscribeUpdate, x as Fetch, L as Publish, b as PublishNamespaceOk, a as PublishNamespaceError, P as PublishNamespace, A as FetchOk, z as FetchError, U as SubscribeOk, Q as SubscribeError, J as SubscribeNamespaceOk, I as SubscribeNamespaceError, H as SubscribeNamespace, O as PublishOk, N as PublishError, a5 as SetupParameters, G as GroupOrder, F as FilterType, a7 as VersionSpecificParameters, h as FetchType, a2 as RequestIdMap, Z as PublishNamespaceDone, B as GoAway, a1 as SubgroupHeader, a0 as FetchHeader, E as ServerSetup, c as PublishNamespaceCancel, $ as UnsubscribeNamespace, a3 as Header } from '../version_parameter-f75NkWiO.js';
 
 /**
  * Copyright 2025 The MOQtail Authors
@@ -263,48 +263,6 @@ type Track = {
     trackAlias?: bigint;
 };
 
-/**
- * Copyright 2025 The MOQtail Authors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeError> {
-    #private;
-    requestId: bigint;
-    fullTrackName: FullTrackName;
-    isCanceled: boolean;
-    startLocation: Location | undefined;
-    endGroup: bigint | undefined;
-    priority: number;
-    forward: boolean;
-    subscribeParameters: KeyValuePair[];
-    largestLocation: Location | undefined;
-    streamsAccepted: bigint;
-    expectedStreams: bigint | undefined;
-    readonly controller: ReadableStreamDefaultController<MoqtObject>;
-    readonly stream: ReadableStream<MoqtObject>;
-    constructor(msg: Subscribe);
-    update(msg: SubscribeUpdate): void;
-    switch(newTrackName: FullTrackName, newParameters: KeyValuePair[]): void;
-    unsubscribe(): void;
-    resolve(value: SubscribeOk | SubscribeError | PromiseLike<SubscribeOk | SubscribeError>): void;
-    reject(reason?: any): void;
-    then<TResult1 = SubscribeOk | SubscribeError, TResult2 = never>(onfulfilled?: ((value: SubscribeOk | SubscribeError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
-    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeOk | SubscribeError | TResult>;
-    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeOk | SubscribeError>;
-}
-
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -390,6 +348,56 @@ declare class FetchPublication {
     publish(): Promise<void>;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @public
+ * Manages the proactive publication of MOQT objects from a publisher to the relay.
+ * Handles live object streaming and stream management.
+ */
+declare class PublishPublication {
+    #private;
+    private readonly client;
+    readonly track: Track;
+    private readonly publishMsg;
+    /**
+     * The latest location that was published to the relay.
+     */
+    latestLocation: Location | undefined;
+    /**
+     * Creates a new PublishPublication instance.
+     * @param client - The MOQT client managing the connection.
+     * @param track - The track being proactively published.
+     * @param publishMsg - The publish message that initiated this session.
+     */
+    constructor(client: MOQtailClient, track: Track, publishMsg: Publish);
+    /**
+     * Cancels the publication and cleans up resources.
+     * Removes the publication from the client's publication map.
+     */
+    cancel(): void;
+    /**
+     * Publishes MOQT objects to the relay as they become available.
+     * Handles stream creation, object writing, and stream closure.
+     * @throws :{@link InternalError} If the track does not support live content.
+     */
+    publishToRelay(): Promise<void>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -454,6 +462,48 @@ declare class FetchRequest implements PromiseLike<FetchOk | FetchError> {
     finally(onfinally?: (() => void) | undefined | null): Promise<FetchOk | FetchError>;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class SubscribeRequest implements PromiseLike<SubscribeOk | SubscribeError> {
+    #private;
+    requestId: bigint;
+    fullTrackName: FullTrackName;
+    isCanceled: boolean;
+    startLocation: Location | undefined;
+    endGroup: bigint | undefined;
+    priority: number;
+    forward: boolean;
+    subscribeParameters: KeyValuePair[];
+    largestLocation: Location | undefined;
+    streamsAccepted: bigint;
+    expectedStreams: bigint | undefined;
+    readonly controller: ReadableStreamDefaultController<MoqtObject>;
+    readonly stream: ReadableStream<MoqtObject>;
+    constructor(msg: Subscribe);
+    update(msg: SubscribeUpdate): void;
+    switch(newTrackName: FullTrackName, newParameters: KeyValuePair[]): void;
+    unsubscribe(): void;
+    resolve(value: SubscribeOk | SubscribeError | PromiseLike<SubscribeOk | SubscribeError>): void;
+    reject(reason?: any): void;
+    then<TResult1 = SubscribeOk | SubscribeError, TResult2 = never>(onfulfilled?: ((value: SubscribeOk | SubscribeError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<SubscribeOk | SubscribeError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeOk | SubscribeError>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -476,7 +526,7 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
     private _resolve;
     private _reject;
     private promise;
-    constructor(requestId: bigint, message: SubscribeNamespace);
+    constructor(msg: SubscribeNamespace);
     resolve(value: SubscribeNamespaceOk | SubscribeNamespaceError | PromiseLike<SubscribeNamespaceOk | SubscribeNamespaceError>): void;
     reject(reason?: any): void;
     then<TResult1 = SubscribeNamespaceOk | SubscribeNamespaceError, TResult2 = never>(onfulfilled?: ((value: SubscribeNamespaceOk | SubscribeNamespaceError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
@@ -484,6 +534,36 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
     finally(onfinally?: (() => void) | undefined | null): Promise<SubscribeNamespaceOk | SubscribeNamespaceError>;
 }
 
+/**
+ * Copyright 2025 The MOQtail Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class PublishRequest implements PromiseLike<PublishOk | PublishError> {
+    readonly requestId: bigint;
+    readonly message: Publish;
+    private _resolve;
+    private _reject;
+    private promise;
+    constructor(msg: Publish);
+    resolve(value: PublishOk | PublishError | PromiseLike<PublishOk | PublishError>): void;
+    reject(reason?: any): void;
+    then<TResult1 = PublishOk | PublishError, TResult2 = never>(onfulfilled?: ((value: PublishOk | PublishError) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): PromiseLike<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | undefined | null): Promise<PublishOk | PublishError | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<PublishOk | PublishError>;
+}
+
 /**
  * Copyright 2025 The MOQtail Authors
  *
@@ -530,7 +610,7 @@ declare class SubscribeNamespaceRequest implements PromiseLike<SubscribeNamespac
  * }
  * ```
  */
-type MOQtailRequest = PublishNamespaceRequest | SubscribeNamespaceRequest | FetchRequest | SubscribeRequest;
+type MOQtailRequest = PublishRequest | PublishNamespaceRequest | SubscribeNamespaceRequest | FetchRequest | SubscribeRequest;
 /**
  * Options for {@link MOQtailClient.new} controlling connection target, protocol negotiation, timeouts,
  * and lifecycle callbacks.
@@ -572,7 +652,7 @@ type MOQtailClientOptions = {
     /** Control stream read timeout in milliseconds. */
     controlStreamTimeoutMs?: number;
     /** If true, enables datagram support for the session. */
-    enableDatagrams: boolean;
+    enableDatagrams?: boolean;
     /** callbacks for observability and logging purposes: */
     callbacks?: {
         /** Called after a control message is successfully written to the {@link ControlStream}. */
@@ -864,22 +944,6 @@ declare class RecvDatagramStream {
     releaseLock(): void;
 }
 
-/**
- * Copyright 2025 The MOQtail Authors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
 /**
  * @public
  * Represents a Media Over QUIC Transport (MOQT) client session.
@@ -954,12 +1018,12 @@ declare class MOQtailClient {
      * Active publications (SUBSCRIBE or FETCH) keyed by requestId to manage object stream controllers and lifecycle.
      * Subset / specialization view of `requests`.
      */
-    readonly publications: Map<bigint, SubscribePublication | FetchPublication>;
+    readonly publications: Map<bigint, SubscribePublication | FetchPublication | PublishPublication>;
     /**
      * Active SUBSCRIBE request wrappers keyed by track alias for rapid alias -\> subscription resolution during
      * incoming unidirectional data handling.
      */
-    readonly subscriptions: Map<bigint, SubscribeRequest>;
+    readonly subscriptions: Map<bigint, any>;
     /**
      * Bidirectional track alias \<-\> subscription requestId mapping
      */
@@ -1052,6 +1116,10 @@ declare class MOQtailClient {
     onDatagramReceived?: (data: DatagramObject | DatagramStatus) => void;
     /** Invoked after enqueuing each outbound datagram object/status. */
     onDatagramSent?: (data: DatagramObject | DatagramStatus) => void;
+    /** Fired when an inbound PUBLISH control message is received. */
+    onPeerPublish?: (msg: Publish, stream: ReadableStream<MoqtObject>) => void;
+    /** Fired when an inbound SUBSCRIBE_NAMESPACE control message is received. */
+    onPeerSubscribeNamespace?: (msg: SubscribeNamespace) => void;
     /**
      * Stream of all received MoqtObjects from datagrams across all tracks
      * Consumer should filter by fullTrackName as needed
@@ -1060,6 +1128,10 @@ declare class MOQtailClient {
      * use subscribeToTrackDatagrams() instead
      */
     readonly receivedDatagramObjects: ReadableStream<MoqtObject>;
+    /**
+     * Generates a safe, sequential local request ID for tracking pushed/incoming tracks.
+     */
+    allocatePseudoRequestId(): bigint;
     /**
      * Gets the current server setup configuration.
      *
@@ -1520,6 +1592,20 @@ declare class MOQtailClient {
      * ```
      */
     fetchCancel(requestId: bigint | number): Promise<void>;
+    /**
+     * Proactively push a track to the relay/peer.
+     */
+    publish(fullTrackName: FullTrackName, forward: boolean, trackAlias: bigint, parameters?: VersionSpecificParameters): Promise<PublishError | {
+        requestId: bigint;
+        trackAlias: bigint;
+    }>;
+    /**
+     * Registers an incoming PUBLISH announcement as a valid data receiver.
+     * This prepares the client to ingest pushed data streams matching the published alias.
+     * * @param msg - The incoming Publish control message
+     * @returns - A stream of MoqtObjects being pushed by the publisher
+     */
+    acceptPushedTrack(msg: Publish): ReadableStream<MoqtObject>;
     /**
      * Declare (publish) a track namespace to the peer so subscribers using matching prefixes (via {@link MOQtailClient.subscribeNamespace})
      * can discover and begin subscribing/fetching its tracks.
@@ -1624,7 +1710,7 @@ declare class MOQtailClient {
      * ```
      */
     publishNamespaceCancel(msg: PublishNamespaceCancel): Promise<void>;
-    subscribeNamespace(msg: SubscribeNamespace): Promise<void>;
+    subscribeNamespace(trackNamespacePrefix: Tuple, parameters?: VersionSpecificParameters): Promise<SubscribeNamespaceError | SubscribeNamespaceOk>;
     unsubscribeNamespace(msg: UnsubscribeNamespace): Promise<void>;
 }
 
@@ -1662,4 +1748,4 @@ declare class RecvStream {
     static new(readStream: ReadableStream<Uint8Array>, partialDataTimeout?: number, onDataReceived?: (data: SubgroupObject | SubgroupHeader | FetchObject | FetchHeader) => void): Promise<RecvStream>;
 }
 
-export { ControlStream, type FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, type LiveObjectSource, LiveTrackSource, MOQtailClient, type MOQtailClientOptions, type MOQtailRequest, MemoryObjectCache, type ObjectCache, type PastObjectSource, PublishNamespaceRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, type SubscribeOptions, SubscribePublication, SubscribeRequest, type SubscribeUpdateOptions, type SwitchOptions, type Track, type TrackSource };
+export { ControlStream, type FetchOptions, FetchPublication, FetchRequest, HybridTrackSource, type LiveObjectSource, LiveTrackSource, MOQtailClient, type MOQtailClientOptions, type MOQtailRequest, MemoryObjectCache, type ObjectCache, type PastObjectSource, PublishNamespaceRequest, PublishPublication, PublishRequest, RecvDatagramStream, RecvStream, RingBufferObjectCache, SendDatagramStream, SendStream, StaticTrackSource, SubscribeNamespaceRequest, type SubscribeOptions, SubscribePublication, SubscribeRequest, type SubscribeUpdateOptions, type SwitchOptions, type Track, type TrackSource };