@hasna/connectors 1.3.2 → 1.3.3

package/connectors/connect-github/src/api/workflows.ts

@@ -0,0 +1,169 @@
+import type { GitHubClient } from './client';
+import type {
+  Workflow,
+  WorkflowRun,
+  WorkflowJob,
+  ListWorkflowRunsOptions,
+  WorkflowDispatchOptions,
+} from '../types';
+
+/**
+ * GitHub Actions / Workflows API
+ */
+export class WorkflowsApi {
+  constructor(private readonly client: GitHubClient) {}
+
+  // ============================================
+  // Workflows
+  // ============================================
+
+  /**
+   * List workflows in a repository
+   */
+  async list(
+    owner: string,
+    repo: string,
+    options?: { per_page?: number; page?: number }
+  ): Promise<{ total_count: number; workflows: Workflow[] }> {
+    return this.client.get(`/repos/${owner}/${repo}/actions/workflows`, options);
+  }
+
+  /**
+   * Get a workflow by ID or filename (e.g. "ci.yml")
+   */
+  async get(owner: string, repo: string, workflowId: number | string): Promise<Workflow> {
+    return this.client.get<Workflow>(`/repos/${owner}/${repo}/actions/workflows/${workflowId}`);
+  }
+
+  /**
+   * Enable a workflow
+   */
+  async enable(owner: string, repo: string, workflowId: number | string): Promise<void> {
+    await this.client.put(`/repos/${owner}/${repo}/actions/workflows/${workflowId}/enable`, {});
+  }
+
+  /**
+   * Disable a workflow
+   */
+  async disable(owner: string, repo: string, workflowId: number | string): Promise<void> {
+    await this.client.put(`/repos/${owner}/${repo}/actions/workflows/${workflowId}/disable`, {});
+  }
+
+  /**
+   * Trigger a workflow run (workflow_dispatch event)
+   */
+  async trigger(
+    owner: string,
+    repo: string,
+    workflowId: number | string,
+    options: WorkflowDispatchOptions
+  ): Promise<void> {
+    await this.client.post(
+      `/repos/${owner}/${repo}/actions/workflows/${workflowId}/dispatches`,
+      options
+    );
+  }
+
+  // ============================================
+  // Workflow Runs
+  // ============================================
+
+  /**
+   * List workflow runs for a workflow
+   */
+  async listRuns(
+    owner: string,
+    repo: string,
+    workflowId: number | string,
+    options?: ListWorkflowRunsOptions
+  ): Promise<{ total_count: number; workflow_runs: WorkflowRun[] }> {
+    return this.client.get(
+      `/repos/${owner}/${repo}/actions/workflows/${workflowId}/runs`,
+      options as Record<string, string | number | boolean | undefined>
+    );
+  }
+
+  /**
+   * List all workflow runs for a repository
+   */
+  async listAllRuns(
+    owner: string,
+    repo: string,
+    options?: ListWorkflowRunsOptions
+  ): Promise<{ total_count: number; workflow_runs: WorkflowRun[] }> {
+    return this.client.get(
+      `/repos/${owner}/${repo}/actions/runs`,
+      options as Record<string, string | number | boolean | undefined>
+    );
+  }
+
+  /**
+   * Get a workflow run
+   */
+  async getRun(owner: string, repo: string, runId: number): Promise<WorkflowRun> {
+    return this.client.get<WorkflowRun>(`/repos/${owner}/${repo}/actions/runs/${runId}`);
+  }
+
+  /**
+   * Cancel a workflow run
+   */
+  async cancelRun(owner: string, repo: string, runId: number): Promise<void> {
+    await this.client.post(`/repos/${owner}/${repo}/actions/runs/${runId}/cancel`, {});
+  }
+
+  /**
+   * Re-run a workflow run
+   */
+  async rerunRun(owner: string, repo: string, runId: number): Promise<void> {
+    await this.client.post(`/repos/${owner}/${repo}/actions/runs/${runId}/rerun`, {});
+  }
+
+  /**
+   * Delete a workflow run
+   */
+  async deleteRun(owner: string, repo: string, runId: number): Promise<void> {
+    await this.client.delete(`/repos/${owner}/${repo}/actions/runs/${runId}`);
+  }
+
+  /**
+   * Download workflow run logs URL
+   */
+  async getRunLogsUrl(owner: string, repo: string, runId: number): Promise<string> {
+    // Returns a redirect — we return the Location header URL
+    const response = await fetch(
+      `https://api.github.com/repos/${owner}/${repo}/actions/runs/${runId}/logs`,
+      {
+        method: 'GET',
+        redirect: 'manual',
+        headers: this.client.getAuthHeaders(),
+      }
+    );
+    return response.headers.get('location') || '';
+  }
+
+  // ============================================
+  // Jobs
+  // ============================================
+
+  /**
+   * List jobs for a workflow run
+   */
+  async listJobs(
+    owner: string,
+    repo: string,
+    runId: number,
+    options?: { filter?: 'latest' | 'all'; per_page?: number; page?: number }
+  ): Promise<{ total_count: number; jobs: WorkflowJob[] }> {
+    return this.client.get(
+      `/repos/${owner}/${repo}/actions/runs/${runId}/jobs`,
+      options as Record<string, string | number | boolean | undefined>
+    );
+  }
+
+  /**
+   * Get a job for a workflow run
+   */
+  async getJob(owner: string, repo: string, jobId: number): Promise<WorkflowJob> {
+    return this.client.get<WorkflowJob>(`/repos/${owner}/${repo}/actions/jobs/${jobId}`);
+  }
+}

