@copado/agentia-cli 0.112.0-alpha.0 → 0.113.0-alpha.0

package/dist/lib/testing-secret-input.js

@@ -0,0 +1,56 @@
+import { createReadStream, lstatSync, realpathSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+export const TESTING_SECRET_INPUT_MAX_BYTES = 1024 * 1024;
+export async function resolveTestingSecretInput(input, options) {
+    if (input.trim === true && input.noTrim === true) {
+        throw new Error('Use either --trim or --no-trim, not both.');
+    }
+    const sourceCount = [input.value !== undefined, input.valueFile !== undefined, input.valueStdin === true].filter(Boolean).length;
+    if (sourceCount > 1) {
+        throw new Error('Use exactly one of --value, --value-file, or --value-stdin.');
+    }
+    if (sourceCount === 0) {
+        if (options.required)
+            throw new Error(`Provide --value, --value-file, or --value-stdin for ${options.label}.`);
+        return undefined;
+    }
+    const raw = input.value ??
+        (input.valueFile === undefined
+            ? await readBoundedStream(process.stdin, options.label)
+            : await readBoundedSecretFile(input.valueFile, options.label));
+    const value = input.noTrim === true ? raw : raw.trim();
+    if (Buffer.byteLength(value) > TESTING_SECRET_INPUT_MAX_BYTES) {
+        throw new Error(`${options.label} exceeds the ${TESTING_SECRET_INPUT_MAX_BYTES} byte safety limit.`);
+    }
+    return value;
+}
+async function readBoundedSecretFile(path, label) {
+    if (path.trim().length === 0 || path.includes('\0'))
+        throw new Error(`${label} file path is invalid.`);
+    const target = resolve(path);
+    const linkStat = lstatSync(target);
+    if (linkStat.isSymbolicLink())
+        throw new Error(`${label} file must not be a symbolic link.`);
+    const canonical = realpathSync(target);
+    const stat = statSync(canonical);
+    if (!stat.isFile())
+        throw new Error(`${label} file must be a regular file.`);
+    if (stat.size > TESTING_SECRET_INPUT_MAX_BYTES) {
+        throw new Error(`${label} exceeds the ${TESTING_SECRET_INPUT_MAX_BYTES} byte safety limit.`);
+    }
+    return readBoundedStream(createReadStream(canonical), label);
+}
+async function readBoundedStream(stream, label) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of stream) {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += bytes.length;
+        if (size > TESTING_SECRET_INPUT_MAX_BYTES) {
+            throw new Error(`${label} exceeds the ${TESTING_SECRET_INPUT_MAX_BYTES} byte safety limit.`);
+        }
+        chunks.push(bytes);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+//# sourceMappingURL=testing-secret-input.js.map

package/dist/lib/testing-secret-input.js.map

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

package/dist/lib/testing-session.d.ts

@@ -0,0 +1,8 @@
+import { type TestingGatewayCallOptions, type TestingRequest } from './testing-gateway.js';
+export type TestingSession = {
+    readonly cookie: string;
+    readonly xsrfToken?: string;
+};
+export declare function exchangeTestingSession(options?: TestingGatewayCallOptions): Promise<TestingSession>;
+export declare function parseTestingSession(response: unknown): TestingSession;
+export declare function testingSessionAuth(session: TestingSession): NonNullable<TestingRequest['auth']>;

package/dist/lib/testing-session.js

@@ -0,0 +1,82 @@
+import { TestingGateway } from './testing-gateway.js';
+export async function exchangeTestingSession(options = {}) {
+    const response = await TestingGateway.call({
+        endpoint: '/user/access-keys/tokens?toSign=all',
+        method: 'GET',
+        service: 'pace',
+    }, options);
+    return parseTestingSession(response);
+}
+export function parseTestingSession(response) {
+    const record = asRecord(response);
+    const fl = stringValue(record.FL, record.fl);
+    const sessionsToken = stringValue(record.sessionsToken, record.sessionToken);
+    const xsrf = parseXsrf(record.XSRF ?? record.xsrf);
+    if (fl === undefined || sessionsToken === undefined || xsrf.jwt === undefined) {
+        throw new Error('CRT session exchange returned incomplete credentials. Sign in to CRT again.');
+    }
+    assertHeaderPart(fl, 'FL');
+    assertHeaderPart(xsrf.jwt, 'XSRF');
+    assertHeaderPart(sessionsToken, 'sessions token');
+    if (xsrf.token !== undefined)
+        assertHeaderValue(xsrf.token, 'XSRF token');
+    return {
+        cookie: `FL=${fl}; XSRF-TOKEN=${xsrf.jwt}; sessionsToken=${sessionsToken}`,
+        xsrfToken: xsrf.token,
+    };
+}
+export function testingSessionAuth(session) {
+    return {
+        cookie: session.cookie,
+        mode: 'session',
+        xsrfToken: session.xsrfToken,
+    };
+}
+function parseXsrf(value) {
+    if (typeof value === 'string') {
+        return { jwt: nonBlank(value), token: extractXsrfTokenClaim(value) };
+    }
+    const record = asRecord(value);
+    const jwt = stringValue(record.jwt, record.JWT, record.value, record.cookie);
+    const token = stringValue(record.token, record.xsrfToken, record['X-XSRF-TOKEN']) ?? extractXsrfTokenClaim(jwt);
+    return { jwt, token };
+}
+function extractXsrfTokenClaim(jwt) {
+    if (jwt === undefined)
+        return undefined;
+    const encoded = jwt.split('.')[1];
+    if (encoded === undefined)
+        return undefined;
+    try {
+        const payload = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
+        return nonBlank(asRecord(payload).token);
+    }
+    catch {
+        return undefined;
+    }
+}
+function stringValue(...values) {
+    for (const value of values) {
+        const normalized = nonBlank(value);
+        if (normalized !== undefined)
+            return normalized;
+    }
+    return undefined;
+}
+function nonBlank(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function asRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function assertHeaderPart(value, label) {
+    assertHeaderValue(value, label);
+    if (value.includes(';'))
+        throw new Error(`CRT ${label} contains an invalid cookie delimiter.`);
+}
+function assertHeaderValue(value, label) {
+    if ([...value].some((character) => character.codePointAt(0) <= 31 || character.codePointAt(0) === 127)) {
+        throw new Error(`CRT ${label} contains invalid header characters.`);
+    }
+}
+//# sourceMappingURL=testing-session.js.map

package/dist/lib/testing-session.js.map

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

package/dist/lib/testing-types.d.ts

@@ -2,14 +2,28 @@ export declare const TESTING_BUILD_STATUSES: readonly ["aborted", "executing", "
 export declare const TESTING_JOB_PARALLEL_MODES: readonly ["disabled", "enabled"];
 export declare const TESTING_JOB_SUITE_TYPES: readonly ["bitbar", "browserstack", "browserstackdesktop", "default", "lambdatest", "lambdatestdesktop", "mobile", "paceconnectmobile", "privatemobile", "rpa", "selenese", "zap"];
 export declare const TESTING_RECORD_BUILD_OPTIONS: readonly ["all", "failed", "none"];
+export declare const TESTING_RUN_TYPES: readonly ["regression", "development"];
+export declare const TESTING_CONSOLE_COLORS: readonly ["auto", "on", "ansi", "off"];
 export declare const TESTING_VARIABLE_TYPES: readonly ["clp", "config", "dataset", "secret"];
 export declare const TESTING_FILE_OPERATIONS: readonly ["add", "replace", "remove"];
+export declare const TESTING_PROJECT_TYPES: readonly ["ta", "rpa"];
+export declare const TESTING_PROJECT_EXECUTORS: readonly ["jenkins", "kubernetes"];
+export declare const TESTING_ROBOT_RUN_ENVIRONMENTS: readonly ["cloud", "paceconnect", "QConnect"];
+export declare const TESTING_ROBOT_TYPES: readonly ["bitbar", "browserstack", "browserstackdesktop", "default", "lambdatest", "lambdatestdesktop", "mobile", "pabot", "paceconnectmobile", "privatemobile"];
+export declare const TESTING_ROBOT_REPORTING: readonly ["all", "nothing"];
 export type TestingBuildStatus = (typeof TESTING_BUILD_STATUSES)[number];
 export type TestingJobParallelMode = (typeof TESTING_JOB_PARALLEL_MODES)[number];
 export type TestingJobSuiteType = (typeof TESTING_JOB_SUITE_TYPES)[number];
 export type TestingRecordBuildOption = (typeof TESTING_RECORD_BUILD_OPTIONS)[number];
+export type TestingRunType = (typeof TESTING_RUN_TYPES)[number];
+export type TestingConsoleColors = (typeof TESTING_CONSOLE_COLORS)[number];
 export type TestingVariableType = (typeof TESTING_VARIABLE_TYPES)[number];
 export type TestingFileOperationName = (typeof TESTING_FILE_OPERATIONS)[number];
+export type TestingProjectType = (typeof TESTING_PROJECT_TYPES)[number];
+export type TestingProjectExecutor = (typeof TESTING_PROJECT_EXECUTORS)[number];
+export type TestingRobotRunEnvironment = (typeof TESTING_ROBOT_RUN_ENVIRONMENTS)[number];
+export type TestingRobotType = (typeof TESTING_ROBOT_TYPES)[number];
+export type TestingRobotReporting = (typeof TESTING_ROBOT_REPORTING)[number];
 export type TestingRecord = Record<string, unknown>;
 export type TestingProject = TestingRecord & {
     id?: number | string;
@@ -41,6 +55,21 @@ export type TestingVariable = TestingRecord & {
     sensitive?: boolean;
     value?: string;
 };
+export type TestingUserParameter = TestingRecord & {
+    id?: number | string;
+    key?: string;
+    sensitive?: boolean;
+    type?: string;
+    userId?: number;
+    value?: string;
+};
+export type TestingPermission = TestingRecord & {
+    edit?: boolean;
+    groupId?: number;
+    id?: number;
+    userId?: number;
+    view?: boolean;
+};
 export type TestingFileEntry = TestingRecord & {
     encoding?: 'base64' | 'utf-8' | string;
     path?: string;
@@ -62,26 +91,63 @@ export type TestingBranchOrTag = {
 };
 export type TestingFileUploadRequest = {
     author: TestingAuthor;
+    commitMessage?: string;
     operations: TestingFileOperation[];
+    parentCommitHash?: string;
 };
 export type TestingCreateProjectRequest = {
+    dashboardId?: number;
     description?: string;
     name: string;
-    projectType: 'ta';
+    projectExecutor?: TestingProjectExecutor;
+    projectType: TestingProjectType;
+};
+export type TestingProjectUpdateRequest = {
+    description?: string;
+    name?: string;
+};
+export type TestingPermissionRequest = {
+    edit?: boolean;
+    groupId?: number;
+    userId?: number;
+    view?: boolean;
 };
 export type TestingCreateRobotRequest = {
     description: string;
-    fwVersion: string;
+    fwVersion?: string;
+    label?: string;
     name: string;
-    os: string;
-    robotType: string;
+    os?: string;
+    reporting?: TestingRobotReporting;
+    robotType?: TestingRobotType;
     runEnvironment: 'cloud' | 'paceconnect';
 };
+export type TestingRobotUpdateRequest = {
+    description?: string;
+    fwVersion?: string;
+    label?: string;
+    name?: string;
+    reporting?: TestingRobotReporting;
+    robotType?: TestingRobotType;
+};
 export type TestingCreateJobRequest = {
+    analytics?: {
+        caseDurationChangeDetection?: boolean;
+    };
     description?: string;
     domainCredentialId?: string;
     name: string;
+    parallelExecution?: TestingJobParallelMode;
+    screen?: {
+        depth: number;
+        height: number;
+        width: number;
+    };
+    showVideoParams?: boolean;
     storage: TestingStorageRequest;
+    suiteType?: TestingJobSuiteType;
+    timeout?: string;
+    validation?: boolean;
 };
 export type TestingGitStorageRequest = {
     branchOrTag: TestingBranchOrTag;
@@ -109,6 +175,19 @@ export type TestingCreateVariableRequest = {
     userSpecific?: boolean;
     value?: string;
 };
+export type TestingCreateUserParameterRequest = {
+    description?: string;
+    key: string;
+    keyIsUnique?: boolean;
+    sensitive?: boolean;
+    type?: 'parameter';
+    value: string;
+};
+export type TestingUserParameterUpdateRequest = {
+    description?: string;
+    key?: string;
+    value?: string;
+};
 export type TestingInputParameter = {
     key: string;
     sensitive?: boolean;
@@ -121,8 +200,46 @@ export type TestingBuildRunRequest = {
     record?: TestingRecordBuildOption;
     rerunFailedFromLatest?: boolean;
     rerunFailedId?: number;
+    runType?: 'development' | 'normal';
     tag?: string;
 };
+export type TestingSchedule = TestingRecord & {
+    record?: TestingRecordBuildOption;
+    schedule: string;
+    timezone?: string;
+};
+export type TestingBuildListOptions = {
+    page?: number;
+    pageSize?: number;
+    resultSize?: 'compact';
+    status?: TestingBuildStatus;
+};
+export type TestingBuildLogOptions = {
+    container?: string;
+    limitBytes?: number;
+    pretty?: boolean;
+    sinceSeconds?: number;
+    tailLines?: number;
+    timestamps?: boolean;
+};
+export type TestingBuildSearchOptions = {
+    count?: boolean;
+    from?: string;
+    jobId: number;
+    order?: 'asc' | 'desc';
+    page?: number;
+    pageSize?: number;
+    projectId: number;
+    robots?: string[];
+    runTypes?: TestingRunType[];
+    sort?: 'date' | 'duration' | 'id' | 'status';
+    statuses?: string[];
+    to?: string;
+};
+export type TestingBuildSearchResult = {
+    count: number;
+    runs: TestingBuild[];
+};
 export type TestingJobUpdateRequest = {
     analytics?: {
         caseDurationChangeDetection?: boolean;
@@ -150,14 +267,18 @@ export type TestingVariableUpdateRequest = {
     value?: string;
 };
 export type TestingJobCreateResult = {
+    dryRun?: true;
     filesUploaded: number;
     job: TestingRecord;
     jobId?: number | string;
     projectId: number;
 };
 export type TestingBuildRunResult = {
-    body: TestingBuildRunRequest;
+    body: Array<TestingBuildRunRequest & {
+        jobId: number;
+    }> | TestingBuildRunRequest;
     build: unknown;
+    dataDriven?: boolean;
     jobId: number;
     projectId: number;
 };
@@ -167,6 +288,7 @@ export type TestingLogResult = {
     log: string;
     output?: string;
     projectId: number;
+    status?: string;
 };
 export type TestingDownloadResult = {
     files: TestingFileEntry[];
@@ -176,29 +298,37 @@ export type TestingDownloadResult = {
     response: unknown;
 };
 export declare function testingProjectsEndpoint(orgId: number): string;
+export declare function testingProjectEndpoint(projectId: number | string): string;
+export declare function testingProjectPermissionsEndpoint(projectId: number | string): string;
+export declare function testingPermissionsEndpoint(projectId: number | string): string;
+export declare function testingPermissionEndpoint(permissionId: number): string;
 export declare function testingRobotsEndpoint(projectId: number): string;
 export declare function testingRobotEndpoint(projectId: number, robotId: number | string): string;
 export declare function testingJobsEndpoint(projectId: number): string;
 export declare function testingJobEndpoint(projectId: number, jobId: number): string;
+export declare function testingJobScheduleEndpoint(projectId: number, jobId: number): string;
 export declare function testingRobotJobsEndpoint(projectId: number, robotId: number | string): string;
 export declare function testingJobFilesEndpoint(projectId: number, jobId: number): string;
+export declare function testingJobRefsEndpoint(projectId: number, jobId: number, sharedCredentials?: boolean): string;
 export declare function testingJobFilesUploadEndpoint(projectId: number, jobId: number, branch?: string): string;
 export declare function testingJobFilesDownloadEndpoint(projectId: number, jobId: number, branch?: string): string;
-export declare function testingJobBuildsEndpoint(projectId: number, jobId: number, options?: {
-    resultSize?: 'compact';
-    status?: TestingBuildStatus;
-}): string;
-export declare function testingProjectBuildsEndpoint(projectId: number, options?: {
-    resultSize?: 'compact';
-    status?: TestingBuildStatus;
+export declare function testingJobBuildsEndpoint(projectId: number, jobId: number, options?: TestingBuildListOptions): string;
+export declare function testingProjectBuildsEndpoint(projectId: number, options?: TestingBuildListOptions): string;
+export declare function testingBuildEndpoint(projectId: number, jobId: number, buildId: number | string, options?: {
+    full?: boolean;
 }): string;
-export declare function testingBuildLogsEndpoint(projectId: number, jobId: number, buildId: number): string;
+export declare function testingBuildLogsEndpoint(projectId: number, jobId: number, buildId: number, options?: TestingBuildLogOptions): string;
 export declare function testingBuildAbortEndpoint(projectId: number, jobId: number, buildId: number): string;
 export declare function testingProjectDeleteEndpoint(projectId: number): string;
 export declare function testingVariablesEndpoint(projectId: number): string;
+export declare function testingMetricsSearchEndpoint(orgId: number): string;
 export declare function testingVariableEndpoint(projectId: number, variableId: string): string;
+export declare function testingUserParametersEndpoint(): string;
+export declare function testingUserParameterEndpoint(parameterId: number | string): string;
+export declare function appendTestingQuery(endpoint: string, values: Record<string, boolean | number | string | undefined>): string;
 export declare function normalizeTestingArray<T extends TestingRecord = TestingRecord>(response: unknown): T[];
 export declare function normalizeTestingRecord<T extends TestingRecord = TestingRecord>(response: unknown): T;
+export declare function normalizeTestingEnvelopeRecord<T extends TestingRecord = TestingRecord>(response: unknown): T;
 export declare function normalizeTestingId(response: unknown): number | string | undefined;
 export declare function normalizeDownloadedFiles(response: unknown): TestingFileEntry[];
 export declare function listSnapshotZipEntries(snapshot: Buffer): TestingFileEntry[];

package/dist/lib/testing-types.js

@@ -17,11 +17,41 @@ export const TESTING_JOB_SUITE_TYPES = [
     'zap',
 ];
 export const TESTING_RECORD_BUILD_OPTIONS = ['all', 'failed', 'none'];
+export const TESTING_RUN_TYPES = ['regression', 'development'];
+export const TESTING_CONSOLE_COLORS = ['auto', 'on', 'ansi', 'off'];
 export const TESTING_VARIABLE_TYPES = ['clp', 'config', 'dataset', 'secret'];
 export const TESTING_FILE_OPERATIONS = ['add', 'replace', 'remove'];
+export const TESTING_PROJECT_TYPES = ['ta', 'rpa'];
+export const TESTING_PROJECT_EXECUTORS = ['jenkins', 'kubernetes'];
+export const TESTING_ROBOT_RUN_ENVIRONMENTS = ['cloud', 'paceconnect', 'QConnect'];
+export const TESTING_ROBOT_TYPES = [
+    'bitbar',
+    'browserstack',
+    'browserstackdesktop',
+    'default',
+    'lambdatest',
+    'lambdatestdesktop',
+    'mobile',
+    'pabot',
+    'paceconnectmobile',
+    'privatemobile',
+];
+export const TESTING_ROBOT_REPORTING = ['all', 'nothing'];
 export function testingProjectsEndpoint(orgId) {
     return `/organizations/${orgId}/projects`;
 }
+export function testingProjectEndpoint(projectId) {
+    return `/projects/${projectId}`;
+}
+export function testingProjectPermissionsEndpoint(projectId) {
+    return `/projects/${projectId}/permissions`;
+}
+export function testingPermissionsEndpoint(projectId) {
+    return `/permissions/projects/${projectId}`;
+}
+export function testingPermissionEndpoint(permissionId) {
+    return `/permissions/${permissionId}`;
+}
 export function testingRobotsEndpoint(projectId) {
     return `/pace/v4/projects/${projectId}/robots`;
 }
@@ -34,12 +64,19 @@ export function testingJobsEndpoint(projectId) {
 export function testingJobEndpoint(projectId, jobId) {
     return `/pace/v4/projects/${projectId}/jobs/${jobId}`;
 }
+export function testingJobScheduleEndpoint(projectId, jobId) {
+    return `/pace/v4/projects/${projectId}/jobs/${jobId}/schedule`;
+}
 export function testingRobotJobsEndpoint(projectId, robotId) {
     return `/pace/v4/projects/${projectId}/robots/${robotId}/jobs`;
 }
 export function testingJobFilesEndpoint(projectId, jobId) {
     return `/pace/v4/projects/${projectId}/jobs/${jobId}/files`;
 }
+export function testingJobRefsEndpoint(projectId, jobId, sharedCredentials) {
+    const endpoint = `/pace/v4/projects/${projectId}/jobs/${jobId}/refs`;
+    return appendBooleanQuery(endpoint, 'sharedCredentials', sharedCredentials);
+}
 export function testingJobFilesUploadEndpoint(projectId, jobId, branch) {
     const endpoint = `/pace/v4/projects/${projectId}/jobs/${jobId}/files/upload`;
     return appendOptionalBranch(endpoint, branch);
@@ -54,29 +91,73 @@ export function testingJobBuildsEndpoint(projectId, jobId, options = {}) {
 export function testingProjectBuildsEndpoint(projectId, options = {}) {
     return appendBuildQuery(`/pace/v4/projects/${projectId}/builds`, options);
 }
-export function testingBuildLogsEndpoint(projectId, jobId, buildId) {
-    return `/pace/v4/projects/${projectId}/jobs/${jobId}/builds/${buildId}/logs`;
+export function testingBuildEndpoint(projectId, jobId, buildId, options = {}) {
+    const endpoint = `/pace/v4/projects/${projectId}/jobs/${jobId}/builds/${buildId}`;
+    return options.full === true ? endpoint : `${endpoint}?resultSize=compact`;
+}
+export function testingBuildLogsEndpoint(projectId, jobId, buildId, options = {}) {
+    const endpoint = `/pace/v4/projects/${projectId}/jobs/${jobId}/builds/${buildId}/logs`;
+    const params = new URLSearchParams();
+    if (options.container !== undefined)
+        params.set('container', options.container);
+    if (options.tailLines !== undefined)
+        params.set('tailLines', options.tailLines.toString());
+    if (options.sinceSeconds !== undefined)
+        params.set('sinceSeconds', options.sinceSeconds.toString());
+    if (options.limitBytes !== undefined)
+        params.set('limitBytes', options.limitBytes.toString());
+    if (options.timestamps !== undefined)
+        params.set('timestamps', options.timestamps.toString());
+    if (options.pretty !== undefined)
+        params.set('pretty', options.pretty.toString());
+    const query = params.toString();
+    return query.length > 0 ? `${endpoint}?${query}` : endpoint;
 }
 export function testingBuildAbortEndpoint(projectId, jobId, buildId) {
     return `/pace/v4/projects/${projectId}/jobs/${jobId}/builds/${buildId}/abort`;
 }
 export function testingProjectDeleteEndpoint(projectId) {
-    return `/pace/v3/projects/${projectId}`;
+    return testingProjectEndpoint(projectId);
 }
 export function testingVariablesEndpoint(projectId) {
     return `/pace/v3/projects/${projectId}/secrets`;
 }
+export function testingMetricsSearchEndpoint(orgId) {
+    return `/organizations/${orgId}/search/_msearch`;
+}
 export function testingVariableEndpoint(projectId, variableId) {
     return `/pace/v3/projects/${projectId}/secrets/${variableId}`;
 }
+export function testingUserParametersEndpoint() {
+    return '/pace/v4/user-parameters';
+}
+export function testingUserParameterEndpoint(parameterId) {
+    return `/pace/v4/user-parameters/${parameterId}`;
+}
+export function appendTestingQuery(endpoint, values) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(values)) {
+        if (value !== undefined)
+            params.set(key, value.toString());
+    }
+    const query = params.toString();
+    return query.length > 0 ? `${endpoint}?${query}` : endpoint;
+}
 function appendOptionalBranch(endpoint, branch) {
     if (branch === undefined || branch.trim().length === 0)
         return endpoint;
     const params = new URLSearchParams({ branches: branch });
     return `${endpoint}?${params.toString()}`;
 }
+function appendBooleanQuery(endpoint, key, value) {
+    return value === undefined ? endpoint : `${endpoint}?${new URLSearchParams({ [key]: value.toString() }).toString()}`;
+}
 function appendBuildQuery(endpoint, options = {}) {
     const params = new URLSearchParams();
+    if (options.page !== undefined)
+        params.set('page', options.page.toString());
+    if (options.pageSize !== undefined)
+        params.set('pageSize', options.pageSize.toString());
     if (options.resultSize !== undefined)
         params.set('resultSize', options.resultSize);
     if (options.status !== undefined)
@@ -101,7 +182,19 @@ export function normalizeTestingArray(response) {
     if (Array.isArray(normalized))
         return normalized;
     if (isRecord(normalized)) {
-        for (const key of ['items', 'records', 'results', 'files', 'builds', 'jobs', 'robots', 'projects', 'secrets']) {
+        for (const key of [
+            'items',
+            'records',
+            'results',
+            'files',
+            'builds',
+            'jobs',
+            'robots',
+            'projects',
+            'secrets',
+            'permissions',
+            'userParameters',
+        ]) {
             const candidate = normalized[key];
             if (Array.isArray(candidate))
                 return candidate;
@@ -113,6 +206,18 @@ export function normalizeTestingRecord(response) {
     const normalized = nestedData(response);
     return isRecord(normalized) ? normalized : {};
 }
+export function normalizeTestingEnvelopeRecord(response) {
+    if (!isRecord(response))
+        return {};
+    const domainKeys = ['id', 'buildId', 'jobId', 'outputArchive', 'status'];
+    if (domainKeys.some((key) => key in response))
+        return response;
+    if (isRecord(response.data))
+        return response.data;
+    if (isRecord(response.result))
+        return response.result;
+    return response;
+}
 export function normalizeTestingId(response) {
     const record = normalizeTestingRecord(response);
     const { id } = record;
@@ -142,7 +247,7 @@ export function redactTestingVariables(value) {
         return value;
     const redacted = {};
     for (const [key, entry] of Object.entries(value)) {
-        redacted[key] = key === 'value' ? '<masked>' : redactTestingVariables(entry);
+        redacted[key] = key === 'value' ? '[REDACTED]' : redactTestingVariables(entry);
     }
     return redacted;
 }