@entergreat/unipile-wrapper 2.1.4 → 2.1.5

package/package.json

@@ -1,32 +1,24 @@
 {
   "name": "@entergreat/unipile-wrapper",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "A lightweight TypeScript wrapper for Unipile's LinkedIn API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
+  "files": ["dist/"],
+  "publishConfig": { "access": "restricted" },
   "scripts": {
     "build": "tsc",
     "build:watch": "tsc --watch",
-    "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nivkman/unipile-wrapper.git"
+    "url": "https://github.com/entergreat/unipile-wrapper.git"
   },
-  "keywords": [
-    "unipile",
-    "linkedin",
-    "automation",
-    "api-wrapper"
-  ],
-  "author": "",
+  "keywords": ["unipile", "linkedin", "automation", "api-wrapper", "entergreat"],
+  "author": "EnterGreat",
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/nivkman/unipile-wrapper/issues"
-  },
-  "homepage": "https://github.com/nivkman/unipile-wrapper#readme",
   "dependencies": {
     "axios": "^1.7.9",
     "form-data": "^4.0.0"

package/src/client/httpClient.ts

@@ -1,61 +0,0 @@
-import axios, { AxiosInstance, AxiosRequestConfig } from "axios";
-import FormData from "form-data";
-import { ServiceConfig } from "../types/index.js";
-
-export class HttpClient {
-  private client: AxiosInstance;
-  private apiKey: string;
-
-  constructor(config: ServiceConfig) {
-    const baseURL = `https://${config.subdomain}.unipile.com:${config.port}/api/v1`;
-    this.apiKey = config.unipileToken;
-
-    this.client = axios.create({
-      baseURL,
-      headers: {
-        accept: "application/json",
-        "content-type": "application/json",
-      },
-    });
-
-    this.setupInterceptors();
-  }
-
-  private setupInterceptors(): void {
-    this.client.interceptors.request.use((config) => {
-      config.headers["X-API-KEY"] = this.apiKey;
-      return config;
-    });
-  }
-
-  get baseURL(): string {
-    return this.client.defaults.baseURL || "";
-  }
-
-  async get<T>(url: string): Promise<T> {
-    const response = await this.client.get<T>(url);
-    return response.data;
-  }
-
-  async post<T>(url: string, body: Record<string, unknown> = {}): Promise<T> {
-    const response = await this.client.post<T>(url, body);
-    return response.data;
-  }
-
-  async patch<T>(url: string, body: Record<string, unknown> = {}): Promise<T> {
-    const response = await this.client.patch<T>(url, body);
-    return response.data;
-  }
-
-  async patchFormData<T>(url: string, formData: FormData): Promise<T> {
-    const config: AxiosRequestConfig = {
-      headers: {
-        ...formData.getHeaders(),
-        "X-API-KEY": this.apiKey,
-        accept: "application/json",
-      },
-    };
-    const response = await this.client.patch<T>(url, formData, config);
-    return response.data;
-  }
-}

package/src/client/index.ts

@@ -1 +0,0 @@
-export * from "./httpClient.js";

package/src/index.ts

@@ -1,31 +0,0 @@
-import { HttpClient } from "./client/index.js";
-import {
-  AccountService,
-  SearchService,
-  ProfileService,
-  CompanyService,
-} from "./services/index.js";
-import { ServiceConfig } from "./types/index.js";
-
-export class LinkedinService {
-  public account: AccountService;
-  public search: SearchService;
-  public profile: ProfileService;
-  public company: CompanyService;
-
-  constructor(config: ServiceConfig) {
-    const client = new HttpClient(config);
-    const { accountId } = config;
-
-    this.account = new AccountService(client, accountId);
-    this.search = new SearchService(client, accountId);
-    this.profile = new ProfileService(client, accountId);
-    this.company = new CompanyService(client, accountId);
-  }
-}
-
-// Re-export types for consumers
-export * from "./types/index.js";
-
-// Re-export utilities that might be useful
-export { ValidationError } from "./utils/validators.js";

package/src/services/accountService.ts

@@ -1,21 +0,0 @@
-import { HttpClient } from "../client/index.js";
-import { BaseService } from "./baseService.js";
-import { ConnectParams, ConnectResponse } from "../types/index.js";
-
-export class AccountService extends BaseService {
-  constructor(client: HttpClient, defaultAccountId?: string) {
-    super(client, defaultAccountId);
-  }
-
-  /**
-   * Connect a LinkedIn account to Unipile using a li_at cookie
-   */
-  async connect({ loginCookie }: ConnectParams): Promise<ConnectResponse> {
-    const body = {
-      provider: "LINKEDIN",
-      access_token: loginCookie,
-    };
-
-    return this.client.post<ConnectResponse>("/accounts", body);
-  }
-}

package/src/services/baseService.ts

@@ -1,31 +0,0 @@
-import { HttpClient } from "../client/index.js";
-import { buildUrl, appendArrayParams, ValidationError } from "../utils/index.js";
-
-export abstract class BaseService {
-  protected client: HttpClient;
-  protected defaultAccountId?: string;
-
-  constructor(client: HttpClient, defaultAccountId?: string) {
-    this.client = client;
-    this.defaultAccountId = defaultAccountId;
-  }
-
-  protected resolveAccountId(accountId?: string): string {
-    const resolved = accountId ?? this.defaultAccountId;
-    if (!resolved) {
-      throw new ValidationError("accountId must be provided either in config or method call");
-    }
-    return resolved;
-  }
-
-  protected buildUrl(
-    path: string,
-    params: Record<string, string | number | boolean | undefined> = {}
-  ): string {
-    return buildUrl(this.client.baseURL, path, params);
-  }
-
-  protected appendArrayParams(url: string, key: string, values: string[]): string {
-    return appendArrayParams(url, key, values);
-  }
-}

package/src/services/companyService.ts

@@ -1,66 +0,0 @@
-import { HttpClient } from "../client/index.js";
-import { BaseService } from "./baseService.js";
-import {
-  RetrieveCompanyRequest,
-  SearchCompanyRequest,
-  CompanyResponse,
-  CompanySearchResponse,
-} from "../types/index.js";
-import { validateCompanyIdOrUrl, extractCompanyIdFromUrl } from "../utils/index.js";
-
-export class CompanyService extends BaseService {
-  constructor(client: HttpClient, defaultAccountId?: string) {
-    super(client, defaultAccountId);
-  }
-
-  /**
-   * Retrieve LinkedIn company information by ID or URL
-   */
-  async retrieve({
-    accountId,
-    companyId,
-    companyUrl,
-  }: RetrieveCompanyRequest): Promise<CompanyResponse> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-    validateCompanyIdOrUrl(companyId, companyUrl);
-
-    let id = companyId;
-    if (!id && companyUrl) {
-      id = extractCompanyIdFromUrl(companyUrl) || undefined;
-    }
-
-    if (!id) {
-      throw new Error("Could not extract company ID from URL");
-    }
-
-    const url = this.buildUrl(`/linkedin/company/${id}`, {
-      account_id: resolvedAccountId,
-    });
-
-    return this.client.get<CompanyResponse>(url);
-  }
-
-  /**
-   * Search for companies by name/keywords
-   */
-  async search({
-    accountId,
-    keywords,
-    limit = 5,
-  }: SearchCompanyRequest): Promise<CompanySearchResponse> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-
-    if (!keywords) {
-      throw new Error("keywords is required for company search");
-    }
-
-    const url = this.buildUrl("/linkedin/search/parameters", {
-      account_id: resolvedAccountId,
-      keywords,
-      type: "COMPANY",
-      limit,
-    });
-
-    return this.client.get<CompanySearchResponse>(url);
-  }
-}

