linkedin-api-voyager 1.1.0 → 1.3.1

package/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/user.d.ts

@@ -0,0 +1,38 @@
+export interface MiniUserProfileLinkedin {
+    id_urn: string;
+    publicIdentifier: string;
+    firstName: string;
+    lastName: string;
+    fullName: string;
+    headline: string;
+    about: string;
+    birthDate: {
+        month: number;
+        day: number;
+    };
+    profilePicture: string;
+    backgroundPicture: string;
+}
+export declare const getUserMiniProfile: (identifier: string) => Promise<MiniUserProfileLinkedin>;
+export declare const extractProfileIdLinkedin: (profileUrl: string) => Promise<any>;
+export declare const getProfileSectionAbout: (identifier: string) => Promise<any>;
+export declare const getProfissionalExperiences: (identifier: string) => Promise<{
+    company: any;
+    role: string | null;
+    idCompany: string | null;
+    time_duration?: string | null;
+    location?: string | null;
+    description?: string | null;
+    time_period?: string | null;
+    duration?: string | null;
+}[]>;
+export declare const getContactInfo: (identifier: string) => Promise<never[] | {
+    address: any;
+    weChatContactInfo: any;
+    phoneNumbers: any;
+    emailAddress: any;
+    websites: any;
+}>;
+export declare const getLinkedinSkills: (identifier: string) => Promise<any>;
+export declare const getLinkedinEducation: (identifier: string) => Promise<any>;
+export declare const getLinkedinCertifications: (identifier: string) => Promise<any>;

package/lib/user.js

