@urun-sh/core 0.1.47 → 0.2.0

package/dist/index.browser.mjs

@@ -0,0 +1 @@
+import{a as ye,b as W,c as K,e as z,f as we,h as _e,j as G,k as Se,l as ve,m as ke,n as be,o as Re}from"./chunk-QTLLNENF.mjs";var w=class extends Error{status;code;constructor(e,t){super(e),this.name="RecordingsError",this.status=t.status,this.code=t.code,t.cause!==void 0&&(this.cause=t.cause),Object.setPrototypeOf(this,new.target.prototype)}},U=class extends w{constructor(e="[urun] recordings: unauthorized",t="unauthorized"){super(e,{status:401,code:t}),this.name="RecordingsUnauthorizedError",Object.setPrototypeOf(this,new.target.prototype)}},J=class extends w{constructor(e="[urun] recordings: not found",t="not_found"){super(e,{status:404,code:t}),this.name="RecordingNotFoundError",Object.setPrototypeOf(this,new.target.prototype)}},Y=class extends w{constructor(e="[urun] recordings: retain requires a temp recording",t="retain_not_temp"){super(e,{status:409,code:t}),this.name="RetainNotTempError",Object.setPrototypeOf(this,new.target.prototype)}},V=class extends w{constructor(e="[urun] recordings: pin requires an active temp recording",t="pin_requires_active_temp"){super(e,{status:409,code:t}),this.name="PinRequiresActiveTempError",Object.setPrototypeOf(this,new.target.prototype)}},H=class extends w{constructor(e="[urun] recordings: recording is permanent and locked",t="permanent_locked"){super(e,{status:409,code:t}),this.name="PermanentLockedError",Object.setPrototypeOf(this,new.target.prototype)}},A=class extends w{constructor(e="[urun] recordings: invalid retention duration",t="bad_duration",n=400){super(e,{status:n,code:t}),this.name="InvalidDurationError",Object.setPrototypeOf(this,new.target.prototype)}};function te(r){return/^(\d+[smhdw])+$/.test(r)}function Fe(r){if(r==="pin")return{action:"pin"};if(te(r))return{action:"retain",duration:r};throw new A(`[urun] recordings: "${r}" is not a duration or "pin"`)}function We(r,e,t){let n=t||e||`HTTP ${r}`;if(r===401)return new U(n,e??"unauthorized");if(r===404)return new J(n,e??"not_found");if(r===400)return new A(n,e??"bad_request",400);if(r===409)switch(e){case"retain_not_temp":return new Y(n,e);case"pin_requires_active_temp":return new V(n,e);case"permanent_locked":return new H(n,e)}return new w(n,{status:r,code:e??`http_${r}`})}var I=class{constructor(e){this._options=e;this._base=`${e.functionsUrl.replace(/\/+$/,"")}/recordings`}_options;_base;async list(e){let n=(await this._request("GET","",{params:e?{session_id:e}:void 0})).recordings;return Array.isArray(n)?n:[]}async get(e){return this._one(await this._request("GET",`/${encodeURIComponent(e)}`))}async retain(e,t){if(!te(t))throw new A(`[urun] recordings: "${t}" is not a valid retention duration`);return this._one(await this._request("POST",`/${encodeURIComponent(e)}/retain`,{body:{duration:t}}))}async pin(e){return this._one(await this._request("POST",`/${encodeURIComponent(e)}/pin`))}async unpin(e){return this._one(await this._request("POST",`/${encodeURIComponent(e)}/unpin`))}async permanent(e){return this._one(await this._request("POST",`/${encodeURIComponent(e)}/permanent`))}async delete(e){return this._one(await this._request("POST",`/${encodeURIComponent(e)}/delete`))}_one(e){let t=e.recording;if(!t||typeof t!="object")throw new w("[urun] recordings: response missing `recording`",{status:0,code:"bad_response"});return t}async _request(e,t,n={}){let s=this._buildUrl(t,n.params),o=await this._resolveToken(),i=await this._fetch(s,e,o,n.body);if(i.status===401&&this._options.getAccessToken){let a=await this._options.getAccessToken({forceRefresh:!0,reason:"unauthorized"});a&&a!==o&&(o=a,i=await this._fetch(s,e,o,n.body))}if(!i.ok){let{code:a,message:m}=await this._readError(i);throw We(i.status,a,m)}return this._readJson(i)}_buildUrl(e,t){let n=`${this._base}${e}`,s=Object.entries(t??{}).filter(([,o])=>o!=null&&o!=="").map(([o,i])=>`${encodeURIComponent(o)}=${encodeURIComponent(i)}`).join("&");return s&&(n+=`?${s}`),n}_fetch(e,t,n,s){let o={Authorization:`Bearer ${n}`,apikey:n,Accept:"application/json","X-Tenant-Id":this._options.orgId};this._options.authProvider&&(o["X-Auth-Provider"]=this._options.authProvider);let i={method:t,headers:o};return s!==void 0&&(o["Content-Type"]="application/json",i.body=JSON.stringify(s)),fetch(e,i)}async _resolveToken(){if(this._options.getAccessToken){let t=await this._options.getAccessToken();if(t)return t}let e=this._options.jwt??this._options.apiKey;if(!e)throw new U("[urun] recordings: no credential \u2014 provide one of apiKey, jwt, or getAccessToken");return e}async _readJson(e){try{return await e.json()}catch{return{}}}async _readError(e){try{let n=(await e.json()).error;if(n&&typeof n=="object"){let{code:s,message:o}=n;return{code:typeof s=="string"?s:void 0,message:typeof o=="string"?o:`HTTP ${e.status}`}}}catch{}return{message:`HTTP ${e.status}`}}};function Ke(r){return new I(r)}var ze="session-api.prod.cloud.urun.sh",Ge=["https://session-api.use2.prod.cloud.urun.sh","https://session-api.usw2.prod.cloud.urun.sh"];function X(r){return r.trim().replace(/\/+$/,"")}function Te(r,e){let t=[],n=s=>{if(!s)return;let o=X(s);o&&!t.includes(o)&&t.push(o)};n(r);for(let s of e??[])n(s);for(let s of tt(r))n(s);return t}var Je=120,Ye=1e3,Ve=3;function He(r){if(!r)return null;try{let e=new URL(r),t=e.pathname.replace(/\/api\/sessions\/create\/?$/,"");return X(`${e.origin}${t}`)}catch{return null}}async function Pe(r){let e=Te(r.baseUrl,r.fallbackUrls),t=null,n=e.length>1;for(let s of e)try{return await Xe(s,r,{pollAttempts:Je,retryAfterLimitMs:n?Ye:void 0})}catch(o){if(t=o instanceof Error?o:new Error(String(o)),t instanceof R)throw t}throw t??new Error("[urun] session allocation failed")}async function Xe(r,e,t){let n,s,o,i=r,a=0,m=new Set;for(let p=0;p<t.pollAttempts;p++){s=o??await re(e),o=void 0;let l=n?await fetch(`${i}/api/session-requests/${encodeURIComponent(n)}`,{headers:ne(e,s)}):await fetch(`${i}/api/sessions/create`,{method:"POST",redirect:"manual",headers:{...ne(e,s),"Content-Type":"application/json","Idempotency-Key":e.idempotencyKey},body:JSON.stringify(Qe(e))});if(!n&&(l.status===307||l.status===308)){let g=He(l.headers.get("location"));if(g&&g!==i&&a<Ve){a+=1,i=g;continue}throw new Error(`[urun] session create redirected from ${i} without a usable target`)}let d=await Ae(l);if(l.ok&&(d.status==="allocated"||!d.status&&!!d.session_id)&&!!d.session_id){let g=d.session_id;if(!d.ws_url)throw new R(`[urun] gateway allocated session ${g} without ws_url`);if(!Ie(d.ws_url))throw new R(`[urun] gateway allocated session ${g} with non-absolute ws_url`);return{baseUrl:i,sessionId:g,wsUrl:d.ws_url,response:d}}if(l.status===202||d.status==="pending"||d.status==="queued"||d.queued){if(n=d.request_id||n,!n)throw new Error("[urun] gateway queued session without request_id");await et(Ze(l,d,t.retryAfterLimitMs));continue}if((l.status===401||l.status===403)&&e.getAccessToken){let g=s??"";m.add(g);let y=await re(e,{forceRefresh:!0,reason:"unauthorized"});if(y&&!m.has(y)){o=y,n=void 0;continue}}let f=d.error_message||d.error_code||`HTTP ${l.status}`;throw new Error(`[urun] session allocation failed at ${i}: ${f}`)}throw new Error(`[urun] timed out waiting for session allocation at ${i}`)}function ne(r,e){let t={"X-Tenant-Id":r.orgId,"X-Auth-Provider":r.authProvider||"default","X-User-Id":"anonymous"};return e&&(t.Authorization=`Bearer ${e}`),t}async function re(r,e){return r.getAccessToken?await r.getAccessToken(e)??void 0:r.jwt}function Qe(r){return{app:r.app,function:r.functionName,gpus:1,idempotency_key:r.idempotencyKey}}async function xe(r){let e=Te(r.baseUrl,r.fallbackUrls),t=null;for(let n of e)try{let s={baseUrl:n,app:"",functionName:"",orgId:r.orgId,jwt:r.jwt,getAccessToken:r.getAccessToken,authProvider:r.authProvider,idempotencyKey:""},o=await re(s),i=await fetch(`${X(n)}/api/sessions/${encodeURIComponent(r.sessionId)}/viewer-connect`,{headers:ne(s,o)});if(!i.ok)throw new Error(`[urun] viewer-connect for ${r.sessionId} failed: HTTP ${i.status}`);let a=await Ae(i);if(!a.ws_url||!Ie(a.ws_url))throw new R(`[urun] viewer-connect returned no usable ws_url for ${r.sessionId}`);return{baseUrl:X(n),sessionId:r.sessionId,wsUrl:a.ws_url,response:a}}catch(s){if(t=s instanceof Error?s:new Error(String(s)),t instanceof R)throw t}throw t??new Error("[urun] viewer-connect failed")}async function Ae(r){try{let e=await r.json();return e&&typeof e=="object"?e:{}}catch{return{}}}function Ze(r,e,t){let n=Number(r.headers.get("Retry-After")||""),s=Number(e.retry_after_seconds??n),o=t??1e4;return Number.isFinite(s)&&s>0?Math.min(s*1e3,o):1e3}function et(r){return new Promise(e=>setTimeout(e,r))}var R=class extends Error{};function Ie(r){try{let e=new URL(r);return e.protocol==="ws:"||e.protocol==="wss:"}catch{return!1}}function tt(r){try{return new URL(r).hostname!==ze?[]:Ge}catch{return[]}}import*as Ce from"yjs";function T(r){return r!==null&&typeof r=="object"&&!Array.isArray(r)}var Q="$bytes";function nt(r){return r instanceof Uint8Array||r instanceof ArrayBuffer}function rt(r){if(!T(r))return!1;let e=Object.keys(r);return e.length===1&&e[0]===Q&&typeof r[Q]=="string"}function st(r){return r instanceof ArrayBuffer?new Uint8Array(r):r}function ot(r){if(typeof Buffer<"u")return Buffer.from(r).toString("base64");let e="";for(let t=0;t<r.length;t++)e+=String.fromCharCode(r[t]);return btoa(e)}function it(r){if(typeof Buffer<"u")return new Uint8Array(Buffer.from(r,"base64"));let e=atob(r),t=new Uint8Array(e.length);for(let n=0;n<e.length;n++)t[n]=e.charCodeAt(n);return t}function se(r){if(nt(r))return{[Q]:ot(st(r))};if(Array.isArray(r))return r.map(se);if(T(r)){let e={};for(let[t,n]of Object.entries(r))e[t]=se(n);return e}return r}function M(r){if(rt(r))return it(r[Q]);if(Array.isArray(r))return r.map(M);if(T(r)){let e={};for(let[t,n]of Object.entries(r))e[t]=M(n);return e}return r}function Oe(r,e){let t={...r};for(let n of Object.keys(e)){let s=e[n],o=t[n];T(s)&&T(o)?t[n]=Oe(o,s):t[n]=s}return t}var Ee=Symbol("urun:doc:path-absent");function at(r,e){let t=e.split("."),n=r;for(let s of t){if(n===null||typeof n!="object"||!(s in n))return Ee;n=n[s]}return n}function ct(r){return r===void 0?r:JSON.parse(JSON.stringify(r))}var ut=Symbol("urun:doc:local"),Z=class{_doc=new Ce.Doc;_root=this._doc.getMap("session");_awareness=new Se(this._doc);_listeners=new Set;_key;_sessionId;_connection=null;_connUnsub=null;_synced;_syncWaiters=new Set;_texts=new Map;_observer=()=>this.notify();constructor(e,t,n){this._key=e,this._sessionId=t,this._root.observeDeep(this._observer),n?(this._connection=n(e,this._doc,this._awareness),this._synced=this._connection.synced,this._connUnsub=this._connection.onSync(s=>{s&&this._markSynced()}),this._synced&&this._markSynced()):this._synced=!0}get awareness(){return this._awareness}setSessionId(e){this._sessionId=e}get synced(){return this._synced}onSynced(e){return this._synced?(e(),()=>{}):(this._syncWaiters.add(e),()=>this._syncWaiters.delete(e))}set(e){e=se(e),this.applyPatch(e)}get(e,t){let n=this.snapshot();if(!e)return M(n);let s=at(n,e);return s===Ee?t:M(s)}on(e,t){return this._listeners.add(t),()=>this._listeners.delete(t)}text(e){let t=this._texts.get(e);return t||(t=new oe(this._doc.getText(`text:${e}`)),this._texts.set(e,t)),t}dispose(){this._root.unobserveDeep(this._observer),this._connUnsub?.(),this._connUnsub=null,this._connection?.destroy(),this._connection=null,this._listeners.clear(),this._syncWaiters.clear();for(let e of this._texts.values())e.dispose();this._texts.clear(),this._awareness.destroy(),this._doc.destroy()}_markSynced(){let e=[...this._syncWaiters];this._synced=!0,this._syncWaiters.clear();for(let t of e)t()}applyPatch(e){this._doc.transact(()=>{let t=this._root.toJSON();for(let[n,s]of Object.entries(e)){let o=t[n],i=T(s)&&T(o)?Oe(o,s):ct(s);JSON.stringify(i)!==JSON.stringify(o)&&this._root.set(n,i)}},ut)}snapshot(){return this._root.toJSON()}notify(){let e=M(this.snapshot());for(let t of this._listeners)t(e)}},oe=class{constructor(e){this._ytext=e;this._observer=t=>{for(let n of t.delta)if(typeof n.insert=="string"&&n.insert.length>0){let s=n.insert;for(let o of this._delta)o(s)}},this._ytext.observe(this._observer)}_ytext;_delta=new Set;_observer;append(e){e.length!==0&&this._ytext.insert(this._ytext.length,e)}toString(){return this._ytext.toString()}get length(){return this._ytext.length}on(e,t){return this._delta.add(t),()=>this._delta.delete(t)}dispose(){this._ytext.unobserve(this._observer),this._delta.clear()}};var _=class extends Error{requestId;code;constructor(e,t){super(e),this.name="RequestError",this.requestId=t?.requestId,this.code=t?.code,t?.cause!==void 0&&(this.cause=t.cause),Object.setPrototypeOf(this,new.target.prototype)}},D=class extends _{timeoutMs;constructor(e,t){super(`[urun] request timed out after ${e}ms`,{requestId:t}),this.name="RequestTimeoutError",this.timeoutMs=e,Object.setPrototypeOf(this,new.target.prototype)}},j=class extends _{timeoutMs;constructor(e,t){super(`[urun] request doc-sync did not establish within ${e}ms \u2014 the request was never delivered to the runtime (the session doc never synced with the session-server; check the doc-sync transport / connection)`,{requestId:t}),this.name="RequestDocSyncError",this.timeoutMs=e,Object.setPrototypeOf(this,new.target.prototype)}},q=class extends Error{stream;owner;attempted;constructor(e,t,n){super(`[urun] stream "${e}" is already produced by the ${t}; this (${n}) peer cannot also produce it \u2014 a named stream has exactly one producer (consume it instead, or use a distinct name for the reverse direction)`),this.name="StreamDirectionConflict",this.stream=e,this.owner=t,this.attempted=n,Object.setPrototypeOf(this,new.target.prototype)}},C=class extends _{constructor(e){super("[urun] request aborted",{requestId:e}),this.name="RequestAbortError",Object.setPrototypeOf(this,new.target.prototype)}},L=class extends _{constructor(e){super("[urun] request cancelled: session disconnected",{requestId:e}),this.name="RequestCancelledError",Object.setPrototypeOf(this,new.target.prototype)}};var Ue="video/mp4";function ie(r,e={}){let t=e.timesliceMs??1e3,n=null,s=null,o=!1,i=(a,m,p)=>{let l=typeof MediaRecorder>"u"?void 0:MediaRecorder;if(!l)throw new Error("[urun] stream.chunks(): MediaRecorder is unavailable in this runtime. Pass { source } to chunks() to inject a byte-tap (e.g. a Node/werift consumer).");let d=e.mimeType??(typeof l.isTypeSupported=="function"&&l.isTypeSupported(Ue)?Ue:void 0),c=new MediaStream([a]),f=new l(c,d?{mimeType:d}:void 0);n=f;let g=Promise.resolve();f.ondataavailable=y=>{let h=y.data;o||!h||h.size===0||(g=g.then(async()=>{let v=new Uint8Array(await h.arrayBuffer());o||m(v)}))},f.onstop=()=>{g.then(()=>{o||p()})},f.onerror=()=>{g.then(()=>{o||p()})},f.start(t)};return{start(a,m){if(n||o)return;let p=r.track();if(p){i(p,a,m);return}s=r.onTrack(l=>{!l||n||o||(s?.(),s=null,i(l,a,m))})},stop(){if(o)return;o=!0,s?.(),s=null;let a=n;if(n=null,a&&a.state!=="inactive")try{a.stop()}catch{}}}}function dt(r){let e=r;return typeof e[Symbol.asyncIterator]=="function"||(e[Symbol.asyncIterator]=function(){let t=r.getReader();return{next(){return t.read()},async return(){try{await t.cancel()}catch{}try{t.releaseLock()}catch{}return{value:void 0,done:!0}},[Symbol.asyncIterator](){return this}}}),e}function Me(r,e){let t=null,n=!1,s=!1,o=new ReadableStream({pull(i){n||(n=!0,t=r(e),t.start(a=>{if(!s)try{i.enqueue(a)}catch{}},()=>{if(!s){s=!0;try{i.close()}catch{}}}))},cancel(){s=!0,t?.stop(),t=null}},new CountQueuingStrategy({highWaterMark:0}));return dt(o)}var lt=new Set;function ue(r){if(r.functionsUrl)return{functionsUrl:r.functionsUrl,orgId:r.orgId,apiKey:r.apiKey,jwt:r.jwt,getAccessToken:r.getAccessToken,authProvider:r.authProvider}}var pt="rpc",je=3e4,mt="rpc-resp";function gt(r){return`${mt}:${r}`}function ae(){return we()}function ft(r){if(r&&typeof r=="object"){let e=r.error;if(e&&typeof e=="object"){let{message:t,code:n}=e;return{message:typeof t=="string"?t:JSON.stringify(e),code:typeof n=="string"?n:void 0}}if(typeof e=="string")return{message:e}}return{message:typeof r=="string"?r:JSON.stringify(r)}}function ht(r,e,t,n,s,o,i,a,m,p){let l=[],d=null,c=!1,f=null,g=!1,y,h,v=new Promise((u,S)=>{y=u,h=S});v.catch(()=>{});let k=i(),b=null,O=null,E=null,B=null,N=!0,le=()=>{E&&(clearTimeout(E),E=null),B&&(B(),B=null)},pe=!1,me=()=>{pe||!g||(pe=!0,r.set({rpc:{[e]:null}}))},F=()=>{N=!1,le(),b?.(),b=null,O?.(),O=null,a?.removeEventListener("abort",fe),k.dispose(),me()},ee=()=>{if(d){if(l.length>0){let u=d;d=null,u.resolve({value:l.shift(),done:!1})}else if(f!==null){let u=d;d=null,u.reject(f)}else if(c){let u=d;d=null,u.resolve({value:void 0,done:!0})}}},$e=u=>{c||(l.push(u),ee())},P=u=>{c||(f=u,c=!0,h(u),F(),ee())},ge=u=>{c||(c=!0,y(u),F(),ee())},fe=()=>{let u=a?.reason;P(u instanceof _?u:new C(e))},Be=u=>{if(!(c||!u||typeof u!="object"))switch(me(),u.t){case"delta":typeof u.delta=="string"&&$e(u.delta);break;case"response":ge(u.body);break;case"error":{let{message:S,code:x}=ft(u.body);P(new _(S,{requestId:e,code:u.code??x}));break}}},Ne=()=>{let u=k.messages()[Symbol.asyncIterator]();b=()=>{u.return?.(void 0)};let S=()=>{N&&u.next().then(x=>{if(N){if(x.done){c||ge(void 0);return}Be(x.value),S()}},x=>{N&&P(x)})};S()},he=()=>{if(!g){if(g=!0,a){if(a.aborted){P(new C(e));return}a.addEventListener("abort",fe,{once:!0})}O=m?.(u=>P(u))??null,Ne(),r.set({rpc:{[e]:{args:t,respond_on:n,consumer_id:s,stream:o}}}),p&&p>0&&!r.synced&&(E=setTimeout(()=>{E=null,!c&&!r.synced&&P(new j(p,e))},p),B=r.onSynced(()=>le()))}};return{deltas:{[Symbol.asyncIterator](){return{next(){if(he(),l.length>0)return Promise.resolve({value:l.shift(),done:!1});if(f!==null){let u=f;return f=null,Promise.reject(u)}return c?Promise.resolve({value:void 0,done:!0}):new Promise((u,S)=>{d={resolve:u,reject:S}})},return(){return c||(c=!0,y(void 0),F()),Promise.resolve({value:void 0,done:!0})},throw(u){return c||(c=!0,h(u),F()),Promise.reject(u)}}}},body:v,start:he}}function De(r){if(r&&typeof r=="object"){let{epoch:e,by:t}=r,n={epoch:typeof e=="number"?e:0};return(t==="runtime"||t==="browser")&&(n.by=t),n}}function yt(r,e){let n=r.get("streams")?.[e];if(!n||typeof n!="object")return null;let{kind:s,rt:o,br:i}=n,a={};(s==="audio"||s==="video"||s==="data")&&(a.kind=s);let m=De(o);m&&(a.rt=m);let p=De(i);return p&&(a.br=p),a}var ce=class{constructor(e,t,n,s){this._name=e;this._transport=t;this._streamData=n;this._controlDoc=s;this._track=this._transport.getTrackByName(this._name)??null,this._unsubscribeTransport=this._transport.on("track",()=>{let o=this._transport.getTrackByName(this._name)??null;o!==this._track&&this._setTrack(o)})}_name;_transport;_streamData;_controlDoc;_track=null;_handlers=new Map;_unsubscribeTransport=null;_subscribed=!1;_messageConsumers=new Set;_dataUnsub=null;_replay=[];_disposed=!1;messages(){this._ensureSubscribed();let e=this;return{[Symbol.asyncIterator](){let t=[...e._replay],n=null,s=!1,o={push(a){if(!s)if(n){let m=n;n=null,m({value:a,done:!1})}else t.push(a)},end(){if(s=!0,n){let a=n;n=null,a({value:void 0,done:!0})}}};e._messageConsumers.add(o);let i=()=>{s=!0,e._messageConsumers.delete(o)};return{next(){return t.length>0?Promise.resolve({value:t.shift(),done:!1}):s?Promise.resolve({value:void 0,done:!0}):new Promise(a=>{n=a})},return(){return i(),Promise.resolve({value:void 0,done:!0})}}}}}_ensureSubscribed(){this._subscribed||this._disposed||(this._subscribed=!0,this._transport.subscribeStream(this._name),this._streamData&&(this._dataUnsub=this._streamData.onData(this._name,e=>this._deliver(e))))}_deliver(e){this._replay.push(e);for(let t of this._messageConsumers)t.push(e)}get track(){let e=this._transport.getTrackByName(this._name)??this._track;return e!==this._track&&this._setTrack(e),this._track}_claimBrowserProducer(e){if(!this._controlDoc)return;let t=this._controlDoc(),n=yt(t,this._name),s=n?.br;if(s?.by==="runtime")throw new q(this._name,"runtime","browser");if(s)return;let o={br:{epoch:1}};n?.rt&&(o.rt=n.rt);let i=n?.kind??e;i&&(o.kind=i),t.set({streams:{[this._name]:o}})}async attach(e){this._claimBrowserProducer("audio"),await this._transport.addTrack(e,this._name)}async attachVideo(e){this._claimBrowserProducer("video"),await this._transport.addVideoTrack(e,this._name)}async emit(e,t={}){if(this._claimBrowserProducer("data"),!this._streamData)throw new Error("[urun] stream.emit requires the data-stream transport (no streamData wired)");this._streamData.sendData(this._name,e,t)}async detach(){this._transport.removeTrack()}async detachVideo(){this._transport.stopVideo()}async seek(e){if(e!=="live"&&(!Number.isFinite(e)||e<0))throw new Error('[urun] stream.seek target must be "live" or a non-negative number of seconds');this._transport.seekStream(this._name,e)}chunks(e={}){let t=e.source??ie;return Me(t,{track:()=>this.track,onTrack:s=>this.on("track",s)})}onSeeked(e){return this._transport.on("seeked",(t,n)=>{t===this._name&&e(n)})}on(e,t){let n=this._handlers.get(e);return n||(n=new Set,this._handlers.set(e,n)),n.add(t),()=>{n?.delete(t),n?.size===0&&this._handlers.delete(e)}}dispose(){this._disposed=!0,this._unsubscribeTransport?.(),this._unsubscribeTransport=null,this._handlers.clear(),this._subscribed&&this._transport.unsubscribeStream(this._name),this._dataUnsub?.(),this._dataUnsub=null;for(let e of this._messageConsumers)e.end();this._messageConsumers.clear()}_setTrack(e){this._track=e,e&&e.addEventListener("ended",()=>{this._track===e&&this._setTrack(null)},{once:!0});let t=this._handlers.get("track");if(t)for(let n of t)n(e)}},$=class r{_sessionId;_multiplexer;_transport;_docs=new Map;_streams=new Map;_docConnector=new be;_streamData;_presence=null;_activeRequests=new Set;_recordingsAuth;_recordingsAccessor=null;constructor(e,t,n,s){this._sessionId=e,this._multiplexer=t,this._transport=n,this._recordingsAuth=s,this._streamData=_e(n),this._wireControlDocIncarnation()}_wireControlDocIncarnation(){let e=this.doc("control");this._transport.applyControlDocState(e.get()),e.on("change",t=>{this._transport.applyControlDocState(t)})}static async attach(e,t){let n=await xe({baseUrl:t.baseUrl,fallbackUrls:t.fallbackUrls,sessionId:e,orgId:t.orgId,jwt:t.jwt,getAccessToken:t.getAccessToken,authProvider:t.authProvider}),s=t.getAccessToken?await t.getAccessToken()??void 0:t.jwt,o=new W,i=new G({url:n.wsUrl,orgId:t.orgId,jwt:s,authProvider:t.authProvider,sessionId:e,iceServers:n.response.ice_servers}),a=new r(e,o,i,ue(t));return i.on("connected",()=>{i.multiplexer&&o.setTarget(i.multiplexer)}),i.setConnection({url:n.wsUrl,sessionId:e,iceServers:n.response.ice_servers}),K()&&await z(),a.setDocTransport({wsUrl:n.wsUrl,token:s}),await i.connect({role:"viewer"}),a}get id(){return this._sessionId}get phase(){return this._transport.phase}onPhase(e){return e(this._transport.phase),this._transport.on("phase",e)}get recordings(){if(this._recordingsAccessor)return this._recordingsAccessor;let e=this._recordingsAuth;if(!e)throw new Error("[urun] session.recordings requires `functionsUrl` to be configured on the App()/Session.attach() options (the eensx /functions/v1 base URL).");let t=new I(e);return this._recordingsAccessor={list:n=>t.list(n??this._sessionId),get:n=>t.get(n),retain:(n,s)=>t.retain(n,s),pin:n=>t.pin(n),unpin:n=>t.unpin(n),permanent:n=>t.permanent(n),delete:n=>t.delete(n)},this._recordingsAccessor}setSessionId(e){if(e===this._sessionId)return;this._multiplexer.rewriteSessionChannels?.call(this._multiplexer,this._sessionId,e),this._sessionId=e;for(let n of this._docs.values())n.setSessionId(e)}stream(e){let t=this._streams.get(e);return t||(t=new ce(e,this._transport,this._streamData,()=>this.doc("control")),this._streams.set(e,t)),t}doc(e){let t=this._docs.get(e);return t||(t=new Z(e,this._sessionId,lt.has(e)?null:this._docConnector.connect),this._docs.set(e,t)),t}get presence(){return this._presence||(this._presence=Re(this.doc("control").awareness)),this._presence}connectDocs(e){this._docConnector.setTarget(e)}setDocTransport(e){this.connectDocs(ke({serverUrl:ve(e.wsUrl),sessionId:this._sessionId,token:e.token,WebSocketPolyfill:e.webSocket}))}useStreamDataTransport(e){if(this._streams.size>0)throw new Error("[urun] useStreamDataTransport must be called before opening any stream");this._streamData=e}sendImage(e){return this.request({reference_image:{value:e}})}sendImageLegacyDesired(e){this.doc("control").set({desired:{reference_image:{value:e}}})}request(e,t={}){let n=ae(),s=new AbortController;t.signal&&(t.signal.aborted?s.abort(t.signal.reason):t.signal.addEventListener("abort",()=>s.abort(t.signal.reason),{once:!0}));let o=null;if(typeof t.timeout=="number"&&t.timeout>=0){let a=t.timeout;o=setTimeout(()=>s.abort(new D(a,n)),a)}let i=this._consumeResponse(n,e,!1,s.signal);return i.start(),i.body.finally(()=>{o&&clearTimeout(o)})}_consumeResponse(e,t,n,s,o){let i=this.doc(pt),a=gt(e);return ht(i,e,t,a,this._streamData.consumerId,n,()=>this.stream(a),s,m=>(this._activeRequests.add(m),()=>this._activeRequests.delete(m)),o??je)}requestStream(e,t={}){let n=ae();return this._consumeResponse(n,e,!0,t.signal,t.docSyncTimeout).deltas}complete(e,t={}){let n=ae(),s=this._consumeResponse(n,e,!1,t.signal,t.docSyncTimeout);return s.start(),s.body}disconnect(){let e=Array.from(this._activeRequests);this._activeRequests.clear();for(let t of e)try{t(new L)}catch{}for(let t of this._docs.values())t.dispose();this._docs.clear();for(let t of this._streams.values())t.dispose();this._streams.clear(),this._transport.disconnect()}};var wt=new Set(["then","catch","finally","toJSON",Symbol.toPrimitive]);function _t(r,e){return new Proxy({},{get(t,n){if(!(wt.has(n)||typeof n!="string"))return s=>{let o=s??{},i=()=>`s_${Date.now()}_${Math.random().toString(36).slice(2)}`,a=i(),m=new W,p=new G({url:"",orgId:e.orgId,jwt:e.jwt,authProvider:e.authProvider,sessionId:a}),l=new $(a,m,p,ue(e)),d=async c=>{let f=await Pe({baseUrl:e.baseUrl,fallbackUrls:e.fallbackUrls,app:r,functionName:n,orgId:e.orgId,jwt:e.jwt,getAccessToken:e.getAccessToken,authProvider:e.authProvider,idempotencyKey:c}),g=e.getAccessToken?await e.getAccessToken()??void 0:e.jwt;return l.setSessionId(f.sessionId),{url:f.wsUrl,sessionId:f.sessionId,jwt:g,iceServers:f.response.ice_servers}};return p.setConnectionResolver(()=>d(i())),p.on("connected",()=>{p.multiplexer&&m.setTarget(p.multiplexer)}),(async()=>{let c=await d(a);p.setAuth({jwt:c.jwt,authProvider:e.authProvider,orgId:e.orgId}),p.setConnection({url:c.url,sessionId:c.sessionId,iceServers:c.iceServers}),K()&&await z(),l.setDocTransport({wsUrl:c.url,token:c.jwt}),await p.connect({app:r,functionName:n,args:o})})().catch(c=>{console.error(`[urun] Failed to connect session for ${n}:`,c)}),l}}})}var qe=3e4,Le="stream:",de=class{_ws;_multiplexer;_pendingRpc=new Map;_rpcId=0;constructor(e,t){this._ws=e,this._multiplexer=t,this._ws.addEventListener("message",n=>{let s;try{s=JSON.parse(typeof n.data=="string"?n.data:"")}catch{return}if(s.rpcId&&this._pendingRpc.has(s.rpcId)){let o=this._pendingRpc.get(s.rpcId);this._pendingRpc.delete(s.rpcId),clearTimeout(o.timer),s.error?o.reject(new Error(s.error)):o.resolve(s.result)}})}async get(e){return this._sendRpc("store.get",{key:e})}async has(e){return await this._sendRpc("store.has",{key:e})}on(e,t){let n=`${Le}${e}`;return this._multiplexer.on(n,s=>{t(s)})}emit(e,t){let n=`${Le}${e}`,s=typeof t=="object"&&t!==null&&!Array.isArray(t)?t:{data:t};this._multiplexer.emit(n,s)}_getInternals(){return{multiplexer:this._multiplexer,ws:this._ws}}_sendRpc(e,t){return new Promise((n,s)=>{if(!this._ws||this._ws.readyState!==WebSocket.OPEN){s(new Error("WebSocket not open"));return}let o=String(++this._rpcId),i=setTimeout(()=>{this._pendingRpc.has(o)&&(this._pendingRpc.delete(o),s(new Error(`RPC request "${e}" timed out after ${qe}ms`)))},qe);this._pendingRpc.set(o,{resolve:n,reject:s,timer:i}),this._ws.send(JSON.stringify({rpcId:o,type:e,...t}))})}};function St(r){let n=`${r.baseUrl.replace(/\/$/,"").replace(/^http/,"ws")}/store/${encodeURIComponent(r.orgId)}`,s=new WebSocket(n);(r.jwt||r.apiKey)&&s.addEventListener("open",()=>{s.send(JSON.stringify({type:"auth",orgId:r.orgId,jwt:r.jwt,authProvider:r.authProvider,apiKey:r.apiKey}))});let o=new ye(s);return new de(s,o)}var vt='video/mp4; codecs="avc1.42E01E"';function kt(r,e){let t=e?.codec??vt,n=document.createElement("video");n.muted=!0,n.playsInline=!0;let s=new MediaSource,o=URL.createObjectURL(s);n.src=o,s.addEventListener("sourceopen",()=>{let c;try{c=s.addSourceBuffer(t)}catch(h){throw h instanceof DOMException&&h.name==="NotSupportedError"?new Error(`Codec not supported: "${t}". Ensure the codec string matches the fMP4 container format. Common values: video/mp4; codecs="avc1.42E01E" (H.264 Baseline), video/mp4; codecs="avc1.4D401F" (H.264 Main).`):h}let f=r.getReader();function g(){return c.updating?new Promise(h=>{c.addEventListener("updateend",()=>h(),{once:!0})}):Promise.resolve()}async function y(){try{for(;;){let{done:h,value:v}=await f.read();if(h){await g(),s.readyState==="open"&&s.endOfStream();return}await g();try{c.appendBuffer(v)}catch(k){if(k instanceof DOMException&&k.name==="QuotaExceededError"){let b=c.buffered;if(b.length>0){let O=b.start(b.length-1);c.remove(0,O),await g(),c.appendBuffer(v)}else throw k}else throw k}}}catch{if(s.readyState==="open")try{s.endOfStream("decode")}catch{}}}y()}),n.play().catch(()=>{});let i=n,a=i.captureStream??i.mozCaptureStream;if(!a)throw new Error("captureStream() is not supported in this browser. videoStream() requires HTMLMediaElement.captureStream() support.");let m=a.call(n),p=m.getTracks(),l=0,d=p.length;if(d===0)n.addEventListener("emptied",()=>{URL.revokeObjectURL(o)},{once:!0});else for(let c of p)c.addEventListener("ended",()=>{l++,l>=d&&URL.revokeObjectURL(o)});return m}function bt(r){return r.status.startsWith("pending_")}export{_t as App,je as DEFAULT_DOC_SYNC_TIMEOUT_MS,A as InvalidDurationError,H as PermanentLockedError,V as PinRequiresActiveTempError,J as RecordingNotFoundError,I as RecordingsClient,w as RecordingsError,U as RecordingsUnauthorizedError,C as RequestAbortError,L as RequestCancelledError,j as RequestDocSyncError,_ as RequestError,D as RequestTimeoutError,Y as RetainNotTempError,$ as Session,q as StreamDirectionConflict,Ke as createRecordingsClient,St as createStore,te as isDurationString,bt as isPendingRecording,ie as mediaRecorderChunkSource,Fe as normalizeRetention,kt as videoStream};

