@devicecloud.dev/dcd 5.0.0-beta.0 → 5.0.0-beta.2

package/dist/services/execution-plan.utils.js

@@ -1,14 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.processDependencies = exports.checkIfFilesExistInWorkspace = exports.readTestYamlFileAsJson = exports.readYamlFileAsJson = void 0;
-exports.getFlowsToRunInSequence = getFlowsToRunInSequence;
-exports.isFlowFile = isFlowFile;
-exports.readDirectory = readDirectory;
-const yaml = require("js-yaml");
-const fs = require("node:fs");
-const path = require("node:path");
+import * as yaml from 'js-yaml';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 const commandsThatRequireFiles = new Set(['addMedia', 'runFlow', 'runScript']);
-function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
+export function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
     if (flowOrder.length === 0) {
         if (debug) {
             console.log('[DEBUG] getFlowsToRunInSequence: flowOrder is empty, returning []');
@@ -33,7 +27,7 @@ function getFlowsToRunInSequence(paths, flowOrder, debug = false) {
     }
     return namesInOrder.map((name) => paths[name]);
 }
-function isFlowFile(filePath) {
+export function isFlowFile(filePath) {
     // Exclude files inside .app bundles
     // Check if any directory in the path ends with .app
     const pathParts = filePath.split(path.sep);
@@ -44,7 +38,7 @@ function isFlowFile(filePath) {
     }
     return filePath.endsWith('.yaml') || filePath.endsWith('.yml');
 }
-const readYamlFileAsJson = (filePath) => {
+export const readYamlFileAsJson = (filePath) => {
     try {
         const normalizedPath = path.normalize(filePath);
         const yamlText = fs.readFileSync(normalizedPath, 'utf8');
@@ -61,11 +55,12 @@ const readYamlFileAsJson = (filePath) => {
         return result;
     }
     catch (error) {
-        throw new Error(`Error parsing YAML file ${filePath}: ${error}`);
+        throw new Error(`Error parsing YAML file ${filePath}: ${error}`, {
+            cause: error,
+        });
     }
 };
-exports.readYamlFileAsJson = readYamlFileAsJson;
-const readTestYamlFileAsJson = (filePath) => {
+export const readTestYamlFileAsJson = (filePath) => {
     try {
         const normalizedPath = path.normalize(filePath);
         const yamlText = fs.readFileSync(normalizedPath, 'utf8');
@@ -88,11 +83,10 @@ const readTestYamlFileAsJson = (filePath) => {
     catch (error) {
         const message = `Error parsing YAML file ${filePath}: ${error}`;
         console.error(message);
-        throw new Error(message);
+        throw new Error(message, { cause: error });
     }
 };
-exports.readTestYamlFileAsJson = readTestYamlFileAsJson;
-async function readDirectory(dir, filterFunction) {
+export async function readDirectory(dir, filterFunction) {
     const readDirResult = await fs.promises.readdir(dir);
     const files = await Promise.all(readDirResult.map(async (file) => {
         const filePath = path.join(dir, file);
@@ -108,7 +102,7 @@ async function readDirectory(dir, filterFunction) {
     }));
     return files.flat().filter(Boolean);
 }
-const checkIfFilesExistInWorkspace = (commandName, command, absoluteFilePath) => {
+export const checkIfFilesExistInWorkspace = (commandName, command, absoluteFilePath) => {
     const errors = [];
     const files = [];
     const directory = path.dirname(absoluteFilePath);
@@ -136,7 +130,6 @@ const checkIfFilesExistInWorkspace = (commandName, command, absoluteFilePath) =>
         processFilePath(x.file);
     return { errors, files };
 };
-exports.checkIfFilesExistInWorkspace = checkIfFilesExistInWorkspace;
 const checkFile = (filePath) => {
     if (!fs.existsSync(filePath))
         return `non-existent file`;
@@ -149,7 +142,7 @@ const checkStepsArray = (steps, absoluteFilePath) => {
             continue;
         for (const [commandName, commandValue] of Object.entries(command)) {
             if (commandsThatRequireFiles.has(commandName)) {
-                const { errors: newErrors, files: newFiles } = (0, exports.checkIfFilesExistInWorkspace)(commandName, commandValue, path.normalize(absoluteFilePath));
+                const { errors: newErrors, files: newFiles } = checkIfFilesExistInWorkspace(commandName, commandValue, path.normalize(absoluteFilePath));
                 errors = [...errors, ...newErrors];
                 files = [...files, ...newFiles];
             }
@@ -164,7 +157,7 @@ const checkStepsArray = (steps, absoluteFilePath) => {
     }
     return { errors, files };
 };
-const processDependencies = ({ config, input, testSteps, }) => {
+export const processDependencies = ({ config, input, testSteps, }) => {
     let allErrors = [];
     let allFiles = [];
     const { onFlowComplete, onFlowStart } = config ?? {};
@@ -186,4 +179,3 @@ const processDependencies = ({ config, input, testSteps, }) => {
     }
     return { allErrors, allFiles };
 };
-exports.processDependencies = processDependencies;

package/dist/services/flow-paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Longest whole-segment directory prefix shared by every flow + referenced
+ * file path. Segment comparison (not `startsWith`) so sibling dirs like
+ * `flows`/`flows-extra` can't merge, and the file segment itself is never
+ * consumed. Returns '' when the paths share no root at all (or none are given).
+ */
+export declare function computeCommonRoot(testFileNames: string[], referencedFiles: string[]): string;
+export interface FlowMetadataEntry {
+    flowName: string;
+    tags: string[];
+}
+/**
+ * Build the portable-relative-path → {flowName, tags} map that results are
+ * keyed by. Flow name comes from the YAML `name` field, falling back to the
+ * filename without extension; tags are normalized to a string array.
+ */
+export declare function buildTestMetadataMap(flowMetadata: Record<string, Record<string, unknown> | null>, commonRoot: string): Record<string, FlowMetadataEntry>;

package/dist/services/flow-paths.js

@@ -0,0 +1,52 @@
+/**
+ * Pure helpers for turning absolute flow paths into the server-side relative
+ * keys that submission, the polling layer, and JSON output all share.
+ *
+ * Extracted from the cloud command so the MCP `dcd_run_cloud_test` tool builds
+ * byte-identical paths without duplicating the logic.
+ */
+import * as path from 'node:path';
+import { toPortableRelativePath } from '../utils/paths.js';
+/**
+ * Longest whole-segment directory prefix shared by every flow + referenced
+ * file path. Segment comparison (not `startsWith`) so sibling dirs like
+ * `flows`/`flows-extra` can't merge, and the file segment itself is never
+ * consumed. Returns '' when the paths share no root at all (or none are given).
+ */
+export function computeCommonRoot(testFileNames, referencedFiles) {
+    const pathsShortestToLongest = [...testFileNames, ...referencedFiles].sort((a, b) => a.split(path.sep).length - b.split(path.sep).length);
+    if (pathsShortestToLongest.length === 0)
+        return '';
+    const splitPaths = pathsShortestToLongest.map((p) => p.split(path.sep));
+    const shortestSegments = splitPaths[0];
+    let matchedSegments = 0;
+    for (let i = 0; i < shortestSegments.length - 1; i++) {
+        if (splitPaths.every((segments) => segments[i] === shortestSegments[i])) {
+            matchedSegments = i + 1;
+        }
+        else {
+            break;
+        }
+    }
+    return shortestSegments.slice(0, matchedSegments).join(path.sep);
+}
+/**
+ * Build the portable-relative-path → {flowName, tags} map that results are
+ * keyed by. Flow name comes from the YAML `name` field, falling back to the
+ * filename without extension; tags are normalized to a string array.
+ */
+export function buildTestMetadataMap(flowMetadata, commonRoot) {
+    const map = {};
+    for (const [absolutePath, meta] of Object.entries(flowMetadata)) {
+        const normalizedPath = toPortableRelativePath(absolutePath, commonRoot);
+        const flowName = meta?.name || path.parse(absolutePath).name;
+        const rawTags = meta?.tags;
+        const tags = Array.isArray(rawTags)
+            ? rawTags.map(String)
+            : rawTags
+                ? [String(rawTags)]
+                : [];
+        map[normalizedPath] = { flowName, tags };
+    }
+    return map;
+}

package/dist/services/metadata-extractor.service.js

@@ -1,12 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetadataExtractorService = exports.ExpoTarGzMetadataExtractor = exports.IosZipMetadataExtractor = exports.IosAppMetadataExtractor = exports.AndroidMetadataExtractor = void 0;
-const bplist_parser_1 = require("bplist-parser");
-const node_apk_1 = require("node-apk");
-const promises_1 = require("node:fs/promises");
-const path = require("node:path");
-const StreamZip = require("node-stream-zip");
-const plist_1 = require("plist");
+import bplistParser from 'bplist-parser';
+import nodeApk from 'node-apk';
+import { readFile, rm } from 'node:fs/promises';
+import * as path from 'node:path';
+import StreamZip from 'node-stream-zip';
+import { parse } from 'plist';
+// node-apk and bplist-parser are CJS with no `exports` map; Node's named-export
+// detection for CJS (cjs-module-lexer) is version-dependent, so destructure off
+// the default import instead — that interop is guaranteed on every Node version.
+const { Apk } = nodeApk;
+const { parseBuffer } = bplistParser;
 /**
  * Parses an Info.plist buffer (XML, UTF-8 BOM'd XML, or binary bplist).
  * Shared by the .app and .zip extractors.
@@ -16,10 +18,10 @@ function parseInfoPlist(buffer) {
     const bufferType = buffer[0];
     // 60 = '<' (XML plist), 239 = UTF-8 BOM, 98 = 'b' (binary "bplist")
     if (bufferType === 60 || bufferType === 239) {
-        data = (0, plist_1.parse)(buffer.toString());
+        data = parse(buffer.toString());
     }
     else if (bufferType === 98) {
-        data = (0, bplist_parser_1.parseBuffer)(buffer)[0];
+        data = parseBuffer(buffer)[0];
     }
     else {
         throw new Error('Unknown plist buffer type.');
@@ -29,12 +31,12 @@ function parseInfoPlist(buffer) {
 /**
  * Extracts metadata from Android APK files
  */
-class AndroidMetadataExtractor {
+export class AndroidMetadataExtractor {
     canHandle(filePath) {
         return filePath.endsWith('.apk');
     }
     async extract(filePath) {
-        const apk = new node_apk_1.Apk(filePath);
+        const apk = new Apk(filePath);
         try {
             const manifest = await apk.getManifestInfo();
             return { appId: manifest.package, platform: 'android' };
@@ -44,27 +46,25 @@ class AndroidMetadataExtractor {
         }
     }
 }
-exports.AndroidMetadataExtractor = AndroidMetadataExtractor;
 /**
  * Extracts metadata from iOS .app directories
  */
-class IosAppMetadataExtractor {
+export class IosAppMetadataExtractor {
     canHandle(filePath) {
         return filePath.endsWith('.app');
     }
     async extract(filePath) {
         const infoPlistPath = path.normalize(path.join(filePath, 'Info.plist'));
-        const buffer = await (0, promises_1.readFile)(infoPlistPath);
+        const buffer = await readFile(infoPlistPath);
         const data = parseInfoPlist(buffer);
         const appId = data.CFBundleIdentifier;
         return { appId, platform: 'ios' };
     }
 }
-exports.IosAppMetadataExtractor = IosAppMetadataExtractor;
 /**
  * Extracts metadata from iOS .zip files containing .app bundles
  */
-class IosZipMetadataExtractor {
+export class IosZipMetadataExtractor {
     canHandle(filePath) {
         return filePath.endsWith('.zip');
     }
@@ -106,18 +106,17 @@ class IosZipMetadataExtractor {
         });
     }
 }
-exports.IosZipMetadataExtractor = IosZipMetadataExtractor;
 /**
  * Extracts metadata from Expo iOS .tar.gz archives by extracting the
  * archive to a temp directory, finding the .app bundle inside, then
  * delegating to IosAppMetadataExtractor.
  */
-class ExpoTarGzMetadataExtractor {
+export class ExpoTarGzMetadataExtractor {
     canHandle(filePath) {
         return filePath.endsWith('.tar.gz');
     }
     async extract(filePath) {
-        const { extractTarGz, findAppBundle } = await Promise.resolve().then(() => require('../utils/expo'));
+        const { extractTarGz, findAppBundle } = await import('../utils/expo.js');
         const extractDir = await extractTarGz(filePath, false);
         try {
             const appPath = await findAppBundle(extractDir);
@@ -125,15 +124,14 @@ class ExpoTarGzMetadataExtractor {
             return await iosExtractor.extract(appPath);
         }
         finally {
-            await (0, promises_1.rm)(extractDir, { recursive: true, force: true }).catch(() => { });
+            await rm(extractDir, { recursive: true, force: true }).catch(() => { });
         }
     }
 }
-exports.ExpoTarGzMetadataExtractor = ExpoTarGzMetadataExtractor;
 /**
  * Service for extracting app metadata from various file formats
  */
-class MetadataExtractorService {
+export class MetadataExtractorService {
     extractors = [
         new AndroidMetadataExtractor(),
         new ExpoTarGzMetadataExtractor(),
@@ -159,4 +157,3 @@ class MetadataExtractorService {
         }
     }
 }
-exports.MetadataExtractorService = MetadataExtractorService;

package/dist/services/moropo.service.js

@@ -1,17 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MoropoService = void 0;
-const progress_1 = require("../utils/progress");
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
-const node_stream_1 = require("node:stream");
-const promises_1 = require("node:stream/promises");
-const StreamZip = require("node-stream-zip");
+import { ux } from '../utils/progress.js';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import StreamZip from 'node-stream-zip';
 /**
  * Service for downloading and extracting Moropo tests from the Moropo API
  */
-class MoropoService {
+export class MoropoService {
     MOROPO_API_URL = 'https://api.moropo.com/tests';
     /**
      * Download and extract Moropo tests from the API
@@ -25,7 +22,7 @@ class MoropoService {
         let moropoDir;
         try {
             if (!quiet && !json) {
-                progress_1.ux.action.start('Downloading Moropo tests', 'Initializing', {
+                ux.action.start('Downloading Moropo tests', 'Initializing', {
                     stdout: true,
                 });
             }
@@ -52,7 +49,7 @@ class MoropoService {
             // Extract zip file
             await this.extractZipFile(zipPath, moropoDir);
             if (!quiet && !json) {
-                progress_1.ux.action.stop('completed');
+                ux.action.stop('completed');
             }
             this.logDebug(debug, logger, '[DEBUG] Successfully extracted Moropo tests');
             // Create config.yaml file
@@ -62,14 +59,16 @@ class MoropoService {
         }
         catch (error) {
             if (!quiet && !json) {
-                progress_1.ux.action.stop('failed');
+                ux.action.stop('failed');
             }
             // Remove the temp directory (and any partially-written zip inside it)
             if (moropoDir) {
                 fs.rmSync(moropoDir, { recursive: true, force: true });
             }
             this.logDebug(debug, logger, `[DEBUG] Error downloading/extracting Moropo tests: ${error}`);
-            throw new Error(`Failed to download/extract Moropo tests: ${error}`);
+            throw new Error(`Failed to download/extract Moropo tests: ${error}`, {
+                cause: error,
+            });
         }
     }
     createConfigFile(moropoDir) {
@@ -84,19 +83,19 @@ class MoropoService {
         if (!response.body) {
             throw new Error('Failed to get response reader');
         }
-        const source = node_stream_1.Readable.fromWeb(response.body);
+        const source = Readable.fromWeb(response.body);
         if (!quiet && !json && totalSize) {
             // Progress tap — pipeline below still owns the flow/backpressure
             source.on('data', (chunk) => {
                 downloadedSize += chunk.length;
                 const progress = Math.round((downloadedSize / totalSize) * 100);
-                progress_1.ux.action.status = `Downloading: ${progress}%`;
+                ux.action.status = `Downloading: ${progress}%`;
             });
         }
         // pipeline (unlike a bare 'finish' wait) propagates errors from both
         // streams, so disk-full or a stalled download rejects instead of
         // crashing or hanging.
-        await (0, promises_1.pipeline)(source, fs.createWriteStream(zipPath));
+        await pipeline(source, fs.createWriteStream(zipPath));
     }
     async extractZipFile(zipPath, extractPath) {
         // eslint-disable-next-line new-cap
@@ -112,8 +111,7 @@ class MoropoService {
     }
     showProgress(quiet, json, message) {
         if (!quiet && !json) {
-            progress_1.ux.action.status = message;
+            ux.action.status = message;
         }
     }
 }
-exports.MoropoService = MoropoService;

package/dist/services/report-download.service.d.ts

@@ -1,4 +1,4 @@
-import type { AuthContext } from '../types/domain/auth.types';
+import type { AuthContext } from '../types/domain/auth.types.js';
 export interface DownloadOptions {
     auth: AuthContext;
     apiUrl: string;

package/dist/services/report-download.service.js

@@ -1,12 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReportDownloadService = void 0;
-const path = require("node:path");
-const api_gateway_1 = require("../gateways/api-gateway");
+import * as path from 'node:path';
+import { ApiGateway } from '../gateways/api-gateway.js';
 /**
  * Service for downloading test artifacts and reports
  */
-class ReportDownloadService {
+export class ReportDownloadService {
     /**
      * Download test artifacts as a zip file
      * @param options Download configuration
@@ -18,7 +15,7 @@ class ReportDownloadService {
             if (debug && logger) {
                 logger(`[DEBUG] Downloading artifacts: ${downloadType}`);
             }
-            await api_gateway_1.ApiGateway.downloadArtifactsZip(apiUrl, auth, uploadId, downloadType, artifactsPath);
+            await ApiGateway.downloadArtifactsZip(apiUrl, auth, uploadId, downloadType, artifactsPath);
             if (logger) {
                 logger('\n');
                 logger(`Test artifacts have been downloaded to ${artifactsPath}`);
@@ -84,7 +81,7 @@ class ReportDownloadService {
             if (debug && logger) {
                 logger(`[DEBUG] Downloading ${type.toUpperCase()} report`);
             }
-            await api_gateway_1.ApiGateway.downloadReportGeneric(apiUrl, auth, uploadId, type, filePath);
+            await ApiGateway.downloadReportGeneric(apiUrl, auth, uploadId, type, filePath);
             if (logger) {
                 logger(`${type.toUpperCase()} test report has been downloaded to ${filePath}`);
             }
@@ -122,4 +119,3 @@ class ReportDownloadService {
         }
     }
 }
-exports.ReportDownloadService = ReportDownloadService;

package/dist/services/results-polling.service.d.ts

@@ -1,4 +1,4 @@
-import type { AuthContext } from '../types/domain/auth.types';
+import type { AuthContext } from '../types/domain/auth.types.js';
 /**
  * Custom error for run failures that includes the polling result
  */
@@ -46,7 +46,9 @@ export interface PollingResult {
  */
 export declare class ResultsPollingService {
     private readonly MAX_SEQUENTIAL_FAILURES;
-    private readonly POLL_INTERVAL_MS;
+    private readonly BEARER_POLL_INTERVAL_MS;
+    private readonly APIKEY_POLL_INTERVAL_MS;
+    private readonly ERROR_BACKOFF_BASE_MS;
     private readonly MAX_ERROR_BACKOFF_MS;
     /**
      * Poll for test results until all tests complete
@@ -91,5 +93,18 @@ export declare class ResultsPollingService {
      * @returns Promise that resolves after the delay
      */
     private sleep;
-    private updateDisplayStatus;
+    /**
+     * Build the body of the live status display (the per-test table, or just the
+     * one-line summary in quiet mode). The footer (countdown + realtime state) is
+     * appended separately by {@link buildStatusFooter} so it can re-render on a
+     * timer without re-fetching.
+     */
+    private buildStatusBody;
+    /**
+     * Build the live footer shown under the status display: whether realtime
+     * updates are connected (for logged-in users) and how long until the next
+     * backstop poll. While a fetch is in flight (`nextPollAt` is null) the
+     * countdown reads "refreshing…". In quiet mode the countdown is omitted.
+     */
+    private buildStatusFooter;
 }