@copado/agentia-cli 0.29.0-alpha.0 → 0.31.0-alpha.0

package/dist/lib/testing-flags.js

@@ -0,0 +1,70 @@
+import { Flags } from '@oclif/core';
+export const testingConnectionFlags = {
+    domain: Flags.string({
+        description: 'CRT domain hostname. Defaults to COPADO_ROBOTIC_DOMAIN, CRT_DOMAIN, or stored auth config.',
+    }),
+    org: Flags.integer({
+        description: 'CRT organization ID. Defaults to COPADO_ROBOTIC_ORG_ID, CRT_ORG, or stored auth config.',
+    }),
+    pat: Flags.string({
+        description: 'CRT PAT token override. Prefer auth set --crt or COPADO_ROBOTIC_API_KEY for regular use.',
+    }),
+};
+export const testingProjectFlag = {
+    project: Flags.integer({
+        char: 'p',
+        description: 'CRT project ID.',
+        required: true,
+    }),
+};
+export const testingJobFlag = {
+    job: Flags.integer({
+        char: 'j',
+        description: 'CRT job/test ID.',
+        required: true,
+    }),
+};
+export const testingBranchFlag = {
+    branch: Flags.string({
+        description: 'Optional CRT branch name for file operations.',
+    }),
+};
+export const testingOutputFlags = {
+    output: Flags.string({
+        char: 'o',
+        description: 'Write raw output to this file path.',
+    }),
+};
+export const testingFileInputFlags = {
+    dir: Flags.string({
+        description: 'Directory containing Robot Framework files to upload. Can be provided multiple times.',
+        multiple: true,
+    }),
+    file: Flags.string({
+        char: 'f',
+        description: 'Robot Framework file to upload. Can be provided multiple times.',
+        multiple: true,
+    }),
+};
+export const testingUploadOperationFlags = {
+    add: Flags.string({
+        description: 'Add a file using local[:remote] syntax. Can be provided multiple times.',
+        multiple: true,
+    }),
+    remove: Flags.string({
+        description: 'Remove a remote CRT file path. Can be provided multiple times.',
+        multiple: true,
+    }),
+    replace: Flags.string({
+        description: 'Replace a file using local[:remote] syntax. Can be provided multiple times.',
+        multiple: true,
+    }),
+};
+export function testingConnectionOptions(flags) {
+    return {
+        domain: flags.domain,
+        org: flags.org,
+        pat: flags.pat,
+    };
+}
+//# sourceMappingURL=testing-flags.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testing-flags.js","sourceRoot":"","sources":["../../src/lib/testing-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAA;AAIjC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,4FAA4F;KAC1G,CAAC;IACF,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;QACjB,WAAW,EAAE,yFAAyF;KACvG,CAAC;IACF,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;QAChB,WAAW,EAAE,0FAA0F;KACxG,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;QACrB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;QACjB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,+CAA+C;KAC7D,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,qCAAqC;KACnD,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;QAChB,WAAW,EAAE,uFAAuF;QACpG,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,GAAG;QACT,WAAW,EAAE,iEAAiE;QAC9E,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;QAChB,WAAW,EAAE,yEAAyE;QACtF,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,gEAAgE;QAC7E,QAAQ,EAAE,IAAI;KACf,CAAC;IACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,6EAA6E;QAC1F,QAAQ,EAAE,IAAI;KACf,CAAC;CACH,CAAA;AAQD,MAAM,UAAU,wBAAwB,CAAC,KAAkC;IACzE,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,33 @@
+import { URL } from 'node:url';
+import { type TestingConnectionOverrides } from './testing-config.js';
+export declare const TESTING_DEFAULT_TIMEOUT_MS = 45000;
+export type TestingRequest = {
+    body?: unknown;
+    endpoint: string;
+    method: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT';
+    responseType?: 'json' | 'text';
+    service: 'pace' | 'platform';
+};
+export type TestingHttpRequestFn = (url: URL, method: string, headers: Record<string, string>, body: unknown, timeoutMs: number) => Promise<string>;
+export type TestingGatewayCallOptions = TestingConnectionOverrides & {
+    timeoutMs?: number;
+};
+export declare class TestingGatewayError extends Error {
+    readonly requestMethod?: string;
+    readonly requestUrl?: string;
+    readonly retryAfterSeconds?: number;
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        request?: {
+            method?: string;
+            url?: string;
+        };
+        retryAfterSeconds?: number;
+        statusCode?: number;
+    });
+}
+export declare class TestingGateway {
+    static call<T = unknown>(request: TestingRequest, options?: TestingGatewayCallOptions): Promise<T>;
+}
+export declare function setTestingHttpRequestForTests(requestFn: TestingHttpRequestFn): void;
+export declare function resetTestingHttpRequestForTests(): void;

