linkedin-secret-sauce 0.11.1 → 0.12.0

package/dist/cosiall-client.d.ts

@@ -1,4 +1,4 @@
-import type { AccountCookies } from "./types";
+import type { AccountCookies, CosiallProfileEmailsResponse, ProfileEmailsLookupOptions } from "./types";
 /**
  * Fetches LinkedIn cookies for all available accounts from the Cosiall API.
  * These cookies are used for authenticating requests to LinkedIn's API.
@@ -19,3 +19,42 @@ import type { AccountCookies } from "./types";
  * ```
  */
 export declare function fetchCookiesFromCosiall(): Promise<AccountCookies[]>;
+/**
+ * Fetches email addresses associated with a LinkedIn profile from the Cosiall API.
+ *
+ * This endpoint provides flexible lookup by ObjectURN, LinkedIn URL, or vanity name.
+ * At least one lookup parameter must be provided.
+ *
+ * @param options - Lookup options (objectUrn, linkedInUrl, or vanity)
+ * @returns Profile emails response with profileId, objectUrn, linkedInUrl, and emails array
+ * @throws LinkedInClientError with code INVALID_REQUEST if no lookup parameters provided
+ * @throws LinkedInClientError with code NOT_FOUND if profile not found
+ * @throws LinkedInClientError with code AUTH_ERROR if API key is invalid
+ * @throws LinkedInClientError with code REQUEST_FAILED for other API errors
+ *
+ * @remarks
+ * - Lookup priority: objectUrn > linkedInUrl > vanity
+ * - Returns empty emails array if profile exists but has no emails
+ * - URL normalization is handled server-side (trailing slashes, https prefix)
+ *
+ * @example
+ * ```typescript
+ * // Lookup by ObjectURN (most precise)
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ * });
+ *
+ * // Lookup by LinkedIn URL
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   linkedInUrl: 'https://www.linkedin.com/in/john-doe/'
+ * });
+ *
+ * // Lookup by vanity name
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   vanity: 'john-doe'
+ * });
+ *
+ * console.log(`Found ${result.emails.length} emails:`, result.emails);
+ * ```
+ */
+export declare function fetchProfileEmailsFromCosiall(options: ProfileEmailsLookupOptions): Promise<CosiallProfileEmailsResponse>;

package/dist/cosiall-client.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchCookiesFromCosiall = fetchCookiesFromCosiall;
+exports.fetchProfileEmailsFromCosiall = fetchProfileEmailsFromCosiall;
 const config_1 = require("./config");
 const errors_1 = require("./utils/errors");
 const logger_1 = require("./utils/logger");
@@ -120,11 +121,149 @@ async function fetchCookiesFromCosiall() {
         }
         return true;
     }
