build-raptor 0.131.0 → 0.133.0

package/dist/deps/brand/brand.d.ts

@@ -0,0 +1,5 @@
+declare const Trademark: unique symbol;
+export type Brand<BaseType, Name> = BaseType & {
+    [Trademark]: Name;
+};
+export {};

package/dist/deps/brand/brand.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJhbmQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYnJhbmQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/deps/brand/index.d.ts

@@ -0,0 +1 @@
+export * from './brand';

package/dist/deps/brand/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./brand"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDBDQUF1QiJ9

package/dist/deps/build-failed-error/build-failed-error.d.ts

@@ -0,0 +1,14 @@
+type HintType = 
+/**
+ * Failure while running a build task (including, for instance, test tasks)
+ */
+'task'
+/**
+ * Failure while running a program (due to `build-raptor run` command)
+ */
+ | 'program';
+export declare class BuildFailedError extends Error {
+    readonly hint: HintType;
+    constructor(m: string, hint?: HintType);
+}
+export {};

package/dist/deps/build-failed-error/build-failed-error.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildFailedError = void 0;
+class BuildFailedError extends Error {
+    constructor(m, hint = 'task') {
+        super(m);
+        this.hint = hint;
+        // Set the prototype explicitly.
+        Object.setPrototypeOf(this, BuildFailedError.prototype);
+    }
+}
+exports.BuildFailedError = BuildFailedError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQtZmFpbGVkLWVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2J1aWxkLWZhaWxlZC1lcnJvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFVQSxNQUFhLGdCQUFpQixTQUFRLEtBQUs7SUFDekMsWUFBWSxDQUFTLEVBQVcsT0FBaUIsTUFBTTtRQUNyRCxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUE7UUFEc0IsU0FBSSxHQUFKLElBQUksQ0FBbUI7UUFHckQsZ0NBQWdDO1FBQ2hDLE1BQU0sQ0FBQyxjQUFjLENBQUMsSUFBSSxFQUFFLGdCQUFnQixDQUFDLFNBQVMsQ0FBQyxDQUFBO0lBQ3pELENBQUM7Q0FDRjtBQVBELDRDQU9DIn0=

package/dist/deps/build-failed-error/index.d.ts

@@ -0,0 +1 @@
+export * from './build-failed-error';

package/dist/deps/build-failed-error/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./build-failed-error"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHVEQUFvQyJ9

package/dist/deps/build-raptor-api/build-raptor-api.d.ts

