livekit-server-sdk 1.1.3 → 1.2.0

package/dist/EgressClient.js

@@ -0,0 +1,263 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EgressClient = void 0;
+const livekit_egress_1 = require("./proto/livekit_egress");
+const ServiceBase_1 = __importDefault(require("./ServiceBase"));
+const TwirpRPC_1 = require("./TwirpRPC");
+const svc = 'Egress';
+/**
+ * Client to access Egress APIs
+ */
+class EgressClient extends ServiceBase_1.default {
+    /**
+     * @param host hostname including protocol. i.e. 'https://cluster.livekit.io'
+     * @param apiKey API Key, can be set in env var LIVEKIT_API_KEY
+     * @param secret API Secret, can be set in env var LIVEKIT_API_SECRET
+     */
+    constructor(host, apiKey, secret) {
+        super(apiKey, secret);
+        this.rpc = new TwirpRPC_1.TwirpRpc(host, TwirpRPC_1.livekitPackage);
+    }
+    startRoomCompositeEgress(roomName, output, optsOrLayout, options, audioOnly, videoOnly, customBaseUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let layout;
+            if (optsOrLayout !== undefined) {
+                if (typeof optsOrLayout === 'string') {
+                    layout = optsOrLayout;
+                }
+                else {
+                    const opts = optsOrLayout;
+                    layout = opts.layout;
+                    options = opts.encodingOptions;
+                    audioOnly = opts.audioOnly;
+                    videoOnly = opts.videoOnly;
+                    customBaseUrl = opts.customBaseUrl;
+                }
+            }
+            layout !== null && layout !== void 0 ? layout : (layout = '');
+            audioOnly !== null && audioOnly !== void 0 ? audioOnly : (audioOnly = false);
+            videoOnly !== null && videoOnly !== void 0 ? videoOnly : (videoOnly = false);
+            customBaseUrl !== null && customBaseUrl !== void 0 ? customBaseUrl : (customBaseUrl = '');
+            const { file, stream, segments, preset, advanced, fileOutputs, streamOutputs, segmentOutputs } = this.getOutputParams(output, options);
+            const req = livekit_egress_1.RoomCompositeEgressRequest.toJSON({
+                roomName,
+                layout,
+                audioOnly,
+                videoOnly,
+                customBaseUrl,
+                file,
+                stream,
+                segments,
+                preset,
+                advanced,
+                fileOutputs,
+                streamOutputs,
+                segmentOutputs,
+            });
+            const data = yield this.rpc.request(svc, 'StartRoomCompositeEgress', req, this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+    /**
+     * @param url url
+     * @param output file or stream output
+     * @param opts WebOptions
+     */
+    startWebEgress(url, output, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const audioOnly = (opts === null || opts === void 0 ? void 0 : opts.audioOnly) || false;
+            const videoOnly = (opts === null || opts === void 0 ? void 0 : opts.videoOnly) || false;
+            const { file, stream, segments, preset, advanced, fileOutputs, streamOutputs, segmentOutputs } = this.getOutputParams(output, opts === null || opts === void 0 ? void 0 : opts.encodingOptions);
+            const req = livekit_egress_1.WebEgressRequest.toJSON({
+                url,
+                audioOnly,
+                videoOnly,
+                file,
+                stream,
+                segments,
+                preset,
+                advanced,
+                fileOutputs,
+                streamOutputs,
+                segmentOutputs,
+            });
+            const data = yield this.rpc.request(svc, 'StartWebEgress', req, this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+    startTrackCompositeEgress(roomName, output, optsOrAudioTrackId, videoTrackId, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let audioTrackId;
+            if (optsOrAudioTrackId !== undefined) {
+                if (typeof optsOrAudioTrackId === 'string') {
+                    audioTrackId = optsOrAudioTrackId;
+                }
+                else {
+                    const opts = optsOrAudioTrackId;
+                    audioTrackId = opts.audioTrackId;
+                    videoTrackId = opts.videoTrackId;
+                    options = opts.encodingOptions;
+                }
+            }
+            audioTrackId !== null && audioTrackId !== void 0 ? audioTrackId : (audioTrackId = '');
+            videoTrackId !== null && videoTrackId !== void 0 ? videoTrackId : (videoTrackId = '');
+            const { file, stream, segments, preset, advanced, fileOutputs, streamOutputs, segmentOutputs } = this.getOutputParams(output, options);
+            const req = livekit_egress_1.TrackCompositeEgressRequest.toJSON({
+                roomName,
+                audioTrackId,
+                videoTrackId,
+                file,
+                stream,
+                segments,
+                preset,
+                advanced,
+                fileOutputs,
+                streamOutputs,
+                segmentOutputs,
+            });
+            const data = yield this.rpc.request(svc, 'StartTrackCompositeEgress', req, this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+    isEncodedOutputs(output) {
+        return (output.file !== undefined ||
+            output.stream !== undefined ||
+            output.segments !== undefined);
+    }
+    isEncodedFileOutput(output) {
+        return (output.filepath !== undefined ||
+            output.fileType !== undefined);
+    }
+    isSegmentedFileOutput(output) {
+        return (output.filenamePrefix !== undefined ||
+            output.playlistName !== undefined ||
+            output.filenameSuffix !== undefined);
+    }
+    isStreamOutput(output) {
+        return (output.protocol !== undefined || output.urls !== undefined);
+    }
+    getOutputParams(output, options) {
+        let file;
+        let fileOutputs;
+        let stream;
+        let streamOutputs;
+        let segments;
+        let segmentOutputs;
+        let preset;
+        let advanced;
+        if (this.isEncodedOutputs(output)) {
+            if (output.file !== undefined) {
+                fileOutputs = [output.file];
+            }
+            if (output.stream !== undefined) {
+                streamOutputs = [output.stream];
+            }
+            if (output.segments !== undefined) {
+                segmentOutputs = [output.segments];
+            }
+        }
+        else if (this.isEncodedFileOutput(output)) {
+            file = output;
+            fileOutputs = [file];
+        }
+        else if (this.isSegmentedFileOutput(output)) {
+            segments = output;
+            segmentOutputs = [segments];
+        }
+        else if (this.isStreamOutput(output)) {
+            stream = output;
+            streamOutputs = [stream];
+        }
+        if (options) {
+            if (typeof options === 'number') {
+                preset = options;
+            }
+            else {
+                advanced = options;
+            }
+        }
+        return { file, stream, segments, preset, advanced, fileOutputs, streamOutputs, segmentOutputs };
+    }
+    /**
+     * @param roomName room name
+     * @param output file or websocket output
+     * @param trackId track Id
+     */
+    startTrackEgress(roomName, output, trackId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let file;
+            let websocketUrl;
+            if (typeof output === 'string') {
+                websocketUrl = output;
+            }
+            else {
+                file = output;
+            }
+            const req = livekit_egress_1.TrackEgressRequest.toJSON({
+                roomName,
+                trackId,
+                file,
+                websocketUrl,
+            });
+            const data = yield this.rpc.request(svc, 'StartTrackEgress', req, this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+    /**
+     * @param egressId
+     * @param layout
+     */
+    updateLayout(egressId, layout) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.rpc.request(svc, 'UpdateLayout', livekit_egress_1.UpdateLayoutRequest.toJSON({ egressId, layout }), this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+    /**
+     * @param egressId
+     * @param addOutputUrls
+     * @param removeOutputUrls
+     */
+    updateStream(egressId, addOutputUrls, removeOutputUrls) {
+        return __awaiter(this, void 0, void 0, function* () {
+            addOutputUrls !== null && addOutputUrls !== void 0 ? addOutputUrls : (addOutputUrls = []);
+            removeOutputUrls !== null && removeOutputUrls !== void 0 ? removeOutputUrls : (removeOutputUrls = []);
+            const data = yield this.rpc.request(svc, 'UpdateStream', livekit_egress_1.UpdateStreamRequest.toJSON({ egressId, addOutputUrls, removeOutputUrls }), this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+    /**
+     * @param roomName list egress for one room only
+     */
+    listEgress(roomName) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            roomName !== null && roomName !== void 0 ? roomName : (roomName = '');
+            const data = yield this.rpc.request(svc, 'ListEgress', livekit_egress_1.ListEgressRequest.toJSON({ roomName }), this.authHeader({ roomRecord: true }));
+            return (_a = livekit_egress_1.ListEgressResponse.fromJSON(data).items) !== null && _a !== void 0 ? _a : [];
+        });
+    }
+    /**
+     * @param egressId
+     */
+    stopEgress(egressId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.rpc.request(svc, 'StopEgress', livekit_egress_1.StopEgressRequest.toJSON({ egressId }), this.authHeader({ roomRecord: true }));
+            return livekit_egress_1.EgressInfo.fromJSON(data);
+        });
+    }
+}
+exports.EgressClient = EgressClient;
+//# sourceMappingURL=EgressClient.js.map

package/dist/EgressClient.js.map

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

package/dist/IngressClient.d.ts

@@ -0,0 +1,84 @@
+import { IngressAudioOptions, IngressInfo, IngressInput, IngressVideoOptions } from './proto/livekit_ingress';
+import ServiceBase from './ServiceBase';
+export interface CreateIngressOptions {
+    /**
+     * ingress name. optional
+     */
+    name?: string;
+    /**
+     * name of the room to send media to. optional
+     */
+    roomName?: string;
+    /**
+     * unique identity of the participant. optional
+     */
+    participantIdentity?: string;
+    /**
+     * participant display name
+     */
+    participantName?: string;
+    /**
+     * custom audio encoding parameters. optional
+     */
+    audio?: IngressAudioOptions;
+    /**
+     * custom video encoding parameters. optional
+     */
+    video?: IngressVideoOptions;
+}
+export interface UpdateIngressOptions {
+    /**
+     * ingress name. optional
+     */
+    name: string;
+    /**
+     * name of the room to send media to. optional
+     */
+    roomName?: string;
+    /**
+     * unique identity of the participant. optional
+     */
+    participantIdentity?: string;
+    /**
+     * participant display name
+     */
+    participantName?: string;
+    /**
+     * custom audio encoding parameters. optional
+     */
+    audio?: IngressAudioOptions;
+    /**
+     * custom video encoding parameters. optional
+     */
+    video?: IngressVideoOptions;
+}
+/**
+ * Client to access Ingress APIs
+ */
+export declare class IngressClient extends ServiceBase {
+    private readonly rpc;
+    /**
+     * @param host hostname including protocol. i.e. 'https://cluster.livekit.io'
+     * @param apiKey API Key, can be set in env var LIVEKIT_API_KEY
+     * @param secret API Secret, can be set in env var LIVEKIT_API_SECRET
+     */
+    constructor(host: string, apiKey?: string, secret?: string);
+    /**
+     * @param inputType protocol for the ingress
+     * @param opts CreateIngressOptions
+     */
+    createIngress(inputType: IngressInput, opts?: CreateIngressOptions): Promise<IngressInfo>;
+    /**
+     * @param ingressId ID of the ingress to update
+     * @param opts UpdateIngressOptions
+     */
+    updateIngress(ingressId: string, opts: UpdateIngressOptions): Promise<IngressInfo>;
+    /**
+     * @param roomName list ingress for one room only
+     */
+    listIngress(roomName?: string): Promise<Array<IngressInfo>>;
+    /**
+     * @param ingressId ingress to delete
+     */
+    deleteIngress(ingressId: string): Promise<IngressInfo>;
+}

package/dist/IngressClient.js

@@ -0,0 +1,112 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IngressClient = void 0;
+const livekit_ingress_1 = require("./proto/livekit_ingress");
+const ServiceBase_1 = __importDefault(require("./ServiceBase"));
+const TwirpRPC_1 = require("./TwirpRPC");
+const svc = 'Ingress';
+/**
+ * Client to access Ingress APIs
+ */
+class IngressClient extends ServiceBase_1.default {
+    /**
+     * @param host hostname including protocol. i.e. 'https://cluster.livekit.io'
+     * @param apiKey API Key, can be set in env var LIVEKIT_API_KEY
+     * @param secret API Secret, can be set in env var LIVEKIT_API_SECRET
+     */
+    constructor(host, apiKey, secret) {
+        super(apiKey, secret);
+        this.rpc = new TwirpRPC_1.TwirpRpc(host, TwirpRPC_1.livekitPackage);
+    }
+    /**
+     * @param inputType protocol for the ingress
+     * @param opts CreateIngressOptions
+     */
+    createIngress(inputType, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let name = '';
+            let roomName = '';
+            let participantName = '';
+            let participantIdentity = '';
+            let audio;
+            let video;
+            if (opts !== undefined) {
+                name = opts.name || '';
+                roomName = opts.roomName || '';
+                participantName = opts.participantName || '';
+                participantIdentity = opts.participantIdentity || '';
+                audio = opts.audio;
+                video = opts.video;
+            }
+            const req = livekit_ingress_1.CreateIngressRequest.toJSON({
+                inputType,
+                name,
+                roomName,
+                participantIdentity,
+                participantName,
+                audio,
+                video,
+            });
+            const data = yield this.rpc.request(svc, 'CreateIngress', req, this.authHeader({ ingressAdmin: true }));
+            return livekit_ingress_1.IngressInfo.fromJSON(data);
+        });
+    }
+    /**
+     * @param ingressId ID of the ingress to update
+     * @param opts UpdateIngressOptions
+     */
+    updateIngress(ingressId, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const name = opts.name || '';
+            const roomName = opts.roomName || '';
+            const participantName = opts.participantName || '';
+            const participantIdentity = opts.participantIdentity || '';
+            const { audio, video } = opts;
+            const req = livekit_ingress_1.UpdateIngressRequest.toJSON({
+                ingressId,
+                name,
+                roomName,
+                participantIdentity,
+                participantName,
+                audio,
+                video,
+            });
+            const data = yield this.rpc.request(svc, 'UpdateIngress', req, this.authHeader({ ingressAdmin: true }));
+            return livekit_ingress_1.IngressInfo.fromJSON(data);
+        });
+    }
+    /**
+     * @param roomName list ingress for one room only
+     */
+    listIngress(roomName) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            roomName !== null && roomName !== void 0 ? roomName : (roomName = '');
+            const data = yield this.rpc.request(svc, 'ListIngress', livekit_ingress_1.ListIngressRequest.toJSON({ roomName }), this.authHeader({ ingressAdmin: true }));
+            return (_a = livekit_ingress_1.ListIngressResponse.fromJSON(data).items) !== null && _a !== void 0 ? _a : [];
+        });
+    }
+    /**
+     * @param ingressId ingress to delete
+     */
+    deleteIngress(ingressId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = yield this.rpc.request(svc, 'DeleteIngress', livekit_ingress_1.DeleteIngressRequest.toJSON({ ingressId }), this.authHeader({ ingressAdmin: true }));
+            return livekit_ingress_1.IngressInfo.fromJSON(data);
+        });
+    }
+}
+exports.IngressClient = IngressClient;
+//# sourceMappingURL=IngressClient.js.map

