bereach 0.2.1 → 1.3.2

package/src/models/operations/upsert-contacts.ts

@@ -0,0 +1,305 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * How this contact was found. Optional for organic creation (defaults to manual_import), required for campaign-based addition.
+ */
+export const Source = {
+  Likes: "likes",
+  Comments: "comments",
+  Reposts: "reposts",
+  Posts: "posts",
+  CompanyFollowers: "company_followers",
+  SearchResults: "search_results",
+  ManualImport: "manual_import",
+  EventAttendees: "event_attendees",
+  GroupMembers: "group_members",
+  EngagementScraping: "engagement_scraping",
+  ContentSearch: "content_search",
+  FollowersMining: "followers_mining",
+  PeopleSearch: "people_search",
+  JobSearch: "job_search",
+  CompanySearch: "company_search",
+  NetworkExpansion: "network_expansion",
+} as const;
+/**
+ * How this contact was found. Optional for organic creation (defaults to manual_import), required for campaign-based addition.
+ */
+export type Source = ClosedEnum<typeof Source>;
+
+/**
+ * Initial lifecycle stage
+ */
+export const LifecycleStage = {
+  Contact: "contact",
+  Lead: "lead",
+  Qualified: "qualified",
+  Approved: "approved",
+  Rejected: "rejected",
+} as const;
+/**
+ * Initial lifecycle stage
+ */
+export type LifecycleStage = ClosedEnum<typeof LifecycleStage>;
+
+export type ContactRequest = {
+  /**
+   * LinkedIn profile URL, URN, or bare vanity name
+   */
+  linkedinUrl: string;
+  /**
+   * LinkedIn profile URN (e.g. urn:li:fsd_profile:ACoAAA...). Improves dedup when provided alongside a vanity URL.
+   */
+  profileUrn?: string | undefined;
+  /**
+   * LinkedIn vanity slug (e.g. joshuaau). Improves dedup when provided alongside a URN.
+   */
+  publicIdentifier?: string | undefined;
+  /**
+   * Profile name
+   */
+  name: string;
+  /**
+   * How this contact was found. Optional for organic creation (defaults to manual_import), required for campaign-based addition.
+   */
+  source?: Source | undefined;
+  /**
+   * Which lead-gen angle found this (e.g., 'vp-sales-france')
+   */
+  sourceAngle?: string | undefined;
+  /**
+   * Initial lifecycle stage
+   */
+  lifecycleStage?: LifecycleStage | undefined;
+  /**
+   * Contact quality score (0-100)
+   */
+  hotScore?: number | undefined;
+  /**
+   * Agent reasoning for qualification decision
+   */
+  qualificationNotes?: string | undefined;
+  notes?: string | undefined;
+};
+
+export type UpsertContactsRequest = {
+  /**
+   * Contacts to add (single or bulk)
+   */
+  contacts: Array<ContactRequest>;
+};
+
+export type Results = {
+  created: number;
+  updated: number;
+  skipped: number;
+  errors: Array<string>;
+};
+
+export type ContactResponse = {
+  id: string;
+  linkedinUrl: string;
+  /**
+   * LinkedIn profile URN (e.g. urn:li:fsd_profile:ACoAAA...)
+   */
+  profileUrn: string | null;
+  /**
+   * LinkedIn vanity slug (e.g. joshuaau)
+   */
+  publicIdentifier: string | null;
+  name: string;
+  lifecycleStage: string;
+  hotScore: number;
+  qualificationNotes: string | null;
+  notes: string | null;
+  stageChangedAt: string | null;
+  profileData: any | null;
+  profileUpdatedAt: string | null;
+  conversationData: any | null;
+  conversationUpdatedAt: string | null;
+  outreachStatus: string;
+  lastContactedAt: string | null;
+  lastRepliedAt: string | null;
+  nextFollowUpAt: string | null;
+  draftNextDm: string | null;
+  draftNextDmGeneratedAt: string | null;
+  doNotContact: boolean;
+  tags: Array<string>;
+  createdAt: string;
+  updatedAt: string;
+};
+
+/**
+ * Contacts created or updated
+ */
+export type UpsertContactsResponse = {
+  success: true;
+  results: Results;
+  /**
+   * Full contact objects with IDs for immediate use
+   */
+  contacts: Array<ContactResponse>;
+  /**
+   * Credits consumed by this call (always 0 for contacts queries).
+   */
+  creditsUsed: number;
+  /**
+   * Seconds to wait before next call of the same type (always 0 for contacts queries).
+   */
+  retryAfter: number;
+};
+
+/** @internal */
+export const Source$outboundSchema: z.ZodMiniEnum<typeof Source> = z.enum(
+  Source,
+);
+
+/** @internal */
+export const LifecycleStage$outboundSchema: z.ZodMiniEnum<
+  typeof LifecycleStage
+> = z.enum(LifecycleStage);
+
+/** @internal */
+export type ContactRequest$Outbound = {
+  linkedinUrl: string;
+  profileUrn?: string | undefined;
+  publicIdentifier?: string | undefined;
+  name: string;
+  source: string;
+  sourceAngle?: string | undefined;
+  lifecycleStage: string;
+  hotScore?: number | undefined;
+  qualificationNotes?: string | undefined;
+  notes?: string | undefined;
+};
+
+/** @internal */
+export const ContactRequest$outboundSchema: z.ZodMiniType<
+  ContactRequest$Outbound,
+  ContactRequest
+> = z.object({
+  linkedinUrl: z.string(),
+  profileUrn: z.optional(z.string()),
+  publicIdentifier: z.optional(z.string()),
+  name: z.string(),
+  source: z._default(Source$outboundSchema, "manual_import"),
+  sourceAngle: z.optional(z.string()),
+  lifecycleStage: z._default(LifecycleStage$outboundSchema, "contact"),
+  hotScore: z.optional(z.int()),
+  qualificationNotes: z.optional(z.string()),
+  notes: z.optional(z.string()),
+});
+
+export function contactRequestToJSON(contactRequest: ContactRequest): string {
+  return JSON.stringify(ContactRequest$outboundSchema.parse(contactRequest));
+}
+
+/** @internal */
+export type UpsertContactsRequest$Outbound = {
+  contacts: Array<ContactRequest$Outbound>;
+};
+
+/** @internal */
+export const UpsertContactsRequest$outboundSchema: z.ZodMiniType<
+  UpsertContactsRequest$Outbound,
+  UpsertContactsRequest
+> = z.object({
+  contacts: z.array(z.lazy(() => ContactRequest$outboundSchema)),
+});
+
+export function upsertContactsRequestToJSON(
+  upsertContactsRequest: UpsertContactsRequest,
+): string {
+  return JSON.stringify(
+    UpsertContactsRequest$outboundSchema.parse(upsertContactsRequest),
+  );
+}
+
+/** @internal */
+export const Results$inboundSchema: z.ZodMiniType<Results, unknown> = z.object({
+  created: types.number(),
+  updated: types.number(),
+  skipped: types.number(),
+  errors: z.array(types.string()),
+});
+
+export function resultsFromJSON(
+  jsonString: string,
+): SafeParseResult<Results, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Results$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Results' from JSON`,
+  );
+}
+
+/** @internal */
+export const ContactResponse$inboundSchema: z.ZodMiniType<
+  ContactResponse,
+  unknown
+> = z.object({
+  id: types.string(),
+  linkedinUrl: types.string(),
+  profileUrn: types.nullable(types.string()),
+  publicIdentifier: types.nullable(types.string()),
+  name: types.string(),
+  lifecycleStage: types.string(),
+  hotScore: types.number(),
+  qualificationNotes: types.nullable(types.string()),
+  notes: types.nullable(types.string()),
+  stageChangedAt: types.nullable(types.string()),
+  profileData: types.nullable(z.any()),
+  profileUpdatedAt: types.nullable(types.string()),
+  conversationData: types.nullable(z.any()),
+  conversationUpdatedAt: types.nullable(types.string()),
+  outreachStatus: types.string(),
+  lastContactedAt: types.nullable(types.string()),
+  lastRepliedAt: types.nullable(types.string()),
+  nextFollowUpAt: types.nullable(types.string()),
+  draftNextDm: types.nullable(types.string()),
+  draftNextDmGeneratedAt: types.nullable(types.string()),
+  doNotContact: types.boolean(),
+  tags: z.array(types.string()),
+  createdAt: types.string(),
+  updatedAt: types.string(),
+});
+
+export function contactResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ContactResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ContactResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ContactResponse' from JSON`,
+  );
+}
+
+/** @internal */
+export const UpsertContactsResponse$inboundSchema: z.ZodMiniType<
+  UpsertContactsResponse,
+  unknown
+> = z.object({
+  success: types.literal(true),
+  results: z.lazy(() => Results$inboundSchema),
+  contacts: z.array(z.lazy(() => ContactResponse$inboundSchema)),
+  creditsUsed: types.number(),
+  retryAfter: types.number(),
+});
+
+export function upsertContactsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<UpsertContactsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => UpsertContactsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UpsertContactsResponse' from JSON`,
+  );
+}

