@hasna/connectors 0.4.0 → 0.4.2

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

@@ -0,0 +1,472 @@
+// LinkedIn Connector Types
+
+// ============================================
+// Configuration
+// ============================================
+
+export interface LinkedInConfig {
+  accessToken: string;
+  baseUrl?: string;
+}
+
+// ============================================
+// Common Types
+// ============================================
+
+export type OutputFormat = 'json' | 'pretty';
+
+export interface PaginatedResponse<T> {
+  elements: T[];
+  paging?: {
+    count: number;
+    start: number;
+    links?: Array<{
+      rel: string;
+      href: string;
+      type: string;
+    }>;
+    total?: number;
+  };
+}
+
+// ============================================
+// Profile Types
+// ============================================
+
+export interface Profile {
+  id: string;
+  localizedFirstName?: string;
+  localizedLastName?: string;
+  localizedHeadline?: string;
+  vanityName?: string;
+  firstName?: LocalizedString;
+  lastName?: LocalizedString;
+  headline?: LocalizedString;
+  profilePicture?: ProfilePicture;
+}
+
+export interface LocalizedString {
+  localized: Record<string, string>;
+  preferredLocale: {
+    country: string;
+    language: string;
+  };
+}
+
+export interface ProfilePicture {
+  displayImage: string;
+  'displayImage~'?: {
+    elements: Array<{
+      identifiers: Array<{
+        identifier: string;
+        identifierType: string;
+        identifierExpiresInSeconds?: number;
+        mediaType?: string;
+      }>;
+    }>;
+  };
+}
+
+export interface EmailAddress {
+  elements: Array<{
+    'handle~': {
+      emailAddress: string;
+    };
+    handle: string;
+  }>;
+}
+
+// ============================================
+// Organization Types
+// ============================================
+
+export interface Organization {
+  id: number;
+  localizedName?: string;
+  localizedDescription?: string;
+  vanityName?: string;
+  localizedWebsite?: string;
+  logoV2?: {
+    original: string;
+    'original~'?: {
+      elements: Array<{
+        identifiers: Array<{
+          identifier: string;
+        }>;
+      }>;
+    };
+  };
+  organizationType?: string;
+  industries?: string[];
+  specialties?: string[];
+  staffCountRange?: string;
+  locations?: OrganizationLocation[];
+  foundedOn?: {
+    year: number;
+    month?: number;
+    day?: number;
+  };
+}
+
+export interface OrganizationLocation {
+  country: string;
+  geographicArea?: string;
+  city?: string;
+  postalCode?: string;
+  line1?: string;
+  line2?: string;
+}
+
+export interface OrganizationAcls {
+  elements: Array<{
+    organizationalTarget: string;
+    role: string;
+    roleAssignee: string;
+    state: string;
+  }>;
+}
+
+// ============================================
+// Post/Share Types
+// ============================================
+
+export type ShareMediaCategory = 'NONE' | 'ARTICLE' | 'IMAGE' | 'VIDEO' | 'CAROUSEL' | 'DOCUMENT';
+export type Visibility = 'PUBLIC' | 'CONNECTIONS' | 'LOGGED_IN' | 'CONTAINER';
+
+export interface Post {
+  id: string;
+  author: string;
+  lifecycleState: 'DRAFT' | 'PUBLISHED' | 'DELETED';
+  visibility: {
+    'com.linkedin.ugc.MemberNetworkVisibility'?: Visibility;
+  };
+  specificContent: {
+    'com.linkedin.ugc.ShareContent': ShareContent;
+  };
+  created: {
+    time: number;
+    actor: string;
+  };
+  lastModified?: {
+    time: number;
+    actor: string;
+  };
+}
+
+export interface ShareContent {
+  shareCommentary: {
+    text: string;
+    attributes?: Array<{
+      start: number;
+      length: number;
+      value: {
+        'com.linkedin.common.MemberAttributedEntity'?: {
+          member: string;
+        };
+        'com.linkedin.common.CompanyAttributedEntity'?: {
+          company: string;
+        };
+        'com.linkedin.common.HashtagAttributedEntity'?: {
+          hashtag: string;
+        };
+      };
+    }>;
+  };
+  shareMediaCategory: ShareMediaCategory;
+  media?: ShareMedia[];
+}
+
+export interface ShareMedia {
+  status: 'READY' | 'PROCESSING' | 'PROCESSING_FAILED';
+  description?: {
+    text: string;
+  };
+  media?: string;
+  originalUrl?: string;
+  title?: {
+    text: string;
+  };
+  thumbnails?: Array<{
+    url: string;
+  }>;
+}
+
+export interface CreatePostParams {
+  author: string;
+  lifecycleState?: 'DRAFT' | 'PUBLISHED';
+  visibility: Visibility;
+  commentary: string;
+  shareMediaCategory?: ShareMediaCategory;
+  media?: Array<{
+    status: 'READY';
+    media?: string;
+    originalUrl?: string;
+    title?: string;
+    description?: string;
+  }>;
+}
+
+// ============================================
+// UGC Post Types (New API)
+// ============================================
+
+export interface UgcPost {
+  author: string;
+  lifecycleState: 'DRAFT' | 'PUBLISHED' | 'DELETED';
+  specificContent: {
+    'com.linkedin.ugc.ShareContent': ShareContent;
+  };
+  visibility: {
+    'com.linkedin.ugc.MemberNetworkVisibility': Visibility;
+  };
+  created?: {
+    time: number;
+    actor: string;
+  };
+}
+
+export interface CreateUgcPostParams {
+  author: string;
+  lifecycleState?: 'DRAFT' | 'PUBLISHED';
+  visibility: Visibility;
+  commentary: string;
+  shareMediaCategory?: ShareMediaCategory;
+  media?: Array<{
+    status: 'READY';
+    media?: string;
+    originalUrl?: string;
+    title?: string;
+    description?: string;
+  }>;
+}
+
+// ============================================
+// Media/Asset Types
+// ============================================
+
+export interface RegisterUploadRequest {
+  recipes: string[];
+  owner: string;
+  serviceRelationships: Array<{
+    relationshipType: string;
+    identifier: string;
+  }>;
+}
+
+export interface RegisterUploadResponse {
+  value: {
+    uploadMechanism: {
+      'com.linkedin.digitalmedia.uploading.MediaUploadHttpRequest': {
+        headers: Record<string, string>;
+        uploadUrl: string;
+      };
+    };
+    mediaArtifact: string;
+    asset: string;
+  };
+}
+
+export interface ImageUploadParams {
+  owner: string;
+  filePath?: string;
+  fileBuffer?: Buffer;
+  fileName?: string;
+}
+
+// ============================================
+// Analytics Types
+// ============================================
+
+export interface ShareStatistics {
+  totalShareStatistics: {
+    shareCount: number;
+    clickCount: number;
+    likeCount: number;
+    commentCount: number;
+    impressionCount: number;
+    engagement: number;
+    uniqueImpressionsCount?: number;
+  };
+  share: string;
+}
+
+export interface OrganizationFollowerStatistics {
+  elements: Array<{
+    followerCounts: {
+      organicFollowerCount: number;
+      paidFollowerCount: number;
+    };
+    organizationalEntity: string;
+    timeRange?: {
+      start: number;
+      end: number;
+    };
+  }>;
+  paging?: {
+    count: number;
+    start: number;
+    total?: number;
+  };
+}
+
+export interface OrganizationPageStatistics {
+  elements: Array<{
+    totalPageStatistics: {
+      views: {
+        mobileProductsPageViews?: {
+          pageViews: number;
+          uniquePageViews: number;
+        };
+        desktopProductsPageViews?: {
+          pageViews: number;
+          uniquePageViews: number;
+        };
+        careersPageViews?: {
+          pageViews: number;
+          uniquePageViews: number;
+        };
+        overviewPageViews?: {
+          pageViews: number;
+          uniquePageViews: number;
+        };
+        allDesktopPageViews?: {
+          pageViews: number;
+          uniquePageViews: number;
+        };
+        allMobilePageViews?: {
+          pageViews: number;
+          uniquePageViews: number;
+        };
+      };
+      clicks?: {
+        careersPageClicks?: {
+          careersPageJobsClicks: number;
+        };
+        mobileCareersPageClicks?: {
+          careersPageJobsClicks: number;
+        };
+        desktopCareersPageClicks?: {
+          careersPageJobsClicks: number;
+        };
+      };
+    };
+    organization: string;
+    timeRange?: {
+      start: number;
+      end: number;
+    };
+  }>;
+  paging?: {
+    count: number;
+    start: number;
+    total?: number;
+  };
+}
+
+// ============================================
+// Connection Types
+// ============================================
+
+export interface ConnectionStats {
+  firstDegreeSize: number;
+}
+
+// ============================================
+// Comment Types
+// ============================================
+
+export interface Comment {
+  id: string;
+  actor: string;
+  message: {
+    text: string;
+  };
+  created: {
+    time: number;
+    actor: string;
+  };
+  parentComment?: string;
+  object: string;
+}
+
+export interface CommentListResponse {
+  elements: Comment[];
+  paging?: {
+    count: number;
+    start: number;
+    links?: Array<{
+      rel: string;
+      href: string;
+    }>;
+    total?: number;
+  };
+}
+
+export interface CreateCommentParams {
+  actor: string;
+  message: string;
+  object: string;
+  parentComment?: string;
+}
+
+// ============================================
+// Reaction Types
+// ============================================
+
+export type ReactionType = 'LIKE' | 'CELEBRATION' | 'LOVE' | 'INSIGHTFUL' | 'CURIOUS' | 'SUPPORT' | 'FUNNY';
+
+export interface Reaction {
+  actor: string;
+  created: {
+    time: number;
+    actor: string;
+  };
+  reactionType: ReactionType;
+  object: string;
+}
+
+export interface ReactionListResponse {
+  elements: Reaction[];
+  paging?: {
+    count: number;
+    start: number;
+    total?: number;
+  };
+}
+
+export interface CreateReactionParams {
+  actor: string;
+  reactionType: ReactionType;
+  object: string;
+}
+
+// ============================================
+// API Error Types
+// ============================================
+
+export interface LinkedInErrorDetail {
+  code: string;
+  message: string;
+  status?: number;
+}
+
+export interface LinkedInErrorResponse {
+  status: number;
+  serviceErrorCode?: number;
+  code?: string;
+  message: string;
+}
+
+export class LinkedInApiError extends Error {
+  public readonly statusCode: number;
+  public readonly serviceErrorCode?: number;
+  public readonly linkedInCode?: string;
+
+  constructor(message: string, statusCode: number, serviceErrorCode?: number, code?: string) {
+    super(message);
+    this.name = 'LinkedInApiError';
+    this.statusCode = statusCode;
+    this.serviceErrorCode = serviceErrorCode;
+    this.linkedInCode = code;
+  }
+}

