@waitaya.buc/client-js 0.1.0-alpha.0

package/dist/core/types/session.types.d.ts

@@ -0,0 +1,57 @@
+import type { User } from './user.types';
+import type { MediaOptions } from './media.types';
+import type { EventHandlers } from './events.types';
+/**
+ * Session type.
+ *
+ * - `group` - Multi-party call (SFU/MCU)
+ * - `p2p` - Peer-to-peer call (2 participants)
+ */
+export type SessionType = 'group' | 'p2p';
+/**
+ * Session connection state.
+ *
+ * - `idle` - Not connected
+ * - `connecting` - Connection in progress
+ * - `connected` - Successfully connected
+ * - `reconnecting` - Attempting to reconnect after disconnect
+ * - `disconnected` - Disconnected from session
+ * - `ended` - Session has ended
+ */
+export type SessionState = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected' | 'ended';
+/**
+ * Reconnect policy configuration
+ */
+export interface ReconnectPolicy {
+    /** Max retry attempts (default: 5) */
+    maxRetries: number;
+    /** Backoff delay in ms (default: 1000) */
+    backoffMs: number;
+}
+/**
+ * Session options
+ */
+export interface SessionOptions {
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnect policy */
+    reconnectPolicy?: ReconnectPolicy;
+}
+/**
+ * Parameters for Vroom.connect()
+ */
+export interface ConnectParams {
+    /** Room identifier */
+    roomName: string;
+    /** User info */
+    user: User;
+    /** Session type */
+    type: SessionType;
+    /** Initial media settings */
+    media?: MediaOptions;
+    /** Session options */
+    options?: SessionOptions;
+    /** Event handlers */
+    eventHandlers?: EventHandlers;
+}
+//# sourceMappingURL=session.types.d.ts.map

package/dist/core/types/session.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/session.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,CAAA;AAEzC;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,CAAA;AAE1G;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,uBAAuB;IACvB,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB;IAChB,IAAI,EAAE,IAAI,CAAA;IACV,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAA;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,sBAAsB;IACtB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,qBAAqB;IACrB,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B"}

package/dist/core/types/session.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.types.js.map

package/dist/core/types/session.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.types.js","sourceRoot":"","sources":["../../../src/core/types/session.types.ts"],"names":[],"mappings":""}

package/dist/core/types/stats.types.d.ts

@@ -0,0 +1,20 @@
+import type { NetworkQualityEvent } from './events.types';
+export type { NetworkQuality, NetworkQualityEvent } from './events.types';
+/**
+ * Stats service event names
+ */
+export declare const StatsEvent: {
+    readonly NetworkQuality: "network-quality";
+};
+export type StatsEventName = (typeof StatsEvent)[keyof typeof StatsEvent];
+/**
+ * Stats event handler types mapped by event name
+ */
+export interface StatsEventMap {
+    [StatsEvent.NetworkQuality]: (event: NetworkQualityEvent) => void;
+}
+/**
+ * Stats event handler type (union of all possible handlers)
+ */
+export type StatsEventHandler = StatsEventMap[StatsEventName];
+//# sourceMappingURL=stats.types.d.ts.map

package/dist/core/types/stats.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/stats.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAGzD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AAEzE;;GAEG;AACH,eAAO,MAAM,UAAU;;CAEb,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAA;CAClE;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,cAAc,CAAC,CAAA"}

package/dist/core/types/stats.types.js

@@ -0,0 +1,7 @@
+/**
+ * Stats service event names
+ */
+export const StatsEvent = {
+    NetworkQuality: 'network-quality',
+};
+//# sourceMappingURL=stats.types.js.map

package/dist/core/types/stats.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.types.js","sourceRoot":"","sources":["../../../src/core/types/stats.types.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,cAAc,EAAE,iBAAiB;CACzB,CAAA"}

