@urun-sh/core 0.3.0 → 0.3.1

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { g as AppOptions, f as App$1, a9 as SessionPhase, af as SessionStatus, ab as SessionPhaseName, A as AccessTokenOptions, X as RuntimeArtifact, Y as RuntimeArtifactDownload, R as Recording, a3 as Session$1, C as ChannelEndpoint, as as TransportSession, h as AttachOptions, a4 as SessionDiagnostic, b as ActivationEvent, ae as SessionStatsSample, T as RecordingsAccessor, Z as RuntimeArtifactsAccessor, a7 as SessionEndResult, ag as SessionStream$1, an as StreamDataTransport, a6 as SessionDocumentImpl, am as StreamChunkOptions, m as ChunkReadable, P as Presence, v as DocConnector, w as DocTokenSupplier, V as RequestOptions, W as RequestStreamOptions, al as StoreOptions, ak as Store, k as ChannelMultiplexer, a8 as SessionFailureKind, B as MediaSession, ar as TransportOfferResponse, az as WtAudioLaneSeam, aA as WtAudioUplinkSeam, aH as WtVideoUplinkSeam, aG as WtDataUplinkSender, aE as WtDataLaneSink, av as TransportState } from './stream-data-ChGPDdoN.mjs';
-export { c as ActivationState, i as AudioPlayoutOptions, D as DERIVED_LEG_SEP, n as DGRAM_HEADER_BYTES, r as DerivedLegRole, s as DgramHeader, u as DocConnectionState, I as InboundStatsSample, M as MediaChunkBinding, x as MediaChunkSource, y as MediaChunkSourceFactory, z as MediaRecorderChunkSourceOptions, N as NegotiatorDataLaneSeam, E as NegotiatorOptions, F as PresenceState, G as PrewakeOptions, H as PrewakeResult, J as PrewakeStatus, Q as QuicStreamDataTransport, K as RecordingBucket, O as RecordingLifecycle, S as RecordingStatus, U as ReleaseSessionBeaconOptions, _ as RuntimeAvailability, $ as RuntimeWakeDetail, a0 as RuntimeWakeGolden, a1 as RuntimeWakeReasonCode, a2 as SIGNALING_PROTOCOL_VERSION, a5 as SessionDocument, aa as SessionPhaseError, ad as SessionStatsOptions, ah as SessionText, ai as SignalCarrier, aj as Signaling, ao as TransportEstablishedNotify, ap as TransportNegotiator, aq as TransportOfferRequest, au as TransportSessionSignaling, aw as VideoPlayoutOptions, ax as WT_CONTROL_FRAME_MAX, ay as WT_DATA_STREAM_VERSION, aB as WtControlDecoder, aC as WtControlMessage, aD as WtDataEnvelope, aF as WtDataStreamParser, aJ as consumeWtDataStreams, aN as derivedLegName, aO as derivedLegRole, aP as encodeWtControlFrame, aQ as isPendingRecording, aR as mediaRecorderChunkSource, aS as parseDgramHeader, aT as prewake, aU as releaseSessionBeacon, aX as writeDgramHeader } from './stream-data-ChGPDdoN.mjs';
+import { g as AppOptions, f as App$1, ae as SessionPhase, ak as SessionStatus, ag as SessionPhaseName, A as AccessTokenOptions, $ as RuntimeArtifact, a0 as RuntimeArtifactDownload, T as Recording, aA as TransportState, a8 as Session$1, C as ChannelEndpoint, ax as TransportSession, h as AttachOptions, a9 as SessionDiagnostic, b as ActivationEvent, aj as SessionStatsSample, z as GenerationTick, X as RecordingsAccessor, a1 as RuntimeArtifactsAccessor, ac as SessionEndResult, al as SessionStream$1, as as StreamDataTransport, ab as SessionDocumentImpl, ar as StreamChunkOptions, m as ChunkReadable, P as Presence, v as DocConnector, x as DocTokenSupplier, w as DocServerUrlResolver, Z as RequestOptions, _ as RequestStreamOptions, aq as StoreOptions, ap as Store, k as ChannelMultiplexer, ad as SessionFailureKind, H as MediaSession, aw as TransportOfferResponse, aF as WtAudioLaneSeam, aG as WtAudioUplinkSeam, aN as WtVideoUplinkSeam, aM as WtDataUplinkSender, aK as WtDataLaneSink } from './stream-data-BJoG7tYI.mjs';
+export { c as ActivationState, i as AudioPlayoutOptions, D as DERIVED_LEG_SEP, n as DGRAM_HEADER_BYTES, r as DerivedLegRole, s as DgramHeader, u as DocConnectionState, G as GENERATION_TICK_EMIT_INTERVAL_MS, y as GENERATION_TICK_MAX_EXTRAPOLATION_MS, I as InboundStatsSample, M as MediaChunkBinding, B as MediaChunkSource, E as MediaChunkSourceFactory, F as MediaRecorderChunkSourceOptions, N as NegotiatorDataLaneSeam, J as NegotiatorOptions, K as PresenceState, O as PrewakeOptions, Q as PrewakeResult, R as PrewakeStatus, S as QuicStreamDataTransport, U as RecordingBucket, V as RecordingLifecycle, W as RecordingStatus, Y as ReleaseSessionBeaconOptions, a2 as RuntimeAvailability, a3 as RuntimeWakeDetail, a4 as RuntimeWakeGolden, a5 as RuntimeWakeReasonCode, a6 as SIGNALING_PROTOCOL_VERSION, a7 as STREAM_END, aa as SessionDocument, af as SessionPhaseError, ai as SessionStatsOptions, am as SessionText, an as SignalCarrier, ao as Signaling, at as TransportEstablishedNotify, au as TransportNegotiator, av as TransportOfferRequest, az as TransportSessionSignaling, aB as VideoPlayoutOptions, aC as WT_CONTROL_FRAME_MAX, aD as WT_DATA_STREAM_VERSION, aE as WatchGenerationTickOptions, aH as WtControlDecoder, aI as WtControlMessage, aJ as WtDataEnvelope, aL as WtDataStreamParser, aP as consumeWtDataStreams, aS as decodeStreamEnvelope, aU as derivedLegName, aV as derivedLegRole, aW as encodeStreamEnvelope, aX as encodeWtControlFrame, aY as isPendingRecording, aZ as mediaRecorderChunkSource, a_ as parseDgramHeader, a$ as prewake, b0 as releaseSessionBeacon, b3 as watchGenerationTick, b4 as writeDgramHeader } from './stream-data-BJoG7tYI.mjs';
 import 'yjs';
 import 'y-protocols/awareness';
 
@@ -195,6 +195,100 @@ declare class RecordingsClient {
 
 declare function createRecordingsClient(options: RecordingsClientOptions): RecordingsClient;
 
+declare const USER_ACTIVITY_FIELD = "user_activity";
+
+declare const FOCUS_FIELD = "focus";
+
+declare const USER_ACTIVITY_MIN_INTERVAL_MS = 30000;
+
+type PresenceConnectivityState = 'idle' | 'connecting' | 'ready' | 'transient_failure';
+type PresenceVisibility = 'visible' | 'hidden';
+type PresenceFocus = 'focused' | 'unfocused';
+
+type PresenceInteractionKind = 'typing' | 'pointer' | 'tty';
+
+interface UserActivityPayload {
+    at: number;
+    counts: {
+        typing: number;
+        pointer: number;
+        tty: number;
+        consumer_reads: number;
+    };
+    inflight: number;
+    visibility?: PresenceVisibility;
+    focus?: PresenceFocus;
+}
+
+interface PresenceAwarenessSink {
+    setLocalStateField(field: string, value: unknown): void;
+}
+
+interface PresenceTransportLike {
+    on(event: 'stateChange', handler: (state: TransportState) => void): () => void;
+    readonly state: TransportState;
+}
+interface PresenceTrackerOptions {
+    
+    awareness?: PresenceAwarenessSink;
+    
+    now?: () => number;
+    
+    windowTarget?: Pick<Window, 'addEventListener' | 'removeEventListener'> | null;
+    documentTarget?: (Pick<Document, 'addEventListener' | 'removeEventListener'> & {
+        hasFocus?: () => boolean;
+    }) | null;
+}
+declare class PresenceTracker {
+    private readonly _awareness;
+    private readonly _now;
+    private readonly _win;
+    private _state;
+    private readonly _stateHandlers;
+    private readonly _transportUnsubs;
+    private _disposed;
+    private readonly _counts;
+    private _inflight;
+    private _visibility;
+    private _focus;
+    private _lastSignalAt;
+    private _lastPublishedAt;
+    private _trailing;
+    private _onWindowFocus;
+    private _onWindowBlur;
+    constructor(options?: PresenceTrackerOptions);
+    
+    get state(): PresenceConnectivityState;
+    
+    onState(handler: (state: PresenceConnectivityState) => void): () => void;
+    
+    transportConnecting(): void;
+    
+    transportReady(): void;
+    
+    transportClosed(): void;
+    
+    attachTransport(transport: PresenceTransportLike): () => void;
+    private _setState;
+    
+    interaction(kind: PresenceInteractionKind, count?: number): void;
+    
+    consumerRead(count?: number): void;
+    
+    get inflight(): number;
+    
+    workBegin(): () => void;
+    
+    setVisibility(visibility: PresenceVisibility): void;
+    
+    setFocus(focus: PresenceFocus): void;
+    
+    private _signal;
+    private _publishNow;
+    
+    dispose(): void;
+}
+
 declare const DEFAULT_DOC_SYNC_TIMEOUT_MS = 30000;
 declare class SessionStream implements SessionStream$1 {
     private _name;
@@ -278,6 +372,8 @@ declare class Session implements Session$1 {
     
     private _activity;
     
+    private _presenceTracker;
+    
     private _activation;
     
     private _activeRequests;
@@ -301,6 +397,9 @@ declare class Session implements Session$1 {
     private _dialNegotiation;
     
     private _dialNegotiationStarted;
+    
+    private _generationTickHandlers;
+    private _generationTickStop;
     constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession, recordingsAuth?: RecordingsClientOptions, artifactsAuth?: RuntimeArtifactsClientOptions);
     private _wireControlDocIncarnation;
     
@@ -323,6 +422,8 @@ declare class Session implements Session$1 {
     
     whenLive(options?: WhenLiveOptions): Promise<void>;
     
+    on(event: 'generationTick', handler: (tick: GenerationTick) => void): () => void;
+    
     get recordings(): RecordingsAccessor;
     get artifacts(): RuntimeArtifactsAccessor;
     setArtifactsAuth(auth: RuntimeArtifactsClientOptions): void;
@@ -338,12 +439,15 @@ declare class Session implements Session$1 {
     
     touch(): void;
     
+    get presenceTracker(): PresenceTracker | null;
+    
     connectDocs(connector: DocConnector): void;
     
     setDocTransport(opts: {
         wsUrl: string;
         token?: string | DocTokenSupplier;
         webSocket?: typeof WebSocket;
+        resolveServerUrl?: DocServerUrlResolver;
     }): void;
     
     useStreamDataTransport(transport: StreamDataTransport): void;
@@ -572,12 +676,105 @@ declare class TransportSessionMismatchError extends Error {
 declare class SessionAllocationError extends Error {
     
     readonly httpStatus?: number;
+    
+    readonly code?: string;
+    
+    readonly balanceCredits?: number;
+    
+    readonly platformStatus?: string;
     constructor(message: string, options?: {
         httpStatus?: number;
+        code?: string;
+        balanceCredits?: number;
+        platformStatus?: string;
         cause?: unknown;
     });
 }
 
+interface CreditsClientOptions {
+    
+    functionsUrl: string;
+    
+    orgId: string;
+    
+    apiKey?: string;
+    
+    jwt?: string;
+    
+    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    
+    authProvider?: string;
+}
+
+interface CreditBalance {
+    org_id: string;
+    
+    balance_credits: number;
+    
+    available_credits: number;
+    free_credits: number;
+    subscription_credits: number;
+    purchased_credits: number;
+    overage_credits: number;
+    
+    activated: boolean;
+    
+    exempt: boolean;
+    updated_at: string;
+}
+
+interface CreditLedgerEntry {
+    id: string;
+    
+    delta_credits: number;
+    
+    reason: string;
+    note?: string;
+    
+    session_id?: string;
+    created_at: string;
+}
+
+interface CreditsLedgerOptions {
+    
+    limit?: number;
+}
+
+declare class CreditsError extends Error {
+    
+    readonly status: number;
+    
+    readonly code: string;
+    constructor(message: string, options: {
+        status: number;
+        code: string;
+        cause?: unknown;
+    });
+}
+
+declare class CreditsUnauthorizedError extends CreditsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class CreditsClient {
+    private readonly _options;
+    private readonly _base;
+    constructor(_options: CreditsClientOptions);
+    
+    getBalance(): Promise<CreditBalance>;
+    
+    getLedger(options?: CreditsLedgerOptions): Promise<CreditLedgerEntry[]>;
+    
+    private _request;
+    private _buildUrl;
+    private _fetch;
+    private _resolveToken;
+    private _readJson;
+    private _readError;
+}
+
+declare function createCreditsClient(options: CreditsClientOptions): CreditsClient;
+
 type CaptureKind = 'audio' | 'video';
 type GetUserMedia = (constraints: MediaStreamConstraints) => Promise<MediaStream>;
 
@@ -957,4 +1154,4 @@ declare class FrameReassembler {
     private requestKeyframe;
 }
 
-export { ACTIVATION_COLD_BOOT_AFTER_MS, ACTIVATION_DEGRADED_AFTER_MS, ACTIVATION_HINT_PATH, ACTIVATION_STILL_AFTER_MS, ACTIVITY_DOM_EVENTS, ACTIVITY_FIELD, ACTIVITY_STAMP_MIN_INTERVAL_MS, ActivationEvent, ActivationMonitor, type ActivationMonitorOptions, type ActivationStreamLike, type ActivityAwareness, type ActivityTracker, type ActivityTrackerOptions, App, App$1 as AppInterface, AppOptions, AttachOptions, BACKOFF_BASE_MS, BACKOFF_MAX_ATTEMPTS, BACKOFF_MAX_MS, type CameraWarp, type CameraWarpOptions, type CameraWarpTransform, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, type ClientToken, ClientTokenError, type ConsumingTransport, type CreateClientTokenOptions, DATA_CHANNEL_MESSAGE_CEILING, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DEFAULT_PRODUCE_ACK_TIMEOUT_MS, DEFAULT_REFERENCE_JPEG_QUALITY, DEFAULT_REFERENCE_MAX_SIZE, DEFAULT_WHEN_LIVE_TIMEOUT_MS, DocTokenSupplier, FOREGROUND_COALESCE_MS, FrameReassembler, INPUT_PRESENCE_DEFAULT_HZ, INPUT_PRESENCE_FIELD, type InputPresenceAwareness, type InputPresencePublisher, type InputPresencePublisherOptions, type InputPresenceState, InvalidDurationError, LEGACY_ACTIVATION_HINT_PATH, MediaSession, type NormalizeReferenceImageOptions, PLATFORM_DOC_NAME, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, ProduceAckTimeoutError, type ReassembledFrame, type ReassemblerCallbacks, type ReassemblerOptions, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, type ReferenceImage, type ReferenceImageSource, type ReferenceImageType, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionDiagnostic, SessionEndError, SessionEndResult, SessionEndUnavailableError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatsSample, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, TransportOfferResponse, TransportSessionMismatchError, TransportState, URUN_DEV_ENV, VISIBILITY_FIELD, type VideoStreamOptions, WIRE_MESSAGE_BUDGET, WebRtcSession, WebTransportSession, type WhenLiveOptions, WtDataLaneSink, activationHintFrom, cameraCaptureAvailable, captureStillFromVideo, computeBackoffDelay, createActivityTracker, createCameraWarp, createClientToken, createInputPresencePublisher, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, fitWithin, isDurationString, isRetryableSessionError, isServerTerminalPhase, isWakingPhase, normalizeReferenceImage, normalizeRetention, observeLeaveConfirm, observePageLifecycle, observePageTeardown, referenceImageErrorMessage, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive };
+export { ACTIVATION_COLD_BOOT_AFTER_MS, ACTIVATION_DEGRADED_AFTER_MS, ACTIVATION_HINT_PATH, ACTIVATION_STILL_AFTER_MS, ACTIVITY_DOM_EVENTS, ACTIVITY_FIELD, ACTIVITY_STAMP_MIN_INTERVAL_MS, ActivationEvent, ActivationMonitor, type ActivationMonitorOptions, type ActivationStreamLike, type ActivityAwareness, type ActivityTracker, type ActivityTrackerOptions, App, App$1 as AppInterface, AppOptions, AttachOptions, BACKOFF_BASE_MS, BACKOFF_MAX_ATTEMPTS, BACKOFF_MAX_MS, type CameraWarp, type CameraWarpOptions, type CameraWarpTransform, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, type ClientToken, ClientTokenError, type ConsumingTransport, type CreateClientTokenOptions, type CreditBalance, type CreditLedgerEntry, CreditsClient, type CreditsClientOptions, CreditsError, type CreditsLedgerOptions, CreditsUnauthorizedError, DATA_CHANNEL_MESSAGE_CEILING, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DEFAULT_PRODUCE_ACK_TIMEOUT_MS, DEFAULT_REFERENCE_JPEG_QUALITY, DEFAULT_REFERENCE_MAX_SIZE, DEFAULT_WHEN_LIVE_TIMEOUT_MS, DocTokenSupplier, FOCUS_FIELD, FOREGROUND_COALESCE_MS, FrameReassembler, GenerationTick, INPUT_PRESENCE_DEFAULT_HZ, INPUT_PRESENCE_FIELD, type InputPresenceAwareness, type InputPresencePublisher, type InputPresencePublisherOptions, type InputPresenceState, InvalidDurationError, LEGACY_ACTIVATION_HINT_PATH, MediaSession, type NormalizeReferenceImageOptions, PLATFORM_DOC_NAME, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, type PresenceAwarenessSink, type PresenceConnectivityState, type PresenceFocus, type PresenceInteractionKind, PresenceTracker, type PresenceTrackerOptions, type PresenceTransportLike, type PresenceVisibility, ProduceAckTimeoutError, type ReassembledFrame, type ReassemblerCallbacks, type ReassemblerOptions, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, type ReferenceImage, type ReferenceImageSource, type ReferenceImageType, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionDiagnostic, SessionEndError, SessionEndResult, SessionEndUnavailableError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatsSample, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, TransportOfferResponse, TransportSessionMismatchError, TransportState, URUN_DEV_ENV, USER_ACTIVITY_FIELD, USER_ACTIVITY_MIN_INTERVAL_MS, type UserActivityPayload, VISIBILITY_FIELD, type VideoStreamOptions, WIRE_MESSAGE_BUDGET, WebRtcSession, WebTransportSession, type WhenLiveOptions, WtDataLaneSink, activationHintFrom, cameraCaptureAvailable, captureStillFromVideo, computeBackoffDelay, createActivityTracker, createCameraWarp, createClientToken, createCreditsClient, createInputPresencePublisher, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, fitWithin, isDurationString, isRetryableSessionError, isServerTerminalPhase, isWakingPhase, normalizeReferenceImage, normalizeRetention, observeLeaveConfirm, observePageLifecycle, observePageTeardown, referenceImageErrorMessage, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { g as AppOptions, f as App$1, a9 as SessionPhase, af as SessionStatus, ab as SessionPhaseName, A as AccessTokenOptions, X as RuntimeArtifact, Y as RuntimeArtifactDownload, R as Recording, a3 as Session$1, C as ChannelEndpoint, as as TransportSession, h as AttachOptions, a4 as SessionDiagnostic, b as ActivationEvent, ae as SessionStatsSample, T as RecordingsAccessor, Z as RuntimeArtifactsAccessor, a7 as SessionEndResult, ag as SessionStream$1, an as StreamDataTransport, a6 as SessionDocumentImpl, am as StreamChunkOptions, m as ChunkReadable, P as Presence, v as DocConnector, w as DocTokenSupplier, V as RequestOptions, W as RequestStreamOptions, al as StoreOptions, ak as Store, k as ChannelMultiplexer, a8 as SessionFailureKind, B as MediaSession, ar as TransportOfferResponse, az as WtAudioLaneSeam, aA as WtAudioUplinkSeam, aH as WtVideoUplinkSeam, aG as WtDataUplinkSender, aE as WtDataLaneSink, av as TransportState } from './stream-data-ChGPDdoN.js';
-export { c as ActivationState, i as AudioPlayoutOptions, D as DERIVED_LEG_SEP, n as DGRAM_HEADER_BYTES, r as DerivedLegRole, s as DgramHeader, u as DocConnectionState, I as InboundStatsSample, M as MediaChunkBinding, x as MediaChunkSource, y as MediaChunkSourceFactory, z as MediaRecorderChunkSourceOptions, N as NegotiatorDataLaneSeam, E as NegotiatorOptions, F as PresenceState, G as PrewakeOptions, H as PrewakeResult, J as PrewakeStatus, Q as QuicStreamDataTransport, K as RecordingBucket, O as RecordingLifecycle, S as RecordingStatus, U as ReleaseSessionBeaconOptions, _ as RuntimeAvailability, $ as RuntimeWakeDetail, a0 as RuntimeWakeGolden, a1 as RuntimeWakeReasonCode, a2 as SIGNALING_PROTOCOL_VERSION, a5 as SessionDocument, aa as SessionPhaseError, ad as SessionStatsOptions, ah as SessionText, ai as SignalCarrier, aj as Signaling, ao as TransportEstablishedNotify, ap as TransportNegotiator, aq as TransportOfferRequest, au as TransportSessionSignaling, aw as VideoPlayoutOptions, ax as WT_CONTROL_FRAME_MAX, ay as WT_DATA_STREAM_VERSION, aB as WtControlDecoder, aC as WtControlMessage, aD as WtDataEnvelope, aF as WtDataStreamParser, aJ as consumeWtDataStreams, aN as derivedLegName, aO as derivedLegRole, aP as encodeWtControlFrame, aQ as isPendingRecording, aR as mediaRecorderChunkSource, aS as parseDgramHeader, aT as prewake, aU as releaseSessionBeacon, aX as writeDgramHeader } from './stream-data-ChGPDdoN.js';
+import { g as AppOptions, f as App$1, ae as SessionPhase, ak as SessionStatus, ag as SessionPhaseName, A as AccessTokenOptions, $ as RuntimeArtifact, a0 as RuntimeArtifactDownload, T as Recording, aA as TransportState, a8 as Session$1, C as ChannelEndpoint, ax as TransportSession, h as AttachOptions, a9 as SessionDiagnostic, b as ActivationEvent, aj as SessionStatsSample, z as GenerationTick, X as RecordingsAccessor, a1 as RuntimeArtifactsAccessor, ac as SessionEndResult, al as SessionStream$1, as as StreamDataTransport, ab as SessionDocumentImpl, ar as StreamChunkOptions, m as ChunkReadable, P as Presence, v as DocConnector, x as DocTokenSupplier, w as DocServerUrlResolver, Z as RequestOptions, _ as RequestStreamOptions, aq as StoreOptions, ap as Store, k as ChannelMultiplexer, ad as SessionFailureKind, H as MediaSession, aw as TransportOfferResponse, aF as WtAudioLaneSeam, aG as WtAudioUplinkSeam, aN as WtVideoUplinkSeam, aM as WtDataUplinkSender, aK as WtDataLaneSink } from './stream-data-BJoG7tYI.js';
+export { c as ActivationState, i as AudioPlayoutOptions, D as DERIVED_LEG_SEP, n as DGRAM_HEADER_BYTES, r as DerivedLegRole, s as DgramHeader, u as DocConnectionState, G as GENERATION_TICK_EMIT_INTERVAL_MS, y as GENERATION_TICK_MAX_EXTRAPOLATION_MS, I as InboundStatsSample, M as MediaChunkBinding, B as MediaChunkSource, E as MediaChunkSourceFactory, F as MediaRecorderChunkSourceOptions, N as NegotiatorDataLaneSeam, J as NegotiatorOptions, K as PresenceState, O as PrewakeOptions, Q as PrewakeResult, R as PrewakeStatus, S as QuicStreamDataTransport, U as RecordingBucket, V as RecordingLifecycle, W as RecordingStatus, Y as ReleaseSessionBeaconOptions, a2 as RuntimeAvailability, a3 as RuntimeWakeDetail, a4 as RuntimeWakeGolden, a5 as RuntimeWakeReasonCode, a6 as SIGNALING_PROTOCOL_VERSION, a7 as STREAM_END, aa as SessionDocument, af as SessionPhaseError, ai as SessionStatsOptions, am as SessionText, an as SignalCarrier, ao as Signaling, at as TransportEstablishedNotify, au as TransportNegotiator, av as TransportOfferRequest, az as TransportSessionSignaling, aB as VideoPlayoutOptions, aC as WT_CONTROL_FRAME_MAX, aD as WT_DATA_STREAM_VERSION, aE as WatchGenerationTickOptions, aH as WtControlDecoder, aI as WtControlMessage, aJ as WtDataEnvelope, aL as WtDataStreamParser, aP as consumeWtDataStreams, aS as decodeStreamEnvelope, aU as derivedLegName, aV as derivedLegRole, aW as encodeStreamEnvelope, aX as encodeWtControlFrame, aY as isPendingRecording, aZ as mediaRecorderChunkSource, a_ as parseDgramHeader, a$ as prewake, b0 as releaseSessionBeacon, b3 as watchGenerationTick, b4 as writeDgramHeader } from './stream-data-BJoG7tYI.js';
 import 'yjs';
 import 'y-protocols/awareness';
 
@@ -195,6 +195,100 @@ declare class RecordingsClient {
 
 declare function createRecordingsClient(options: RecordingsClientOptions): RecordingsClient;
 
+declare const USER_ACTIVITY_FIELD = "user_activity";
+
+declare const FOCUS_FIELD = "focus";
+
+declare const USER_ACTIVITY_MIN_INTERVAL_MS = 30000;
+
+type PresenceConnectivityState = 'idle' | 'connecting' | 'ready' | 'transient_failure';
+type PresenceVisibility = 'visible' | 'hidden';
+type PresenceFocus = 'focused' | 'unfocused';
+
+type PresenceInteractionKind = 'typing' | 'pointer' | 'tty';
+
+interface UserActivityPayload {
+    at: number;
+    counts: {
+        typing: number;
+        pointer: number;
+        tty: number;
+        consumer_reads: number;
+    };
+    inflight: number;
+    visibility?: PresenceVisibility;
+    focus?: PresenceFocus;
+}
+
+interface PresenceAwarenessSink {
+    setLocalStateField(field: string, value: unknown): void;
+}
+
+interface PresenceTransportLike {
+    on(event: 'stateChange', handler: (state: TransportState) => void): () => void;
+    readonly state: TransportState;
+}
+interface PresenceTrackerOptions {
+    
+    awareness?: PresenceAwarenessSink;
+    
+    now?: () => number;
+    
+    windowTarget?: Pick<Window, 'addEventListener' | 'removeEventListener'> | null;
+    documentTarget?: (Pick<Document, 'addEventListener' | 'removeEventListener'> & {
+        hasFocus?: () => boolean;
+    }) | null;
+}
+declare class PresenceTracker {
+    private readonly _awareness;
+    private readonly _now;
+    private readonly _win;
+    private _state;
+    private readonly _stateHandlers;
+    private readonly _transportUnsubs;
+    private _disposed;
+    private readonly _counts;
+    private _inflight;
+    private _visibility;
+    private _focus;
+    private _lastSignalAt;
+    private _lastPublishedAt;
+    private _trailing;
+    private _onWindowFocus;
+    private _onWindowBlur;
+    constructor(options?: PresenceTrackerOptions);
+    
+    get state(): PresenceConnectivityState;
+    
+    onState(handler: (state: PresenceConnectivityState) => void): () => void;
+    
+    transportConnecting(): void;
+    
+    transportReady(): void;
+    
+    transportClosed(): void;
+    
+    attachTransport(transport: PresenceTransportLike): () => void;
+    private _setState;
+    
+    interaction(kind: PresenceInteractionKind, count?: number): void;
+    
+    consumerRead(count?: number): void;
+    
+    get inflight(): number;
+    
+    workBegin(): () => void;
+    
+    setVisibility(visibility: PresenceVisibility): void;
+    
+    setFocus(focus: PresenceFocus): void;
+    
+    private _signal;
+    private _publishNow;
+    
+    dispose(): void;
+}
+
 declare const DEFAULT_DOC_SYNC_TIMEOUT_MS = 30000;
 declare class SessionStream implements SessionStream$1 {
     private _name;
@@ -278,6 +372,8 @@ declare class Session implements Session$1 {
     
     private _activity;
     
+    private _presenceTracker;
+    
     private _activation;
     
     private _activeRequests;
@@ -301,6 +397,9 @@ declare class Session implements Session$1 {
     private _dialNegotiation;
     
     private _dialNegotiationStarted;
+    
+    private _generationTickHandlers;
+    private _generationTickStop;
     constructor(sessionId: string, multiplexer: ChannelEndpoint, transport: TransportSession, recordingsAuth?: RecordingsClientOptions, artifactsAuth?: RuntimeArtifactsClientOptions);
     private _wireControlDocIncarnation;
     
@@ -323,6 +422,8 @@ declare class Session implements Session$1 {
     
     whenLive(options?: WhenLiveOptions): Promise<void>;
     
+    on(event: 'generationTick', handler: (tick: GenerationTick) => void): () => void;
+    
     get recordings(): RecordingsAccessor;
     get artifacts(): RuntimeArtifactsAccessor;
     setArtifactsAuth(auth: RuntimeArtifactsClientOptions): void;
@@ -338,12 +439,15 @@ declare class Session implements Session$1 {
     
     touch(): void;
     
+    get presenceTracker(): PresenceTracker | null;
+    
     connectDocs(connector: DocConnector): void;
     
     setDocTransport(opts: {
         wsUrl: string;
         token?: string | DocTokenSupplier;
         webSocket?: typeof WebSocket;
+        resolveServerUrl?: DocServerUrlResolver;
     }): void;
     
     useStreamDataTransport(transport: StreamDataTransport): void;
@@ -572,12 +676,105 @@ declare class TransportSessionMismatchError extends Error {
 declare class SessionAllocationError extends Error {
     
     readonly httpStatus?: number;
+    
+    readonly code?: string;
+    
+    readonly balanceCredits?: number;
+    
+    readonly platformStatus?: string;
     constructor(message: string, options?: {
         httpStatus?: number;
+        code?: string;
+        balanceCredits?: number;
+        platformStatus?: string;
         cause?: unknown;
     });
 }
 
+interface CreditsClientOptions {
+    
+    functionsUrl: string;
+    
+    orgId: string;
+    
+    apiKey?: string;
+    
+    jwt?: string;
+    
+    getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
+    
+    authProvider?: string;
+}
+
+interface CreditBalance {
+    org_id: string;
+    
+    balance_credits: number;
+    
+    available_credits: number;
+    free_credits: number;
+    subscription_credits: number;
+    purchased_credits: number;
+    overage_credits: number;
+    
+    activated: boolean;
+    
+    exempt: boolean;
+    updated_at: string;
+}
+
+interface CreditLedgerEntry {
+    id: string;
+    
+    delta_credits: number;
+    
+    reason: string;
+    note?: string;
+    
+    session_id?: string;
+    created_at: string;
+}
+
+interface CreditsLedgerOptions {
+    
+    limit?: number;
+}
+
+declare class CreditsError extends Error {
+    
+    readonly status: number;
+    
+    readonly code: string;
+    constructor(message: string, options: {
+        status: number;
+        code: string;
+        cause?: unknown;
+    });
+}
+
+declare class CreditsUnauthorizedError extends CreditsError {
+    constructor(message?: string, code?: string);
+}
+
+declare class CreditsClient {
+    private readonly _options;
+    private readonly _base;
+    constructor(_options: CreditsClientOptions);
+    
+    getBalance(): Promise<CreditBalance>;
+    
+    getLedger(options?: CreditsLedgerOptions): Promise<CreditLedgerEntry[]>;
+    
+    private _request;
+    private _buildUrl;
+    private _fetch;
+    private _resolveToken;
+    private _readJson;
+    private _readError;
+}
+
+declare function createCreditsClient(options: CreditsClientOptions): CreditsClient;
+
 type CaptureKind = 'audio' | 'video';
 type GetUserMedia = (constraints: MediaStreamConstraints) => Promise<MediaStream>;
 
@@ -957,4 +1154,4 @@ declare class FrameReassembler {
     private requestKeyframe;
 }
 
-export { ACTIVATION_COLD_BOOT_AFTER_MS, ACTIVATION_DEGRADED_AFTER_MS, ACTIVATION_HINT_PATH, ACTIVATION_STILL_AFTER_MS, ACTIVITY_DOM_EVENTS, ACTIVITY_FIELD, ACTIVITY_STAMP_MIN_INTERVAL_MS, ActivationEvent, ActivationMonitor, type ActivationMonitorOptions, type ActivationStreamLike, type ActivityAwareness, type ActivityTracker, type ActivityTrackerOptions, App, App$1 as AppInterface, AppOptions, AttachOptions, BACKOFF_BASE_MS, BACKOFF_MAX_ATTEMPTS, BACKOFF_MAX_MS, type CameraWarp, type CameraWarpOptions, type CameraWarpTransform, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, type ClientToken, ClientTokenError, type ConsumingTransport, type CreateClientTokenOptions, DATA_CHANNEL_MESSAGE_CEILING, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DEFAULT_PRODUCE_ACK_TIMEOUT_MS, DEFAULT_REFERENCE_JPEG_QUALITY, DEFAULT_REFERENCE_MAX_SIZE, DEFAULT_WHEN_LIVE_TIMEOUT_MS, DocTokenSupplier, FOREGROUND_COALESCE_MS, FrameReassembler, INPUT_PRESENCE_DEFAULT_HZ, INPUT_PRESENCE_FIELD, type InputPresenceAwareness, type InputPresencePublisher, type InputPresencePublisherOptions, type InputPresenceState, InvalidDurationError, LEGACY_ACTIVATION_HINT_PATH, MediaSession, type NormalizeReferenceImageOptions, PLATFORM_DOC_NAME, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, ProduceAckTimeoutError, type ReassembledFrame, type ReassemblerCallbacks, type ReassemblerOptions, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, type ReferenceImage, type ReferenceImageSource, type ReferenceImageType, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionDiagnostic, SessionEndError, SessionEndResult, SessionEndUnavailableError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatsSample, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, TransportOfferResponse, TransportSessionMismatchError, TransportState, URUN_DEV_ENV, VISIBILITY_FIELD, type VideoStreamOptions, WIRE_MESSAGE_BUDGET, WebRtcSession, WebTransportSession, type WhenLiveOptions, WtDataLaneSink, activationHintFrom, cameraCaptureAvailable, captureStillFromVideo, computeBackoffDelay, createActivityTracker, createCameraWarp, createClientToken, createInputPresencePublisher, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, fitWithin, isDurationString, isRetryableSessionError, isServerTerminalPhase, isWakingPhase, normalizeReferenceImage, normalizeRetention, observeLeaveConfirm, observePageLifecycle, observePageTeardown, referenceImageErrorMessage, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive };
+export { ACTIVATION_COLD_BOOT_AFTER_MS, ACTIVATION_DEGRADED_AFTER_MS, ACTIVATION_HINT_PATH, ACTIVATION_STILL_AFTER_MS, ACTIVITY_DOM_EVENTS, ACTIVITY_FIELD, ACTIVITY_STAMP_MIN_INTERVAL_MS, ActivationEvent, ActivationMonitor, type ActivationMonitorOptions, type ActivationStreamLike, type ActivityAwareness, type ActivityTracker, type ActivityTrackerOptions, App, App$1 as AppInterface, AppOptions, AttachOptions, BACKOFF_BASE_MS, BACKOFF_MAX_ATTEMPTS, BACKOFF_MAX_MS, type CameraWarp, type CameraWarpOptions, type CameraWarpTransform, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, type ClientToken, ClientTokenError, type ConsumingTransport, type CreateClientTokenOptions, type CreditBalance, type CreditLedgerEntry, CreditsClient, type CreditsClientOptions, CreditsError, type CreditsLedgerOptions, CreditsUnauthorizedError, DATA_CHANNEL_MESSAGE_CEILING, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DEFAULT_PRODUCE_ACK_TIMEOUT_MS, DEFAULT_REFERENCE_JPEG_QUALITY, DEFAULT_REFERENCE_MAX_SIZE, DEFAULT_WHEN_LIVE_TIMEOUT_MS, DocTokenSupplier, FOCUS_FIELD, FOREGROUND_COALESCE_MS, FrameReassembler, GenerationTick, INPUT_PRESENCE_DEFAULT_HZ, INPUT_PRESENCE_FIELD, type InputPresenceAwareness, type InputPresencePublisher, type InputPresencePublisherOptions, type InputPresenceState, InvalidDurationError, LEGACY_ACTIVATION_HINT_PATH, MediaSession, type NormalizeReferenceImageOptions, PLATFORM_DOC_NAME, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, type PresenceAwarenessSink, type PresenceConnectivityState, type PresenceFocus, type PresenceInteractionKind, PresenceTracker, type PresenceTrackerOptions, type PresenceTransportLike, type PresenceVisibility, ProduceAckTimeoutError, type ReassembledFrame, type ReassemblerCallbacks, type ReassemblerOptions, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, type ReferenceImage, type ReferenceImageSource, type ReferenceImageType, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionDiagnostic, SessionEndError, SessionEndResult, SessionEndUnavailableError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatsSample, SessionStatus, SessionStream$1 as SessionStream, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, TransportOfferResponse, TransportSessionMismatchError, TransportState, URUN_DEV_ENV, USER_ACTIVITY_FIELD, USER_ACTIVITY_MIN_INTERVAL_MS, type UserActivityPayload, VISIBILITY_FIELD, type VideoStreamOptions, WIRE_MESSAGE_BUDGET, WebRtcSession, WebTransportSession, type WhenLiveOptions, WtDataLaneSink, activationHintFrom, cameraCaptureAvailable, captureStillFromVideo, computeBackoffDelay, createActivityTracker, createCameraWarp, createClientToken, createCreditsClient, createInputPresencePublisher, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, fitWithin, isDurationString, isRetryableSessionError, isServerTerminalPhase, isWakingPhase, normalizeReferenceImage, normalizeRetention, observeLeaveConfirm, observePageLifecycle, observePageTeardown, referenceImageErrorMessage, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive };