@hasna/connectors 1.1.3 → 1.1.5

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

@@ -1,30 +0,0 @@
-// Gmail API Connector
-// A TypeScript wrapper for Gmail with OAuth2 authentication
-
-export { Gmail } from './api';
-export * from './types';
-
-// Re-export individual API classes for advanced usage
-export {
-  GmailClient,
-  MessagesApi,
-  LabelsApi,
-  ThreadsApi,
-  ProfileApi,
-} from './api';
-
-// Export auth utilities
-export {
-  getAuthUrl,
-  startCallbackServer,
-  refreshAccessToken,
-  getValidAccessToken,
-} from './utils/auth';
-
-// Export config utilities
-export {
-  isAuthenticated,
-  loadTokens,
-  saveTokens,
-  clearConfig,
-} from './utils/config';

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

@@ -1,202 +0,0 @@
-// Gmail API Connector Types
-
-// ============================================
-// Configuration
-// ============================================
-
-export interface GmailConfig {
-  clientId: string;
-  clientSecret: string;
-  accessToken?: string;
-  refreshToken?: string;
-}
-
-export interface OAuth2Tokens {
-  accessToken: string;
-  refreshToken: string;
-  expiresAt: number;
-  tokenType: string;
-  scope: string;
-}
-
-export interface CliConfig {
-  clientId?: string;
-  clientSecret?: string;
-  tokens?: OAuth2Tokens;
-  userEmail?: string;
-  userName?: string; // Display name for sending emails
-}
-
-// ============================================
-// Common Types
-// ============================================
-
-export type OutputFormat = 'json' | 'table' | 'pretty';
-
-// ============================================
-// Gmail Message Types
-// ============================================
-
-export interface GmailMessage {
-  id: string;
-  threadId: string;
-  labelIds: string[];
-  snippet: string;
-  historyId: string;
-  internalDate: string;
-  payload?: MessagePart;
-  sizeEstimate: number;
-  raw?: string;
-}
-
-export interface MessagePart {
-  partId: string;
-  mimeType: string;
-  filename: string;
-  headers: MessageHeader[];
-  body: MessagePartBody;
-  parts?: MessagePart[];
-}
-
-export interface MessageHeader {
-  name: string;
-  value: string;
-}
-
-export interface MessagePartBody {
-  attachmentId?: string;
-  size: number;
-  data?: string;
-}
-
-export interface MessageListResponse {
-  messages: Array<{ id: string; threadId: string }>;
-  nextPageToken?: string;
-  resultSizeEstimate: number;
-}
-
-// ============================================
-// Gmail Label Types
-// ============================================
-
-export interface GmailLabel {
-  id: string;
-  name: string;
-  messageListVisibility?: 'show' | 'hide';
-  labelListVisibility?: 'labelShow' | 'labelShowIfUnread' | 'labelHide';
-  type: 'system' | 'user';
-  messagesTotal?: number;
-  messagesUnread?: number;
-  threadsTotal?: number;
-  threadsUnread?: number;
-  color?: LabelColor;
-}
-
-export interface LabelColor {
-  textColor: string;
-  backgroundColor: string;
-}
-
-// ============================================
-// Gmail Thread Types
-// ============================================
-
-export interface GmailThread {
-  id: string;
-  historyId: string;
-  messages: GmailMessage[];
-  snippet?: string;
-}
-
-export interface ThreadListResponse {
-  threads: Array<{ id: string; snippet: string; historyId: string }>;
-  nextPageToken?: string;
-  resultSizeEstimate: number;
-}
-
-// ============================================
-// Gmail Draft Types
-// ============================================
-
-export interface GmailDraft {
-  id: string;
-  message: GmailMessage;
-}
-
-// ============================================
-// Send Message Types
-// ============================================
-
-export interface SendMessageOptions {
-  to: string | string[];
-  cc?: string | string[];
-  bcc?: string | string[];
-  subject: string;
-  body: string;
-  isHtml?: boolean;
-  threadId?: string;
-  attachments?: Attachment[];
-}
-
-export interface Attachment {
-  filename: string;
-  mimeType: string;
-  data: string; // base64 encoded
-}
-
-// ============================================
-// Search/Query Types
-// ============================================
-
-export interface ListMessagesOptions {
-  maxResults?: number;
-  pageToken?: string;
-  q?: string; // Gmail search query
-  labelIds?: string[];
-  includeSpamTrash?: boolean;
-}
-
-export interface ListThreadsOptions {
-  maxResults?: number;
-  pageToken?: string;
-  q?: string;
-  labelIds?: string[];
-  includeSpamTrash?: boolean;
-}
-
-// ============================================
-// Profile Types
-// ============================================
-
-export interface GmailProfile {
-  emailAddress: string;
-  messagesTotal: number;
-  threadsTotal: number;
-  historyId: string;
-}
-
-// ============================================
-// API Error Types
-// ============================================
-
-export interface GmailError {
-  code: number;
-  message: string;
-  errors?: Array<{
-    domain: string;
-    reason: string;
-    message: string;
-  }>;
-}
-
-export class GmailApiError extends Error {
-  public readonly statusCode: number;
-  public readonly errors?: GmailError['errors'];
-
-  constructor(message: string, statusCode: number, errors?: GmailError['errors']) {
-    super(message);
-    this.name = 'GmailApiError';
-    this.statusCode = statusCode;
-    this.errors = errors;
-  }
-}

