@urun-sh/core 0.2.7 → 0.2.9

package/dist/index.browser.d.mts

@@ -1,10 +1,39 @@
-import { b as AppOptions, a as App$1, J as SessionPhase, Q as SessionStatus, A as AccessTokenOptions, x as RuntimeArtifact, y as RuntimeArtifactDownload, R as Recording, F as Session$1, C as ChannelEndpoint, Z as TransportSession, c as AttachOptions, u as RecordingsAccessor, z as RuntimeArtifactsAccessor, T as SessionStream$1, Y as StreamDataTransport, H as SessionDocumentImpl, X as StreamChunkOptions, g as ChunkReadable, P as Presence, j as DocConnector, v as RequestOptions, w as RequestStreamOptions, W as StoreOptions, V as Store, e as ChannelMultiplexer, I as SessionFailureKind } from './stream-data-B16nTnox.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, B as RuntimeAvailability, S as SceneContext, E as SceneGraph, G as SessionDocument, K as SessionPhaseError, N as SessionPhaseName, U as SessionText, $ as TransportState, a3 as isPendingRecording, a4 as mediaRecorderChunkSource } from './stream-data-B16nTnox.mjs';
+import { b as AppOptions, a as App$1, K as SessionPhase, T as SessionStatus, O as SessionPhaseName, A as AccessTokenOptions$1, y as RuntimeArtifact, z as RuntimeArtifactDownload, R as Recording, G as Session$1, C as ChannelEndpoint, _ as TransportSession, c as AttachOptions, v as RecordingsAccessor, B as RuntimeArtifactsAccessor, U as SessionStream$1, Z as StreamDataTransport, I as SessionDocumentImpl, Y as StreamChunkOptions, g as ChunkReadable, P as Presence, k as DocConnector, w as RequestOptions, x as RequestStreamOptions, X as StoreOptions, W as Store, e as ChannelMultiplexer, J as SessionFailureKind } from './stream-data-DWu57atL.mjs';
+export { L as Layer, l as LayoutConfig, m as LayoutContext, M as MediaChunkBinding, o as MediaChunkSource, p as MediaChunkSourceFactory, q as MediaRecorderChunkSourceOptions, r as PresenceState, s as RecordingBucket, t as RecordingLifecycle, u as RecordingStatus, E as RuntimeAvailability, S as SceneContext, F as SceneGraph, H as SessionDocument, N as SessionPhaseError, V as SessionText, a0 as TransportState, a4 as isPendingRecording, a5 as mediaRecorderChunkSource } from './stream-data-DWu57atL.mjs';
 import 'yjs';
 import 'y-protocols/awareness';
 
 declare function App(appId: string, options: AppOptions): App$1;
 
