maestrostack 0.1.0

package/README.md

@@ -0,0 +1,205 @@
+# MaestroStack
+
+MaestroStack is a config-driven CLI for running [Maestro](https://maestro.mobile.dev/)
+mobile tests on [BrowserStack App Automate](https://www.browserstack.com/app-automate).
+
+It packages Maestro flow folders, uploads app and test artifacts, and starts
+BrowserStack Maestro builds across one or more real devices from a single command:
+
+```bash
+maestrostack run
+```
+
+Under the hood BrowserStack's Maestro workflow is several manual REST calls: upload
+the app, upload a zipped suite, copy the returned URLs, hand-build a JSON payload
+with the right devices and `execute` paths, and POST to the correct Android or iOS
+build endpoint. MaestroStack turns that into one repeatable command you can run
+locally or in CI.
+
+## Install
+
+```bash
+npm install -g maestrostack
+```
+
+Requires Node.js 18+. Works on macOS, Linux and Windows.
+
+## Quick start
+
+```bash
+# 1. Scaffold a config
+maestrostack init --android
+
+# 2. Provide BrowserStack credentials (see Authentication below)
+export BROWSERSTACK_USERNAME=...
+export BROWSERSTACK_ACCESS_KEY=...
+
+# 3. Check everything before touching the network
+maestrostack validate
+maestrostack run --dry-run
+
+# 4. Run on BrowserStack
+maestrostack run
+```
+
+## Project layout
+
+MaestroStack encourages this structure:
+
+```text
+mobile-tests/
+├── maestrostack.yml      # tool config (NOT a Maestro flow)
+├── smoke/
+│   ├── login.yml         # Maestro flow
+│   └── signup.yml
+├── regression/
+│   └── checkout.yml
+└── apps/
+    └── app-release.apk
+```
+
+> **Root-level YAML files are treated as config files, not Maestro flows.**
+> Keep your Maestro flows inside subfolders. This avoids confusing
+> `maestrostack.yml` (tool config) with `smoke/login.yml` (a test flow).
+
+## Configuration
+
+`maestrostack init` writes a starter `maestrostack.yml`. A full example:
+
+```yaml
+version: 1
+
+auth:
+  username: ${BROWSERSTACK_USERNAME}
+  accessKey: ${BROWSERSTACK_ACCESS_KEY}
+
+platform: android            # android | ios
+
+app:
+  source: upload             # upload | app_url
+  path: ./apps/app-release.apk
+  customId: SampleApp
+
+suite:
+  root: .
+  packageName: Flows.zip
+  customId: SampleTest
+  include:
+    - smoke/**/*.yml
+    - regression/**/*.yml
+  exclude:
+    - apps/**
+
+run:
+  project: Maestro_Test
+  devices:
+    - Samsung Galaxy S20-10.0
+    - Google Pixel 7-13.0
+  executeMode: explicit      # explicit | main
+  execute:
+    - smoke/login.yml
+    - smoke/signup.yml
+    - regression/checkout.yml
+  options:
+    networkLogs: true
+    deviceLogs: true
+```
+
+### App source
+
+| `app.source` | Required fields | Notes |
+|---|---|---|
+| `upload`  | `path` | Uploads a local `.apk` (Android) / `.ipa` (iOS). |
+| `app_url` | `appUrl` | Reuses an existing `bs://` app reference. |
+
+### Execute modes
+
+- **`explicit`** (recommended): list flow files in `run.execute`. MaestroStack
+  sends them as the BrowserStack `execute` array - no root `main.yaml` needed.
+- **`main`**: omit `run.execute` and provide a `main.yaml` at the suite root.
+  BrowserStack runs it as the entrypoint.
+
+### Authentication
+
+Credentials are read from environment variables referenced as `${VAR}` in the
+config. MaestroStack loads a `.env` file from the working directory if present:
+
+```env
+BROWSERSTACK_USERNAME=my_username
+BROWSERSTACK_ACCESS_KEY=my_access_key
+```
+
+If a referenced variable is missing, MaestroStack fails *before* any upload.
+Secrets are never printed.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `maestrostack init` | Create a starter config (`--android`, `--ios`, `--force`). |
+| `maestrostack validate` | Validate config, suite structure, app and devices. |
+| `maestrostack package` | Discover flows and build the suite zip (no upload). |
+| `maestrostack upload-app` | Upload only the app; print its `app_url`. |
+| `maestrostack upload-suite` | Package and upload only the suite; print its `test_suite_url`. |
+| `maestrostack run` | Package, upload and trigger a build. |
+
+### Global options
+
+- `-c, --config <path>` - use a specific config file (e.g. `maestrostack.staging.yml`).
+- `--debug` - verbose logging.
+
+### `run` options
+
+- `--dry-run` - validate, show the files that would be zipped and the exact
+  BrowserStack payload + endpoint, without making any API calls.
+- `--device <name>` - override `run.devices` (repeatable).
+- `--execute <path>` - override `run.execute` (repeatable; forces explicit mode).
+
+```bash
+maestrostack run -c maestrostack.android.smoke.yml
+maestrostack run --device "Google Pixel 7-13.0" --device "Samsung Galaxy S20-10.0"
+maestrostack run --execute smoke/login.yml --dry-run
+```
+
+## How it works
+
+`maestrostack run`:
+
+1. Loads `.env` and the config, substitutes `${VAR}` tokens, validates everything.
+2. Discovers flow files (ignoring root-level YAML, `node_modules`, `.git`).
+3. Zips the suite under a `Flows/` prefix preserving folder structure.
+4. Resolves the app (uploads the local binary or uses an existing `bs://` URL).
+5. Uploads the suite zip.
+6. POSTs the build to `.../maestro/v2/{android|ios}/build` and prints the build id.
+
+Example output:
+
+```text
+MaestroStack run started
+
+Project: Maestro_Test
+Platform: android
+Devices:
+- Samsung Galaxy S20-10.0
+- Google Pixel 7-13.0
+
+App: bs://...
+Test suite: bs://...
+Build ID: 5c5ab4338cec13aeb78f7a6977344556ac00bccd6
+```
+
+## Development
+
+```bash
+npm install
+npm run build       # bundle with tsup -> dist/cli.js
+npm run typecheck   # tsc --noEmit
+npm test            # vitest
+```
+
+The BrowserStack integration is covered by tests with mocked HTTP, so the full
+package to payload path runs without a live account.
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,801 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+
+// src/commands/init.ts
+import { writeFile } from "fs/promises";
+import path2 from "path";
+
+// src/utils/errors.ts
+var MaestroStackError = class extends Error {
+  /** Optional extra lines shown beneath the main message (e.g. hints). */
+  details;
+  constructor(message, details) {
+    super(message);
+    this.name = "MaestroStackError";
+    this.details = details;
+  }
+};
+function isMaestroStackError(err) {
+  return err instanceof MaestroStackError;
+}
+
+// src/utils/fs.ts
+import { constants } from "fs";
+import fs from "fs/promises";
+import path from "path";
+async function pathExists(p) {
+  try {
+    await fs.access(p, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function isFile(p) {
+  try {
+    const stat = await fs.stat(p);
+    return stat.isFile();
+  } catch {
+    return false;
+  }
+}
+async function isDirectory(p) {
+  try {
+    const stat = await fs.stat(p);
+    return stat.isDirectory();
+  } catch {
+    return false;
+  }
+}
+async function ensureDir(dir) {
+  await fs.mkdir(dir, { recursive: true });
+}
+function extname(p) {
+  return path.extname(p).toLowerCase();
+}
+
+// src/utils/logger.ts
+var debugEnabled = false;
+function setDebug(enabled) {
+  debugEnabled = enabled;
+}
+var logger = {
+  /** Primary user-facing output. */
+  info(message = "") {
+    console.log(message);
+  },
+  warn(message) {
+    console.warn(`warning: ${message}`);
+  },
+  error(message) {
+    console.error(message);
+  },
+  /** Only printed when --debug is set. Prefixed so it is visually distinct. */
+  debug(message) {
+    if (debugEnabled) {
+      console.error(`[debug] ${message}`);
+    }
+  }
+};
+
+// src/commands/init.ts
+var CONFIG_NAME = "maestrostack.yml";
+async function initCommand(opts) {
+  if (opts.android && opts.ios) {
+    throw new MaestroStackError("Pass only one of --android or --ios.");
+  }
+  const platform = opts.ios ? "ios" : "android";
+  const cwd = process.cwd();
+  const target = path2.join(cwd, CONFIG_NAME);
+  if (await pathExists(target) && !opts.force) {
+    throw new MaestroStackError(`${CONFIG_NAME} already exists.`, [
+      "Use --force to overwrite it."
+    ]);
+  }
+  await writeFile(target, template(platform), "utf8");
+  logger.info(`Created ${CONFIG_NAME} (platform: ${platform}).`);
+  logger.info("Next: set BROWSERSTACK_USERNAME / BROWSERSTACK_ACCESS_KEY, then run `maestrostack validate`.");
+}
+function template(platform) {
+  const appPath = platform === "ios" ? "./apps/app-release.ipa" : "./apps/app-release.apk";
+  const devices = platform === "ios" ? ["iPhone 15-17.0"] : ["Samsung Galaxy S20-10.0", "Google Pixel 7-13.0"];
+  const deviceLines = devices.map((d) => `    - ${d}`).join("\n");
+  return [
+    "version: 1",
+    "",
+    "auth:",
+    "  username: ${BROWSERSTACK_USERNAME}",
+    "  accessKey: ${BROWSERSTACK_ACCESS_KEY}",
+    "",
+    `platform: ${platform}`,
+    "",
+    "app:",
+    "  source: upload",
+    `  path: ${appPath}`,
+    "  customId: SampleApp",
+    "",
+    "suite:",
+    "  root: .",
+    "  packageName: Flows.zip",
+    "  customId: SampleTest",
+    "  include:",
+    "    - smoke/**/*.yml",
+    "    - regression/**/*.yml",
+    "  exclude:",
+    "    - apps/**",
+    "",
+    "run:",
+    "  project: Maestro_Test",
+    "  devices:",
+    deviceLines,
+    "  executeMode: explicit",
+    "  execute:",
+    "    - smoke/login.yml",
+    "  options:",
+    "    networkLogs: true",
+    "    deviceLogs: true",
+    ""
+  ].join("\n");
+}
+
+// src/commands/package.ts
+import path9 from "path";
+
+// src/config/loadConfig.ts
+import { readFile } from "fs/promises";
+import path3 from "path";
+import dotenv from "dotenv";
+import { parse as parseYaml } from "yaml";
+
+// src/config/resolveEnv.ts
+var ENV_TOKEN = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+function resolveEnv(raw, env = process.env) {
+  const missing = /* @__PURE__ */ new Set();
+  const resolved = raw.replace(ENV_TOKEN, (_match, name) => {
+    const value = env[name];
+    if (value === void 0 || value === "") {
+      missing.add(name);
+      return "";
+    }
+    return value;
+  });
+  if (missing.size > 0) {
+    const names = [...missing].sort();
+    throw new MaestroStackError(
+      `Missing required environment variable(s): ${names.join(", ")}`,
+      ["Set them in your shell or a .env file in the working directory."]
+    );
+  }
+  return resolved;
+}
+
+// src/config/schema.ts
+import { z } from "zod";
+var nonEmpty = (label) => z.string({ required_error: `${label} is required` }).trim().min(1, `${label} must not be empty`);
+var authSchema = z.object({
+  username: nonEmpty("BrowserStack username (auth.username)"),
+  accessKey: nonEmpty("BrowserStack access key (auth.accessKey)")
+});
+var appUploadSchema = z.object({
+  source: z.literal("upload"),
+  path: nonEmpty("app.path"),
+  customId: z.string().trim().min(1).optional()
+});
+var appUrlSchema = z.object({
+  source: z.literal("app_url"),
+  appUrl: nonEmpty("app.appUrl").refine((v) => v.startsWith("bs://"), {
+    message: "app.appUrl must start with bs://"
+  }),
+  customId: z.string().trim().min(1).optional()
+});
+var appCustomIdSchema = z.object({
+  // Present in the schema so configs validate, but resolution is deferred (see validate.ts).
+  source: z.literal("custom_id"),
+  customId: nonEmpty("app.customId")
+});
+var appSchema = z.discriminatedUnion("source", [
+  appUploadSchema,
+  appUrlSchema,
+  appCustomIdSchema
+]);
+var suiteSchema = z.object({
+  root: z.string().trim().min(1).default("."),
+  packageName: z.string().trim().min(1).default("Flows.zip"),
+  customId: z.string().trim().min(1).optional(),
+  include: z.array(nonEmpty("suite.include entry")).default(["**/*.yml", "**/*.yaml"]),
+  exclude: z.array(z.string()).default([])
+});
+var optionsSchema = z.object({
+  networkLogs: z.boolean().optional(),
+  deviceLogs: z.boolean().optional()
+}).default({});
+var runSchema = z.object({
+  project: nonEmpty("run.project"),
+  devices: z.array(nonEmpty("device")).min(1, "run.devices must contain at least one device"),
+  executeMode: z.enum(["explicit", "main"]).default("explicit"),
+  execute: z.array(nonEmpty("run.execute entry")).optional(),
+  options: optionsSchema
+});
+var configSchema = z.object({
+  version: z.literal(1, {
+    errorMap: () => ({ message: "Unsupported config version. Expected version: 1" })
+  }),
+  auth: authSchema,
+  platform: z.enum(["android", "ios"], {
+    errorMap: () => ({ message: "Unsupported platform. Expected android or ios" })
+  }),
+  app: appSchema,
+  suite: suiteSchema.default({}),
+  run: runSchema
+});
+
+// src/config/loadConfig.ts
+var DEFAULT_CONFIG_NAMES = ["maestrostack.yml", "maestrostack.yaml"];
+async function resolveConfigPath(explicit, cwd = process.cwd()) {
+  if (explicit) {
+    const resolved = path3.resolve(cwd, explicit);
+    if (!await isFile(resolved)) {
+      throw new MaestroStackError(`Config file not found: ${explicit}`);
+    }
+    return resolved;
+  }
+  for (const name of DEFAULT_CONFIG_NAMES) {
+    const candidate = path3.resolve(cwd, name);
+    if (await isFile(candidate)) {
+      return candidate;
+    }
+  }
+  throw new MaestroStackError("maestrostack.yml not found.", [
+    "Run `maestrostack init` to create one, or pass --config <path>."
+  ]);
+}
+async function loadConfig(explicit, cwd = process.cwd()) {
+  dotenv.config({ path: path3.resolve(cwd, ".env") });
+  const configPath = await resolveConfigPath(explicit, cwd);
+  logger.debug(`Using config: ${configPath}`);
+  const raw = await readFile(configPath, "utf8");
+  const substituted = resolveEnv(raw);
+  let parsed;
+  try {
+    parsed = parseYaml(substituted);
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new MaestroStackError(`Invalid YAML in ${path3.basename(configPath)}.`, [reason]);
+  }
+  const result = configSchema.safeParse(parsed);
+  if (!result.success) {
+    const details = result.error.issues.map((issue) => {
+      const where = issue.path.length > 0 ? `${issue.path.join(".")}: ` : "";
+      return `- ${where}${issue.message}`;
+    });
+    throw new MaestroStackError("Invalid configuration:", details);
+  }
+  return { config: result.data, configPath };
+}
+
+// src/suite/createZip.ts
+import { createWriteStream } from "fs";
+import path5 from "path";
+import archiver from "archiver";
+
+// src/utils/paths.ts
+import path4 from "path";
+var WORK_DIR = ".maestrostack";
+function distDir(cwd = process.cwd()) {
+  return path4.join(cwd, WORK_DIR, "dist");
+}
+function toPosix(p) {
+  return p.split(/[\\/]+/).join("/");
+}
+
+// src/suite/createZip.ts
+var SUITE_PREFIX = "Flows";
+async function createZip(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const root = path5.resolve(cwd, options.suiteRoot);
+  const outDir = distDir(cwd);
+  await ensureDir(outDir);
+  const zipPath = path5.join(outDir, options.packageName);
+  await new Promise((resolve, reject) => {
+    const output = createWriteStream(zipPath);
+    const archive = archiver("zip", { zlib: { level: 9 } });
+    output.on("close", () => resolve());
+    output.on("error", reject);
+    archive.on("error", reject);
+    archive.on("warning", (err) => {
+      if (err.code === "ENOENT") return;
+      reject(err);
+    });
+    archive.pipe(output);
+    for (const rel of options.files) {
+      const absolute = path5.join(root, ...rel.split("/"));
+      const entryName = `${SUITE_PREFIX}/${rel}`;
+      archive.file(absolute, { name: entryName });
+    }
+    void archive.finalize();
+  });
+  return { zipPath, files: options.files };
+}
+
+// src/commands/validate.ts
+import path8 from "path";
+
+// src/suite/discoverFlows.ts
+import path6 from "path";
+import fg from "fast-glob";
+var BUILT_IN_IGNORES = [
+  "*.yml",
+  "*.yaml",
+  ".git/**",
+  "node_modules/**",
+  ".maestrostack/**"
+];
+async function discoverFlows(suite, opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const root = path6.resolve(cwd, suite.root);
+  if (!await isDirectory(root)) {
+    throw new MaestroStackError(`suite.root does not exist: ${suite.root}`);
+  }
+  const ignore = [...BUILT_IN_IGNORES, ...suite.exclude];
+  if (opts.configBasename) {
+    ignore.push(opts.configBasename);
+  }
+  const matches = await fg(suite.include, {
+    cwd: root,
+    ignore,
+    onlyFiles: true,
+    dot: false,
+    followSymbolicLinks: false
+  });
+  if (matches.length === 0) {
+    throw new MaestroStackError("No Maestro flow files found.", [
+      "Maestro flow files should live inside subfolders (root-level YAML files are ignored).",
+      `Checked suite.root="${suite.root}" with include=${JSON.stringify(suite.include)}.`
+    ]);
+  }
+  return matches.sort();
+}
+
+// src/suite/validateSuite.ts
+import path7 from "path";
+var MAIN_FLOW = "main.yaml";
+async function validateSuite(config, discovered, cwd = process.cwd()) {
+  const { run, suite } = config;
+  if (run.executeMode === "main") {
+    const mainPath = path7.resolve(cwd, suite.root, MAIN_FLOW);
+    if (!await isFile(mainPath)) {
+      throw new MaestroStackError(
+        `executeMode is "main" but ${MAIN_FLOW} was not found in suite.root (${suite.root}).`,
+        [`Add a ${MAIN_FLOW} or switch to executeMode: explicit with a run.execute list.`]
+      );
+    }
+    return;
+  }
+  if (run.execute && run.execute.length > 0) {
+    const available = new Set(discovered.map(toPosix));
+    const missing = run.execute.map(toPosix).filter((p) => !available.has(p));
+    if (missing.length > 0) {
+      throw new MaestroStackError(
+        "Configured execute file(s) do not exist in the packaged suite:",
+        missing.map((p) => `- ${p}`)
+      );
+    }
+  }
+}
+
+// src/commands/validate.ts
+var PLATFORM_EXT = {
+  android: ".apk",
+  ios: ".ipa"
+};
+async function validateApp(config, cwd) {
+  const { app, platform } = config;
+  if (app.source === "custom_id") {
+    throw new MaestroStackError(
+      'app.source "custom_id" is not supported in the MVP.',
+      ["Use source: upload (with a path) or source: app_url (with a bs:// url)."]
+    );
+  }
+  if (app.source === "upload") {
+    const appPath = path8.resolve(cwd, app.path);
+    if (!await isFile(appPath)) {
+      throw new MaestroStackError(`app.path does not exist: ${app.path}`);
+    }
+    const expected = PLATFORM_EXT[platform];
+    if (extname(appPath) !== expected) {
+      throw new MaestroStackError(
+        `Platform "${platform}" requires a ${expected} file, but app.path is "${app.path}".`
+      );
+    }
+  }
+}
+async function validateAll(loaded, cwd) {
+  const { config, configPath } = loaded;
+  await validateApp(config, cwd);
+  const flows = await discoverFlows(config.suite, {
+    cwd,
+    configBasename: path8.basename(configPath)
+  });
+  await validateSuite(config, flows, cwd);
+  return { flows };
+}
+async function validateCommand(opts) {
+  const cwd = process.cwd();
+  const loaded = await loadConfig(opts.config, cwd);
+  const { flows } = await validateAll(loaded, cwd);
+  const { config } = loaded;
+  logger.info("Configuration is valid.");
+  logger.info("");
+  logger.info(`Config:    ${path8.relative(cwd, loaded.configPath) || loaded.configPath}`);
+  logger.info(`Platform:  ${config.platform}`);
+  logger.info(`Project:   ${config.run.project}`);
+  logger.info(`App:       ${describeApp(config)}`);
+  logger.info(`Devices:   ${config.run.devices.length}`);
+  for (const device of config.run.devices) {
+    logger.info(`  - ${device}`);
+  }
+  logger.info(`Flows:     ${flows.length}`);
+  for (const flow of flows) {
+    logger.info(`  - ${flow}`);
+  }
+  logger.info(`Execute:   ${config.run.executeMode}`);
+}
+function describeApp(config) {
+  const { app } = config;
+  switch (app.source) {
+    case "upload":
+      return `upload ${app.path}`;
+    case "app_url":
+      return `app_url ${app.appUrl}`;
+    default:
+      return app.source;
+  }
+}
+
+// src/commands/package.ts
+async function packageCommand(opts) {
+  const cwd = process.cwd();
+  const loaded = await loadConfig(opts.config, cwd);
+  const { config } = loaded;
+  const { flows } = await validateAll(loaded, cwd);
+  const { zipPath } = await createZip({
+    files: flows,
+    suiteRoot: config.suite.root,
+    packageName: config.suite.packageName,
+    cwd
+  });
+  logger.info(`Created suite zip: ${path9.relative(cwd, zipPath) || zipPath}`);
+  logger.info("Included flows:");
+  for (const flow of flows) {
+    logger.info(`- ${flow}`);
+  }
+}
+
+// src/commands/run.ts
+import path12 from "path";
+
+// src/browserstack/uploadApp.ts
+import { openAsBlob } from "fs";
+import path10 from "path";
+import { FormData } from "undici";
+
+// src/browserstack/client.ts
+import { fetch } from "undici";
+var BASE_URL = "https://api-cloud.browserstack.com";
+function authHeader(auth) {
+  const token = Buffer.from(`${auth.username}:${auth.accessKey}`).toString("base64");
+  return `Basic ${token}`;
+}
+async function bsRequest(options) {
+  const url = `${BASE_URL}${options.path}`;
+  const headers = {
+    authorization: authHeader(options.auth)
+  };
+  let body;
+  if (options.jsonBody !== void 0) {
+    headers["content-type"] = "application/json";
+    body = JSON.stringify(options.jsonBody);
+  } else if (options.rawBody !== void 0) {
+    body = options.rawBody;
+  }
+  logger.debug(`${options.method} ${url}`);
+  let response;
+  try {
+    response = await fetch(url, { method: options.method, headers, body });
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    throw new MaestroStackError(`Failed to reach BrowserStack: ${reason}`);
+  }
+  const text = await response.text();
+  let data = {};
+  if (text) {
+    try {
+      data = JSON.parse(text);
+    } catch {
+      data = { raw: text };
+    }
+  }
+  if (!response.ok) {
+    const message = extractErrorMessage(data) ?? response.statusText;
+    throw new MaestroStackError(`BrowserStack API error (${response.status}): ${message}`);
+  }
+  return data;
+}
+function extractErrorMessage(data) {
+  if (data && typeof data === "object") {
+    const obj = data;
+    for (const key of ["message", "error", "errors"]) {
+      const value = obj[key];
+      if (typeof value === "string" && value.length > 0) return value;
+    }
+  }
+  return void 0;
+}
+
+// src/browserstack/uploadApp.ts
+async function uploadApp(options) {
+  if (!await isFile(options.filePath)) {
+    throw new MaestroStackError(`app.path does not exist: ${options.filePath}`);
+  }
+  const form = new FormData();
+  const blob = await openAsBlob(options.filePath);
+  form.set("file", blob, path10.basename(options.filePath));
+  if (options.customId) {
+    form.set("custom_id", options.customId);
+  }
+  return bsRequest({
+    path: "/app-automate/maestro/v2/app",
+    method: "POST",
+    auth: options.auth,
+    rawBody: form
+  });
+}
+
+// src/browserstack/uploadSuite.ts
+import { openAsBlob as openAsBlob2 } from "fs";
+import path11 from "path";
+import { FormData as FormData2 } from "undici";
+async function uploadSuite(options) {
+  if (!await isFile(options.zipPath)) {
+    throw new MaestroStackError(`Suite zip does not exist: ${options.zipPath}`);
+  }
+  const form = new FormData2();
+  const blob = await openAsBlob2(options.zipPath);
+  form.set("file", blob, path11.basename(options.zipPath));
+  if (options.customId) {
+    form.set("custom_id", options.customId);
+  }
+  return bsRequest({
+    path: "/app-automate/maestro/v2/test-suite",
+    method: "POST",
+    auth: options.auth,
+    rawBody: form
+  });
+}
+
+// src/browserstack/startBuild.ts
+function buildPath(platform) {
+  return `/app-automate/maestro/v2/${platform}/build`;
+}
+function buildPayload(config, resolved) {
+  const { run } = config;
+  const payload = {
+    app: resolved.app,
+    testSuite: resolved.testSuite,
+    project: run.project,
+    devices: run.devices
+  };
+  if (run.executeMode === "explicit" && run.execute && run.execute.length > 0) {
+    payload.execute = run.execute;
+  }
+  if (run.options.networkLogs !== void 0) {
+    payload.networkLogs = run.options.networkLogs;
+  }
+  if (run.options.deviceLogs !== void 0) {
+    payload.deviceLogs = run.options.deviceLogs;
+  }
+  return payload;
+}
+async function startBuild(options) {
+  return bsRequest({
+    path: buildPath(options.platform),
+    method: "POST",
+    auth: options.auth,
+    jsonBody: options.payload
+  });
+}
+
+// src/commands/run.ts
+var APP_PLACEHOLDER = "<resolved after upload>";
+var SUITE_PLACEHOLDER = "<resolved after upload>";
+function applyOverrides(config, opts) {
+  let run = config.run;
+  if (opts.device && opts.device.length > 0) {
+    run = { ...run, devices: opts.device };
+  }
+  if (opts.execute && opts.execute.length > 0) {
+    run = { ...run, execute: opts.execute.map(toPosix), executeMode: "explicit" };
+  }
+  return { ...config, run };
+}
+async function runCommand(opts) {
+  const cwd = process.cwd();
+  const loaded = await loadConfig(opts.config, cwd);
+  const config = applyOverrides(loaded.config, opts);
+  const { flows } = await validateAll({ ...loaded, config }, cwd);
+  if (opts.dryRun) {
+    printDryRun(config, flows, cwd);
+    return;
+  }
+  const { zipPath } = await createZip({
+    files: flows,
+    suiteRoot: config.suite.root,
+    packageName: config.suite.packageName,
+    cwd
+  });
+  logger.debug(`Created suite zip: ${zipPath}`);
+  const appUrl = await resolveApp(config, cwd);
+  logger.debug(`Resolved app: ${appUrl}`);
+  logger.info(`Uploading test suite (${flows.length} flow(s)) ...`);
+  const suiteResult = await uploadSuite({
+    auth: config.auth,
+    zipPath,
+    customId: config.suite.customId
+  });
+  const payload = buildPayload(config, {
+    app: appUrl,
+    testSuite: suiteResult.test_suite_url
+  });
+  logger.info(`Starting ${config.platform} build ...`);
+  const build = await startBuild({ auth: config.auth, platform: config.platform, payload });
+  printSummary(config, appUrl, suiteResult.test_suite_url, build.build_id);
+}
+async function resolveApp(config, cwd) {
+  const { app } = config;
+  if (app.source === "app_url") {
+    return app.appUrl;
+  }
+  if (app.source === "upload") {
+    logger.info(`Uploading app: ${app.path} ...`);
+    const result = await uploadApp({
+      auth: config.auth,
+      filePath: path12.resolve(cwd, app.path),
+      customId: app.customId
+    });
+    return result.app_url;
+  }
+  throw new MaestroStackError(`Unsupported app.source: ${app.source}`);
+}
+function previewApp(config) {
+  const { app } = config;
+  return app.source === "app_url" ? app.appUrl : APP_PLACEHOLDER;
+}
+function printDryRun(config, flows, cwd) {
+  logger.info("Dry run only. No API calls made.");
+  logger.info("");
+  logger.info("Would package:");
+  for (const flow of flows) {
+    logger.info(`- ${flow}`);
+  }
+  logger.info("");
+  const { app } = config;
+  if (app.source === "upload") {
+    logger.info(`Would upload app:
+${app.path}`);
+  } else if (app.source === "app_url") {
+    logger.info(`Would use app:
+${app.appUrl}`);
+  }
+  logger.info("");
+  logger.info(`Would call:
+POST ${buildPath(config.platform)}`);
+  logger.info("");
+  const payload = buildPayload(config, {
+    app: previewApp(config),
+    testSuite: SUITE_PLACEHOLDER
+  });
+  logger.info("Payload:");
+  logger.info(JSON.stringify(payload, null, 2));
+}
+function printSummary(config, appUrl, testSuiteUrl, buildId) {
+  logger.info("");
+  logger.info("MaestroStack run started");
+  logger.info("");
+  logger.info(`Project: ${config.run.project}`);
+  logger.info(`Platform: ${config.platform}`);
+  logger.info("Devices:");
+  for (const device of config.run.devices) {
+    logger.info(`- ${device}`);
+  }
+  logger.info("");
+  logger.info(`App: ${appUrl}`);
+  logger.info(`Test suite: ${testSuiteUrl}`);
+  logger.info(`Build ID: ${buildId}`);
+}
+
+// src/commands/uploadApp.ts
+import path13 from "path";
+async function uploadAppCommand(opts) {
+  const cwd = process.cwd();
+  const { config } = await loadConfig(opts.config, cwd);
+  await validateApp(config, cwd);
+  if (config.app.source !== "upload") {
+    throw new MaestroStackError(
+      `upload-app requires app.source "upload" (current: "${config.app.source}").`
+    );
+  }
+  const filePath = path13.resolve(cwd, config.app.path);
+  logger.info(`Uploading app: ${config.app.path} ...`);
+  const result = await uploadApp({
+    auth: config.auth,
+    filePath,
+    customId: config.app.customId
+  });
+  logger.info("Uploaded app:");
+  logger.info(`app_url: ${result.app_url}`);
+  if (result.custom_id) logger.info(`custom_id: ${result.custom_id}`);
+  if (result.expiry) logger.info(`expires: ${result.expiry}`);
+}
+
+// src/commands/uploadSuite.ts
+async function uploadSuiteCommand(opts) {
+  const cwd = process.cwd();
+  const loaded = await loadConfig(opts.config, cwd);
+  const { config } = loaded;
+  const { flows } = await validateAll(loaded, cwd);
+  const { zipPath } = await createZip({
+    files: flows,
+    suiteRoot: config.suite.root,
+    packageName: config.suite.packageName,
+    cwd
+  });
+  logger.info(`Uploading test suite (${flows.length} flow(s)) ...`);
+  const result = await uploadSuite({
+    auth: config.auth,
+    zipPath,
+    customId: config.suite.customId
+  });
+  logger.info("Uploaded test suite:");
+  logger.info(`test_suite_url: ${result.test_suite_url}`);
+  if (result.custom_id) logger.info(`custom_id: ${result.custom_id}`);
+  if (result.expiry) logger.info(`expires: ${result.expiry}`);
+}
+
+// src/cli.ts
+var program = new Command();
+function collect(value, previous) {
+  return [...previous, value];
+}
+function action(fn) {
+  return async (rawOpts) => {
+    const opts = { ...program.opts(), ...rawOpts };
+    if (opts.debug) setDebug(true);
+    try {
+      await fn(opts);
+    } catch (err) {
+      if (isMaestroStackError(err)) {
+        logger.error(err.message);
+        for (const line of err.details ?? []) {
+          logger.error(`  ${line}`);
+        }
+      } else {
+        logger.error(err instanceof Error ? err.stack ?? err.message : String(err));
+      }
+      process.exitCode = 1;
+    }
+  };
+}
+program.name("maestrostack").description("Config-driven CLI for running Maestro tests on BrowserStack App Automate.").version("0.1.0").option("-c, --config <path>", "path to the config file").option("--debug", "enable debug logging");
+program.command("init").description("Create a starter maestrostack.yml").option("--android", "scaffold an Android config").option("--ios", "scaffold an iOS config").option("--force", "overwrite an existing config").action(action(initCommand));
+program.command("validate").description("Validate the config, suite structure and devices").action(action(validateCommand));
+program.command("package").description("Discover flows and create the suite zip without uploading").action(action(packageCommand));
+program.command("upload-app").description("Upload only the app and print its BrowserStack app_url").action(action(uploadAppCommand));
+program.command("upload-suite").description("Package and upload only the Maestro suite").action(action(uploadSuiteCommand));
+program.command("run").description("Package, upload and trigger a BrowserStack Maestro build").option("--dry-run", "validate and print the payload without making API calls").option("--device <name>", "override run.devices (repeatable)", collect, []).option("--execute <path>", "override run.execute (repeatable)", collect, []).action(action(runCommand));
+program.parseAsync(process.argv).catch((err) => {
+  logger.error(err instanceof Error ? err.message : String(err));
+  process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/commands/init.ts","../src/utils/errors.ts","../src/utils/fs.ts","../src/utils/logger.ts","../src/commands/package.ts","../src/config/loadConfig.ts","../src/config/resolveEnv.ts","../src/config/schema.ts","../src/suite/createZip.ts","../src/utils/paths.ts","../src/commands/validate.ts","../src/suite/discoverFlows.ts","../src/suite/validateSuite.ts","../src/commands/run.ts","../src/browserstack/uploadApp.ts","../src/browserstack/client.ts","../src/browserstack/uploadSuite.ts","../src/browserstack/startBuild.ts","../src/commands/uploadApp.ts","../src/commands/uploadSuite.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { initCommand } from \"./commands/init.js\";\nimport { packageCommand } from \"./commands/package.js\";\nimport { runCommand } from \"./commands/run.js\";\nimport { uploadAppCommand } from \"./commands/uploadApp.js\";\nimport { uploadSuiteCommand } from \"./commands/uploadSuite.js\";\nimport { validateCommand } from \"./commands/validate.js\";\nimport { isMaestroStackError } from \"./utils/errors.js\";\nimport { logger, setDebug } from \"./utils/logger.js\";\n\nconst program = new Command();\n\n/** Accumulate repeated CLI options (e.g. --device a --device b) into an array. */\nfunction collect(value: string, previous: string[]): string[] {\n  return [...previous, value];\n}\n\n/**\n * Wrap a command action: merge program-level (global) options, apply debug mode,\n * and turn expected errors into a clean message with exit code 1 instead of an\n * unhandled rejection / stack dump.\n */\nfunction action<T extends object>(\n  fn: (opts: T & { config?: string; debug?: boolean }) => Promise<void>,\n): (opts: T) => Promise<void> {\n  return async (rawOpts: T) => {\n    const opts = { ...program.opts(), ...rawOpts };\n    if (opts.debug) setDebug(true);\n    try {\n      await fn(opts);\n    } catch (err) {\n      if (isMaestroStackError(err)) {\n        logger.error(err.message);\n        for (const line of err.details ?? []) {\n          logger.error(`  ${line}`);\n        }\n      } else {\n        logger.error(err instanceof Error ? (err.stack ?? err.message) : String(err));\n      }\n      process.exitCode = 1;\n    }\n  };\n}\n\nprogram\n  .name(\"maestrostack\")\n  .description(\"Config-driven CLI for running Maestro tests on BrowserStack App Automate.\")\n  .version(\"0.1.0\")\n  .option(\"-c, --config <path>\", \"path to the config file\")\n  .option(\"--debug\", \"enable debug logging\");\n\nprogram\n  .command(\"init\")\n  .description(\"Create a starter maestrostack.yml\")\n  .option(\"--android\", \"scaffold an Android config\")\n  .option(\"--ios\", \"scaffold an iOS config\")\n  .option(\"--force\", \"overwrite an existing config\")\n  .action(action(initCommand));\n\nprogram\n  .command(\"validate\")\n  .description(\"Validate the config, suite structure and devices\")\n  .action(action(validateCommand));\n\nprogram\n  .command(\"package\")\n  .description(\"Discover flows and create the suite zip without uploading\")\n  .action(action(packageCommand));\n\nprogram\n  .command(\"upload-app\")\n  .description(\"Upload only the app and print its BrowserStack app_url\")\n  .action(action(uploadAppCommand));\n\nprogram\n  .command(\"upload-suite\")\n  .description(\"Package and upload only the Maestro suite\")\n  .action(action(uploadSuiteCommand));\n\nprogram\n  .command(\"run\")\n  .description(\"Package, upload and trigger a BrowserStack Maestro build\")\n  .option(\"--dry-run\", \"validate and print the payload without making API calls\")\n  .option(\"--device <name>\", \"override run.devices (repeatable)\", collect, [])\n  .option(\"--execute <path>\", \"override run.execute (repeatable)\", collect, [])\n  .action(action(runCommand));\n\nprogram.parseAsync(process.argv).catch((err) => {\n  logger.error(err instanceof Error ? err.message : String(err));\n  process.exitCode = 1;\n});\n","import { writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Platform } from \"../config/schema.js\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { pathExists } from \"../utils/fs.js\";\nimport { logger } from \"../utils/logger.js\";\n\nexport interface InitOptions {\n  android?: boolean;\n  ios?: boolean;\n  force?: boolean;\n}\n\nconst CONFIG_NAME = \"maestrostack.yml\";\n\n/** Create a starter maestrostack.yml. */\nexport async function initCommand(opts: InitOptions): Promise<void> {\n  if (opts.android && opts.ios) {\n    throw new MaestroStackError(\"Pass only one of --android or --ios.\");\n  }\n  const platform: Platform = opts.ios ? \"ios\" : \"android\";\n\n  const cwd = process.cwd();\n  const target = path.join(cwd, CONFIG_NAME);\n\n  if ((await pathExists(target)) && !opts.force) {\n    throw new MaestroStackError(`${CONFIG_NAME} already exists.`, [\n      \"Use --force to overwrite it.\",\n    ]);\n  }\n\n  await writeFile(target, template(platform), \"utf8\");\n  logger.info(`Created ${CONFIG_NAME} (platform: ${platform}).`);\n  logger.info(\"Next: set BROWSERSTACK_USERNAME / BROWSERSTACK_ACCESS_KEY, then run `maestrostack validate`.\");\n}\n\nfunction template(platform: Platform): string {\n  const appPath = platform === \"ios\" ? \"./apps/app-release.ipa\" : \"./apps/app-release.apk\";\n  const devices =\n    platform === \"ios\"\n      ? [\"iPhone 15-17.0\"]\n      : [\"Samsung Galaxy S20-10.0\", \"Google Pixel 7-13.0\"];\n\n  const deviceLines = devices.map((d) => `    - ${d}`).join(\"\\n\");\n\n  // Always \\n line endings so the file is identical across platforms.\n  return [\n    \"version: 1\",\n    \"\",\n    \"auth:\",\n    \"  username: ${BROWSERSTACK_USERNAME}\",\n    \"  accessKey: ${BROWSERSTACK_ACCESS_KEY}\",\n    \"\",\n    `platform: ${platform}`,\n    \"\",\n    \"app:\",\n    \"  source: upload\",\n    `  path: ${appPath}`,\n    \"  customId: SampleApp\",\n    \"\",\n    \"suite:\",\n    \"  root: .\",\n    \"  packageName: Flows.zip\",\n    \"  customId: SampleTest\",\n    \"  include:\",\n    \"    - smoke/**/*.yml\",\n    \"    - regression/**/*.yml\",\n    \"  exclude:\",\n    \"    - apps/**\",\n    \"\",\n    \"run:\",\n    \"  project: Maestro_Test\",\n    \"  devices:\",\n    deviceLines,\n    \"  executeMode: explicit\",\n    \"  execute:\",\n    \"    - smoke/login.yml\",\n    \"  options:\",\n    \"    networkLogs: true\",\n    \"    deviceLogs: true\",\n    \"\",\n  ].join(\"\\n\");\n}\n","/**\n * Error type for all expected, user-facing failures (bad config, missing files,\n * API errors, etc). The CLI entrypoint catches these and prints a clean message\n * with exit code 1, rather than dumping a stack trace.\n */\nexport class MaestroStackError extends Error {\n  /** Optional extra lines shown beneath the main message (e.g. hints). */\n  readonly details?: string[];\n\n  constructor(message: string, details?: string[]) {\n    super(message);\n    this.name = \"MaestroStackError\";\n    this.details = details;\n  }\n}\n\n/** Type guard for {@link MaestroStackError}. */\nexport function isMaestroStackError(err: unknown): err is MaestroStackError {\n  return err instanceof MaestroStackError;\n}\n","import { constants } from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/** Returns true if a file or directory exists at `p`. */\nexport async function pathExists(p: string): Promise<boolean> {\n  try {\n    await fs.access(p, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** Returns true if `p` exists and is a regular file. */\nexport async function isFile(p: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(p);\n    return stat.isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Returns true if `p` exists and is a directory. */\nexport async function isDirectory(p: string): Promise<boolean> {\n  try {\n    const stat = await fs.stat(p);\n    return stat.isDirectory();\n  } catch {\n    return false;\n  }\n}\n\n/** Creates a directory (and parents) if it does not already exist. */\nexport async function ensureDir(dir: string): Promise<void> {\n  await fs.mkdir(dir, { recursive: true });\n}\n\n/** Removes a directory tree if present; no-op if missing. */\nexport async function removeDir(dir: string): Promise<void> {\n  await fs.rm(dir, { recursive: true, force: true });\n}\n\n/** Lower-cased file extension including the dot (e.g. \".apk\"). */\nexport function extname(p: string): string {\n  return path.extname(p).toLowerCase();\n}\n","/* eslint-disable no-console */\n\nlet debugEnabled = false;\n\n/** Enable or disable debug-level output (wired to the global --debug flag). */\nexport function setDebug(enabled: boolean): void {\n  debugEnabled = enabled;\n}\n\nexport function isDebugEnabled(): boolean {\n  return debugEnabled;\n}\n\nexport const logger = {\n  /** Primary user-facing output. */\n  info(message = \"\"): void {\n    console.log(message);\n  },\n  warn(message: string): void {\n    console.warn(`warning: ${message}`);\n  },\n  error(message: string): void {\n    console.error(message);\n  },\n  /** Only printed when --debug is set. Prefixed so it is visually distinct. */\n  debug(message: string): void {\n    if (debugEnabled) {\n      console.error(`[debug] ${message}`);\n    }\n  },\n};\n\n/**\n * Mask a secret for display, keeping only the last few characters so logs are\n * still useful for debugging without exposing the value. Empty/short values are\n * fully masked.\n */\nexport function redact(secret: string | undefined): string {\n  if (!secret) return \"\";\n  if (secret.length <= 4) return \"****\";\n  return `****${secret.slice(-4)}`;\n}\n","import path from \"node:path\";\nimport { loadConfig } from \"../config/loadConfig.js\";\nimport { createZip } from \"../suite/createZip.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { validateAll, type GlobalOptions } from \"./validate.js\";\n\n/**\n * Discover flows and create the suite zip without uploading. Useful for\n * debugging the resulting archive structure.\n */\nexport async function packageCommand(opts: GlobalOptions): Promise<void> {\n  const cwd = process.cwd();\n  const loaded = await loadConfig(opts.config, cwd);\n  const { config } = loaded;\n  const { flows } = await validateAll(loaded, cwd);\n\n  const { zipPath } = await createZip({\n    files: flows,\n    suiteRoot: config.suite.root,\n    packageName: config.suite.packageName,\n    cwd,\n  });\n\n  logger.info(`Created suite zip: ${path.relative(cwd, zipPath) || zipPath}`);\n  logger.info(\"Included flows:\");\n  for (const flow of flows) {\n    logger.info(`- ${flow}`);\n  }\n}\n","import { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport dotenv from \"dotenv\";\nimport { parse as parseYaml } from \"yaml\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { isFile } from \"../utils/fs.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { resolveEnv } from \"./resolveEnv.js\";\nimport { configSchema, type Config } from \"./schema.js\";\n\nconst DEFAULT_CONFIG_NAMES = [\"maestrostack.yml\", \"maestrostack.yaml\"];\n\nexport interface LoadedConfig {\n  config: Config;\n  /** Absolute path to the resolved config file. */\n  configPath: string;\n}\n\n/**\n * Resolve which config file to use. An explicit `-c` path must exist; otherwise\n * we look for maestrostack.yml then maestrostack.yaml in the working directory.\n */\nexport async function resolveConfigPath(\n  explicit: string | undefined,\n  cwd: string = process.cwd(),\n): Promise<string> {\n  if (explicit) {\n    const resolved = path.resolve(cwd, explicit);\n    if (!(await isFile(resolved))) {\n      throw new MaestroStackError(`Config file not found: ${explicit}`);\n    }\n    return resolved;\n  }\n\n  for (const name of DEFAULT_CONFIG_NAMES) {\n    const candidate = path.resolve(cwd, name);\n    if (await isFile(candidate)) {\n      return candidate;\n    }\n  }\n\n  throw new MaestroStackError(\"maestrostack.yml not found.\", [\n    \"Run `maestrostack init` to create one, or pass --config <path>.\",\n  ]);\n}\n\n/**\n * Load, env-substitute, parse and validate a config file. The `.env` in the\n * working directory is loaded first so `${VAR}` tokens can resolve against it.\n */\nexport async function loadConfig(\n  explicit: string | undefined,\n  cwd: string = process.cwd(),\n): Promise<LoadedConfig> {\n  // Load .env (does not override already-set process.env values).\n  dotenv.config({ path: path.resolve(cwd, \".env\") });\n\n  const configPath = await resolveConfigPath(explicit, cwd);\n  logger.debug(`Using config: ${configPath}`);\n\n  const raw = await readFile(configPath, \"utf8\");\n  const substituted = resolveEnv(raw);\n\n  let parsed: unknown;\n  try {\n    parsed = parseYaml(substituted);\n  } catch (err) {\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new MaestroStackError(`Invalid YAML in ${path.basename(configPath)}.`, [reason]);\n  }\n\n  const result = configSchema.safeParse(parsed);\n  if (!result.success) {\n    const details = result.error.issues.map((issue) => {\n      const where = issue.path.length > 0 ? `${issue.path.join(\".\")}: ` : \"\";\n      return `- ${where}${issue.message}`;\n    });\n    throw new MaestroStackError(\"Invalid configuration:\", details);\n  }\n\n  return { config: result.data, configPath };\n}\n","import { MaestroStackError } from \"../utils/errors.js\";\n\n/** Matches ${VAR_NAME} tokens. Variable names follow shell-ish conventions. */\nconst ENV_TOKEN = /\\$\\{([A-Za-z_][A-Za-z0-9_]*)\\}/g;\n\n/**\n * Substitute `${VAR}` tokens in the raw config text using `env` (defaults to\n * process.env). All missing variables are collected and reported together so the\n * user fixes them in one pass - and crucially this happens before any upload.\n */\nexport function resolveEnv(\n  raw: string,\n  env: NodeJS.ProcessEnv = process.env,\n): string {\n  const missing = new Set<string>();\n\n  const resolved = raw.replace(ENV_TOKEN, (_match, name: string) => {\n    const value = env[name];\n    if (value === undefined || value === \"\") {\n      missing.add(name);\n      return \"\";\n    }\n    return value;\n  });\n\n  if (missing.size > 0) {\n    const names = [...missing].sort();\n    throw new MaestroStackError(\n      `Missing required environment variable(s): ${names.join(\", \")}`,\n      [\"Set them in your shell or a .env file in the working directory.\"],\n    );\n  }\n\n  return resolved;\n}\n","import { z } from \"zod\";\n\n/**\n * Zod schema for maestrostack.yml. Parsing yields a fully-typed {@link Config}.\n * Validation messages here are intentionally human-readable since they surface\n * directly in the CLI.\n */\n\nconst nonEmpty = (label: string) =>\n  z.string({ required_error: `${label} is required` }).trim().min(1, `${label} must not be empty`);\n\nconst authSchema = z.object({\n  username: nonEmpty(\"BrowserStack username (auth.username)\"),\n  accessKey: nonEmpty(\"BrowserStack access key (auth.accessKey)\"),\n});\n\nconst appUploadSchema = z.object({\n  source: z.literal(\"upload\"),\n  path: nonEmpty(\"app.path\"),\n  customId: z.string().trim().min(1).optional(),\n});\n\nconst appUrlSchema = z.object({\n  source: z.literal(\"app_url\"),\n  appUrl: nonEmpty(\"app.appUrl\").refine((v) => v.startsWith(\"bs://\"), {\n    message: \"app.appUrl must start with bs://\",\n  }),\n  customId: z.string().trim().min(1).optional(),\n});\n\nconst appCustomIdSchema = z.object({\n  // Present in the schema so configs validate, but resolution is deferred (see validate.ts).\n  source: z.literal(\"custom_id\"),\n  customId: nonEmpty(\"app.customId\"),\n});\n\nconst appSchema = z.discriminatedUnion(\"source\", [\n  appUploadSchema,\n  appUrlSchema,\n  appCustomIdSchema,\n]);\n\nconst suiteSchema = z.object({\n  root: z.string().trim().min(1).default(\".\"),\n  packageName: z.string().trim().min(1).default(\"Flows.zip\"),\n  customId: z.string().trim().min(1).optional(),\n  include: z.array(nonEmpty(\"suite.include entry\")).default([\"**/*.yml\", \"**/*.yaml\"]),\n  exclude: z.array(z.string()).default([]),\n});\n\nconst optionsSchema = z\n  .object({\n    networkLogs: z.boolean().optional(),\n    deviceLogs: z.boolean().optional(),\n  })\n  .default({});\n\nconst runSchema = z.object({\n  project: nonEmpty(\"run.project\"),\n  devices: z\n    .array(nonEmpty(\"device\"))\n    .min(1, \"run.devices must contain at least one device\"),\n  executeMode: z.enum([\"explicit\", \"main\"]).default(\"explicit\"),\n  execute: z.array(nonEmpty(\"run.execute entry\")).optional(),\n  options: optionsSchema,\n});\n\nexport const configSchema = z.object({\n  version: z.literal(1, {\n    errorMap: () => ({ message: \"Unsupported config version. Expected version: 1\" }),\n  }),\n  auth: authSchema,\n  platform: z.enum([\"android\", \"ios\"], {\n    errorMap: () => ({ message: \"Unsupported platform. Expected android or ios\" }),\n  }),\n  app: appSchema,\n  suite: suiteSchema.default({}),\n  run: runSchema,\n});\n\nexport type Config = z.infer<typeof configSchema>;\nexport type AppConfig = Config[\"app\"];\nexport type Platform = Config[\"platform\"];\n","import { createWriteStream } from \"node:fs\";\nimport path from \"node:path\";\nimport archiver from \"archiver\";\nimport { ensureDir } from \"../utils/fs.js\";\nimport { distDir } from \"../utils/paths.js\";\n\nexport interface ZipResult {\n  /** Absolute path to the written zip file. */\n  zipPath: string;\n  /** Forward-slash flow paths that were included (relative to suite root). */\n  files: string[];\n}\n\n/** Top-level folder inside the archive. BrowserStack locates flows under this. */\nexport const SUITE_PREFIX = \"Flows\";\n\n/**\n * Create the suite zip from the given flow files. Each entry is stored under\n * `Flows/<relativePath>` using forward slashes (required by the ZIP spec and so\n * BrowserStack can locate flows regardless of the host OS that built the zip).\n */\nexport async function createZip(options: {\n  files: string[];\n  suiteRoot: string;\n  packageName: string;\n  cwd?: string;\n}): Promise<ZipResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const root = path.resolve(cwd, options.suiteRoot);\n  const outDir = distDir(cwd);\n  await ensureDir(outDir);\n  const zipPath = path.join(outDir, options.packageName);\n\n  await new Promise<void>((resolve, reject) => {\n    const output = createWriteStream(zipPath);\n    const archive = archiver(\"zip\", { zlib: { level: 9 } });\n\n    output.on(\"close\", () => resolve());\n    output.on(\"error\", reject);\n    archive.on(\"error\", reject);\n    archive.on(\"warning\", (err) => {\n      if (err.code === \"ENOENT\") return; // non-fatal\n      reject(err);\n    });\n\n    archive.pipe(output);\n\n    for (const rel of options.files) {\n      // `rel` is already forward-slash (from discoverFlows); resolve to the OS\n      // path for reading, but name the entry with forward slashes.\n      const absolute = path.join(root, ...rel.split(\"/\"));\n      const entryName = `${SUITE_PREFIX}/${rel}`;\n      archive.file(absolute, { name: entryName });\n    }\n\n    void archive.finalize();\n  });\n\n  return { zipPath, files: options.files };\n}\n","import path from \"node:path\";\n\n/**\n * Internal working directory MaestroStack writes to. Relative to the current\n * working directory so it lands next to the user's project. Should be gitignored.\n */\nexport const WORK_DIR = \".maestrostack\";\n\n/** Directory for build artifacts (the generated suite zip). */\nexport function distDir(cwd: string = process.cwd()): string {\n  return path.join(cwd, WORK_DIR, \"dist\");\n}\n\n/** Directory for transient files. */\nexport function tmpDir(cwd: string = process.cwd()): string {\n  return path.join(cwd, WORK_DIR, \"tmp\");\n}\n\n/**\n * Convert a path into the forward-slash form used internally and by BrowserStack\n * (zip entries, execute paths). Both separators are normalized so a config or\n * `--execute` value authored on Windows (`smoke\\login.yml`) matches discovered\n * flows regardless of the OS MaestroStack runs on.\n */\nexport function toPosix(p: string): string {\n  return p.split(/[\\\\/]+/).join(\"/\");\n}\n","import path from \"node:path\";\nimport type { Config } from \"../config/schema.js\";\nimport { loadConfig, type LoadedConfig } from \"../config/loadConfig.js\";\nimport { discoverFlows } from \"../suite/discoverFlows.js\";\nimport { validateSuite } from \"../suite/validateSuite.js\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { extname, isFile } from \"../utils/fs.js\";\nimport { logger } from \"../utils/logger.js\";\n\nexport interface GlobalOptions {\n  config?: string;\n  debug?: boolean;\n}\n\nconst PLATFORM_EXT: Record<Config[\"platform\"], string> = {\n  android: \".apk\",\n  ios: \".ipa\",\n};\n\n/**\n * Semantic validation of the app block beyond the Zod schema: deferred sources,\n * file existence and platform/extension agreement.\n */\nexport async function validateApp(config: Config, cwd: string): Promise<void> {\n  const { app, platform } = config;\n\n  if (app.source === \"custom_id\") {\n    throw new MaestroStackError(\n      'app.source \"custom_id\" is not supported in the MVP.',\n      [\"Use source: upload (with a path) or source: app_url (with a bs:// url).\"],\n    );\n  }\n\n  if (app.source === \"upload\") {\n    const appPath = path.resolve(cwd, app.path);\n    if (!(await isFile(appPath))) {\n      throw new MaestroStackError(`app.path does not exist: ${app.path}`);\n    }\n    const expected = PLATFORM_EXT[platform];\n    if (extname(appPath) !== expected) {\n      throw new MaestroStackError(\n        `Platform \"${platform}\" requires a ${expected} file, but app.path is \"${app.path}\".`,\n      );\n    }\n  }\n}\n\n/**\n * Full validation pipeline shared by `validate` and `run`: app block, flow\n * discovery and suite/execute checks. Returns the discovered flow paths.\n */\nexport async function validateAll(\n  loaded: LoadedConfig,\n  cwd: string,\n): Promise<{ flows: string[] }> {\n  const { config, configPath } = loaded;\n  await validateApp(config, cwd);\n\n  const flows = await discoverFlows(config.suite, {\n    cwd,\n    configBasename: path.basename(configPath),\n  });\n\n  await validateSuite(config, flows, cwd);\n\n  return { flows };\n}\n\nexport async function validateCommand(opts: GlobalOptions): Promise<void> {\n  const cwd = process.cwd();\n  const loaded = await loadConfig(opts.config, cwd);\n  const { flows } = await validateAll(loaded, cwd);\n  const { config } = loaded;\n\n  logger.info(\"Configuration is valid.\");\n  logger.info(\"\");\n  logger.info(`Config:    ${path.relative(cwd, loaded.configPath) || loaded.configPath}`);\n  logger.info(`Platform:  ${config.platform}`);\n  logger.info(`Project:   ${config.run.project}`);\n  logger.info(`App:       ${describeApp(config)}`);\n  logger.info(`Devices:   ${config.run.devices.length}`);\n  for (const device of config.run.devices) {\n    logger.info(`  - ${device}`);\n  }\n  logger.info(`Flows:     ${flows.length}`);\n  for (const flow of flows) {\n    logger.info(`  - ${flow}`);\n  }\n  logger.info(`Execute:   ${config.run.executeMode}`);\n}\n\nfunction describeApp(config: Config): string {\n  const { app } = config;\n  switch (app.source) {\n    case \"upload\":\n      return `upload ${app.path}`;\n    case \"app_url\":\n      return `app_url ${app.appUrl}`;\n    default:\n      return app.source;\n  }\n}\n","import path from \"node:path\";\nimport fg from \"fast-glob\";\nimport type { Config } from \"../config/schema.js\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { isDirectory } from \"../utils/fs.js\";\n\nexport interface DiscoverOptions {\n  /** Working directory the suite root is resolved against. */\n  cwd?: string;\n  /** Basename of the active config file, always excluded from the suite. */\n  configBasename?: string;\n}\n\n/**\n * Always-on ignore patterns. Root-level YAML files are treated as config files,\n * not Maestro flows (top-level only - `*.yml` matches `staging.yml` but not\n * `smoke/login.yml`). Build/VCS/dependency dirs are never packaged.\n */\nconst BUILT_IN_IGNORES = [\n  \"*.yml\",\n  \"*.yaml\",\n  \".git/**\",\n  \"node_modules/**\",\n  \".maestrostack/**\",\n];\n\n/**\n * Discover Maestro flow files under `suite.root` using the configured include /\n * exclude globs. Returns sorted, forward-slash relative paths (fast-glob emits\n * POSIX separators on every OS, keeping output identical across platforms).\n */\nexport async function discoverFlows(\n  suite: Config[\"suite\"],\n  opts: DiscoverOptions = {},\n): Promise<string[]> {\n  const cwd = opts.cwd ?? process.cwd();\n  const root = path.resolve(cwd, suite.root);\n\n  if (!(await isDirectory(root))) {\n    throw new MaestroStackError(`suite.root does not exist: ${suite.root}`);\n  }\n\n  const ignore = [...BUILT_IN_IGNORES, ...suite.exclude];\n  if (opts.configBasename) {\n    ignore.push(opts.configBasename);\n  }\n\n  const matches = await fg(suite.include, {\n    cwd: root,\n    ignore,\n    onlyFiles: true,\n    dot: false,\n    followSymbolicLinks: false,\n  });\n\n  if (matches.length === 0) {\n    throw new MaestroStackError(\"No Maestro flow files found.\", [\n      \"Maestro flow files should live inside subfolders (root-level YAML files are ignored).\",\n      `Checked suite.root=\"${suite.root}\" with include=${JSON.stringify(suite.include)}.`,\n    ]);\n  }\n\n  return matches.sort();\n}\n","import path from \"node:path\";\nimport type { Config } from \"../config/schema.js\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { isFile } from \"../utils/fs.js\";\nimport { toPosix } from \"../utils/paths.js\";\n\nexport const MAIN_FLOW = \"main.yaml\";\n\n/**\n * Validate the suite against the discovered flow set and the configured execute\n * mode.\n *\n * - explicit mode: every `run.execute` path must exist in the discovered flows.\n * - main mode: a `main.yaml` must exist at the suite root.\n *\n * `discovered` paths are forward-slash relative to the suite root; execute paths\n * supplied by users are normalized so Windows-style separators still match.\n */\nexport async function validateSuite(\n  config: Config,\n  discovered: string[],\n  cwd: string = process.cwd(),\n): Promise<void> {\n  const { run, suite } = config;\n\n  if (run.executeMode === \"main\") {\n    const mainPath = path.resolve(cwd, suite.root, MAIN_FLOW);\n    if (!(await isFile(mainPath))) {\n      throw new MaestroStackError(\n        `executeMode is \"main\" but ${MAIN_FLOW} was not found in suite.root (${suite.root}).`,\n        [`Add a ${MAIN_FLOW} or switch to executeMode: explicit with a run.execute list.`],\n      );\n    }\n    return;\n  }\n\n  // explicit mode\n  if (run.execute && run.execute.length > 0) {\n    const available = new Set(discovered.map(toPosix));\n    const missing = run.execute\n      .map(toPosix)\n      .filter((p) => !available.has(p));\n\n    if (missing.length > 0) {\n      throw new MaestroStackError(\n        \"Configured execute file(s) do not exist in the packaged suite:\",\n        missing.map((p) => `- ${p}`),\n      );\n    }\n  }\n}\n","import path from \"node:path\";\nimport { loadConfig } from \"../config/loadConfig.js\";\nimport type { Config } from \"../config/schema.js\";\nimport { uploadApp } from \"../browserstack/uploadApp.js\";\nimport { uploadSuite } from \"../browserstack/uploadSuite.js\";\nimport { buildPath, buildPayload, startBuild } from \"../browserstack/startBuild.js\";\nimport { createZip } from \"../suite/createZip.js\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { toPosix } from \"../utils/paths.js\";\nimport { validateAll, type GlobalOptions } from \"./validate.js\";\n\nexport interface RunOptions extends GlobalOptions {\n  dryRun?: boolean;\n  /** Temporary device override(s); replaces run.devices. */\n  device?: string[];\n  /** Temporary execute override(s); replaces run.execute (forces explicit mode). */\n  execute?: string[];\n}\n\nconst APP_PLACEHOLDER = \"<resolved after upload>\";\nconst SUITE_PLACEHOLDER = \"<resolved after upload>\";\n\n/** Apply CLI overrides for devices / execute onto a loaded config. */\nexport function applyOverrides(config: Config, opts: RunOptions): Config {\n  let run = config.run;\n  if (opts.device && opts.device.length > 0) {\n    run = { ...run, devices: opts.device };\n  }\n  if (opts.execute && opts.execute.length > 0) {\n    run = { ...run, execute: opts.execute.map(toPosix), executeMode: \"explicit\" };\n  }\n  return { ...config, run };\n}\n\nexport async function runCommand(opts: RunOptions): Promise<void> {\n  const cwd = process.cwd();\n  const loaded = await loadConfig(opts.config, cwd);\n  const config = applyOverrides(loaded.config, opts);\n\n  // Validate with overrides applied.\n  const { flows } = await validateAll({ ...loaded, config }, cwd);\n\n  if (opts.dryRun) {\n    printDryRun(config, flows, cwd);\n    return;\n  }\n\n  // 1. Package the suite.\n  const { zipPath } = await createZip({\n    files: flows,\n    suiteRoot: config.suite.root,\n    packageName: config.suite.packageName,\n    cwd,\n  });\n  logger.debug(`Created suite zip: ${zipPath}`);\n\n  // 2. Resolve the app (upload local binary or use an existing bs:// url).\n  const appUrl = await resolveApp(config, cwd);\n  logger.debug(`Resolved app: ${appUrl}`);\n\n  // 3. Upload the suite.\n  logger.info(`Uploading test suite (${flows.length} flow(s)) ...`);\n  const suiteResult = await uploadSuite({\n    auth: config.auth,\n    zipPath,\n    customId: config.suite.customId,\n  });\n\n  // 4. Trigger the build.\n  const payload = buildPayload(config, {\n    app: appUrl,\n    testSuite: suiteResult.test_suite_url,\n  });\n  logger.info(`Starting ${config.platform} build ...`);\n  const build = await startBuild({ auth: config.auth, platform: config.platform, payload });\n\n  printSummary(config, appUrl, suiteResult.test_suite_url, build.build_id);\n}\n\nasync function resolveApp(config: Config, cwd: string): Promise<string> {\n  const { app } = config;\n  if (app.source === \"app_url\") {\n    return app.appUrl;\n  }\n  if (app.source === \"upload\") {\n    logger.info(`Uploading app: ${app.path} ...`);\n    const result = await uploadApp({\n      auth: config.auth,\n      filePath: path.resolve(cwd, app.path),\n      customId: app.customId,\n    });\n    return result.app_url;\n  }\n  throw new MaestroStackError(`Unsupported app.source: ${app.source}`);\n}\n\nfunction previewApp(config: Config): string {\n  const { app } = config;\n  return app.source === \"app_url\" ? app.appUrl : APP_PLACEHOLDER;\n}\n\nfunction printDryRun(config: Config, flows: string[], cwd: string): void {\n  logger.info(\"Dry run only. No API calls made.\");\n  logger.info(\"\");\n  logger.info(\"Would package:\");\n  for (const flow of flows) {\n    logger.info(`- ${flow}`);\n  }\n  logger.info(\"\");\n\n  const { app } = config;\n  if (app.source === \"upload\") {\n    logger.info(`Would upload app:\\n${app.path}`);\n  } else if (app.source === \"app_url\") {\n    logger.info(`Would use app:\\n${app.appUrl}`);\n  }\n  logger.info(\"\");\n\n  logger.info(`Would call:\\nPOST ${buildPath(config.platform)}`);\n  logger.info(\"\");\n\n  const payload = buildPayload(config, {\n    app: previewApp(config),\n    testSuite: SUITE_PLACEHOLDER,\n  });\n  logger.info(\"Payload:\");\n  logger.info(JSON.stringify(payload, null, 2));\n}\n\nfunction printSummary(\n  config: Config,\n  appUrl: string,\n  testSuiteUrl: string,\n  buildId: string,\n): void {\n  logger.info(\"\");\n  logger.info(\"MaestroStack run started\");\n  logger.info(\"\");\n  logger.info(`Project: ${config.run.project}`);\n  logger.info(`Platform: ${config.platform}`);\n  logger.info(\"Devices:\");\n  for (const device of config.run.devices) {\n    logger.info(`- ${device}`);\n  }\n  logger.info(\"\");\n  logger.info(`App: ${appUrl}`);\n  logger.info(`Test suite: ${testSuiteUrl}`);\n  logger.info(`Build ID: ${buildId}`);\n}\n","import { openAsBlob } from \"node:fs\";\nimport path from \"node:path\";\nimport { FormData } from \"undici\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { isFile } from \"../utils/fs.js\";\nimport { bsRequest, type BsAuth } from \"./client.js\";\n\nexport interface UploadAppResult {\n  app_url: string;\n  custom_id?: string;\n  expiry?: string;\n  app_name?: string;\n}\n\n/**\n * Upload a local app binary (.apk / .ipa) to BrowserStack.\n * POST /app-automate/maestro/v2/app  (multipart: file, optional custom_id)\n */\nexport async function uploadApp(options: {\n  auth: BsAuth;\n  filePath: string;\n  customId?: string;\n}): Promise<UploadAppResult> {\n  if (!(await isFile(options.filePath))) {\n    throw new MaestroStackError(`app.path does not exist: ${options.filePath}`);\n  }\n\n  const form = new FormData();\n  const blob = await openAsBlob(options.filePath);\n  form.set(\"file\", blob, path.basename(options.filePath));\n  if (options.customId) {\n    form.set(\"custom_id\", options.customId);\n  }\n\n  return bsRequest<UploadAppResult>({\n    path: \"/app-automate/maestro/v2/app\",\n    method: \"POST\",\n    auth: options.auth,\n    rawBody: form,\n  });\n}\n","import { fetch, type BodyInit } from \"undici\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { logger } from \"../utils/logger.js\";\n\nexport const BASE_URL = \"https://api-cloud.browserstack.com\";\n\nexport interface BsAuth {\n  username: string;\n  accessKey: string;\n}\n\n/** Build an HTTP Basic auth header from BrowserStack credentials. */\nexport function authHeader(auth: BsAuth): string {\n  const token = Buffer.from(`${auth.username}:${auth.accessKey}`).toString(\"base64\");\n  return `Basic ${token}`;\n}\n\ninterface RequestOptions {\n  path: string;\n  method: \"GET\" | \"POST\";\n  auth: BsAuth;\n  /** JSON body - serialized and sent with application/json. */\n  jsonBody?: unknown;\n  /** Raw body (e.g. multipart FormData). undici sets the content-type. */\n  rawBody?: BodyInit;\n}\n\n/**\n * Perform a request against the BrowserStack API with Basic auth, returning the\n * parsed JSON. Non-2xx responses become a {@link MaestroStackError} carrying the\n * status and any server message - credentials are never logged.\n */\nexport async function bsRequest<T>(options: RequestOptions): Promise<T> {\n  const url = `${BASE_URL}${options.path}`;\n  const headers: Record<string, string> = {\n    authorization: authHeader(options.auth),\n  };\n\n  let body: BodyInit | undefined;\n  if (options.jsonBody !== undefined) {\n    headers[\"content-type\"] = \"application/json\";\n    body = JSON.stringify(options.jsonBody);\n  } else if (options.rawBody !== undefined) {\n    body = options.rawBody;\n  }\n\n  logger.debug(`${options.method} ${url}`);\n\n  let response: Awaited<ReturnType<typeof fetch>>;\n  try {\n    response = await fetch(url, { method: options.method, headers, body });\n  } catch (err) {\n    const reason = err instanceof Error ? err.message : String(err);\n    throw new MaestroStackError(`Failed to reach BrowserStack: ${reason}`);\n  }\n\n  const text = await response.text();\n  let data: unknown = {};\n  if (text) {\n    try {\n      data = JSON.parse(text);\n    } catch {\n      data = { raw: text };\n    }\n  }\n\n  if (!response.ok) {\n    const message = extractErrorMessage(data) ?? response.statusText;\n    throw new MaestroStackError(`BrowserStack API error (${response.status}): ${message}`);\n  }\n\n  return data as T;\n}\n\nfunction extractErrorMessage(data: unknown): string | undefined {\n  if (data && typeof data === \"object\") {\n    const obj = data as Record<string, unknown>;\n    for (const key of [\"message\", \"error\", \"errors\"]) {\n      const value = obj[key];\n      if (typeof value === \"string\" && value.length > 0) return value;\n    }\n  }\n  return undefined;\n}\n","import { openAsBlob } from \"node:fs\";\nimport path from \"node:path\";\nimport { FormData } from \"undici\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { isFile } from \"../utils/fs.js\";\nimport { bsRequest, type BsAuth } from \"./client.js\";\n\nexport interface UploadSuiteResult {\n  test_suite_url: string;\n  custom_id?: string;\n  expiry?: string;\n  test_suite_name?: string;\n  framework?: string;\n}\n\n/**\n * Upload a zipped Maestro test suite to BrowserStack.\n * POST /app-automate/maestro/v2/test-suite  (multipart: file, optional custom_id)\n */\nexport async function uploadSuite(options: {\n  auth: BsAuth;\n  zipPath: string;\n  customId?: string;\n}): Promise<UploadSuiteResult> {\n  if (!(await isFile(options.zipPath))) {\n    throw new MaestroStackError(`Suite zip does not exist: ${options.zipPath}`);\n  }\n\n  const form = new FormData();\n  const blob = await openAsBlob(options.zipPath);\n  form.set(\"file\", blob, path.basename(options.zipPath));\n  if (options.customId) {\n    form.set(\"custom_id\", options.customId);\n  }\n\n  return bsRequest<UploadSuiteResult>({\n    path: \"/app-automate/maestro/v2/test-suite\",\n    method: \"POST\",\n    auth: options.auth,\n    rawBody: form,\n  });\n}\n","import type { Config, Platform } from \"../config/schema.js\";\nimport { bsRequest, type BsAuth } from \"./client.js\";\n\nexport interface BuildPayload {\n  app: string;\n  testSuite: string;\n  project: string;\n  devices: string[];\n  execute?: string[];\n  networkLogs?: boolean;\n  deviceLogs?: boolean;\n}\n\nexport interface StartBuildResult {\n  message?: string;\n  build_id: string;\n}\n\n/** Build endpoint path for the given platform. */\nexport function buildPath(platform: Platform): string {\n  return `/app-automate/maestro/v2/${platform}/build`;\n}\n\n/**\n * Construct the BrowserStack build payload from config and the resolved app /\n * test-suite references. Pure and side-effect free so it can be unit-tested and\n * reused for the `--dry-run` preview.\n *\n * - `execute` is included only in explicit mode (in main mode BrowserStack runs\n *   the suite's main.yaml).\n * - `networkLogs` / `deviceLogs` are JSON booleans, included only when set.\n */\nexport function buildPayload(\n  config: Config,\n  resolved: { app: string; testSuite: string },\n): BuildPayload {\n  const { run } = config;\n  const payload: BuildPayload = {\n    app: resolved.app,\n    testSuite: resolved.testSuite,\n    project: run.project,\n    devices: run.devices,\n  };\n\n  if (run.executeMode === \"explicit\" && run.execute && run.execute.length > 0) {\n    payload.execute = run.execute;\n  }\n\n  if (run.options.networkLogs !== undefined) {\n    payload.networkLogs = run.options.networkLogs;\n  }\n  if (run.options.deviceLogs !== undefined) {\n    payload.deviceLogs = run.options.deviceLogs;\n  }\n\n  return payload;\n}\n\n/** Trigger a Maestro build and return the BrowserStack build id. */\nexport async function startBuild(options: {\n  auth: BsAuth;\n  platform: Platform;\n  payload: BuildPayload;\n}): Promise<StartBuildResult> {\n  return bsRequest<StartBuildResult>({\n    path: buildPath(options.platform),\n    method: \"POST\",\n    auth: options.auth,\n    jsonBody: options.payload,\n  });\n}\n","import path from \"node:path\";\nimport { loadConfig } from \"../config/loadConfig.js\";\nimport { uploadApp } from \"../browserstack/uploadApp.js\";\nimport { MaestroStackError } from \"../utils/errors.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { validateApp, type GlobalOptions } from \"./validate.js\";\n\n/**\n * Upload only the app and print the resulting BrowserStack app_url. Only valid\n * for app.source: upload.\n */\nexport async function uploadAppCommand(opts: GlobalOptions): Promise<void> {\n  const cwd = process.cwd();\n  const { config } = await loadConfig(opts.config, cwd);\n  await validateApp(config, cwd);\n\n  if (config.app.source !== \"upload\") {\n    throw new MaestroStackError(\n      `upload-app requires app.source \"upload\" (current: \"${config.app.source}\").`,\n    );\n  }\n\n  const filePath = path.resolve(cwd, config.app.path);\n  logger.info(`Uploading app: ${config.app.path} ...`);\n\n  const result = await uploadApp({\n    auth: config.auth,\n    filePath,\n    customId: config.app.customId,\n  });\n\n  logger.info(\"Uploaded app:\");\n  logger.info(`app_url: ${result.app_url}`);\n  if (result.custom_id) logger.info(`custom_id: ${result.custom_id}`);\n  if (result.expiry) logger.info(`expires: ${result.expiry}`);\n}\n","import { loadConfig } from \"../config/loadConfig.js\";\nimport { uploadSuite } from \"../browserstack/uploadSuite.js\";\nimport { createZip } from \"../suite/createZip.js\";\nimport { logger } from \"../utils/logger.js\";\nimport { validateAll, type GlobalOptions } from \"./validate.js\";\n\n/** Package and upload only the Maestro suite, printing the test_suite_url. */\nexport async function uploadSuiteCommand(opts: GlobalOptions): Promise<void> {\n  const cwd = process.cwd();\n  const loaded = await loadConfig(opts.config, cwd);\n  const { config } = loaded;\n  const { flows } = await validateAll(loaded, cwd);\n\n  const { zipPath } = await createZip({\n    files: flows,\n    suiteRoot: config.suite.root,\n    packageName: config.suite.packageName,\n    cwd,\n  });\n\n  logger.info(`Uploading test suite (${flows.length} flow(s)) ...`);\n\n  const result = await uploadSuite({\n    auth: config.auth,\n    zipPath,\n    customId: config.suite.customId,\n  });\n\n  logger.info(\"Uploaded test suite:\");\n  logger.info(`test_suite_url: ${result.test_suite_url}`);\n  if (result.custom_id) logger.info(`custom_id: ${result.custom_id}`);\n  if (result.expiry) logger.info(`expires: ${result.expiry}`);\n}\n"],"mappings":"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","names":["path","path","path","path","path","path","path","path","path","path","path","path","path","path","path","path","path","path","openAsBlob","path","FormData","FormData","openAsBlob","path","path","path","path"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "maestrostack",
+  "version": "0.1.0",
+  "description": "Config-driven CLI for running Maestro mobile tests on BrowserStack App Automate.",
+  "keywords": [
+    "maestro",
+    "browserstack",
+    "app-automate",
+    "mobile-testing",
+    "cli",
+    "android",
+    "ios"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "maestrostack": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5",
+    "fast-glob": "^3.3.2",
+    "undici": "^6.21.0",
+    "yaml": "^2.6.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/archiver": "^6.0.3",
+    "@types/node": "^22.10.5",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3",
+    "unzipper": "^0.12.3",
+    "vitest": "^2.1.8"
+  }
+}