@seleniumbox/sbox-mcp 0.2.0

package/dist/adapters/index.d.ts

@@ -0,0 +1,16 @@
+export { authAdapter } from "./auth.adapter";
+export type { AuthAdapter, UserSessionApi } from "./auth.adapter";
+export { sessionAdapter } from "./session.adapter";
+export type { SessionAdapter, ESSessionDataRaw } from "./session.adapter";
+export { browserAdapter, BROWSER_NAMES } from "./browser.adapter";
+export type { BrowserAdapter } from "./browser.adapter";
+export { deviceAdapter } from "./device.adapter";
+export type { DeviceAdapter } from "./device.adapter";
+export { projectAdapter } from "./project.adapter";
+export type { ProjectAdapter } from "./project.adapter";
+export { userAdapter } from "./user.adapter";
+export type { UserAdapter } from "./user.adapter";
+export { statsAdapter } from "./stats.adapter";
+export type { StatsAdapter } from "./stats.adapter";
+export { uploadAdapter } from "./upload.adapter";
+export type { UploadAdapter } from "./upload.adapter";

package/dist/adapters/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadAdapter = exports.statsAdapter = exports.userAdapter = exports.projectAdapter = exports.deviceAdapter = exports.BROWSER_NAMES = exports.browserAdapter = exports.sessionAdapter = exports.authAdapter = void 0;
+var auth_adapter_1 = require("./auth.adapter");
+Object.defineProperty(exports, "authAdapter", { enumerable: true, get: function () { return auth_adapter_1.authAdapter; } });
+var session_adapter_1 = require("./session.adapter");
+Object.defineProperty(exports, "sessionAdapter", { enumerable: true, get: function () { return session_adapter_1.sessionAdapter; } });
+var browser_adapter_1 = require("./browser.adapter");
+Object.defineProperty(exports, "browserAdapter", { enumerable: true, get: function () { return browser_adapter_1.browserAdapter; } });
+Object.defineProperty(exports, "BROWSER_NAMES", { enumerable: true, get: function () { return browser_adapter_1.BROWSER_NAMES; } });
+var device_adapter_1 = require("./device.adapter");
+Object.defineProperty(exports, "deviceAdapter", { enumerable: true, get: function () { return device_adapter_1.deviceAdapter; } });
+var project_adapter_1 = require("./project.adapter");
+Object.defineProperty(exports, "projectAdapter", { enumerable: true, get: function () { return project_adapter_1.projectAdapter; } });
+var user_adapter_1 = require("./user.adapter");
+Object.defineProperty(exports, "userAdapter", { enumerable: true, get: function () { return user_adapter_1.userAdapter; } });
+var stats_adapter_1 = require("./stats.adapter");
+Object.defineProperty(exports, "statsAdapter", { enumerable: true, get: function () { return stats_adapter_1.statsAdapter; } });
+var upload_adapter_1 = require("./upload.adapter");
+Object.defineProperty(exports, "uploadAdapter", { enumerable: true, get: function () { return upload_adapter_1.uploadAdapter; } });

package/dist/adapters/project.adapter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Adapter for SBOX project/testproject APIs. Calls /testprojects and count-per-project.
+ * No business logic; only HTTP and response typing.
+ */
+export interface TestProjectRaw {
+    name?: string;
+    id?: number;
+    description?: string;
+    token?: {
+        id?: string;
+        token?: string;
+        createdAt?: string;
+    };
+    [key: string]: unknown;
+}
+export interface CountByProjectRaw {
+    project?: string;
+    count?: number;
+}
+export interface ProjectAdapter {
+    listProjects(token: string): Promise<{
+        status: number;
+        projects: TestProjectRaw[];
+        error?: string;
+    }>;
+    /** My Projects page: projects the user has right to (token:selfservice). */
+    listMyProjects(token: string): Promise<{
+        status: number;
+        projects: TestProjectRaw[];
+        error?: string;
+    }>;
+    getCountPerProject(days: number, token: string): Promise<{
+        status: number;
+        items: CountByProjectRaw[];
+        error?: string;
+    }>;
+}
+export declare const projectAdapter: ProjectAdapter;