package/connectors/connect-linkedin/src/utils/config.ts

@@ -0,0 +1,157 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const CONNECTOR_NAME = 'connect-linkedin';
+const DEFAULT_PROFILE = 'default';
+
+export interface ProfileConfig {
+  accessToken?: string;
+}
+
+let profileOverride: string | undefined;
+
+const CONFIG_DIR = join(homedir(), '.connect', CONNECTOR_NAME);
+const PROFILES_DIR = join(CONFIG_DIR, 'profiles');
+const CURRENT_PROFILE_FILE = join(CONFIG_DIR, 'current_profile');
+
+export function setProfileOverride(profile: string | undefined): void {
+  profileOverride = profile;
+}
+
+export function ensureConfigDir(): void {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  if (!existsSync(PROFILES_DIR)) {
+    mkdirSync(PROFILES_DIR, { recursive: true });
+  }
+}
+
+function getProfilePath(profile: string): string {
+  return join(PROFILES_DIR, `${profile}.json`);
+}
+
+export function getCurrentProfile(): string {
+  if (profileOverride) {
+    return profileOverride;
+  }
+
+  ensureConfigDir();
+
+  if (existsSync(CURRENT_PROFILE_FILE)) {
+    try {
+      const profile = readFileSync(CURRENT_PROFILE_FILE, 'utf-8').trim();
+      if (profile && profileExists(profile)) {
+        return profile;
+      }
+    } catch {
+      // Fall through to default
+    }
+  }
+
+  return DEFAULT_PROFILE;
+}
+
+export function setCurrentProfile(profile: string): void {
+  ensureConfigDir();
+
+  if (!profileExists(profile) && profile !== DEFAULT_PROFILE) {
+    throw new Error(`Profile "${profile}" does not exist`);
+  }
+
+  writeFileSync(CURRENT_PROFILE_FILE, profile);
+}
+
+export function profileExists(profile: string): boolean {
+  return existsSync(getProfilePath(profile));
+}
+
+export function listProfiles(): string[] {
+  ensureConfigDir();
+
+  if (!existsSync(PROFILES_DIR)) {
+    return [];
+  }
+
+  return readdirSync(PROFILES_DIR)
+    .filter(f => f.endsWith('.json'))
+    .map(f => f.replace('.json', ''))
+    .sort();
+}
+
+export function createProfile(profile: string, config: ProfileConfig = {}): boolean {
+  ensureConfigDir();
+
+  if (profileExists(profile)) {
+    return false;
+  }
+
+  if (!/^[a-zA-Z0-9_-]+$/.test(profile)) {
+    throw new Error('Profile name can only contain letters, numbers, hyphens, and underscores');
+  }
+
+  writeFileSync(getProfilePath(profile), JSON.stringify(config, null, 2));
+  return true;
+}
+
+export function deleteProfile(profile: string): boolean {
+  if (profile === DEFAULT_PROFILE) {
+    return false;
+  }
+
+  if (!profileExists(profile)) {
+    return false;
+  }
+
+  if (getCurrentProfile() === profile) {
+    setCurrentProfile(DEFAULT_PROFILE);
+  }
+
+  rmSync(getProfilePath(profile));
+  return true;
+}
+
+export function loadProfile(profile?: string): ProfileConfig {
+  ensureConfigDir();
+  const profileName = profile || getCurrentProfile();
+  const profilePath = getProfilePath(profileName);
+
+  if (!existsSync(profilePath)) {
+    return {};
+  }
+
+  try {
+    return JSON.parse(readFileSync(profilePath, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+export function saveProfile(config: ProfileConfig, profile?: string): void {
+  ensureConfigDir();
+  const profileName = profile || getCurrentProfile();
+  writeFileSync(getProfilePath(profileName), JSON.stringify(config, null, 2));
+}
+
+export function getAccessToken(): string | undefined {
+  return process.env.LINKEDIN_ACCESS_TOKEN || loadProfile().accessToken;
+}
+
+export function setAccessToken(accessToken: string): void {
+  const config = loadProfile();
+  config.accessToken = accessToken;
+  saveProfile(config);
+}
+
+export function clearConfig(): void {
+  saveProfile({});
+}
+
+export function getConfigDir(): string {
+  return CONFIG_DIR;
+}
+
+export function getActiveProfileName(): string {
+  return getCurrentProfile();
+}