linkedin-secret-sauce 0.12.5 → 0.13.0

package/dist/index.d.ts

@@ -48,7 +48,7 @@ export { initializeLinkedInClient, getConfig } from "./config";
 export type { LinkedInClientConfig } from "./config";
 export * from "./linkedin-api";
 export * from "./types";
-export type { LinkedInTenure, LinkedInPosition, LinkedInSpotlightBadge, SalesLeadSearchResult, } from "./types";
+export type { LinkedInTenure, LinkedInPosition, LinkedInSpotlightBadge, SalesLeadSearchResult, LinkedInReactionType, ReactionActor, PostReaction, PostReactionsResult, CommentAuthor, PostComment, PostCommentsResult, ProfilePost, PostHistoryResult, PostAnalytics, AnalyzedPost, ProfileAnalysisOptions, ProfileAnalysisResult, } from "./types";
 export { LinkedInClientError } from "./utils/errors";
 export * from "./cosiall-client";
 export * from "./cookie-pool";

package/dist/linkedin-api.d.ts

@@ -1,4 +1,4 @@
-import type { SalesSearchFilters, LinkedInProfile, SearchSalesResult, TypeaheadResult, SalesNavigatorProfile, SalesNavigatorProfileFull, Company } from "./types";
+import type { SalesSearchFilters, LinkedInProfile, SearchSalesResult, TypeaheadResult, SalesNavigatorProfile, SalesNavigatorProfileFull, Company, PostReactionsResult, PostCommentsResult, PostHistoryResult, ProfileAnalysisOptions, ProfileAnalysisResult } from "./types";
 /**
  * Fetches a LinkedIn profile by vanity URL (public identifier).
  * Results are cached for the configured TTL (default: 15 minutes).
@@ -81,6 +81,44 @@ export declare function searchSalesLeads(keywords: string, options?: {
     rawQuery?: string;
     sessionId?: string;
 }): Promise<SearchSalesResult>;
+/**
+ * Analyzes a LinkedIn profile's posts with engagement data (reactions and comments).
+ * This is a high-level convenience function that orchestrates multiple API calls:
+ * 1. Fetches the profile by vanity URL or URN
+ * 2. Retrieves the profile's post history
+ * 3. Fetches reactions and comments for each post
+ *
+ * @param profileIdentifier - LinkedIn vanity URL, full profile URL, or FSD profile URN
+ * @param options - Analysis options for controlling fetch behavior
+ * @returns Complete analysis result with profile, posts, engagement data, and summary statistics
+ *
+ * @example
+ * ```typescript
+ * // Analyze by vanity URL
+ * const analysis = await analyzeProfilePosts('john-doe');
+ * console.log(analysis.summary.totalReactions);
+ * console.log(analysis.summary.avgCommentsPerPost);
+ *
+ * // Analyze by full LinkedIn URL
+ * const analysis = await analyzeProfilePosts('https://www.linkedin.com/in/john-doe');
+ *
+ * // Analyze with options
+ * const analysis = await analyzeProfilePosts('john-doe', {
+ *   postsCount: 20,
+ *   reactionsPerPost: 50,
+ *   commentsPerPost: 25,
+ *   concurrency: 5,
+ * });
+ *
+ * // Access individual post engagement
+ * for (const analyzed of analysis.analyzedPosts) {
+ *   console.log(`Post: ${analyzed.post.text?.substring(0, 50)}...`);
+ *   console.log(`  Reactions: ${analyzed.reactions.totalCount}`);
+ *   console.log(`  Comments: ${analyzed.comments.totalCount}`);
+ * }
+ * ```
+ */
+export declare function analyzeProfilePosts(profileIdentifier: string, options?: ProfileAnalysisOptions): Promise<ProfileAnalysisResult>;
 export declare function getProfilesBatch(vanities: string[], concurrency?: number): Promise<(LinkedInProfile | null)[]>;
 export declare function resolveCompanyUniversalName(universalName: string): Promise<{
     companyId?: string;
@@ -167,3 +205,77 @@ export declare function getSalesNavigatorProfileFull(profileUrnOrId: string): Pr
  * ```
  */
 export declare function extractLinkedInHandle(flagshipProfileUrl: string | null | undefined): string | null;
+/**
+ * Fetches reactions (likes, celebrates, etc.) for a LinkedIn post.
+ * Uses the Voyager GraphQL API with pagination support.
+ *
+ * @param activityUrn - The activity URN (e.g., "urn:li:activity:7419061111293083648") or bare ID
+ * @param options - Pagination options
+ * @param options.start - Pagination offset (default: 0)
+ * @param options.count - Number of reactions to fetch (default: 10, max: 100)
+ * @returns PostReactionsResult with reactions array and pagination info
+ * @throws LinkedInClientError with code NOT_FOUND if post doesn't exist
+ *
+ * @example
+ * ```typescript
+ * // Get first 10 reactions
+ * const reactions = await getPostReactions('urn:li:activity:7419061111293083648');
+ * console.log(reactions.totalCount); // 37
+ * console.log(reactions.reactions[0].reactionType); // "LIKE"
+ *
+ * // Paginate through all reactions
+ * const page2 = await getPostReactions('7419061111293083648', { start: 10, count: 10 });
+ * ```
+ */
+export declare function getPostReactions(activityUrn: string, options?: {
+    start?: number;
+    count?: number;
+}): Promise<PostReactionsResult>;
+/**
+ * Fetches comments for a LinkedIn post.
+ * Uses the voyagerFeedDashUpdates GraphQL API.
+ *
+ * @param activityUrn - The activity URN (e.g., "urn:li:activity:7419061111293083648") or bare ID
+ * @param options - Fetch options
+ * @param options.commentsCount - Number of comments to fetch (default: 10, max: 100)
+ * @returns PostCommentsResult with comments array
+ * @throws LinkedInClientError with code NOT_FOUND if post doesn't exist
+ *
+ * @example
+ * ```typescript
+ * // Get comments for a post
+ * const comments = await getPostComments('urn:li:activity:7419061111293083648');
+ * console.log(comments.totalCount);
+ *
+ * // Get more comments
+ * const moreComments = await getPostComments('7419061111293083648', { commentsCount: 50 });
+ * ```
+ */
+export declare function getPostComments(activityUrn: string, options?: {
+    commentsCount?: number;
+}): Promise<PostCommentsResult>;
+/**
+ * Fetches a user's post history (their published posts).
+ * Uses the Voyager profileUpdatesV2 API with pagination support.
+ *
+ * @param profileUrn - The FSD profile URN (e.g., "urn:li:fsd_profile:ABC123xyz") or bare key
+ * @param options - Pagination options
+ * @param options.start - Pagination offset (default: 0)
+ * @param options.count - Number of posts to fetch (default: 10, max: 100)
+ * @returns PostHistoryResult with posts array and pagination info
+ * @throws LinkedInClientError with code NOT_FOUND if profile doesn't exist
+ *
+ * @example
+ * ```typescript
+ * // Get first 10 posts
+ * const posts = await getPostHistory('ABC123xyz');
+ * console.log(posts.posts.length);
+ *
+ * // Paginate
+ * const page2 = await getPostHistory('ABC123xyz', { start: 10, count: 10 });
+ * ```
+ */
+export declare function getPostHistory(profileUrn: string, options?: {
+    start?: number;
+    count?: number;
+}): Promise<PostHistoryResult>;