package/dist/adapters/project.adapter.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Adapter for SBOX project/testproject APIs. Calls /testprojects and count-per-project.
+ * No business logic; only HTTP and response typing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectAdapter = void 0;
+const sbox_api_client_1 = require("./sbox-api.client");
+async function listProjects(token) {
+    const { data, status } = await (0, sbox_api_client_1.get)("testprojects", token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to list projects";
+        return { status, projects: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, projects: list };
+}
+/** GET /e34/api/test-projects?requestedRight=token:selfservice — matches My Projects page in sbox-fe-v2. */
+async function listMyProjects(token) {
+    const path = "test-projects?requestedRight=token:selfservice";
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to list my projects";
+        return { status, projects: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, projects: list };
+}
+async function getCountPerProject(days, token) {
+    const path = `tests/count-per-project?days=${days}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get count per project";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+exports.projectAdapter = { listProjects, listMyProjects, getCountPerProject };

package/dist/adapters/sbox-api.client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTTP client for SBOX backend API. All calls go to /e34/api/*.
+ * Does not contain business logic; only request/response handling.
+ */
+export interface SboxApiResponse<T> {
+    data: T;
+    status: number;
+}
+export interface SboxApiError {
+    success: false;
+    message: string;
+    type?: string;
+    status: number;
+}
+/** GET without sbox-mcp-server header (for MCP add-on check before login redirect). */
+export declare function getPublic<T>(path: string): Promise<SboxApiResponse<T>>;
+export declare function get<T>(path: string, token?: string | null): Promise<SboxApiResponse<T>>;
+export declare function post<T>(path: string, body: unknown, token?: string | null): Promise<SboxApiResponse<T>>;
+export interface MultipartFormDataLike {
+    getHeaders?: () => Record<string, string>;
+}
+export declare function postMultipart<T>(path: string, formData: FormData | MultipartFormDataLike, token?: string | null): Promise<SboxApiResponse<T>>;
+export declare function put<T>(path: string, body: unknown, token?: string | null): Promise<SboxApiResponse<T>>;
+export declare function del<T>(path: string, token?: string | null): Promise<SboxApiResponse<T>>;
+export declare function isSboxError(res: unknown): res is {
+    success: boolean;
+    message: string;
+    type?: string;
+};
+export declare function toSboxApiError(err: unknown, defaultStatus: number): SboxApiError;
+export declare function extractToken(authHeader: string | undefined): string | null;

package/dist/adapters/sbox-api.client.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * HTTP client for SBOX backend API. All calls go to /e34/api/*.
+ * Does not contain business logic; only request/response handling.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPublic = getPublic;
+exports.get = get;
+exports.post = post;
+exports.postMultipart = postMultipart;
+exports.put = put;
+exports.del = del;
+exports.isSboxError = isSboxError;
+exports.toSboxApiError = toSboxApiError;
+exports.extractToken = extractToken;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("../config");
+function createClient(token, omitContentType = false) {
+    const headers = {
+        Accept: "application/json",
+        [config_1.config.mcpServerHeaderName]: config_1.config.mcpVersion,
+    };
+    if (!omitContentType)
+        headers["Content-Type"] = "application/json";
+    if (token)
+        headers[config_1.config.jwtHeader] = token;
+    return axios_1.default.create({
+        baseURL: config_1.config.sboxApiBaseUrl + config_1.config.sboxApiPrefix,
+        timeout: config_1.config.requestTimeoutMs,
+        headers,
+        validateStatus: () => true,
+    });
+}
+/** GET without sbox-mcp-server header (for MCP add-on check before login redirect). */
+async function getPublic(path) {
+    const url = (path.startsWith("/") ? path : `/${path}`).replace(/^\//, "");
+    const fullUrl = config_1.config.sboxApiBaseUrl + config_1.config.sboxApiPrefix + "/" + url;
+    const res = await axios_1.default.get(fullUrl, {
+        timeout: config_1.config.requestTimeoutMs,
+        headers: { Accept: "application/json" },
+        validateStatus: () => true,
+    });
+    return { data: res.data, status: res.status };
+}
+async function get(path, token) {
+    const client = createClient(token);
+    const url = path.startsWith("/") ? path : `/${path}`;
+    const res = await client.get(url);
+    return { data: res.data, status: res.status };
+}
+async function post(path, body, token) {
+    const client = createClient(token);
+    const url = path.startsWith("/") ? path : `/${path}`;
+    const res = await client.post(url, body);
+    return { data: res.data, status: res.status };
+}
+async function postMultipart(path, formData, token) {
+    const client = createClient(token, true);
+    const url = path.startsWith("/") ? path : `/${path}`;
+    const extraHeaders = formData && typeof formData.getHeaders === "function" ? formData.getHeaders() : {};
+    const res = await client.post(url, formData, { headers: extraHeaders });
+    return { data: res.data, status: res.status };
+}
+async function put(path, body, token) {
+    const client = createClient(token);
+    const url = path.startsWith("/") ? path : `/${path}`;
+    const res = await client.put(url, body);
+    return { data: res.data, status: res.status };
+}
+async function del(path, token) {
+    const client = createClient(token);
+    const url = path.startsWith("/") ? path : `/${path}`;
+    const res = await client.delete(url);
+    return { data: res.data, status: res.status };
+}
+function isSboxError(res) {
+    return (typeof res === "object" &&
+        res !== null &&
+        "success" in res &&
+        res.success === false &&
+        "message" in res);
+}
+function toSboxApiError(err, defaultStatus) {
+    if (axios_1.default.isAxiosError(err)) {
+        const ax = err;
+        const status = ax.response?.status ?? defaultStatus;
+        const message = ax.response?.data?.message ?? ax.message ?? "Request failed";
+        const data = ax.response?.data;
+        return { success: false, message, status, type: data?.type };
+    }
+    const message = err instanceof Error ? err.message : "Unknown error";
+    return { success: false, message, status: defaultStatus };
+}
+function extractToken(authHeader) {
+    if (!authHeader || typeof authHeader !== "string")
+        return null;
+    const v = authHeader.trim();
+    if (v.toLowerCase().startsWith("bearer "))
+        return v.slice(7).trim();
+    return v;
+}

package/dist/adapters/session.adapter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Adapter for SBOX session APIs. Calls session, video, manual, purge, builds/status.
+ * No business logic; only HTTP and response typing.
+ */
+export interface ESSessionDataRaw {
+    ekey?: string;
+    browser?: string;
+    version?: string;
+    browserVersion?: string;
+    deviceName?: string;
+    platformName?: string;
+    platformVersion?: string;
+    result?: string;
+    duration?: number;
+    framework?: string;
+    originIp?: string;
+    node?: string;
+    index?: string;
+    extras?: Record<string, unknown>;
+    "@timestamp"?: string;
+    [key: string]: unknown;
+}
+export interface PaginatedSessionsRaw {
+    content?: ESSessionDataRaw[];
+    totalElements?: number;
+}
+export interface SessionAdapter {
+    getByEkey(ekey: string, token: string): Promise<{
+        status: number;
+        data: ESSessionDataRaw | null;
+        error?: string;
+    }>;
+    getVideoUrl(sessionId: string, token: string): Promise<{
+        status: number;
+        videoUrl: string | null;
+        error?: string;
+    }>;
+    /** Update a single session's result via POST /e34/api/test-data?sessionId=&passed= */
+    updateSessionStatus(sessionId: string, passed: boolean, token: string): Promise<{
+        status: number;
+        error?: string;
+    }>;
+    updateStatusByBuild(params: {
+        buildName: string;
+        projectId: string;
+        status: string;
+    }, token: string): Promise<{
+        status: number;
+        error?: string;
+    }>;
+    listPaginated(params: {
+        projectId?: string;
+        size: number;
+        offset: number;
+        status?: string;
+        browser?: string;
+        build?: string;
+        sortBy?: string;
+        sortDirection?: string;
+        maxAgeDays?: number;
+    }, token: string): Promise<{
+        status: number;
+        content: ESSessionDataRaw[];
+        totalElements: number;
+        error?: string;
+    }>;
+    deleteManualSession(sessionId: string, token: string): Promise<{
+        status: number;
+        error?: string;
+    }>;
+    startManualSession(body: Record<string, unknown>, token: string): Promise<{
+        status: number;
+        sessionId?: string;
+        error?: string;
+    }>;
+}
+export declare const sessionAdapter: SessionAdapter;

package/dist/adapters/session.adapter.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Adapter for SBOX session APIs. Calls session, video, manual, purge, builds/status.
+ * No business logic; only HTTP and response typing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionAdapter = void 0;
+const sbox_api_client_1 = require("./sbox-api.client");
+async function getByEkey(ekey, token) {
+    const path = `session/${encodeURIComponent(ekey)}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Session not found";
+        return { status, data: null, error: msg };
+    }
+    return { status, data: data };
+}
+async function getVideoUrl(sessionId, token) {
+    const { status, data } = await (0, sbox_api_client_1.get)(`video/${encodeURIComponent(sessionId)}`, token);
+    if (status === 200 && data && typeof data.url === "string") {
+        return { status, videoUrl: data.url };
+    }
+    if (status === 302 || status === 200) {
+        const loc = data?.location;
+        if (typeof loc === "string")
+            return { status, videoUrl: loc };
+    }
+    return { status, videoUrl: null };
+}
+/** POST /e34/api/test-data?sessionId=xxx&passed=true|false */
+async function updateSessionStatus(sessionId, passed, token) {
+    const path = `test-data?sessionId=${encodeURIComponent(sessionId)}&passed=${passed}`;
+    const { status, data } = await (0, sbox_api_client_1.post)(path, {}, token);
+    if (status >= 200 && status < 300)
+        return { status };
+    const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Update session status failed";
+    return { status, error: msg };
+}
+async function updateStatusByBuild(params, token) {
+    const { status, data } = await (0, sbox_api_client_1.put)("builds/status", params, token);
+    if (status >= 200 && status < 300)
+        return { status };
+    const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Update failed";
+    return { status, error: msg };
+}
+async function listPaginated(params, token) {
+    const q = new URLSearchParams();
+    if (params.projectId)
+        q.set("projectId", params.projectId);
+    q.set("size", String(params.size));
+    q.set("offset", String(params.offset));
+    if (params.status)
+        q.set("status", params.status);
+    if (params.browser)
+        q.set("browser", params.browser);
+    if (params.build)
+        q.set("build", params.build);
+    if (params.sortBy)
+        q.set("sortBy", params.sortBy);
+    if (params.sortDirection)
+        q.set("sortDirection", params.sortDirection);
+    const path = `v2/paginated/tests-data?${q.toString()}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "List failed";
+        return { status, content: [], totalElements: 0, error: msg };
+    }
+    const raw = data;
+    return { status, content: raw.content ?? [], totalElements: raw.totalElements ?? 0 };
+}
+/** DELETE /e34/api/test-data?sessionId=xxx — soft-delete session result (same as dashboard). */
+async function deleteManualSession(sessionId, token) {
+    const { status, data } = await (0, sbox_api_client_1.del)(`test-data?sessionId=${encodeURIComponent(sessionId)}`, token);
+    if (status >= 200 && status < 300)
+        return { status };
+    const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Delete failed";
+    return { status, error: msg };
+}
+async function startManualSession(body, token) {
+    const { data, status } = await (0, sbox_api_client_1.post)("manual", body, token);
+    if (status === 200 && typeof data === "string") {
+        return { status, sessionId: data };
+    }
+    const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Start manual session failed";
+    return { status, error: msg };
+}
+exports.sessionAdapter = {
+    getByEkey,
+    getVideoUrl,
+    updateSessionStatus,
+    updateStatusByBuild,
+    listPaginated,
+    deleteManualSession,
+    startManualSession,
+};

package/dist/adapters/stats.adapter.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Adapter for SBOX stats/count APIs. Supports time range as days or unit+value (hour/minute/day).
+ */
+import type { TimeRange } from "../utils/time-range";
+export interface ResultCountRaw {
+    result?: string;
+    count?: number;
+}
+export interface BrowserVersionCountRaw {
+    browser?: string;
+    version?: string;
+    count?: number;
+}
+export interface BuildCountRaw {
+    buildName?: string;
+    session_count?: number;
+}
+export interface CountByProjectRaw {
+    project?: string;
+    count?: number;
+}
+export interface CountByUserRaw {
+    user?: string;
+    count?: number;
+}
+export interface CountByTestNameRaw {
+    testName?: string;
+    count?: number;
+}
+export interface StatsAdapter {
+    getTotalTests(token: string, days: number): Promise<{
+        status: number;
+        total: number;
+        error?: string;
+    }>;
+    getCountByStatus(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: ResultCountRaw[];
+        error?: string;
+    }>;
+    getSessionsPerBrowser(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: BrowserVersionCountRaw[];
+        error?: string;
+    }>;
+    getSessionsByBuild(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: BuildCountRaw[];
+        error?: string;
+    }>;
+    getCountPerProject(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: CountByProjectRaw[];
+        error?: string;
+    }>;
+    getCountPerUser(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: CountByUserRaw[];
+        error?: string;
+    }>;
+    getCountPerTestName(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: CountByTestNameRaw[];
+        error?: string;
+    }>;
+    getManualCountPerTestName(token: string, timeRange: TimeRange): Promise<{
+        status: number;
+        items: CountByTestNameRaw[];
+        error?: string;
+    }>;
+}
+export declare const statsAdapter: StatsAdapter;

package/dist/adapters/stats.adapter.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Adapter for SBOX stats/count APIs. Supports time range as days or unit+value (hour/minute/day).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statsAdapter = void 0;
+const sbox_api_client_1 = require("./sbox-api.client");
+const time_range_1 = require("../utils/time-range");
+async function getTotalTests(token, days) {
+    const d = Math.max(1, Math.min(365, days));
+    const path = `tests/count?days=${d}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get total tests count";
+        return { status, total: 0, error: msg };
+    }
+    const total = typeof data.totalTestsLast15Days === "number"
+        ? data.totalTestsLast15Days
+        : 0;
+    return { status, total };
+}
+async function getCountByStatus(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `tests/count-by-status?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get count by status";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+async function getSessionsPerBrowser(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `tests/count-by-browser-and-version?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get sessions per browser";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+async function getSessionsByBuild(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `sessions/count/builds?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get sessions by build";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+async function getCountPerProject(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `tests/count-per-project?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get count per project";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+async function getCountPerUser(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `tests/count-per-user?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get count per user";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+async function getCountPerTestName(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `tests/count-per-test-name?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get count per test name";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+async function getManualCountPerTestName(token, timeRange) {
+    const q = (0, time_range_1.buildTimeQuery)(timeRange);
+    const path = `tests/manual/count-per-test-name?${q}`;
+    const { data, status } = await (0, sbox_api_client_1.get)(path, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Failed to get manual test count per test name";
+        return { status, items: [], error: msg };
+    }
+    const list = Array.isArray(data) ? data : [];
+    return { status, items: list };
+}
+exports.statsAdapter = {
+    getTotalTests,
+    getCountByStatus,
+    getSessionsPerBrowser,
+    getSessionsByBuild,
+    getCountPerProject,
+    getCountPerUser,
+    getCountPerTestName,
+    getManualCountPerTestName,
+};

package/dist/adapters/upload.adapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Adapter for SBOX file upload (mobile apps APK/IPA). Calls POST /e34/api/app (multipart).
+ * No business logic; only HTTP and response typing.
+ */
+export interface UploadAppResponseRaw {
+    success?: boolean;
+    uploadedAppIdentifier?: string;
+}
+export interface UploadAdapter {
+    uploadMobileApp(projectId: string, fileBuffer: Buffer, filename: string, token: string): Promise<{
+        status: number;
+        uploadedAppIdentifier?: string;
+        error?: string;
+    }>;
+}
+export declare const uploadAdapter: UploadAdapter;

package/dist/adapters/upload.adapter.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Adapter for SBOX file upload (mobile apps APK/IPA). Calls POST /e34/api/app (multipart).
+ * No business logic; only HTTP and response typing.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadAdapter = void 0;
+const form_data_1 = __importDefault(require("form-data"));
+const sbox_api_client_1 = require("./sbox-api.client");
+async function uploadMobileApp(projectId, fileBuffer, filename, token) {
+    const form = new form_data_1.default();
+    form.append("file", fileBuffer, { filename });
+    const path = `app?projectId=${encodeURIComponent(projectId)}`;
+    const { data, status } = await (0, sbox_api_client_1.postMultipart)(path, form, token);
+    if (status !== 200) {
+        const msg = (0, sbox_api_client_1.isSboxError)(data) ? data.message : "Upload failed";
+        return { status, error: msg };
+    }
+    const raw = data;
+    return { status, uploadedAppIdentifier: raw.uploadedAppIdentifier };
+}
+exports.uploadAdapter = { uploadMobileApp };

package/dist/adapters/user.adapter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Adapter for SBOX user APIs. Calls /users and uses session data for active counts.
+ * No business logic; only HTTP and response typing.
+ */
+export interface PrincipalRaw {
+    userId?: string;
+    fullname?: string;
+    realm?: {
+        id?: string;
+    };
+    extras?: Record<string, string>;
+}
+export interface UserAdapter {
+    searchUsers(params: {
+        realmId: string;
+        filter?: string;
+        size?: number;
+    }, token: string): Promise<{
+        status: number;
+        users: PrincipalRaw[];
+        error?: string;
+    }>;
+}
+export declare const userAdapter: UserAdapter;