package/src/services/index.ts

@@ -1,5 +0,0 @@
-export * from "./baseService.js";
-export * from "./accountService.js";
-export * from "./searchService.js";
-export * from "./profileService.js";
-export * from "./companyService.js";

package/src/services/profileService.ts

@@ -1,177 +0,0 @@
-import FormData from "form-data";
-import { HttpClient } from "../client/index.js";
-import { BaseService } from "./baseService.js";
-import {
-  RetrieveProfileRequest,
-  EditProfileRequest,
-  AddExperienceRequest,
-  EditExperienceRequest,
-  ProfileResponse,
-} from "../types/index.js";
-import {
-  validateProfileId,
-  validateProfileData,
-  validateExperience,
-  convertToBracketNotation,
-} from "../utils/index.js";
-
-export class ProfileService extends BaseService {
-  constructor(client: HttpClient, defaultAccountId?: string) {
-    super(client, defaultAccountId);
-  }
-
-  /**
-   * Retrieve a LinkedIn user profile
-   */
-  async retrieve({
-    accountId,
-    profileId,
-    linkedinSections = [],
-    notify = false,
-  }: RetrieveProfileRequest): Promise<ProfileResponse> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-    validateProfileId(profileId);
-
-    let url = this.buildUrl(`/users/${profileId}`, {
-      account_id: resolvedAccountId,
-      notify,
-    });
-
-    if (linkedinSections.length > 0) {
-      url = this.appendArrayParams(url, "linkedin_sections", linkedinSections);
-    }
-
-    return this.client.get<ProfileResponse>(url);
-  }
-
-  /**
-   * Edit the LinkedIn profile of the account owner
-   */
-  async edit({ accountId, profileData }: EditProfileRequest): Promise<ProfileResponse> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-    validateProfileData(profileData);
-
-    const url = this.buildUrl("/users/me/edit", {
-      account_id: resolvedAccountId,
-    });
-
-    const body = convertToBracketNotation(profileData);
-
-    return this.client.patch<ProfileResponse>(url, body);
-  }
-
-  /**
-   * Add a work experience position to the profile
-   */
-  async addExperience({
-    accountId,
-    experience,
-  }: AddExperienceRequest): Promise<ProfileResponse> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-    validateExperience(experience);
-
-    const url = this.buildUrl("/users/me/edit", {
-      account_id: resolvedAccountId,
-    });
-
-    const formData = this.buildExperienceFormData(resolvedAccountId, experience);
-
-    return this.client.patchFormData<ProfileResponse>(url, formData);
-  }
-
-  /**
-   * Edit an existing work experience position
-   */
-  async editExperience({
-    accountId,
-    experienceId,
-    experience,
-  }: EditExperienceRequest): Promise<ProfileResponse> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-
-    if (!experienceId) {
-      throw new Error("experienceId is required");
-    }
-
-    const url = this.buildUrl("/users/me/edit", {
-      account_id: resolvedAccountId,
-    });
-
-    const formData = this.buildExperienceFormData(resolvedAccountId, experience, experienceId);
-
-    return this.client.patchFormData<ProfileResponse>(url, formData);
-  }
-
-  private buildExperienceFormData(
-    accountId: string,
-    experience: AddExperienceRequest["experience"] | EditExperienceRequest["experience"],
-    experienceId?: string
-  ): FormData {
-    const formData = new FormData();
-
-    formData.append("type", "LINKEDIN");
-    formData.append("account_id", accountId);
-
-    // If editing, include the experience ID
-    if (experienceId) {
-      formData.append("experience[id]", experienceId);
-    }
-
-    if (experience.role) {
-      formData.append("experience[role]", experience.role);
-    }
-    if (experience.company) {
-      formData.append("experience[company]", experience.company);
-    }
-
-    if (experience.company_id) {
-      formData.append("company_id", experience.company_id);
-    }
-
-    if (experience.description) {
-      formData.append("description", experience.description);
-    }
-
-    if (experience.location) {
-      formData.append("location", experience.location);
-    }
-
-    if (experience.notify_network !== undefined) {
-      formData.append("notify_network", experience.notify_network.toString());
-    }
-
-    if (experience.start_month) {
-      formData.append(
-        "experience[seniority][start_date][month]",
-        experience.start_month.toString()
-      );
-    }
-    if (experience.start_year) {
-      formData.append(
-        "experience[seniority][start_date][year]",
-        experience.start_year.toString()
-      );
-    }
-
-    if (experience.end_month) {
-      formData.append(
-        "experience[seniority][end_date][month]",
-        experience.end_month.toString()
-      );
-    }
-    if (experience.end_year) {
-      formData.append(
-        "experience[seniority][end_date][year]",
-        experience.end_year.toString()
-      );
-    }
-
-    if (experience.skills && Array.isArray(experience.skills)) {
-      for (const skill of experience.skills) {
-        formData.append("skills", skill);
-      }
-    }
-
-    return formData;
-  }
-}