package/dist/core/types/token.types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Allowed features from sessionToken feat[] claim
+ */
+export declare const AllowedFeature: {
+    readonly Rtc: "rtc";
+    readonly Chat: "chat";
+    readonly Presence: "presence";
+    readonly Recording: "recording";
+    readonly Notetaker: "notetaker";
+    readonly Moderation: "moderation";
+    readonly Stats: "stats";
+};
+export type AllowedFeature = (typeof AllowedFeature)[keyof typeof AllowedFeature];
+/**
+ * User roles from sessionToken role claim
+ *
+ * - `host` - Full control: can mute/kick/ban anyone, start/stop recording
+ * - `moderator` - Room creator or first participant, can mute/kick participants
+ * - `member` - Standard participant (default)
+ * - `viewer` - View-only access, cannot publish tracks
+ */
+export declare const UserRole: {
+    readonly Host: "host";
+    readonly Moderator: "moderator";
+    readonly Member: "member";
+    readonly Viewer: "viewer";
+};
+export type UserRole = (typeof UserRole)[keyof typeof UserRole];
+/**
+ * SessionToken (Vroom JWT) payload structure
+ *
+ * Received from POST /v1/rtc/token
+ *
+ * @example
+ * {
+ *   "iss": "vroom-sdk-api",
+ *   "iat": 1234567890,
+ *   "exp": 1234589490,
+ *   "kid": "key-001",
+ *   "pid": "proj-001",
+ *   "feat": ["rtc", "chat", "presence", "recording"],
+ *   "uid": "user-123",
+ *   "room": "my-room",
+ *   "role": "moderator"
+ * }
+ */
+export interface SessionTokenPayload {
+    /** Issuer (always "vroom-sdk-api") */
+    iss: string;
+    /** Issued at (Unix timestamp) */
+    iat: number;
+    /** Expiration time (Unix timestamp) */
+    exp: number;
+    /** API Key ID */
+    kid: string;
+    /** Project ID */
+    pid: string;
+    /** Allowed features */
+    feat: AllowedFeature[];
+    /** User ID */
+    uid: string;
+    /** Room name */
+    room: string;
+    /** User role */
+    role: UserRole;
+}
+/**
+ * Parsed session permissions for SDK use
+ */
+export interface SessionPermissions {
+    /** List of allowed features */
+    features: AllowedFeature[];
+    /** User role in the room */
+    role: UserRole;
+    /** User ID */
+    userId: string;
+    /** Room name */
+    roomName: string;
+    /** Token expiration time */
+    expiresAt: number;
+}
+//# sourceMappingURL=token.types.d.ts.map

package/dist/core/types/token.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/token.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;CAQjB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;AAEjF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,uBAAuB;IACvB,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,cAAc;IACd,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,CAAA;IACd,cAAc;IACd,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/core/types/token.types.js

@@ -0,0 +1,27 @@
+/**
+ * Allowed features from sessionToken feat[] claim
+ */
+export const AllowedFeature = {
+    Rtc: 'rtc',
+    Chat: 'chat',
+    Presence: 'presence',
+    Recording: 'recording',
+    Notetaker: 'notetaker',
+    Moderation: 'moderation',
+    Stats: 'stats',
+};
+/**
+ * User roles from sessionToken role claim
+ *
+ * - `host` - Full control: can mute/kick/ban anyone, start/stop recording
+ * - `moderator` - Room creator or first participant, can mute/kick participants
+ * - `member` - Standard participant (default)
+ * - `viewer` - View-only access, cannot publish tracks
+ */
+export const UserRole = {
+    Host: 'host',
+    Moderator: 'moderator',
+    Member: 'member',
+    Viewer: 'viewer',
+};
+//# sourceMappingURL=token.types.js.map

package/dist/core/types/token.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.types.js","sourceRoot":"","sources":["../../../src/core/types/token.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;CACN,CAAA;AAIV;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAA"}

package/dist/core/types/track.types.d.ts