package/dist/index.d.mts

@@ -1,39 +1,121 @@
-import { a as AppOptions, A as App$1, k as SessionDocument, p as SessionText, j as Session$1, C as ChannelEndpoint, T as TransportSession, b as AttachOptions, l as SessionPhase, o as SessionStream$1, R as RequestOptions, h as RequestStreamOptions, r as StoreOptions, q as Store, d as ChannelMultiplexer } from './transport-DwP_VpLT.mjs';
-export { L as Layer, f as LayoutConfig, g as LayoutContext, S as SceneContext, i as SceneGraph, m as SessionPhaseName, t as TransportState } from './transport-DwP_VpLT.mjs';
+import { b as AppOptions, a as App$1, A as AccessTokenOptions, R as Recording, z as SessionDocument, j as DocConnector, H as SessionText, y as Session$1, C as ChannelEndpoint, T as TransportSession, c as AttachOptions, B as SessionPhase, u as RecordingsAccessor, G as SessionStream$1, N as StreamDataTransport, K as StreamChunkOptions, g as ChunkReadable, P as Presence, v as RequestOptions, w as RequestStreamOptions, J as StoreOptions, I as Store, e as ChannelMultiplexer } from './stream-data-BQHZia_W.mjs';
+export { L as Layer, k as LayoutConfig, l as LayoutContext, M as MediaChunkBinding, n as MediaChunkSource, o as MediaChunkSourceFactory, p as MediaRecorderChunkSourceOptions, q as PresenceState, r as RecordingBucket, s as RecordingLifecycle, t as RecordingStatus, S as SceneContext, x as SceneGraph, E as SessionPhaseName, Q as TransportState, X as isPendingRecording, Y as mediaRecorderChunkSource } from './stream-data-BQHZia_W.mjs';
 import * as Y from 'yjs';
