@prvt/integration-sdk 0.1.0

package/README.md

@@ -0,0 +1,144 @@
+# `@prvt/integration-sdk`
+
+TypeScript SDK for building visible Node.js integrations for a self-hosted
+prvt room.
+
+The SDK exchanges a room-scoped integration key for a short-lived participant
+token and can connect the integration through the official LiveKit Node SDK.
+It does not persist credentials, retry mutations, or hide integration
+participants.
+
+## Install
+
+```bash
+npm install @prvt/integration-sdk @livekit/rtc-node
+```
+
+Node.js 18 or newer is required. `@livekit/rtc-node` is a peer dependency so
+the application controls the native realtime runtime version.
+
+## Create an integration key
+
+Join a room in the browser that created it, open **Room tools**, and choose
+**Copy integrations API token**. The `Personal integration` key is shown only
+once. Move it directly into the Node application's secret manager before
+closing the dialog.
+
+Never put the integration key in a URL, log, source file, or browser storage.
+
+## Connect
+
+```ts
+import { RoomEvent } from "@livekit/rtc-node";
+import { createPrvtIntegration } from "@prvt/integration-sdk";
+
+const integrationKey = process.env.PRVT_INTEGRATION_KEY;
+if (!integrationKey) throw new Error("PRVT_INTEGRATION_KEY is required");
+
+const integration = createPrvtIntegration({
+  baseUrl: "https://call.example.com",
+  integrationKey,
+});
+
+const session = await integration.connect({
+  roomOptions: {
+    autoSubscribe: true,
+    dynacast: false,
+  },
+});
+
+session.room.on(RoomEvent.ParticipantConnected, (participant) => {
+  console.log(`${participant.name ?? participant.identity} joined`);
+});
+
+process.once("SIGINT", async () => {
+  await session.disconnect();
+  process.exit(0);
+});
+```
+
+`session.room` is the official `@livekit/rtc-node` `Room`. Use its track,
+participant, text-stream, and data APIs directly. The integration's stable
+identity, expiry, and effective permissions are also available on the session.
+
+## Exchange without connecting
+
+Use `exchangeToken()` when the application needs to configure the LiveKit room
+itself:
+
+```ts
+const token = await integration.exchangeToken();
+
+// token.participantToken  short-lived bearer JWT
+// token.serverUrl         public LiveKit WebSocket URL
+// token.participantIdentity
+// token.expiresAt
+// token.permissions
+```
+
+The participant JWT is valid for five minutes and exactly one managed room.
+Fetch a fresh token before a full reconnect instead of persisting it as a
+replacement for the integration key.
+
+## Permissions
+
+The server returns the effective permissions with every exchange:
+
+- `subscribeMedia` allows room-wide media subscription, including both audio
+  and video.
+- `publishMicrophone` allows publication restricted to microphone-source
+  tracks.
+- `publishData` allows room-wide data publication. Topics such as
+  `prvt.chat` route messages but are not authorization boundaries.
+
+`PRVT_CHAT_TOPIC` exports the exact `prvt.chat` topic name.
+
+Personal integrations created from Room tools currently receive all three
+permissions. The owner API can create integrations with selected permissions.
+
+## Errors
+
+```ts
+import {
+  PrvtApiError,
+  PrvtConnectionError,
+  PrvtNetworkError,
+  PrvtProtocolError,
+} from "@prvt/integration-sdk";
+
+try {
+  await integration.connect();
+} catch (error) {
+  if (error instanceof PrvtApiError) {
+    console.error(error.code, error.status, error.retryAfterSeconds);
+  } else if (error instanceof PrvtNetworkError) {
+    console.error("The prvt API is unreachable");
+  } else if (error instanceof PrvtProtocolError) {
+    console.error("The API response did not match the SDK contract");
+  } else if (error instanceof PrvtConnectionError) {
+    console.error("LiveKit connection failed");
+  }
+}
+```
+
+The SDK does not include integration keys, participant JWTs, request headers,
+or response bodies in its own error messages. It does not retry automatically.
+Respect `retryAfterSeconds` for `RATE_LIMITED`; use bounded backoff for
+temporary `STORAGE_UNAVAILABLE` or `LIVEKIT_UNAVAILABLE` failures; require
+operator action for revoked, closed, or unauthorized credentials.
+
+## Visibility and lifecycle
+
+Integrations are ordinary visible room participants. Server-signed metadata
+drives their badge, roster entry, join announcement, and chat attribution. A
+new connection with the same stable integration identity replaces the older
+connection.
+
+Revoking an integration blocks future token exchanges and attempts to remove
+the connected bot. An already issued JWT cannot be invalidated and may reconnect
+for the remainder of its five-minute lifetime. Always disconnect the session
+cleanly during shutdown.
+
+This package intentionally does not wrap the owner API or browser moderator
+flow. It is the runtime SDK for a Node.js integration after an integration key
+has been created.

