@roboflow/inference-sdk 0.1.7 → 0.1.9

package/dist/index.es.js

@@ -1,24 +1,24 @@
-var W = Object.defineProperty;
-var U = (o, e, t) => e in o ? W(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t;
-var p = (o, e, t) => U(o, typeof e != "symbol" ? e + "" : e, t);
-var b;
-const I = typeof process < "u" && ((b = process.env) != null && b.RF_API_BASE_URL) ? process.env.RF_API_BASE_URL : "https://api.roboflow.com", O = [
+var A = Object.defineProperty;
+var q = (r, e, t) => e in r ? A(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var l = (r, e, t) => q(r, typeof e != "symbol" ? e + "" : e, t);
+var L;
+const K = typeof process < "u" && ((L = process.env) != null && L.RF_API_BASE_URL) ? process.env.RF_API_BASE_URL : "https://api.roboflow.com", B = [
   "https://serverless.roboflow.com"
 ];
-class v {
+class E {
   /**
    * @private
    * Use InferenceHTTPClient.init() instead
    */
   constructor(e, t = "https://serverless.roboflow.com") {
-    p(this, "apiKey");
-    p(this, "serverUrl");
+    l(this, "apiKey");
+    l(this, "serverUrl");
     this.apiKey = e, this.serverUrl = t;
   }
   static init({ apiKey: e, serverUrl: t }) {
     if (!e)
       throw new Error("apiKey is required");
-    return new v(e, t);
+    return new E(e, t);
   }
   /**
    * Initialize a WebRTC worker pipeline
@@ -48,59 +48,61 @@ class v {
   async initializeWebrtcWorker({
     offer: e,
     workflowSpec: t,
-    workspaceName: r,
-    workflowId: a,
-    config: n = {}
+    workspaceName: n,
+    workflowId: o,
+    config: a = {}
   }) {
     if (!e || !e.sdp || !e.type)
       throw new Error("offer with sdp and type is required");
-    const i = !!t, s = !!(r && a);
-    if (!i && !s)
+    const i = !!t, u = !!(n && o);
+    if (!i && !u)
       throw new Error("Either workflowSpec OR (workspaceName + workflowId) is required");
-    if (i && s)
+    if (i && u)
       throw new Error("Provide either workflowSpec OR (workspaceName + workflowId), not both");
     const {
-      imageInputName: l = "image",
-      streamOutputNames: c = [],
+      imageInputName: c = "image",
+      streamOutputNames: s = [],
       dataOutputNames: h = ["string"],
       threadPoolWorkers: y = 4,
       workflowsParameters: f = {},
       iceServers: d,
-      processingTimeout: S,
-      requestedPlan: _,
-      requestedRegion: g
-    } = n, R = {
+      processingTimeout: m,
+      requestedPlan: S,
+      requestedRegion: v,
+      realtimeProcessing: _ = !0,
+      rtspUrl: k
+    } = a, w = {
       type: "WorkflowConfiguration",
-      image_input_name: l,
+      image_input_name: c,
       workflows_parameters: f,
       workflows_thread_pool_workers: y,
       cancel_thread_pool_tasks_on_exit: !0,
       video_metadata_input_name: "video_metadata"
     };
-    i ? R.workflow_specification = t : (R.workspace_name = r, R.workflow_id = a);
-    const m = {
-      workflow_configuration: R,
+    i ? w.workflow_specification = t : (w.workspace_name = n, w.workflow_id = o);
+    const p = {
+      workflow_configuration: w,
       api_key: this.apiKey,
-      webrtc_realtime_processing: !0,
+      webrtc_realtime_processing: _,
       webrtc_offer: {
         sdp: e.sdp,
         type: e.type
       },
       webrtc_config: d ? { iceServers: d } : null,
-      stream_output: c,
+      stream_output: s,
       data_output: h
     };
-    S !== void 0 && (m.processing_timeout = S), _ !== void 0 && (m.requested_plan = _), g !== void 0 && (m.requested_region = g), console.trace("payload", m);
-    const u = await fetch(`${this.serverUrl}/initialise_webrtc_worker`, {
+    m !== void 0 && (p.processing_timeout = m), S !== void 0 && (p.requested_plan = S), v !== void 0 && (p.requested_region = v), k && (p.rtsp_url = k);
+    const R = await fetch(`${this.serverUrl}/initialise_webrtc_worker`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(m)
+      body: JSON.stringify(p)
     });
-    if (!u.ok) {
-      const w = await u.text().catch(() => "");
-      throw new Error(`initialise_webrtc_worker failed (${u.status}): ${w}`);
+    if (!R.ok) {
+      const b = await R.text().catch(() => "");
+      throw new Error(`initialise_webrtc_worker failed (${R.status}): ${b}`);
     }
-    return await u.json();
+    return await R.json();
   }
   async terminatePipeline({ pipelineId: e }) {
     if (!e)
@@ -130,11 +132,11 @@ class v {
    * ```
    */
   async fetchTurnConfig() {
-    if (!O.includes(this.serverUrl))
+    if (!B.includes(this.serverUrl))
       return null;
     try {
       const e = await fetch(
-        `${I}/webrtc_turn_config?api_key=${this.apiKey}`,
+        `${K}/webrtc_turn_config?api_key=${this.apiKey}`,
         {
           method: "GET",
           headers: { "Content-Type": "application/json" }
@@ -143,26 +145,26 @@ class v {
       if (!e.ok)
         return console.warn(`[RFWebRTC] Failed to fetch TURN config (${e.status}), using defaults`), null;
       const t = await e.json();
-      let r;
+      let n;
       if (Array.isArray(t))
-        r = t;
+        n = t;
       else if (t.iceServers && Array.isArray(t.iceServers))
-        r = t.iceServers;
+        n = t.iceServers;
       else if (t.urls)
-        r = [t];
+        n = [t];
       else
         return console.warn("[RFWebRTC] Invalid TURN config format, using defaults"), null;
-      return r.map((n) => ({
-        urls: Array.isArray(n.urls) ? n.urls : [n.urls],
-        username: n.username,
-        credential: n.credential
+      return n.map((a) => ({
+        urls: Array.isArray(a.urls) ? a.urls : [a.urls],
+        username: a.username,
+        credential: a.credential
       }));
     } catch (e) {
       return console.warn("[RFWebRTC] Error fetching TURN config:", e), null;
     }
   }
 }
-const $ = {
+const ne = {
   /**
    * Create a connector that uses API key directly
    *
@@ -181,36 +183,38 @@ const $ = {
    * const answer = await connector.connectWrtc(offer, wrtcParams);
    * ```
    */
-  withApiKey(o, e = {}) {
+  withApiKey(r, e = {}) {
     const { serverUrl: t } = e;
     typeof window < "u" && console.warn(
       "[Security Warning] Using API key directly in browser will expose it. Use connectors.withProxyUrl() for production. See: https://docs.roboflow.com/api-reference/authentication#securing-your-api-key"
     );
-    const r = v.init({ apiKey: o, serverUrl: t });
+    const n = E.init({ apiKey: r, serverUrl: t });
     return {
-      connectWrtc: async (a, n) => (console.log("wrtcParams", n), await r.initializeWebrtcWorker({
-        offer: a,
-        workflowSpec: n.workflowSpec,
-        workspaceName: n.workspaceName,
-        workflowId: n.workflowId,
+      connectWrtc: async (o, a) => (console.debug("wrtcParams", a), await n.initializeWebrtcWorker({
+        offer: o,
+        workflowSpec: a.workflowSpec,
+        workspaceName: a.workspaceName,
+        workflowId: a.workflowId,
         config: {
-          imageInputName: n.imageInputName,
-          streamOutputNames: n.streamOutputNames,
-          dataOutputNames: n.dataOutputNames,
-          threadPoolWorkers: n.threadPoolWorkers,
-          workflowsParameters: n.workflowsParameters,
-          iceServers: n.iceServers,
-          processingTimeout: n.processingTimeout,
-          requestedPlan: n.requestedPlan,
-          requestedRegion: n.requestedRegion
+          imageInputName: a.imageInputName,
+          streamOutputNames: a.streamOutputNames,
+          dataOutputNames: a.dataOutputNames,
+          threadPoolWorkers: a.threadPoolWorkers,
+          workflowsParameters: a.workflowsParameters,
+          iceServers: a.iceServers,
+          processingTimeout: a.processingTimeout,
+          requestedPlan: a.requestedPlan,
+          requestedRegion: a.requestedRegion,
+          realtimeProcessing: a.realtimeProcessing,
+          rtspUrl: a.rtspUrl
         }
       })),
       /**
        * Fetch TURN server configuration for improved WebRTC connectivity
        */
-      getIceServers: async () => await r.fetchTurnConfig(),
+      getIceServers: async () => await n.fetchTurnConfig(),
       // Store apiKey for cleanup
-      _apiKey: o,
+      _apiKey: r,
       _serverUrl: t
     };
   },
@@ -277,23 +281,23 @@ const $ = {
    * });
    * ```
    */
-  withProxyUrl(o, e = {}) {
+  withProxyUrl(r, e = {}) {
     const { turnConfigUrl: t } = e;
     return {
-      connectWrtc: async (r, a) => {
-        const n = await fetch(o, {
+      connectWrtc: async (n, o) => {
+        const a = await fetch(r, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
-            offer: r,
-            wrtcParams: a
+            offer: n,
+            wrtcParams: o
           })
         });
-        if (!n.ok) {
-          const i = await n.text().catch(() => "");
-          throw new Error(`Proxy request failed (${n.status}): ${i}`);
+        if (!a.ok) {
+          const i = await a.text().catch(() => "");
+          throw new Error(`Proxy request failed (${a.status}): ${i}`);
         }
-        return await n.json();
+        return await a.json();
       },
       /**
        * Fetch TURN server configuration from the proxy backend
@@ -301,60 +305,100 @@ const $ = {
        */
       getIceServers: t ? async () => {
         try {
-          const r = await fetch(t, {
+          const n = await fetch(t, {
             method: "GET",
             headers: { "Content-Type": "application/json" }
           });
-          return r.ok ? (await r.json()).iceServers || null : (console.warn(`[RFWebRTC] Failed to fetch TURN config from proxy (${r.status})`), null);
-        } catch (r) {
-          return console.warn("[RFWebRTC] Error fetching TURN config from proxy:", r), null;
+          return n.ok ? (await n.json()).iceServers || null : (console.warn(`[RFWebRTC] Failed to fetch TURN config from proxy (${n.status})`), null);
+        } catch (n) {
+          return console.warn("[RFWebRTC] Error fetching TURN config from proxy:", n), null;
         }
       } : void 0
     };
   }
 };
-async function P(o = { video: !0 }) {
+async function j(r = { video: !0 }) {
   try {
-    console.log("[RFStreams] requesting with", o);
-    const e = await navigator.mediaDevices.getUserMedia(o);
+    console.log("[RFStreams] requesting with", r);
+    const e = await navigator.mediaDevices.getUserMedia(r);
     return console.log("[RFStreams] got stream", e.getVideoTracks().map((t) => ({ id: t.id, label: t.label }))), e;
   } catch (e) {
     console.warn("[RFStreams] failed, falling back", e);
     const t = await navigator.mediaDevices.getUserMedia({ video: !0, audio: !1 });
-    return console.log("[RFStreams] fallback stream", t.getVideoTracks().map((r) => ({ id: r.id, label: r.label }))), t;
+    return console.log("[RFStreams] fallback stream", t.getVideoTracks().map((n) => ({ id: n.id, label: n.label }))), t;
   }
 }
-function C(o) {
-  o && (o.getTracks().forEach((e) => e.stop()), console.log("[RFStreams] Stream stopped"));
+function P(r) {
+  r && (r.getTracks().forEach((e) => e.stop()), console.log("[RFStreams] Stream stopped"));
 }
-const B = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const ae = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  stopStream: C,
-  useCamera: P
-}, Symbol.toStringTag, { value: "Module" })), N = 12;
-class T {
+  stopStream: P,
+  useCamera: j
+}, Symbol.toStringTag, { value: "Module" })), T = 49152, V = 262144, $ = 10;
+function M(r) {
+  return new Promise((e) => setTimeout(e, r));
+}
+class O {
+  constructor(e, t) {
+    l(this, "file");
+    l(this, "channel");
+    l(this, "totalChunks");
+    l(this, "cancelled", !1);
+    this.file = e, this.channel = t, this.totalChunks = Math.ceil(e.size / T);
+  }
+  /**
+   * Cancel the upload
+   */
+  cancel() {
+    this.cancelled = !0;
+  }
+  /**
+   * Upload the file in chunks with backpressure handling
+   *
+   * @param onProgress - Optional callback for progress updates (bytesUploaded, totalBytes)
+   */
+  async upload(e) {
+    const t = this.file.size;
+    for (let n = 0; n < this.totalChunks; n++) {
+      if (this.cancelled)
+        throw new Error("Upload cancelled");
+      if (this.channel.readyState !== "open")
+        throw new Error("Video upload interrupted");
+      const o = n * T, a = Math.min(o + T, t), i = this.file.slice(o, a), u = new Uint8Array(await i.arrayBuffer()), c = new ArrayBuffer(8 + u.length), s = new DataView(c);
+      for (s.setUint32(0, n, !0), s.setUint32(4, this.totalChunks, !0), new Uint8Array(c, 8).set(u); this.channel.bufferedAmount > V; ) {
+        if (this.channel.readyState !== "open")
+          throw new Error("Video upload interrupted");
+        await M($);
+      }
+      this.channel.send(c), e && e(a, t);
+    }
+  }
+}
+const z = 12;
+class D {
   constructor() {
-    p(this, "pendingFrames", /* @__PURE__ */ new Map());
+    l(this, "pendingFrames", /* @__PURE__ */ new Map());
   }
   /**
    * Process an incoming chunk and return the complete message if all chunks received
    */
-  processChunk(e, t, r, a) {
-    if (r === 1)
-      return a;
+  processChunk(e, t, n, o) {
+    if (n === 1)
+      return o;
     this.pendingFrames.has(e) || this.pendingFrames.set(e, {
       chunks: /* @__PURE__ */ new Map(),
-      totalChunks: r
+      totalChunks: n
     });
-    const n = this.pendingFrames.get(e);
-    if (n.chunks.set(t, a), n.chunks.size === r) {
-      const i = Array.from(n.chunks.values()).reduce((c, h) => c + h.length, 0), s = new Uint8Array(i);
-      let l = 0;
-      for (let c = 0; c < r; c++) {
-        const h = n.chunks.get(c);
-        s.set(h, l), l += h.length;
+    const a = this.pendingFrames.get(e);
+    if (a.chunks.set(t, o), a.chunks.size === n) {
+      const i = Array.from(a.chunks.values()).reduce((s, h) => s + h.length, 0), u = new Uint8Array(i);
+      let c = 0;
+      for (let s = 0; s < n; s++) {
+        const h = a.chunks.get(s);
+        u.set(h, c), c += h.length;
       }
-      return this.pendingFrames.delete(e), s;
+      return this.pendingFrames.delete(e), u;
     }
     return null;
   }
@@ -365,113 +409,139 @@ class T {
     this.pendingFrames.clear();
   }
 }
-function E(o) {
-  const e = new DataView(o), t = e.getUint32(0, !0), r = e.getUint32(4, !0), a = e.getUint32(8, !0), n = new Uint8Array(o, N);
-  return { frameId: t, chunkIndex: r, totalChunks: a, payload: n };
+function N(r) {
+  const e = new DataView(r), t = e.getUint32(0, !0), n = e.getUint32(4, !0), o = e.getUint32(8, !0), a = new Uint8Array(r, z);
+  return { frameId: t, chunkIndex: n, totalChunks: o, payload: a };
 }
-async function L(o, e = 6e3) {
-  if (o.iceGatheringState === "complete") return;
+async function H(r, e = 6e3) {
+  if (r.iceGatheringState === "complete") return;
   let t = !1;
-  const r = (a) => {
-    a.candidate && a.candidate.type === "srflx" && (t = !0);
+  const n = (o) => {
+    o.candidate && o.candidate.type === "srflx" && (t = !0);
   };
-  o.addEventListener("icecandidate", r);
+  r.addEventListener("icecandidate", n);
   try {
     await Promise.race([
-      new Promise((a) => {
-        const n = () => {
-          o.iceGatheringState === "complete" && (o.removeEventListener("icegatheringstatechange", n), a());
+      new Promise((o) => {
+        const a = () => {
+          r.iceGatheringState === "complete" && (r.removeEventListener("icegatheringstatechange", a), o());
         };
-        o.addEventListener("icegatheringstatechange", n);
+        r.addEventListener("icegatheringstatechange", a);
       }),
-      new Promise((a, n) => {
+      new Promise((o, a) => {
         setTimeout(() => {
-          t ? a() : (console.error("[ICE] timeout with NO srflx candidate! Connection may fail."), n(new Error("ICE gathering timeout without srflx candidate")));
+          t ? o() : (console.error("[ICE] timeout with NO srflx candidate! Connection may fail."), a(new Error("ICE gathering timeout without srflx candidate")));
         }, e);
       })
     ]);
   } finally {
-    o.removeEventListener("icecandidate", r);
+    r.removeEventListener("icecandidate", n);
   }
 }
-function x(o) {
+function G(r) {
   return new Promise((e) => {
-    o.addEventListener("track", (t) => {
+    r.addEventListener("track", (t) => {
       t.streams && t.streams[0] && e(t.streams[0]);
     });
   });
 }
-const D = [
+const J = [
   { urls: ["stun:stun.l.google.com:19302"] }
 ];
-async function A(o, e) {
-  const t = e ?? D, r = new RTCPeerConnection({
-    iceServers: t
+async function Z(r, e, t, n) {
+  if ([!!r, !!e, !!n].filter(Boolean).length !== 1)
+    throw new Error("Exactly one of localStream, file, or rtspUrl must be provided");
+  const c = t ?? J, s = new RTCPeerConnection({
+    iceServers: c
   });
   try {
-    r.addTransceiver("video", { direction: "recvonly" });
-  } catch (s) {
-    console.warn("[RFWebRTC] Could not add transceiver:", s);
+    s.addTransceiver("video", { direction: "recvonly" });
+  } catch (m) {
+    console.warn("[RFWebRTC] Could not add transceiver:", m);
   }
-  o.getVideoTracks().forEach((s) => {
+  r && r.getVideoTracks().forEach((m) => {
     try {
-      s.contentHint = "detail";
+      m.contentHint = "detail";
     } catch {
     }
-    r.addTrack(s, o);
+    s.addTrack(m, r);
   });
-  const a = x(r), n = r.createDataChannel("roboflow-control", {
+  const h = G(s), y = s.createDataChannel("inference", {
     ordered: !0
-  }), i = await r.createOffer();
-  return await r.setLocalDescription(i), await L(r), {
-    pc: r,
-    offer: r.localDescription,
-    remoteStreamPromise: a,
-    dataChannel: n
+  });
+  let f;
+  e && (f = s.createDataChannel("video_upload"));
+  const d = await s.createOffer();
+  return await s.setLocalDescription(d), await H(s), {
+    pc: s,
+    offer: s.localDescription,
+    remoteStreamPromise: h,
+    dataChannel: y,
+    uploadChannel: f
   };
 }
-async function q(o) {
-  const e = o.getSenders().find((r) => r.track && r.track.kind === "video");
+async function Q(r) {
+  const e = r.getSenders().find((n) => n.track && n.track.kind === "video");
   if (!e) return;
   const t = e.getParameters();
   t.encodings = t.encodings || [{}], t.encodings[0].scaleResolutionDownBy = 1;
   try {
     await e.setParameters(t);
-  } catch (r) {
-    console.warn("[RFWebRTC] Failed to set encoding parameters:", r);
+  } catch (n) {
+    console.warn("[RFWebRTC] Failed to set encoding parameters:", n);
   }
 }
-class F {
+function X(r, e = 3e4) {
+  return new Promise((t, n) => {
+    if (r.readyState === "open") {
+      t();
+      return;
+    }
+    const o = () => {
+      r.removeEventListener("open", o), r.removeEventListener("error", a), clearTimeout(i), t();
+    }, a = () => {
+      r.removeEventListener("open", o), r.removeEventListener("error", a), clearTimeout(i), n(new Error("Datachannel error"));
+    }, i = setTimeout(() => {
+      r.removeEventListener("open", o), r.removeEventListener("error", a), n(new Error("Datachannel open timeout"));
+    }, e);
+    r.addEventListener("open", o), r.addEventListener("error", a);
+  });
+}
+class x {
   /** @private */
-  constructor(e, t, r, a, n, i, s) {
-    p(this, "pc");
-    p(this, "_localStream");
-    p(this, "remoteStreamPromise");
-    p(this, "pipelineId");
-    p(this, "apiKey");
-    p(this, "dataChannel");
-    p(this, "reassembler");
-    this.pc = e, this._localStream = t, this.remoteStreamPromise = r, this.pipelineId = a, this.apiKey = n, this.dataChannel = i, this.reassembler = new T(), this.dataChannel.binaryType = "arraybuffer", s && (this.dataChannel.addEventListener("open", () => {
-    }), this.dataChannel.addEventListener("message", (l) => {
+  constructor(e, t, n, o, a, i) {
+    l(this, "pc");
+    l(this, "_localStream");
+    l(this, "remoteStreamPromise");
+    l(this, "pipelineId");
+    l(this, "apiKey");
+    l(this, "dataChannel");
+    l(this, "reassembler");
+    l(this, "uploadChannel");
+    l(this, "uploader");
+    l(this, "onComplete");
+    this.pc = e, this._localStream = i == null ? void 0 : i.localStream, this.remoteStreamPromise = t, this.pipelineId = n, this.apiKey = o, this.dataChannel = a, this.reassembler = new D(), this.uploadChannel = i == null ? void 0 : i.uploadChannel, this.onComplete = i == null ? void 0 : i.onComplete, this.dataChannel.binaryType = "arraybuffer";
+    const u = i == null ? void 0 : i.onData;
+    u && (this.dataChannel.addEventListener("message", (c) => {
       try {
-        if (l.data instanceof ArrayBuffer) {
-          const { frameId: c, chunkIndex: h, totalChunks: y, payload: f } = E(l.data), d = this.reassembler.processChunk(c, h, y, f);
+        if (c.data instanceof ArrayBuffer) {
+          const { frameId: s, chunkIndex: h, totalChunks: y, payload: f } = N(c.data), d = this.reassembler.processChunk(s, h, y, f);
           if (d) {
-            const _ = new TextDecoder("utf-8").decode(d), g = JSON.parse(_);
-            s(g);
+            const S = new TextDecoder("utf-8").decode(d), v = JSON.parse(S);
+            u(v);
           }
         } else {
-          const c = JSON.parse(l.data);
-          s(c);
+          const s = JSON.parse(c.data);
+          u(s);
         }
-      } catch (c) {
-        console.error("[RFWebRTC] Failed to parse data channel message:", c);
+      } catch (s) {
+        console.error("[RFWebRTC] Failed to parse data channel message:", s);
       }
-    }), this.dataChannel.addEventListener("error", (l) => {
-      console.error("[RFWebRTC] Data channel error:", l);
-    }), this.dataChannel.addEventListener("close", () => {
-      this.reassembler.clear();
-    }));
+    }), this.dataChannel.addEventListener("error", (c) => {
+      console.error("[RFWebRTC] Data channel error:", c);
+    })), this.dataChannel.addEventListener("close", () => {
+      this.reassembler.clear(), this.onComplete && this.onComplete();
+    });
   }
   /**
    * Get the remote stream (processed video from Roboflow)
@@ -491,13 +561,15 @@ class F {
   /**
    * Get the local stream (original camera)
    *
-   * @returns The local MediaStream
+   * @returns The local MediaStream, or undefined if using file upload mode
    *
    * @example
    * ```typescript
    * const conn = await useStream({ ... });
    * const localStream = conn.localStream();
-   * videoElement.srcObject = localStream;
+   * if (localStream) {
+   *   videoElement.srcObject = localStream;
+   * }
    * ```
    */
   localStream() {
@@ -507,7 +579,7 @@ class F {
    * Cleanup and close connection
    *
    * Terminates the pipeline on Roboflow, closes the peer connection,
-   * and stops the local media stream.
+   * and stops the local media stream (if applicable).
    *
    * @returns Promise that resolves when cleanup is complete
    *
@@ -519,7 +591,39 @@ class F {
    * ```
    */
   async cleanup() {
-    this.reassembler.clear(), this.pipelineId && this.apiKey && await v.init({ apiKey: this.apiKey }).terminatePipeline({ pipelineId: this.pipelineId }), this.pc && this.pc.connectionState !== "closed" && this.pc.close(), C(this._localStream);
+    if (this.uploader && this.uploader.cancel(), this.reassembler.clear(), this.pipelineId && this.apiKey)
+      try {
+        await E.init({ apiKey: this.apiKey }).terminatePipeline({ pipelineId: this.pipelineId });
+      } catch (e) {
+        console.warn("[RFWebRTC] Failed to terminate pipeline:", e);
+      }
+    this.pc && this.pc.connectionState !== "closed" && this.pc.close(), this._localStream && P(this._localStream);
+  }
+  /**
+   * Start uploading a file through the connection
+   *
+   * @param file - The file to upload
+   * @param onProgress - Optional callback for progress updates (bytesUploaded, totalBytes)
+   * @returns Promise that resolves when upload is complete
+   * @throws Error if no upload channel is available
+   *
+   * @example
+   * ```typescript
+   * await connection.startUpload(videoFile, (uploaded, total) => {
+   *   console.log(`Upload progress: ${(uploaded / total * 100).toFixed(1)}%`);
+   * });
+   * ```
+   */
+  async startUpload(e, t) {
+    if (!this.uploadChannel)
+      throw new Error("No upload channel available. This connection was not created for file uploads.");
+    await X(this.uploadChannel), this.uploader = new O(e, this.uploadChannel), await this.uploader.upload(t);
+  }
+  /**
+   * Cancel any ongoing file upload
+   */
+  cancelUpload() {
+    this.uploader && this.uploader.cancel();
   }
   /**
    * Reconfigure pipeline outputs at runtime
@@ -574,59 +678,136 @@ class F {
     }
   }
 }
-async function j({
-  source: o,
-  connector: e,
-  wrtcParams: t,
-  onData: r,
-  options: a = {}
+async function F({
+  source: r,
+  rtspUrl: e,
+  connector: t,
+  wrtcParams: n,
+  onData: o,
+  onComplete: a,
+  onFileUploadProgress: i,
+  options: u = {}
 }) {
-  var m;
-  if (!e || typeof e.connectWrtc != "function")
+  var W;
+  if (!t || typeof t.connectWrtc != "function")
     throw new Error("connector must have a connectWrtc method");
-  const n = o;
-  let i = t.iceServers;
-  if ((!i || i.length === 0) && e.getIceServers)
+  const c = !!e, s = !c && r instanceof File, h = !c && !s && r ? r : void 0, y = s ? r : void 0;
+  let f = n.iceServers;
+  if ((!f || f.length === 0) && t.getIceServers)
     try {
-      const u = await e.getIceServers();
-      u && u.length > 0 && (i = u, console.log("[RFWebRTC] Using TURN servers from connector"));
-    } catch (u) {
-      console.warn("[RFWebRTC] Failed to fetch TURN config, using defaults:", u);
+      const g = await t.getIceServers();
+      g && g.length > 0 && (f = g, console.log("[RFWebRTC] Using TURN servers from connector"));
+    } catch (g) {
+      console.warn("[RFWebRTC] Failed to fetch TURN config, using defaults:", g);
     }
-  const { pc: s, offer: l, remoteStreamPromise: c, dataChannel: h } = await A(
-    n,
-    i
-  ), y = {
-    ...t,
-    iceServers: i
-  }, f = await e.connectWrtc(
-    { sdp: l.sdp, type: l.type },
-    y
-  ), d = { sdp: f.sdp, type: f.type };
-  if (!(d != null && d.sdp) || !(d != null && d.type))
-    throw console.error("[RFWebRTC] Invalid answer from server:", f), new Error("connector.connectWrtc must return answer with sdp and type");
-  const S = ((m = f == null ? void 0 : f.context) == null ? void 0 : m.pipeline_id) || null;
-  await s.setRemoteDescription(d), await new Promise((u, k) => {
-    const w = () => {
-      s.connectionState === "connected" ? (s.removeEventListener("connectionstatechange", w), u()) : s.connectionState === "failed" && (s.removeEventListener("connectionstatechange", w), k(new Error("WebRTC connection failed")));
+  const { pc: d, offer: m, remoteStreamPromise: S, dataChannel: v, uploadChannel: _ } = await Z(
+    h,
+    y,
+    f,
+    e
+  ), k = {
+    ...n,
+    iceServers: f,
+    realtimeProcessing: n.realtimeProcessing ?? !s,
+    rtspUrl: e
+  }, w = await t.connectWrtc(
+    { sdp: m.sdp, type: m.type },
+    k
+  ), p = { sdp: w.sdp, type: w.type };
+  if (!(p != null && p.sdp) || !(p != null && p.type))
+    throw console.error("[RFWebRTC] Invalid answer from server:", w), new Error("connector.connectWrtc must return answer with sdp and type");
+  const R = ((W = w == null ? void 0 : w.context) == null ? void 0 : W.pipeline_id) || null;
+  await d.setRemoteDescription(p), await new Promise((g, I) => {
+    const C = () => {
+      d.connectionState === "connected" ? (d.removeEventListener("connectionstatechange", C), g()) : d.connectionState === "failed" && (d.removeEventListener("connectionstatechange", C), I(new Error("WebRTC connection failed")));
     };
-    s.addEventListener("connectionstatechange", w), w(), setTimeout(() => {
-      s.removeEventListener("connectionstatechange", w), k(new Error("WebRTC connection timeout after 30s"));
+    d.addEventListener("connectionstatechange", C), C(), setTimeout(() => {
+      d.removeEventListener("connectionstatechange", C), I(new Error("WebRTC connection timeout after 30s"));
     }, 3e4);
-  }), a.disableInputStreamDownscaling !== !1 && await q(s);
-  const g = e._apiKey || null;
-  return new F(s, n, c, S, g, h, r);
+  }), h && u.disableInputStreamDownscaling !== !1 && await Q(d);
+  const U = t._apiKey || null, b = new x(
+    d,
+    S,
+    R,
+    U,
+    v,
+    {
+      localStream: h,
+      uploadChannel: _,
+      onData: o,
+      onComplete: a
+    }
+  );
+  return y && _ && b.startUpload(y, i).catch((g) => {
+    console.error("[RFWebRTC] Upload error:", g);
+  }), b;
+}
+async function Y({
+  source: r,
+  connector: e,
+  wrtcParams: t,
+  onData: n,
+  options: o = {}
+}) {
+  if (r instanceof File)
+    throw new Error("useStream requires a MediaStream. Use useVideoFile for File uploads.");
+  return F({
+    source: r,
+    connector: e,
+    wrtcParams: t,
+    onData: n,
+    options: o
+  });
+}
+async function ee({
+  file: r,
+  connector: e,
+  wrtcParams: t,
+  onData: n,
+  onUploadProgress: o,
+  onComplete: a
+}) {
+  return F({
+    source: r,
+    connector: e,
+    wrtcParams: {
+      ...t,
+      realtimeProcessing: t.realtimeProcessing ?? !0
+    },
+    onData: n,
+    onComplete: a,
+    onFileUploadProgress: o
+  });
+}
+async function te({
+  rtspUrl: r,
+  connector: e,
+  wrtcParams: t,
+  onData: n
+}) {
+  if (!r.startsWith("rtsp://") && !r.startsWith("rtsps://"))
+    throw new Error("Invalid RTSP URL: must start with rtsp:// or rtsps://");
+  return F({
+    rtspUrl: r,
+    connector: e,
+    wrtcParams: t,
+    onData: n
+  });
 }
-const M = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const oe = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  ChunkReassembler: T,
-  RFWebRTCConnection: F,
-  parseBinaryHeader: E,
-  useStream: j
+  ChunkReassembler: D,
+  FileUploader: O,
+  RFWebRTCConnection: x,
+  parseBinaryHeader: N,
+  useRtspStream: te,
+  useStream: Y,
+  useVideoFile: ee
 }, Symbol.toStringTag, { value: "Module" }));
 export {
-  v as InferenceHTTPClient,
-  $ as connectors,
-  B as streams,
-  M as webrtc
+  E as InferenceHTTPClient,
+  ne as connectors,
+  ae as streams,
+  oe as webrtc
 };
+//# sourceMappingURL=index.es.js.map