@elevasis/core 0.7.1 → 0.8.2

package/src/execution/engine/tools/integration/server/adapters/millionverifier/fetch/check-credits/index.ts

@@ -1,59 +1,59 @@
-import { ToolingError } from '../../../../../../types'
-import { withRetry, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
-import type { ExecutionContext } from '../../../../../../../base/types'
-import type { MillionVerifierCheckCreditsResult } from '../../../../../types/millionverifier'
-
-interface MillionVerifierCredentials {
-  apiKey: string
-}
-
-const MV_CREDITS_URL = 'https://api.millionverifier.com/api/v3/credits'
-
-/**
- * Check remaining MillionVerifier credits
- *
- * @param credentials - MillionVerifier API key
- * @param context - Execution context for logging
- * @returns Credit balance breakdown
- */
-export async function checkCredits(
-  credentials: MillionVerifierCredentials,
-  context?: ExecutionContext
-): Promise<MillionVerifierCheckCreditsResult> {
-  const { apiKey } = credentials
-
-  if (context?.logger) {
-    context.logger.info(
-      `[MillionVerifierAdapter] checkCredits: organizationId=${context.organizationId} executionId=${context.executionId}`
-    )
-  }
-
-  const url = new URL(MV_CREDITS_URL)
-  url.searchParams.set('api', apiKey)
-
-  const response = await withRetry(async () => {
-    const res = await fetch(url.toString(), {
-      method: 'GET',
-      signal: AbortSignal.timeout(30_000)
-    })
-
-    if (!res.ok) {
-      throw new ToolingError('api_error', `MillionVerifier credits API returned HTTP ${res.status}`, {
-        integration: 'millionverifier',
-        method: 'checkCredits',
-        organizationId: context?.organizationId
-      })
-    }
-
-    return res.json() as Promise<Record<string, unknown>>
-  }, DEFAULT_RETRY_POLICY)
-
-  const data = response as Record<string, unknown>
-
-  return {
-    credits: (data.credits as number) ?? 0,
-    bulkCredits: (data.bulk_credits as number) ?? 0,
-    renewingCredits: (data.renewing_credits as number) ?? 0,
-    plan: (data.plan as number) ?? 0
-  }
-}
+import { ToolingError } from '../../../../../../types'
+import { withRetry, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
+import type { ExecutionContext } from '../../../../../../../base/types'
+import type { MillionVerifierCheckCreditsResult } from '../../../../../types/millionverifier'
+
+interface MillionVerifierCredentials {
+  apiKey: string
+}
+
+const MV_CREDITS_URL = 'https://api.millionverifier.com/api/v3/credits'
+
+/**
+ * Check remaining MillionVerifier credits
+ *
+ * @param credentials - MillionVerifier API key
+ * @param context - Execution context for logging
+ * @returns Credit balance breakdown
+ */
+export async function checkCredits(
+  credentials: MillionVerifierCredentials,
+  context?: ExecutionContext
+): Promise<MillionVerifierCheckCreditsResult> {
+  const { apiKey } = credentials
+
+  if (context?.logger) {
+    context.logger.info(
+      `[MillionVerifierAdapter] checkCredits: organizationId=${context.organizationId} executionId=${context.executionId}`
+    )
+  }
+
+  const url = new URL(MV_CREDITS_URL)
+  url.searchParams.set('api', apiKey)
+
+  const response = await withRetry(async () => {
+    const res = await fetch(url.toString(), {
+      method: 'GET',
+      signal: AbortSignal.timeout(30_000)
+    })
+
+    if (!res.ok) {
+      throw new ToolingError('api_error', `MillionVerifier credits API returned HTTP ${res.status}`, {
+        integration: 'millionverifier',
+        method: 'checkCredits',
+        organizationId: context?.organizationId
+      })
+    }
+
+    return res.json() as Promise<Record<string, unknown>>
+  }, DEFAULT_RETRY_POLICY)
+
+  const data = response as Record<string, unknown>
+
+  return {
+    credits: (data.credits as number) ?? 0,
+    bulkCredits: (data.bulk_credits as number) ?? 0,
+    renewingCredits: (data.renewing_credits as number) ?? 0,
+    plan: (data.plan as number) ?? 0
+  }
+}

package/src/execution/engine/tools/integration/server/adapters/millionverifier/fetch/verify-email/index.ts

@@ -1,102 +1,102 @@
-import { ToolingError } from '../../../../../../types'
-import { withRetry, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
-import type { ExecutionContext } from '../../../../../../../base/types'
-import type { MillionVerifierVerifyEmailResult } from '../../../../../types/millionverifier'
-
-interface MillionVerifierCredentials {
-  apiKey: string
-}
-
-export interface VerifyEmailParams {
-  email: string
-}
-
-const MV_API_BASE = 'https://api.millionverifier.com/api/v3/'
-
-/**
- * Verify an email address via MillionVerifier
- *
- * Calls the MillionVerifier single-verification endpoint. The API always returns
- * HTTP 200 -- errors are signalled by result === 'error' and a non-empty error field.
- *
- * Credits are deducted for ok/invalid/disposable results; catch_all and unknown are free.
- *
- * @param credentials - MillionVerifier API key
- * @param params - Email address to verify
- * @param context - Execution context for logging
- * @returns Normalized verification result in camelCase
- */
-export async function verifyEmail(
-  credentials: MillionVerifierCredentials,
-  params: VerifyEmailParams,
-  context?: ExecutionContext
-): Promise<MillionVerifierVerifyEmailResult> {
-  const { apiKey } = credentials
-  const { email } = params
-
-  if (!email) {
-    throw new ToolingError('validation_error', 'Missing required parameter: email', {
-      integration: 'millionverifier',
-      method: 'verifyEmail'
-    })
-  }
-
-  if (context?.logger) {
-    context.logger.info(
-      `[MillionVerifierAdapter] verifyEmail: email=${email} organizationId=${context.organizationId} executionId=${context.executionId}`
-    )
-  }
-
-  const url = new URL(MV_API_BASE)
-  url.searchParams.set('api', apiKey)
-  url.searchParams.set('email', email)
-
-  const response = await withRetry(async () => {
-    const res = await fetch(url.toString(), {
-      method: 'GET',
-      signal: AbortSignal.timeout(60_000)
-    })
-
-    if (!res.ok) {
-      throw new ToolingError('api_error', `MillionVerifier API returned HTTP ${res.status}`, {
-        integration: 'millionverifier',
-        method: 'verifyEmail',
-        organizationId: context?.organizationId
-      })
-    }
-
-    return res.json() as Promise<Record<string, unknown>>
-  }, DEFAULT_RETRY_POLICY)
-
-  const data = response as Record<string, unknown>
-
-  // The API signals errors via result === 'error' with a non-empty error field
-  if (data.result === 'error' && data.error) {
-    throw new ToolingError('api_error', `MillionVerifier error: ${data.error as string}`, {
-      integration: 'millionverifier',
-      method: 'verifyEmail',
-      organizationId: context?.organizationId
-    })
-  }
-
-  if (context?.logger) {
-    context.logger.info(
-      `[MillionVerifierAdapter] verifyEmail complete: email=${email} result=${data.result ?? ''} quality=${data.quality ?? ''} organizationId=${context.organizationId}`
-    )
-  }
-
-  return {
-    email: (data.email as string) ?? email,
-    quality: (data.quality as MillionVerifierVerifyEmailResult['quality']) ?? '',
-    result: (data.result as MillionVerifierVerifyEmailResult['result']) ?? 'unknown',
-    resultCode: (data.resultcode as MillionVerifierVerifyEmailResult['resultCode']) ?? 3,
-    subresult: (data.subresult as string) ?? '',
-    free: (data.free as boolean) ?? false,
-    role: (data.role as boolean) ?? false,
-    didYouMean: (data.didyoumean as string) ?? '',
-    credits: (data.credits as number) ?? 0,
-    executionTime: (data.executiontime as number) ?? 0,
-    error: (data.error as string) ?? '',
-    liveMode: (data.livemode as boolean) ?? false
-  }
-}
+import { ToolingError } from '../../../../../../types'
+import { withRetry, DEFAULT_RETRY_POLICY } from '../../../../../../../../../platform/resilience'
+import type { ExecutionContext } from '../../../../../../../base/types'
+import type { MillionVerifierVerifyEmailResult } from '../../../../../types/millionverifier'
+
+interface MillionVerifierCredentials {
+  apiKey: string
+}
+
+export interface VerifyEmailParams {
+  email: string
+}
+
+const MV_API_BASE = 'https://api.millionverifier.com/api/v3/'
+
+/**
+ * Verify an email address via MillionVerifier
+ *
+ * Calls the MillionVerifier single-verification endpoint. The API always returns
+ * HTTP 200 -- errors are signalled by result === 'error' and a non-empty error field.
+ *
+ * Credits are deducted for ok/invalid/disposable results; catch_all and unknown are free.
+ *
+ * @param credentials - MillionVerifier API key
+ * @param params - Email address to verify
+ * @param context - Execution context for logging
+ * @returns Normalized verification result in camelCase
+ */
+export async function verifyEmail(
+  credentials: MillionVerifierCredentials,
+  params: VerifyEmailParams,
+  context?: ExecutionContext
+): Promise<MillionVerifierVerifyEmailResult> {
+  const { apiKey } = credentials
+  const { email } = params
+
+  if (!email) {
+    throw new ToolingError('validation_error', 'Missing required parameter: email', {
+      integration: 'millionverifier',
+      method: 'verifyEmail'
+    })
+  }
+
+  if (context?.logger) {
+    context.logger.info(
+      `[MillionVerifierAdapter] verifyEmail: email=${email} organizationId=${context.organizationId} executionId=${context.executionId}`
+    )
+  }
+
+  const url = new URL(MV_API_BASE)
+  url.searchParams.set('api', apiKey)
+  url.searchParams.set('email', email)
+
+  const response = await withRetry(async () => {
+    const res = await fetch(url.toString(), {
+      method: 'GET',
+      signal: AbortSignal.timeout(60_000)
+    })
+
+    if (!res.ok) {
+      throw new ToolingError('api_error', `MillionVerifier API returned HTTP ${res.status}`, {
+        integration: 'millionverifier',
+        method: 'verifyEmail',
+        organizationId: context?.organizationId
+      })
+    }
+
+    return res.json() as Promise<Record<string, unknown>>
+  }, DEFAULT_RETRY_POLICY)
+
+  const data = response as Record<string, unknown>
+
+  // The API signals errors via result === 'error' with a non-empty error field
+  if (data.result === 'error' && data.error) {
+    throw new ToolingError('api_error', `MillionVerifier error: ${data.error as string}`, {
+      integration: 'millionverifier',
+      method: 'verifyEmail',
+      organizationId: context?.organizationId
+    })
+  }
+
+  if (context?.logger) {
+    context.logger.info(
+      `[MillionVerifierAdapter] verifyEmail complete: email=${email} result=${data.result ?? ''} quality=${data.quality ?? ''} organizationId=${context.organizationId}`
+    )
+  }
+
+  return {
+    email: (data.email as string) ?? email,
+    quality: (data.quality as MillionVerifierVerifyEmailResult['quality']) ?? '',
+    result: (data.result as MillionVerifierVerifyEmailResult['result']) ?? 'unknown',
+    resultCode: (data.resultcode as MillionVerifierVerifyEmailResult['resultCode']) ?? 3,
+    subresult: (data.subresult as string) ?? '',
+    free: (data.free as boolean) ?? false,
+    role: (data.role as boolean) ?? false,
+    didYouMean: (data.didyoumean as string) ?? '',
+    credits: (data.credits as number) ?? 0,
+    executionTime: (data.executiontime as number) ?? 0,
+    error: (data.error as string) ?? '',
+    liveMode: (data.livemode as boolean) ?? false
+  }
+}

package/src/execution/engine/tools/integration/server/adapters/millionverifier/index.ts

@@ -1,17 +1,17 @@
-/**
- * MillionVerifier Integration - Barrel Export
- *
- * Exports MillionVerifier adapter and tool factory functions.
- */
-
-// ============================================================================
-// MILLIONVERIFIER ADAPTER
-// ============================================================================
-
-export { MillionVerifierAdapter } from './millionverifier-adapter'
-
-// ============================================================================
-// MILLIONVERIFIER TOOLS
-// ============================================================================
-
-export { createMillionVerifierVerifyEmailTool, createMillionVerifierCheckCreditsTool } from './millionverifier-tools'
+/**
+ * MillionVerifier Integration - Barrel Export
+ *
+ * Exports MillionVerifier adapter and tool factory functions.
+ */
+
+// ============================================================================
+// MILLIONVERIFIER ADAPTER
+// ============================================================================
+
+export { MillionVerifierAdapter } from './millionverifier-adapter'
+
+// ============================================================================
+// MILLIONVERIFIER TOOLS
+// ============================================================================
+
+export { createMillionVerifierVerifyEmailTool, createMillionVerifierCheckCreditsTool } from './millionverifier-tools'

package/src/execution/engine/tools/integration/server/adapters/millionverifier/millionverifier-adapter.ts

@@ -1,80 +1,80 @@
-import type { BaseIntegrationAdapter } from '../../../base-integration-adapter'
-import { ToolingError } from '../../../../types'
-import type { ExecutionContext } from '../../../../../base/types'
-import { verifyEmail } from './fetch/verify-email/index'
-import type { VerifyEmailParams } from './fetch/verify-email/index'
-import { checkCredits } from './fetch/check-credits/index'
-
-/**
- * MillionVerifier credentials format
- * Stored in credentials table, encrypted
- */
-interface MillionVerifierCredentials {
-  apiKey: string
-}
-
-/**
- * MillionVerifier integration adapter
- *
- * Provides access to the MillionVerifier email verification API for validating
- * email deliverability before campaigns. Uses API key as a query parameter.
- *
- * Credits are deducted for ok/invalid/disposable results; catch_all and unknown are free.
- *
- * @example
- * ```typescript
- * const adapter = new MillionVerifierAdapter()
- * const result = await adapter.call(
- *   'verifyEmail',
- *   { email: 'john@example.com' },
- *   { apiKey: 'your-api-key' },
- *   context
- * )
- * ```
- */
-export class MillionVerifierAdapter implements BaseIntegrationAdapter {
-  readonly name = 'millionverifier'
-
-  /**
-   * Call MillionVerifier API method
-   */
-  async call(
-    method: string,
-    params: unknown,
-    credentials: Record<string, unknown>,
-    context?: ExecutionContext
-  ): Promise<unknown> {
-    // Validate credentials first
-    if (!this.validateCredentials(credentials)) {
-      throw new ToolingError('credentials_invalid', 'Invalid MillionVerifier credentials', {
-        integration: this.name,
-        organizationId: context?.organizationId
-      })
-    }
-
-    // Safe to cast after validation confirms apiKey exists and is valid
-    const creds = credentials as unknown as MillionVerifierCredentials
-
-    // Route to method handler - delegate to fetch functions
-    switch (method) {
-      case 'verifyEmail':
-        return verifyEmail(creds, params as VerifyEmailParams, context)
-      case 'checkCredits':
-        return checkCredits(creds, context)
-      default:
-        throw new ToolingError('method_not_found', `Unknown MillionVerifier method: ${method}`, {
-          integration: this.name,
-          method,
-          organizationId: context?.organizationId
-        })
-    }
-  }
-
-  /**
-   * Validate MillionVerifier credentials
-   */
-  validateCredentials(credentials: Record<string, unknown>): boolean {
-    const creds = credentials as unknown as MillionVerifierCredentials
-    return !!creds.apiKey && typeof creds.apiKey === 'string' && creds.apiKey.length > 0
-  }
-}
+import type { BaseIntegrationAdapter } from '../../../base-integration-adapter'
+import { ToolingError } from '../../../../types'
+import type { ExecutionContext } from '../../../../../base/types'
+import { verifyEmail } from './fetch/verify-email/index'
+import type { VerifyEmailParams } from './fetch/verify-email/index'
+import { checkCredits } from './fetch/check-credits/index'
+
+/**
+ * MillionVerifier credentials format
+ * Stored in credentials table, encrypted
+ */
+interface MillionVerifierCredentials {
+  apiKey: string
+}
+
+/**
+ * MillionVerifier integration adapter
+ *
+ * Provides access to the MillionVerifier email verification API for validating
+ * email deliverability before campaigns. Uses API key as a query parameter.
+ *
+ * Credits are deducted for ok/invalid/disposable results; catch_all and unknown are free.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new MillionVerifierAdapter()
+ * const result = await adapter.call(
+ *   'verifyEmail',
+ *   { email: 'john@example.com' },
+ *   { apiKey: 'your-api-key' },
+ *   context
+ * )
+ * ```
+ */
+export class MillionVerifierAdapter implements BaseIntegrationAdapter {
+  readonly name = 'millionverifier'
+
+  /**
+   * Call MillionVerifier API method
+   */
+  async call(
+    method: string,
+    params: unknown,
+    credentials: Record<string, unknown>,
+    context?: ExecutionContext
+  ): Promise<unknown> {
+    // Validate credentials first
+    if (!this.validateCredentials(credentials)) {
+      throw new ToolingError('credentials_invalid', 'Invalid MillionVerifier credentials', {
+        integration: this.name,
+        organizationId: context?.organizationId
+      })
+    }
+
+    // Safe to cast after validation confirms apiKey exists and is valid
+    const creds = credentials as unknown as MillionVerifierCredentials
+
+    // Route to method handler - delegate to fetch functions
+    switch (method) {
+      case 'verifyEmail':
+        return verifyEmail(creds, params as VerifyEmailParams, context)
+      case 'checkCredits':
+        return checkCredits(creds, context)
+      default:
+        throw new ToolingError('method_not_found', `Unknown MillionVerifier method: ${method}`, {
+          integration: this.name,
+          method,
+          organizationId: context?.organizationId
+        })
+    }
+  }
+
+  /**
+   * Validate MillionVerifier credentials
+   */
+  validateCredentials(credentials: Record<string, unknown>): boolean {
+    const creds = credentials as unknown as MillionVerifierCredentials
+    return !!creds.apiKey && typeof creds.apiKey === 'string' && creds.apiKey.length > 0
+  }
+}