@@ -0,0 +1,172 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLinkedinCertifications = exports.getLinkedinEducation = exports.getLinkedinSkills = exports.getContactInfo = exports.getProfissionalExperiences = exports.getProfileSectionAbout = exports.extractProfileIdLinkedin = exports.getUserMiniProfile = void 0;
+const company_1 = require("./company");
+const config_1 = require("./config");
+const utils_1 = require("./utils");
+const getUserMiniProfile = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e, _f;
+    const response = yield (0, config_1.fetchData)(`graphql?variables=(vanityName:${identifier})&queryId=voyagerIdentityDashProfiles.34ead06db82a2cc9a778fac97f69ad6a`);
+    if ("included" in response) {
+        const profileData = response.included.find((item) => (item === null || item === void 0 ? void 0 : item.publicIdentifier) === `${identifier}`);
+        const profile = {
+            id_urn: profileData === null || profileData === void 0 ? void 0 : profileData.entityUrn.replace("urn:li:fsd_profile:", ""),
+            publicIdentifier: profileData === null || profileData === void 0 ? void 0 : profileData.publicIdentifier,
+            firstName: profileData === null || profileData === void 0 ? void 0 : profileData.firstName,
+            lastName: profileData === null || profileData === void 0 ? void 0 : profileData.lastName,
+            fullName: `${(profileData === null || profileData === void 0 ? void 0 : profileData.firstName) || ""} ${(profileData === null || profileData === void 0 ? void 0 : profileData.lastName) || ""}`,
+            headline: (0, utils_1.getNestedValue)(profileData, "headline"),
+            about: (yield (0, exports.getProfileSectionAbout)(identifier)) || "N/A",
+            birthDate: {
+                month: ((_a = profileData === null || profileData === void 0 ? void 0 : profileData.birthDateOn) === null || _a === void 0 ? void 0 : _a.month) || null,
+                day: ((_b = profileData === null || profileData === void 0 ? void 0 : profileData.birthDateOn) === null || _b === void 0 ? void 0 : _b.day) || null,
+            },
+            profilePicture: `${(0, utils_1.getNestedValue)(profileData, "profilePicture.displayImageReferenceResolutionResult.vectorImage.rootUrl")}${((_d = (_c = (0, utils_1.getNestedValue)(profileData, "profilePicture.displayImageReferenceResolutionResult.vectorImage.artifacts")) === null || _c === void 0 ? void 0 : _c.at(-1)) === null || _d === void 0 ? void 0 : _d.fileIdentifyingUrlPathSegment) || null}`,
+            backgroundPicture: `${(0, utils_1.getNestedValue)(profileData, "backgroundPicture.displayImageReferenceResolutionResult.vectorImage.rootUrl")}${((_f = (_e = (0, utils_1.getNestedValue)(profileData, "backgroundPicture.displayImageReferenceResolutionResult.vectorImage.artifacts")) === null || _e === void 0 ? void 0 : _e.at(-1)) === null || _f === void 0 ? void 0 : _f.fileIdentifyingUrlPathSegment) || null}`,
+        };
+        return profile;
+    }
+    throw new Error("Profile not found");
+});
+exports.getUserMiniProfile = getUserMiniProfile;
+const extractProfileIdLinkedin = (profileUrl) => __awaiter(void 0, void 0, void 0, function* () {
+    const match = profileUrl.match(/linkedin\.com\/in\/([a-zA-Z0-9-]+)/);
+    const profileId = match ? match[1] : profileUrl;
+    if (profileId) {
+        const response = yield (0, config_1.fetchData)(`graphql?variables=(vanityName:${profileId})&queryId=voyagerIdentityDashProfiles.34ead06db82a2cc9a778fac97f69ad6a`);
+        if ("included" in response) {
+            const profileData = response.included.find((item) => (item === null || item === void 0 ? void 0 : item.publicIdentifier) === `${profileId}`);
+            return (profileData === null || profileData === void 0 ? void 0 : profileData.entityUrn.replace("urn:li:fsd_profile:", "")) || null;
+        }
+        return null;
+    }
+    return null;
+});
+exports.extractProfileIdLinkedin = extractProfileIdLinkedin;
+const getProfileSectionAbout = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    const profileId = yield (0, exports.extractProfileIdLinkedin)(identifier);
+    const response = yield (0, config_1.fetchData)(`graphql?variables=(profileUrn:urn%3Ali%3Afsd_profile%3A${profileId})&queryId=voyagerIdentityDashProfileCards.55af784c21dc8640b500ab5b45937064`);
+    const aboutData = (0, utils_1.getDataIncludedForEntity)(response, `about`);
+    const about = aboutData === null || aboutData === void 0 ? void 0 : aboutData.topComponents.find((item) => { var _a; return ((_a = item.components) === null || _a === void 0 ? void 0 : _a.textComponent) !== null; });
+    const aboutText = ((_c = (_b = (_a = about === null || about === void 0 ? void 0 : about.components) === null || _a === void 0 ? void 0 : _a.textComponent) === null || _b === void 0 ? void 0 : _b.text) === null || _c === void 0 ? void 0 : _c.text) || null;
+    return aboutText;
+});
+exports.getProfileSectionAbout = getProfileSectionAbout;
+const getProfissionalExperiences = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    const profileId = yield (0, exports.extractProfileIdLinkedin)(identifier);
+    if (!profileId) {
+        throw new Error("Profile not found");
+    }
+    const response = yield (0, config_1.fetchData)(`graphql?variables=(profileUrn:urn%3Ali%3Afsd_profile%3A${profileId},sectionType:experience,locale:en_US)&queryId=voyagerIdentityDashProfileComponents.c5d4db426a0f8247b8ab7bc1d660775a`);
+    const experiencesData = Promise.all((0, utils_1.extractExperiences)(response).map((item) => __awaiter(void 0, void 0, void 0, function* () {
+        const company = yield (0, company_1.getCompany)(item.idCompany || "");
+        if (item.idCompany) {
+            delete item.idCompany;
+        }
+        return Object.assign(Object.assign({}, item), { company });
+    })));
+    return experiencesData;
+});
+exports.getProfissionalExperiences = getProfissionalExperiences;
+const getContactInfo = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c;
+    const profileId = yield (0, exports.extractProfileIdLinkedin)(identifier);
+    if (!profileId) {
+        throw new Error("Profile not found");
+    }
+    const response = yield (0, config_1.fetchData)(`graphql?includeWebMetadata=true&variables=(memberIdentity:${identifier})&queryId=voyagerIdentityDashProfiles.c7452e58fa37646d09dae4920fc5b4b9`);
+    const included = (response === null || response === void 0 ? void 0 : response.included) || [];
+    if (!included.length) {
+        console.warn("[PROFILE] No 'included' array found");
+        return [];
+    }
+    const dataProfile = included.find((item) => (item === null || item === void 0 ? void 0 : item.entityUrn) === `urn:li:fsd_profile:${profileId}`);
+    const contactInfo = {
+        address: (dataProfile === null || dataProfile === void 0 ? void 0 : dataProfile.address) || null,
+        weChatContactInfo: (dataProfile === null || dataProfile === void 0 ? void 0 : dataProfile.weChatContactInfo) || null,
+        phoneNumbers: ((_a = dataProfile === null || dataProfile === void 0 ? void 0 : dataProfile.phoneNumbers) === null || _a === void 0 ? void 0 : _a.map((item) => { var _a; return (_a = item === null || item === void 0 ? void 0 : item.phoneNumber) === null || _a === void 0 ? void 0 : _a.number; })) || null,
+        emailAddress: ((_b = dataProfile === null || dataProfile === void 0 ? void 0 : dataProfile.emailAddress) === null || _b === void 0 ? void 0 : _b.emailAddress) || null,
+        websites: ((_c = dataProfile === null || dataProfile === void 0 ? void 0 : dataProfile.websites) === null || _c === void 0 ? void 0 : _c.map((item) => ({
+            label: item === null || item === void 0 ? void 0 : item.label,
+            url: item === null || item === void 0 ? void 0 : item.url,
+        }))) || null,
+    };
+    return contactInfo;
+});
+exports.getContactInfo = getContactInfo;
+const getLinkedinSkills = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    const profileId = yield (0, exports.extractProfileIdLinkedin)(identifier);
+    if (!profileId) {
+        throw new Error("Profile not found");
+    }
+    const response = yield (0, config_1.fetchData)(`graphql?includeWebMetadata=true&variables=(profileUrn:urn%3Ali%3Afsd_profile%3A${profileId},sectionType:skills,locale:pt_BR)&queryId=voyagerIdentityDashProfileComponents.c5d4db426a0f8247b8ab7bc1d660775a`);
+    const included = (response === null || response === void 0 ? void 0 : response.included) || [];
+    const componentsSkills = included
+        .filter((item) => (item === null || item === void 0 ? void 0 : item.$type) ===
+        "com.linkedin.voyager.dash.identity.profile.tetris.PagedListComponent")
+        .map((item) => item === null || item === void 0 ? void 0 : item.components.elements.map((item) => (item === null || item === void 0 ? void 0 : item.components.entityComponent.titleV2.text.text) || null))
+        .filter((item) => item !== null)
+        .flat();
+    return componentsSkills;
+});
+exports.getLinkedinSkills = getLinkedinSkills;
+const getLinkedinEducation = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    const profileId = yield (0, exports.extractProfileIdLinkedin)(identifier);
+    if (!profileId) {
+        throw new Error("Profile not found");
+    }
+    const response = yield (0, config_1.fetchData)(`graphql?includeWebMetadata=true&variables=(profileUrn:urn%3Ali%3Afsd_profile%3A${profileId},sectionType:education,locale:pt_BR)&queryId=voyagerIdentityDashProfileComponents.c5d4db426a0f8247b8ab7bc1d660775a`);
+    const included = (response === null || response === void 0 ? void 0 : response.included) || [];
+    const componentsEducation = included
+        .filter((item) => (item === null || item === void 0 ? void 0 : item.$type) ===
+        "com.linkedin.voyager.dash.identity.profile.tetris.PagedListComponent")
+        .map((item) => item === null || item === void 0 ? void 0 : item.components.elements.map((item) => (item === null || item === void 0 ? void 0 : item.components.entityComponent) || null))
+        .filter((item) => item !== null);
+    const parseData = (componentsEducation === null || componentsEducation === void 0 ? void 0 : componentsEducation[0]) || [];
+    const educationData = parseData.map((item) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        const isStudying = (item === null || item === void 0 ? void 0 : item.caption) === null;
+        const skillsData = item === null || item === void 0 ? void 0 : item.subComponents.components.find((item) => { var _a; return ((_a = item === null || item === void 0 ? void 0 : item.components) === null || _a === void 0 ? void 0 : _a.insightComponent) === null; });
+        return {
+            schoolName: ((_b = (_a = item === null || item === void 0 ? void 0 : item.titleV2) === null || _a === void 0 ? void 0 : _a.text) === null || _b === void 0 ? void 0 : _b.text) || null,
+            linkedinUrlSchool: (item === null || item === void 0 ? void 0 : item.textActionTarget) || null,
+            degreeName: (item === null || item === void 0 ? void 0 : item.subtitle.text) || null,
+            startDate: !isStudying
+                ? Number((_d = (_c = item === null || item === void 0 ? void 0 : item.caption) === null || _c === void 0 ? void 0 : _c.text) === null || _d === void 0 ? void 0 : _d.split(" - ")[0]) || null
+                : null,
+            endDate: !isStudying
+                ? Number((_f = (_e = item === null || item === void 0 ? void 0 : item.caption) === null || _e === void 0 ? void 0 : _e.text) === null || _f === void 0 ? void 0 : _f.split(" - ")[1]) || null
+                : null,
+            isStudying,
+            skills: ((_l = (_k = (_j = (_h = (_g = skillsData === null || skillsData === void 0 ? void 0 : skillsData.components) === null || _g === void 0 ? void 0 : _g.fixedListComponent) === null || _h === void 0 ? void 0 : _h.components[0]) === null || _j === void 0 ? void 0 : _j.components) === null || _k === void 0 ? void 0 : _k.textComponent) === null || _l === void 0 ? void 0 : _l.text.text) || null,
+        };
+    });
+    return educationData;
+});
+exports.getLinkedinEducation = getLinkedinEducation;
+const getLinkedinCertifications = (identifier) => __awaiter(void 0, void 0, void 0, function* () {
+    const profileId = yield (0, exports.extractProfileIdLinkedin)(identifier);
+    if (!profileId) {
+        throw new Error("Profile not found");
+    }
+    const response = yield (0, config_1.fetchData)(`graphql?includeWebMetadata=true&variables=(profileUrn:urn%3Ali%3Afsd_profile%3A${profileId},sectionType:certifications,locale:pt_BR)&queryId=voyagerIdentityDashProfileComponents.c5d4db426a0f8247b8ab7bc1d660775a`);
+    const included = (response === null || response === void 0 ? void 0 : response.included) || [];
+    const componentsCertifications = included
+        .filter((item) => (item === null || item === void 0 ? void 0 : item.$type) ===
+        "com.linkedin.voyager.dash.identity.profile.tetris.PagedListComponent")
+        .map((item) => item === null || item === void 0 ? void 0 : item.components.elements.map((item) => (item === null || item === void 0 ? void 0 : item.components.entityComponent) || null))
+        .filter((item) => item !== null);
+    const parseData = (componentsCertifications === null || componentsCertifications === void 0 ? void 0 : componentsCertifications[0]) || [];
+    return parseData;
+});
+exports.getLinkedinCertifications = getLinkedinCertifications;