package/dist/client.d.ts

@@ -0,0 +1,11 @@
+import type { Room } from "@livekit/rtc-node";
+import type { ConnectIntegrationOptions, CreatePrvtIntegrationOptions, ExchangeTokenOptions, IntegrationToken, PrvtIntegration, PrvtIntegrationSession } from "./types.js";
+export type RoomFactory = () => Promise<Room>;
+export declare class PrvtIntegrationClient implements PrvtIntegration {
+    #private;
+    constructor(options: CreatePrvtIntegrationOptions, roomFactory?: RoomFactory);
+    exchangeToken(options?: ExchangeTokenOptions): Promise<IntegrationToken>;
+    connect(options?: ConnectIntegrationOptions): Promise<PrvtIntegrationSession>;
+}
+export declare const createPrvtIntegration: (options: CreatePrvtIntegrationOptions) => PrvtIntegration;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAQ9C,OAAO,KAAK,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AASpB,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAyC9C,qBAAa,qBAAsB,YAAW,eAAe;;gBAM/C,OAAO,EAAE,4BAA4B,EAAE,WAAW,GAAE,WAAgC;IAQ1F,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiC5E,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAYxF;AAED,eAAO,MAAM,qBAAqB,GAAI,SAAS,4BAA4B,KAAG,eAE7E,CAAC"}

package/dist/client.js