-    return data
-        .filter(isItem)
-        .map((item) => ({
+    return data.filter(isItem).map((item) => ({
         accountId: item.accountId,
         cookies: item.cookies,
         expiresAt: item.expiresAt,
     }));
 }
+/**
+ * Fetches email addresses associated with a LinkedIn profile from the Cosiall API.
+ *
+ * This endpoint provides flexible lookup by ObjectURN, LinkedIn URL, or vanity name.
+ * At least one lookup parameter must be provided.
+ *
+ * @param options - Lookup options (objectUrn, linkedInUrl, or vanity)
+ * @returns Profile emails response with profileId, objectUrn, linkedInUrl, and emails array
+ * @throws LinkedInClientError with code INVALID_REQUEST if no lookup parameters provided
+ * @throws LinkedInClientError with code NOT_FOUND if profile not found
+ * @throws LinkedInClientError with code AUTH_ERROR if API key is invalid
+ * @throws LinkedInClientError with code REQUEST_FAILED for other API errors
+ *
+ * @remarks
+ * - Lookup priority: objectUrn > linkedInUrl > vanity
+ * - Returns empty emails array if profile exists but has no emails
+ * - URL normalization is handled server-side (trailing slashes, https prefix)
+ *
+ * @example
+ * ```typescript
+ * // Lookup by ObjectURN (most precise)
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ * });
+ *
+ * // Lookup by LinkedIn URL
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   linkedInUrl: 'https://www.linkedin.com/in/john-doe/'
+ * });
+ *
+ * // Lookup by vanity name
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   vanity: 'john-doe'
+ * });
+ *
+ * console.log(`Found ${result.emails.length} emails:`, result.emails);
+ * ```
+ */
+async function fetchProfileEmailsFromCosiall(options) {
+    const { objectUrn, linkedInUrl, vanity } = options;
+    // Validate at least one parameter is provided
+    if (!objectUrn && !linkedInUrl && !vanity) {
+        throw new errors_1.LinkedInClientError("At least one of 'objectUrn', 'linkedInUrl', or 'vanity' must be provided", "INVALID_REQUEST", 400);
+    }
+    const { cosiallApiUrl, cosiallApiKey } = (0, config_1.getConfig)();
+    const base = cosiallApiUrl.replace(/\/+$/, "");
+    // Build query string
+    const params = new URLSearchParams();
+    if (objectUrn)
+        params.set("objectUrn", objectUrn);
+    if (linkedInUrl)
+        params.set("linkedInUrl", linkedInUrl);
+    if (vanity)
+        params.set("vanity", vanity);
+    const url = `${base}/api/flexiq/profile-emails?${params.toString()}`;
+    (0, logger_1.log)("info", "cosiall.profileEmails.start", {
+        objectUrn,
+        linkedInUrl,
+        vanity,
+    });
+    (0, metrics_1.incrementMetric)("cosiallProfileEmailsFetches");
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            "X-API-Key": cosiallApiKey,
+            Accept: "application/json",
+        },
+    });
+    // Handle error responses
+    if (!response.ok) {
+        const status = response.status;
+        let errorMessage = "Profile emails fetch failed";
+        let errorCode = "REQUEST_FAILED";
+        try {
+            const errorData = (await response.json());
+            errorMessage = errorData.error || errorMessage;
+        }
+        catch {
+            // Ignore JSON parse errors
+        }
+        if (status === 400) {
+            errorCode = "INVALID_REQUEST";
+            (0, logger_1.log)("warn", "cosiall.profileEmails.invalidRequest", {
+                status,
+                errorMessage,
+            });
+        }
+        else if (status === 401) {
+            errorCode = "AUTH_ERROR";
+            (0, logger_1.log)("warn", "cosiall.profileEmails.authError", { status });
+        }
+        else if (status === 404) {
+            errorCode = "NOT_FOUND";
+            (0, logger_1.log)("info", "cosiall.profileEmails.notFound", {
+                objectUrn,
+                linkedInUrl,
+                vanity,
+            });
+        }
+        else {
+            (0, logger_1.log)("warn", "cosiall.profileEmails.error", { status, errorMessage });
+            (0, metrics_1.incrementMetric)("cosiallProfileEmailsFailures");
+            // Report unexpected errors to Sentry
+            try {
+                const { reportCriticalError } = await Promise.resolve().then(() => __importStar(require("./utils/sentry")));
+                reportCriticalError("Cosiall Profile Emails API failure", {
+                    status,
+                    errorMessage,
+                    objectUrn,
+                    linkedInUrl,
+                    vanity,
+                    tags: { component: "cosiall-client", endpoint: "profile-emails" },
+                });
+            }
+            catch { }
+        }
+        throw new errors_1.LinkedInClientError(errorMessage, errorCode, status);
+    }
+    const data = await response.json();
+    // Validate response structure
+    if (!data ||
+        typeof data !== "object" ||
+        !("profileId" in data) ||
+        !("objectUrn" in data) ||
+        !("linkedInUrl" in data) ||
+        !("emails" in data)) {
+        (0, logger_1.log)("error", "cosiall.profileEmails.invalidFormat", {
+            dataType: typeof data,
+        });
+        (0, metrics_1.incrementMetric)("cosiallProfileEmailsFailures");
+        throw new errors_1.LinkedInClientError("Invalid profile emails response format", "REQUEST_FAILED", 500);
+    }
+    const result = data;
+    (0, logger_1.log)("info", "cosiall.profileEmails.success", {
+        profileId: result.profileId,
+        emailCount: result.emails.length,
+    });
+    (0, metrics_1.incrementMetric)("cosiallProfileEmailsSuccess");
+    return result;
+}