package/lib/utils.d.ts

@@ -1,3 +1,4 @@
+import type { ExperienceItem, LIDate, LinkedVectorImage, Organization, RawOrganization, VectorImage } from "./types";
 export declare function filterKeys(obj: any, keysToKeep: string[]): any;
 export declare function filterOutKeys(obj: any, keysToIgnore: string[]): any;
 export declare function getNestedValue(obj: any, path: string): any;
@@ -8,3 +9,37 @@ export declare function extractDataWithReferences(elements: string[], included:
 export declare function debugResolvedStructure(elements: string[], included: any[], maxDepth?: number): void;
 export declare function extractFieldsFromIncluded(included: any[], fields: string[]): Record<string, any>[];
 export declare function mergeExtraFields(mainData: any[], extraData: Record<string, any>[], matchKey?: string): any[];
+type AnyObject = Record<string, any>;
+interface Experience {
+    role: string | null;
+    idCompany: string | null;
+    company: string | null;
+    time_duration?: string | null;
+    location?: string | null;
+    description?: string | null;
+    time_period?: string | null;
+    duration?: string | null;
+}
+export declare const getDataIncludedForEntity: (jsonData: AnyObject, entityUrn: string) => any;
+export declare function extractExperiences(jsonData: AnyObject): Experience[];
+export declare function assert(value: unknown, message?: string | Error): asserts value;
+export declare function getIdFromUrn(urn?: string): string | undefined;
+/**
+ * Return the URN of a raw group update
+ *
+ * Example: urn:li:fs_miniProfile:<id>
+ * Example: urn:li:fs_updateV2:(<urn>,GROUP_FEED,EMPTY,DEFAULT,false)
+ */
+export declare function getUrnFromRawUpdate(update?: string): string | undefined;
+export declare function isLinkedInUrn(urn?: string): boolean | undefined;
+export declare function parseExperienceItem(item: any, { isGroupItem, included }: {
+    isGroupItem?: boolean;
+    included: any[];
+}): ExperienceItem;
+export declare function getGroupedItemId(item: any): string | undefined;
+export declare const omit: <T extends Record<string, unknown> | object, K extends keyof any>(inputObj: T, ...keys: K[]) => Omit<T, K>;
+export declare function resolveImageUrl(vectorImage?: VectorImage): string | undefined;
+export declare function resolveLinkedVectorImageUrl(linkedVectorImage?: LinkedVectorImage): string | undefined;
+export declare function stringifyLinkedInDate(date?: LIDate): string | undefined;
+export declare function normalizeRawOrganization(o?: RawOrganization): Organization;
+export {};