@quickmeet/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 QuickMeet contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,35 @@
+# @quickmeet/sdk
+
+Framework-neutral browser client and shared TypeScript types for the self-hosted
+QuickMeet video conferencing API.
+
+## Install
+
+```bash
+npm install @quickmeet/sdk
+```
+
+## Browser invitation flow
+
+```ts
+import { QuickMeetClient } from '@quickmeet/sdk';
+
+const quickmeet = new QuickMeetClient({
+  apiUrl: 'https://meet-api.example.com',
+});
+
+const meeting = await quickmeet.getMeeting('weekly-review-a1b2c3');
+const credentials = await quickmeet.joinMeeting(meeting.slug, {
+  name: 'Aarav',
+  accessKey: new URLSearchParams(location.search).get('key') ?? undefined,
+});
+```
+
+Pass `credentials` to `@quickmeet/react` or connect with `livekit-client`.
+
+Trusted meeting creation and role assignment belong on your backend. Use
+`@quickmeet/node` there so the QuickMeet API key never enters browser code.
+
+## License
+
+Apache-2.0

package/dist/client.d.ts

@@ -0,0 +1,22 @@
+import type { ApiErrorBody, CreateMeetingInput, CreateMeetingResult, JoinCredentials, JoinMeetingInput, MeetingSummary, UpdateMeetingInput } from './types.js';
+export declare class QuickMeetApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(status: number, body: ApiErrorBody);
+}
+export interface QuickMeetClientOptions {
+    apiUrl: string;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class QuickMeetClient {
+    private readonly apiUrl;
+    private readonly fetcher;
+    constructor(options: QuickMeetClientOptions);
+    createMeeting(input: CreateMeetingInput): Promise<CreateMeetingResult>;
+    getMeeting(meetingIdOrSlug: string): Promise<MeetingSummary>;
+    joinMeeting(meetingIdOrSlug: string, input: JoinMeetingInput): Promise<JoinCredentials>;
+    updateMeeting(meetingIdOrSlug: string, input: UpdateMeetingInput): Promise<MeetingSummary>;
+    private request;
+}
+//# 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,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAO/C;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,OAAO,EAAE,sBAAsB;IAK3C,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOtE,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5D,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAOvF,aAAa,CACX,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,cAAc,CAAC;YASZ,OAAO;CAgBtB"}

package/dist/client.js

@@ -0,0 +1,58 @@
+export class QuickMeetApiError extends Error {
+    status;
+    code;
+    details;
+    constructor(status, body) {
+        super(body.message);
+        this.name = 'QuickMeetApiError';
+        this.status = status;
+        this.code = body.error;
+        this.details = body.details;
+    }
+}
+export class QuickMeetClient {
+    apiUrl;
+    fetcher;
+    constructor(options) {
+        this.apiUrl = options.apiUrl.replace(/\/+$/, '');
+        this.fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    createMeeting(input) {
+        return this.request('/v1/meetings', {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    getMeeting(meetingIdOrSlug) {
+        return this.request(`/v1/meetings/${encodeURIComponent(meetingIdOrSlug)}`);
+    }
+    joinMeeting(meetingIdOrSlug, input) {
+        return this.request(`/v1/meetings/${encodeURIComponent(meetingIdOrSlug)}/join`, {
+            method: 'POST',
+            body: JSON.stringify(input),
+        });
+    }
+    updateMeeting(meetingIdOrSlug, input) {
+        const { accessKey, ...updates } = input;
+        return this.request(`/v1/meetings/${encodeURIComponent(meetingIdOrSlug)}`, {
+            method: 'PATCH',
+            headers: accessKey ? { 'x-quickmeet-access-key': accessKey } : undefined,
+            body: JSON.stringify(updates),
+        });
+    }
+    async request(path, init = {}) {
+        const response = await this.fetcher(`${this.apiUrl}${path}`, {
+            ...init,
+            headers: {
+                'content-type': 'application/json',
+                ...init.headers,
+            },
+        });
+        const body = (await response.json());
+        if (!response.ok) {
+            throw new QuickMeetApiError(response.status, body);
+        }
+        return body;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAAW;IAE3B,YAAY,MAAc,EAAE,IAAkB;QAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;CACF;AAOD,MAAM,OAAO,eAAe;IACT,MAAM,CAAS;IACf,OAAO,CAA0B;IAElD,YAAY,OAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,aAAa,CAAC,KAAyB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,eAAuB;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,kBAAkB,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,WAAW,CAAC,eAAuB,EAAE,KAAuB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,kBAAkB,CAAC,eAAe,CAAC,OAAO,EAAE;YAC9E,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CACX,eAAuB,EACvB,KAAyB;QAEzB,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,kBAAkB,CAAC,eAAe,CAAC,EAAE,EAAE;YACzE,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;YACxE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,OAAoB,EAAE;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE;YAC3D,GAAG,IAAI;YACP,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,IAAI,CAAC,OAAO;aAChB;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAqB,CAAC;QACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAoB,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client.js';
+export * from './types.js';
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './client.js';
+export * from './types.js';
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+export type MeetingRole = 'host' | 'cohost' | 'participant';
+export type MeetingAccess = 'open' | 'invite-only';
+export interface MeetingFeatures {
+    camera: boolean;
+    microphone: boolean;
+    screenShare: boolean;
+    chat: boolean;
+}
+export declare const defaultMeetingFeatures: MeetingFeatures;
+export interface PersonInput {
+    id?: string;
+    name: string;
+    email?: string;
+}
+export interface CreateMeetingInput {
+    name: string;
+    host: PersonInput;
+    coHosts?: PersonInput[];
+    participants?: PersonInput[];
+    features?: Partial<MeetingFeatures>;
+    access?: MeetingAccess;
+}
+export interface MeetingSummary {
+    id: string;
+    slug: string;
+    name: string;
+    access: MeetingAccess;
+    features: MeetingFeatures;
+    host: Omit<PersonInput, 'id'> & {
+        id: string;
+    };
+    coHostCount: number;
+    participantCount: number;
+    createdAt: string;
+}
+export interface MeetingInvitation {
+    id: string;
+    name: string;
+    email?: string;
+    role: MeetingRole;
+    accessKey: string;
+    joinUrl?: string;
+}
+export interface CreateMeetingResult {
+    meeting: MeetingSummary;
+    hostAccessKey: string;
+    invitations: MeetingInvitation[];
+}
+export interface JoinMeetingInput {
+    name: string;
+    accessKey?: string;
+}
+export interface JoinCredentials {
+    serverUrl: string;
+    participantToken: string;
+    meeting: MeetingSummary;
+    participant: {
+        identity: string;
+        name: string;
+        role: MeetingRole;
+    };
+}
+export interface UpdateMeetingInput {
+    name?: string;
+    features?: Partial<MeetingFeatures>;
+    access?: MeetingAccess;
+    accessKey?: string;
+}
+export interface ApiErrorBody {
+    error: string;
+    message: string;
+    details?: unknown;
+}
+//# 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,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,sBAAsB,EAAE,eAKpC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,WAAW,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+export const defaultMeetingFeatures = {
+    camera: true,
+    microphone: true,
+    screenShare: true,
+    chat: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACrD,MAAM,EAAE,IAAI;IACZ,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,IAAI,EAAE,IAAI;CACX,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@quickmeet/sdk",
+  "version": "0.1.0",
+  "description": "Framework-agnostic QuickMeet browser SDK",
+  "license": "Apache-2.0",
+  "keywords": [
+    "quickmeet",
+    "video-conferencing",
+    "webrtc",
+    "livekit",
+    "sdk"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  }
+}