package/dist/lib/testing-gateway.js

@@ -0,0 +1,161 @@
+import * as http from 'node:http';
+import * as https from 'node:https';
+import { createRequire } from 'node:module';
+import { URL } from 'node:url';
+import { createTransactionId, getGatewayTransactionId } from './cicd-gateway.js';
+import { paceBaseUrl, platformBaseUrl, resolveTestingCredentials, } from './testing-config.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../../package.json');
+export const TESTING_DEFAULT_TIMEOUT_MS = 45_000;
+export class TestingGatewayError extends Error {
+    requestMethod;
+    requestUrl;
+    retryAfterSeconds;
+    statusCode;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'TestingGatewayError';
+        this.requestMethod = options.request?.method;
+        this.requestUrl = options.request?.url;
+        this.retryAfterSeconds = options.retryAfterSeconds;
+        this.statusCode = options.statusCode;
+    }
+}
+function userAgent() {
+    return `agentia-cli/${packageJson.version}`;
+}
+function transactionIdForRequest() {
+    return getGatewayTransactionId() ?? createTransactionId();
+}
+function parseRetryAfterHeader(value) {
+    if (value === undefined)
+        return undefined;
+    const raw = Array.isArray(value) ? value[0] : value;
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw === 'number')
+        return Number.isFinite(raw) && raw >= 0 ? Math.ceil(raw) : undefined;
+    const trimmed = raw.trim();
+    if (/^\d+$/u.test(trimmed))
+        return Number.parseInt(trimmed, 10);
+    const dateMs = Date.parse(trimmed);
+    return Number.isNaN(dateMs) ? undefined : Math.max(0, Math.ceil((dateMs - Date.now()) / 1000));
+}
+function extractErrorMessage(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        for (const value of [parsed.message, parsed.error, parsed.title]) {
+            if (typeof value === 'string' && value.trim().length > 0)
+                return value.trim();
+        }
+    }
+    catch {
+        return raw.trim().length > 0 ? raw.trim() : undefined;
+    }
+    return undefined;
+}
+function defaultHttpsRequest(url, method, headers, body, timeoutMs) {
+    const hasBody = body !== undefined;
+    const payload = hasBody ? JSON.stringify(body) : '';
+    const requestHeaders = {
+        Accept: 'application/json',
+        ...headers,
+    };
+    if (hasBody) {
+        requestHeaders['Content-Type'] = requestHeaders['Content-Type'] ?? 'application/json';
+        requestHeaders['Content-Length'] = Buffer.byteLength(payload).toString();
+    }
+    const transport = url.protocol === 'http:' ? http : https;
+    return new Promise((resolve, reject) => {
+        const req = transport.request({
+            headers: requestHeaders,
+            hostname: url.hostname,
+            method,
+            path: `${url.pathname}${url.search}`,
+            port: url.port.length > 0 ? Number(url.port) : undefined,
+            timeout: timeoutMs,
+        }, (res) => {
+            const chunks = [];
+            res.on('data', (chunk) => chunks.push(chunk));
+            res.on('end', () => {
+                const raw = Buffer.concat(chunks).toString('utf8');
+                const status = res.statusCode ?? 0;
+                if (status >= 400) {
+                    const message = extractErrorMessage(raw) ?? `CRT request failed (${status}).`;
+                    reject(new TestingGatewayError(message, {
+                        retryAfterSeconds: status === 429 ? parseRetryAfterHeader(res.headers['retry-after']) : undefined,
+                        statusCode: status,
+                    }));
+                    return;
+                }
+                resolve(raw);
+            });
+        });
+        req.on('error', (error) => reject(error));
+        req.on('timeout', () => {
+            req.destroy(new Error(`CRT request timed out after ${Math.ceil(timeoutMs / 1000)} seconds.`));
+        });
+        if (hasBody)
+            req.write(payload);
+        req.end();
+    });
+}
+let httpRequestFn = defaultHttpsRequest;
+function requestUrl(request, domain) {
+    const baseUrl = request.service === 'platform' ? platformBaseUrl(domain) : paceBaseUrl(domain);
+    return new URL(request.endpoint, `${baseUrl}/`);
+}
+function withRequestSuffix(message, request) {
+    const suffix = request.url === undefined ? '' : ` Request: ${request.method ?? ''} ${request.url}`.trimEnd();
+    if (suffix.length === 0)
+        return message;
+    return message.endsWith('.') ? `${message} ${suffix}` : `${message}. ${suffix}`;
+}
+async function executeTestingRequest(request, options = {}) {
+    const credentials = resolveTestingCredentials(options);
+    const url = requestUrl(request, credentials.domain);
+    const requestInfo = { method: request.method, url: url.toString() };
+    const headers = {
+        'User-Agent': userAgent(),
+        'X-Authorization': credentials.pat,
+        'x-transaction-id': transactionIdForRequest(),
+    };
+    let raw;
+    try {
+        raw = await httpRequestFn(url, request.method, headers, request.body, options.timeoutMs ?? TESTING_DEFAULT_TIMEOUT_MS);
+    }
+    catch (error) {
+        if (error instanceof TestingGatewayError) {
+            throw new TestingGatewayError(withRequestSuffix(error.message, requestInfo), {
+                request: requestInfo,
+                retryAfterSeconds: error.retryAfterSeconds,
+                statusCode: error.statusCode,
+            });
+        }
+        throw error;
+    }
+    if (raw.trim().length === 0)
+        return undefined;
+    if (request.responseType === 'text')
+        return raw;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new TestingGatewayError(withRequestSuffix(`CRT API returned non-JSON response: ${raw}`, requestInfo), {
+            request: requestInfo,
+        });
+    }
+}
+export class TestingGateway {
+    static async call(request, options = {}) {
+        return executeTestingRequest(request, options);
+    }
+}
+export function setTestingHttpRequestForTests(requestFn) {
+    httpRequestFn = requestFn;
+}
+export function resetTestingHttpRequestForTests() {
+    httpRequestFn = defaultHttpsRequest;
+}
+//# sourceMappingURL=testing-gateway.js.map

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

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

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

