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

package/dist/core/api/auth.api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.api.js","sourceRoot":"","sources":["../../../src/core/api/auth.api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAIvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,OAAO,EAA2B,MAAM,QAAQ,CAAA;AAsCzD;;;GAGG;AACH,MAAM,gBAAgB,GAAuB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;IACjE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU,CAAC,iBAAiB;YAC/B,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACxC,KAAK,UAAU,CAAC,cAAc;YAC5B,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACvC;YACE,OAAO,IAAI,CAAA,CAAC,oCAAoC;IACpD,CAAC;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAGzB,YAAY,MAAuB;QACjC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,sBAAsB,CAAA;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,OAAO,OAAO,CAAmB;YAC/B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,eAAe;YACpC,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;YACvC,IAAI,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE;YAC3C,kBAAkB,EAAE,gBAAgB;YACpC,YAAY,EAAE,gCAAgC;SAC/C,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,MAAuB;QACvC,OAAO,OAAO,CAAmB;YAC/B,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,eAAe;YACpC,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,SAAS,EAAE,EAAE;YACxD,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB;YACD,kBAAkB,EAAE,gBAAgB;YACpC,YAAY,EAAE,yBAAyB;SACxC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/core/api/http.d.ts

@@ -0,0 +1,86 @@
+import { VroomError } from '../errors/vroom.error';
+/**
+ * API error response from Vroom backend
+ */
+export interface ApiErrorResponse {
+    code: string;
+    message: string;
+}
+/**
+ * Error context passed to custom error handlers
+ */
+export interface ErrorContext {
+    response: Response;
+    code: string;
+    message: string;
+}
+/**
+ * Custom error handler for endpoint-specific errors.
+ * Return a VroomError to throw it, or null to fallback to common error handling.
+ */
+export type CustomErrorHandler = (ctx: ErrorContext) => VroomError | null;
+/**
+ * Base request options shared by request and requestVoid
+ */
+export interface BaseRequestOptions<TBody = unknown> {
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    /** Full URL to request */
+    url: string;
+    /** Request body (will be JSON stringified) */
+    body?: TBody;
+    /** Additional headers to include in the request */
+    headers?: Record<string, string>;
+    /** Custom error handler for endpoint-specific errors */
+    customErrorHandler?: CustomErrorHandler;
+}
+/**
+ * Request options for endpoints that return JSON data
+ */
+export interface RequestOptions<TBody = unknown> extends BaseRequestOptions<TBody> {
+    /** Error message for NetworkError when fetch fails */
+    errorMessage: string;
+}
+/**
+ * Request options for endpoints that return no content (204, etc.)
+ */
+export interface RequestVoidOptions<TBody = unknown> extends BaseRequestOptions<TBody> {
+    /** Error message for NetworkError when fetch fails (optional for void requests) */
+    errorMessage?: string;
+}
+/**
+ * Handle API error response with optional custom handler.
+ *
+ * Flow:
+ * 1. Try custom handler first (for endpoint-specific errors)
+ * 2. Handle common errors (BadRequest, PermissionDenied)
+ * 3. HTTP status fallback (403, 5xx)
+ * 4. Default to NetworkError
+ *
+ * @param response - Fetch response object
+ * @param customHandler - Optional custom error handler
+ */
+export declare function handleApiError(response: Response, customHandler?: CustomErrorHandler): Promise<never>;
+/**
+ * Make an HTTP request to the Vroom API that returns JSON data.
+ *
+ * Use this for endpoints that return a response body.
+ * For endpoints that return no content (204), use `requestVoid` instead.
+ *
+ * @param options - Request options
+ * @returns Parsed JSON response
+ * @throws NetworkError if response body is empty (unexpected)
+ * @throws VroomError subclass based on error type
+ */
+export declare function request<TResponse, TBody = unknown>(options: RequestOptions<TBody>): Promise<TResponse>;
+/**
+ * Make an HTTP request to the Vroom API that returns no content.
+ *
+ * Use this for endpoints that return 204 No Content or empty body.
+ * For endpoints that return JSON data, use `request` instead.
+ *
+ * @param options - Request options
+ * @throws VroomError subclass based on error type
+ */
+export declare function requestVoid<TBody = unknown>(options: RequestVoidOptions<TBody>): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/core/api/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/api/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,UAAU,EACX,MAAM,uBAAuB,CAAA;AAG9B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,UAAU,GAAG,IAAI,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO;IACjD,kBAAkB;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;IACzC,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,kBAAkB,CAAC,KAAK,CAAC;IAChF,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,kBAAkB,CAAC,KAAK,CAAC;IACpF,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,QAAQ,EAClB,aAAa,CAAC,EAAE,kBAAkB,GACjC,OAAO,CAAC,KAAK,CAAC,CA4ChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,KAAK,GAAG,OAAO,EACtD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAC7B,OAAO,CAAC,SAAS,CAAC,CA+BpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,KAAK,GAAG,OAAO,EAC/C,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/core/api/http.js