package/src/services/searchService.ts

@@ -1,88 +0,0 @@
-import { HttpClient } from "../client/index.js";
-import { BaseService } from "./baseService.js";
-import {
-  SearchByParamsRequest,
-  SearchByUrlRequest,
-  RetrieveSearchParametersRequest,
-  SearchResult,
-  SearchParametersResult,
-} from "../types/index.js";
-
-export class SearchService extends BaseService {
-  constructor(client: HttpClient, defaultAccountId?: string) {
-    super(client, defaultAccountId);
-  }
-
-  /**
-   * Perform a LinkedIn search using parameters
-   */
-  async byParams({
-    accountId,
-    params = {},
-    cursor,
-    limit = 10,
-  }: SearchByParamsRequest): Promise<SearchResult> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-
-    const url = this.buildUrl("/linkedin/search", {
-      account_id: resolvedAccountId,
-      limit,
-      cursor,
-    });
-
-    const body = {
-      ...params,
-      api: "classic",
-      category: "people",
-    };
-
-    return this.client.post<SearchResult>(url, body);
-  }
-
-  /**
-   * Perform a LinkedIn search using a LinkedIn URL
-   */
-  async byUrl({
-    accountId,
-    searchUrl,
-    cursor,
-    limit = 10,
-  }: SearchByUrlRequest): Promise<SearchResult> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-
-    const url = this.buildUrl("/linkedin/search", {
-      account_id: resolvedAccountId,
-      limit,
-      cursor,
-    });
-
-    const body = {
-      api: "classic",
-      category: "people",
-      url: searchUrl,
-    };
-
-    return this.client.post<SearchResult>(url, body);
-  }
-
-  /**
-   * Retrieve LinkedIn search parameter suggestions
-   */
-  async retrieveParameters({
-    accountId,
-    type,
-    keywords = "",
-    limit = 3,
-  }: RetrieveSearchParametersRequest): Promise<SearchParametersResult> {
-    const resolvedAccountId = this.resolveAccountId(accountId);
-
-    const url = this.buildUrl("/linkedin/search/parameters", {
-      account_id: resolvedAccountId,
-      keywords,
-      type: type.toUpperCase(),
-      limit,
-    });
-
-    return this.client.get<SearchParametersResult>(url);
-  }
-}