@@ -0,0 +1,99 @@
+import { type TestingGatewayCallOptions } from './testing-gateway.js';
+import { type TestingAuthor, type TestingBuild, type TestingBuildRunResult, type TestingBuildStatus, type TestingCreateVariableRequest, type TestingDownloadResult, type TestingFileEntry, type TestingFileOperation, type TestingJob, type TestingJobCreateResult, type TestingLogResult, type TestingProject, type TestingRecord, type TestingRobot, type TestingVariable } from './testing-types.js';
+export declare const DEFAULT_TESTING_AUTHOR: TestingAuthor;
+export type TestingFileCollectionInput = {
+    dirs?: string[];
+    files?: string[];
+};
+export type TestingConnectionOptions = TestingGatewayCallOptions;
+export type TestingCreateJobOptions = TestingConnectionOptions & {
+    description?: string;
+    fileInput?: TestingFileCollectionInput;
+    name: string;
+    projectId: number;
+    robotId: number | string;
+};
+export type TestingUploadOptions = TestingConnectionOptions & {
+    author?: TestingAuthor;
+    branch?: string;
+    jobId: number;
+    operations: TestingFileOperation[];
+    projectId: number;
+};
+export type TestingDownloadOptions = TestingConnectionOptions & {
+    branch?: string;
+    files: string[];
+    jobId: number;
+    outputDir?: string;
+    projectId: number;
+};
+export declare function listTestingProjects(options?: TestingConnectionOptions & {
+    name?: string;
+}): Promise<TestingProject[]>;
+export declare function createTestingProject(options: TestingConnectionOptions & {
+    description?: string;
+    name: string;
+}): Promise<TestingProject>;
+export declare function listTestingRobots(options: TestingConnectionOptions & {
+    projectId: number;
+}): Promise<TestingRobot[]>;
+export declare function createTestingRobot(options: TestingConnectionOptions & {
+    description?: string;
+    fwVersion?: string;
+    kind?: 'cloud' | 'QConnect';
+    name: string;
+    os?: string;
+    projectId: number;
+    robotType?: string;
+}): Promise<TestingRobot>;
+export declare function listTestingJobs(options: TestingConnectionOptions & {
+    name?: string;
+    projectId: number;
+}): Promise<TestingJob[]>;
+export declare function createTestingJob(options: TestingCreateJobOptions): Promise<TestingJobCreateResult>;
+export declare function listTestingJobFiles(options: TestingConnectionOptions & {
+    jobId: number;
+    projectId: number;
+}): Promise<TestingFileEntry[]>;
+export declare function uploadTestingJobFiles(options: TestingUploadOptions): Promise<{
+    operations: TestingFileOperation[];
+    response: TestingRecord;
+}>;
+export declare function downloadTestingJobFiles(options: TestingDownloadOptions): Promise<TestingDownloadResult>;
+export declare function runTestingBuild(options: TestingConnectionOptions & {
+    jobId: number;
+    projectId: number;
+}): Promise<TestingBuildRunResult>;
+export declare function listTestingBuilds(options: TestingConnectionOptions & {
+    jobId?: number;
+    projectId: number;
+    resultSize?: 'compact';
+    status?: TestingBuildStatus;
+}): Promise<TestingBuild[]>;
+export declare function getTestingBuildLogs(options: TestingConnectionOptions & {
+    buildId: number;
+    jobId: number;
+    output?: string;
+    projectId: number;
+}): Promise<TestingLogResult>;
+export declare function listTestingVariables(options: TestingConnectionOptions & {
+    jobId?: number;
+    projectId: number;
+    robotId?: number;
+}): Promise<TestingVariable[]>;
+export declare function createTestingVariable(options: TestingConnectionOptions & TestingCreateVariableRequest & {
+    projectId: number;
+}): Promise<unknown>;
+export declare function deleteTestingVariable(options: TestingConnectionOptions & {
+    projectId: number;
+    variableId: string;
+}): Promise<{
+    projectId: number;
+    variableId: string;
+}>;
+export declare function buildFileAddOperations(input: TestingFileCollectionInput): TestingFileOperation[];
+export declare function buildFileOperationsFromSpecs(specs: {
+    add?: string[];
+    remove?: string[];
+    replace?: string[];
+}): TestingFileOperation[];

