@elevasis/core 0.7.1 → 0.8.2

package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-daily-campaign-analytics/index.ts

@@ -1,104 +1,104 @@
-import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
-import type { ExecutionContext } from '../../../../../../../base/types'
-
-interface InstantlyCredentials {
-  apiKey: string
-}
-
-export interface GetDailyCampaignAnalyticsParams {
-  campaign_id?: string
-  start_date?: string
-  end_date?: string
-}
-
-export interface GetDailyCampaignAnalyticsResult {
-  data: Array<{
-    date: string
-    sent: number
-    opened: number
-    unique_opened: number
-    replied: number
-    unique_replied: number
-    bounced: number
-    clicks: number
-    unique_clicks: number
-  }>
-}
-
-const INSTANTLY_API_BASE = 'https://api.instantly.ai/api/v2'
-
-/**
- * Get daily analytics for Instantly campaigns
- *
- * Retrieves day-by-day engagement breakdown including sends, opens, replies,
- * bounces, and clicks. When no campaign_id is provided, returns aggregate
- * daily metrics across all campaigns in the workspace.
- *
- * @param credentials - Instantly API key
- * @param params - Optional campaign ID and date range
- * @param context - Execution context for logging
- * @returns Array of daily analytics entries
- */
-export async function getDailyCampaignAnalytics(
-  credentials: InstantlyCredentials,
-  params: GetDailyCampaignAnalyticsParams,
-  context?: ExecutionContext
-): Promise<GetDailyCampaignAnalyticsResult> {
-  const { apiKey } = credentials
-  const { campaign_id, start_date, end_date } = params
-
-  const queryParams = new URLSearchParams()
-  if (campaign_id) queryParams.set('campaign_id', campaign_id)
-  if (start_date) queryParams.set('start_date', start_date)
-  if (end_date) queryParams.set('end_date', end_date)
-
-  const query = queryParams.toString()
-  const url = `${INSTANTLY_API_BASE}/campaigns/analytics/daily${query ? `?${query}` : ''}`
-
-  if (context?.logger) {
-    context.logger.info(
-      `[InstantlyAdapter] Fetching daily campaign analytics: campaign_id=${campaign_id} executionId=${context.executionId}`
-    )
-  }
-
-  const response = await withRetry(async () => {
-    const res = await fetch(url, {
-      headers: {
-        Authorization: `Bearer ${apiKey}`
-      }
-    })
-
-    if (!res.ok) {
-      throw await createHttpError(res, {
-        integration: 'instantly',
-        method: 'getDailyCampaignAnalytics',
-        organizationId: context?.organizationId
-      })
-    }
-
-    return res.json()
-  }, DEFAULT_RETRY_POLICY)
-
-  const rawData = response.data ?? response
-  const entries: Array<Record<string, unknown>> = Array.isArray(rawData) ? rawData : [rawData]
-
-  const data = entries.map((entry) => ({
-    date: String(entry.date ?? ''),
-    sent: Number(entry.sent ?? 0),
-    opened: Number(entry.opened ?? 0),
-    unique_opened: Number(entry.unique_opened ?? 0),
-    replied: Number(entry.replies ?? entry.replied ?? 0),
-    unique_replied: Number(entry.unique_replies ?? entry.unique_replied ?? 0),
-    bounced: Number(entry.bounced ?? 0),
-    clicks: Number(entry.clicks ?? 0),
-    unique_clicks: Number(entry.unique_clicks ?? 0)
-  }))
-
-  if (context?.logger) {
-    context.logger.info(
-      `[InstantlyAdapter] Daily campaign analytics fetched: campaign_id=${campaign_id} daily_entries=${data.length} executionId=${context.executionId}`
-    )
-  }
-
-  return { data }
-}
+import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
+import type { ExecutionContext } from '../../../../../../../base/types'
+
+interface InstantlyCredentials {
+  apiKey: string
+}
+
+export interface GetDailyCampaignAnalyticsParams {
+  campaign_id?: string
+  start_date?: string
+  end_date?: string
+}
+
+export interface GetDailyCampaignAnalyticsResult {
+  data: Array<{
+    date: string
+    sent: number
+    opened: number
+    unique_opened: number
+    replied: number
+    unique_replied: number
+    bounced: number
+    clicks: number
+    unique_clicks: number
+  }>
+}
+
+const INSTANTLY_API_BASE = 'https://api.instantly.ai/api/v2'
+
+/**
+ * Get daily analytics for Instantly campaigns
+ *
+ * Retrieves day-by-day engagement breakdown including sends, opens, replies,
+ * bounces, and clicks. When no campaign_id is provided, returns aggregate
+ * daily metrics across all campaigns in the workspace.
+ *
+ * @param credentials - Instantly API key
+ * @param params - Optional campaign ID and date range
+ * @param context - Execution context for logging
+ * @returns Array of daily analytics entries
+ */
+export async function getDailyCampaignAnalytics(
+  credentials: InstantlyCredentials,
+  params: GetDailyCampaignAnalyticsParams,
+  context?: ExecutionContext
+): Promise<GetDailyCampaignAnalyticsResult> {
+  const { apiKey } = credentials
+  const { campaign_id, start_date, end_date } = params
+
+  const queryParams = new URLSearchParams()
+  if (campaign_id) queryParams.set('campaign_id', campaign_id)
+  if (start_date) queryParams.set('start_date', start_date)
+  if (end_date) queryParams.set('end_date', end_date)
+
+  const query = queryParams.toString()
+  const url = `${INSTANTLY_API_BASE}/campaigns/analytics/daily${query ? `?${query}` : ''}`
+
+  if (context?.logger) {
+    context.logger.info(
+      `[InstantlyAdapter] Fetching daily campaign analytics: campaign_id=${campaign_id} executionId=${context.executionId}`
+    )
+  }
+
+  const response = await withRetry(async () => {
+    const res = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`
+      }
+    })
+
+    if (!res.ok) {
+      throw await createHttpError(res, {
+        integration: 'instantly',
+        method: 'getDailyCampaignAnalytics',
+        organizationId: context?.organizationId
+      })
+    }
+
+    return res.json()
+  }, DEFAULT_RETRY_POLICY)
+
+  const rawData = response.data ?? response
+  const entries: Array<Record<string, unknown>> = Array.isArray(rawData) ? rawData : [rawData]
+
+  const data = entries.map((entry) => ({
+    date: String(entry.date ?? ''),
+    sent: Number(entry.sent ?? 0),
+    opened: Number(entry.opened ?? 0),
+    unique_opened: Number(entry.unique_opened ?? 0),
+    replied: Number(entry.replies ?? entry.replied ?? 0),
+    unique_replied: Number(entry.unique_replies ?? entry.unique_replied ?? 0),
+    bounced: Number(entry.bounced ?? 0),
+    clicks: Number(entry.clicks ?? 0),
+    unique_clicks: Number(entry.unique_clicks ?? 0)
+  }))
+
+  if (context?.logger) {
+    context.logger.info(
+      `[InstantlyAdapter] Daily campaign analytics fetched: campaign_id=${campaign_id} daily_entries=${data.length} executionId=${context.executionId}`
+    )
+  }
+
+  return { data }
+}

package/src/execution/engine/tools/integration/server/adapters/instantly/fetch/get-emails/index.ts

@@ -1,155 +1,155 @@
-import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
-import type { ExecutionContext } from '../../../../../../../base/types'
-
-interface InstantlyCredentials {
-  apiKey: string
-}
-
-export interface GetEmailsParams {
-  email_id?: string
-  search?: string
-  campaign_id?: string
-  lead?: string
-  email_type?: 'received' | 'sent' | 'manual'
-  eaccount?: string
-  sort_order?: 'asc' | 'desc'
-  preview_only?: boolean
-  is_unread?: boolean
-  limit?: number
-  starting_after?: string
-}
-
-export interface GetEmailsResult {
-  emails: unknown[]
-  total_count: number
-  next_starting_after?: string
-}
-
-const INSTANTLY_API_BASE = 'https://api.instantly.ai/api/v2'
-
-/**
- * Get emails from Instantly workspace
- *
- * Retrieves email data with optional filtering and pagination.
- * Can fetch a specific email by ID or list emails with filters.
- *
- * @param credentials - Instantly API key
- * @param params - Email ID, search, filters, and pagination options
- * @param context - Execution context for logging
- * @returns Email data and pagination info
- */
-export async function getEmails(
-  credentials: InstantlyCredentials,
-  params: GetEmailsParams,
-  context?: ExecutionContext
-): Promise<GetEmailsResult> {
-  const { apiKey } = credentials
-  const {
-    email_id,
-    search,
-    campaign_id,
-    lead,
-    email_type,
-    eaccount,
-    sort_order,
-    preview_only,
-    is_unread,
-    limit,
-    starting_after
-  } = params
-
-  // If specific email ID provided, fetch that email
-  if (email_id) {
-    const emailUrl = `${INSTANTLY_API_BASE}/emails/${email_id}`
-
-    if (context?.logger) {
-      context.logger.info(`[InstantlyAdapter] Fetching email: email_id=${email_id} executionId=${context.executionId}`)
-    }
-
-    const response = await withRetry(async () => {
-      const res = await fetch(emailUrl, {
-        headers: {
-          Authorization: `Bearer ${apiKey}`
-        }
-      })
-
-      if (!res.ok) {
-        throw await createHttpError(res, {
-          integration: 'instantly',
-          method: 'getEmails',
-          organizationId: context?.organizationId
-        })
-      }
-
-      return res.json()
-    }, DEFAULT_RETRY_POLICY)
-
-    const email = response.data || response
-
-    if (context?.logger) {
-      context.logger.info(`[InstantlyAdapter] Email fetched: email_id=${email_id} executionId=${context.executionId}`)
-    }
-
-    return {
-      emails: [email],
-      total_count: 1
-    }
-  }
-
-  // Otherwise, list emails with filters and cursor pagination
-  const queryParams = new URLSearchParams()
-  if (limit) queryParams.set('limit', String(limit))
-  if (search) queryParams.set('search', search)
-  if (campaign_id) queryParams.set('campaign_id', campaign_id)
-  if (lead) queryParams.set('lead', lead)
-  if (email_type) queryParams.set('email_type', email_type)
-  if (eaccount) queryParams.set('eaccount', eaccount)
-  if (sort_order) queryParams.set('sort_order', sort_order)
-  if (preview_only !== undefined) queryParams.set('preview_only', String(preview_only))
-  if (is_unread !== undefined) queryParams.set('is_unread', String(is_unread))
-  if (starting_after) queryParams.set('starting_after', starting_after)
-
-  const listUrl = `${INSTANTLY_API_BASE}/emails${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
-
-  if (context?.logger) {
-    context.logger.info(
-      `[InstantlyAdapter] Listing emails: limit=${limit} campaign_id=${campaign_id} executionId=${context.executionId}`
-    )
-  }
-
-  const response = await withRetry(async () => {
-    const res = await fetch(listUrl, {
-      headers: {
-        Authorization: `Bearer ${apiKey}`
-      }
-    })
-
-    if (!res.ok) {
-      throw await createHttpError(res, {
-        integration: 'instantly',
-        method: 'getEmails',
-        organizationId: context?.organizationId
-      })
-    }
-
-    return res.json()
-  }, DEFAULT_RETRY_POLICY)
-
-  // Parse response - handle multiple possible API response shapes
-  const rawData = response.data ?? response
-  const emails = Array.isArray(rawData) ? rawData : rawData?.items || rawData?.emails || []
-  const total_count = emails.length
-  const next_starting_after = response.next_starting_after || response.data?.next_starting_after
-
-  if (context?.logger) {
-    context.logger.info(
-      `[InstantlyAdapter] Emails fetched: count=${emails.length} total_count=${total_count} executionId=${context.executionId}`
-    )
-  }
-
-  return {
-    emails,
-    total_count,
-    ...(next_starting_after ? { next_starting_after } : {})
-  }
-}
+import { withRetry, createHttpError, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
+import type { ExecutionContext } from '../../../../../../../base/types'
+
+interface InstantlyCredentials {
+  apiKey: string
+}
+
+export interface GetEmailsParams {
+  email_id?: string
+  search?: string
+  campaign_id?: string
+  lead?: string
+  email_type?: 'received' | 'sent' | 'manual'
+  eaccount?: string
+  sort_order?: 'asc' | 'desc'
+  preview_only?: boolean
+  is_unread?: boolean
+  limit?: number
+  starting_after?: string
+}
+
+export interface GetEmailsResult {
+  emails: unknown[]
+  total_count: number
+  next_starting_after?: string
+}
+
+const INSTANTLY_API_BASE = 'https://api.instantly.ai/api/v2'
+
+/**
+ * Get emails from Instantly workspace
+ *
+ * Retrieves email data with optional filtering and pagination.
+ * Can fetch a specific email by ID or list emails with filters.
+ *
+ * @param credentials - Instantly API key
+ * @param params - Email ID, search, filters, and pagination options
+ * @param context - Execution context for logging
+ * @returns Email data and pagination info
+ */
+export async function getEmails(
+  credentials: InstantlyCredentials,
+  params: GetEmailsParams,
+  context?: ExecutionContext
+): Promise<GetEmailsResult> {
+  const { apiKey } = credentials
+  const {
+    email_id,
+    search,
+    campaign_id,
+    lead,
+    email_type,
+    eaccount,
+    sort_order,
+    preview_only,
+    is_unread,
+    limit,
+    starting_after
+  } = params
+
+  // If specific email ID provided, fetch that email
+  if (email_id) {
+    const emailUrl = `${INSTANTLY_API_BASE}/emails/${email_id}`
+
+    if (context?.logger) {
+      context.logger.info(`[InstantlyAdapter] Fetching email: email_id=${email_id} executionId=${context.executionId}`)
+    }
+
+    const response = await withRetry(async () => {
+      const res = await fetch(emailUrl, {
+        headers: {
+          Authorization: `Bearer ${apiKey}`
+        }
+      })
+
+      if (!res.ok) {
+        throw await createHttpError(res, {
+          integration: 'instantly',
+          method: 'getEmails',
+          organizationId: context?.organizationId
+        })
+      }
+
+      return res.json()
+    }, DEFAULT_RETRY_POLICY)
+
+    const email = response.data || response
+
+    if (context?.logger) {
+      context.logger.info(`[InstantlyAdapter] Email fetched: email_id=${email_id} executionId=${context.executionId}`)
+    }
+
+    return {
+      emails: [email],
+      total_count: 1
+    }
+  }
+
+  // Otherwise, list emails with filters and cursor pagination
+  const queryParams = new URLSearchParams()
+  if (limit) queryParams.set('limit', String(limit))
+  if (search) queryParams.set('search', search)
+  if (campaign_id) queryParams.set('campaign_id', campaign_id)
+  if (lead) queryParams.set('lead', lead)
+  if (email_type) queryParams.set('email_type', email_type)
+  if (eaccount) queryParams.set('eaccount', eaccount)
+  if (sort_order) queryParams.set('sort_order', sort_order)
+  if (preview_only !== undefined) queryParams.set('preview_only', String(preview_only))
+  if (is_unread !== undefined) queryParams.set('is_unread', String(is_unread))
+  if (starting_after) queryParams.set('starting_after', starting_after)
+
+  const listUrl = `${INSTANTLY_API_BASE}/emails${queryParams.toString() ? `?${queryParams.toString()}` : ''}`
+
+  if (context?.logger) {
+    context.logger.info(
+      `[InstantlyAdapter] Listing emails: limit=${limit} campaign_id=${campaign_id} executionId=${context.executionId}`
+    )
+  }
+
+  const response = await withRetry(async () => {
+    const res = await fetch(listUrl, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`
+      }
+    })
+
+    if (!res.ok) {
+      throw await createHttpError(res, {
+        integration: 'instantly',
+        method: 'getEmails',
+        organizationId: context?.organizationId
+      })
+    }
+
+    return res.json()
+  }, DEFAULT_RETRY_POLICY)
+
+  // Parse response - handle multiple possible API response shapes
+  const rawData = response.data ?? response
+  const emails = Array.isArray(rawData) ? rawData : rawData?.items || rawData?.emails || []
+  const total_count = emails.length
+  const next_starting_after = response.next_starting_after || response.data?.next_starting_after
+
+  if (context?.logger) {
+    context.logger.info(
+      `[InstantlyAdapter] Emails fetched: count=${emails.length} total_count=${total_count} executionId=${context.executionId}`
+    )
+  }
+
+  return {
+    emails,
+    total_count,
+    ...(next_starting_after ? { next_starting_after } : {})
+  }
+}