package/src/types/account.ts

@@ -1,9 +0,0 @@
-export interface ConnectParams {
-  loginCookie: string;
-}
-
-export interface ConnectResponse {
-  object: string;
-  account_id: string;
-  // Add more fields as needed based on API response
-}

package/src/types/common.ts

@@ -1,21 +0,0 @@
-export interface ServiceConfig {
-  unipileToken: string;
-  subdomain: string;
-  port: number | string;
-  accountId?: string;
-}
-
-export interface RequestHeaders {
-  accept: string;
-  "content-type": string;
-  "X-API-KEY": string;
-}
-
-export interface PaginationParams {
-  cursor?: string;
-  limit?: number;
-}
-
-export interface AccountIdParam {
-  accountId?: string;
-}

package/src/types/company.ts

@@ -1,41 +0,0 @@
-import { AccountIdParam } from "./common.js";
-
-export interface RetrieveCompanyRequest extends AccountIdParam {
-  companyId?: string;
-  companyUrl?: string;
-}
-
-export interface SearchCompanyRequest extends AccountIdParam {
-  keywords: string;
-  limit?: number;
-}
-
-export interface CompanySearchResult {
-  id: string;
-  name: string;
-  linkedin_url?: string;
-  logo_url?: string;
-  industry?: string;
-}
-
-export interface CompanySearchResponse {
-  object: string;
-  items: CompanySearchResult[];
-}
-
-export interface CompanyResponse {
-  object: string;
-  id: string;
-  name?: string;
-  industry?: string;
-  company_size?: string;
-  description?: string;
-  linkedin_url?: string;
-  website?: string;
-  locations?: Array<{
-    id?: string;
-    city?: string;
-    country?: string;
-    name?: string;
-  }>;
-}