@@ -0,0 +1,351 @@
+import { z } from 'zod';
+/**
+ * Represents a union of possible build step types, discriminated by the 'step' field.
+ * Each step type contains specific information about different phases of the build process.
+ */
+export declare const Step: z.ZodDiscriminatedUnion<"step", [z.ZodObject<{
+    step: z.ZodLiteral<"BUILD_RUN_STARTED">;
+    buildRunId: z.ZodString;
+    commitHash: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    step: "BUILD_RUN_STARTED";
+    buildRunId: string;
+    commitHash?: string | undefined;
+}, {
+    step: "BUILD_RUN_STARTED";
+    buildRunId: string;
+    commitHash?: string | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"BUILD_RUN_ENDED">;
+}, "strip", z.ZodTypeAny, {
+    step: "BUILD_RUN_ENDED";
+}, {
+    step: "BUILD_RUN_ENDED";
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TASK_STORE_PUT">;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    taskName: z.ZodString;
+    unitId: z.ZodString;
+    taskKind: z.ZodString;
+    blobId: z.ZodString;
+    files: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    step: "TASK_STORE_PUT";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}, {
+    step: "TASK_STORE_PUT";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TASK_STORE_GET">;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    taskName: z.ZodString;
+    unitId: z.ZodString;
+    taskKind: z.ZodString;
+    blobId: z.ZodString;
+    files: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    step: "TASK_STORE_GET";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}, {
+    step: "TASK_STORE_GET";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TEST_ENDED">;
+    taskName: z.ZodString;
+    fileName: z.ZodString;
+    testPath: z.ZodArray<z.ZodString, "many">;
+    durationMillis: z.ZodUnion<[z.ZodNumber, z.ZodUndefined]>;
+    verdict: z.ZodUnion<[z.ZodLiteral<"TEST_PASSED">, z.ZodLiteral<"TEST_FAILED">, z.ZodLiteral<"TEST_CRASHED">, z.ZodLiteral<"TEST_TIMEDOUT">]>;
+}, "strip", z.ZodTypeAny, {
+    step: "TEST_ENDED";
+    taskName: string;
+    fileName: string;
+    testPath: string[];
+    verdict: "TEST_PASSED" | "TEST_FAILED" | "TEST_CRASHED" | "TEST_TIMEDOUT";
+    durationMillis?: number | undefined;
+}, {
+    step: "TEST_ENDED";
+    taskName: string;
+    fileName: string;
+    testPath: string[];
+    verdict: "TEST_PASSED" | "TEST_FAILED" | "TEST_CRASHED" | "TEST_TIMEDOUT";
+    durationMillis?: number | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TASK_ENDED">;
+    /** The fully qualified name of the task (e.g., 'my-module:build') */
+    taskName: z.ZodString;
+    /** The final verdict that represents whether the task succeeded or failed */
+    verdict: z.ZodUnion<[z.ZodLiteral<"OK">, z.ZodLiteral<"FAIL">, z.ZodLiteral<"CRASH">, z.ZodLiteral<"UNKNOWN">]>;
+    /** Indicates how the task was processed during the build run */
+    executionType: z.ZodUnion<[z.ZodLiteral<"EXECUTED">, z.ZodLiteral<"CACHED">, z.ZodLiteral<"CANNOT_START">, z.ZodLiteral<"UNKNOWN">]>;
+    /** Duration of the task execution in milliseconds (optional for backwards compatibility) */
+    durationMillis: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    step: "TASK_ENDED";
+    taskName: string;
+    verdict: "OK" | "FAIL" | "CRASH" | "UNKNOWN";
+    executionType: "UNKNOWN" | "EXECUTED" | "CACHED" | "CANNOT_START";
+    durationMillis?: number | undefined;
+}, {
+    step: "TASK_ENDED";
+    taskName: string;
+    verdict: "OK" | "FAIL" | "CRASH" | "UNKNOWN";
+    executionType: "UNKNOWN" | "EXECUTED" | "CACHED" | "CANNOT_START";
+    durationMillis?: number | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"ASSET_PUBLISHED">;
+    labels: z.ZodArray<z.ZodString, "many">;
+    taskName: z.ZodString;
+    unitId: z.ZodString;
+    taskKind: z.ZodUnknown;
+    fingerprint: z.ZodString;
+    casAddress: z.ZodString;
+    file: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    step: "ASSET_PUBLISHED";
+    fingerprint: string;
+    taskName: string;
+    unitId: string;
+    labels: string[];
+    casAddress: string;
+    file: string;
+    taskKind?: unknown;
+}, {
+    step: "ASSET_PUBLISHED";
+    fingerprint: string;
+    taskName: string;
+    unitId: string;
+    labels: string[];
+    casAddress: string;
+    file: string;
+    taskKind?: unknown;
+}>, z.ZodObject<{
+    /**
+     * Indicates the planning phase is complete. This step occurs once per build, before task execution begins.
+     */
+    step: z.ZodLiteral<"PLAN_PREPARED">;
+    /**
+     * List of all task names within the current build scope. The scope is determined by the goals or labels provided to build-raptor.
+     * This list:
+     * - Includes tasks that may be skipped due to caching
+     * - Excludes tasks from modules not included in this build scope.
+     */
+    taskNames: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    step: "PLAN_PREPARED";
+    taskNames: string[];
+}, {
+    step: "PLAN_PREPARED";
+    taskNames: string[];
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"PUBLIC_FILES">;
+    taskName: z.ZodString;
+    /**
+     * Maps path-in-repo (of "public output" files) to the hash of the content of the file.
+     */
+    publicFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    step: "PUBLIC_FILES";
+    taskName: string;
+    publicFiles: Record<string, string>;
+}, {
+    step: "PUBLIC_FILES";
+    taskName: string;
+    publicFiles: Record<string, string>;
+}>]>;
+export type Step = z.infer<typeof Step>;
+export type StepName = Step['step'];
+export type StepByName<N extends StepName> = Extract<Step, {
+    step: N;
+}>;
+export declare const StepByStep: z.ZodArray<z.ZodDiscriminatedUnion<"step", [z.ZodObject<{
+    step: z.ZodLiteral<"BUILD_RUN_STARTED">;
+    buildRunId: z.ZodString;
+    commitHash: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    step: "BUILD_RUN_STARTED";
+    buildRunId: string;
+    commitHash?: string | undefined;
+}, {
+    step: "BUILD_RUN_STARTED";
+    buildRunId: string;
+    commitHash?: string | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"BUILD_RUN_ENDED">;
+}, "strip", z.ZodTypeAny, {
+    step: "BUILD_RUN_ENDED";
+}, {
+    step: "BUILD_RUN_ENDED";
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TASK_STORE_PUT">;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    taskName: z.ZodString;
+    unitId: z.ZodString;
+    taskKind: z.ZodString;
+    blobId: z.ZodString;
+    files: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    step: "TASK_STORE_PUT";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}, {
+    step: "TASK_STORE_PUT";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TASK_STORE_GET">;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    taskName: z.ZodString;
+    unitId: z.ZodString;
+    taskKind: z.ZodString;
+    blobId: z.ZodString;
+    files: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    step: "TASK_STORE_GET";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}, {
+    step: "TASK_STORE_GET";
+    taskName: string;
+    unitId: string;
+    taskKind: string;
+    blobId: string;
+    files: string[];
+    fingerprint?: string | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TEST_ENDED">;
+    taskName: z.ZodString;
+    fileName: z.ZodString;
+    testPath: z.ZodArray<z.ZodString, "many">;
+    durationMillis: z.ZodUnion<[z.ZodNumber, z.ZodUndefined]>;
+    verdict: z.ZodUnion<[z.ZodLiteral<"TEST_PASSED">, z.ZodLiteral<"TEST_FAILED">, z.ZodLiteral<"TEST_CRASHED">, z.ZodLiteral<"TEST_TIMEDOUT">]>;
+}, "strip", z.ZodTypeAny, {
+    step: "TEST_ENDED";
+    taskName: string;
+    fileName: string;
+    testPath: string[];
+    verdict: "TEST_PASSED" | "TEST_FAILED" | "TEST_CRASHED" | "TEST_TIMEDOUT";
+    durationMillis?: number | undefined;
+}, {
+    step: "TEST_ENDED";
+    taskName: string;
+    fileName: string;
+    testPath: string[];
+    verdict: "TEST_PASSED" | "TEST_FAILED" | "TEST_CRASHED" | "TEST_TIMEDOUT";
+    durationMillis?: number | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"TASK_ENDED">;
+    /** The fully qualified name of the task (e.g., 'my-module:build') */
+    taskName: z.ZodString;
+    /** The final verdict that represents whether the task succeeded or failed */
+    verdict: z.ZodUnion<[z.ZodLiteral<"OK">, z.ZodLiteral<"FAIL">, z.ZodLiteral<"CRASH">, z.ZodLiteral<"UNKNOWN">]>;
+    /** Indicates how the task was processed during the build run */
+    executionType: z.ZodUnion<[z.ZodLiteral<"EXECUTED">, z.ZodLiteral<"CACHED">, z.ZodLiteral<"CANNOT_START">, z.ZodLiteral<"UNKNOWN">]>;
+    /** Duration of the task execution in milliseconds (optional for backwards compatibility) */
+    durationMillis: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    step: "TASK_ENDED";
+    taskName: string;
+    verdict: "OK" | "FAIL" | "CRASH" | "UNKNOWN";
+    executionType: "UNKNOWN" | "EXECUTED" | "CACHED" | "CANNOT_START";
+    durationMillis?: number | undefined;
+}, {
+    step: "TASK_ENDED";
+    taskName: string;
+    verdict: "OK" | "FAIL" | "CRASH" | "UNKNOWN";
+    executionType: "UNKNOWN" | "EXECUTED" | "CACHED" | "CANNOT_START";
+    durationMillis?: number | undefined;
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"ASSET_PUBLISHED">;
+    labels: z.ZodArray<z.ZodString, "many">;
+    taskName: z.ZodString;
+    unitId: z.ZodString;
+    taskKind: z.ZodUnknown;
+    fingerprint: z.ZodString;
+    casAddress: z.ZodString;
+    file: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    step: "ASSET_PUBLISHED";
+    fingerprint: string;
+    taskName: string;
+    unitId: string;
+    labels: string[];
+    casAddress: string;
+    file: string;
+    taskKind?: unknown;
+}, {
+    step: "ASSET_PUBLISHED";
+    fingerprint: string;
+    taskName: string;
+    unitId: string;
+    labels: string[];
+    casAddress: string;
+    file: string;
+    taskKind?: unknown;
+}>, z.ZodObject<{
+    /**
+     * Indicates the planning phase is complete. This step occurs once per build, before task execution begins.
+     */
+    step: z.ZodLiteral<"PLAN_PREPARED">;
+    /**
+     * List of all task names within the current build scope. The scope is determined by the goals or labels provided to build-raptor.
+     * This list:
+     * - Includes tasks that may be skipped due to caching
+     * - Excludes tasks from modules not included in this build scope.
+     */
+    taskNames: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    step: "PLAN_PREPARED";
+    taskNames: string[];
+}, {
+    step: "PLAN_PREPARED";
+    taskNames: string[];
+}>, z.ZodObject<{
+    step: z.ZodLiteral<"PUBLIC_FILES">;
+    taskName: z.ZodString;
+    /**
+     * Maps path-in-repo (of "public output" files) to the hash of the content of the file.
+     */
+    publicFiles: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    step: "PUBLIC_FILES";
+    taskName: string;
+    publicFiles: Record<string, string>;
+}, {
+    step: "PUBLIC_FILES";
+    taskName: string;
+    publicFiles: Record<string, string>;
+}>]>, "many">;
+export type StepByStep = z.infer<typeof StepByStep>;