@@ -0,0 +1,39 @@
+import type { Participant } from './participant.types';
+/**
+ * Track kind constants.
+ */
+export declare const TrackKind: {
+    readonly Audio: "audio";
+    readonly Video: "video";
+    readonly Screen: "screen";
+};
+export type TrackKind = (typeof TrackKind)[keyof typeof TrackKind];
+/**
+ * Track represents an audio, video, or screen stream
+ */
+export interface Track {
+    /** Track ID */
+    id: string;
+    /** Track kind */
+    kind: TrackKind;
+    /** Whether track is enabled */
+    enabled: boolean;
+    /** Whether track is muted */
+    muted: boolean;
+    /** Participant who owns this track */
+    participant: Participant;
+    /**
+     * The underlying MediaStreamTrack for attaching to DOM elements.
+     * Use this to display video/audio in your application.
+     *
+     * @example
+     * // Web
+     * videoElement.srcObject = new MediaStream([track.mediaStreamTrack])
+     *
+     * // React Native
+     * // import { RTCView } from '@waitaya.buc/client-js/react-native'
+     * <RTCView streamURL={track.mediaStreamTrack.id} />
+     */
+    mediaStreamTrack?: MediaStreamTrack;
+}
+//# sourceMappingURL=track.types.d.ts.map

package/dist/core/types/track.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/track.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,eAAe;IACf,EAAE,EAAE,MAAM,CAAA;IACV,iBAAiB;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,+BAA+B;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,sCAAsC;IACtC,WAAW,EAAE,WAAW,CAAA;IACxB;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC"}

package/dist/core/types/track.types.js

@@ -0,0 +1,9 @@
+/**
+ * Track kind constants.
+ */
+export const TrackKind = {
+    Audio: 'audio',
+    Video: 'video',
+    Screen: 'screen',
+};
+//# sourceMappingURL=track.types.js.map

package/dist/core/types/track.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.types.js","sourceRoot":"","sources":["../../../src/core/types/track.types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAA"}