package/src/types/index.ts

@@ -1,5 +0,0 @@
-export * from "./common.js";
-export * from "./account.js";
-export * from "./search.js";
-export * from "./profile.js";
-export * from "./company.js";

package/src/types/profile.ts

@@ -1,69 +0,0 @@
-import { AccountIdParam } from "./common.js";
-
-export interface RetrieveProfileRequest extends AccountIdParam {
-  profileId: string;
-  linkedinSections?: string[];
-  notify?: boolean;
-}
-
-export interface ProfileData {
-  headline?: string;
-  summary?: string;
-  location?: { id: string };
-  picture?: Record<string, unknown>;
-  experience?: {
-    skills?: string[];
-    [key: string]: unknown;
-  };
-  education?: Record<string, unknown>;
-  [key: string]: unknown;
-}
-
-export interface EditProfileRequest extends AccountIdParam {
-  profileData: ProfileData;
-}
-
-export interface ExperienceData {
-  role: string;
-  company: string;
-  company_id?: string;
-  description?: string;
-  location?: string;
-  start_month?: number;
-  start_year?: number;
-  end_month?: number;
-  end_year?: number;
-  skills?: string[];
-  notify_network?: boolean;
-}
-
-export interface AddExperienceRequest extends AccountIdParam {
-  experience: ExperienceData;
-}
-
-export interface EditExperienceRequest extends AccountIdParam {
-  experienceId: string;
-  experience: Partial<ExperienceData>;
-}
-
-export interface ProfileResponse {
-  object: string;
-  id: string;
-  name?: string;
-  headline?: string;
-  occupation?: string;
-  about?: string;
-  work_experience?: WorkExperience[];
-  work_experience_total_count?: number;
-  public_identifier?: string;
-}
-
-export interface WorkExperience {
-  id?: string;
-  title?: string;
-  company_name?: string;
-  company_id?: string;
-  description?: string;
-  start_date?: { month?: number; year?: number };
-  end_date?: { month?: number; year?: number };
-}

package/src/types/search.ts

@@ -1,27 +0,0 @@
-import { AccountIdParam, PaginationParams } from "./common.js";
-
-export interface SearchByParamsRequest extends AccountIdParam, PaginationParams {
-  params?: Record<string, unknown>;
-}
-
-export interface SearchByUrlRequest extends AccountIdParam, PaginationParams {
-  searchUrl: string;
-}
-
-export interface RetrieveSearchParametersRequest extends AccountIdParam {
-  type: string;
-  keywords?: string;
-  limit?: number;
-}
-
-export interface SearchResult {
-  object: string;
-  items: unknown[];
-  cursor?: string;
-  // Add more fields as needed
-}
-
-export interface SearchParametersResult {
-  object: string;
-  items: unknown[];
-}

package/src/utils/helpers.ts