package/dist/deps/build-raptor-api/build-raptor-api.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepByStep = exports.Step = void 0;
+const zod_1 = require("zod");
+/**
+ * Represents a union of possible build step types, discriminated by the 'step' field.
+ * Each step type contains specific information about different phases of the build process.
+ */
+exports.Step = zod_1.z.discriminatedUnion('step', [
+    zod_1.z.object({
+        step: zod_1.z.literal('BUILD_RUN_STARTED'),
+        buildRunId: zod_1.z.string(),
+        commitHash: zod_1.z.string().optional(),
+    }),
+    zod_1.z.object({
+        step: zod_1.z.literal('BUILD_RUN_ENDED'),
+    }),
+    zod_1.z.object({
+        step: zod_1.z.literal('TASK_STORE_PUT'),
+        fingerprint: zod_1.z.string().optional(),
+        taskName: zod_1.z.string(),
+        unitId: zod_1.z.string(),
+        taskKind: zod_1.z.string(),
+        blobId: zod_1.z.string(),
+        files: zod_1.z.string().array(),
+    }),
+    zod_1.z.object({
+        step: zod_1.z.literal('TASK_STORE_GET'),
+        fingerprint: zod_1.z.string().optional(),
+        taskName: zod_1.z.string(),
+        unitId: zod_1.z.string(),
+        taskKind: zod_1.z.string(),
+        blobId: zod_1.z.string(),
+        files: zod_1.z.string().array(),
+    }),
+    zod_1.z.object({
+        step: zod_1.z.literal('TEST_ENDED'),
+        taskName: zod_1.z.string(),
+        fileName: zod_1.z.string(),
+        testPath: zod_1.z.string().array(),
+        durationMillis: zod_1.z.number().or(zod_1.z.undefined()),
+        verdict: zod_1.z.union([
+            zod_1.z.literal('TEST_PASSED'),
+            zod_1.z.literal('TEST_FAILED'),
+            zod_1.z.literal('TEST_CRASHED'),
+            zod_1.z.literal('TEST_TIMEDOUT'),
+        ]),
+    }),
+    /**
+     * Indicates the completion of a build task. This step is emitted when a task either completes execution or is
+     * determined to be skippable due to caching.
+     *
+     * @example
+     * // Example of a successfully executed task
+     * {
+     *   step: 'TASK_ENDED',
+     *   taskName: 'webapp:build',
+     *   verdict: 'OK',
+     *   executionType: 'EXECUTED'
+     * }
+     *
+     * // Example of a skipped task due to cache hit
+     * {
+     *   step: 'TASK_ENDED',
+     *   taskName: 'webapp:test',
+     *   verdict: 'OK',
+     *   executionType: 'CACHED'
+     * }
+     */
+    zod_1.z.object({
+        step: zod_1.z.literal('TASK_ENDED'),
+        /** The fully qualified name of the task (e.g., 'my-module:build') */
+        taskName: zod_1.z.string(),
+        /** The final verdict that represents whether the task succeeded or failed */
+        verdict: zod_1.z.union([
+            /** Task executed and completed successfully */
+            zod_1.z.literal('OK'),
+            /** Task executed but failed with an error code */
+            zod_1.z.literal('FAIL'),
+            /** Task execution terminated unexpectedly (e.g., ran out of memory) */
+            zod_1.z.literal('CRASH'),
+            /** Task verdict is indeterminate due to an unexpected failure of the build system */
+            zod_1.z.literal('UNKNOWN'),
+        ]),
+        /** Indicates how the task was processed during the build run */
+        executionType: zod_1.z.union([
+            /** Task was executed in this build run */
+            zod_1.z.literal('EXECUTED'),
+            /** Task outputs were retrieved from cache without execution */
+            zod_1.z.literal('CACHED'),
+            /** Task could not be started (typically due to a 'FAIL' verdict in a dependency task) */
+            zod_1.z.literal('CANNOT_START'),
+            /** Execution type is indeterminate due to an unexpected failure of the build system */
+            zod_1.z.literal('UNKNOWN'),
+        ]),
+        /** Duration of the task execution in milliseconds (optional for backwards compatibility) */
+        durationMillis: zod_1.z.number().optional(),
+    }),
+    zod_1.z.object({
+        step: zod_1.z.literal('ASSET_PUBLISHED'),
+        labels: zod_1.z.string().array(),
+        taskName: zod_1.z.string(),
+        unitId: zod_1.z.string(),
+        taskKind: zod_1.z.unknown(),
+        fingerprint: zod_1.z.string(),
+        casAddress: zod_1.z.string(),
+        file: zod_1.z.string(),
+    }),
+    zod_1.z.object({
+        /**
+         * Indicates the planning phase is complete. This step occurs once per build, before task execution begins.
+         */
+        step: zod_1.z.literal('PLAN_PREPARED'),
+        /**
+         * List of all task names within the current build scope. The scope is determined by the goals or labels provided to build-raptor.
+         * This list:
+         * - Includes tasks that may be skipped due to caching
+         * - Excludes tasks from modules not included in this build scope.
+         */
+        taskNames: zod_1.z.string().array(),
+    }),
+    zod_1.z.object({
+        step: zod_1.z.literal('PUBLIC_FILES'),
+        taskName: zod_1.z.string(),
+        /**
+         * Maps path-in-repo (of "public output" files) to the hash of the content of the file.
+         */
+        publicFiles: zod_1.z.record(zod_1.z.string(), zod_1.z.string()),
+    }),
+]);
+exports.StepByStep = exports.Step.array();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQtcmFwdG9yLWFwaS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9idWlsZC1yYXB0b3ItYXBpLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZCQUF1QjtBQUV2Qjs7O0dBR0c7QUFDVSxRQUFBLElBQUksR0FBRyxPQUFDLENBQUMsa0JBQWtCLENBQUMsTUFBTSxFQUFFO0lBQy9DLE9BQUMsQ0FBQyxNQUFNLENBQUM7UUFDUCxJQUFJLEVBQUUsT0FBQyxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsQ0FBQztRQUNwQyxVQUFVLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRTtRQUN0QixVQUFVLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRTtLQUNsQyxDQUFDO0lBQ0YsT0FBQyxDQUFDLE1BQU0sQ0FBQztRQUNQLElBQUksRUFBRSxPQUFDLENBQUMsT0FBTyxDQUFDLGlCQUFpQixDQUFDO0tBQ25DLENBQUM7SUFDRixPQUFDLENBQUMsTUFBTSxDQUFDO1FBQ1AsSUFBSSxFQUFFLE9BQUMsQ0FBQyxPQUFPLENBQUMsZ0JBQWdCLENBQUM7UUFDakMsV0FBVyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7UUFDbEMsUUFBUSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUU7UUFDcEIsTUFBTSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUU7UUFDbEIsUUFBUSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUU7UUFDcEIsTUFBTSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUU7UUFDbEIsS0FBSyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxLQUFLLEVBQUU7S0FDMUIsQ0FBQztJQUNGLE9BQUMsQ0FBQyxNQUFNLENBQUM7UUFDUCxJQUFJLEVBQUUsT0FBQyxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQztRQUNqQyxXQUFXLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFD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