package/connectors/connect-github/src/types/index.ts

@@ -495,3 +495,193 @@ export class GitHubApiError extends Error {
     this.documentationUrl = documentationUrl;
   }
 }
+
+// ============================================
+// Releases
+// ============================================
+
+export interface ReleaseAsset {
+  id: number;
+  url: string;
+  browser_download_url: string;
+  name: string;
+  label: string | null;
+  state: 'uploaded' | 'open';
+  content_type: string;
+  size: number;
+  download_count: number;
+  created_at: string;
+  updated_at: string;
+  uploader: User;
+}
+
+export interface Release {
+  id: number;
+  url: string;
+  html_url: string;
+  assets_url: string;
+  upload_url: string;
+  tarball_url: string | null;
+  zipball_url: string | null;
+  tag_name: string;
+  target_commitish: string;
+  name: string | null;
+  body: string | null;
+  draft: boolean;
+  prerelease: boolean;
+  created_at: string;
+  published_at: string | null;
+  author: User;
+  assets: ReleaseAsset[];
+}
+
+export interface CreateReleaseOptions {
+  target_commitish?: string;
+  name?: string;
+  body?: string;
+  draft?: boolean;
+  prerelease?: boolean;
+  generate_release_notes?: boolean;
+  make_latest?: 'true' | 'false' | 'legacy';
+}
+
+export interface UpdateReleaseOptions {
+  tag_name?: string;
+  target_commitish?: string;
+  name?: string;
+  body?: string;
+  draft?: boolean;
+  prerelease?: boolean;
+  make_latest?: 'true' | 'false' | 'legacy';
+}
+
+// ============================================
+// Actions / Workflows
+// ============================================
+
+export interface Workflow {
+  id: number;
+  node_id: string;
+  name: string;
+  path: string;
+  state: 'active' | 'deleted' | 'disabled_fork' | 'disabled_inactivity' | 'disabled_manually';
+  created_at: string;
+  updated_at: string;
+  url: string;
+  html_url: string;
+  badge_url: string;
+}
+
+export interface WorkflowRun {
+  id: number;
+  name: string | null;
+  node_id: string;
+  head_branch: string | null;
+  head_sha: string;
+  run_number: number;
+  run_attempt: number;
+  event: string;
+  status: 'queued' | 'in_progress' | 'completed' | 'waiting' | 'requested' | 'pending' | null;
+  conclusion: 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'timed_out' | 'action_required' | 'startup_failure' | null;
+  workflow_id: number;
+  url: string;
+  html_url: string;
+  created_at: string;
+  updated_at: string;
+  run_started_at: string;
+  actor: User;
+  triggering_actor: User;
+}
+
+export interface WorkflowJobStep {
+  name: string;
+  status: 'queued' | 'in_progress' | 'completed';
+  conclusion: string | null;
+  number: number;
+  started_at: string | null;
+  completed_at: string | null;
+}
+
+export interface WorkflowJob {
+  id: number;
+  run_id: number;
+  node_id: string;
+  head_sha: string;
+  url: string;
+  html_url: string;
+  status: 'queued' | 'in_progress' | 'completed' | 'waiting';
+  conclusion: 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'timed_out' | 'action_required' | null;
+  name: string;
+  steps: WorkflowJobStep[];
+  started_at: string;
+  completed_at: string | null;
+  runner_name: string | null;
+  runner_group_name: string | null;
+}
+
+export interface WorkflowDispatchOptions {
+  ref: string;
+  inputs?: Record<string, string>;
+}
+
+export interface ListWorkflowRunsOptions {
+  actor?: string;
+  branch?: string;
+  event?: string;
+  status?: 'queued' | 'in_progress' | 'completed' | 'waiting' | 'requested' | 'pending' | 'action_required' | 'cancelled' | 'failure' | 'neutral' | 'skipped' | 'stale' | 'success' | 'timed_out' | 'startup_failure';
+  per_page?: number;
+  page?: number;
+  created?: string;
+  exclude_pull_requests?: boolean;
+  head_sha?: string;
+}
+
+// ============================================
+// Commits & Branches
+// ============================================
+
+export interface Branch {
+  name: string;
+  commit: {
+    sha: string;
+    url: string;
+  };
+  protected: boolean;
+}
+
+export interface CommitStatus {
+  id: number;
+  url: string;
+  state: 'error' | 'failure' | 'pending' | 'success';
+  description: string | null;
+  target_url: string | null;
+  context: string;
+  created_at: string;
+  updated_at: string;
+  creator: User;
+}
+
+export interface CreateCommitStatusOptions {
+  state: 'error' | 'failure' | 'pending' | 'success';
+  target_url?: string;
+  description?: string;
+  context?: string;
+}
+
+export interface CompareResult {
+  url: string;
+  html_url: string;
+  status: 'diverged' | 'ahead' | 'behind' | 'identical';
+  ahead_by: number;
+  behind_by: number;
+  total_commits: number;
+  commits: Commit[];
+  files: Array<{
+    filename: string;
+    status: string;
+    additions: number;
+    deletions: number;
+    changes: number;
+    patch?: string;
+  }>;
+}

