@generacy-ai/generacy-plugin-github-actions 0.0.0-preview-20260304013206

package/dist/plugin.d.ts

@@ -0,0 +1,254 @@
+import type { Pipeline, PipelineRun, TriggerOptions, IssueTracker } from '@generacy-ai/latency';
+import { AbstractCICDPlugin } from '@generacy-ai/latency-plugin-ci-cd';
+import type { GitHubActionsConfig } from './types/config.js';
+import type { WorkflowRun, TriggerWorkflowParams } from './types/workflows.js';
+import type { Job } from './types/jobs.js';
+import type { Artifact } from './types/artifacts.js';
+import type { CheckRun, CreateCheckRunParams, UpdateCheckRunParams } from './types/check-runs.js';
+import type { PollingConfig, PollingResult, PollingHandle } from './polling/types.js';
+import type { EventBus } from './events/types.js';
+import { StatusPoller } from './polling/status-poller.js';
+/**
+ * Plugin manifest declaration
+ */
+export declare const PLUGIN_MANIFEST: {
+    readonly name: "@generacy-ai/generacy-plugin-github-actions";
+    readonly version: "0.1.0";
+    readonly provides: readonly ["GitHubActions", "CICDPipeline"];
+    readonly requires: readonly [{
+        readonly facet: "EventBus";
+        readonly optional: false;
+    }];
+    readonly optionalRequires: readonly [{
+        readonly facet: "IssueTracker";
+        readonly optional: true;
+    }];
+};
+/**
+ * GitHubActionsPlugin - Main plugin class
+ *
+ * Extends AbstractCICDPlugin to provide the standard CICDPipeline interface
+ * (triggerPipeline, getPipelineStatus, cancelPipeline, listPipelines) while
+ * also exposing GitHub Actions-specific functionality.
+ */
+export declare class GitHubActionsPlugin extends AbstractCICDPlugin {
+    private readonly client;
+    private readonly config;
+    private readonly eventEmitter;
+    private issueTracker;
+    constructor(config: GitHubActionsConfig, eventBus?: EventBus);
+    /**
+     * Set the issue tracker facet for optional integration
+     */
+    setIssueTracker(tracker: IssueTracker): void;
+    /**
+     * Trigger a pipeline run (implements abstract method).
+     *
+     * Maps to GitHub Actions workflow dispatch.
+     */
+    protected doTrigger(pipelineId: string, options?: TriggerOptions): Promise<PipelineRun>;
+    /**
+     * Get pipeline run status (implements abstract method).
+     *
+     * Maps to getWorkflowRun.
+     */
+    protected doGetStatus(runId: string): Promise<PipelineRun>;
+    /**
+     * Cancel a pipeline run (implements abstract method).
+     *
+     * Maps to cancelWorkflowRun.
+     */
+    protected doCancel(runId: string): Promise<void>;
+    /**
+     * List available pipelines (implements abstract method).
+     *
+     * Maps to listWorkflows.
+     */
+    protected doListPipelines(): Promise<Pipeline[]>;
+    /**
+     * Trigger a workflow by filename or ID
+     */
+    triggerWorkflow(params: TriggerWorkflowParams): Promise<WorkflowRun>;
+    /**
+     * Trigger a workflow dispatch event
+     */
+    triggerWorkflowDispatch(workflow: string, ref: string, inputs?: Record<string, string>): Promise<WorkflowRun>;
+    /**
+     * Get workflow ID by filename
+     */
+    getWorkflowId(filename: string): Promise<number>;
+    /**
+     * Get a workflow run by ID
+     */
+    getWorkflowRun(runId: number): Promise<WorkflowRun>;
+    /**
+     * List workflow runs for a workflow
+     */
+    listWorkflowRuns(workflow: string | number, options?: {
+        branch?: string;
+        event?: string;
+        status?: 'completed' | 'action_required' | 'cancelled' | 'failure' | 'neutral' | 'skipped' | 'stale' | 'success' | 'timed_out' | 'in_progress' | 'queued' | 'requested' | 'waiting' | 'pending';
+        per_page?: number;
+        page?: number;
+    }): Promise<WorkflowRun[]>;
+    /**
+     * Cancel a workflow run
+     */
+    cancelWorkflowRun(runId: number): Promise<void>;
+    /**
+     * Re-run a workflow
+     */
+    rerunWorkflowRun(runId: number): Promise<WorkflowRun>;
+    /**
+     * Re-run failed jobs in a workflow
+     */
+    rerunFailedJobs(runId: number): Promise<WorkflowRun>;
+    /**
+     * Get jobs for a workflow run
+     */
+    getJobs(runId: number): Promise<Job[]>;
+    /**
+     * Get a specific job by ID
+     */
+    getJob(jobId: number): Promise<Job>;
+    /**
+     * Download job logs
+     */
+    getJobLogs(jobId: number): Promise<string>;
+    /**
+     * Get failed jobs from a workflow run
+     */
+    getFailedJobs(runId: number): Promise<Job[]>;
+    /**
+     * List artifacts for a workflow run
+     */
+    listArtifacts(runId: number): Promise<Artifact[]>;
+    /**
+     * Get an artifact by ID
+     */
+    getArtifact(artifactId: number): Promise<Artifact>;
+    /**
+     * Download an artifact
+     */
+    downloadArtifact(artifactId: number): Promise<Buffer>;
+    /**
+     * Delete an artifact
+     */
+    deleteArtifact(artifactId: number): Promise<void>;
+    /**
+     * List all artifacts in the repository
+     */
+    listRepoArtifacts(options?: {
+        per_page?: number;
+        page?: number;
+        name?: string;
+    }): Promise<Artifact[]>;
+    /**
+     * Create a check run
+     */
+    createCheckRun(params: CreateCheckRunParams): Promise<CheckRun>;
+    /**
+     * Update a check run
+     */
+    updateCheckRun(checkRunId: number, params: UpdateCheckRunParams): Promise<CheckRun>;
+    /**
+     * Get a check run by ID
+     */
+    getCheckRun(checkRunId: number): Promise<CheckRun>;
+    /**
+     * List check runs for a ref
+     */
+    listCheckRuns(ref: string, options?: {
+        check_name?: string;
+        status?: 'queued' | 'in_progress' | 'completed';
+        filter?: 'latest' | 'all';
+        per_page?: number;
+        page?: number;
+    }): Promise<CheckRun[]>;
+    /**
+     * List check runs for a check suite
+     */
+    listCheckRunsForSuite(checkSuiteId: number, options?: {
+        check_name?: string;
+        status?: 'queued' | 'in_progress' | 'completed';
+        filter?: 'latest' | 'all';
+        per_page?: number;
+        page?: number;
+    }): Promise<CheckRun[]>;
+    /**
+     * Create a status poller
+     */
+    createPoller(config?: Partial<PollingConfig>): StatusPoller;
+    /**
+     * Poll for a workflow run to complete
+     */
+    pollUntilComplete(runId: number, config?: Partial<PollingConfig>): Promise<WorkflowRun>;
+    /**
+     * Wait for a workflow run with timeout
+     */
+    waitForRun(runId: number, timeoutMs?: number, intervalMs?: number): Promise<PollingResult>;
+    /**
+     * Start polling and return a handle
+     */
+    startPolling(runId: number, config?: Partial<PollingConfig>): PollingHandle;
+    /**
+     * Trigger a workflow and wait for completion
+     */
+    triggerAndWait(params: TriggerWorkflowParams, pollingConfig?: Partial<PollingConfig>): Promise<WorkflowRun>;
+    /**
+     * Get the configured CI workflow name
+     */
+    getCIWorkflow(): string | undefined;
+    /**
+     * Get the configured deploy workflow name
+     */
+    getDeployWorkflow(): string | undefined;
+    /**
+     * Get the configured test workflow name
+     */
+    getTestWorkflow(): string | undefined;
+    /**
+     * Post workflow status to an issue
+     *
+     * @param issueNumber - The issue number to comment on
+     * @param run - The workflow run to report on
+     */
+    postWorkflowStatusToIssue(issueNumber: number, run: WorkflowRun): Promise<void>;
+    /**
+     * Post failed workflow details to an issue
+     *
+     * @param issueNumber - The issue number to comment on
+     * @param run - The failed workflow run
+     * @param failedJobs - The failed jobs in the run
+     */
+    postWorkflowFailureToIssue(issueNumber: number, run: WorkflowRun, failedJobs: Job[]): Promise<void>;
+    /**
+     * Handle workflow completion - emit events and optionally comment on issues
+     */
+    private handleWorkflowComplete;
+    /**
+     * Get status emoji for workflow conclusion
+     */
+    private getStatusEmoji;
+    /**
+     * Format workflow duration for display
+     */
+    private formatDuration;
+    /**
+     * Map a GitHub Actions WorkflowRun to a Latency PipelineRun.
+     */
+    private mapWorkflowRunToPipelineRun;
+    /**
+     * Map GitHub Actions workflow status to Latency PipelineStatus.
+     */
+    private mapWorkflowStatus;
+    /**
+     * Map a GitHub Actions Workflow to a Latency Pipeline.
+     */
+    private mapWorkflowToPipeline;
+}
+/**
+ * Create a GitHubActionsPlugin instance
+ */
+export declare function createGitHubActionsPlugin(config: GitHubActionsConfig, eventBus?: EventBus): GitHubActionsPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}