@argos-ci/core 4.1.6 → 4.2.1-alpha.4

package/dist/index.d.ts

@@ -1,123 +1,133 @@
-import * as _argos_ci_util from '@argos-ci/util';
 import { ArgosAPISchema } from '@argos-ci/api-client';
+import { ScreenshotMetadata } from '@argos-ci/util';
 
-type BuildMetadata = ArgosAPISchema.components["schemas"]["BuildMetadata"];
-interface UploadParameters {
+interface Config {
     /**
-     * Globs matching image file paths to upload
+     * Base URL of the Argos API.
+     * Use this to target a self-hosted installation.
+     * @default "https://api.argos-ci.com/v2/"
      */
-    files?: string[];
+    apiBaseUrl: string;
     /**
-     * Root directory to look for image to upload
-     * @default process.cwd()
+     * Git commit SHA.
      */
-    root?: string;
+    commit: string;
     /**
-     * Globs matching image file paths to ignore
-     * @default ["**\/*.\{png,jpg,jpeg\}"]
+     * Git branch name of the build.
+     * @example "main", "develop", "release/1.0"
      */
-    ignore?: string[];
+    branch: string;
     /**
-     * Base URL of Argos API
-     * @default "https://api.argos-ci.com/v2/"
+     * Argos repository access token.
      */
-    apiBaseUrl?: string;
+    token: string | null;
     /**
-     * Git commit
+     * Custom build name.
+     * Useful for multi-build setups on the same commit.
      */
-    commit?: string;
+    buildName: string | null;
     /**
-     * Git branch
+     * Whether this build is split across multiple parallel jobs.
+     * @default false
      */
-    branch?: string;
+    parallel: boolean;
     /**
-     * Argos repository token
+     * Unique identifier shared by all parallel jobs.
      */
-    token?: string;
+    parallelNonce: string | null;
     /**
-     * Pull-request number
+     * Index of the current parallel job.
+     * Must be between 1 and `parallelTotal`, or null if not set.
      */
-    prNumber?: number;
+    parallelIndex: number | null;
     /**
-     * Name of the build used to trigger multiple Argos builds on one commit
+     * Total number of parallel jobs.
+     * Use -1 if unknown, or null if not set.
      */
-    buildName?: string;
+    parallelTotal: number | null;
     /**
-     * Mode of comparison applied
-     * @default "ci"
+     * Git branch used as the baseline for screenshot comparison.
      */
-    mode?: "ci" | "monitoring";
+    referenceBranch: string | null;
     /**
-     Parallel test suite mode
+     * Git commit SHA used as the baseline for screenshot comparison.
      */
-    parallel?: {
-        /** Unique build ID for this parallel build */
-        nonce: string;
-        /** The number of parallel nodes being ran */
-        total: number;
-        /** The index of the parallel node */
-        index?: number;
-    } | false;
+    referenceCommit: string | null;
     /**
-     * Branch used as baseline for screenshot comparison
+     * Repository slug of the source repository.
+     * Example: "my-org/my-repo" or "my-user/my-repo".
+     * If from a fork, this refers to the fork repository.
      */
-    referenceBranch?: string;
+    repository: string | null;
     /**
-     * Commit used as baseline for screenshot comparison
+     * Repository slug of the original (base) repository.
+     * Example: "my-org/my-repo" or "my-user/my-repo".
+     * If from a fork, this refers to the base repository.
      */
-    referenceCommit?: string;
+    originalRepository: string | null;
     /**
-     * Sensitivity threshold between 0 and 1.
-     * The higher the threshold, the less sensitive the diff will be.
-     * @default 0.5
+     * CI job identifier (if provided by the CI environment).
      */
-    threshold?: number;
+    jobId: string | null;
     /**
-     * Build metadata.
+     * CI run identifier (if provided by the CI environment).
      */
-    metadata?: BuildMetadata;
+    runId: string | null;
     /**
-     * Preview URL configuration.
-     * Accepts a base URL or a function that receives the URL and returns the preview URL.
+     * CI run attempt number (if provided by the CI environment).
      */
-    previewUrl?: {
-        baseUrl: string;
-    } | ((url: string) => string);
+    runAttempt: number | null;
+    /**
+     * Pull request number associated with the build.
+     */
+    prNumber: number | null;
+    /**
+     * Pull request head commit SHA (if available).
+     */
+    prHeadCommit: string | null;
+    /**
+     * Pull request base branch (if available).
+     */
+    prBaseBranch: string | null;
+    /**
+     * Build mode to use.
+     * - "ci": Review visual changes introduced by a feature branch and prevent regressions.
+     * - "monitoring": Track visual changes outside the standard CI flow, either on a schedule or before a release.
+     * @see https://argos-ci.com/docs/build-modes
+     */
+    mode: "ci" | "monitoring" | null;
+    /**
+     * Name of the detected CI provider (if available).
+     * @example "github-actions", "gitlab-ci", "circleci"
+     */
+    ciProvider: string | null;
+    /**
+     * Diff sensitivity threshold between 0 and 1.
+     * Higher values make Argos less sensitive to differences.
+     */
+    threshold: number | null;
+    /**
+     * Base URL to use for preview links.
+     * @example "https://my-preview.example.com"
+     */
+    previewBaseUrl: string | null;
+    /**
+     * Skip this build.
+     * No screenshots are uploaded, and the commit status is marked as success.
+     */
+    skipped?: boolean;
 }
-/**
- * Upload screenshots to Argos.
- */
-declare function upload(params: UploadParameters): Promise<{
-    build: {
-        id: ArgosAPISchema.components["schemas"]["BuildId"];
-        number: number;
-        status: ("accepted" | "rejected") | ("no-changes" | "changes-detected") | ("expired" | "pending" | "progress" | "error" | "aborted");
-        url: string;
-        notification: {
-            description: string;
-            context: string;
-            github: {
-                state: "pending" | "success" | "error" | "failure";
-            };
-            gitlab: {
-                state: "pending" | "running" | "success" | "failed" | "canceled";
-            };
-        } | null;
-    };
-    screenshots: {
-        hash: string;
-        optimizedPath: string;
-        metadata: _argos_ci_util.ScreenshotMetadata | null;
-        threshold: number | null;
-        baseName: string | null;
-        pwTrace: {
-            path: string;
-            hash: string;
-        } | null;
-        name: string;
-        path: string;
-    }[];
-}>;
+declare function readConfig(options?: Partial<Config>): Promise<Config>;
+declare function getConfigFromOptions({ parallel, ...options }: Omit<Partial<Config>, "parallel"> & {
+    parallel?: {
+        /** Unique build ID for this parallel build */
+        nonce: string;
+        /** The number of parallel nodes being ran */
+        total: number;
+        /** The index of the parallel node */
+        index?: number;
+    } | false | undefined;
+}): Promise<Config>;
 
 interface components {
     schemas: {
@@ -136,6 +146,11 @@ interface components {
             name: string;
             baseName?: string | null;
             metadata?: {
+                /**
+                 * @description Ignored. Can be set to get completions, validations and documentation in some editors.
+                 * @example https://api.argos-ci.com/v2/screenshot-metadata.json
+                 */
+                $schema?: string;
                 /** @description The URL of the page that was screenshotted */
                 url?: string | null;
                 /** @description An URL to an accessible preview of the screenshot */
@@ -292,102 +307,118 @@ declare function finalize(params: FinalizeParameters): Promise<{
     builds: components["schemas"]["Build"][];
 }>;
 
-interface Config {
-    /**
-     * Argos API base URL (for self-hosted installations)
-     */
-    apiBaseUrl: string;
-    /**
-     * The commit SHA1 (40 characters)
-     */
-    commit: string;
-    /**
-     * The git branch name (e.g. "main", "master", "develop", "release/1.0" etc.)
-     */
-    branch: string;
-    /**
-     * The Argos repository token (40 characters)
-     */
-    token: string | null;
-    /**
-     * The name of the build (for multi-build setups)
-     */
-    buildName: string | null;
+type BuildMetadata = ArgosAPISchema.components["schemas"]["BuildMetadata"];
+interface UploadParameters {
     /**
-     * Whether the current run is parallelized (split in multiple jobs) or not
+     * Globs that match image file paths to upload.
      */
-    parallel: boolean;
+    files?: string[];
     /**
-     * The parallelization nonce (identifier shared by all parallel jobs)
+     * Root directory used to resolve image paths.
+     * @default process.cwd()
      */
-    parallelNonce: string | null;
+    root?: string;
     /**
-     * The index of the current job (between 1 and parallelTotal inclusive, or null if not set)
+     * Globs that match image file paths to exclude from upload.
+     * @default ["**\/*.{png,jpg,jpeg}"]
      */
-    parallelIndex: number | null;
+    ignore?: string[];
     /**
-     * The total number of parallel jobs (or -1 if unknown, or null if not set)
+     * Base URL of the Argos API.
+     * @default "https://api.argos-ci.com/v2/"
      */
-    parallelTotal: number | null;
+    apiBaseUrl?: string;
     /**
-     * The reference git branch to compare against
+     * Git commit SHA of the build.
      */
-    referenceBranch: string | null;
+    commit?: string;
     /**
-     * The reference commit SHA1 to compare against
+     * Git branch name of the build.
      */
-    referenceCommit: string | null;
+    branch?: string;
     /**
-     * The git repository slug (e.g. "my-org/my-repo" or "my-user/my-repo")
-     * If from a fork, this is the fork's repository.
+     * Argos repository access token.
      */
-    repository: string | null;
+    token?: string;
     /**
-     * The original git repository slug (e.g. "my-org/my-repo" or "my-user/my-repo")
-     * If from a fork, this is the base repository.
+     * Pull request number associated with the build.
      */
-    originalRepository: string | null;
+    prNumber?: number;
     /**
-     * The CI job identifier (if available)
+     * Custom build name. Useful when triggering multiple Argos builds
+     * for the same commit.
      */
-    jobId: string | null;
+    buildName?: string;
     /**
-     * The CI run identifier (if available)
+     * Build mode to use.
+     * - "ci": Review the visual changes introduced by a feature branch and prevent regressions.
+     * - "monitoring": Track visual changes outside the standard CI flow, either on a schedule or before a release.
+     * @see https://argos-ci.com/docs/build-modes
+     * @default "ci"
      */
-    runId: string | null;
+    mode?: "ci" | "monitoring";
     /**
-     * The CI run attempt (if available)
+     * Parallel test suite configuration.
+     * @default false
      */
-    runAttempt: number | null;
+    parallel?: {
+        /** Unique build identifier shared across parallel jobs. */
+        nonce: string;
+        /** Total number of parallel jobs, set to -1 to finalize manually. */
+        total: number;
+        /** Index of the current job (must start from 1). */
+        index?: number;
+    } | false;
     /**
-     * The pull request number (if available)
+     * Branch used as the baseline for screenshot comparison.
      */
-    prNumber: number | null;
+    referenceBranch?: string;
     /**
-     * The pull request head commit SHA1 (if available)
+     * Commit SHA used as the baseline for screenshot comparison.
      */
-    prHeadCommit: string | null;
+    referenceCommit?: string;
     /**
-     * The pull request base branch (if available)
+     * Diff sensitivity threshold between 0 and 1.
+     * Higher values make Argos less sensitive to differences.
+     * @default 0.5
      */
-    prBaseBranch: string | null;
+    threshold?: number;
     /**
-     * The mode Argos is running in (ci or monitoring)
+     * Additional build metadata.
      */
-    mode: "ci" | "monitoring" | null;
+    metadata?: BuildMetadata;
     /**
-     * The CI provider name (if detected)
+     * Preview URL configuration.
+     * Can be a fixed base URL or a function to transform URLs dynamically.
      */
-    ciProvider: string | null;
+    previewUrl?: {
+        baseUrl: string;
+    } | ((url: string) => string);
     /**
-     * The threshold to use for this run (if any, between 0 and 1 inclusive, e.g. 0.1 for 10% or 0.0 for 0%)
+     * Mark this build as skipped.
+     * No screenshots are uploaded, and the commit status is marked as success.
      */
+    skipped?: boolean;
+}
+interface Screenshot {
+    hash: string;
+    optimizedPath: string;
+    metadata: ScreenshotMetadata | null;
     threshold: number | null;
-    /**
-     * The base URL to use for preview links (if any)
-     */
-    previewBaseUrl: string | null;
+    baseName: string | null;
+    pwTrace: {
+        path: string;
+        hash: string;
+    } | null;
+    name: string;
+    path: string;
 }
-declare function readConfig(options?: Partial<Config>): Promise<Config>;
+/**
+ * Upload screenshots to Argos.
+ */
+declare function upload(params: UploadParameters): Promise<{
+    build: ArgosAPISchema.components["schemas"]["Build"];
+    screenshots: Screenshot[];
+}>;
 
-export { type Config, type FinalizeParameters, type UploadParameters, finalize, readConfig, upload };
+export { type Config, type FinalizeParameters, type UploadParameters, finalize, getConfigFromOptions, readConfig, upload };

package/dist/index.js

@@ -1,6 +1,3 @@
-// src/upload.ts
-import { createClient, throwAPIError } from "@argos-ci/api-client";
-
 // src/config.ts
 import convict from "convict";
 
@@ -344,6 +341,30 @@ function getPullRequestFromPayload(payload) {
   }
   return null;
 }
+function getVercelDeploymentPayload(payload) {
+  if (!payload) {
+    return null;
+  }
+  if (process.env.GITHUB_EVENT_NAME !== "repository_dispatch") {
+    return null;
+  }
+  if (!("client_payload" in payload) || !("action" in payload)) {
+    return null;
+  }
+  if (payload.action !== "vercel.deployment.success") {
+    return null;
+  }
+  return payload;
+}
+function getSha(context, vercelPayload) {
+  if (vercelPayload) {
+    return vercelPayload.client_payload.git.sha;
+  }
+  if (!context.env.GITHUB_SHA) {
+    throw new Error(`GITHUB_SHA is missing`);
+  }
+  return context.env.GITHUB_SHA;
+}
 var service4 = {
   name: "GitHub Actions",
   key: "github-actions",
@@ -351,10 +372,8 @@ var service4 = {
   config: async (context) => {
     const { env } = context;
     const payload = readEventPayload(context);
-    const sha = process.env.GITHUB_SHA || null;
-    if (!sha) {
-      throw new Error(`GITHUB_SHA is missing`);
-    }
+    const vercelPayload = getVercelDeploymentPayload(payload);
+    const sha = getSha(context, vercelPayload);
     const pullRequest = payload ? getPullRequestFromPayload(payload) : await getPullRequestFromHeadSha(context, sha);
     return {
       commit: sha,
@@ -364,7 +383,7 @@ var service4 = {
       runId: env.GITHUB_RUN_ID || null,
       runAttempt: env.GITHUB_RUN_ATTEMPT ? Number(env.GITHUB_RUN_ATTEMPT) : null,
       nonce: `${env.GITHUB_RUN_ID}-${env.GITHUB_RUN_ATTEMPT}`,
-      branch: getBranchFromContext(context) || pullRequest?.head.ref || (payload ? getBranchFromPayload(payload) : null) || null,
+      branch: vercelPayload?.client_payload?.git?.ref || getBranchFromContext(context) || pullRequest?.head.ref || (payload ? getBranchFromPayload(payload) : null) || null,
       prNumber: pullRequest?.number || null,
       prHeadCommit: pullRequest?.head.sha ?? null,
       prBaseBranch: pullRequest?.base.ref ?? null
@@ -775,6 +794,11 @@ var schema = {
     format: String,
     default: null,
     nullable: true
+  },
+  skipped: {
+    env: "ARGOS_SKIPPED",
+    format: Boolean,
+    default: false
   }
 };
 function createConfig() {
@@ -815,7 +839,8 @@ async function readConfig(options = {}) {
     parallelIndex: options.parallelIndex ?? defaultConfig.parallelIndex ?? null,
     mode: options.mode || defaultConfig.mode || null,
     ciProvider: ciEnv?.key || null,
-    previewBaseUrl: defaultConfig.previewBaseUrl || null
+    previewBaseUrl: defaultConfig.previewBaseUrl || null,
+    skipped: options.skipped ?? defaultConfig.skipped ?? false
   });
   if (!config.get("branch") || !config.get("commit")) {
     throw new Error(
@@ -825,6 +850,83 @@ async function readConfig(options = {}) {
   config.validate();
   return config.get();
 }
+async function getConfigFromOptions({
+  parallel,
+  ...options
+}) {
+  return readConfig({
+    ...options,
+    parallel: parallel !== void 0 ? Boolean(parallel) : void 0,
+    parallelNonce: parallel ? parallel.nonce : void 0,
+    parallelTotal: parallel ? parallel.total : void 0,
+    parallelIndex: parallel ? parallel.index : void 0
+  });
+}
+
+// src/finalize.ts
+import { createClient, throwAPIError } from "@argos-ci/api-client";
+
+// src/auth.ts
+var base64Encode = (obj) => Buffer.from(JSON.stringify(obj), "utf8").toString("base64");
+function getAuthToken(args) {
+  const {
+    token,
+    ciProvider,
+    originalRepository: repository,
+    jobId,
+    runId,
+    prNumber
+  } = args;
+  if (token) {
+    return token;
+  }
+  switch (ciProvider) {
+    case "github-actions": {
+      if (!repository || !jobId || !runId) {
+        throw new Error(
+          `Automatic GitHub Actions variables detection failed. Please add the 'ARGOS_TOKEN'`
+        );
+      }
+      const [owner, repo] = repository.split("/");
+      return `tokenless-github-${base64Encode({
+        owner,
+        repository: repo,
+        jobId,
+        runId,
+        prNumber: prNumber ?? void 0
+      })}`;
+    }
+    default:
+      throw new Error("Missing Argos repository token 'ARGOS_TOKEN'");
+  }
+}
+
+// src/finalize.ts
+async function finalize(params) {
+  const config = await readConfig({
+    parallelNonce: params.parallel?.nonce
+  });
+  const authToken = getAuthToken(config);
+  const apiClient = createClient({
+    baseUrl: config.apiBaseUrl,
+    authToken
+  });
+  if (!config.parallelNonce) {
+    throw new Error("parallel.nonce is required to finalize the build");
+  }
+  const finalizeBuildsResult = await apiClient.POST("/builds/finalize", {
+    body: {
+      parallelNonce: config.parallelNonce
+    }
+  });
+  if (finalizeBuildsResult.error) {
+    throwAPIError(finalizeBuildsResult.error);
+  }
+  return finalizeBuildsResult.data;
+}
+
+// src/upload.ts
+import { createClient as createClient2, throwAPIError as throwAPIError2 } from "@argos-ci/api-client";
 
 // src/discovery.ts
 import { resolve } from "path";
@@ -925,41 +1027,6 @@ var hashFile = async (filepath) => {
   return hash.digest("hex");
 };
 
-// src/auth.ts
-var base64Encode = (obj) => Buffer.from(JSON.stringify(obj), "utf8").toString("base64");
-function getAuthToken(args) {
-  const {
-    token,
-    ciProvider,
-    originalRepository: repository,
-    jobId,
-    runId,
-    prNumber
-  } = args;
-  if (token) {
-    return token;
-  }
-  switch (ciProvider) {
-    case "github-actions": {
-      if (!repository || !jobId || !runId) {
-        throw new Error(
-          `Automatic GitHub Actions variables detection failed. Please add the 'ARGOS_TOKEN'`
-        );
-      }
-      const [owner, repo] = repository.split("/");
-      return `tokenless-github-${base64Encode({
-        owner,
-        repository: repo,
-        jobId,
-        runId,
-        prNumber: prNumber ?? void 0
-      })}`;
-    }
-    default:
-      throw new Error("Missing Argos repository token 'ARGOS_TOKEN'");
-  }
-}
-
 // src/s3.ts
 import { readFile } from "fs/promises";
 async function uploadFile(input) {
@@ -992,7 +1059,10 @@ var chunk = (collection, size) => {
 };
 
 // src/upload.ts
-import { getPlaywrightTracePath, readMetadata } from "@argos-ci/util";
+import {
+  getPlaywrightTracePath,
+  readMetadata
+} from "@argos-ci/util";
 
 // src/version.ts
 import { readVersionFromPackage } from "@argos-ci/util";
@@ -1006,66 +1076,48 @@ async function getArgosCoreSDKIdentifier() {
 
 // src/upload.ts
 var CHUNK_SIZE = 10;
-async function getConfigFromOptions({
-  parallel,
-  ...options
-}) {
-  return readConfig({
-    ...options,
-    parallel: parallel !== void 0 ? Boolean(parallel) : void 0,
-    parallelNonce: parallel ? parallel.nonce : void 0,
-    parallelTotal: parallel ? parallel.total : void 0,
-    parallelIndex: parallel ? parallel.index : void 0
-  });
-}
-async function uploadFilesToS3(files) {
-  debug(`Split files in chunks of ${CHUNK_SIZE}`);
-  const chunks = chunk(files, CHUNK_SIZE);
-  debug(`Starting upload of ${chunks.length} chunks`);
-  for (let i = 0; i < chunks.length; i++) {
-    debug(`Uploading chunk ${i + 1}/${chunks.length}`);
-    const timeLabel = `Chunk ${i + 1}/${chunks.length}`;
-    debugTime(timeLabel);
-    const chunk2 = chunks[i];
-    if (!chunk2) {
-      throw new Error(`Invariant: chunk ${i} is empty`);
-    }
-    await Promise.all(
-      chunk2.map(async ({ url, path, contentType }) => {
-        await uploadFile({
-          url,
-          path,
-          contentType
-        });
-      })
-    );
-    debugTimeEnd(timeLabel);
-  }
-}
-function formatPreviewUrl(url, formatter) {
-  if (typeof formatter === "function") {
-    return formatter(url);
-  }
-  const urlObj = new URL(url);
-  return new URL(
-    urlObj.pathname + urlObj.search + urlObj.hash,
-    formatter.baseUrl
-  ).href;
-}
 async function upload(params) {
   debug("Starting upload with params", params);
   const [config, argosSdk] = await Promise.all([
     getConfigFromOptions(params),
     getArgosCoreSDKIdentifier()
   ]);
-  const previewUrlFormatter = params.previewUrl ?? (config.previewBaseUrl ? { baseUrl: config.previewBaseUrl } : void 0);
-  const files = params.files ?? ["**/*.{png,jpg,jpeg}"];
-  debug("Using config and files", config, files);
   const authToken = getAuthToken(config);
-  const apiClient = createClient({
+  const apiClient = createClient2({
     baseUrl: config.apiBaseUrl,
     authToken
   });
+  if (config.skipped) {
+    const createBuildResponse2 = await apiClient.POST("/builds", {
+      body: {
+        commit: config.commit,
+        branch: config.branch,
+        name: config.buildName,
+        mode: config.mode,
+        parallel: config.parallel,
+        parallelNonce: config.parallelNonce,
+        prNumber: config.prNumber,
+        prHeadCommit: config.prHeadCommit,
+        referenceBranch: config.referenceBranch,
+        referenceCommit: config.referenceCommit,
+        argosSdk,
+        ciProvider: config.ciProvider,
+        runId: config.runId,
+        runAttempt: config.runAttempt,
+        skipped: true,
+        screenshotKeys: [],
+        pwTraceKeys: [],
+        parentCommits: []
+      }
+    });
+    if (createBuildResponse2.error) {
+      throwAPIError2(createBuildResponse2.error);
+    }
+    return { build: createBuildResponse2.data.build, screenshots: [] };
+  }
+  const previewUrlFormatter = params.previewUrl ?? (config.previewBaseUrl ? { baseUrl: config.previewBaseUrl } : void 0);
+  const files = params.files ?? ["**/*.{png,jpg,jpeg}"];
+  debug("Using config and files", config, files);
   const foundScreenshots = await discoverScreenshots(files, {
     root: params.root,
     ignore: params.ignore
@@ -1107,7 +1159,7 @@ async function upload(params) {
   debug("Fetch project");
   const projectResponse = await apiClient.GET("/project");
   if (projectResponse.error) {
-    throwAPIError(projectResponse.error);
+    throwAPIError2(projectResponse.error);
   }
   debug("Project fetched", projectResponse.data);
   const { defaultBaseBranch, hasRemoteContentAccess } = projectResponse.data;
@@ -1178,7 +1230,7 @@ async function upload(params) {
     }
   });
   if (createBuildResponse.error) {
-    throwAPIError(createBuildResponse.error);
+    throwAPIError2(createBuildResponse.error);
   }
   const result = createBuildResponse.data;
   debug("Got uploads url", result);
@@ -1232,37 +1284,47 @@ async function upload(params) {
     }
   });
   if (uploadBuildResponse.error) {
-    throwAPIError(uploadBuildResponse.error);
+    throwAPIError2(uploadBuildResponse.error);
   }
   return { build: uploadBuildResponse.data.build, screenshots };
 }
-
-// src/finalize.ts
-import { createClient as createClient2, throwAPIError as throwAPIError2 } from "@argos-ci/api-client";
-async function finalize(params) {
-  const config = await readConfig({
-    parallelNonce: params.parallel?.nonce
-  });
-  const authToken = getAuthToken(config);
-  const apiClient = createClient2({
-    baseUrl: config.apiBaseUrl,
-    authToken
-  });
-  if (!config.parallelNonce) {
-    throw new Error("parallel.nonce is required to finalize the build");
-  }
-  const finalizeBuildsResult = await apiClient.POST("/builds/finalize", {
-    body: {
-      parallelNonce: config.parallelNonce
+async function uploadFilesToS3(files) {
+  debug(`Split files in chunks of ${CHUNK_SIZE}`);
+  const chunks = chunk(files, CHUNK_SIZE);
+  debug(`Starting upload of ${chunks.length} chunks`);
+  for (let i = 0; i < chunks.length; i++) {
+    debug(`Uploading chunk ${i + 1}/${chunks.length}`);
+    const timeLabel = `Chunk ${i + 1}/${chunks.length}`;
+    debugTime(timeLabel);
+    const chunk2 = chunks[i];
+    if (!chunk2) {
+      throw new Error(`Invariant: chunk ${i} is empty`);
     }
-  });
-  if (finalizeBuildsResult.error) {
-    throwAPIError2(finalizeBuildsResult.error);
+    await Promise.all(
+      chunk2.map(async ({ url, path, contentType }) => {
+        await uploadFile({
+          url,
+          path,
+          contentType
+        });
+      })
+    );
+    debugTimeEnd(timeLabel);
   }
-  return finalizeBuildsResult.data;
+}
+function formatPreviewUrl(url, formatter) {
+  if (typeof formatter === "function") {
+    return formatter(url);
+  }
+  const urlObj = new URL(url);
+  return new URL(
+    urlObj.pathname + urlObj.search + urlObj.hash,
+    formatter.baseUrl
+  ).href;
 }
 export {
   finalize,
+  getConfigFromOptions,
   readConfig,
   upload
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@argos-ci/core",
   "description": "Node.js SDK for visual testing with Argos.",
-  "version": "4.1.6",
+  "version": "4.2.1-alpha.4+d1894ac",
   "type": "module",
   "main": "./dist/index.cjs",
   "exports": {
@@ -40,8 +40,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@argos-ci/api-client": "0.11.1",
-    "@argos-ci/util": "3.1.0",
+    "@argos-ci/api-client": "0.12.1-alpha.4+d1894ac",
+    "@argos-ci/util": "3.1.2-alpha.4+d1894ac",
     "convict": "^6.2.4",
     "debug": "^4.4.3",
     "fast-glob": "^3.3.3",
@@ -53,6 +53,7 @@
     "@types/convict": "^6.1.6",
     "@types/debug": "^4.1.12",
     "@types/tmp": "^0.2.6",
+    "@vercel/repository-dispatch": "^0.1.0",
     "msw": "^2.11.3",
     "vitest": "catalog:"
   },
@@ -64,5 +65,5 @@
     "lint": "eslint .",
     "test": "vitest"
   },
-  "gitHead": "00f28041a847158e437aaab5fc9e816f6b609021"
+  "gitHead": "d1894acc62fb886d4673c88cc7e8cc95e81db78b"
 }