@generacy-ai/generacy-plugin-cloud-build 0.0.0-preview-20260304013206

package/dist/operations/artifacts.js

@@ -0,0 +1,168 @@
+/**
+ * Artifact operations for the Cloud Build plugin.
+ *
+ * Handles:
+ * - Listing build artifacts
+ * - Downloading artifacts (Buffer mode for ≤100MB)
+ * - Streaming artifacts (ReadableStream for large files)
+ */
+import { MAX_ARTIFACT_SIZE_BYTES } from '../types/artifacts.js';
+import { NotFoundError, ValidationError, CloudBuildError } from '../errors.js';
+import { mapApiError } from '../client.js';
+export class ArtifactOperations {
+    cloudBuildClient;
+    storage;
+    config;
+    logger;
+    constructor(cloudBuildClient, storage, config, logger) {
+        this.cloudBuildClient = cloudBuildClient;
+        this.storage = storage;
+        this.config = config;
+        this.logger = logger;
+    }
+    /**
+     * List artifacts for a build.
+     */
+    async listArtifacts(buildId) {
+        this.logger.debug({ buildId }, 'Listing artifacts');
+        try {
+            // Get the build to find artifact information
+            const [build] = await this.cloudBuildClient.getBuild({
+                projectId: this.config.projectId,
+                id: buildId,
+            });
+            if (!build) {
+                throw new NotFoundError('Build', buildId);
+            }
+            // Get artifacts from build results and config
+            const artifacts = [];
+            // Check for object artifacts
+            const artifactConfig = build.artifacts?.objects;
+            if (artifactConfig?.location && artifactConfig?.paths) {
+                const bucketMatch = artifactConfig.location.match(/^gs:\/\/([^/]+)(?:\/(.*))?$/);
+                if (bucketMatch) {
+                    const bucketName = bucketMatch[1];
+                    const prefix = bucketMatch[2] || '';
+                    if (bucketName) {
+                        const bucket = this.storage.bucket(bucketName);
+                        for (const pathPattern of artifactConfig.paths) {
+                            const fullPrefix = prefix ? `${prefix}/${pathPattern.replace(/\*\*?/g, '')}` : pathPattern.replace(/\*\*?/g, '');
+                            const [files] = await bucket.getFiles({
+                                prefix: fullPrefix,
+                            });
+                            for (const file of files) {
+                                const [metadata] = await file.getMetadata();
+                                artifacts.push({
+                                    path: file.name,
+                                    bucket: bucketName,
+                                    size: parseInt(metadata.size) || 0,
+                                    contentType: metadata.contentType ?? undefined,
+                                    generation: metadata.generation?.toString(),
+                                    md5Hash: metadata.md5Hash ?? undefined,
+                                    crc32c: metadata.crc32c ?? undefined,
+                                    updated: new Date(metadata.updated),
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            // Also check explicit artifact bucket in config
+            if (this.config.artifactBucket) {
+                const bucket = this.storage.bucket(this.config.artifactBucket);
+                const buildPrefix = `builds/${buildId}/`;
+                const [files] = await bucket.getFiles({ prefix: buildPrefix });
+                for (const file of files) {
+                    // Avoid duplicates
+                    if (artifacts.some(a => a.path === file.name && a.bucket === this.config.artifactBucket)) {
+                        continue;
+                    }
+                    const [metadata] = await file.getMetadata();
+                    artifacts.push({
+                        path: file.name,
+                        bucket: this.config.artifactBucket,
+                        size: parseInt(metadata.size) || 0,
+                        contentType: metadata.contentType ?? undefined,
+                        generation: metadata.generation?.toString(),
+                        md5Hash: metadata.md5Hash ?? undefined,
+                        crc32c: metadata.crc32c ?? undefined,
+                        updated: new Date(metadata.updated),
+                    });
+                }
+            }
+            return artifacts;
+        }
+        catch (error) {
+            if (error instanceof NotFoundError || error instanceof CloudBuildError) {
+                throw error;
+            }
+            throw mapApiError(error, { buildId });
+        }
+    }
+    /**
+     * Download an artifact as a Buffer.
+     * Throws if artifact exceeds 100MB.
+     */
+    async getArtifact(buildId, path) {
+        this.logger.debug({ buildId, path }, 'Getting artifact');
+        // Find the artifact to get its metadata
+        const artifacts = await this.listArtifacts(buildId);
+        const artifact = artifacts.find(a => a.path === path || a.path.endsWith(`/${path}`));
+        if (!artifact) {
+            throw new NotFoundError('Artifact', path);
+        }
+        // Check size limit
+        if (artifact.size > MAX_ARTIFACT_SIZE_BYTES) {
+            throw new ValidationError(`Artifact size (${artifact.size} bytes) exceeds maximum of ${MAX_ARTIFACT_SIZE_BYTES} bytes. Use getArtifactStream() for large files.`, 'size');
+        }
+        try {
+            const bucket = this.storage.bucket(artifact.bucket);
+            const file = bucket.file(artifact.path);
+            const [contents] = await file.download();
+            return contents;
+        }
+        catch (error) {
+            throw mapApiError(error, { buildId, path });
+        }
+    }
+    /**
+     * Download an artifact as a ReadableStream.
+     * Use for large files that exceed the 100MB Buffer limit.
+     */
+    async getArtifactStream(buildId, path) {
+        this.logger.debug({ buildId, path }, 'Getting artifact stream');
+        // Find the artifact
+        const artifacts = await this.listArtifacts(buildId);
+        const artifact = artifacts.find(a => a.path === path || a.path.endsWith(`/${path}`));
+        if (!artifact) {
+            throw new NotFoundError('Artifact', path);
+        }
+        try {
+            const bucket = this.storage.bucket(artifact.bucket);
+            const file = bucket.file(artifact.path);
+            // Create a Node.js readable stream
+            const nodeStream = file.createReadStream();
+            // Convert Node.js stream to Web ReadableStream
+            return new ReadableStream({
+                start(controller) {
+                    nodeStream.on('data', (chunk) => {
+                        controller.enqueue(new Uint8Array(chunk));
+                    });
+                    nodeStream.on('end', () => {
+                        controller.close();
+                    });
+                    nodeStream.on('error', (error) => {
+                        controller.error(error);
+                    });
+                },
+                cancel() {
+                    nodeStream.destroy();
+                },
+            });
+        }
+        catch (error) {
+            throw mapApiError(error, { buildId, path });
+        }
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/operations/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/operations/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,OAAO,kBAAkB;IAEV;IACA;IACA;IACA;IAJnB,YACmB,gBAAkC,EAClC,OAAgB,EAChB,MAAwB,EACxB,MAAc;QAHd,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,YAAO,GAAP,OAAO,CAAS;QAChB,WAAM,GAAN,MAAM,CAAkB;QACxB,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAEpD,IAAI,CAAC;YACH,6CAA6C;YAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;gBACnD,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAChC,EAAE,EAAE,OAAO;aACZ,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;YAED,8CAA8C;YAC9C,MAAM,SAAS,GAAe,EAAE,CAAC;YAEjC,6BAA6B;YAC7B,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;YAChD,IAAI,cAAc,EAAE,QAAQ,IAAI,cAAc,EAAE,KAAK,EAAE,CAAC;gBACtD,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;gBACjF,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;oBAClC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAEpC,IAAI,UAAU,EAAE,CAAC;wBACf,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;wBAE/C,KAAK,MAAM,WAAW,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;4BAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;4BAEjH,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;gCACpC,MAAM,EAAE,UAAU;6BACnB,CAAC,CAAC;4BAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gCACzB,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gCAE5C,SAAS,CAAC,IAAI,CAAC;oCACb,IAAI,EAAE,IAAI,CAAC,IAAI;oCACf,MAAM,EAAE,UAAU;oCAClB,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAc,CAAC,IAAI,CAAC;oCAC5C,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,SAAS;oCAC9C,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE;oCAC3C,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,SAAS;oCACtC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,SAAS;oCACpC,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAiB,CAAC;iCAC9C,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,gDAAgD;YAChD,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;gBAC/D,MAAM,WAAW,GAAG,UAAU,OAAO,GAAG,CAAC;gBAEzC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;gBAE/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,mBAAmB;oBACnB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;wBACzF,SAAS;oBACX,CAAC;oBAED,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;oBAE5C,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;wBAClC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAc,CAAC,IAAI,CAAC;wBAC5C,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,SAAS;wBAC9C,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE;wBAC3C,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,SAAS;wBACtC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,SAAS;wBACpC,OAAO,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAiB,CAAC;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACvE,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAAY;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAEzD,wCAAwC;QACxC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAErF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,mBAAmB;QACnB,IAAI,QAAQ,CAAC,IAAI,GAAG,uBAAuB,EAAE,CAAC;YAC5C,MAAM,IAAI,eAAe,CACvB,kBAAkB,QAAQ,CAAC,IAAI,8BAA8B,uBAAuB,kDAAkD,EACtI,MAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAExC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,IAAY;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,yBAAyB,CAAC,CAAC;QAEhE,oBAAoB;QACpB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAErF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAExC,mCAAmC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE3C,+CAA+C;YAC/C,OAAO,IAAI,cAAc,CAAC;gBACxB,KAAK,CAAC,UAAU;oBACd,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;wBACtC,UAAU,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC5C,CAAC,CAAC,CAAC;oBAEH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;wBACxB,UAAU,CAAC,KAAK,EAAE,CAAC;oBACrB,CAAC,CAAC,CAAC;oBAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;wBACtC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC1B,CAAC,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM;oBACJ,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF"}

package/dist/operations/builds.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Build operations for the Cloud Build plugin.
+ *
+ * Handles:
+ * - Build triggering (triggerBuild, runBuild)
+ * - Build monitoring (getBuild, listBuilds)
+ * - Build lifecycle (cancelBuild, retryBuild)
+ */
+import type { CloudBuildClient } from '@google-cloud/cloudbuild';
+import type { Logger } from 'pino';
+import type { CloudBuildConfig } from '../config/types.js';
+import type { Build, BuildConfig, BuildFilter, BuildSource, PaginatedResult } from '../types/builds.js';
+export declare class BuildOperations {
+    private readonly client;
+    private readonly config;
+    private readonly logger;
+    constructor(client: CloudBuildClient, config: CloudBuildConfig, logger: Logger);
+    /**
+     * Trigger a build from an existing trigger.
+     */
+    triggerBuild(triggerId: string, source?: BuildSource): Promise<Build>;
+    /**
+     * Run a build from inline configuration.
+     */
+    runBuild(buildConfig: BuildConfig): Promise<Build>;
+    /**
+     * Get a single build by ID.
+     */
+    getBuild(buildId: string): Promise<Build>;
+    /**
+     * List builds with optional filtering.
+     */
+    listBuilds(filter?: BuildFilter): Promise<PaginatedResult<Build>>;
+    /**
+     * Cancel a running build.
+     */
+    cancelBuild(buildId: string): Promise<void>;
+    /**
+     * Retry a failed build.
+     */
+    retryBuild(buildId: string): Promise<Build>;
+    /**
+     * Execute operation with retry logic.
+     */
+    private withRetry;
+    /**
+     * Build filter string for API request.
+     */
+    private buildFilterString;
+    /**
+     * Map Google Cloud Build source to API request format.
+     */
+    private mapSourceToRequest;
+    /**
+     * Map Google Cloud Build to plugin Build type.
+     */
+    private mapBuild;
+    /**
+     * Map build status enum.
+     */
+    private mapStatus;
+    /**
+     * Map build step.
+     */
+    private mapStep;
+    /**
+     * Map build step status.
+     */
+    private mapStepStatus;
+    /**
+     * Map build results.
+     */
+    private mapResults;
+    /**
+     * Map source from API response.
+     */
+    private mapSource;
+    /**
+     * Map time span.
+     */
+    private mapTimeSpan;
+    /**
+     * Convert protobuf timestamp to Date.
+     */
+    private toDate;
+    /**
+     * Calculate build duration in seconds.
+     */
+    private calculateDuration;
+}
+//# sourceMappingURL=builds.d.ts.map

package/dist/operations/builds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builds.d.ts","sourceRoot":"","sources":["../../src/operations/builds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,WAAW,EACX,WAAW,EAKX,eAAe,EAGhB,MAAM,oBAAoB,CAAC;AAW5B,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM;IAGjC;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IA0B3E;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;IA+CxD;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAwB/C;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAwBvE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAkBjD;;OAEG;YACW,SAAS;IAUvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAuBhB;;OAEG;IACH,OAAO,CAAC,SAAS;IA6BjB;;OAEG;IACH,OAAO,CAAC,OAAO;IAkBf;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,SAAS;IAuBjB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,MAAM;IAQd;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/operations/builds.js

@@ -0,0 +1,397 @@
+/**
+ * Build operations for the Cloud Build plugin.
+ *
+ * Handles:
+ * - Build triggering (triggerBuild, runBuild)
+ * - Build monitoring (getBuild, listBuilds)
+ * - Build lifecycle (cancelBuild, retryBuild)
+ */
+import { NotFoundError, ValidationError } from '../errors.js';
+import { mapApiError } from '../client.js';
+import { withRetry, shouldRetryError } from '../utils/retry.js';
+export class BuildOperations {
+    client;
+    config;
+    logger;
+    constructor(client, config, logger) {
+        this.client = client;
+        this.config = config;
+        this.logger = logger;
+    }
+    /**
+     * Trigger a build from an existing trigger.
+     */
+    async triggerBuild(triggerId, source) {
+        this.logger.debug({ triggerId, source }, 'Triggering build');
+        try {
+            const [operation] = await this.withRetry(() => this.client.runBuildTrigger({
+                projectId: this.config.projectId,
+                triggerId,
+                source: source?.repoSource ? {
+                    projectId: source.repoSource.projectId,
+                    repoName: source.repoSource.repoName,
+                    branchName: source.repoSource.branchName,
+                    tagName: source.repoSource.tagName,
+                    commitSha: source.repoSource.commitSha,
+                    dir: source.repoSource.dir,
+                } : undefined,
+            }));
+            const [response] = await operation.promise();
+            return this.mapBuild(response);
+        }
+        catch (error) {
+            throw mapApiError(error, { triggerId });
+        }
+    }
+    /**
+     * Run a build from inline configuration.
+     */
+    async runBuild(buildConfig) {
+        if (!buildConfig.steps || buildConfig.steps.length === 0) {
+            throw new ValidationError('At least one build step is required', 'steps');
+        }
+        this.logger.debug({ stepCount: buildConfig.steps.length }, 'Running build');
+        try {
+            const [operation] = await this.withRetry(() => this.client.createBuild({
+                projectId: this.config.projectId,
+                build: {
+                    steps: buildConfig.steps.map(step => ({
+                        name: step.name,
+                        entrypoint: step.entrypoint,
+                        args: step.args,
+                        dir: step.dir,
+                        env: step.env,
+                        secretEnv: step.secretEnv,
+                        waitFor: step.waitFor,
+                        timeout: step.timeout ? { seconds: parseInt(step.timeout) } : undefined,
+                        script: step.script,
+                    })),
+                    source: buildConfig.source ? this.mapSourceToRequest(buildConfig.source) : undefined,
+                    timeout: buildConfig.timeout ? { seconds: parseInt(buildConfig.timeout) } : undefined,
+                    substitutions: buildConfig.substitutions,
+                    tags: buildConfig.tags,
+                    serviceAccount: buildConfig.serviceAccount,
+                    logsBucket: buildConfig.logsBucket,
+                    artifacts: buildConfig.artifacts ? {
+                        images: buildConfig.artifacts.images,
+                        objects: buildConfig.artifacts.objects ? {
+                            location: buildConfig.artifacts.objects.location,
+                            paths: buildConfig.artifacts.objects.paths,
+                        } : undefined,
+                    } : undefined,
+                },
+            }));
+            const [response] = await operation.promise();
+            return this.mapBuild(response);
+        }
+        catch (error) {
+            throw mapApiError(error);
+        }
+    }
+    /**
+     * Get a single build by ID.
+     */
+    async getBuild(buildId) {
+        this.logger.debug({ buildId }, 'Getting build');
+        try {
+            const [build] = await this.withRetry(() => this.client.getBuild({
+                projectId: this.config.projectId,
+                id: buildId,
+            }));
+            if (!build) {
+                throw new NotFoundError('Build', buildId);
+            }
+            return this.mapBuild(build);
+        }
+        catch (error) {
+            if (error instanceof NotFoundError) {
+                throw error;
+            }
+            throw mapApiError(error, { buildId });
+        }
+    }
+    /**
+     * List builds with optional filtering.
+     */
+    async listBuilds(filter) {
+        this.logger.debug({ filter }, 'Listing builds');
+        try {
+            const filterString = this.buildFilterString(filter);
+            const [builds, , response] = await this.withRetry(() => this.client.listBuilds({
+                projectId: this.config.projectId,
+                filter: filterString || undefined,
+                pageSize: filter?.pageSize ?? 50,
+                pageToken: filter?.pageToken,
+            }));
+            return {
+                items: builds.map(build => this.mapBuild(build)),
+                nextPageToken: response?.nextPageToken ?? undefined,
+            };
+        }
+        catch (error) {
+            throw mapApiError(error);
+        }
+    }
+    /**
+     * Cancel a running build.
+     */
+    async cancelBuild(buildId) {
+        this.logger.debug({ buildId }, 'Cancelling build');
+        try {
+            await this.withRetry(() => this.client.cancelBuild({
+                projectId: this.config.projectId,
+                id: buildId,
+            }));
+        }
+        catch (error) {
+            throw mapApiError(error, { buildId });
+        }
+    }
+    /**
+     * Retry a failed build.
+     */
+    async retryBuild(buildId) {
+        this.logger.debug({ buildId }, 'Retrying build');
+        try {
+            const [operation] = await this.withRetry(() => this.client.retryBuild({
+                projectId: this.config.projectId,
+                id: buildId,
+            }));
+            const [response] = await operation.promise();
+            return this.mapBuild(response);
+        }
+        catch (error) {
+            throw mapApiError(error, { buildId });
+        }
+    }
+    /**
+     * Execute operation with retry logic.
+     */
+    async withRetry(operation) {
+        return withRetry(operation, {
+            ...this.config.retry,
+            shouldRetry: shouldRetryError,
+            onRetry: (error, attempt, delayMs) => {
+                this.logger.warn({ error, attempt, delayMs }, 'Retrying operation');
+            },
+        });
+    }
+    /**
+     * Build filter string for API request.
+     */
+    buildFilterString(filter) {
+        if (!filter)
+            return '';
+        const parts = [];
+        if (filter.status) {
+            const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+            const statusFilter = statuses.map(s => `status="${s}"`).join(' OR ');
+            parts.push(`(${statusFilter})`);
+        }
+        if (filter.triggerId) {
+            parts.push(`build_trigger_id="${filter.triggerId}"`);
+        }
+        if (filter.startTime?.after) {
+            parts.push(`create_time>="${filter.startTime.after.toISOString()}"`);
+        }
+        if (filter.startTime?.before) {
+            parts.push(`create_time<="${filter.startTime.before.toISOString()}"`);
+        }
+        if (filter.tags && filter.tags.length > 0) {
+            const tagFilter = filter.tags.map(t => `tags="${t}"`).join(' OR ');
+            parts.push(`(${tagFilter})`);
+        }
+        return parts.join(' AND ');
+    }
+    /**
+     * Map Google Cloud Build source to API request format.
+     */
+    mapSourceToRequest(source) {
+        return {
+            storageSource: source.storageSource ? {
+                bucket: source.storageSource.bucket,
+                object: source.storageSource.object,
+                generation: source.storageSource.generation,
+            } : undefined,
+            repoSource: source.repoSource ? {
+                projectId: source.repoSource.projectId,
+                repoName: source.repoSource.repoName,
+                branchName: source.repoSource.branchName,
+                tagName: source.repoSource.tagName,
+                commitSha: source.repoSource.commitSha,
+                dir: source.repoSource.dir,
+            } : undefined,
+            gitSource: source.gitSource ? {
+                url: source.gitSource.url,
+                revision: source.gitSource.revision,
+                dir: source.gitSource.dir,
+            } : undefined,
+        };
+    }
+    /**
+     * Map Google Cloud Build to plugin Build type.
+     */
+    mapBuild(raw) {
+        return {
+            id: raw.id ?? '',
+            projectId: raw.projectId ?? this.config.projectId,
+            status: this.mapStatus(raw.status),
+            statusDetail: raw.statusDetail ?? undefined,
+            source: raw.source ? this.mapSource(raw.source) : undefined,
+            steps: (raw.steps ?? []).map(step => this.mapStep(step)),
+            results: raw.results ? this.mapResults(raw.results) : undefined,
+            createTime: this.toDate(raw.createTime) ?? new Date(),
+            startTime: this.toDate(raw.startTime),
+            finishTime: this.toDate(raw.finishTime),
+            duration: this.calculateDuration(raw),
+            timeout: raw.timeout?.seconds ? `${raw.timeout.seconds}s` : undefined,
+            logUrl: raw.logUrl ?? undefined,
+            logsBucket: raw.logsBucket ?? undefined,
+            buildTriggerId: raw.buildTriggerId ?? undefined,
+            substitutions: raw.substitutions,
+            tags: raw.tags,
+            serviceAccount: raw.serviceAccount ?? undefined,
+        };
+    }
+    /**
+     * Map build status enum.
+     */
+    mapStatus(status) {
+        if (status === null || status === undefined)
+            return 'STATUS_UNKNOWN';
+        const statusMap = {
+            0: 'STATUS_UNKNOWN',
+            1: 'PENDING',
+            2: 'QUEUED',
+            3: 'WORKING',
+            4: 'SUCCESS',
+            5: 'FAILURE',
+            6: 'INTERNAL_ERROR',
+            7: 'TIMEOUT',
+            8: 'CANCELLED',
+            9: 'EXPIRED',
+            'STATUS_UNKNOWN': 'STATUS_UNKNOWN',
+            'PENDING': 'PENDING',
+            'QUEUED': 'QUEUED',
+            'WORKING': 'WORKING',
+            'SUCCESS': 'SUCCESS',
+            'FAILURE': 'FAILURE',
+            'INTERNAL_ERROR': 'INTERNAL_ERROR',
+            'TIMEOUT': 'TIMEOUT',
+            'CANCELLED': 'CANCELLED',
+            'EXPIRED': 'EXPIRED',
+        };
+        return statusMap[status] ?? 'STATUS_UNKNOWN';
+    }
+    /**
+     * Map build step.
+     */
+    mapStep(step) {
+        return {
+            id: step.id ?? undefined,
+            name: step.name ?? '',
+            entrypoint: step.entrypoint ?? undefined,
+            args: step.args,
+            dir: step.dir ?? undefined,
+            env: step.env,
+            secretEnv: step.secretEnv,
+            waitFor: step.waitFor,
+            timeout: step.timeout?.seconds ? `${step.timeout.seconds}s` : undefined,
+            status: this.mapStepStatus(step.status),
+            timing: step.timing ? this.mapTimeSpan(step.timing) : undefined,
+            pullTiming: step.pullTiming ? this.mapTimeSpan(step.pullTiming) : undefined,
+            script: step.script ?? undefined,
+        };
+    }
+    /**
+     * Map build step status.
+     */
+    mapStepStatus(status) {
+        if (status === null || status === undefined)
+            return 'STATUS_UNKNOWN';
+        const statusMap = {
+            0: 'STATUS_UNKNOWN',
+            1: 'PENDING',
+            2: 'QUEUED',
+            3: 'WORKING',
+            4: 'SUCCESS',
+            5: 'FAILURE',
+            6: 'INTERNAL_ERROR',
+            7: 'TIMEOUT',
+            8: 'CANCELLED',
+        };
+        return statusMap[status] ?? 'STATUS_UNKNOWN';
+    }
+    /**
+     * Map build results.
+     */
+    mapResults(results) {
+        return {
+            images: results.images?.map(img => ({
+                name: img.name ?? '',
+                digest: img.digest ?? '',
+                pushTiming: img.pushTiming ? this.mapTimeSpan(img.pushTiming) : undefined,
+            })),
+            buildStepImages: results.buildStepImages,
+            artifactManifest: results.artifactManifest ?? undefined,
+            numArtifacts: results.numArtifacts ? Number(results.numArtifacts) : undefined,
+            artifactTiming: results.artifactTiming ? this.mapTimeSpan(results.artifactTiming) : undefined,
+        };
+    }
+    /**
+     * Map source from API response.
+     */
+    mapSource(source) {
+        return {
+            storageSource: source.storageSource ? {
+                bucket: source.storageSource.bucket ?? '',
+                object: source.storageSource.object ?? '',
+                generation: source.storageSource.generation?.toString(),
+            } : undefined,
+            repoSource: source.repoSource ? {
+                projectId: source.repoSource.projectId ?? undefined,
+                repoName: source.repoSource.repoName ?? '',
+                branchName: source.repoSource.branchName ?? undefined,
+                tagName: source.repoSource.tagName ?? undefined,
+                commitSha: source.repoSource.commitSha ?? undefined,
+                dir: source.repoSource.dir ?? undefined,
+            } : undefined,
+            gitSource: source.gitSource ? {
+                url: source.gitSource.url ?? '',
+                revision: source.gitSource.revision ?? undefined,
+                dir: source.gitSource.dir ?? undefined,
+            } : undefined,
+        };
+    }
+    /**
+     * Map time span.
+     */
+    mapTimeSpan(span) {
+        return {
+            startTime: this.toDate(span.startTime) ?? new Date(),
+            endTime: this.toDate(span.endTime) ?? new Date(),
+        };
+    }
+    /**
+     * Convert protobuf timestamp to Date.
+     */
+    toDate(timestamp) {
+        if (!timestamp?.seconds)
+            return undefined;
+        const seconds = typeof timestamp.seconds === 'object'
+            ? Number(timestamp.seconds.toString())
+            : Number(timestamp.seconds);
+        return new Date(seconds * 1000 + (timestamp.nanos ?? 0) / 1000000);
+    }
+    /**
+     * Calculate build duration in seconds.
+     */
+    calculateDuration(build) {
+        const startTime = this.toDate(build.startTime);
+        const finishTime = this.toDate(build.finishTime);
+        if (!startTime || !finishTime)
+            return undefined;
+        return Math.round((finishTime.getTime() - startTime.getTime()) / 1000);
+    }
+}
+//# sourceMappingURL=builds.js.map