@@ -1,41 +0,0 @@
-/**
- * Extracts company ID from a LinkedIn company URL
- * Handles URLs like:
- * - https://www.linkedin.com/company/company-name/
- * - https://www.linkedin.com/company/12345678/
- * - https://linkedin.com/company/company-name
- */
-export function extractCompanyIdFromUrl(url: string): string | null {
-  const match = url.match(/linkedin\.com\/company\/([^\/\?]+)/i);
-  return match ? match[1] : null;
-}
-
-/**
- * Converts nested objects to bracket notation for API compatibility
- * Example: { experience: { role: "Dev" } } -> { "experience[role]": "Dev" }
- */
-export function convertToBracketNotation(
-  obj: Record<string, unknown>,
-  prefix = ""
-): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-
-  for (const key in obj) {
-    if (obj[key] === undefined) continue;
-
-    const fullKey = prefix ? `${prefix}[${key}]` : key;
-
-    if (Array.isArray(obj[key])) {
-      result[fullKey] = obj[key];
-    } else if (typeof obj[key] === "object" && obj[key] !== null) {
-      Object.assign(
-        result,
-        convertToBracketNotation(obj[key] as Record<string, unknown>, fullKey)
-      );
-    } else {
-      result[fullKey] = obj[key];
-    }
-  }
-
-  return result;
-}

package/src/utils/index.ts

@@ -1,3 +0,0 @@
-export * from "./validators.js";
-export * from "./helpers.js";
-export * from "./urlBuilder.js";

package/src/utils/urlBuilder.ts

@@ -1,37 +0,0 @@
-type QueryParams = Record<string, string | number | boolean | undefined>;
-
-/**
- * Builds a URL with query parameters, filtering out undefined values
- * Properly joins baseUrl path with the given path
- */
-export function buildUrl(baseUrl: string, path: string, params: QueryParams = {}): string {
-  // Parse the base URL to get its components
-  const base = new URL(baseUrl);
-
-  // Join the base path with the new path (remove leading slash from path if base has trailing content)
-  const basePath = base.pathname.endsWith('/') ? base.pathname.slice(0, -1) : base.pathname;
-  const newPath = path.startsWith('/') ? path : `/${path}`;
-  base.pathname = basePath + newPath;
-
-  // Add query parameters
-  for (const [key, value] of Object.entries(params)) {
-    if (value !== undefined && value !== "") {
-      base.searchParams.append(key, String(value));
-    }
-  }
-
-  return base.toString();
-}
-
-/**
- * Appends array values as repeated query parameters
- */
-export function appendArrayParams(url: string, key: string, values: string[]): string {
-  const urlObj = new URL(url);
-
-  for (const value of values) {
-    urlObj.searchParams.append(key, value);
-  }
-
-  return urlObj.toString();
-}

package/src/utils/validators.ts

@@ -1,47 +0,0 @@
-export class ValidationError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = "ValidationError";
-  }
-}
-
-export function validateRequired(
-  params: Record<string, unknown>,
-  requiredFields: string[]
-): void {
-  for (const field of requiredFields) {
-    if (!params[field]) {
-      throw new ValidationError(`${field} must be provided`);
-    }
-  }
-}
-
-export function validateAccountId(accountId: string | undefined): void {
-  if (!accountId) {
-    throw new ValidationError("accountId must be provided");
-  }
-}
-
-export function validateProfileId(profileId: string | undefined): void {
-  if (!profileId) {
-    throw new ValidationError("profileId must be provided");
-  }
-}
-
-export function validateExperience(experience: { role?: string; company?: string } | undefined): void {
-  if (!experience || !experience.role || !experience.company) {
-    throw new ValidationError("experience with role and company is required");
-  }
-}
-
-export function validateProfileData(profileData: Record<string, unknown> | undefined): void {
-  if (!profileData || Object.keys(profileData).length === 0) {
-    throw new ValidationError("profileData must be provided with at least one field to update");
-  }
-}
-
-export function validateCompanyIdOrUrl(companyId?: string, companyUrl?: string): void {
-  if (!companyId && !companyUrl) {
-    throw new ValidationError("companyId or companyUrl must be provided");
-  }
-}

package/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022"],
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}