package/connectors/connect-gmail/src/utils/auth.ts

@@ -1,247 +0,0 @@
-import { createServer } from 'http';
-import type { OAuth2Tokens } from '../types';
-import { saveTokens, getClientId, getClientSecret, loadTokens } from './config';
-
-// Google OAuth2 endpoints
-const GOOGLE_AUTH_URL = 'https://accounts.google.com/o/oauth2/v2/auth';
-const GOOGLE_TOKEN_URL = 'https://oauth2.googleapis.com/token';
-
-// Gmail API scopes
-const GMAIL_SCOPES = [
-  'https://www.googleapis.com/auth/gmail.readonly',
-  'https://www.googleapis.com/auth/gmail.send',
-  'https://www.googleapis.com/auth/gmail.compose',
-  'https://www.googleapis.com/auth/gmail.modify',
-  'https://www.googleapis.com/auth/gmail.labels',
-  'https://www.googleapis.com/auth/gmail.settings.basic', // Filter management
-  'https://mail.google.com/', // Full access
-].join(' ');
-
-const REDIRECT_PORT = 8089;
-// For Desktop/Installed apps, use loopback IP without path
-const REDIRECT_URI = `http://127.0.0.1:${REDIRECT_PORT}`;
-
-export interface AuthResult {
-  success: boolean;
-  tokens?: OAuth2Tokens;
-  error?: string;
-}
-
-/**
- * Generate the OAuth2 authorization URL
- */
-export function getAuthUrl(): string {
-  const clientId = getClientId();
-  if (!clientId) {
-    throw new Error('Client ID not configured. Run "connect-gmail config set-credentials" first.');
-  }
-
-  const params = new URLSearchParams({
-    client_id: clientId,
-    redirect_uri: REDIRECT_URI,
-    response_type: 'code',
-    scope: GMAIL_SCOPES,
-    access_type: 'offline',
-    prompt: 'consent', // Force consent to get refresh token
-  });
-
-  return `${GOOGLE_AUTH_URL}?${params.toString()}`;
-}
-
-/**
- * Exchange authorization code for tokens
- */
-export async function exchangeCodeForTokens(code: string): Promise<OAuth2Tokens> {
-  const clientId = getClientId();
-  const clientSecret = getClientSecret();
-
-  if (!clientId || !clientSecret) {
-    throw new Error('OAuth credentials not configured');
-  }
-
-  const response = await fetch(GOOGLE_TOKEN_URL, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/x-www-form-urlencoded',
-    },
-    body: new URLSearchParams({
-      code,
-      client_id: clientId,
-      client_secret: clientSecret,
-      redirect_uri: REDIRECT_URI,
-      grant_type: 'authorization_code',
-    }),
-  });
-
-  if (!response.ok) {
-    const errorText = await response.text();
-    let errorMessage = `Token exchange failed: ${response.status} ${response.statusText}`;
-    try {
-      const error = JSON.parse(errorText);
-      errorMessage = `Token exchange failed: ${error.error_description || error.error || response.statusText}`;
-      console.error('Token exchange error details:', error);
-    } catch {
-      errorMessage = `Token exchange failed: ${errorText || response.statusText}`;
-    }
-    throw new Error(errorMessage);
-  }
-
-  const data = await response.json();
-
-  const tokens: OAuth2Tokens = {
-    accessToken: data.access_token,
-    refreshToken: data.refresh_token,
-    expiresAt: Date.now() + data.expires_in * 1000,
-    tokenType: data.token_type,
-    scope: data.scope,
-  };
-
-  // Don't save here - let CLI save after determining correct profile from email
-  return tokens;
-}
-
-/**
- * Refresh the access token using the refresh token
- */
-export async function refreshAccessToken(): Promise<OAuth2Tokens> {
-  const clientId = getClientId();
-  const clientSecret = getClientSecret();
-  const currentTokens = loadTokens();
-
-  if (!clientId || !clientSecret) {
-    throw new Error('OAuth credentials not configured');
-  }
-
-  if (!currentTokens?.refreshToken) {
-    throw new Error('No refresh token available. Please login again.');
-  }
-
-  const response = await fetch(GOOGLE_TOKEN_URL, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/x-www-form-urlencoded',
-    },
-    body: new URLSearchParams({
-      client_id: clientId,
-      client_secret: clientSecret,
-      refresh_token: currentTokens.refreshToken,
-      grant_type: 'refresh_token',
-    }),
-  });
-
-  if (!response.ok) {
-    const error = await response.json();
-    throw new Error(`Token refresh failed: ${error.error_description || error.error}`);
-  }
-
-  const data = await response.json();
-
-  const tokens: OAuth2Tokens = {
-    accessToken: data.access_token,
-    refreshToken: currentTokens.refreshToken, // Keep the original refresh token
-    expiresAt: Date.now() + data.expires_in * 1000,
-    tokenType: data.token_type,
-    scope: data.scope || currentTokens.scope,
-  };
-
-  saveTokens(tokens);
-  return tokens;
-}
-
-/**
- * Start a local HTTP server to receive the OAuth callback
- */
-export function startCallbackServer(): Promise<AuthResult> {
-  return new Promise((resolve) => {
-    const server = createServer(async (req, res) => {
-      const url = new URL(req.url || '', `http://127.0.0.1:${REDIRECT_PORT}`);
-
-      // Accept both root path and /callback for flexibility
-      if (url.pathname === '/' || url.pathname === '/callback') {
-        const code = url.searchParams.get('code');
-        const error = url.searchParams.get('error');
-
-        if (error) {
-          res.writeHead(200, { 'Content-Type': 'text/html' });
-          res.end(`
-            <html>
-              <body style="font-family: sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0;">
-                <div style="text-align: center;">
-                  <h1 style="color: #dc3545;">Authentication Failed</h1>
-                  <p>Error: ${error}</p>
-                  <p>You can close this window.</p>
-                </div>
-              </body>
-            </html>
-          `);
-          server.close();
-          resolve({ success: false, error });
-          return;
-        }
-
-        if (code) {
-          try {
-            const tokens = await exchangeCodeForTokens(code);
-            res.writeHead(200, { 'Content-Type': 'text/html' });
-            res.end(`
-              <html>
-                <body style="font-family: sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0;">
-                  <div style="text-align: center;">
-                    <h1 style="color: #28a745;">Authentication Successful!</h1>
-                    <p>You can close this window and return to the terminal.</p>
-                  </div>
-                </body>
-              </html>
-            `);
-            server.close();
-            resolve({ success: true, tokens });
-          } catch (err) {
-            res.writeHead(200, { 'Content-Type': 'text/html' });
-            res.end(`
-              <html>
-                <body style="font-family: sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0;">
-                  <div style="text-align: center;">
-                    <h1 style="color: #dc3545;">Authentication Failed</h1>
-                    <p>Error: ${String(err)}</p>
-                    <p>You can close this window.</p>
-                  </div>
-                </body>
-              </html>
-            `);
-            server.close();
-            resolve({ success: false, error: String(err) });
-          }
-        }
-      }
-    });
-
-    server.listen(REDIRECT_PORT, () => {
-      // Server is ready
-    });
-
-    // Timeout after 5 minutes
-    setTimeout(() => {
-      server.close();
-      resolve({ success: false, error: 'Authentication timed out' });
-    }, 5 * 60 * 1000);
-  });
-}
-
-/**
- * Get a valid access token, refreshing if necessary
- */
-export async function getValidAccessToken(): Promise<string> {
-  const tokens = loadTokens();
-
-  if (!tokens) {
-    throw new Error('Not authenticated. Run "connect-gmail auth login" first.');
-  }
-
-  // Check if token is expired or will expire in next 5 minutes
-  if (Date.now() >= tokens.expiresAt - 5 * 60 * 1000) {
-    const newTokens = await refreshAccessToken();
-    return newTokens.accessToken;
-  }
-
-  return tokens.accessToken;
-}