@entergreat/unipile-wrapper 1.0.5 → 1.0.7

package/README.md

@@ -7,6 +7,7 @@ A lightweight JavaScript wrapper for Unipile's social network automation platfor
 - Simplified interface for Unipile's LinkedIn API
 - Easy account connection using li_at cookies
 - Streamlined search capabilities (URL-based and parameter-based)
+- Profile management (retrieve and edit)
 - Built-in pagination support
 - Clean error handling
 - Promise-based async/await interface
@@ -87,6 +88,43 @@ try {
 }
 ```
 
+### Edit LinkedIn Profile
+Update the authenticated account's LinkedIn profile:
+
+```javascript
+try {
+  const result = await linkedinService.editProfile({
+    accountId: 'your-unipile-account-id',
+    profileData: {
+      headline: 'Senior Software Engineer | Node.js Expert'
+    }
+  });
+  console.log('Profile updated successfully:', result);
+} catch (error) {
+  console.error('Profile update failed:', error);
+}
+```
+
+#### Update multiple fields at once:
+```javascript
+try {
+  const result = await linkedinService.editProfile({
+    accountId: 'your-unipile-account-id',
+    profileData: {
+      headline: 'Full Stack Developer',
+      summary: 'Passionate developer with 10+ years of experience...',
+      location: { id: '105015875' },
+      experience: {
+        skills: ['JavaScript', 'Python', 'React', 'Node.js']
+      }
+    }
+  });
+  console.log('Profile updated successfully:', result);
+} catch (error) {
+  console.error('Profile update failed:', error);
+}
+```
+
 ## API Reference 📚
 
 ### LinkedinService
@@ -127,6 +165,41 @@ Performs a LinkedIn search through Unipile using a LinkedIn search URL.
   - `limit`: Results per page (optional, default: 10)
 - **Returns:** Promise with search results
 
+##### retrieveSearchParameters({ accountId: string, type: string, keywords?: string, limit?: number })
+Retrieves LinkedIn search parameter suggestions from Unipile.
+- **Parameters:**
+  - `accountId`: Unipile account ID (required)
+  - `type`: Parameter type to retrieve (required)
+  - `keywords`: Search keywords for suggestions (optional, default: "")
+  - `limit`: Number of suggestions (optional, default: 3)
+- **Returns:** Promise with search parameter suggestions
+
+##### retrieveProfile({ accountId: string, profileId: string, linkedinSections?: array, notify?: boolean })
+Retrieves a LinkedIn user profile through Unipile.
+- **Parameters:**
+  - `accountId`: Unipile account ID (required)
+  - `profileId`: LinkedIn profile ID or URL (required)
+  - `linkedinSections`: Array of specific LinkedIn sections to retrieve (optional, default: [])
+  - `notify`: Whether to notify the profile owner (optional, default: false)
+- **Returns:** Promise with user profile data
+
+##### editProfile({ accountId: string, profileData: object })
+Edits the LinkedIn profile of the account owner through Unipile.
+- **Parameters:**
+  - `accountId`: Unipile account ID (required)
+  - `profileData`: Object containing profile fields to update (required)
+    - Supported fields include: `headline`, `summary`, `location`, `picture`, `experience`, `education`, and more
+    - Nested objects are automatically converted to Unipile's bracket notation format
+    - Example fields:
+      - `headline`: string - Professional headline
+      - `summary`: string - Profile bio/summary
+      - `location`: object - Location with `id` field
+      - `picture`: object - Profile/cover picture settings
+      - `experience`: object - Experience data with `skills` array, positions, etc.
+      - `education`: object - Education entries
+- **Returns:** Promise with updated profile data
+- **Note:** Only the account owner's profile can be edited (the profile associated with the accountId)
+
 ## Error Handling ⚠️
 The wrapper provides error handling for common Unipile API interactions:
 - Validates required parameters (e.g., accountId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entergreat/unipile-wrapper",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "",
   "main": "src/index.js",
   "type": "module",

package/src/services/linkedinService.js

@@ -1,4 +1,33 @@
-import { get, post } from "../utils/api.js";
+import { get, post, patch } from "../utils/api.js";
+
+function extractCompanyIdFromUrl(url) {
+  // Handle URLs like:
+  // https://www.linkedin.com/company/company-name/
+  // https://www.linkedin.com/company/12345678/
+  // https://linkedin.com/company/company-name
+  const match = url.match(/linkedin\.com\/company\/([^\/\?]+)/i);
+  return match ? match[1] : null;
+}
+
+function convertToBracketNotation(obj, prefix = '') {
+  const result = {};
+
+  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], fullKey));
+    } else {
+      result[fullKey] = obj[key];
+    }
+  }
+
+  return result;
+}
 
 export default class LinkedinService {
   constructor({ uniphileToken, subdomain, port }) {
@@ -120,4 +149,49 @@ export default class LinkedinService {
       throw error;
     }
   }
+
+  // retrieve LinkedIn company by URL or ID
+  async retrieveCompany({ accountId, companyId, companyUrl }) {
+    try {
+      if (!accountId) {
+        throw "account_id must be provided";
+      }
+
+      let id = companyId;
+      if (!id && companyUrl) {
+        id = extractCompanyIdFromUrl(companyUrl);
+      }
+
+      if (!id) {
+        throw "company_id or company_url must be provided";
+      }
+
+      const url = `${this.unipileUrl}/linkedin/company/${id}?account_id=${accountId}`;
+
+      return await get(url, this.headers);
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  // edit LinkedIn profile
+  async editProfile({ accountId, profileData }) {
+    try {
+      if (!accountId) {
+        throw "account_id must be provided";
+      }
+
+      if (!profileData || Object.keys(profileData).length === 0) {
+        throw "profileData must be provided with at least one field to update";
+      }
+
+      const url = `${this.unipileUrl}/users/me/edit?account_id=${accountId}`;
+
+      const body = convertToBracketNotation(profileData);
+
+      return await patch(url, body, this.headers);
+    } catch (error) {
+      throw error;
+    }
+  }
 }

package/src/utils/api.js

@@ -17,3 +17,12 @@ export const post = async (route, body = {}, headers = {}) => {
     throw error;
   }
 };
+
+export const patch = async (route, body = {}, headers = {}) => {
+  try {
+    const response = await axios.patch(route, body, { headers });
+    return response.data;
+  } catch (error) {
+    throw error;
+  }
+};