package/dist/deps/build-raptor-api/index.d.ts

@@ -0,0 +1,2 @@
+export * from './build-raptor-api';
+export * from './step-by-step-processor';

package/dist/deps/build-raptor-api/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./build-raptor-api"), exports);
+__exportStar(require("./step-by-step-processor"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHFEQUFrQztBQUNsQywyREFBd0MifQ==

package/dist/deps/build-raptor-api/step-by-step-processor.d.ts

@@ -0,0 +1,35 @@
+import { Step } from './build-raptor-api';
+/**
+ * StepByStepProcessor is a function type for processing build steps in real-time.
+ * Each step's details are passed to your processor as it occurs during the build.
+ *
+ * To use with build-raptor:
+ * 1. Create a file that imports the necessary types from 'build-raptor-api'
+ * 2. Implement and export a function called `processor` matching the `StepByStepProcessor` type
+ * 3. The function can be async or sync and should handle the `Step` object according to your needs
+ *
+ * ## Example Implementation (my-step-processor.ts)
+ * ```typescript
+ * import { Step, StepByStepProcessor } from 'build-raptor-api'
+ *
+ * export const processor: StepByStepProcessor = async (step: Step) => {
+ *   // Log step details
+ *   console.log(`Step "${step.name}" status: ${step.status}`)
+ *
+ *   // Send metrics to monitoring system
+ *   await sendMetrics({
+ *     stepName: step.name,
+ *     duration: step.duration,
+ *     status: step.status
+ *   })
+ * }
+ * ```
+ *
+ * ## Usage
+ * To make build-raptor use your own processor:
+ *
+ * ```bash
+ * build-raptor --step-by-step-processor ./path/to/my-step-processor.js
+ * ```
+ */
+export type StepByStepProcessor = (step: Step) => void | Promise<void>;

package/dist/deps/build-raptor-api/step-by-step-processor.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1ieS1zdGVwLXByb2Nlc3Nvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdGVwLWJ5LXN0ZXAtcHJvY2Vzc29yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist/deps/build-raptor-core/breakdown.d.ts

@@ -0,0 +1,18 @@
+import { BuildRunId } from 'build-run-id';
+import { PerformanceReport } from './performance-report';
+import { TaskSummary } from './task-summary';
+export declare class Breakdown {
+    readonly overallVerdict: 'OK' | 'FAIL' | 'CRASH';
+    readonly buildRunId: BuildRunId;
+    private readonly summaries;
+    private readonly rootDir;
+    readonly performanceReport?: PerformanceReport | undefined;
+    readonly crashCause?: unknown | undefined;
+    readonly message?: string | undefined;
+    constructor(overallVerdict: 'OK' | 'FAIL' | 'CRASH', buildRunId: BuildRunId, summaries: TaskSummary[], rootDir: string, performanceReport?: PerformanceReport | undefined, crashCause?: unknown | undefined, message?: string | undefined);
+    get exitCode(): number;
+    getSummaries(): readonly TaskSummary[];
+    outputOf(taskKind: string, unitId: string, format: 'string'): Promise<string>;
+    outputOf(taskKind: string, unitId: string, format?: 'lines'): Promise<string[]>;
+    readLines(relativePath: string): Promise<string[] | undefined>;
+}