@wavezfm/api 0.1.0

package/dist/core/api.js

@@ -0,0 +1,327 @@
+import { ApiError } from "./ApiError";
+import { createSdkMessageFormatter, resolveSdkErrorMessage } from "./i18n";
+const DEFAULT_TIMEOUT_MS = 30_000;
+function ensureFetchImplementation(candidate, formatMessage) {
+    const resolved = candidate ?? globalThis.fetch;
+    if (typeof resolved !== "function") {
+        throw new Error(formatMessage?.("fetchUnavailable") ??
+            "Fetch API is unavailable. Provide `fetch` to createApi(...) or use a runtime with native fetch.");
+    }
+    return resolved;
+}
+function normalizeApiBaseURL(baseURL, formatMessage) {
+    const trimmed = baseURL.trim();
+    if (!trimmed) {
+        throw new Error(formatMessage?.("baseUrlRequired") ??
+            "`baseURL` is required to create the client.");
+    }
+    const url = new URL(trimmed);
+    const normalizedPathname = url.pathname.replace(/\/+$/, "");
+    url.pathname =
+        normalizedPathname.length === 0
+            ? resolveDefaultApiBasePath(url)
+            : normalizedPathname;
+    url.search = "";
+    url.hash = "";
+    return url.toString().replace(/\/$/, "");
+}
+function resolveDefaultApiBasePath(url) {
+    const hostname = url.hostname.trim().toLowerCase();
+    const isLocalDevelopmentHost = hostname === "localhost" ||
+        hostname === "127.0.0.1" ||
+        hostname === "::1" ||
+        hostname.endsWith(".localhost");
+    const isDedicatedApiHost = hostname === "api" || hostname.startsWith("api.");
+    const isCommonApiPort = url.port === "3001";
+    if (isLocalDevelopmentHost || isDedicatedApiHost || isCommonApiPort) {
+        return "/";
+    }
+    return "/api";
+}
+function buildRequestUrl(baseURL, path, query) {
+    const rawPath = path.trim();
+    const base = /^https?:\/\//i.test(rawPath)
+        ? new URL(rawPath)
+        : new URL(`${baseURL}${rawPath.startsWith("/") ? rawPath : `/${rawPath}`}`);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            appendQueryValue(base.searchParams, key, value);
+        }
+    }
+    return base.toString();
+}
+function appendQueryValue(searchParams, key, value) {
+    if (value === undefined) {
+        return;
+    }
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            if (entry !== undefined) {
+                searchParams.append(key, stringifyQueryValue(entry));
+            }
+        }
+        return;
+    }
+    searchParams.set(key, stringifyQueryValue(value));
+}
+function stringifyQueryValue(value) {
+    if (value === null) {
+        return "null";
+    }
+    return String(value);
+}
+function isFormData(value) {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+}
+function isUrlSearchParams(value) {
+    return value instanceof URLSearchParams;
+}
+function isBlobLike(value) {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+}
+function isArrayBufferLike(value) {
+    return value instanceof ArrayBuffer;
+}
+function hasJsonContentType(contentType) {
+    return contentType?.includes("application/json") ?? false;
+}
+function createTimeoutSignal(timeoutMs, signal) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    if (signal) {
+        if (signal.aborted) {
+            controller.abort();
+        }
+        else {
+            signal.addEventListener("abort", () => {
+                controller.abort();
+            }, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        cleanup() {
+            clearTimeout(timeoutId);
+        },
+    };
+}
+function extractErrorMessage(payload, fallback) {
+    if (typeof payload === "string" && payload.trim()) {
+        return payload;
+    }
+    if (payload && typeof payload === "object") {
+        const record = payload;
+        if (typeof record.error === "string" && record.error.trim()) {
+            return record.error;
+        }
+        if (typeof record.message === "string" && record.message.trim()) {
+            return record.message;
+        }
+    }
+    return fallback;
+}
+function extractErrorCode(payload) {
+    if (!payload || typeof payload !== "object") {
+        return null;
+    }
+    const record = payload;
+    return typeof record.code === "string" && record.code.trim()
+        ? record.code
+        : null;
+}
+export class WavezApi {
+    baseURL;
+    defaultHeaders;
+    timeout;
+    credentials;
+    fetchImpl;
+    logging;
+    messageFormatter;
+    authToken;
+    roomBotToken;
+    constructor(config) {
+        this.messageFormatter = createSdkMessageFormatter(config.locale, config.messages);
+        this.baseURL = normalizeApiBaseURL(config.baseURL, this.messageFormatter);
+        this.defaultHeaders = new Headers(config.headers);
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+        this.credentials = config.credentials ?? "include";
+        this.fetchImpl = ensureFetchImplementation(config.fetch, this.messageFormatter);
+        this.logging = config.logging ?? false;
+        this.authToken =
+            typeof config.authToken === "string" ? config.authToken : null;
+        this.roomBotToken =
+            typeof config.roomBotToken === "string"
+                ? config.roomBotToken
+                : null;
+    }
+    getBaseURL() {
+        return this.baseURL;
+    }
+    getSiteURL(path = "/") {
+        const url = new URL(this.baseURL);
+        return new URL(path, `${url.origin}/`).toString();
+    }
+    formatMessage(key, values) {
+        return this.messageFormatter(key, values);
+    }
+    setAuthToken(token) {
+        this.authToken = token && token.trim().length > 0 ? token : null;
+    }
+    getAuthToken() {
+        return this.authToken;
+    }
+    setRoomBotToken(token) {
+        this.roomBotToken = token && token.trim().length > 0 ? token : null;
+    }
+    getRoomBotToken() {
+        return this.roomBotToken;
+    }
+    async request(options) {
+        const method = options.method ?? "GET";
+        const url = buildRequestUrl(this.baseURL, options.path, options.query);
+        const headers = new Headers(this.defaultHeaders);
+        if (options.headers) {
+            const additionalHeaders = new Headers(options.headers);
+            additionalHeaders.forEach((value, key) => {
+                headers.set(key, value);
+            });
+        }
+        const authMode = options.authMode ?? "session";
+        if (authMode === "auth-token" &&
+            this.authToken &&
+            !headers.has("Authorization")) {
+            headers.set("Authorization", `Bearer ${this.authToken}`);
+        }
+        if (authMode === "room-bot" &&
+            this.roomBotToken &&
+            !headers.has("X-Wavez-Bot-Token")) {
+            headers.set("X-Wavez-Bot-Token", this.roomBotToken);
+        }
+        let body;
+        if (options.body !== undefined) {
+            if (typeof options.body === "string" ||
+                isFormData(options.body) ||
+                isUrlSearchParams(options.body) ||
+                isBlobLike(options.body) ||
+                isArrayBufferLike(options.body)) {
+                body = options.body;
+            }
+            else {
+                if (!headers.has("Content-Type")) {
+                    headers.set("Content-Type", "application/json");
+                }
+                body = JSON.stringify(options.body);
+            }
+        }
+        const timeout = createTimeoutSignal(this.timeout, options.signal);
+        const startedAt = Date.now();
+        if (this.logging) {
+            console.info(`[Wavez API] ${method} ${url}`);
+        }
+        try {
+            const response = await this.fetchImpl(url, {
+                method,
+                headers,
+                body,
+                credentials: options.credentials ?? this.credentials,
+                cache: options.cache,
+                signal: timeout.signal,
+            });
+            const completedAt = Date.now() - startedAt;
+            const parseAs = options.parseAs ?? "json";
+            const contentType = response.headers.get("content-type");
+            let payload = undefined;
+            if (parseAs === "text") {
+                payload = await response.text();
+            }
+            else if (parseAs === "json") {
+                if (response.status !== 204 && hasJsonContentType(contentType)) {
+                    payload = await response.json();
+                }
+                else if (response.status !== 204) {
+                    const text = await response.text();
+                    payload = text.length > 0 ? text : undefined;
+                }
+            }
+            if (!response.ok) {
+                const errorCode = extractErrorCode(payload);
+                const fallbackMessage = extractErrorMessage(payload, `Request failed with status ${response.status}.`);
+                throw new ApiError(resolveSdkErrorMessage(errorCode, fallbackMessage, this.messageFormatter), {
+                    status: response.status,
+                    statusText: response.statusText,
+                    code: errorCode,
+                    response: payload,
+                    headers: response.headers,
+                });
+            }
+            if (this.logging) {
+                console.info(`[Wavez API] ${method} ${url} -> ${response.status} (${completedAt}ms)`);
+            }
+            return {
+                data: parseAs === "void"
+                    ? undefined
+                    : (payload ?? undefined),
+                status: response.status,
+                headers: response.headers,
+            };
+        }
+        catch (error) {
+            if (error instanceof ApiError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new ApiError(this.messageFormatter("requestTimedOut"), {
+                    status: 408,
+                    statusText: "Request Timeout",
+                    code: "REQUEST_TIMEOUT",
+                });
+            }
+            throw error;
+        }
+        finally {
+            timeout.cleanup();
+        }
+    }
+    get(path, options) {
+        return this.request({
+            ...options,
+            path,
+            method: "GET",
+        });
+    }
+    post(path, body, options) {
+        return this.request({
+            ...options,
+            path,
+            method: "POST",
+            body,
+        });
+    }
+    put(path, body, options) {
+        return this.request({
+            ...options,
+            path,
+            method: "PUT",
+            body,
+        });
+    }
+    patch(path, body, options) {
+        return this.request({
+            ...options,
+            path,
+            method: "PATCH",
+            body,
+        });
+    }
+    delete(path, options) {
+        return this.request({
+            ...options,
+            path,
+            method: "DELETE",
+        });
+    }
+}
+export function createApi(config) {
+    return new WavezApi(config);
+}
+//# sourceMappingURL=api.js.map

package/dist/core/api.js.map

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

package/dist/core/i18n.d.ts

@@ -0,0 +1,3 @@
+import type { WavezApiLocale, WavezApiMessageKey, WavezApiMessages, WavezApiMessageValues } from "../types";
+export declare function createSdkMessageFormatter(locale?: WavezApiLocale, overrides?: WavezApiMessages): (key: WavezApiMessageKey, values?: WavezApiMessageValues) => string;
+export declare function resolveSdkErrorMessage(code: string | null, fallback: string, formatMessage: (key: WavezApiMessageKey, values?: WavezApiMessageValues) => string): string;

package/dist/core/i18n.js

@@ -0,0 +1,97 @@
+const DEFAULT_LOCALE = "en";
+const DEFAULT_MESSAGES = {
+    en: {
+        fetchUnavailable: "Fetch API is unavailable. Provide `fetch` to createApi(...) or use a runtime with native fetch.",
+        baseUrlRequired: "`baseURL` is required to create the client.",
+        requestTimedOut: "Request timed out.",
+        roomPermissionManageRoom: "You cannot manage this room.",
+        roomNotFound: "Room not found.",
+        roomBotInvalid: "Invalid room bot token.",
+        roomBotScopeMismatch: "This room bot token is not valid for the requested room.",
+        roomBotOwnerMissing: "The room bot owner no longer exists.",
+        roomBotOwnerBanned: "The room bot owner is suspended from Wavez.",
+        roomBotPermissionDenied: "This room bot token does not include the required permission.",
+        roomBotForbidden: "This room bot token is not allowed to perform this action.",
+        roomBotTokenRequired: "Room bot token is required.",
+        roomBotMuted: "The room bot owner is muted in this room.",
+        roomBotWebsocketFactoryRequired: "WebSocket is unavailable. Provide `websocketFactory` when creating the realtime client.",
+        roomBotWebsocketListenerUnsupported: "The provided WebSocket implementation does not support listeners.",
+        roomBotWebsocketNotConnected: "WebSocket is not connected.",
+        roomBotWebsocketCreateFailed: "Failed to create the room bot WebSocket.",
+        roomBotWebsocketConnectFailed: "Failed to connect the room bot WebSocket.",
+        roomBotCreateNameLengthInvalid: "Bot name must be between 2 and 40 characters.",
+        roomBotCreateAvatarUrlInvalid: "Bot avatar URL is invalid.",
+        roomBotCreateAvatarUrlDirectImageRequired: "Bot avatar URL must point directly to an image or GIF.",
+        roomBotCreatePermissionsArrayRequired: "Room bot permissions must be an array.",
+        roomBotCreatePermissionInvalid: "Invalid room bot permission.",
+        roomBotCreatePermissionRequired: "At least one room bot permission is required.",
+        roomBotCreatePrefixLengthInvalid: "Bot prefix must be between 1 and 12 characters.",
+        roomBotCreatePrefixWhitespaceInvalid: "Bot prefix cannot contain whitespace.",
+        roomBotCreateExpiryNumberInvalid: "Room bot expiration must be a valid number of hours.",
+        roomBotCreateExpiryRangeInvalid: "Room bot expiration must be between 1 and 720 hours.",
+    },
+    "pt-BR": {
+        fetchUnavailable: "A Fetch API não está disponível. Informe `fetch` em createApi(...) ou use um runtime com fetch nativo.",
+        baseUrlRequired: "`baseURL` é obrigatório para criar o client.",
+        requestTimedOut: "A requisição expirou.",
+        roomPermissionManageRoom: "Você não pode gerenciar esta sala.",
+        roomNotFound: "Sala não encontrada.",
+        roomBotInvalid: "Token de room bot inválido.",
+        roomBotScopeMismatch: "Este token de room bot não é válido para a sala solicitada.",
+        roomBotOwnerMissing: "O dono do room bot não existe mais.",
+        roomBotOwnerBanned: "O dono do room bot está suspenso do Wavez.",
+        roomBotPermissionDenied: "Este token de room bot não inclui a permissão necessária.",
+        roomBotForbidden: "Este token de room bot não pode executar esta ação.",
+        roomBotTokenRequired: "O token do room bot é obrigatório.",
+        roomBotMuted: "O dono do room bot está mutado nesta sala.",
+        roomBotWebsocketFactoryRequired: "WebSocket indisponível. Informe `websocketFactory` ao criar o realtime client.",
+        roomBotWebsocketListenerUnsupported: "A implementação de WebSocket informada não suporta listeners.",
+        roomBotWebsocketNotConnected: "WebSocket não conectado.",
+        roomBotWebsocketCreateFailed: "Falha ao criar o WebSocket do room bot.",
+        roomBotWebsocketConnectFailed: "Falha ao conectar o WebSocket do room bot.",
+        roomBotCreateNameLengthInvalid: "O nome do bot precisa ter entre 2 e 40 caracteres.",
+        roomBotCreateAvatarUrlInvalid: "A URL do avatar do bot é inválida.",
+        roomBotCreateAvatarUrlDirectImageRequired: "A URL do avatar do bot precisa apontar diretamente para uma imagem ou GIF.",
+        roomBotCreatePermissionsArrayRequired: "As permissões do room bot precisam ser um array.",
+        roomBotCreatePermissionInvalid: "Permissão de room bot inválida.",
+        roomBotCreatePermissionRequired: "Pelo menos uma permissão de room bot é obrigatória.",
+        roomBotCreatePrefixLengthInvalid: "O prefixo do bot precisa ter entre 1 e 12 caracteres.",
+        roomBotCreatePrefixWhitespaceInvalid: "O prefixo do bot não pode conter espaços.",
+        roomBotCreateExpiryNumberInvalid: "A expiração do room bot precisa ser um número válido de horas.",
+        roomBotCreateExpiryRangeInvalid: "A expiração do room bot precisa ficar entre 1 e 720 horas.",
+    },
+};
+const ERROR_CODE_MESSAGE_MAP = {
+    ROOM_PERMISSION_MANAGE_ROOM: "roomPermissionManageRoom",
+    ROOM_NOT_FOUND: "roomNotFound",
+    ROOM_BOT_INVALID: "roomBotInvalid",
+    ROOM_BOT_SCOPE_MISMATCH: "roomBotScopeMismatch",
+    ROOM_BOT_OWNER_MISSING: "roomBotOwnerMissing",
+    ROOM_BOT_OWNER_BANNED: "roomBotOwnerBanned",
+    ROOM_BOT_PERMISSION_DENIED: "roomBotPermissionDenied",
+    ROOM_BOT_FORBIDDEN: "roomBotForbidden",
+    ROOM_BOT_TOKEN_REQUIRED: "roomBotTokenRequired",
+    ROOM_BOT_MUTED: "roomBotMuted",
+};
+function interpolateMessage(template, values) {
+    if (!values) {
+        return template;
+    }
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+        const value = values[key];
+        return value == null ? `{${key}}` : String(value);
+    });
+}
+export function createSdkMessageFormatter(locale = DEFAULT_LOCALE, overrides = {}) {
+    const dictionary = {
+        ...DEFAULT_MESSAGES.en,
+        ...(DEFAULT_MESSAGES[locale] ?? DEFAULT_MESSAGES.en),
+        ...overrides,
+    };
+    return (key, values) => interpolateMessage(dictionary[key], values);
+}
+export function resolveSdkErrorMessage(code, fallback, formatMessage) {
+    const messageKey = code ? ERROR_CODE_MESSAGE_MAP[code] : null;
+    return messageKey ? formatMessage(messageKey) : fallback;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/core/i18n.js.map

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