package/dist/lib/testing-operations.js

@@ -0,0 +1,268 @@
+/* eslint-disable unicorn/text-encoding-identifier-case -- CRT file operation payloads require the literal utf-8 enum. */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { resolveTestingCredentials } from './testing-config.js';
+import { TestingGateway } from './testing-gateway.js';
+import { createDefaultRobotSnapshotBase64, normalizeDownloadedFiles, normalizeTestingArray, normalizeTestingId, normalizeTestingRecord, redactTestingVariables, testingBuildLogsEndpoint, testingJobBuildsEndpoint, testingJobFilesDownloadEndpoint, testingJobFilesEndpoint, testingJobFilesUploadEndpoint, testingJobsEndpoint, testingProjectBuildsEndpoint, testingProjectsEndpoint, testingRobotJobsEndpoint, testingRobotsEndpoint, testingVariableEndpoint, testingVariablesEndpoint, } from './testing-types.js';
+export const DEFAULT_TESTING_AUTHOR = {
+    email: 'agentia@copado.com',
+    name: 'Agentia CLI',
+};
+export async function listTestingProjects(options = {}) {
+    const credentials = resolveOptions(options);
+    const response = await TestingGateway.call({ endpoint: testingProjectsEndpoint(credentials.orgId), method: 'GET', service: 'platform' }, options);
+    const projects = normalizeTestingArray(response);
+    return filterByName(projects, options.name, false);
+}
+export async function createTestingProject(options) {
+    const credentials = resolveOptions(options);
+    const body = {
+        description: options.description ?? '',
+        name: options.name,
+        projectType: 'ta',
+    };
+    const response = await TestingGateway.call({ body, endpoint: testingProjectsEndpoint(credentials.orgId), method: 'POST', service: 'platform' }, options);
+    return normalizeTestingRecord(response);
+}
+export async function listTestingRobots(options) {
+    const response = await TestingGateway.call({ endpoint: testingRobotsEndpoint(options.projectId), method: 'GET', service: 'pace' }, options);
+    return normalizeTestingArray(response);
+}
+export async function createTestingRobot(options) {
+    const body = {
+        description: options.description ?? '',
+        fwVersion: options.fwVersion ?? 'stable',
+        name: options.name,
+        os: options.os ?? 'linux',
+        robotType: options.robotType ?? 'default',
+        runEnvironment: options.kind === 'QConnect' ? 'paceconnect' : 'cloud',
+    };
+    const response = await TestingGateway.call({ body, endpoint: testingRobotsEndpoint(options.projectId), method: 'POST', service: 'pace' }, options);
+    return normalizeTestingRecord(response);
+}
+export async function listTestingJobs(options) {
+    const response = await TestingGateway.call({ endpoint: testingJobsEndpoint(options.projectId), method: 'GET', service: 'pace' }, options);
+    const jobs = normalizeTestingArray(response);
+    return filterByName(jobs, options.name, true);
+}
+export async function createTestingJob(options) {
+    const body = {
+        description: options.description ?? '',
+        name: options.name,
+        storage: {
+            contentsBase64: createDefaultRobotSnapshotBase64(),
+            kind: 'snapshot',
+        },
+    };
+    const response = await TestingGateway.call({ body, endpoint: testingRobotJobsEndpoint(options.projectId, options.robotId), method: 'POST', service: 'pace' }, options);
+    const job = normalizeTestingRecord(response);
+    const jobId = normalizeTestingId(response);
+    const result = {
+        filesUploaded: 0,
+        job,
+        jobId,
+        projectId: options.projectId,
+    };
+    if (jobId !== undefined && options.fileInput !== undefined) {
+        const operations = buildFileAddOperations(options.fileInput);
+        if (operations.length > 0) {
+            const upload = await uploadTestingJobFiles({
+                ...options,
+                jobId: numericId(jobId, 'job'),
+                operations: [{ op: 'remove', path: 'tests.robot' }, ...operations],
+                projectId: options.projectId,
+            });
+            result.filesUploaded = upload.operations.length - 1;
+        }
+    }
+    return result;
+}
+export async function listTestingJobFiles(options) {
+    const response = await TestingGateway.call({ endpoint: testingJobFilesEndpoint(options.projectId, options.jobId), method: 'GET', service: 'pace' }, options);
+    return normalizeDownloadedFiles(response);
+}
+export async function uploadTestingJobFiles(options) {
+    const body = {
+        author: options.author ?? DEFAULT_TESTING_AUTHOR,
+        operations: options.operations,
+    };
+    const response = await TestingGateway.call({
+        body,
+        endpoint: testingJobFilesUploadEndpoint(options.projectId, options.jobId, options.branch),
+        method: 'POST',
+        service: 'pace',
+    }, options);
+    return { operations: options.operations, response: normalizeTestingRecord(response) };
+}
+export async function downloadTestingJobFiles(options) {
+    const response = await TestingGateway.call({
+        body: { files: options.files },
+        endpoint: testingJobFilesDownloadEndpoint(options.projectId, options.jobId, options.branch),
+        method: 'POST',
+        service: 'pace',
+    }, options);
+    const files = normalizeDownloadedFiles(response);
+    if (options.outputDir !== undefined) {
+        writeDownloadedFiles(options.outputDir, files);
+    }
+    return {
+        files,
+        jobId: options.jobId,
+        outputDir: options.outputDir,
+        projectId: options.projectId,
+        response,
+    };
+}
+export async function runTestingBuild(options) {
+    const build = await TestingGateway.call({ body: {}, endpoint: testingJobBuildsEndpoint(options.projectId, options.jobId), method: 'POST', service: 'pace' }, options);
+    return { build, jobId: options.jobId, projectId: options.projectId };
+}
+export async function listTestingBuilds(options) {
+    const endpoint = options.jobId === undefined
+        ? testingProjectBuildsEndpoint(options.projectId, { resultSize: options.resultSize, status: options.status })
+        : testingJobBuildsEndpoint(options.projectId, options.jobId, { resultSize: options.resultSize, status: options.status });
+    const response = await TestingGateway.call({ endpoint, method: 'GET', service: 'pace' }, options);
+    return normalizeTestingArray(response);
+}
+export async function getTestingBuildLogs(options) {
+    const log = await TestingGateway.call({
+        endpoint: testingBuildLogsEndpoint(options.projectId, options.jobId, options.buildId),
+        method: 'GET',
+        responseType: 'text',
+        service: 'pace',
+    }, options);
+    if (options.output !== undefined) {
+        mkdirSync(dirname(resolve(options.output)), { recursive: true });
+        writeFileSync(options.output, log, 'utf8');
+    }
+    return {
+        buildId: options.buildId,
+        jobId: options.jobId,
+        log,
+        output: options.output,
+        projectId: options.projectId,
+    };
+}
+export async function listTestingVariables(options) {
+    const response = await TestingGateway.call({ endpoint: testingVariablesEndpoint(options.projectId), method: 'GET', service: 'pace' }, options);
+    const variables = normalizeTestingArray(response)
+        .filter((variable) => options.jobId === undefined || variable.jobId?.toString() === options.jobId.toString())
+        .filter((variable) => options.robotId === undefined || variable.robotId?.toString() === options.robotId.toString());
+    return redactTestingVariables(variables);
+}
+export async function createTestingVariable(options) {
+    const body = [omitUndefined({
+            description: options.description,
+            jobId: options.jobId,
+            key: options.key,
+            robotId: options.robotId,
+            sensitive: options.sensitive,
+            type: options.type,
+            userSpecific: options.userSpecific,
+            value: options.value,
+        })];
+    const response = await TestingGateway.call({ body, endpoint: testingVariablesEndpoint(options.projectId), method: 'POST', service: 'pace' }, options);
+    return redactTestingVariables(response);
+}
+export async function deleteTestingVariable(options) {
+    await TestingGateway.call({ endpoint: testingVariableEndpoint(options.projectId, options.variableId), method: 'DELETE', service: 'pace' }, options);
+    return { projectId: options.projectId, variableId: options.variableId };
+}
+export function buildFileAddOperations(input) {
+    const operations = [];
+    for (const file of input.files ?? []) {
+        operations.push(fileOperationFromLocalFile(file, basenameForPath(file), 'add'));
+    }
+    for (const dir of input.dirs ?? []) {
+        const root = resolve(dir);
+        for (const file of collectFiles(root)) {
+            operations.push(fileOperationFromLocalFile(file, relative(root, file).split(sep).join('/'), 'add'));
+        }
+    }
+    return operations;
+}
+export function buildFileOperationsFromSpecs(specs) {
+    return [
+        ...(specs.add ?? []).map((spec) => fileOperationFromSpec(spec, 'add')),
+        ...(specs.replace ?? []).map((spec) => fileOperationFromSpec(spec, 'replace')),
+        ...(specs.remove ?? []).map((path) => ({ op: 'remove', path: normalizeRemotePath(path) })),
+    ];
+}
+function fileOperationFromSpec(spec, op) {
+    const separator = spec.indexOf(':');
+    const localPath = separator === -1 ? spec : spec.slice(0, separator);
+    const remotePath = separator === -1 ? basenameForPath(localPath) : spec.slice(separator + 1);
+    return fileOperationFromLocalFile(localPath, remotePath, op);
+}
+function fileOperationFromLocalFile(localPath, remotePath, op) {
+    const path = normalizeRemotePath(remotePath);
+    return {
+        encoding: 'utf-8',
+        op,
+        path,
+        value: readFileSync(localPath, 'utf8'),
+    };
+}
+function collectFiles(root) {
+    if (!existsSync(root))
+        throw new Error(`Directory does not exist: ${root}`);
+    const entries = readdirSync(root).sort();
+    const files = [];
+    for (const entry of entries) {
+        const path = join(root, entry);
+        const stat = statSync(path);
+        if (stat.isDirectory())
+            files.push(...collectFiles(path));
+        else if (stat.isFile())
+            files.push(path);
+    }
+    return files;
+}
+function normalizeRemotePath(path) {
+    const normalized = path.trim().replaceAll('\\', '/').replace(/^\/+/u, '');
+    if (normalized.length === 0 || normalized.includes('..')) {
+        throw new Error(`Invalid CRT file path: ${path}`);
+    }
+    return normalized;
+}
+function writeDownloadedFiles(outputDir, files) {
+    const root = resolve(outputDir);
+    mkdirSync(root, { recursive: true });
+    for (const file of files) {
+        const remotePath = normalizeRemotePath(file.path ?? '');
+        const target = resolve(root, remotePath);
+        if (!target.startsWith(`${root}${sep}`) && target !== root) {
+            throw new Error(`Refusing to write CRT file outside output directory: ${remotePath}`);
+        }
+        mkdirSync(dirname(target), { recursive: true });
+        const value = file.value ?? '';
+        const contents = file.encoding === 'base64' ? Buffer.from(value, 'base64') : Buffer.from(value, 'utf8');
+        writeFileSync(target, contents);
+    }
+}
+function basenameForPath(path) {
+    const segments = path.replaceAll('\\', '/').split('/').filter(Boolean);
+    return segments.at(-1) ?? path;
+}
+function filterByName(records, name, insensitive) {
+    if (name === undefined || name.trim().length === 0)
+        return records;
+    const expected = insensitive ? name.toLowerCase() : name;
+    return records.filter((record) => {
+        const actual = record.name ?? '';
+        return insensitive ? actual.toLowerCase() === expected : actual === expected;
+    });
+}
+function numericId(value, label) {
+    const parsed = typeof value === 'number' ? value : Number.parseInt(value, 10);
+    if (!Number.isSafeInteger(parsed))
+        throw new Error(`CRT ${label} ID must be numeric: ${value}`);
+    return parsed;
+}
+function omitUndefined(record) {
+    return Object.fromEntries(Object.entries(record).filter(([, value]) => value !== undefined));
+}
+function resolveOptions(options) {
+    return { orgId: resolveTestingCredentials(options).orgId };
+}
+//# sourceMappingURL=testing-operations.js.map