linkedin-automation-cli 1.0.0

package/src/linkedin/selector-engine.ts

@@ -0,0 +1,393 @@
+import { Page, ElementHandle } from 'playwright';
+import { SELECTORS, SelectorCategory } from './selectors';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
+export interface SelectorResult {
+  element: ElementHandle | null;
+  selector: string | null;
+  attempts: string[];
+  method: string;
+}
+
+export interface SelectorLearning {
+  successes: Record<string, number>;
+  failures: Record<string, number>;
+}
+
+export class SelectorEngine {
+  private page: Page;
+  private learningPath: string;
+  private learning: SelectorLearning;
+
+  constructor(page: Page) {
+    this.page = page;
+    this.learningPath = path.join(os.homedir(), '.linkedin-cli', 'selector-learning.json');
+    this.learning = this.loadLearning();
+  }
+
+  private loadLearning(): SelectorLearning {
+    try {
+      if (fs.existsSync(this.learningPath)) {
+        const data = fs.readFileSync(this.learningPath, 'utf-8');
+        return JSON.parse(data);
+      }
+    } catch (error) {
+      console.log('Could not load selector learning:', error);
+    }
+    return { successes: {}, failures: {} };
+  }
+
+  private saveLearning(): void {
+    try {
+      const dir = path.dirname(this.learningPath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      fs.writeFileSync(this.learningPath, JSON.stringify(this.learning, null, 2));
+    } catch (error) {
+      console.log('Could not save selector learning:', error);
+    }
+  }
+
+  private recordSuccess(key: string): void {
+    this.learning.successes[key] = (this.learning.successes[key] || 0) + 1;
+    this.saveLearning();
+  }
+
+  private recordFailure(key: string): void {
+    this.learning.failures[key] = (this.learning.failures[key] || 0) + 1;
+    this.saveLearning();
+  }
+
+  /**
+   * Find element using hybrid approach:
+   * 1. Accessibility locators (getByRole, getByLabel, getByTestId)
+   * 2. Text pattern matching
+   * 3. CSS selectors with fuzzy matching
+   * 4. Legacy selectors from SELECTORS
+   */
+  async findElement(
+    category: SelectorCategory,
+    key: string,
+    options: { timeout?: number; visible?: boolean; text?: string } = {}
+  ): Promise<SelectorResult> {
+    const attempts: string[] = [];
+    const learningKey = `${category}.${key}`;
+
+    // Layer 1: Accessibility-first queries using Playwright locators
+    const a11yResult = await this.findByAccessibility(category, key, options);
+    if (a11yResult.element) {
+      this.recordSuccess(learningKey);
+      return a11yResult;
+    }
+    attempts.push(...a11yResult.attempts);
+
+    // Layer 2: Text pattern matching
+    if (options.text) {
+      const textResult = await this.findByText(options.text, options.timeout);
+      if (textResult.element) {
+        this.recordSuccess(learningKey);
+        return textResult;
+      }
+      attempts.push(...textResult.attempts);
+    }
+
+    // Layer 3: Pattern-based CSS selectors (fuzzy class matching)
+    const patternResult = await this.findByPattern(category, key, options);
+    if (patternResult.element) {
+      this.recordSuccess(learningKey);
+      return patternResult;
+    }
+    attempts.push(...patternResult.attempts);
+
+    // Layer 4: Legacy selectors from SELECTORS
+    const legacyResult = await this.findByLegacy(category, key, options);
+    if (legacyResult.element) {
+      this.recordSuccess(learningKey);
+      return legacyResult;
+    }
+    attempts.push(...legacyResult.attempts);
+
+    // No element found
+    this.recordFailure(learningKey);
+    return { element: null, selector: null, attempts, method: 'none' };
+  }
+
+  /**
+   * Layer 1: Accessibility-first queries
+   */
+  private async findByAccessibility(
+    category: SelectorCategory,
+    key: string,
+    options: { timeout?: number } = {}
+  ): Promise<SelectorResult> {
+    const timeout = options.timeout ?? 5000;
+    const attempts: string[] = [];
+
+    // Define accessibility queries based on category/key
+    const queries = this.buildAccessibilityQueries(category, key);
+
+    for (const query of queries) {
+      try {
+        attempts.push(`getByRole(${query.role}${query.name ? `, "${query.name}"` : ''})`);
+        const element = await this.page
+          .getByRole(query.role as any, {
+            name: query.name ? new RegExp(query.name, 'i') : undefined,
+          })
+          .elementHandle({ timeout });
+        if (element) {
+          return { element, selector: attempts[attempts.length - 1], attempts, method: 'a11y' };
+        }
+      } catch {
+        // Continue to next query
+      }
+
+      // Try getByLabel
+      if (query.label) {
+        try {
+          attempts.push(`getByLabel("${query.label}")`);
+          const element = await this.page
+            .getByLabel(new RegExp(query.label, 'i'))
+            .elementHandle({ timeout });
+          if (element) {
+            return { element, selector: attempts[attempts.length - 1], attempts, method: 'a11y' };
+          }
+        } catch {
+          // Continue
+        }
+      }
+
+      // Try getByTestId
+      if (query.testId) {
+        try {
+          attempts.push(`getByTestId("${query.testId}")`);
+          const element = await this.page.getByTestId(query.testId).elementHandle({ timeout });
+          if (element) {
+            return { element, selector: attempts[attempts.length - 1], attempts, method: 'a11y' };
+          }
+        } catch {
+          // Continue
+        }
+      }
+    }
+
+    return { element: null, selector: null, attempts, method: 'a11y' };
+  }
+
+  private buildAccessibilityQueries(
+    category: SelectorCategory,
+    key: string
+  ): Array<{
+    role?: string;
+    name?: string;
+    label?: string;
+    testId?: string;
+  }> {
+    // Map category+key to accessibility queries
+    const queries: Array<{ role?: string; name?: string; label?: string; testId?: string }> = [];
+
+    if (category === 'messages' && key === 'conversationList') {
+      queries.push(
+        { role: 'list', name: 'conversation' },
+        { role: 'list', name: 'message' },
+        { role: 'region', name: 'conversations' },
+        { testId: 'conversations-list' },
+        { testId: 'conversation-list' },
+        { label: 'conversations' },
+        { label: 'messages' }
+      );
+    }
+
+    if (category === 'messages' && key === 'conversationItem') {
+      queries.push(
+        { role: 'listitem' },
+        { role: 'article' },
+        { role: 'button', name: 'conversation' },
+        { testId: 'conversation-card' }
+      );
+    }
+
+    if (category === 'messages' && key === 'messageInput') {
+      queries.push(
+        { role: 'textbox', name: 'message' },
+        { role: 'textbox', name: 'Write a message' },
+        { label: 'Write a message' },
+        { testId: 'message-input' }
+      );
+    }
+
+    return queries;
+  }
+
+  /**
+   * Layer 2: Find by text content
+   */
+  private async findByText(text: string, timeout?: number): Promise<SelectorResult> {
+    const attempts: string[] = [];
+
+    try {
+      attempts.push(`getByText("${text}")`);
+      const element = await this.page
+        .getByText(new RegExp(text, 'i'))
+        .elementHandle({ timeout: timeout ?? 5000 });
+      if (element) {
+        return { element, selector: attempts[attempts.length - 1], attempts, method: 'text' };
+      }
+    } catch {
+      // Continue
+    }
+
+    return { element: null, selector: null, attempts, method: 'text' };
+  }
+
+  /**
+   * Layer 3: Pattern-based CSS selectors
+   */
+  private async findByPattern(
+    category: SelectorCategory,
+    key: string,
+    options: { timeout?: number } = {}
+  ): Promise<SelectorResult> {
+    const timeout = options.timeout ?? 5000;
+    const attempts: string[] = [];
+
+    // Get patterns for this category/key
+    const patterns = this.getPatternSelectors(category, key);
+
+    for (const pattern of patterns) {
+      try {
+        attempts.push(`CSS: ${pattern}`);
+        const element = await this.page.waitForSelector(pattern, { timeout, state: 'attached' });
+        if (element) {
+          return { element, selector: pattern, attempts, method: 'pattern' };
+        }
+      } catch {
+        // Continue
+      }
+    }
+
+    return { element: null, selector: null, attempts, method: 'pattern' };
+  }
+
+  private getPatternSelectors(category: SelectorCategory, key: string): string[] {
+    // Pattern-based selectors using common LinkedIn class patterns
+    const patterns: Record<string, Record<string, string[]>> = {
+      messages: {
+        conversationList: [
+          '[class*="msg-conversations"]',
+          '[class*="conversations-list"]',
+          '[class*="msg-options"]',
+          'div[role="list"]',
+          'ul[role="list"]',
+        ],
+        conversationItem: [
+          '[class*="msg-conversation"]',
+          '[class*="conversation-card"]',
+          '[class*="message-card"]',
+          'li[role="listitem"]',
+          'div[role="listitem"]',
+        ],
+        messageInput: [
+          '[class*="msg-form"]',
+          '[class*="message-input"]',
+          '[contenteditable="true"]',
+          'div[role="textbox"]',
+        ],
+      },
+    };
+
+    return (patterns[category] as any)?.[key] || [];
+  }
+
+  /**
+   * Layer 4: Legacy selectors from SELECTORS constant
+   */
+  private async findByLegacy(
+    category: SelectorCategory,
+    key: string,
+    options: { timeout?: number; visible?: boolean } = {}
+  ): Promise<SelectorResult> {
+    const selectors = this.getSelectors(category, key);
+    const attempts: string[] = [];
+
+    for (const selector of selectors) {
+      attempts.push(`Legacy: ${selector}`);
+      try {
+        const element = await this.page.waitForSelector(selector, {
+          timeout: options.timeout ?? 5000,
+          state: options.visible ? 'visible' : 'attached',
+        });
+        if (element) {
+          return { element, selector, attempts, method: 'legacy' };
+        }
+      } catch {
+        // Continue to next selector
+      }
+    }
+
+    return { element: null, selector: null, attempts, method: 'legacy' };
+  }
+
+  /**
+   * Get selector strings for a category/key
+   */
+  private getSelectors(category: SelectorCategory, key: string): string[] {
+    const categorySelectors = SELECTORS[category];
+    if (!categorySelectors) return [];
+
+    const keySelectors = categorySelectors[key as keyof typeof categorySelectors];
+    if (!keySelectors) return [];
+
+    return keySelectors as string[];
+  }
+
+  /**
+   * Quickly check if an element exists without waiting
+   */
+  async hasElement(category: SelectorCategory, key: string): Promise<boolean> {
+    const result = await this.findElement(category, key, { timeout: 2000 });
+    if (result.element) {
+      await result.element.dispose();
+      return true;
+    }
+    return false;
+  }
+
+  /**
+   * Try to find element using semantic/accessible attributes first
+   */
+  async findAccessible(
+    options: {
+      role?: string;
+      name?: string;
+      label?: string;
+    },
+    timeout = 5000
+  ): Promise<ElementHandle | null> {
+    const selectors: string[] = [];
+
+    if (options.role && options.name) {
+      selectors.push(`[role="${options.role}"][aria-label*="${options.name}"]`);
+      selectors.push(`[role="${options.role}"][title*="${options.name}"]`);
+    }
+    if (options.label) {
+      selectors.push(`[aria-label*="${options.label}"]`);
+      selectors.push(`[placeholder*="${options.label}"]`);
+    }
+    if (options.role) {
+      selectors.push(`[role="${options.role}"]`);
+    }
+
+    for (const selector of selectors) {
+      try {
+        const element = await this.page.waitForSelector(selector, { timeout });
+        if (element) return element;
+      } catch {
+        continue;
+      }
+    }
+    return null;
+  }
+}

package/src/linkedin/selectors.ts

@@ -0,0 +1,268 @@
+/**
+ * Multi-layer selector system for LinkedIn's unstable UI
+ * Each selector key has multiple fallback strategies
+ */
+export const SELECTORS = {
+  // Login page
+  login: {
+    emailInput: ['input#username', 'input[name="session_key"]', 'input[type="email"]'],
+    passwordInput: ['input#password', 'input[name="session_password"]', 'input[type="password"]'],
+    submitButton: [
+      'button[type="submit"]',
+      'button.sign-in-form__submit-btn',
+      'button:has-text("Sign in")',
+    ],
+  },
+
+  // 2FA
+  twoFA: {
+    pinInput: [
+      'input#input__phone_verification_pin',
+      'input[name="pin"]',
+      'input[type="text"][*="pin" i]',
+    ],
+    submitButton: [
+      'button[type="submit"]',
+      'button:has-text("Submit")',
+      'button:has-text("Verify")',
+    ],
+  },
+
+  // Navigation / logged in indicators
+  nav: {
+    globalNav: ['nav.global-nav', 'header.global-nav', '[data-testid="global-nav"]'],
+    profileDropdown: [
+      'button[aria-label*="Settings"]',
+      '.global-nav__me-menu button',
+      '[data-testid="settings-menu-trigger"]',
+    ],
+  },
+
+  // Messaging
+  messages: {
+    conversationList: [
+      'div.msg-conversations-container__conversations-list',
+      '[data-testid="conversations-list"]',
+      'div[class*="conversations-list"]',
+    ],
+    conversationItem: [
+      'div.msg-conversation-card',
+      '[data-testid="conversation-card"]',
+      'div[class*="conversation-card"]',
+    ],
+    messageBubble: [
+      'div.msg-s-message-group__message',
+      '[data-testid="message-bubble"]',
+      'div[class*="message-bubble"]',
+    ],
+    messageInput: [
+      'div.msg-form__contenteditable',
+      'div[contenteditable="true"][role="textbox"]',
+      '[data-testid="message-input"]',
+    ],
+    sendButton: ['button.msg-form__send-btn', 'button[type="submit"]', 'button:has-text("Send")'],
+  },
+
+  // Connection requests
+  connection: {
+    // Primary connect button (various states)
+    // LinkedIn has many variants - we need comprehensive fallbacks
+    connectButton: [
+      // Aria-label variants
+      'button[aria-label*="Connect"]',
+      'button[aria-label*="Invite"]',
+      'button[aria-label*="to connect"]',
+      // Text content variants
+      'button:has-text("Connect")',
+      'button:has-text("Invite")',
+      'button:has-text("Connect ")',
+      // Class-based variants (LinkedIn uses artdeco classes)
+      'button.artdeco-button--primary:has-text("Connect")',
+      'button.artdeco-button--secondary:has-text("Connect")',
+      'button.artdeco-button--primary',
+      'button.artdeco-button--secondary',
+      // Specific profile page selectors
+      '.pv-top-card-v2-ctas button:has-text("Connect")',
+      '.profile-topcard-actions button:has-text("Connect")',
+      'div.pv-top-card-v2-ctas button',
+      // Data test IDs
+      '[data-testid="connect-button"]',
+      '[data-testid="invite-button"]',
+      // Generic fallback - any button with connect-related text
+      'button[id*="connect"]',
+      'button[id*="invite"]',
+    ],
+    // More actions menu (three dots)
+    moreActionsButton: [
+      'button[aria-label*="More actions"]',
+      'button[aria-label*="More"]',
+      'button:has-text("More")',
+      '.artdeco-dropdown__trigger',
+      'button[data-testid="more-actions"]',
+    ],
+    // Connect option in dropdown menu
+    connectOptionInMenu: [
+      'div[role="menuitem"]:has-text("Connect")',
+      'button:has-text("Connect")',
+      '[role="menuitem"][aria-label*="Connect"]',
+    ],
+    // Add a note modal
+    addNoteButton: ['button[aria-label*="Add a note"]', 'button:has-text("Add a note")'],
+    noteTextarea: ['textarea[name="message"]', 'textarea[placeholder*="note"]', 'textarea'],
+    sendButton: [
+      // Aria-label variants
+      'button[aria-label*="Send invitation"]',
+      'button[aria-label*="Send invite"]',
+      'button[aria-label="Send"]',
+      // Text content variants
+      'button:has-text("Send")',
+      'button:has-text("Send invitation")',
+      'button:has-text("Send invite")',
+      // Modal-specific primary buttons
+      '.artdeco-modal button.artdeco-button--primary',
+      '.artdeco-modal button:has-text("Send")',
+      '.artdeco-modal button[type="submit"]',
+      // Generic modal submit
+      '[role="dialog"] button.artdeco-button--primary',
+      '[role="dialog"] button:has-text("Send")',
+      // Form submit in modal
+      'form button[type="submit"]',
+      '.artdeco-modal form button.artdeco-button--primary',
+      // Generic fallback
+      'button[type="submit"]',
+      '.artdeco-button--primary',
+    ],
+  },
+
+  // Company profile extraction
+  company: {
+    name: [
+      'h1.text-heading-xlarge',
+      '.org-top-card-primary-content h1',
+      'h1.org-top-card-summary__title',
+    ],
+    website: [
+      'a[data-testid="website-link"]',
+      '.org-about-us-module__website a',
+      'dd a[href^="http"]:not([href*="linkedin"])',
+    ],
+    industry: [
+      'dt:has-text("Industry") + dd',
+      '.org-about-company-module__dl dt:has-text("Industry") + dd',
+    ],
+    company_size: [
+      'dt:has-text("Company size") + dd',
+      'dt:has-text("Employees") + dd',
+      '.org-about-company-module__dl dt:has-text("Company size") + dd',
+    ],
+    headquarters: [
+      'dt:has-text("Headquarters") + dd',
+      '.org-about-company-module__dl dt:has-text("Headquarters") + dd',
+    ],
+    founded: [
+      'dt:has-text("Founded") + dd',
+      '.org-about-company-module__dl dt:has-text("Founded") + dd',
+    ],
+    specialties: [
+      'dt:has-text("Specialties") + dd',
+      '.org-about-company-module__dl dt:has-text("Specialties") + dd',
+    ],
+    type: [
+      'dt:has-text("Company type") + dd',
+      'dt:has-text("Type") + dd',
+      '.org-about-company-module__dl dt:has-text("Company type") + dd',
+    ],
+    follower_count: [
+      '.org-top-card-primary-content__followers-count',
+      '.org-top-card-module__followers-count',
+      'span:has-text("followers")',
+      '.org-top-card-summary__followers',
+    ],
+    // Authwall dismiss button
+    dismissAuthwall: [
+      'button[aria-label="Dismiss"]',
+      'button[aria-label="Close"]',
+      '.artdeco-modal__dismiss',
+      'button.artdeco-modal__dismiss',
+    ],
+  },
+
+  // Profile extraction
+  profile: {
+    // Top card
+    name: [
+      'h1.text-heading-xlarge',
+      '[data-testid="top-card-profile-name"]',
+      '.pv-top-card .text-heading-xlarge',
+      'section.artdeco-card h1',
+    ],
+    headline: [
+      '.text-body-medium',
+      '[data-testid="top-card-profile-headline"]',
+      '.pv-top-card .text-body-medium',
+    ],
+    location: [
+      '.text-body-small.inline.t-black--light',
+      '[data-testid="top-card-profile-location"]',
+      '.pv-top-card .text-body-small',
+    ],
+
+    // Experience section - find by heading text pattern
+    experienceSection: [
+      'section:has(h2:has-text("Experience"))',
+      'section[data-view-name="profile-card-experience"]',
+      'section[id*="experience"]',
+    ],
+    experienceList: [
+      'li[data-view-name="profile-component-entity"]',
+      'section:has(h2:has-text("Experience")) li',
+      '.pvs-list__item',
+    ],
+    // Title: First .t-bold span in each experience item
+    experienceTitle: [
+      '.t-bold span[aria-hidden="true"]',
+      '.hoverable-link-text span[aria-hidden="true"]',
+      '.display-flex.align-items-center.t-bold span',
+    ],
+    // Company: First .t-14.t-normal span (after title)
+    experienceCompany: ['.t-14.t-normal span[aria-hidden="true"]', 'span[class*="t-14"]'],
+    // Duration: caption wrapper contains "X yrs Y mos"
+    experienceDuration: [
+      '.pvs-entity__caption-wrapper',
+      '.t-14.t-black--light span[aria-hidden="true"]',
+      'span[class*="caption"]',
+    ],
+    companyLink: ['a[data-field="experience_company_logo"]', 'a[href*="/company/"]'],
+
+    // Contact info
+    contactInfoButton: [
+      'a[href*="contact-info"]',
+      'button[aria-label*="contact info" i]',
+      '[data-control-name="contact_see_more"]',
+    ],
+    contactInfoPanel: [
+      '.pv-contact-info',
+      '[data-testid="contact-info-panel"]',
+      '.artdeco-modal__content',
+    ],
+    contactInfoCloseButton: [
+      '.artdeco-modal__dismiss',
+      'button[aria-label*="Dismiss"]',
+      'button[aria-label*="Close"]',
+      '[data-testid="modal-close"]',
+    ],
+    email: [
+      'a[href^="mailto:"]',
+      '[data-testid="contact-email"]',
+      '.pv-contact-info__contact-type[href*="mailto"]',
+    ],
+    phone: [
+      'a[href^="tel:"]',
+      '[data-testid="contact-phone"]',
+      '.pv-contact-info__contact-type[href*="tel"]',
+    ],
+  } as const,
+} as const;
+
+export type SelectorCategory = keyof typeof SELECTORS;
+export type SelectorKey<C extends SelectorCategory> = keyof (typeof SELECTORS)[C];

package/src/templates/defaults/followup.txt

@@ -0,0 +1,14 @@
+---
+name: Follow-up Message
+description: Follow-up after initial outreach
+category: followup
+---
+
+Hi {{firstName}},
+
+Just following up on my previous message. I know you're busy, so no pressure at all.
+
+I'd still love to connect when you have a moment. Let me know if you're interested!
+
+Best,
+{{senderName}}

package/src/templates/defaults/meeting.txt

@@ -0,0 +1,16 @@
+---
+name: Meeting Request
+description: Request a meeting or call
+category: meeting
+---
+
+Hi {{firstName}},
+
+I've been following {{company}}'s work and I'm really impressed with what you're building.
+
+I have some ideas that might be relevant to your {{topic}} initiatives. Would you be open to a 15-minute call next week to explore this?
+
+I'm flexible on timing - just let me know what works for you!
+
+Best regards,
+{{senderName}}