package/connectors/connect-gmail/src/cli/index.ts

@@ -131,24 +131,13 @@ authCmd
         saveTokens(result.tokens);
       }
 
-      // Fetch user email and display name, save to the active profile
+      // Fetch user email and save it to the active profile
       try {
         const gmail = Gmail.create();
         const profile = await gmail.profile.get();
         const email = profile.emailAddress;
         setUserEmail(email);
         info(`Email: ${email}`);
-
-        // Try to get display name from Gmail send-as settings
-        try {
-          const displayName = await gmail.profile.getDisplayName();
-          if (displayName) {
-            setUserName(displayName);
-            info(`Name: ${displayName}`);
-          }
-        } catch {
-          // Display name fetch failed — not critical
-        }
       } catch (err) {
         // Email fetch failed but auth succeeded — tokens are saved
         warn(`Could not fetch email address: ${err}`);
@@ -553,29 +542,11 @@ messagesCmd
         if (exactMatch) {
           body = exactMatch.data;
         } else {
-          // Fallback: if looking for text/plain but only text/html exists, strip HTML
+          // Fallback: if looking for text/plain but only text/html exists, use that
           // Or if looking for text/html but only text/plain exists, use that
           const altMatch = textParts.find(p => p.mimeType.startsWith('text/'));
           if (altMatch) {
-            if (!opts.html && altMatch.mimeType === 'text/html') {
-              // Strip HTML to get readable plain text
-              body = altMatch.data
-                .replace(/<br\s*\/?>/gi, '\n')
-                .replace(/<\/p>/gi, '\n\n')
-                .replace(/<\/div>/gi, '\n')
-                .replace(/<\/li>/gi, '\n')
-                .replace(/<[^>]+>/g, '')
-                .replace(/&nbsp;/g, ' ')
-                .replace(/&amp;/g, '&')
-                .replace(/&lt;/g, '<')
-                .replace(/&gt;/g, '>')
-                .replace(/&quot;/g, '"')
-                .replace(/&#39;/g, "'")
-                .replace(/\n{3,}/g, '\n\n')
-                .trim();
-            } else {
-              body = altMatch.data;
-            }
+            body = altMatch.data;
           }
         }
       }

package/connectors/connect-googleads/src/api/adGroups.ts

@@ -89,7 +89,7 @@ export class AdGroupsApi {
       cpcBidMicros?: string;
     }
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
 
     const adGroup: Record<string, unknown> = {
       name,
@@ -117,7 +117,7 @@ export class AdGroupsApi {
       targetCpaMicros?: string;
     }
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroups/${adGroupId}`;
 
     const adGroup: Record<string, unknown> = {
@@ -153,7 +153,7 @@ export class AdGroupsApi {
    * Remove an ad group
    */
   async remove(adGroupId: string): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroups/${adGroupId}`;
 
     return this.client.mutate('adGroups', [{

package/connectors/connect-googleads/src/api/ads.ts

@@ -103,7 +103,7 @@ export class AdsApi {
       status?: AdStatus;
     }
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
 
     const ad: Record<string, unknown> = {
       adGroup: `customers/${customerId}/adGroups/${adGroupId}`,
@@ -131,7 +131,7 @@ export class AdsApi {
    * Update ad status
    */
   async updateStatus(adGroupId: string, adId: string, status: AdStatus): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroupAds/${adGroupId}~${adId}`;
 
     return this.client.mutate('adGroupAds', [{
@@ -161,7 +161,7 @@ export class AdsApi {
    * Remove an ad
    */
   async remove(adGroupId: string, adId: string): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroupAds/${adGroupId}~${adId}`;
 
     return this.client.mutate('adGroupAds', [{

package/connectors/connect-googleads/src/api/campaigns.ts

@@ -92,7 +92,7 @@ export class CampaignsApi {
       endDate?: string;
     }
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
 
     // First create the budget
     const budgetResponse = await this.client.mutate('campaignBudgets', [{
@@ -143,7 +143,7 @@ export class CampaignsApi {
       endDate?: string;
     }
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/campaigns/${campaignId}`;
 
     const campaign: Record<string, unknown> = {
@@ -179,7 +179,7 @@ export class CampaignsApi {
    * Remove a campaign
    */
   async remove(campaignId: string): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/campaigns/${campaignId}`;
 
     return this.client.mutate('campaigns', [{
@@ -238,7 +238,7 @@ export class CampaignsApi {
    * Update campaign budget
    */
   async updateBudget(budgetId: string, amountMicros: string): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/campaignBudgets/${budgetId}`;
 
     return this.client.mutate('campaignBudgets', [{

package/connectors/connect-googleads/src/api/client.ts

@@ -39,7 +39,7 @@ export class GoogleAdsClient {
     return headers;
   }
 
-  private getCustomerId(): string {
+  getCustomerId(): string {
     if (!this.customerId) {
       throw new Error('Customer ID not set. Use --customer or set default with "connect-googleads config set-customer"');
     }

package/connectors/connect-googleads/src/api/keywords.ts

@@ -103,7 +103,7 @@ export class KeywordsApi {
     }>,
     options?: { status?: AdGroupCriterionStatus }
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
 
     const operations = keywords.map(kw => ({
       create: {
@@ -141,7 +141,7 @@ export class KeywordsApi {
    * Update keyword status
    */
   async updateStatus(adGroupId: string, criterionId: string, status: AdGroupCriterionStatus): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroupCriteria/${adGroupId}~${criterionId}`;
 
     return this.client.mutate('adGroupCriteria', [{
@@ -157,7 +157,7 @@ export class KeywordsApi {
    * Update keyword bid
    */
   async updateBid(adGroupId: string, criterionId: string, cpcBidMicros: string): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroupCriteria/${adGroupId}~${criterionId}`;
 
     return this.client.mutate('adGroupCriteria', [{
@@ -187,7 +187,7 @@ export class KeywordsApi {
    * Remove a keyword
    */
   async remove(adGroupId: string, criterionId: string): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
     const resourceName = `customers/${customerId}/adGroupCriteria/${adGroupId}~${criterionId}`;
 
     return this.client.mutate('adGroupCriteria', [{
@@ -202,7 +202,7 @@ export class KeywordsApi {
     adGroupId: string,
     keywords: Array<{ text: string; matchType: KeywordMatchType }>
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
 
     const operations = keywords.map(kw => ({
       create: {
@@ -243,7 +243,7 @@ export class KeywordsApi {
     campaignId: string,
     keywords: Array<{ text: string; matchType: KeywordMatchType }>
   ): Promise<MutateResponse> {
-    const customerId = (this.client as any).getCustomerId();
+    const customerId = this.client.getCustomerId();
 
     const operations = keywords.map(kw => ({
       create: {