@@ -0,0 +1,146 @@
+import { BadRequestError, ConflictError, ForbiddenError, MethodNotAllowedError, NetworkError, NotFoundError, PermissionDeniedError, ServiceError, UnauthorizedError, VroomError, } from '../errors/vroom.error';
+import { ErrorCodes } from '../errors/error-codes';
+/**
+ * Parse error response from API
+ */
+async function parseErrorResponse(response) {
+    let errorData = null;
+    try {
+        errorData = (await response.json());
+    }
+    catch {
+        // Response body is not JSON
+    }
+    return {
+        code: errorData?.code ?? 'E_UNKNOWN',
+        message: errorData?.message ?? `HTTP ${response.status}`,
+    };
+}
+/**
+ * Handle API error response with optional custom handler.
+ *
+ * Flow:
+ * 1. Try custom handler first (for endpoint-specific errors)
+ * 2. Handle common errors (BadRequest, PermissionDenied)
+ * 3. HTTP status fallback (403, 5xx)
+ * 4. Default to NetworkError
+ *
+ * @param response - Fetch response object
+ * @param customHandler - Optional custom error handler
+ */
+export async function handleApiError(response, customHandler) {
+    const { code, message } = await parseErrorResponse(response);
+    const ctx = { response, code, message };
+    // 1. Try custom handler first
+    if (customHandler) {
+        const customError = customHandler(ctx);
+        if (customError)
+            throw customError;
+    }
+    // 2. Common errors by error code (from response body)
+    switch (code) {
+        case ErrorCodes.E_BAD_REQUEST:
+            throw new BadRequestError(message);
+        case ErrorCodes.E_PERMISSION_DENIED:
+            throw new PermissionDeniedError(message);
+        case ErrorCodes.E_FORBIDDEN:
+            throw new ForbiddenError(message);
+        case ErrorCodes.E_METHOD_NOT_ALLOWED:
+            throw new MethodNotAllowedError(message);
+    }
+    // 3. HTTP status fallback (when no specific error code)
+    switch (response.status) {
+        case 400:
+            throw new BadRequestError(message);
+        case 401:
+            throw new UnauthorizedError(message);
+        case 403:
+            throw new PermissionDeniedError(message);
+        case 404:
+            throw new NotFoundError(message);
+        case 405:
+            throw new MethodNotAllowedError(message);
+        case 409:
+            throw new ConflictError(message);
+    }
+    if (response.status >= 500) {
+        throw new ServiceError(message);
+    }
+    // 4. Default - unknown 4xx errors
+    throw new BadRequestError(message);
+}
+/**
+ * Make an HTTP request to the Vroom API that returns JSON data.
+ *
+ * Use this for endpoints that return a response body.
+ * For endpoints that return no content (204), use `requestVoid` instead.
+ *
+ * @param options - Request options
+ * @returns Parsed JSON response
+ * @throws NetworkError if response body is empty (unexpected)
+ * @throws VroomError subclass based on error type
+ */
+export async function request(options) {
+    const { method, url, body, headers, customErrorHandler, errorMessage } = options;
+    try {
+        const response = await fetch(url, {
+            method,
+            headers: {
+                ...(body !== undefined && { 'Content-Type': 'application/json' }),
+                ...headers,
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            await handleApiError(response, customErrorHandler);
+        }
+        const text = await response.text();
+        if (!text) {
+            throw new NetworkError('Expected response body but received empty');
+        }
+        return JSON.parse(text);
+    }
+    catch (error) {
+        // Re-throw SDK errors as-is
+        if (error instanceof VroomError) {
+            throw error;
+        }
+        // Wrap other errors (TypeError, fetch errors, etc.) as NetworkError
+        throw new NetworkError(errorMessage, error);
+    }
+}
+/**
+ * Make an HTTP request to the Vroom API that returns no content.
+ *
+ * Use this for endpoints that return 204 No Content or empty body.
+ * For endpoints that return JSON data, use `request` instead.
+ *
+ * @param options - Request options
+ * @throws VroomError subclass based on error type
+ */
+export async function requestVoid(options) {
+    const { method, url, body, headers, customErrorHandler, errorMessage } = options;
+    try {
+        const response = await fetch(url, {
+            method,
+            headers: {
+                ...(body !== undefined && { 'Content-Type': 'application/json' }),
+                ...headers,
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            await handleApiError(response, customErrorHandler);
+        }
+        // Don't parse response body - this is a void endpoint
+    }
+    catch (error) {
+        // Re-throw SDK errors as-is
+        if (error instanceof VroomError) {
+            throw error;
+        }
+        // Wrap other errors (TypeError, fetch errors, etc.) as NetworkError
+        throw new NetworkError(errorMessage ?? 'Request failed', error);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/core/api/http.js.map

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

package/dist/core/errors/error-codes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Standard error codes for Vroom SDK
+ */
+export declare const ErrorCodes: {
+    /** Missing or invalid request fields */
+    readonly E_BAD_REQUEST: "E_BAD_REQUEST";
+    /** API key validation failed */
+    readonly E_INVALID_API_KEY: "E_INVALID_API_KEY";
+    /** Invalid or expired auth token */
+    readonly E_UNAUTHORIZED: "E_UNAUTHORIZED";
+    /** Invalid or malformed token */
+    readonly E_INVALID_TOKEN: "E_INVALID_TOKEN";
+    /** Platform restriction violated */
+    readonly E_PLATFORM_MISMATCH: "E_PLATFORM_MISMATCH";
+    /** Network error occurred */
+    readonly E_NETWORK: "E_NETWORK";
+    /** Operation timed out */
+    readonly E_TIMEOUT: "E_TIMEOUT";
+    /** Service-specific error */
+    readonly E_SERVICE_ERROR: "E_SERVICE_ERROR";
+    /** Media permission denied */
+    readonly E_PERMISSION_DENIED: "E_PERMISSION_DENIED";
+    /** Media device operation failed (e.g., mute/unmute, device disconnected) */
+    readonly E_MEDIA: "E_MEDIA";
+    /** Feature not supported */
+    readonly E_UNSUPPORTED_FEATURE: "E_UNSUPPORTED_FEATURE";
+    /** Failed to start recording */
+    readonly E_RECORDING_START: "E_RECORDING_START";
+    /** Unsupported RTC provider */
+    readonly E_UNSUPPORTED_PROVIDER: "E_UNSUPPORTED_PROVIDER";
+    /** Resource not found */
+    readonly E_NOT_FOUND: "E_NOT_FOUND";
+    /** Resource conflict (e.g., already exists) */
+    readonly E_CONFLICT: "E_CONFLICT";
+    /** HTTP method not allowed */
+    readonly E_METHOD_NOT_ALLOWED: "E_METHOD_NOT_ALLOWED";
+    /** Access to resource is forbidden (e.g., cross-room access) */
+    readonly E_FORBIDDEN: "E_FORBIDDEN";
+    /** Internal server error */
+    readonly E_INTERNAL: "E_INTERNAL";
+};
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/core/errors/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/core/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,wCAAwC;;IAExC,gCAAgC;;IAEhC,oCAAoC;;IAEpC,iCAAiC;;IAEjC,oCAAoC;;IAEpC,6BAA6B;;IAE7B,0BAA0B;;IAE1B,6BAA6B;;IAE7B,8BAA8B;;IAE9B,6EAA6E;;IAE7E,4BAA4B;;IAE5B,gCAAgC;;IAEhC,+BAA+B;;IAE/B,yBAAyB;;IAEzB,+CAA+C;;IAE/C,8BAA8B;;IAE9B,gEAAgE;;IAEhE,4BAA4B;;CAEpB,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA"}

package/dist/core/errors/error-codes.js

@@ -0,0 +1,42 @@
+/**
+ * Standard error codes for Vroom SDK
+ */
+export const ErrorCodes = {
+    /** Missing or invalid request fields */
+    E_BAD_REQUEST: 'E_BAD_REQUEST',
+    /** API key validation failed */
+    E_INVALID_API_KEY: 'E_INVALID_API_KEY',
+    /** Invalid or expired auth token */
+    E_UNAUTHORIZED: 'E_UNAUTHORIZED',
+    /** Invalid or malformed token */
+    E_INVALID_TOKEN: 'E_INVALID_TOKEN',
+    /** Platform restriction violated */
+    E_PLATFORM_MISMATCH: 'E_PLATFORM_MISMATCH',
+    /** Network error occurred */
+    E_NETWORK: 'E_NETWORK',
+    /** Operation timed out */
+    E_TIMEOUT: 'E_TIMEOUT',
+    /** Service-specific error */
+    E_SERVICE_ERROR: 'E_SERVICE_ERROR',
+    /** Media permission denied */
+    E_PERMISSION_DENIED: 'E_PERMISSION_DENIED',
+    /** Media device operation failed (e.g., mute/unmute, device disconnected) */
+    E_MEDIA: 'E_MEDIA',
+    /** Feature not supported */
+    E_UNSUPPORTED_FEATURE: 'E_UNSUPPORTED_FEATURE',
+    /** Failed to start recording */
+    E_RECORDING_START: 'E_RECORDING_START',
+    /** Unsupported RTC provider */
+    E_UNSUPPORTED_PROVIDER: 'E_UNSUPPORTED_PROVIDER',
+    /** Resource not found */
+    E_NOT_FOUND: 'E_NOT_FOUND',
+    /** Resource conflict (e.g., already exists) */
+    E_CONFLICT: 'E_CONFLICT',
+    /** HTTP method not allowed */
+    E_METHOD_NOT_ALLOWED: 'E_METHOD_NOT_ALLOWED',
+    /** Access to resource is forbidden (e.g., cross-room access) */
+    E_FORBIDDEN: 'E_FORBIDDEN',
+    /** Internal server error */
+    E_INTERNAL: 'E_INTERNAL',
+};
+//# sourceMappingURL=error-codes.js.map

package/dist/core/errors/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../src/core/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,wCAAwC;IACxC,aAAa,EAAE,eAAe;IAC9B,gCAAgC;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,oCAAoC;IACpC,cAAc,EAAE,gBAAgB;IAChC,iCAAiC;IACjC,eAAe,EAAE,iBAAiB;IAClC,oCAAoC;IACpC,mBAAmB,EAAE,qBAAqB;IAC1C,6BAA6B;IAC7B,SAAS,EAAE,WAAW;IACtB,0BAA0B;IAC1B,SAAS,EAAE,WAAW;IACtB,6BAA6B;IAC7B,eAAe,EAAE,iBAAiB;IAClC,8BAA8B;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,6EAA6E;IAC7E,OAAO,EAAE,SAAS;IAClB,4BAA4B;IAC5B,qBAAqB,EAAE,uBAAuB;IAC9C,gCAAgC;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,+BAA+B;IAC/B,sBAAsB,EAAE,wBAAwB;IAChD,yBAAyB;IACzB,WAAW,EAAE,aAAa;IAC1B,+CAA+C;IAC/C,UAAU,EAAE,YAAY;IACxB,8BAA8B;IAC9B,oBAAoB,EAAE,sBAAsB;IAC5C,gEAAgE;IAChE,WAAW,EAAE,aAAa;IAC1B,4BAA4B;IAC5B,UAAU,EAAE,YAAY;CAChB,CAAA"}

package/dist/core/errors/vroom.error.d.ts

@@ -0,0 +1,99 @@
+import { type ErrorCode } from './error-codes';
+/**
+ * Base error class for Vroom SDK
+ * All errors extend this class
+ */
+export declare class VroomError extends Error {
+    /** Error code */
+    readonly code: ErrorCode;
+    /** Additional error details */
+    readonly details?: unknown;
+    /** Error timestamp */
+    readonly timestamp: number;
+    constructor(code: ErrorCode, message: string, details?: unknown);
+}
+/**
+ * Bad request error - missing or invalid request fields
+ */
+export declare class BadRequestError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Invalid API key error
+ */
+export declare class InvalidApiKeyError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Unauthorized error - invalid or expired auth token
+ */
+export declare class UnauthorizedError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Platform mismatch error
+ */
+export declare class PlatformMismatchError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Network error
+ */
+export declare class NetworkError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Timeout error
+ */
+export declare class TimeoutError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Service error
+ */
+export declare class ServiceError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Permission denied error
+ */
+export declare class PermissionDeniedError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Unsupported feature error
+ */
+export declare class UnsupportedFeatureError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Recording start error
+ */
+export declare class RecordingStartError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Not found error - resource does not exist
+ */
+export declare class NotFoundError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Conflict error - resource already exists or state conflict
+ */
+export declare class ConflictError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Method not allowed error
+ */
+export declare class MethodNotAllowedError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Forbidden error - access to resource is forbidden (e.g., cross-room access)
+ */
+export declare class ForbiddenError extends VroomError {
+    constructor(message?: string, details?: unknown);
+}
+//# sourceMappingURL=vroom.error.d.ts.map

package/dist/core/errors/vroom.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vroom.error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/vroom.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AAE1D;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAOhE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,SAAgB,EAAE,OAAO,CAAC,EAAE,OAAO;CAIvD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,SAA8B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIrE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,SAAiB,EAAE,OAAO,CAAC,EAAE,OAAO;CAIxD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,OAAO,SAAkC,EAAE,OAAO,CAAC,EAAE,OAAO;CAIzE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,SAA2B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIlE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,SAAwB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/D;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,SAA2B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIlE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,SAA0B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIjE;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,SAA8B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIrE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,SAAuB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI9D;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,OAAO,SAAuB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI9D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,SAAc,EAAE,OAAO,CAAC,EAAE,OAAO;CAIrD"}

package/dist/core/errors/vroom.error.js

@@ -0,0 +1,141 @@
+import { ErrorCodes } from './error-codes';
+/**
+ * Base error class for Vroom SDK
+ * All errors extend this class
+ */
+export class VroomError extends Error {
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'VroomError';
+        this.code = code;
+        this.details = details;
+        this.timestamp = Date.now();
+    }
+}
+/**
+ * Bad request error - missing or invalid request fields
+ */
+export class BadRequestError extends VroomError {
+    constructor(message = 'Bad request', details) {
+        super(ErrorCodes.E_BAD_REQUEST, message, details);
+        this.name = 'BadRequestError';
+    }
+}
+/**
+ * Invalid API key error
+ */
+export class InvalidApiKeyError extends VroomError {
+    constructor(message = 'API key validation failed', details) {
+        super(ErrorCodes.E_INVALID_API_KEY, message, details);
+        this.name = 'InvalidApiKeyError';
+    }
+}
+/**
+ * Unauthorized error - invalid or expired auth token
+ */
+export class UnauthorizedError extends VroomError {
+    constructor(message = 'Unauthorized', details) {
+        super(ErrorCodes.E_UNAUTHORIZED, message, details);
+        this.name = 'UnauthorizedError';
+    }
+}
+/**
+ * Platform mismatch error
+ */
+export class PlatformMismatchError extends VroomError {
+    constructor(message = 'Platform restriction violated', details) {
+        super(ErrorCodes.E_PLATFORM_MISMATCH, message, details);
+        this.name = 'PlatformMismatchError';
+    }
+}
+/**
+ * Network error
+ */
+export class NetworkError extends VroomError {
+    constructor(message = 'Network error occurred', details) {
+        super(ErrorCodes.E_NETWORK, message, details);
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Timeout error
+ */
+export class TimeoutError extends VroomError {
+    constructor(message = 'Operation timed out', details) {
+        super(ErrorCodes.E_TIMEOUT, message, details);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Service error
+ */
+export class ServiceError extends VroomError {
+    constructor(message = 'Service error occurred', details) {
+        super(ErrorCodes.E_SERVICE_ERROR, message, details);
+        this.name = 'ServiceError';
+    }
+}
+/**
+ * Permission denied error
+ */
+export class PermissionDeniedError extends VroomError {
+    constructor(message = 'Permission denied', details) {
+        super(ErrorCodes.E_PERMISSION_DENIED, message, details);
+        this.name = 'PermissionDeniedError';
+    }
+}
+/**
+ * Unsupported feature error
+ */
+export class UnsupportedFeatureError extends VroomError {
+    constructor(message = 'Feature not supported', details) {
+        super(ErrorCodes.E_UNSUPPORTED_FEATURE, message, details);
+        this.name = 'UnsupportedFeatureError';
+    }
+}
+/**
+ * Recording start error
+ */
+export class RecordingStartError extends VroomError {
+    constructor(message = 'Failed to start recording', details) {
+        super(ErrorCodes.E_RECORDING_START, message, details);
+        this.name = 'RecordingStartError';
+    }
+}
+/**
+ * Not found error - resource does not exist
+ */
+export class NotFoundError extends VroomError {
+    constructor(message = 'Resource not found', details) {
+        super(ErrorCodes.E_NOT_FOUND, message, details);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Conflict error - resource already exists or state conflict
+ */
+export class ConflictError extends VroomError {
+    constructor(message = 'Resource conflict', details) {
+        super(ErrorCodes.E_CONFLICT, message, details);
+        this.name = 'ConflictError';
+    }
+}
+/**
+ * Method not allowed error
+ */
+export class MethodNotAllowedError extends VroomError {
+    constructor(message = 'Method not allowed', details) {
+        super(ErrorCodes.E_METHOD_NOT_ALLOWED, message, details);
+        this.name = 'MethodNotAllowedError';
+    }
+}
+/**
+ * Forbidden error - access to resource is forbidden (e.g., cross-room access)
+ */
+export class ForbiddenError extends VroomError {
+    constructor(message = 'Forbidden', details) {
+        super(ErrorCodes.E_FORBIDDEN, message, details);
+        this.name = 'ForbiddenError';
+    }
+}
+//# sourceMappingURL=vroom.error.js.map

package/dist/core/errors/vroom.error.js.map

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

package/dist/core/ports/outbound/provider-adapter-factory.port.d.ts

@@ -0,0 +1,41 @@
+import type { ProviderAdapter } from './provider-adapter.port';
+import type { ServiceContext } from '../../types/service-adapters.types';
+import type { Platform } from '../../types/vroom.types';
+/**
+ * Factory interface for creating provider adapters.
+ *
+ * This is the port (interface) that provider implementations must implement.
+ * The factory pattern allows the core to create adapters without knowing
+ * the concrete implementation, following Hexagonal Architecture principles.
+ *
+ * ## Lazy Loading
+ *
+ * Provider factories are async so adapters can be loaded lazily on demand.
+ * Platform setup (e.g., React Native WebRTC globals) should be handled during
+ * SDK init, before connect() is called.
+ *
+ * @example
+ * ```typescript
+ * // In adapter layer (e.g., adapters/livekit/index.ts)
+ * export const LiveKitAdapterFactory: ProviderAdapterFactory = {
+ *   create: async (context, _platform) => {
+ *     // Import adapter only when needed
+ *     const { LiveKitAdapter } = await import('./livekit.adapter')
+ *     return new LiveKitAdapter(context)
+ *   },
+ * }
+ * ```
+ */
+export interface ProviderAdapterFactory {
+    /**
+     * Create a new provider adapter instance.
+     *
+     * Can be async to support lazy loading.
+     *
+     * @param serviceContext - Context containing session token and API endpoint
+     * @param platform - Target platform ('web', 'ios', 'android') for platform-specific setup
+     * @returns A new ProviderAdapter instance (sync or async)
+     */
+    create(serviceContext: ServiceContext, platform: Platform): ProviderAdapter | Promise<ProviderAdapter>;
+}
+//# sourceMappingURL=provider-adapter-factory.port.d.ts.map

package/dist/core/ports/outbound/provider-adapter-factory.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter-factory.port.d.ts","sourceRoot":"","sources":["../../../../src/core/ports/outbound/provider-adapter-factory.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACvG"}

package/dist/core/ports/outbound/provider-adapter-factory.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-adapter-factory.port.js.map

package/dist/core/ports/outbound/provider-adapter-factory.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter-factory.port.js","sourceRoot":"","sources":["../../../../src/core/ports/outbound/provider-adapter-factory.port.ts"],"names":[],"mappings":""}