linkedin-api-voyager 1.3.2 → 1.3.4

package/README.md

@@ -6,45 +6,46 @@ Biblioteca TypeScript para interagir com endpoints internos do LinkedIn (Voyager
 
 ```bash
 npm install linkedin-api-voyager
+# ou
+yarn add linkedin-api-voyager
 ```
 
-## Autenticação (cookies)
+## Configuração (Obrigatório)
 
-Para fazer requisições autenticadas, você precisa dos cookies `li_at` e `JSESSIONID` da sua sessão no LinkedIn.
+**Atenção:** Esta biblioteca deve ser executada **exclusivamente no lado do servidor (Node.js)**. O uso direto no navegador (client-side) resultará em erros de CORS e restrições de segurança.
 
-### Onde pegar `li_at` e `JSESSIONID`
+Se você estiver usando em uma aplicação web (React, Vue, etc.), você deve criar uma API ou função intermediária no seu backend para chamar esta biblioteca.
+
+### 1. Inicialize o Client
+
+No ponto de entrada da sua aplicação backend (ex: `index.ts`, `server.ts`):
+
+```ts
+import { Client } from "linkedin-api-voyager";
+
+// Configure suas credenciais uma única vez
+Client({
+  JSESSIONID: process.env.LINKEDIN_JSESSIONID, // ex: "ajax:123456789" (apenas os números se preferir, a lib trata)
+  li_at: process.env.LINKEDIN_LI_AT,           // ex: "AQEDAR..."
+});
+```
+
+### 2. Onde pegar `li_at` e `JSESSIONID`
 
 1. Faça login no LinkedIn pelo navegador.
 2. Abra o DevTools do navegador.
 3. Vá em:
    - Chrome/Edge: `Application` -> `Storage` -> `Cookies` -> `https://www.linkedin.com`
    - Firefox: `Storage` -> `Cookies` -> `https://www.linkedin.com`
-4. Copie os valores dos cookies:
-   - `li_at`: copie o valor inteiro.
-   - `JSESSIONID`: o valor costuma vir no formato `"ajax:123456789"`.
-     - Remova as aspas.
-     - Use apenas os números após `ajax:` (ex.: `123456789`).
-
-### Salvando cookies em `linkedin_cookies.json`
-
-Por padrão, a lib procura o arquivo `linkedin_cookies.json` na raiz do seu projeto.
-
-Formato esperado:
-
-```json
-{
-  "JSESSIONID": "123456789",
-  "li_at": "AQEDAR...",
-  "timestamp": 1730000000000
-}
-```
+4. Copie os valores:
+   - `li_at`: valor completo.
+   - `JSESSIONID`: valor completo (ex: `"ajax:123456789"`).
 
-Observações:
+> **Nota:** Nunca comite suas credenciais reais no código. Use variáveis de ambiente (`.env`).
 
-- O arquivo `linkedin_cookies.json` já está no `.gitignore`.
-- Não compartilhe esses cookies e não comite esse arquivo.
+## Exemplos de Uso
 
-## Uso rápido
+Após inicializar o `Client`, você pode importar e usar qualquer função diretamente:
 
 ```ts
 import {
@@ -55,49 +56,40 @@ import {
   getCommentsByPostUrl,
 } from "linkedin-api-voyager";
 
+// Exemplo: Buscar perfil
 const profile = await getUserMiniProfile("wesbush");
+console.log(profile);
+
+// Exemplo: Buscar experiências
 const experiences = await getProfissionalExperiences("wesbush");
+
+// Exemplo: Buscar empresa
 const company = await getCompany("microsoft");
+
+// Exemplo: Pesquisar pessoas
 const people = await searchPeople("software engineer");
+
+// Exemplo: Buscar comentários
 const comments = await getCommentsByPostUrl(
   "https://www.linkedin.com/feed/update/urn:li:activity-1234567890/",
 );
 ```
 
-## API (por arquivo em `src/`)
-
-O pacote reexporta os módulos listados em `src/index.ts`: `user`, `company`, `posts`, `search`, `utils`, `config`.
+## API
 
 ### `src/config.ts`
 
-Constantes exportadas:
-
-- `COOKIE_FILE_PATH`: caminho padrão do arquivo de cookies (`linkedin_cookies.json`).
-- `API_BASE_URL`: base URL das chamadas Voyager (`https://www.linkedin.com/voyager/api`).
-- `AUTH_BASE_URL`: base URL do LinkedIn (`https://www.linkedin.com`).
-
-Funções exportadas:
-
-- `saveCookies(JSESSIONID: string, li_at: string): Promise<void>`
-  - Salva os cookies no `COOKIE_FILE_PATH`.
-- `loadCookies(): Promise<{ JSESSIONID: string; li_at: string; timestamp: number } | null>`
-  - Carrega e valida o arquivo de cookies.
-- `Client(providedCookies?: { JSESSIONID: string; li_at: string }): Promise<AxiosInstance>`
-  - Cria um cliente HTTP com headers/cookies.
-  - Se existir `linkedin_cookies.json`, usa ele.
-  - Se não existir e `providedCookies` for passado, salva e usa.
-- `fetchData(endpoint: string): Promise<any>`
-  - Faz um `GET` usando `Client()` e retorna `response.data`.
-
-Exemplo (salvar cookies e criar cliente):
-
-```ts
-import { Client, saveCookies } from "linkedin-api-voyager";
+- `Client(config: { JSESSIONID: string; li_at: string })`: Configura a instância global do axios. Deve ser chamado antes de qualquer outra função.
+- `API_BASE_URL`: `https://www.linkedin.com/voyager/api`
 
-await saveCookies("123456789", "AQEDAR...");
-const api = await Client();
+### Módulos Disponíveis
 
-const me = await api.get("/me");
+A biblioteca exporta funções dos seguintes módulos:
+- `user`: Perfis e dados de usuário.
+- `company`: Dados de empresas.
+- `posts`: Interações com posts e comentários.
+- `search`: Busca de pessoas e empresas.
+- `utils`: Utilitários gerais.
 ```
 
 ### `src/user.ts`

package/lib/browser.d.ts

@@ -0,0 +1,9 @@
+export * from "./types";
+export * from "./utils";
+export declare const COOKIE_FILE_PATH = "linkedin_cookies.json";
+export declare const API_BASE_URL = "https://www.linkedin.com/voyager/api";
+export declare const AUTH_BASE_URL = "https://www.linkedin.com";
+export declare const saveCookies: () => Promise<never>;
+export declare const loadCookies: () => Promise<never>;
+export declare const Client: () => Promise<never>;
+export declare const fetchData: () => Promise<never>;

package/lib/browser.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+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.fetchData = exports.Client = exports.loadCookies = exports.saveCookies = exports.AUTH_BASE_URL = exports.API_BASE_URL = exports.COOKIE_FILE_PATH = void 0;
+const ERROR_BROWSER_ONLY = "linkedin-api-voyager: este pacote não roda no browser. Use um Route Handler (Next.js) no servidor.";
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+exports.COOKIE_FILE_PATH = "linkedin_cookies.json";
+exports.API_BASE_URL = "https://www.linkedin.com/voyager/api";
+exports.AUTH_BASE_URL = "https://www.linkedin.com";
+const saveCookies = () => __awaiter(void 0, void 0, void 0, function* () {
+    throw new Error(ERROR_BROWSER_ONLY);
+});
+exports.saveCookies = saveCookies;
+const loadCookies = () => __awaiter(void 0, void 0, void 0, function* () {
+    throw new Error(ERROR_BROWSER_ONLY);
+});
+exports.loadCookies = loadCookies;
+const Client = () => __awaiter(void 0, void 0, void 0, function* () {
+    throw new Error(ERROR_BROWSER_ONLY);
+});
+exports.Client = Client;
+const fetchData = () => __awaiter(void 0, void 0, void 0, function* () {
+    throw new Error(ERROR_BROWSER_ONLY);
+});
+exports.fetchData = fetchData;

package/lib/config.d.ts

@@ -1,20 +1,7 @@
-export declare const COOKIE_FILE_PATH = "linkedin_cookies.json";
+import { AxiosInstance } from "axios";
 export declare const API_BASE_URL = "https://www.linkedin.com/voyager/api";
-export declare const AUTH_BASE_URL = "https://www.linkedin.com";
-interface LinkedInCookies {
+export declare const Client: (providedCookies: {
     JSESSIONID: string;
     li_at: string;
-    timestamp: number;
-}
-export declare const saveCookies: (JSESSIONID: string, li_at: string) => Promise<void>;
-export declare const loadCookies: () => Promise<LinkedInCookies | null>;
-export declare const Client: (providedCookies?: {
-    JSESSIONID: string;
-    li_at: string;
-}) => Promise<ReturnType<typeof api>>;
-declare const api: ({ JSESSIONID, li_at }: {
-    li_at: string;
-    JSESSIONID: number;
-}) => import("axios").AxiosInstance;
+}) => AxiosInstance;
 export declare const fetchData: (endpoint: string) => Promise<any>;
-export {};

package/lib/config.js

@@ -9,86 +9,28 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchData = exports.Client = exports.loadCookies = exports.saveCookies = exports.AUTH_BASE_URL = exports.API_BASE_URL = exports.COOKIE_FILE_PATH = void 0;
-const fs = require("fs-extra");
+exports.fetchData = exports.Client = exports.API_BASE_URL = void 0;
 const axios_1 = require("axios");
-exports.COOKIE_FILE_PATH = "linkedin_cookies.json";
 exports.API_BASE_URL = "https://www.linkedin.com/voyager/api";
-exports.AUTH_BASE_URL = "https://www.linkedin.com";
-// Função para salvar cookies no arquivo JSON
-const saveCookies = (JSESSIONID, li_at) => __awaiter(void 0, void 0, void 0, function* () {
-    try {
-        const cookies = {
-            JSESSIONID,
-            li_at,
-            timestamp: Date.now(),
-        };
-        yield fs.ensureFile(exports.COOKIE_FILE_PATH);
-        yield fs.writeJson(exports.COOKIE_FILE_PATH, cookies, { spaces: 2 });
-    }
-    catch (error) {
-        throw error;
-    }
-});
-exports.saveCookies = saveCookies;
-// Função para carregar cookies do arquivo JSON
-const loadCookies = () => __awaiter(void 0, void 0, void 0, function* () {
-    try {
-        const exists = yield fs.pathExists(exports.COOKIE_FILE_PATH);
-        if (!exists) {
-            throw new Error("Arquivo de cookies não encontrado");
-        }
-        const cookies = yield fs.readJson(exports.COOKIE_FILE_PATH);
-        // Verificar se os cookies têm a estrutura esperada
-        if (!cookies.JSESSIONID || !cookies.li_at) {
-            throw new Error("Cookies inválidos encontrados no arquivo");
-        }
-        return cookies;
-    }
-    catch (error) {
-        throw error;
-    }
-});
-exports.loadCookies = loadCookies;
-// Função para criar cliente com cookies automáticos
-const Client = (providedCookies) => __awaiter(void 0, void 0, void 0, function* () {
-    let cookiesToUse;
-    const savedCookies = yield (0, exports.loadCookies)();
-    if (savedCookies) {
-        cookiesToUse = {
-            JSESSIONID: savedCookies.JSESSIONID,
-            li_at: savedCookies.li_at,
-        };
-    }
-    else {
-        if (providedCookies) {
-            yield (0, exports.saveCookies)(providedCookies.JSESSIONID, providedCookies.li_at);
-            cookiesToUse = providedCookies;
-        }
-        else {
-            throw new Error("Nenhum cookie válido fornecido");
-        }
-    }
-    return api({
-        JSESSIONID: parseInt(cookiesToUse.JSESSIONID),
-        li_at: cookiesToUse.li_at,
-    });
-});
-exports.Client = Client;
-const api = ({ JSESSIONID, li_at }) => {
-    return axios_1.default.create({
+let apiInstance = null;
+const Client = (providedCookies) => {
+    apiInstance = axios_1.default.create({
         baseURL: exports.API_BASE_URL,
         headers: {
             "accept-language": "pt-BR,pt;q=0.9,fr-FR;q=0.8,fr;q=0.7,en-US;q=0.6,en;q=0.5",
             accept: "application/vnd.linkedin.normalized+json+2.1",
-            cookie: `li_at=${li_at}; JSESSIONID="ajax:${JSESSIONID}"`,
-            "csrf-token": `ajax:${JSESSIONID}`,
+            cookie: `li_at=${providedCookies.li_at}; JSESSIONID="ajax:${providedCookies.JSESSIONID}"`,
+            "csrf-token": `ajax:${providedCookies.JSESSIONID}`,
         },
     });
+    return apiInstance;
 };
+exports.Client = Client;
 const fetchData = (endpoint) => __awaiter(void 0, void 0, void 0, function* () {
-    const api = yield (0, exports.Client)();
-    const response = yield api.get(endpoint);
+    if (!apiInstance) {
+        throw new Error("Client not initialized. Please call Client({ JSESSIONID, li_at }) first.");
+    }
+    const response = yield apiInstance.get(endpoint);
     return response.data;
 });
 exports.fetchData = fetchData;

package/lib/teste.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("./config");
 const user_1 = require("./user");
+(0, config_1.Client)({
+    JSESSIONID: "2687703175806319775",
+    li_at: "AQEDARgQ7uMA1d5dAAABmm_VFQcAAAGcT-gumU0Agr-WPhYEN-QPXcfx84Ct0mtL2WQqj9YrWiAR2onQlCPyIa9RWXygwj3JKVSY1elRE6DjH4y6nEE5I3NhxBpswfzbRBCIgKUYmKWeEblF1t9VeGDl",
+});
 (0, user_1.getUserMiniProfile)("wesbush")
     .then((profile) => {
     console.log("profile: ", profile);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedin-api-voyager",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Uma biblioteca TypeScript para interagir com a API interna do LinkedIn (Voyager)",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -15,7 +15,6 @@
     "prepublishOnly": "npm run build"
   },
   "devDependencies": {
-    "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.13.1",
     "nodemon": "^3.1.9",
     "ts-node": "^10.9.2",
@@ -23,7 +22,6 @@
   },
   "dependencies": {
     "axios": "^1.11.0",
-    "fs-extra": "^11.3.1",
     "path": "^0.12.7"
   }
 }