package/dist/IngressClient.js.map

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

package/dist/RoomServiceClient.d.ts

@@ -0,0 +1,132 @@
+import { DataPacket_Kind, ParticipantInfo, ParticipantPermission, Room, TrackInfo } from './proto/livekit_models';
+import { RoomEgress } from './proto/livekit_room';
+import ServiceBase from './ServiceBase';
+/**
+ * Options for when creating a room
+ */
+export interface CreateOptions {
+    /**
+     * name of the room. required
+     */
+    name: string;
+    /**
+     * number of seconds the room should clean up after being empty
+     */
+    emptyTimeout?: number;
+    /**
+     * limit to the number of participants in a room at a time
+     */
+    maxParticipants?: number;
+    /**
+     * initial room metadata
+     */
+    metadata?: string;
+    /**
+     * add egress options
+     */
+    egress?: RoomEgress;
+    /**
+     * override the node room is allocated to, for debugging
+     * does not work with Cloud
+     */
+    nodeId?: string;
+}
+export declare type SendDataOptions = {
+    destinationSids?: string[];
+    topic?: string;
+};
+/**
+ * Client to access Room APIs
+ */
+export declare class RoomServiceClient extends ServiceBase {
+    private readonly rpc;
+    /**
+     *
+     * @param host hostname including protocol. i.e. 'https://cluster.livekit.io'
+     * @param apiKey API Key, can be set in env var LIVEKIT_API_KEY
+     * @param secret API Secret, can be set in env var LIVEKIT_API_SECRET
+     */
+    constructor(host: string, apiKey?: string, secret?: string);
+    /**
+     * Creates a new room. Explicit room creation is not required, since rooms will
+     * be automatically created when the first participant joins. This method can be
+     * used to customize room settings.
+     * @param options
+     */
+    createRoom(options: CreateOptions): Promise<Room>;
+    /**
+     * List active rooms
+     * @param names when undefined or empty, list all rooms.
+     *              otherwise returns rooms with matching names
+     * @returns
+     */
+    listRooms(names?: string[]): Promise<Room[]>;
+    deleteRoom(room: string): Promise<void>;
+    /**
+     * Update metadata of a room
+     * @param room name of the room
+     * @param metadata the new metadata for the room
+     */
+    updateRoomMetadata(room: string, metadata: string): Promise<Room>;
+    /**
+     * List participants in a room
+     * @param room name of the room
+     */
+    listParticipants(room: string): Promise<ParticipantInfo[]>;
+    /**
+     * Get information on a specific participant, including the tracks that participant
+     * has published
+     * @param room name of the room
+     * @param identity identity of the participant to return
+     */
+    getParticipant(room: string, identity: string): Promise<ParticipantInfo>;
+    /**
+     * Removes a participant in the room. This will disconnect the participant
+     * and will emit a Disconnected event for that participant.
+     * Even after being removed, the participant can still re-join the room.
+     * @param room
+     * @param identity
+     */
+    removeParticipant(room: string, identity: string): Promise<void>;
+    /**
+     * Mutes a track that the participant has published.
+     * @param room
+     * @param identity
+     * @param trackSid sid of the track to be muted
+     * @param muted true to mute, false to unmute
+     */
+    mutePublishedTrack(room: string, identity: string, trackSid: string, muted: boolean): Promise<TrackInfo>;
+    /**
+     * Updates a participant's metadata or permissions
+     * @param room
+     * @param identity
+     * @param metadata optional, metadata to update
+     * @param permission optional, new permissions to assign to participant
+     * @param name optional, new name for participant
+     */
+    updateParticipant(room: string, identity: string, metadata?: string, permission?: ParticipantPermission, name?: string): Promise<ParticipantInfo>;
+    /**
+     * Updates a participant's subscription to tracks
+     * @param room
+     * @param identity
+     * @param trackSids
+     * @param subscribe true to subscribe, false to unsubscribe
+     */
+    updateSubscriptions(room: string, identity: string, trackSids: string[], subscribe: boolean): Promise<void>;
+    /**
+     * Sends data message to participants in the room
+     * @param room
+     * @param data opaque payload to send
+     * @param kind delivery reliability
+     * @param options optionally specify a topic and destinationSids (when destinationSids is empty, message is sent to everyone)
+     */
+    sendData(room: string, data: Uint8Array, kind: DataPacket_Kind, options: SendDataOptions): Promise<void>;
+    /**
+     * Sends data message to participants in the room
+     * @param room
+     * @param data opaque payload to send
+     * @param kind delivery reliability
+     * @param destinationSids optional. when empty, message is sent to everyone
+     */
+    sendData(room: string, data: Uint8Array, kind: DataPacket_Kind, destinationSids?: string[]): Promise<void>;
+}