package/src/sdk/actions.ts

@@ -0,0 +1,81 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { actionsConnectProfile } from "../funcs/actions-connect-profile.js";
+import { actionsFollowCompany } from "../funcs/actions-follow-company.js";
+import { actionsListSentInvitations } from "../funcs/actions-list-sent-invitations.js";
+import { actionsSendMessage } from "../funcs/actions-send-message.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Actions extends ClientSDK {
+  /**
+   * Send LinkedIn connection request
+   *
+   * @remarks
+   * Authenticates the requester, validates LinkedIn credentials, and sends a connection request to the specified LinkedIn profile. Rate limited to 80 requests per day per user.
+   */
+  async connectProfile(
+    request: operations.ConnectLinkedInProfileRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ConnectLinkedInProfileResponse> {
+    return unwrapAsync(actionsConnectProfile(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Send LinkedIn message
+   *
+   * @remarks
+   * Authenticates the requester, validates LinkedIn credentials, and sends a message to the specified LinkedIn recipient. Rate limited to 150 messages per day per user.
+   */
+  async sendMessage(
+    request: operations.SendLinkedInMessageRequest,
+    options?: RequestOptions,
+  ): Promise<operations.SendLinkedInMessageResponse> {
+    return unwrapAsync(actionsSendMessage(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List sent connection invitations
+   *
+   * @remarks
+   * List sent (pending) LinkedIn connection invitations. 1 credit.
+   */
+  async listSentInvitations(
+    request: operations.ListSentLinkedInInvitationsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListSentLinkedInInvitationsResponse> {
+    return unwrapAsync(actionsListSentInvitations(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Follow a company
+   *
+   * @remarks
+   * Follow a LinkedIn company page. 0 credits.
+   */
+  async followCompany(
+    request: operations.FollowLinkedInCompanyRequest,
+    options?: RequestOptions,
+  ): Promise<operations.FollowLinkedInCompanyResponse> {
+    return unwrapAsync(actionsFollowCompany(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/campaigns.ts

@@ -5,7 +5,7 @@
 import { campaignsFilter } from "../funcs/campaigns-filter.js";
 import { campaignsGetStats } from "../funcs/campaigns-get-stats.js";
 import { campaignsGetStatus } from "../funcs/campaigns-get-status.js";
-import { campaignsSyncActions } from "../funcs/campaigns-sync-actions.js";
+import { campaignsSync } from "../funcs/campaigns-sync.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
@@ -53,11 +53,11 @@ export class Campaigns extends ClientSDK {
    * @remarks
    * Manually mark actions as completed for profiles within a campaign. Use when actions were performed outside the API (e.g. manual DMs) and need to be synced. 0 credits, no rate limit.
    */
-  async syncActions(
+  async sync(
     request: operations.SyncCampaignActionsRequest,
     options?: RequestOptions,
   ): Promise<operations.SyncCampaignActionsResponse> {
-    return unwrapAsync(campaignsSyncActions(
+    return unwrapAsync(campaignsSync(
       this,
       request,
       options,

package/src/sdk/{linkedin-chat.ts → chat.ts}

@@ -2,32 +2,15 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { linkedinChatFindConversation } from "../funcs/linkedin-chat-find-conversation.js";
-import { linkedinChatGetMessages } from "../funcs/linkedin-chat-get-messages.js";
-import { linkedinChatListConversations } from "../funcs/linkedin-chat-list-conversations.js";
-import { linkedinChatSearchConversations } from "../funcs/linkedin-chat-search-conversations.js";
+import { chatArchive } from "../funcs/chat-archive.js";
+import { chatFindConversation } from "../funcs/chat-find-conversation.js";
+import { chatSearchConversations } from "../funcs/chat-search-conversations.js";
+import { chatUnreact } from "../funcs/chat-unreact.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
-export class LinkedinChat extends ClientSDK {
-  /**
-   * List LinkedIn inbox conversations
-   *
-   * @remarks
-   * List inbox conversations for the authenticated user. Returns conversations with participants, last message, and read status. Paginate via nextCursor.
-   */
-  async listConversations(
-    request: operations.ListInboxConversationsRequest,
-    options?: RequestOptions,
-  ): Promise<operations.ListInboxConversationsResponse> {
-    return unwrapAsync(linkedinChatListConversations(
-      this,
-      request,
-      options,
-    ));
-  }
-
+export class Chat extends ClientSDK {
   /**
    * Search LinkedIn conversations
    *
@@ -38,7 +21,7 @@ export class LinkedinChat extends ClientSDK {
     request: operations.SearchLinkedInConversationsRequest,
     options?: RequestOptions,
   ): Promise<operations.SearchLinkedInConversationsResponse> {
-    return unwrapAsync(linkedinChatSearchConversations(
+    return unwrapAsync(chatSearchConversations(
       this,
       request,
       options,
@@ -62,7 +45,7 @@ export class LinkedinChat extends ClientSDK {
     request: operations.FindLinkedInConversationRequest,
     options?: RequestOptions,
   ): Promise<operations.FindLinkedInConversationResponse> {
-    return unwrapAsync(linkedinChatFindConversation(
+    return unwrapAsync(chatFindConversation(
       this,
       request,
       options,
@@ -70,20 +53,33 @@ export class LinkedinChat extends ClientSDK {
   }
 
   /**
-   * Read messages from a conversation
+   * Archive a conversation
    *
    * @remarks
-   * Fetch messages from a specific LinkedIn conversation. 0 credits.
-   *
-   * Pass the full `conversationUrn` as returned by `/chats/linkedin` or `/chats/linkedin/search`. No parsing required — the server handles extraction internally.
+   * Move a LinkedIn conversation to the archive. 0 credits.
+   */
+  async archive(
+    request: operations.ArchiveConversationRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ArchiveConversationResponse> {
+    return unwrapAsync(chatArchive(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Remove emoji reaction from a message
    *
-   * Example: `{ "conversationUrn": "urn:li:msg_conversation:(urn:li:fsd_profile:ACoAAXXX,2-YWUx...)" }`
+   * @remarks
+   * Remove an emoji reaction from a LinkedIn message. 0 credits.
    */
-  async getMessages(
-    request: operations.GetConversationMessagesRequest,
+  async unreact(
+    request: operations.UnreactToMessageRequest,
     options?: RequestOptions,
-  ): Promise<operations.GetConversationMessagesResponse> {
-    return unwrapAsync(linkedinChatGetMessages(
+  ): Promise<operations.UnreactToMessageResponse> {
+    return unwrapAsync(chatUnreact(
       this,
       request,
       options,

package/src/sdk/company-pages.ts

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { companyPagesGetAnalytics } from "../funcs/company-pages-get-analytics.js";
+import { companyPagesGetPermissions } from "../funcs/company-pages-get-permissions.js";
+import { companyPagesGetPosts } from "../funcs/company-pages-get-posts.js";
+import { companyPagesList } from "../funcs/company-pages-list.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class CompanyPages extends ClientSDK {
+  /**
+   * List company pages the user administers
+   *
+   * @remarks
+   * Returns LinkedIn company pages where the authenticated user has admin access. Uses the Voyager organization admin API. Costs 1 credit.
+   */
+  async list(
+    options?: RequestOptions,
+  ): Promise<operations.ListLinkedInCompanyPagesResponse> {
+    return unwrapAsync(companyPagesList(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Get recent posts from a company page
+   *
+   * @remarks
+   * Fetch the most recent posts from a LinkedIn company page feed. Requires admin access to the company page. Costs 1 credit.
+   */
+  async getPosts(
+    request: operations.GetCompanyPagePostsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetCompanyPagePostsResponse> {
+    return unwrapAsync(companyPagesGetPosts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get admin permissions for a company page
+   *
+   * @remarks
+   * Returns the authenticated user's admin permissions on a given LinkedIn company page. Use this to check what actions (post, comment, like, message, analytics) are available before calling write endpoints. Costs 1 credit.
+   */
+  async getPermissions(
+    request: operations.GetCompanyPagePermissionsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetCompanyPagePermissionsResponse> {
+    return unwrapAsync(companyPagesGetPermissions(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Get company page overview analytics
+   *
+   * @remarks
+   * Returns overview analytics for a company page including visitor count, employee count, founding date, headquarters, description, and more. Costs 1 credit.
+   */
+  async getAnalytics(
+    request: operations.GetCompanyPageAnalyticsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetCompanyPageAnalyticsResponse> {
+    return unwrapAsync(companyPagesGetAnalytics(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/contacts.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { contactsUpsert } from "../funcs/contacts-upsert.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Contacts extends ClientSDK {
+  /**
+   * Create or upsert contacts (no campaign required)
+   *
+   * @remarks
+   * Save contacts organically without creating a campaign first. Upserts by LinkedIn URL — if the contact already exists for this user, it updates the name and optional fields. Returns full contact objects with IDs so the AI agent can immediately log activities and update lifecycle stages.
+   */
+  async upsert(
+    request: operations.UpsertContactsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.UpsertContactsResponse> {
+    return unwrapAsync(contactsUpsert(
+      this,
+      request,
+      options,
+    ));
+  }
+}