package/dist/index.d.ts

@@ -52,6 +52,7 @@ export type { LinkedInTenure, LinkedInPosition, LinkedInSpotlightBadge, SalesLea
 export { LinkedInClientError } from "./utils/errors";
 export * from "./cosiall-client";
 export * from "./cookie-pool";
+export type { CosiallProfileEmailsResponse, ProfileEmailsLookupOptions, } from "./types";
 export { parseFullProfile } from "./parsers/profile-parser";
 export { parseSalesSearchResults } from "./parsers/search-parser";
 export * from "./utils/metrics";

package/dist/types.d.ts

@@ -1,3 +1,29 @@
+/**
+ * Response from the Cosiall Profile Emails API endpoint.
+ * Returns email addresses associated with a LinkedIn profile.
+ */
+export interface CosiallProfileEmailsResponse {
+    /** Cosiall internal profile ID */
+    profileId: number;
+    /** LinkedIn ObjectURN identifier (e.g., "urn:li:fsd_profile:ACoAABcdEfG") */
+    objectUrn: string;
+    /** LinkedIn profile URL */
+    linkedInUrl: string;
+    /** List of email addresses associated with the profile (may be empty) */
+    emails: string[];
+}
+/**
+ * Options for looking up profile emails from Cosiall.
+ * At least one of objectUrn, linkedInUrl, or vanity must be provided.
+ */
+export interface ProfileEmailsLookupOptions {
+    /** LinkedIn ObjectURN identifier (most precise lookup method) */
+    objectUrn?: string;
+    /** Full LinkedIn profile URL (e.g., "https://www.linkedin.com/in/john-doe/") */
+    linkedInUrl?: string;
+    /** LinkedIn username/vanity name (e.g., "john-doe") */
+    vanity?: string;
+}
 export interface LinkedInCookie {
     name: string;
     value: string;
@@ -6,7 +32,7 @@ export interface LinkedInCookie {
     expires?: number;
     httpOnly?: boolean;
     secure?: boolean;
-    sameSite?: 'Strict' | 'Lax' | 'None';
+    sameSite?: "Strict" | "Lax" | "None";
 }
 export interface AccountCookies {
     accountId: string;
@@ -184,7 +210,7 @@ export interface Company {
     specialties?: string[];
     emailDomains?: string[];
 }
-export type TypeaheadType = 'BING_GEO' | 'TITLE' | 'INDUSTRY' | 'SENIORITY_LEVEL' | 'FUNCTION' | 'COMPANY_SIZE' | 'COMPANY' | 'PROFILE_LANGUAGE';
+export type TypeaheadType = "BING_GEO" | "TITLE" | "INDUSTRY" | "SENIORITY_LEVEL" | "FUNCTION" | "COMPANY_SIZE" | "COMPANY" | "PROFILE_LANGUAGE";
 export interface TypeaheadItem {
     id: string;
     text: string;
@@ -208,7 +234,7 @@ export interface SalesNavigatorProfile {
     flagshipProfileUrl?: string;
 }
 export type Geo = {
-    type: 'region' | 'country' | 'state' | 'city' | 'postal';
+    type: "region" | "country" | "state" | "city" | "postal";
     value: string;
     id?: string;
 };

package/dist/utils/metrics.d.ts

@@ -15,6 +15,9 @@ export interface Metrics {
     cosiallFetches: number;
     cosiallSuccess: number;
     cosiallFailures: number;
+    cosiallProfileEmailsFetches: number;
+    cosiallProfileEmailsSuccess: number;
+    cosiallProfileEmailsFailures: number;
     companyFetches: number;
     typeaheadRequests: number;
 }

package/dist/utils/metrics.js

@@ -20,6 +20,9 @@ const metrics = {
     cosiallFetches: 0,
     cosiallSuccess: 0,
     cosiallFailures: 0,
+    cosiallProfileEmailsFetches: 0,
+    cosiallProfileEmailsSuccess: 0,
+    cosiallProfileEmailsFailures: 0,
     companyFetches: 0,
     typeaheadRequests: 0,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedin-secret-sauce",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "Private LinkedIn Sales Navigator client with automatic cookie management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",