lumnisai 0.1.19 → 0.1.21

package/dist/index.cjs

@@ -11,7 +11,9 @@ const LINKEDIN_LIMITS = {
   basic: {
     connectionRequests: {
       weeklyMax: 100,
-      dailySafe: 15
+      dailySafe: 15,
+      personalizedMonthly: 10
+      // Very limited personalized requests
     },
     messages: {
       weeklyMax: 100,
@@ -25,13 +27,41 @@ const LINKEDIN_LIMITS = {
     profileViews: {
       dailyMax: 500,
       dailySafe: 250
-    }
+    },
+    openProfileMessagesMonthly: null
   },
-  premium_career: {
+  premium: {
     connectionRequests: {
+      weeklyMax: 150,
+      // Same as basic, SSI-dependent
+      dailySafe: 20,
+      personalizedMonthly: null
+      // Unlimited
+    },
+    messages: {
       weeklyMax: 150,
       dailySafe: 20
     },
+    inmail: {
+      monthlyCredits: 5,
+      maxAccumulation: 15,
+      rollover: true
+    },
+    profileViews: {
+      dailyMax: 1e3,
+      // Premium (non-SN): 150-1000/day
+      dailySafe: 500
+    },
+    openProfileMessagesMonthly: null
+  },
+  premium_career: {
+    connectionRequests: {
+      weeklyMax: 150,
+      // Same as basic, SSI-dependent
+      dailySafe: 20,
+      personalizedMonthly: null
+      // Unlimited
+    },
     messages: {
       weeklyMax: 150,
       dailySafe: 20
@@ -44,14 +74,16 @@ const LINKEDIN_LIMITS = {
     profileViews: {
       dailyMax: 1e3,
       // Premium (non-SN): 150-1000/day
-      dailySafe: 300
-    }
+      dailySafe: 500
+    },
+    openProfileMessagesMonthly: null
   },
   premium_business: {
     connectionRequests: {
       weeklyMax: 150,
       // Same as Premium Career, SSI-dependent
-      dailySafe: 20
+      dailySafe: 20,
+      personalizedMonthly: null
     },
     messages: {
       weeklyMax: 150,
@@ -65,13 +97,15 @@ const LINKEDIN_LIMITS = {
     profileViews: {
       dailyMax: 1e3,
       // Premium (non-SN): 150-1000/day
-      dailySafe: 300
-    }
+      dailySafe: 500
+    },
+    openProfileMessagesMonthly: null
   },
   sales_navigator: {
     connectionRequests: {
       weeklyMax: 200,
-      dailySafe: 25
+      dailySafe: 25,
+      personalizedMonthly: null
     },
     messages: {
       weeklyMax: 150,
@@ -84,13 +118,15 @@ const LINKEDIN_LIMITS = {
     },
     profileViews: {
       dailyMax: 2e3,
-      dailySafe: 500
-    }
+      dailySafe: 1e3
+    },
+    openProfileMessagesMonthly: null
   },
   recruiter_lite: {
     connectionRequests: {
       weeklyMax: 200,
-      dailySafe: 25
+      dailySafe: 25,
+      personalizedMonthly: null
     },
     messages: {
       weeklyMax: 200,
@@ -104,13 +140,15 @@ const LINKEDIN_LIMITS = {
     },
     profileViews: {
       dailyMax: 2e3,
-      dailySafe: 500
-    }
+      dailySafe: 1e3
+    },
+    openProfileMessagesMonthly: 1e3
   },
   recruiter_corporate: {
     connectionRequests: {
       weeklyMax: 250,
-      dailySafe: 30
+      dailySafe: 30,
+      personalizedMonthly: null
     },
     messages: {
       weeklyMax: 200,
@@ -123,10 +161,63 @@ const LINKEDIN_LIMITS = {
     },
     profileViews: {
       dailyMax: 2e3,
-      dailySafe: 500
-    }
+      dailySafe: 1e3
+    },
+    openProfileMessagesMonthly: 1e3
+  }
+};
+const UNIPILE_SAFE_LIMITS = {
+  // Connection requests per day (Unipile recommends 80-100 for paid)
+  connectionRequestsDaily: {
+    basic: 15,
+    premium: 20,
+    premium_career: 20,
+    premium_business: 20,
+    sales_navigator: 25,
+    recruiter_lite: 25,
+    recruiter_corporate: 30
+  },
+  // Messages per day (steady pace recommended)
+  messagesDaily: {
+    basic: 15,
+    premium: 20,
+    premium_career: 20,
+    premium_business: 20,
+    sales_navigator: 20,
+    recruiter_lite: 25,
+    recruiter_corporate: 30
+  },
+  // Profile views per day (stay under 50% of max)
+  profileViewsDaily: {
+    basic: 250,
+    premium: 300,
+    // 50% of 1000 max, conservative
+    premium_career: 300,
+    premium_business: 300,
+    sales_navigator: 500,
+    // 50% of 2000 max
+    recruiter_lite: 500,
+    recruiter_corporate: 500
   }
 };
+const RATE_LIMIT_COOLDOWNS = {
+  connectionRequestRejected: 3600,
+  // 1 hour after rejection
+  messageRateLimited: 1800,
+  // 30 min after rate limit
+  dailyLimitReached: 86400,
+  // 24 hours
+  weeklyLimitReached: 604800
+  // 7 days
+};
+const UNIPILE_RATE_LIMIT_ERRORS = {
+  422: "cannot_resend_yet",
+  // Connection request limit
+  429: "rate_limited",
+  // Too many requests
+  500: "server_error_possibly_rate_limited"
+  // Sometimes indicates limits
+};
 const ACTION_DELAYS = {
   betweenConnectionRequests: 30,
   betweenMessages: 15,
@@ -153,27 +244,23 @@ function canSendInmail(subscriptionType) {
   const limits = getLimits(subscriptionType);
   return limits.inmail.monthlyCredits > 0;
 }
+function hasOpenProfileMessages(subscriptionType) {
+  const limits = getLimits(subscriptionType);
+  return limits.openProfileMessagesMonthly !== null;
+}
 function getBestSubscriptionForAction(subscriptionTypes, action) {
   if (subscriptionTypes.length === 0)
     return null;
   if (subscriptionTypes.length === 1)
     return subscriptionTypes[0];
   if (action === "inmail") {
-    const priority = ["recruiter_corporate", "recruiter_lite", "sales_navigator", "premium_business", "premium_career", "basic"];
-    for (const priorityType of priority) {
-      if (subscriptionTypes.includes(priorityType))
-        return priorityType;
-    }
-  }
-  if (action === "connection_requests") {
-    const priority = ["recruiter_corporate", "sales_navigator", "recruiter_lite", "premium_business", "premium_career", "basic"];
+    const priority = ["recruiter_corporate", "sales_navigator", "recruiter_lite", "premium_business", "premium", "premium_career"];
     for (const priorityType of priority) {
       if (subscriptionTypes.includes(priorityType))
         return priorityType;
     }
-  }
-  if (action === "messages") {
-    const priority = ["recruiter_corporate", "recruiter_lite", "sales_navigator", "premium_business", "premium_career", "basic"];
+  } else {
+    const priority = ["recruiter_corporate", "sales_navigator", "recruiter_lite", "premium_business", "premium", "premium_career", "basic"];
     for (const priorityType of priority) {
       if (subscriptionTypes.includes(priorityType))
         return priorityType;
@@ -1029,23 +1116,97 @@ class MessagingResource {
     }
   }
   /**
-   * Create drafts for multiple prospects with AI generation
+   * Create drafts for multiple prospects with AI generation.
+   *
+   * **Default behavior (async):**
+   * Returns immediately with a job_id (202 response). Poll `getBatchDraftJobStatus()`
+   * for progress and results. The job continues processing in the background even
+   * if the client disconnects.
+   *
+   * **Legacy behavior (sync):**
+   * Set `wait: true` to block until completion. Not recommended for large batches
+   * as the request may timeout.
+   *
+   * @param userId - User ID or email
+   * @param request - Batch draft creation request
+   * @param options - Optional parameters
+   * @param options.wait - If true, wait for completion (legacy behavior)
+   * @returns BatchDraftJobResponse (async) or BatchDraftResponse (sync with wait=true)
+   *
+   * @example
+   * ```typescript
+   * // Async (recommended) - returns immediately with job_id
+   * const job = await client.messaging.createBatchDrafts(userId, request);
+   * if ('jobId' in job) {
+   *   // Poll for status
+   *   const status = await client.messaging.getBatchDraftJobStatus(userId, job.jobId);
+   * }
+   *
+   * // Sync (legacy) - blocks until complete
+   * const result = await client.messaging.createBatchDrafts(userId, request, { wait: true });
+   * console.log(result.drafts); // All drafts available immediately
+   * ```
    */
-  async createBatchDrafts(userId, request) {
+  async createBatchDrafts(userId, request, options) {
     const queryParams = new URLSearchParams();
     queryParams.append("user_id", userId);
+    if (options?.wait) {
+      queryParams.append("wait", "true");
+    }
     return this.http.post(
       `/messaging/drafts/batch?${queryParams.toString()}`,
       request
     );
   }
+  /**
+   * Get status and results of a batch draft job.
+   *
+   * Poll this endpoint to track progress and retrieve results for batch draft jobs
+   * created via `createBatchDrafts()`. Jobs are retained for 24 hours after creation.
+   *
+   * @param userId - User ID or email
+   * @param jobId - The job ID returned from createBatchDrafts()
+   * @returns BatchDraftJobStatusResponse with progress and results
+   * @throws NotFoundError if job not found or expired
+   *
+   * @example
+   * ```typescript
+   * // Create job
+   * const job = await client.messaging.createBatchDrafts(userId, request);
+   * if ('jobId' in job) {
+   *   // Poll until complete
+   *   let status;
+   *   do {
+   *     await new Promise(r => setTimeout(r, 1000)); // Wait 1 second
+   *     status = await client.messaging.getBatchDraftJobStatus(userId, job.jobId);
+   *     console.log(`Progress: ${status.progress.percentage}%`);
+   *   } while (status.status !== 'completed' && status.status !== 'failed');
+   *
+   *   console.log(`Created ${status.drafts.length} drafts`);
+   * }
+   * ```
+   */
+  async getBatchDraftJobStatus(userId, jobId) {
+    const queryParams = new URLSearchParams();
+    queryParams.append("user_id", userId);
+    return this.http.get(
+      `/messaging/drafts/batch/jobs/${encodeURIComponent(jobId)}?${queryParams.toString()}`
+    );
+  }
   /**
    * Create drafts for multiple prospects with real-time progress updates via Server-Sent Events (SSE).
    *
    * This method provides real-time progress updates as drafts are being created, significantly
    * improving user experience for large batch operations (30+ prospects).
    *
+   * **Resilience features:**
+   * - Job state is stored in Redis and survives client disconnects
+   * - Background task continues processing even if SSE connection drops
+   * - Client can reconnect using `jobId` option to resume streaming
+   * - Poll `getBatchDraftJobStatus()` as fallback
+   *
    * **Event Types:**
+   * - `job_started`: First event with job_id for reconnection
    * - `progress`: Progress update with percentage and current prospect
    * - `draft_created`: Draft successfully created
    * - `error`: Error occurred for a specific prospect
@@ -1053,6 +1214,8 @@ class MessagingResource {
    *
    * **Example:**
    * ```typescript
+   * let savedJobId: string | undefined;
+   *
    * const result = await client.messaging.createBatchDraftsStream(
    *   'user@example.com',
    *   {
@@ -1061,6 +1224,9 @@ class MessagingResource {
    *     useAiGeneration: true
    *   },
    *   {
+   *     onJobStarted: (jobId) => {
+   *       savedJobId = jobId; // Save for reconnection if disconnected
+   *     },
    *     onProgress: (processed, total, percentage, prospectName) => {
    *       console.log(`${percentage}% - ${prospectName}`)
    *     },
@@ -1080,11 +1246,16 @@ class MessagingResource {
    * @param userId - User ID or email
    * @param request - Batch draft creation request
    * @param callbacks - Optional callbacks for stream events
+   * @param options - Optional parameters
+   * @param options.jobId - Existing job ID to resume streaming (for reconnection)
    * @returns Final result with created drafts and error details
    */
-  async createBatchDraftsStream(userId, request, callbacks) {
+  async createBatchDraftsStream(userId, request, callbacks, options) {
     const queryParams = new URLSearchParams();
     queryParams.append("user_id", userId);
+    if (options?.jobId) {
+      queryParams.append("job_id", options.jobId);
+    }
     const baseUrl = this.http.options.baseUrl;
     const apiPrefix = this.http.options.apiPrefix || "";
     const path = `/messaging/drafts/batch/stream?${queryParams.toString()}`;
@@ -1150,6 +1321,11 @@ class MessagingResource {
             const eventData = JSON.parse(line.slice(6));
             const { event, data } = eventData;
             switch (event) {
+              case "job_started": {
+                const jobData = toCamelCase(data);
+                callbacks?.onJobStarted?.(jobData.jobId || "");
+                break;
+              }
               case "progress": {
                 const progressData = toCamelCase(data);
                 callbacks?.onProgress?.(
@@ -1204,8 +1380,15 @@ class MessagingResource {
    *
    * This method yields events as they arrive, providing more control over event handling.
    *
+   * **Resilience features:**
+   * - Job state is stored in Redis and survives client disconnects
+   * - First event is `job_started` with job_id for reconnection
+   * - Client can reconnect using `jobId` option to resume streaming
+   *
    * **Example:**
    * ```typescript
+   * let savedJobId: string | undefined;
+   *
    * for await (const event of client.messaging.createBatchDraftsStreamGenerator(
    *   'user@example.com',
    *   {
@@ -1215,6 +1398,9 @@ class MessagingResource {
    *   }
    * )) {
    *   switch (event.event) {
+   *     case 'job_started':
+   *       savedJobId = event.data.jobId; // Save for reconnection
+   *       break;
    *     case 'progress':
    *       console.log(`Progress: ${event.data.percentage}%`)
    *       break
@@ -1233,12 +1419,17 @@ class MessagingResource {
    *
    * @param userId - User ID or email
    * @param request - Batch draft creation request
+   * @param options - Optional parameters
+   * @param options.jobId - Existing job ID to resume streaming (for reconnection)
    * @yields Stream events with 'event' and 'data' keys
    * @returns Final result with created drafts and error details
    */
-  async *createBatchDraftsStreamGenerator(userId, request) {
+  async *createBatchDraftsStreamGenerator(userId, request, options) {
     const queryParams = new URLSearchParams();
     queryParams.append("user_id", userId);
+    if (options?.jobId) {
+      queryParams.append("job_id", options.jobId);
+    }
     const baseUrl = this.http.options.baseUrl;
     const apiPrefix = this.http.options.apiPrefix || "";
     const path = `/messaging/drafts/batch/stream?${queryParams.toString()}`;
@@ -2593,6 +2784,13 @@ var SyncJobStatus = /* @__PURE__ */ ((SyncJobStatus2) => {
   SyncJobStatus2["FAILED"] = "failed";
   return SyncJobStatus2;
 })(SyncJobStatus || {});
+var BatchJobStatus = /* @__PURE__ */ ((BatchJobStatus2) => {
+  BatchJobStatus2["PENDING"] = "pending";
+  BatchJobStatus2["IN_PROGRESS"] = "in_progress";
+  BatchJobStatus2["COMPLETED"] = "completed";
+  BatchJobStatus2["FAILED"] = "failed";
+  return BatchJobStatus2;
+})(BatchJobStatus || {});
 var QueueItemStatus = /* @__PURE__ */ ((QueueItemStatus2) => {
   QueueItemStatus2["QUEUED"] = "queued";
   QueueItemStatus2["PROCESSING"] = "processing";
@@ -2728,6 +2926,7 @@ function verifyWebhookSignature(payload, signature, secret) {
 
 exports.ACTION_DELAYS = ACTION_DELAYS;
 exports.AuthenticationError = AuthenticationError;
+exports.BatchJobStatus = BatchJobStatus;
 exports.ChannelType = ChannelType;
 exports.ConversationStatus = ConversationStatus;
 exports.DraftStatus = DraftStatus;
@@ -2751,9 +2950,12 @@ exports.PeopleDataSource = PeopleDataSource;
 exports.ProgressTracker = ProgressTracker;
 exports.ProviderType = ProviderType;
 exports.QueueItemStatus = QueueItemStatus;
+exports.RATE_LIMIT_COOLDOWNS = RATE_LIMIT_COOLDOWNS;
 exports.RateLimitError = RateLimitError;
 exports.SourcesNotAvailableError = SourcesNotAvailableError;
 exports.SyncJobStatus = SyncJobStatus;
+exports.UNIPILE_RATE_LIMIT_ERRORS = UNIPILE_RATE_LIMIT_ERRORS;
+exports.UNIPILE_SAFE_LIMITS = UNIPILE_SAFE_LIMITS;
 exports.ValidationError = ValidationError;
 exports.canSendInmail = canSendInmail;
 exports.displayProgress = displayProgress;
@@ -2763,4 +2965,5 @@ exports.getConnectionRequestLimit = getConnectionRequestLimit;
 exports.getInmailAllowance = getInmailAllowance;
 exports.getLimits = getLimits;
 exports.getMessageLimit = getMessageLimit;
+exports.hasOpenProfileMessages = hasOpenProfileMessages;
 exports.verifyWebhookSignature = verifyWebhookSignature;