package/dist/core/types/user.types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * User role in a session.
+ *
+ * - `host` - Full control: can mute/kick/ban anyone, start/stop recording
+ * - `moderator` - Room creator or first participant, can mute/kick participants
+ * - `member` - Standard participant (default)
+ * - `viewer` - View-only access, cannot publish tracks
+ */
+export type UserRole = 'host' | 'moderator' | 'member' | 'viewer';
+/**
+ * User information for connecting to a session.
+ */
+export interface User {
+    /** Unique identifier for the user (max 64 chars) */
+    id: string;
+    /** Display name shown to other participants */
+    displayName: string;
+    /** User's role in the session */
+    role: UserRole;
+    /** Optional custom metadata (e.g., avatarUrl, department) */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=user.types.d.ts.map

package/dist/core/types/user.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/user.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAA;IAEV,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAA;IAEnB,iCAAiC;IACjC,IAAI,EAAE,QAAQ,CAAA;IAEd,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC"}

package/dist/core/types/user.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user.types.js.map

package/dist/core/types/user.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.types.js","sourceRoot":"","sources":["../../../src/core/types/user.types.ts"],"names":[],"mappings":""}

package/dist/core/types/vroom.types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Logger level.
+ *
+ * - `debug` - Verbose logging for development
+ * - `info` - General information
+ * - `warn` - Warnings
+ * - `error` - Errors only
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger configuration
+ */
+export interface LoggerConfig {
+    /** Log level */
+    level: LogLevel;
+    /** Custom log handler */
+    handler?: (level: LogLevel, message: string, context?: unknown) => void;
+}
+/**
+ * Platform type for API key validation
+ */
+export type Platform = 'web' | 'ios' | 'android';
+/**
+ * Platform info for API key validation.
+ * Different platforms require different identifiers.
+ */
+export type PlatformInfo = {
+    platform: 'web';
+    domain: string;
+} | {
+    platform: 'ios';
+    bundleId: string;
+} | {
+    platform: 'android';
+    packageName: string;
+};
+/**
+ * RTC provider constants
+ */
+export declare const Provider: {
+    readonly LiveKit: "LiveKit";
+    readonly Banuba: "Banuba";
+};
+/**
+ * RTC provider type
+ */
+export type ProviderType = (typeof Provider)[keyof typeof Provider];
+/**
+ * Default Vroom API endpoint
+ */
+export declare const DEFAULT_VROOM_ENDPOINT = "https://vroom-sdk-api-dev.truevirtualworld.com";
+/**
+ * Configuration for Vroom.init()
+ */
+export interface VroomInitConfig {
+    /** Vroom API key */
+    apiKey: string;
+    /** Vroom backend endpoint (optional) */
+    endpoint?: string;
+    /** Region preference */
+    region?: string;
+    /** Logger configuration */
+    logger?: LoggerConfig;
+    /**
+     * Platform information for API key validation.
+     * Required for non-web platforms (iOS, Android).
+     * Auto-detected on web from window.location.hostname.
+     *
+     * @example
+     * // iOS
+     * { platform: 'ios', bundleId: 'com.example.app' }
+     *
+     * // Android
+     * { platform: 'android', packageName: 'com.example.app' }
+     */
+    platformInfo?: PlatformInfo;
+}
+/**
+ * Internal configuration with platform info (used by API client)
+ * @internal
+ */
+export interface VroomInitConfigInternal extends VroomInitConfig {
+    /** Platform information for API key validation (auto-detected by SDK) */
+    platformInfo: PlatformInfo;
+}
+//# sourceMappingURL=vroom.types.d.ts.map

package/dist/core/types/vroom.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vroom.types.d.ts","sourceRoot":"","sources":["../../../src/core/types/vroom.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,KAAK,EAAE,QAAQ,CAAA;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACxE;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,QAAQ;;;CAGX,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,sBAAsB,mDAAmD,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,yEAAyE;IACzE,YAAY,EAAE,YAAY,CAAA;CAC3B"}

package/dist/core/types/vroom.types.js

@@ -0,0 +1,12 @@
+/**
+ * RTC provider constants
+ */
+export const Provider = {
+    LiveKit: 'LiveKit',
+    Banuba: 'Banuba',
+};
+/**
+ * Default Vroom API endpoint
+ */
+export const DEFAULT_VROOM_ENDPOINT = 'https://vroom-sdk-api-dev.truevirtualworld.com';
+//# sourceMappingURL=vroom.types.js.map

package/dist/core/types/vroom.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vroom.types.js","sourceRoot":"","sources":["../../../src/core/types/vroom.types.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAA;AAOV;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,gDAAgD,CAAA"}

package/dist/core/utils/token.d.ts

@@ -0,0 +1,77 @@
+import { UserRole, type SessionPermissions, type AllowedFeature } from '../types/token.types';
+/**
+ * TokenService handles sessionToken decoding and permission checking.
+ *
+ * This is a core utility (not a domain service) because:
+ * - JWT decode logic is provider-agnostic
+ * - No events or lifecycle management needed
+ * - Used internally by Vroom.connect() and Session
+ *
+ * @example
+ * ```typescript
+ * const token = new TokenService(sessionToken)
+ *
+ * // Check feature availability
+ * if (token.hasFeature('recording')) {
+ *   // Recording is allowed
+ * }
+ *
+ * // Check role
+ * if (token.canModerate()) {
+ *   // User is host or moderator
+ * }
+ * ```
+ */
+export declare class TokenService {
+    private payload;
+    private permissions;
+    constructor(sessionToken: string);
+    /**
+     * Get all allowed features
+     */
+    getFeatures(): AllowedFeature[];
+    /**
+     * Check if a specific feature is allowed
+     */
+    hasFeature(feature: AllowedFeature): boolean;
+    /**
+     * Get user role
+     */
+    getRole(): UserRole;
+    /**
+     * Check if user has host role
+     */
+    isHost(): boolean;
+    /**
+     * Check if user has moderator role
+     */
+    isModerator(): boolean;
+    /**
+     * Check if user can moderate (host or moderator)
+     */
+    canModerate(): boolean;
+    /**
+     * Get full permissions object
+     */
+    getPermissions(): SessionPermissions;
+    /**
+     * Check if token is expired
+     */
+    isExpired(): boolean;
+    /**
+     * Decode JWT token (without verification)
+     *
+     * JWT structure: header.payload.signature
+     * We only need the payload part which is base64url encoded
+     */
+    private decodeToken;
+    /**
+     * Base64URL decode (handles URL-safe base64)
+     */
+    private base64UrlDecode;
+    /**
+     * Extract permissions from token payload
+     */
+    private extractPermissions;
+}
+//# sourceMappingURL=token.d.ts.map

package/dist/core/utils/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/core/utils/token.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAER,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAA;AAI7B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAoB;gBAE3B,YAAY,EAAE,MAAM;IAKhC;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAI5C;;OAEG;IACH,OAAO,IAAI,QAAQ;IAInB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,cAAc,IAAI,kBAAkB;IAIpC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/core/utils/token.js

@@ -0,0 +1,127 @@
+import { UserRole, } from '../types/token.types';
+import { VroomError } from '../errors/vroom.error';
+import { ErrorCodes } from '../errors/error-codes';
+/**
+ * TokenService handles sessionToken decoding and permission checking.
+ *
+ * This is a core utility (not a domain service) because:
+ * - JWT decode logic is provider-agnostic
+ * - No events or lifecycle management needed
+ * - Used internally by Vroom.connect() and Session
+ *
+ * @example
+ * ```typescript
+ * const token = new TokenService(sessionToken)
+ *
+ * // Check feature availability
+ * if (token.hasFeature('recording')) {
+ *   // Recording is allowed
+ * }
+ *
+ * // Check role
+ * if (token.canModerate()) {
+ *   // User is host or moderator
+ * }
+ * ```
+ */
+export class TokenService {
+    constructor(sessionToken) {
+        this.payload = this.decodeToken(sessionToken);
+        this.permissions = this.extractPermissions(this.payload);
+    }
+    /**
+     * Get all allowed features
+     */
+    getFeatures() {
+        return [...this.permissions.features];
+    }
+    /**
+     * Check if a specific feature is allowed
+     */
+    hasFeature(feature) {
+        return this.permissions.features.includes(feature);
+    }
+    /**
+     * Get user role
+     */
+    getRole() {
+        return this.permissions.role;
+    }
+    /**
+     * Check if user has host role
+     */
+    isHost() {
+        return this.permissions.role === UserRole.Host;
+    }
+    /**
+     * Check if user has moderator role
+     */
+    isModerator() {
+        return this.permissions.role === UserRole.Moderator;
+    }
+    /**
+     * Check if user can moderate (host or moderator)
+     */
+    canModerate() {
+        return this.isHost() || this.isModerator();
+    }
+    /**
+     * Get full permissions object
+     */
+    getPermissions() {
+        return { ...this.permissions };
+    }
+    /**
+     * Check if token is expired
+     */
+    isExpired() {
+        return Date.now() >= this.permissions.expiresAt;
+    }
+    /**
+     * Decode JWT token (without verification)
+     *
+     * JWT structure: header.payload.signature
+     * We only need the payload part which is base64url encoded
+     */
+    decodeToken(token) {
+        try {
+            const parts = token.split('.');
+            if (parts.length !== 3) {
+                throw new Error('Invalid JWT format');
+            }
+            // Decode payload (second part)
+            const payload = this.base64UrlDecode(parts[1]);
+            return JSON.parse(payload);
+        }
+        catch (error) {
+            throw new VroomError(ErrorCodes.E_INVALID_TOKEN, 'Failed to decode session token', error);
+        }
+    }
+    /**
+     * Base64URL decode (handles URL-safe base64)
+     */
+    base64UrlDecode(str) {
+        // Replace URL-safe characters
+        let base64 = str.replace(/-/g, '+').replace(/_/g, '/');
+        // Add padding if needed
+        const padding = base64.length % 4;
+        if (padding) {
+            base64 += '='.repeat(4 - padding);
+        }
+        // Decode
+        return atob(base64);
+    }
+    /**
+     * Extract permissions from token payload
+     */
+    extractPermissions(payload) {
+        return {
+            features: payload.feat || [],
+            role: payload.role,
+            userId: payload.uid,
+            roomName: payload.room,
+            expiresAt: payload.exp * 1000, // Convert to milliseconds
+        };
+    }
+}
+//# sourceMappingURL=token.js.map

package/dist/core/utils/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../src/core/utils/token.ts"],"names":[],"mappings":"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"}