@@ -0,0 +1,94 @@
+import { PrvtApiError, PrvtConnectionError, PrvtNetworkError, PrvtProtocolError, PrvtRtcUnavailableError, } from "./errors.js";
+import { normalizeBaseUrl, normalizeIntegrationKey, parseApiErrorCode, parseIntegrationToken, parseRetryAfter, } from "./validation.js";
+const defaultRoomFactory = async () => {
+    try {
+        const { Room } = await import("@livekit/rtc-node");
+        return new Room();
+    }
+    catch {
+        throw new PrvtRtcUnavailableError();
+    }
+};
+const isAbortError = (caught, signal) => (signal?.aborted === true
+    || (typeof caught === "object" && caught !== null && "name" in caught && caught.name === "AbortError"));
+const abortReason = (signal) => {
+    if (signal.reason !== undefined)
+        return signal.reason;
+    const error = new Error("The operation was aborted");
+    error.name = "AbortError";
+    return error;
+};
+class IntegrationSession {
+    room;
+    participantIdentity;
+    expiresAt;
+    permissions;
+    constructor(room, token) {
+        this.room = room;
+        this.participantIdentity = token.participantIdentity;
+        this.expiresAt = token.expiresAt;
+        this.permissions = token.permissions;
+    }
+    async disconnect() {
+        await this.room.disconnect();
+    }
+}
+export class PrvtIntegrationClient {
+    #baseUrl;
+    #integrationKey;
+    #fetch;
+    #roomFactory;
+    constructor(options, roomFactory = defaultRoomFactory) {
+        this.#baseUrl = normalizeBaseUrl(options.baseUrl);
+        this.#integrationKey = normalizeIntegrationKey(options.integrationKey);
+        this.#fetch = options.fetch ?? globalThis.fetch;
+        if (typeof this.#fetch !== "function")
+            throw new TypeError("fetch is not available in this Node.js runtime");
+        this.#roomFactory = roomFactory;
+    }
+    async exchangeToken(options = {}) {
+        let response;
+        try {
+            response = await this.#fetch(new URL("/api/v1/integrations/token", this.#baseUrl), {
+                method: "POST",
+                headers: {
+                    Accept: "application/json",
+                    Authorization: `Bearer ${this.#integrationKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: "{}",
+                signal: options.signal,
+            });
+        }
+        catch (caught) {
+            if (isAbortError(caught, options.signal)) {
+                throw options.signal?.aborted ? abortReason(options.signal) : caught;
+            }
+            throw new PrvtNetworkError();
+        }
+        const body = await response.json().catch(() => null);
+        if (!response.ok) {
+            throw new PrvtApiError(parseApiErrorCode(body), response.status, parseRetryAfter(response.headers.get("Retry-After")));
+        }
+        const token = parseIntegrationToken(body);
+        if (token === null)
+            throw new PrvtProtocolError();
+        return token;
+    }
+    async connect(options = {}) {
+        const token = await this.exchangeToken({ signal: options.signal });
+        if (options.signal?.aborted)
+            throw abortReason(options.signal);
+        const room = await this.#roomFactory();
+        try {
+            await room.connect(token.serverUrl, token.participantToken, options.roomOptions);
+        }
+        catch {
+            await room.disconnect().catch(() => { });
+            throw new PrvtConnectionError();
+        }
+        return new IntegrationSession(room, token);
+    }
+}
+export const createPrvtIntegration = (options) => (new PrvtIntegrationClient(options));
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+import type { PrvtApiErrorCode } from "./types.js";
+export declare class PrvtApiError extends Error {
+    readonly code: PrvtApiErrorCode;
+    readonly status: number;
+    readonly retryAfterSeconds?: number;
+    constructor(code: PrvtApiErrorCode, status: number, retryAfterSeconds?: number);
+}
+export declare class PrvtNetworkError extends Error {
+    constructor();
+}
+export declare class PrvtProtocolError extends Error {
+    constructor();
+}
+export declare class PrvtRtcUnavailableError extends Error {
+    constructor();
+}
+export declare class PrvtConnectionError extends Error {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;gBAExB,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM;CAO/E;AAED,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;;CAK3C;AAED,qBAAa,uBAAwB,SAAQ,KAAK;;CAKjD;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C"}

package/dist/errors.js

@@ -0,0 +1,38 @@
+export class PrvtApiError extends Error {
+    code;
+    status;
+    retryAfterSeconds;
+    constructor(code, status, retryAfterSeconds) {
+        super(`prvt API request failed (${code})`);
+        this.name = "PrvtApiError";
+        this.code = code;
+        this.status = status;
+        if (retryAfterSeconds !== undefined)
+            this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+export class PrvtNetworkError extends Error {
+    constructor() {
+        super("Could not reach the prvt API");
+        this.name = "PrvtNetworkError";
+    }
+}
+export class PrvtProtocolError extends Error {
+    constructor() {
+        super("The prvt API returned an invalid response");
+        this.name = "PrvtProtocolError";
+    }
+}
+export class PrvtRtcUnavailableError extends Error {
+    constructor() {
+        super("@livekit/rtc-node is required to connect an integration");
+        this.name = "PrvtRtcUnavailableError";
+    }
+}
+export class PrvtConnectionError extends Error {
+    constructor() {
+        super("Could not connect the integration to its prvt room");
+        this.name = "PrvtConnectionError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,MAAM,CAAS;IACf,iBAAiB,CAAU;IAEpC,YAAY,IAAsB,EAAE,MAAc,EAAE,iBAA0B;QAC5E,KAAK,CAAC,4BAA4B,IAAI,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,iBAAiB,KAAK,SAAS;YAAE,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAClF,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC;QACE,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD;QACE,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { PrvtApiError, PrvtConnectionError, PrvtNetworkError, PrvtProtocolError, PrvtRtcUnavailableError, } from "./errors.js";
+export { createPrvtIntegration } from "./client.js";
+export type { ConnectIntegrationOptions, CreatePrvtIntegrationOptions, ExchangeTokenOptions, IntegrationPermissions, IntegrationToken, PrvtApiErrorCode, PrvtIntegration, PrvtIntegrationSession, } from "./types.js";
+export declare const PRVT_CHAT_TOPIC = "prvt.chat";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EACV,yBAAyB,EACzB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { PrvtApiError, PrvtConnectionError, PrvtNetworkError, PrvtProtocolError, PrvtRtcUnavailableError, } from "./errors.js";
+export { createPrvtIntegration } from "./client.js";
+export const PRVT_CHAT_TOPIC = "prvt.chat";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAYpD,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+import type { Room, RoomOptions } from "@livekit/rtc-node";
+export type IntegrationPermissions = {
+    subscribeMedia: boolean;
+    publishMicrophone: boolean;
+    publishData: boolean;
+};
+export type PrvtApiErrorCode = "INVALID_JSON" | "INVALID_REQUEST" | "INVALID_ROOM_NAME" | "INVALID_PARTICIPANT_NAME" | "INVALID_INTEGRATION_NAME" | "INVALID_INTEGRATION_PERMISSIONS" | "INVALID_CURSOR" | "UNAUTHORIZED" | "FORBIDDEN" | "ROOM_NOT_FOUND" | "INTEGRATION_NOT_FOUND" | "ROOM_CLOSED" | "INTEGRATION_REVOKED" | "ROOM_CAPACITY_REACHED" | "INTEGRATION_CAPACITY_REACHED" | "REQUEST_TOO_LARGE" | "UNSUPPORTED_MEDIA_TYPE" | "RATE_LIMITED" | "IDENTIFIER_GENERATION_FAILED" | "STORAGE_UNAVAILABLE" | "LIVEKIT_UNAVAILABLE" | "NOT_FOUND" | "UNKNOWN_ERROR";
+export type IntegrationToken = {
+    participantToken: string;
+    serverUrl: string;
+    participantIdentity: string;
+    expiresAt: string;
+    permissions: IntegrationPermissions;
+};
+export type CreatePrvtIntegrationOptions = {
+    baseUrl: string;
+    integrationKey: string;
+    fetch?: typeof globalThis.fetch;
+};
+export type ExchangeTokenOptions = {
+    signal?: AbortSignal;
+};
+export type ConnectIntegrationOptions = ExchangeTokenOptions & {
+    roomOptions?: RoomOptions;
+};
+export interface PrvtIntegrationSession {
+    readonly room: Room;
+    readonly participantIdentity: string;
+    readonly expiresAt: string;
+    readonly permissions: IntegrationPermissions;
+    disconnect(): Promise<void>;
+}
+export interface PrvtIntegration {
+    exchangeToken(options?: ExchangeTokenOptions): Promise<IntegrationToken>;
+    connect(options?: ConnectIntegrationOptions): Promise<PrvtIntegrationSession>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,0BAA0B,GAC1B,0BAA0B,GAC1B,iCAAiC,GACjC,gBAAgB,GAChB,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,uBAAuB,GACvB,aAAa,GACb,qBAAqB,GACrB,uBAAuB,GACvB,8BAA8B,GAC9B,mBAAmB,GACnB,wBAAwB,GACxB,cAAc,GACd,8BAA8B,GAC9B,qBAAqB,GACrB,qBAAqB,GACrB,WAAW,GACX,eAAe,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG;IAC7D,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzE,OAAO,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC/E"}

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,7 @@
+import type { IntegrationToken, PrvtApiErrorCode } from "./types.js";
+export declare const normalizeBaseUrl: (value: string) => string;
+export declare const normalizeIntegrationKey: (value: string) => string;
+export declare const parseApiErrorCode: (value: unknown) => PrvtApiErrorCode;
+export declare const parseRetryAfter: (value: string | null) => number | undefined;
+export declare const parseIntegrationToken: (value: unknown) => IntegrationToken | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsD7F,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,WAgB7C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,WAKpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,gBAOlD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,GAAG,IAAI,uBAInD,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,gBAAgB,GAAG,IA6BzE,CAAC"}

package/dist/validation.js

@@ -0,0 +1,116 @@
+const API_ERROR_CODES = new Set([
+    "INVALID_JSON",
+    "INVALID_REQUEST",
+    "INVALID_ROOM_NAME",
+    "INVALID_PARTICIPANT_NAME",
+    "INVALID_INTEGRATION_NAME",
+    "INVALID_INTEGRATION_PERMISSIONS",
+    "INVALID_CURSOR",
+    "UNAUTHORIZED",
+    "FORBIDDEN",
+    "ROOM_NOT_FOUND",
+    "INTEGRATION_NOT_FOUND",
+    "ROOM_CLOSED",
+    "INTEGRATION_REVOKED",
+    "ROOM_CAPACITY_REACHED",
+    "INTEGRATION_CAPACITY_REACHED",
+    "REQUEST_TOO_LARGE",
+    "UNSUPPORTED_MEDIA_TYPE",
+    "RATE_LIMITED",
+    "IDENTIFIER_GENERATION_FAILED",
+    "STORAGE_UNAVAILABLE",
+    "LIVEKIT_UNAVAILABLE",
+    "NOT_FOUND",
+]);
+const isRecord = (value) => (typeof value === "object" && value !== null && !Array.isArray(value));
+const hasExactlyKeys = (value, expected) => {
+    const actual = Object.keys(value).sort();
+    const sortedExpected = [...expected].sort();
+    return actual.length === sortedExpected.length
+        && actual.every((key, index) => key === sortedExpected[index]);
+};
+const parsePermissions = (value) => {
+    if (!isRecord(value) || !hasExactlyKeys(value, ["subscribeMedia", "publishMicrophone", "publishData"])) {
+        return null;
+    }
+    if (typeof value.subscribeMedia !== "boolean"
+        || typeof value.publishMicrophone !== "boolean"
+        || typeof value.publishData !== "boolean")
+        return null;
+    return {
+        subscribeMedia: value.subscribeMedia,
+        publishMicrophone: value.publishMicrophone,
+        publishData: value.publishData,
+    };
+};
+export const normalizeBaseUrl = (value) => {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new TypeError("baseUrl must be an absolute HTTP(S) origin");
+    }
+    if ((url.protocol !== "http:" && url.protocol !== "https:")
+        || url.username !== ""
+        || url.password !== ""
+        || url.pathname !== "/"
+        || url.search !== ""
+        || url.hash !== "")
+        throw new TypeError("baseUrl must be an absolute HTTP(S) origin");
+    return url.origin;
+};
+export const normalizeIntegrationKey = (value) => {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError("integrationKey must be a non-empty string");
+    }
+    return value.trim();
+};
+export const parseApiErrorCode = (value) => {
+    if (!isRecord(value) || !isRecord(value.error) || typeof value.error.code !== "string") {
+        return "UNKNOWN_ERROR";
+    }
+    return API_ERROR_CODES.has(value.error.code)
+        ? value.error.code
+        : "UNKNOWN_ERROR";
+};
+export const parseRetryAfter = (value) => {
+    if (value === null || !/^\d+$/.test(value))
+        return undefined;
+    const seconds = Number(value);
+    return Number.isSafeInteger(seconds) ? seconds : undefined;
+};
+export const parseIntegrationToken = (value) => {
+    if (!isRecord(value)
+        || !hasExactlyKeys(value, ["participantToken", "serverUrl", "participantIdentity", "expiresAt", "permissions"])
+        || typeof value.participantToken !== "string"
+        || value.participantToken.length === 0
+        || typeof value.serverUrl !== "string"
+        || typeof value.participantIdentity !== "string"
+        || value.participantIdentity.length === 0
+        || typeof value.expiresAt !== "string")
+        return null;
+    let serverUrl;
+    try {
+        serverUrl = new URL(value.serverUrl);
+    }
+    catch {
+        return null;
+    }
+    if (serverUrl.protocol !== "ws:" && serverUrl.protocol !== "wss:")
+        return null;
+    const expiresAt = new Date(value.expiresAt);
+    if (!Number.isFinite(expiresAt.getTime()) || expiresAt.toISOString() !== value.expiresAt)
+        return null;
+    const permissions = parsePermissions(value.permissions);
+    if (permissions === null)
+        return null;
+    return {
+        participantToken: value.participantToken,
+        serverUrl: value.serverUrl,
+        participantIdentity: value.participantIdentity,
+        expiresAt: value.expiresAt,
+        permissions,
+    };
+};
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@prvt/integration-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for building visible Node.js integrations for prvt rooms.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "clean": "bun -e \"import { rm } from 'node:fs/promises'; await rm('dist', { recursive: true, force: true })\"",
+    "build": "bun run clean && tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pack:check": "bun pm pack --dry-run",
+    "prepack": "bun run build",
+    "prepublishOnly": "bun run test && bun run typecheck"
+  },
+  "peerDependencies": {
+    "@livekit/rtc-node": "^0.13.34"
+  },
+  "devDependencies": {
+    "@livekit/rtc-node": "0.13.34",
+    "@types/bun": "^1.4.1",
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yerofey/prvt.git",
+    "directory": "packages/integration-sdk"
+  },
+  "keywords": [
+    "prvt",
+    "livekit",
+    "webrtc",
+    "integration",
+    "typescript"
+  ]
+}