+interface AccessTokenOptions {
+    forceRefresh?: boolean;
+    reason?: 'initial' | 'unauthorized' | 'background';
+}
+interface PrewakeOptions {
+    baseUrl: string;
+    
+    app: string;
+    
+    functionName: string;
+    orgId: string;
+    jwt?: string;
+    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    authProvider?: string;
+}
+type PrewakeStatus = 'warming' | 'prebound' | 'unknown-app' | 'unavailable';
+interface PrewakeResult {
+    
+    status: PrewakeStatus;
+    
+    expiresAt?: string;
+    
+    warmCapable?: boolean;
+}
+
+declare function prewake(options: PrewakeOptions): Promise<PrewakeResult>;
+
+declare function isWakingPhase(phase: SessionPhase | SessionPhaseName | null | undefined): boolean;
+
 interface PhaseObservable {
     
     readonly phase: SessionPhase;
@@ -32,7 +61,7 @@ interface RuntimeArtifactsClientOptions {
     fallbackUrls?: readonly string[];
     orgId: string;
     jwt?: string;
-    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    getAccessToken?: (options?: AccessTokenOptions$1) => string | null | undefined | Promise<string | null | undefined>;
     authProvider?: string;
 }
 declare class RuntimeArtifactsError extends Error {
@@ -69,7 +98,7 @@ interface RecordingsClientOptions {
     
     jwt?: string;
     
-    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    getAccessToken?: (options?: AccessTokenOptions$1) => string | null | undefined | Promise<string | null | undefined>;
     
     authProvider?: string;
 }
@@ -227,6 +256,10 @@ declare class Session implements Session$1 {
     private _recordingsAccessor;
     
     private _artifactsAccessor;
+    
+    private _recoveryHooks;
+    
+    private _lifecycleUnsub;
     constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession, recordingsAuth?: RecordingsClientOptions, artifactsAuth?: RuntimeArtifactsClientOptions);
     private _wireControlDocIncarnation;
     
@@ -235,6 +268,8 @@ declare class Session implements Session$1 {
     
     get phase(): SessionPhase;
     
+    get endsAt(): Date | null;
+    
     get status(): SessionStatus;
     
     onPhase(handler: (phase: SessionPhase) => void): () => void;
@@ -273,9 +308,17 @@ declare class Session implements Session$1 {
     requestStream(payload: unknown, options?: RequestStreamOptions): AsyncIterable<string>;
     
     complete(payload: unknown, options?: RequestStreamOptions): Promise<unknown>;
+    
+    recover(): void;
+    
+    onRecovery(hook: () => void): () => void;
     disconnect(): void;
 }
 
+declare const FOREGROUND_COALESCE_MS = 250;
+
+declare function observePageLifecycle(onForeground: () => void): () => void;
+
 declare function createStore(options: StoreOptions): Store & {
     _getInternals(): {
         multiplexer: ChannelMultiplexer;
@@ -359,4 +402,49 @@ declare class SessionAllocationError extends Error {
     });
 }
 
-export { App, App$1 as AppInterface, AppOptions, AttachOptions, ChunkReadable, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_WHEN_LIVE_TIMEOUT_MS, InvalidDurationError, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type VideoStreamOptions, type WhenLiveOptions, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, isDurationString, normalizeRetention, sessionFailureFromMediaError, videoStream, whenLive };
+type CaptureKind = 'audio' | 'video';
+type GetUserMedia = (constraints: MediaStreamConstraints) => Promise<MediaStream>;
+
+declare class CaptureUnavailableError extends Error {
+    constructor();
+}
+
+interface CaptureClaim {
+    readonly kind: CaptureKind;
+    
+    readonly track: MediaStreamTrack | null;
+    
+    readonly stream: MediaStream | null;
+    
+    update(constraints: MediaTrackConstraints): Promise<MediaStreamTrack>;
+    
+    release(): void;
+    
+    onTrack(listener: (track: MediaStreamTrack, stream: MediaStream) => void): () => void;
+    
+    onLost(listener: (error: Error) => void): () => void;
+}
+interface CaptureControllerOptions {
+    
+    getUserMedia?: GetUserMedia;
+}
+
+declare class CaptureController {
+    private readonly claims;
+    private readonly injectedGetUserMedia?;
+    private queue;
+    constructor(options?: CaptureControllerOptions);
+    
+    claim(kind: CaptureKind, constraints: MediaTrackConstraints): Promise<CaptureClaim>;
+    
+    idle(): Promise<void>;
+    private enqueue;
+    private resolveGetUserMedia;
+    
+    private converge;
+    private createState;
+}
+
+declare function sharedCaptureController(): CaptureController;
+
+export { App, App$1 as AppInterface, AppOptions, AttachOptions, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_WHEN_LIVE_TIMEOUT_MS, FOREGROUND_COALESCE_MS, InvalidDurationError, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, type PrewakeOptions, type PrewakeResult, type PrewakeStatus, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type VideoStreamOptions, type WhenLiveOptions, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, isDurationString, isWakingPhase, normalizeRetention, observePageLifecycle, prewake, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive };

package/dist/index.browser.d.ts

@@ -1,10 +1,39 @@
-import { b as AppOptions, a as App$1, J as SessionPhase, Q as SessionStatus, A as AccessTokenOptions, x as RuntimeArtifact, y as RuntimeArtifactDownload, R as Recording, F as Session$1, C as ChannelEndpoint, Z as TransportSession, c as AttachOptions, u as RecordingsAccessor, z as RuntimeArtifactsAccessor, T as SessionStream$1, Y as StreamDataTransport, H as SessionDocumentImpl, X as StreamChunkOptions, g as ChunkReadable, P as Presence, j as DocConnector, v as RequestOptions, w as RequestStreamOptions, W as StoreOptions, V as Store, e as ChannelMultiplexer, I as SessionFailureKind } from './stream-data-B16nTnox.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, B as RuntimeAvailability, S as SceneContext, E as SceneGraph, G as SessionDocument, K as SessionPhaseError, N as SessionPhaseName, U as SessionText, $ as TransportState, a3 as isPendingRecording, a4 as mediaRecorderChunkSource } from './stream-data-B16nTnox.js';
+import { b as AppOptions, a as App$1, K as SessionPhase, T as SessionStatus, O as SessionPhaseName, A as AccessTokenOptions$1, y as RuntimeArtifact, z as RuntimeArtifactDownload, R as Recording, G as Session$1, C as ChannelEndpoint, _ as TransportSession, c as AttachOptions, v as RecordingsAccessor, B as RuntimeArtifactsAccessor, U as SessionStream$1, Z as StreamDataTransport, I as SessionDocumentImpl, Y as StreamChunkOptions, g as ChunkReadable, P as Presence, k as DocConnector, w as RequestOptions, x as RequestStreamOptions, X as StoreOptions, W as Store, e as ChannelMultiplexer, J as SessionFailureKind } from './stream-data-DWu57atL.js';
+export { L as Layer, l as LayoutConfig, m as LayoutContext, M as MediaChunkBinding, o as MediaChunkSource, p as MediaChunkSourceFactory, q as MediaRecorderChunkSourceOptions, r as PresenceState, s as RecordingBucket, t as RecordingLifecycle, u as RecordingStatus, E as RuntimeAvailability, S as SceneContext, F as SceneGraph, H as SessionDocument, N as SessionPhaseError, V as SessionText, a0 as TransportState, a4 as isPendingRecording, a5 as mediaRecorderChunkSource } from './stream-data-DWu57atL.js';
 import 'yjs';
 import 'y-protocols/awareness';
 
 declare function App(appId: string, options: AppOptions): App$1;
 
+interface AccessTokenOptions {
+    forceRefresh?: boolean;
+    reason?: 'initial' | 'unauthorized' | 'background';
+}
+interface PrewakeOptions {
+    baseUrl: string;
+    
+    app: string;
+    
+    functionName: string;
+    orgId: string;
+    jwt?: string;
+    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    authProvider?: string;
+}
+type PrewakeStatus = 'warming' | 'prebound' | 'unknown-app' | 'unavailable';
+interface PrewakeResult {
+    
+    status: PrewakeStatus;
+    
+    expiresAt?: string;
+    
+    warmCapable?: boolean;
+}
+
+declare function prewake(options: PrewakeOptions): Promise<PrewakeResult>;
+
+declare function isWakingPhase(phase: SessionPhase | SessionPhaseName | null | undefined): boolean;
+
 interface PhaseObservable {
     
     readonly phase: SessionPhase;
@@ -32,7 +61,7 @@ interface RuntimeArtifactsClientOptions {
     fallbackUrls?: readonly string[];
     orgId: string;
     jwt?: string;
-    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    getAccessToken?: (options?: AccessTokenOptions$1) => string | null | undefined | Promise<string | null | undefined>;
     authProvider?: string;
 }
 declare class RuntimeArtifactsError extends Error {
@@ -69,7 +98,7 @@ interface RecordingsClientOptions {
     
     jwt?: string;
     
-    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    getAccessToken?: (options?: AccessTokenOptions$1) => string | null | undefined | Promise<string | null | undefined>;
     
     authProvider?: string;
 }
@@ -227,6 +256,10 @@ declare class Session implements Session$1 {
     private _recordingsAccessor;
     
     private _artifactsAccessor;
+    
+    private _recoveryHooks;
+    
+    private _lifecycleUnsub;
     constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession, recordingsAuth?: RecordingsClientOptions, artifactsAuth?: RuntimeArtifactsClientOptions);
     private _wireControlDocIncarnation;
     
@@ -235,6 +268,8 @@ declare class Session implements Session$1 {
     
     get phase(): SessionPhase;
     
+    get endsAt(): Date | null;
+    
     get status(): SessionStatus;
     
     onPhase(handler: (phase: SessionPhase) => void): () => void;
@@ -273,9 +308,17 @@ declare class Session implements Session$1 {
     requestStream(payload: unknown, options?: RequestStreamOptions): AsyncIterable<string>;
     
     complete(payload: unknown, options?: RequestStreamOptions): Promise<unknown>;
+    
+    recover(): void;
+    
+    onRecovery(hook: () => void): () => void;
     disconnect(): void;
 }
 
+declare const FOREGROUND_COALESCE_MS = 250;
+
+declare function observePageLifecycle(onForeground: () => void): () => void;
+
 declare function createStore(options: StoreOptions): Store & {
     _getInternals(): {
         multiplexer: ChannelMultiplexer;
@@ -359,4 +402,49 @@ declare class SessionAllocationError extends Error {
     });
 }
 
-export { App, App$1 as AppInterface, AppOptions, AttachOptions, ChunkReadable, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_WHEN_LIVE_TIMEOUT_MS, InvalidDurationError, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type VideoStreamOptions, type WhenLiveOptions, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, isDurationString, normalizeRetention, sessionFailureFromMediaError, videoStream, whenLive };
+type CaptureKind = 'audio' | 'video';
+type GetUserMedia = (constraints: MediaStreamConstraints) => Promise<MediaStream>;
+
+declare class CaptureUnavailableError extends Error {
+    constructor();
+}
+
+interface CaptureClaim {
+    readonly kind: CaptureKind;
+    
+    readonly track: MediaStreamTrack | null;
+    
+    readonly stream: MediaStream | null;
+    
+    update(constraints: MediaTrackConstraints): Promise<MediaStreamTrack>;
+    
+    release(): void;
+    
+    onTrack(listener: (track: MediaStreamTrack, stream: MediaStream) => void): () => void;
+    
+    onLost(listener: (error: Error) => void): () => void;
+}
+interface CaptureControllerOptions {
+    
+    getUserMedia?: GetUserMedia;
+}
+
+declare class CaptureController {
+    private readonly claims;
+    private readonly injectedGetUserMedia?;
+    private queue;
+    constructor(options?: CaptureControllerOptions);
+    
+    claim(kind: CaptureKind, constraints: MediaTrackConstraints): Promise<CaptureClaim>;
+    
+    idle(): Promise<void>;
+    private enqueue;
+    private resolveGetUserMedia;
+    
+    private converge;
+    private createState;
+}
+
+declare function sharedCaptureController(): CaptureController;
+
+export { App, App$1 as AppInterface, AppOptions, AttachOptions, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_WHEN_LIVE_TIMEOUT_MS, FOREGROUND_COALESCE_MS, InvalidDurationError, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, type PrewakeOptions, type PrewakeResult, type PrewakeStatus, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type VideoStreamOptions, type WhenLiveOptions, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, isDurationString, isWakingPhase, normalizeRetention, observePageLifecycle, prewake, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive };