@entergreat/unipile-wrapper 1.0.11 → 2.1.0

package/dist/utils/urlBuilder.d.ts

@@ -0,0 +1,11 @@
+type QueryParams = Record<string, string | number | boolean | undefined>;
+/**
+ * Builds a URL with query parameters, filtering out undefined values
+ */
+export declare function buildUrl(baseUrl: string, path: string, params?: QueryParams): string;
+/**
+ * Appends array values as repeated query parameters
+ */
+export declare function appendArrayParams(url: string, key: string, values: string[]): string;
+export {};
+//# sourceMappingURL=urlBuilder.d.ts.map

package/dist/utils/urlBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlBuilder.d.ts","sourceRoot":"","sources":["../../src/utils/urlBuilder.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;AAEzE;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,MAAM,CAUxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAQpF"}

package/dist/utils/urlBuilder.js

@@ -0,0 +1,23 @@
+/**
+ * Builds a URL with query parameters, filtering out undefined values
+ */
+export function buildUrl(baseUrl, path, params = {}) {
+    const url = new URL(path, baseUrl);
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== "") {
+            url.searchParams.append(key, String(value));
+        }
+    }
+    return url.toString();
+}
+/**
+ * Appends array values as repeated query parameters
+ */
+export function appendArrayParams(url, key, values) {
+    const urlObj = new URL(url);
+    for (const value of values) {
+        urlObj.searchParams.append(key, value);
+    }
+    return urlObj.toString();
+}
+//# sourceMappingURL=urlBuilder.js.map

package/dist/utils/urlBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlBuilder.js","sourceRoot":"","sources":["../../src/utils/urlBuilder.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAY,EAAE,SAAsB,EAAE;IAC9E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,GAAW,EAAE,MAAgB;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAE5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/utils/validators.d.ts

@@ -0,0 +1,13 @@
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare function validateRequired(params: Record<string, unknown>, requiredFields: string[]): void;
+export declare function validateAccountId(accountId: string | undefined): void;
+export declare function validateProfileId(profileId: string | undefined): void;
+export declare function validateExperience(experience: {
+    role?: string;
+    company?: string;
+} | undefined): void;
+export declare function validateProfileData(profileData: Record<string, unknown> | undefined): void;
+export declare function validateCompanyIdOrUrl(companyId?: string, companyUrl?: string): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/utils/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,EAAE,GACvB,IAAI,CAMN;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIrE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIrE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,CAIpG;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAI1F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpF"}

package/dist/utils/validators.js

@@ -0,0 +1,39 @@
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
+export function validateRequired(params, requiredFields) {
+    for (const field of requiredFields) {
+        if (!params[field]) {
+            throw new ValidationError(`${field} must be provided`);
+        }
+    }
+}
+export function validateAccountId(accountId) {
+    if (!accountId) {
+        throw new ValidationError("accountId must be provided");
+    }
+}
+export function validateProfileId(profileId) {
+    if (!profileId) {
+        throw new ValidationError("profileId must be provided");
+    }
+}
+export function validateExperience(experience) {
+    if (!experience || !experience.role || !experience.company) {
+        throw new ValidationError("experience with role and company is required");
+    }
+}
+export function validateProfileData(profileData) {
+    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, companyUrl) {
+    if (!companyId && !companyUrl) {
+        throw new ValidationError("companyId or companyUrl must be provided");
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAA+B,EAC/B,cAAwB;IAExB,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA6B;IAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,4BAA4B,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA6B;IAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,4BAA4B,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAA2D;IAC5F,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,IAAI,eAAe,CAAC,8CAA8C,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAgD;IAClF,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,eAAe,CAAC,gEAAgE,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAkB,EAAE,UAAmB;IAC5E,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,eAAe,CAAC,0CAA0C,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,27 +1,38 @@
 {
   "name": "@entergreat/unipile-wrapper",
-  "version": "1.0.11",
-  "description": "",
-  "main": "src/index.js",
+  "version": "2.1.0",
+  "description": "A lightweight TypeScript wrapper for Unipile's LinkedIn API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "start": "src/index.js"
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nivkman/unipile-wrapper.git"
   },
-  "keywords": [],
+  "keywords": [
+    "unipile",
+    "linkedin",
+    "automation",
+    "api-wrapper"
+  ],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/nivkman/unipile-wrapper/issues"
   },
   "homepage": "https://github.com/nivkman/unipile-wrapper#readme",
   "dependencies": {
     "axios": "^1.7.9",
-    "cors": "^2.8.5",
     "form-data": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
   }
 }

package/src/client/httpClient.ts

@@ -0,0 +1,61 @@
+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

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

package/src/index.ts

@@ -0,0 +1,31 @@
+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

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,31 @@
+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

@@ -0,0 +1,37 @@
+import { HttpClient } from "../client/index.js";
+import { BaseService } from "./baseService.js";
+import { RetrieveCompanyRequest, CompanyResponse } 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);
+  }
+}

package/src/services/index.ts

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,142 @@
+import FormData from "form-data";
+import { HttpClient } from "../client/index.js";
+import { BaseService } from "./baseService.js";
+import {
+  RetrieveProfileRequest,
+  EditProfileRequest,
+  AddExperienceRequest,
+  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);
+  }
+
+  private buildExperienceFormData(
+    accountId: string,
+    experience: AddExperienceRequest["experience"]
+  ): FormData {
+    const formData = new FormData();
+
+    formData.append("type", "LINKEDIN");
+    formData.append("account_id", accountId);
+    formData.append("experience[role]", experience.role);
+    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

@@ -0,0 +1,88 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,13 @@
+import { AccountIdParam } from "./common.js";
+
+export interface RetrieveCompanyRequest extends AccountIdParam {
+  companyId?: string;
+  companyUrl?: string;
+}
+
+export interface CompanyResponse {
+  object: string;
+  id: string;
+  name?: string;
+  // Add more fields as needed
+}

package/src/types/index.ts

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