@applooma/rtc-react-native 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AppLooma LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/THIRD-PARTY-LICENSES

@@ -0,0 +1,6 @@
+AppLooma RTC incorporates the following third-party open source software:
+
+- LiveKit (https://github.com/livekit) — Apache License 2.0
+  Copyright (c) LiveKit, Inc.
+
+Full license text: https://www.apache.org/licenses/LICENSE-2.0

package/dist/index.d.mts

@@ -0,0 +1,125 @@
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+
+/**
+ * AppLooma RTC React Native SDK
+ * © AppLooma LLC
+ *
+ * Call initAppLooma() once at app startup (before joining any channel):
+ *
+ *   import { initAppLooma, AppEngine } from '@applooma/rtc-react-native';
+ *   initAppLooma();
+ */
+
+type AppRole = 'host' | 'cohost' | 'audience';
+type AppConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+interface AppEngineConfig {
+    /** Your AppLooma RTC App ID from applooma.dev/dashboard */
+    appId: string;
+}
+interface AppJoinOptions {
+    role?: AppRole;
+    camera?: boolean;
+    microphone?: boolean;
+}
+/** Must be called once at app startup, before creating an engine. */
+declare function initAppLooma(): void;
+declare class AppRemoteUser {
+    private p;
+    get uid(): string;
+    get displayName(): string | undefined;
+    get metadata(): string | undefined;
+    get isSpeaking(): boolean;
+    get hasVideo(): boolean;
+}
+interface AppEventMap {
+    'user-joined': (user: AppRemoteUser) => void;
+    'user-left': (user: AppRemoteUser) => void;
+    /** A remote user's camera or microphone became available to render. */
+    'track-subscribed': (user: AppRemoteUser) => void;
+    'track-unsubscribed': (user: AppRemoteUser) => void;
+    'connection-state-changed': (state: AppConnectionState) => void;
+    'data-received': (data: Uint8Array, from?: AppRemoteUser) => void;
+    'gift-received': (gift: AppGiftEvent) => void;
+    'active-speakers-changed': (uids: string[]) => void;
+}
+/** A virtual gift broadcast to the room (sent via your server's POST /v1/gifts/send). */
+interface AppGiftEvent {
+    txId: string;
+    gift: {
+        id: string;
+        name: string;
+        imageUrl: string;
+        coinPrice: number;
+    };
+    sender: string;
+    receiver: string;
+    quantity: number;
+    sentAt: string;
+}
+declare class AppEngine {
+    readonly config: AppEngineConfig;
+    private room;
+    private listeners;
+    private users;
+    private joined;
+    private constructor();
+    static create(config: AppEngineConfig): AppEngine;
+    joinChannel(token: string, wsUrl: string, options?: AppJoinOptions): Promise<void>;
+    leaveChannel(): Promise<void>;
+    /** Emits joined/subscribed events for everyone already present at join time. */
+    private seedExistingParticipants;
+    /**
+     * Release the engine. After this the instance cannot be reused.
+     */
+    destroy(): Promise<void>;
+    enableCamera(on?: boolean): Promise<void>;
+    enableMicrophone(on?: boolean): Promise<void>;
+    sendData(data: Uint8Array | string, reliable?: boolean): Promise<void>;
+    get connectionState(): AppConnectionState;
+    get localUid(): string;
+    get channelName(): string;
+    get remoteUsers(): AppRemoteUser[];
+    on<K extends keyof AppEventMap>(event: K, cb: AppEventMap[K]): this;
+    off<K extends keyof AppEventMap>(event: K, cb: AppEventMap[K]): this;
+    private emit;
+    private userFor;
+    private wireEvents;
+}
+declare function useAppEngine(config: AppEngineConfig): {
+    engine: AppEngine;
+    connectionState: AppConnectionState;
+    remoteUsers: AppRemoteUser[];
+    join: (token: string, wsUrl: string, options?: AppJoinOptions) => Promise<void>;
+    leave: () => Promise<void>;
+};
+/**
+ * Renders a remote user's camera, or the local preview when `local` is set.
+ *
+ * The underlying component needs a full track reference — participant,
+ * publication and source. The previous version passed `publication: undefined`,
+ * which threw a TypeError on every render and made video impossible on this
+ * platform.
+ */
+declare function AppVideoView({ user, engine, local, style, mirror, }: {
+    /** Remote user to render. Ignored when `local` is set. */
+    user?: AppRemoteUser;
+    /** Required when rendering the local preview. */
+    engine?: AppEngine;
+    local?: boolean;
+    style?: StyleProp<ViewStyle>;
+    mirror?: boolean;
+}): React.JSX.Element | null;
+/**
+ * Manages the iOS audio session for a call. Call it once in a component that
+ * lives for the duration of the call. No effect on Android.
+ */
+/**
+ * Configures the iOS audio session for a call: routing, the speaker, and
+ * interruptions from incoming phone calls. Call it in the component that lives
+ * for the duration of the call. It does nothing on Android, so it is safe to
+ * call unconditionally.
+ */
+declare function useAppAudioSession(engine: AppEngine): void;
+
+export { type AppConnectionState, AppEngine, type AppEngineConfig, type AppEventMap, type AppGiftEvent, type AppJoinOptions, AppRemoteUser, type AppRole, AppVideoView, AppEngine as default, initAppLooma, useAppAudioSession, useAppEngine };

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+
+/**
+ * AppLooma RTC React Native SDK
+ * © AppLooma LLC
+ *
+ * Call initAppLooma() once at app startup (before joining any channel):
+ *
+ *   import { initAppLooma, AppEngine } from '@applooma/rtc-react-native';
+ *   initAppLooma();
+ */
+
+type AppRole = 'host' | 'cohost' | 'audience';
+type AppConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+interface AppEngineConfig {
+    /** Your AppLooma RTC App ID from applooma.dev/dashboard */
+    appId: string;
+}
+interface AppJoinOptions {
+    role?: AppRole;
+    camera?: boolean;
+    microphone?: boolean;
+}
+/** Must be called once at app startup, before creating an engine. */
+declare function initAppLooma(): void;
+declare class AppRemoteUser {
+    private p;
+    get uid(): string;
+    get displayName(): string | undefined;
+    get metadata(): string | undefined;
+    get isSpeaking(): boolean;
+    get hasVideo(): boolean;
+}
+interface AppEventMap {
+    'user-joined': (user: AppRemoteUser) => void;
+    'user-left': (user: AppRemoteUser) => void;
+    /** A remote user's camera or microphone became available to render. */
+    'track-subscribed': (user: AppRemoteUser) => void;
+    'track-unsubscribed': (user: AppRemoteUser) => void;
+    'connection-state-changed': (state: AppConnectionState) => void;
+    'data-received': (data: Uint8Array, from?: AppRemoteUser) => void;
+    'gift-received': (gift: AppGiftEvent) => void;
+    'active-speakers-changed': (uids: string[]) => void;
+}
+/** A virtual gift broadcast to the room (sent via your server's POST /v1/gifts/send). */
+interface AppGiftEvent {
+    txId: string;
+    gift: {
+        id: string;
+        name: string;
+        imageUrl: string;
+        coinPrice: number;
+    };
+    sender: string;
+    receiver: string;
+    quantity: number;
+    sentAt: string;
+}
+declare class AppEngine {
+    readonly config: AppEngineConfig;
+    private room;
+    private listeners;
+    private users;
+    private joined;
+    private constructor();
+    static create(config: AppEngineConfig): AppEngine;
+    joinChannel(token: string, wsUrl: string, options?: AppJoinOptions): Promise<void>;
+    leaveChannel(): Promise<void>;
+    /** Emits joined/subscribed events for everyone already present at join time. */
+    private seedExistingParticipants;
+    /**
+     * Release the engine. After this the instance cannot be reused.
+     */
+    destroy(): Promise<void>;
+    enableCamera(on?: boolean): Promise<void>;
+    enableMicrophone(on?: boolean): Promise<void>;
+    sendData(data: Uint8Array | string, reliable?: boolean): Promise<void>;
+    get connectionState(): AppConnectionState;
+    get localUid(): string;
+    get channelName(): string;
+    get remoteUsers(): AppRemoteUser[];
+    on<K extends keyof AppEventMap>(event: K, cb: AppEventMap[K]): this;
+    off<K extends keyof AppEventMap>(event: K, cb: AppEventMap[K]): this;
+    private emit;
+    private userFor;
+    private wireEvents;
+}
+declare function useAppEngine(config: AppEngineConfig): {
+    engine: AppEngine;
+    connectionState: AppConnectionState;
+    remoteUsers: AppRemoteUser[];
+    join: (token: string, wsUrl: string, options?: AppJoinOptions) => Promise<void>;
+    leave: () => Promise<void>;
+};
+/**
+ * Renders a remote user's camera, or the local preview when `local` is set.
+ *
+ * The underlying component needs a full track reference — participant,
+ * publication and source. The previous version passed `publication: undefined`,
+ * which threw a TypeError on every render and made video impossible on this
+ * platform.
+ */
+declare function AppVideoView({ user, engine, local, style, mirror, }: {
+    /** Remote user to render. Ignored when `local` is set. */
+    user?: AppRemoteUser;
+    /** Required when rendering the local preview. */
+    engine?: AppEngine;
+    local?: boolean;
+    style?: StyleProp<ViewStyle>;
+    mirror?: boolean;
+}): React.JSX.Element | null;
+/**
+ * Manages the iOS audio session for a call. Call it once in a component that
+ * lives for the duration of the call. No effect on Android.
+ */
+/**
+ * Configures the iOS audio session for a call: routing, the speaker, and
+ * interruptions from incoming phone calls. Call it in the component that lives
+ * for the duration of the call. It does nothing on Android, so it is safe to
+ * call unconditionally.
+ */
+declare function useAppAudioSession(engine: AppEngine): void;
+
+export { type AppConnectionState, AppEngine, type AppEngineConfig, type AppEventMap, type AppGiftEvent, type AppJoinOptions, AppRemoteUser, type AppRole, AppVideoView, AppEngine as default, initAppLooma, useAppAudioSession, useAppEngine };