+import { Awareness } from 'y-protocols/awareness';
 
 declare function App(appId: string, options: AppOptions): App$1;
 
-interface SessionDocTransport {
+interface RecordingsClientOptions {
     
-    sendDocSync(docKey: string, payload: Uint8Array): void;
+    functionsUrl: string;
     
-    onDocSync(docKey: string, handler: (payload: Uint8Array) => void): () => void;
+    orgId: string;
     
-    onDocSyncReady(handler: () => void): () => void;
+    apiKey?: string;
     
-    readonly isOpen: boolean;
+    jwt?: string;
+    
+    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    
+    authProvider?: string;
+}
+
+declare class RecordingsError extends Error {
+    
+    readonly status: number;
+    
+    readonly code: string;
+    constructor(message: string, options: {
+        status: number;
+        code: string;
+        cause?: unknown;
+    });
+}
+
+declare class RecordingsUnauthorizedError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class RecordingNotFoundError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class RetainNotTempError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class PinRequiresActiveTempError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class PermanentLockedError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class InvalidDurationError extends RecordingsError {
+    constructor(message?: string, code?: string, status?: number);
+}
+
+declare function isDurationString(value: string): boolean;
+
+type RetentionIntent = {
+    action: 'retain';
+    duration: string;
+} | {
+    action: 'pin';
+};
+
+declare function normalizeRetention(value: string): RetentionIntent;
+
+declare class RecordingsClient {
+    private readonly _options;
+    private readonly _base;
+    constructor(_options: RecordingsClientOptions);
+    
+    list(sessionId?: string): Promise<Recording[]>;
+    
+    get(id: string): Promise<Recording>;
+    
+    retain(id: string, duration: string): Promise<Recording>;
+    
+    pin(id: string): Promise<Recording>;
+    
+    unpin(id: string): Promise<Recording>;
+    
+    permanent(id: string): Promise<Recording>;
+    
+    delete(id: string): Promise<Recording>;
+    private _one;
+    
+    private _request;
+    private _buildUrl;
+    private _fetch;
+    private _resolveToken;
+    private _readJson;
+    private _readError;
 }
 
+declare function createRecordingsClient(options: RecordingsClientOptions): RecordingsClient;
+
 declare class SessionDocumentImpl implements SessionDocument {
     private _doc;
     private _root;
+    private _awareness;
     private _listeners;
     private _key;
     private _sessionId;
-    private _transport;
-    private _transportUnsubs;
+    private _connection;
+    private _connUnsub;
     
     private _synced;
     
-    private _pendingPatches;
-    
     private _syncWaiters;
     
     private _texts;
     private _observer;
-    private _updateHandler;
-    constructor(key: string, sessionId: string, transport?: SessionDocTransport | null);
+    constructor(key: string, sessionId: string, connector?: DocConnector | null);
+    
+    get awareness(): Awareness;
     
     setSessionId(sessionId: string): void;
     
@@ -47,9 +129,7 @@ declare class SessionDocumentImpl implements SessionDocument {
     
     text(field: string): SessionTextImpl;
     dispose(): void;
-    
-    private sendHello;
-    private applyRemote;
+    private _markSynced;
     
     private applyPatch;
     private snapshot;
@@ -73,7 +153,7 @@ declare class SessionStream implements SessionStream$1 {
     private _name;
     private _transport;
     
-    private _laneDoc?;
+    private _streamData?;
     
     private _controlDoc?;
     private _track;
@@ -84,15 +164,13 @@ declare class SessionStream implements SessionStream$1 {
     
     private _messageConsumers;
     
-    private _laneUnsubs;
-    
-    private _laneSeen;
+    private _dataUnsub;
     
     private _replay;
     private _disposed;
     constructor(_name: string, _transport: TransportSession, 
     
-    _laneDoc?: ((key: string) => SessionDocumentImpl) | undefined, 
+    _streamData?: StreamDataTransport | undefined, 
     
     _controlDoc?: (() => SessionDocumentImpl) | undefined);
     
@@ -100,7 +178,7 @@ declare class SessionStream implements SessionStream$1 {
     
     private _ensureSubscribed;
     
-    private _drainLane;
+    private _deliver;
     get track(): MediaStreamTrack | null;
     
     private _claimBrowserProducer;
@@ -115,6 +193,10 @@ declare class SessionStream implements SessionStream$1 {
     
     detachVideo(): Promise<void>;
     seek(target: number | 'live'): Promise<void>;
+    
+    chunks(options?: StreamChunkOptions): ChunkReadable;
+    
+    onSeeked(handler: (target: number | 'live') => void): () => void;
     on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
     dispose(): void;
     private _setTrack;
@@ -127,8 +209,18 @@ declare class Session implements Session$1 {
     private _docs;
     private _streams;
     
+    private _docConnector;
+    
+    private _streamData;
+    
+    private _presence;
+    
     private _activeRequests;
-    constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession);
+    
+    private _recordingsAuth?;
+    
+    private _recordingsAccessor;
+    constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession, recordingsAuth?: RecordingsClientOptions);
     private _wireControlDocIncarnation;
     
     static attach(sessionId: string, options: AttachOptions): Promise<Session>;
@@ -137,11 +229,25 @@ declare class Session implements Session$1 {
     get phase(): SessionPhase;
     
     onPhase(handler: (phase: SessionPhase) => void): () => void;
+    
+    get recordings(): RecordingsAccessor;
     setSessionId(sessionId: string): void;
     stream(name: string): SessionStream;
     
     doc(key: string): SessionDocumentImpl;
     
+    get presence(): Presence;
+    
+    connectDocs(connector: DocConnector): void;
+    
+    setDocTransport(opts: {
+        wsUrl: string;
+        token?: string;
+        webSocket?: typeof WebSocket;
+    }): void;
+    
+    useStreamDataTransport(transport: StreamDataTransport): void;
+    
     sendImage(value: string): Promise<unknown>;
     
     sendImageLegacyDesired(value: string): void;
@@ -212,4 +318,4 @@ declare class RequestCancelledError extends RequestError {
     constructor(requestId?: string);
 }
 
-export { App, App$1 as AppInterface, AppOptions, AttachOptions, DEFAULT_DOC_SYNC_TIMEOUT_MS, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, Session, SessionDocument, Session$1 as SessionInterface, SessionPhase, SessionStream$1 as SessionStream, SessionText, Store, StoreOptions, StreamDirectionConflict, type VideoStreamOptions, createStore, videoStream };
+export { App, App$1 as AppInterface, AppOptions, AttachOptions, ChunkReadable, DEFAULT_DOC_SYNC_TIMEOUT_MS, InvalidDurationError, PermanentLockedError, PinRequiresActiveTempError, Presence, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, Session, SessionDocument, Session$1 as SessionInterface, SessionPhase, SessionStream$1 as SessionStream, SessionText, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type VideoStreamOptions, createRecordingsClient, createStore, isDurationString, normalizeRetention, videoStream };

package/dist/index.d.ts

@@ -1,39 +1,121 @@
-import { a as AppOptions, A as App$1, k as SessionDocument, p as SessionText, j as Session$1, C as ChannelEndpoint, T as TransportSession, b as AttachOptions, l as SessionPhase, o as SessionStream$1, R as RequestOptions, h as RequestStreamOptions, r as StoreOptions, q as Store, d as ChannelMultiplexer } from './transport-DwP_VpLT.js';
-export { L as Layer, f as LayoutConfig, g as LayoutContext, S as SceneContext, i as SceneGraph, m as SessionPhaseName, t as TransportState } from './transport-DwP_VpLT.js';
+import { b as AppOptions, a as App$1, A as AccessTokenOptions, R as Recording, z as SessionDocument, j as DocConnector, H as SessionText, y as Session$1, C as ChannelEndpoint, T as TransportSession, c as AttachOptions, B as SessionPhase, u as RecordingsAccessor, G as SessionStream$1, N as StreamDataTransport, K as StreamChunkOptions, g as ChunkReadable, P as Presence, v as RequestOptions, w as RequestStreamOptions, J as StoreOptions, I as Store, e as ChannelMultiplexer } from './stream-data-BQHZia_W.js';
+export { L as Layer, k as LayoutConfig, l as LayoutContext, M as MediaChunkBinding, n as MediaChunkSource, o as MediaChunkSourceFactory, p as MediaRecorderChunkSourceOptions, q as PresenceState, r as RecordingBucket, s as RecordingLifecycle, t as RecordingStatus, S as SceneContext, x as SceneGraph, E as SessionPhaseName, Q as TransportState, X as isPendingRecording, Y as mediaRecorderChunkSource } from './stream-data-BQHZia_W.js';
 import * as Y from 'yjs';
+import { Awareness } from 'y-protocols/awareness';
 
 declare function App(appId: string, options: AppOptions): App$1;
 
-interface SessionDocTransport {
+interface RecordingsClientOptions {
     
-    sendDocSync(docKey: string, payload: Uint8Array): void;
+    functionsUrl: string;
     
-    onDocSync(docKey: string, handler: (payload: Uint8Array) => void): () => void;
+    orgId: string;
     
-    onDocSyncReady(handler: () => void): () => void;
+    apiKey?: string;
     
-    readonly isOpen: boolean;
+    jwt?: string;
+    
+    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    
+    authProvider?: string;
+}
+
+declare class RecordingsError extends Error {
+    
+    readonly status: number;
+    
+    readonly code: string;
+    constructor(message: string, options: {
+        status: number;
+        code: string;
+        cause?: unknown;
+    });
+}
+
+declare class RecordingsUnauthorizedError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class RecordingNotFoundError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class RetainNotTempError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class PinRequiresActiveTempError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class PermanentLockedError extends RecordingsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class InvalidDurationError extends RecordingsError {
+    constructor(message?: string, code?: string, status?: number);
+}
+
+declare function isDurationString(value: string): boolean;
+
+type RetentionIntent = {
+    action: 'retain';
+    duration: string;
+} | {
+    action: 'pin';
+};
+
+declare function normalizeRetention(value: string): RetentionIntent;
+
+declare class RecordingsClient {
+    private readonly _options;
+    private readonly _base;
+    constructor(_options: RecordingsClientOptions);
+    
+    list(sessionId?: string): Promise<Recording[]>;
+    
+    get(id: string): Promise<Recording>;
+    
+    retain(id: string, duration: string): Promise<Recording>;
+    
+    pin(id: string): Promise<Recording>;
+    
+    unpin(id: string): Promise<Recording>;
+    
+    permanent(id: string): Promise<Recording>;
+    
+    delete(id: string): Promise<Recording>;
+    private _one;
+    
+    private _request;
+    private _buildUrl;
+    private _fetch;
+    private _resolveToken;
+    private _readJson;
+    private _readError;
 }
 
+declare function createRecordingsClient(options: RecordingsClientOptions): RecordingsClient;
+
 declare class SessionDocumentImpl implements SessionDocument {
     private _doc;
     private _root;
+    private _awareness;
     private _listeners;
     private _key;
     private _sessionId;
-    private _transport;
-    private _transportUnsubs;
+    private _connection;
+    private _connUnsub;
     
     private _synced;
     
-    private _pendingPatches;
-    
     private _syncWaiters;
     
     private _texts;
     private _observer;
-    private _updateHandler;
-    constructor(key: string, sessionId: string, transport?: SessionDocTransport | null);
+    constructor(key: string, sessionId: string, connector?: DocConnector | null);
+    
+    get awareness(): Awareness;
     
     setSessionId(sessionId: string): void;
     
@@ -47,9 +129,7 @@ declare class SessionDocumentImpl implements SessionDocument {
     
     text(field: string): SessionTextImpl;
     dispose(): void;
-    
-    private sendHello;
-    private applyRemote;
+    private _markSynced;
     
     private applyPatch;
     private snapshot;
@@ -73,7 +153,7 @@ declare class SessionStream implements SessionStream$1 {
     private _name;
     private _transport;
     
-    private _laneDoc?;
+    private _streamData?;
     
     private _controlDoc?;
     private _track;
@@ -84,15 +164,13 @@ declare class SessionStream implements SessionStream$1 {
     
     private _messageConsumers;
     
-    private _laneUnsubs;
-    
-    private _laneSeen;
+    private _dataUnsub;
     
     private _replay;
     private _disposed;
     constructor(_name: string, _transport: TransportSession, 
     
-    _laneDoc?: ((key: string) => SessionDocumentImpl) | undefined, 
+    _streamData?: StreamDataTransport | undefined, 
     
     _controlDoc?: (() => SessionDocumentImpl) | undefined);
     
@@ -100,7 +178,7 @@ declare class SessionStream implements SessionStream$1 {
     
     private _ensureSubscribed;
     
-    private _drainLane;
+    private _deliver;
     get track(): MediaStreamTrack | null;
     
     private _claimBrowserProducer;
@@ -115,6 +193,10 @@ declare class SessionStream implements SessionStream$1 {
     
     detachVideo(): Promise<void>;
     seek(target: number | 'live'): Promise<void>;
+    
+    chunks(options?: StreamChunkOptions): ChunkReadable;
+    
+    onSeeked(handler: (target: number | 'live') => void): () => void;
     on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
     dispose(): void;
     private _setTrack;
@@ -127,8 +209,18 @@ declare class Session implements Session$1 {
     private _docs;
     private _streams;
     
+    private _docConnector;
+    
+    private _streamData;
+    
+    private _presence;
+    
     private _activeRequests;
-    constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession);
+    
+    private _recordingsAuth?;
+    
+    private _recordingsAccessor;
+    constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession, recordingsAuth?: RecordingsClientOptions);
     private _wireControlDocIncarnation;
     
     static attach(sessionId: string, options: AttachOptions): Promise<Session>;
@@ -137,11 +229,25 @@ declare class Session implements Session$1 {
     get phase(): SessionPhase;
     
     onPhase(handler: (phase: SessionPhase) => void): () => void;
+    
+    get recordings(): RecordingsAccessor;
     setSessionId(sessionId: string): void;
     stream(name: string): SessionStream;
     
     doc(key: string): SessionDocumentImpl;
     
+    get presence(): Presence;
+    
+    connectDocs(connector: DocConnector): void;
+    
+    setDocTransport(opts: {
+        wsUrl: string;
+        token?: string;
+        webSocket?: typeof WebSocket;
+    }): void;
+    
+    useStreamDataTransport(transport: StreamDataTransport): void;
+    
     sendImage(value: string): Promise<unknown>;
     
     sendImageLegacyDesired(value: string): void;
@@ -212,4 +318,4 @@ declare class RequestCancelledError extends RequestError {
     constructor(requestId?: string);
 }
 
-export { App, App$1 as AppInterface, AppOptions, AttachOptions, DEFAULT_DOC_SYNC_TIMEOUT_MS, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, Session, SessionDocument, Session$1 as SessionInterface, SessionPhase, SessionStream$1 as SessionStream, SessionText, Store, StoreOptions, StreamDirectionConflict, type VideoStreamOptions, createStore, videoStream };
+export { App, App$1 as AppInterface, AppOptions, AttachOptions, ChunkReadable, DEFAULT_DOC_SYNC_TIMEOUT_MS, InvalidDurationError, PermanentLockedError, PinRequiresActiveTempError, Presence, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, Session, SessionDocument, Session$1 as SessionInterface, SessionPhase, SessionStream$1 as SessionStream, SessionText, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type VideoStreamOptions, createRecordingsClient, createStore, isDurationString, normalizeRetention, videoStream };