digital-tools 2.1.1 → 2.3.0

package/src/providers/email/resend.ts

@@ -23,6 +23,72 @@ import { defineProvider } from '../registry.js'
 
 const RESEND_API_URL = 'https://api.resend.com'
 
+// =============================================================================
+// Resend API Response Types
+// =============================================================================
+
+/** Resend success response for sending email */
+interface ResendSendResponse {
+  id: string
+}
+
+/** Resend error response */
+interface ResendErrorResponse {
+  name?: string
+  message?: string
+}
+
+/** Resend batch send response item */
+interface ResendBatchItem {
+  id: string
+}
+
+/** Resend batch send response */
+interface ResendBatchResponse {
+  data: ResendBatchItem[]
+}
+
+/** Resend email data from API */
+interface ResendEmailData {
+  id: string
+  from: string
+  to: string | string[]
+  cc?: string[]
+  bcc?: string[]
+  subject: string
+  text?: string
+  html?: string
+  last_event: string
+  created_at?: string
+}
+
+/** Resend DNS record from API */
+interface ResendDNSRecord {
+  type: string
+  name: string
+  value: string
+  status: string
+}
+
+/** Resend domain response from API */
+interface ResendDomainResponse {
+  name: string
+  status: string
+  records?: ResendDNSRecord[]
+}
+
+/** Resend domain list item from API */
+interface ResendDomainListItem {
+  name: string
+  status: string
+  created_at: string
+}
+
+/** Resend domains list response */
+interface ResendDomainsListResponse {
+  data?: ResendDomainListItem[]
+}
+
 /**
  * Resend provider info
  */
@@ -49,7 +115,7 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
 
     async initialize(cfg: ProviderConfig): Promise<void> {
       apiKey = cfg.apiKey as string
-      defaultFrom = cfg.defaultFrom as string | undefined
+      defaultFrom = cfg['defaultFrom'] as string | undefined
 
       if (!apiKey) {
         throw new Error('Resend API key is required')
@@ -108,7 +174,7 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
       }
 
       if (options.attachments?.length) {
-        body.attachments = options.attachments.map((att) => ({
+        body['attachments'] = options.attachments.map((att) => ({
           filename: att.filename,
           content: typeof att.content === 'string' ? att.content : att.content.toString('base64'),
           content_type: att.contentType,
@@ -116,7 +182,7 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
       }
 
       if (options.sendAt) {
-        body.scheduled_at = options.sendAt.toISOString()
+        body['scheduled_at'] = options.sendAt.toISOString()
       }
 
       try {
@@ -132,17 +198,19 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
         const data = await response.json()
 
         if (response.ok) {
+          const sendResponse = data as ResendSendResponse
           return {
             success: true,
-            messageId: (data as any).id,
+            messageId: sendResponse.id,
           }
         }
 
+        const errorResponse = data as ResendErrorResponse
         return {
           success: false,
           error: {
-            code: (data as any).name || `HTTP_${response.status}`,
-            message: (data as any).message || response.statusText,
+            code: errorResponse.name || `HTTP_${response.status}`,
+            message: errorResponse.message || response.statusText,
           },
         }
       } catch (error) {
@@ -183,18 +251,20 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
         const data = await response.json()
 
         if (response.ok) {
-          return (data as any).data.map((item: any) => ({
+          const batchResponse = data as ResendBatchResponse
+          return batchResponse.data.map((item) => ({
             success: true,
             messageId: item.id,
           }))
         }
 
         // If batch fails, return error for all
+        const errorResponse = data as ResendErrorResponse
         return emails.map(() => ({
           success: false,
           error: {
-            code: (data as any).name || `HTTP_${response.status}`,
-            message: (data as any).message || response.statusText,
+            code: errorResponse.name || `HTTP_${response.status}`,
+            message: errorResponse.message || response.statusText,
           },
         }))
       } catch (error) {
@@ -221,18 +291,18 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
           throw new Error(`HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ResendEmailData
         return {
           id: data.id,
           from: data.from,
           to: Array.isArray(data.to) ? data.to : [data.to],
-          cc: data.cc,
-          bcc: data.bcc,
+          ...(data.cc !== undefined && { cc: data.cc }),
+          ...(data.bcc !== undefined && { bcc: data.bcc }),
           subject: data.subject,
-          text: data.text,
-          html: data.html,
+          ...(data.text !== undefined && { text: data.text }),
+          ...(data.html !== undefined && { html: data.html }),
           status: mapResendStatus(data.last_event),
-          sentAt: data.created_at ? new Date(data.created_at) : undefined,
+          ...(data.created_at !== undefined && { sentAt: new Date(data.created_at) }),
         }
       } catch {
         return null
@@ -249,17 +319,18 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
         body: JSON.stringify({ name: domain }),
       })
 
-      const data = (await response.json()) as any
+      const data = (await response.json()) as ResendDomainResponse
 
       return {
         domain: data.name,
         verified: data.status === 'verified',
-        dnsRecords: data.records?.map((r: any) => ({
-          type: r.type,
-          name: r.name,
-          value: r.value,
-          verified: r.status === 'verified',
-        })) || [],
+        dnsRecords:
+          data.records?.map((r) => ({
+            type: r.type as 'TXT' | 'CNAME' | 'MX',
+            name: r.name,
+            value: r.value,
+            verified: r.status === 'verified',
+          })) || [],
       }
     },
 
@@ -270,12 +341,14 @@ export function createResendProvider(config: ProviderConfig): EmailProvider {
         },
       })
 
-      const data = (await response.json()) as any
-      return data.data?.map((d: any) => ({
-        domain: d.name,
-        verified: d.status === 'verified',
-        createdAt: new Date(d.created_at),
-      })) || []
+      const data = (await response.json()) as ResendDomainsListResponse
+      return (
+        data.data?.map((d) => ({
+          domain: d.name,
+          verified: d.status === 'verified',
+          createdAt: new Date(d.created_at),
+        })) || []
+      )
     },
   }
 }

package/src/providers/email/sendgrid.ts

@@ -47,7 +47,7 @@ export function createSendGridProvider(config: ProviderConfig): EmailProvider {
 
     async initialize(cfg: ProviderConfig): Promise<void> {
       apiKey = cfg.apiKey as string
-      defaultFrom = cfg.defaultFrom as string | undefined
+      defaultFrom = cfg['defaultFrom'] as string | undefined
 
       if (!apiKey) {
         throw new Error('SendGrid API key is required')
@@ -111,11 +111,11 @@ export function createSendGridProvider(config: ProviderConfig): EmailProvider {
       }
 
       if (options.replyTo) {
-        body.reply_to = { email: options.replyTo }
+        body['reply_to'] = { email: options.replyTo }
       }
 
       if (options.attachments?.length) {
-        body.attachments = options.attachments.map((att) => ({
+        body['attachments'] = options.attachments.map((att) => ({
           content: typeof att.content === 'string' ? att.content : att.content.toString('base64'),
           filename: att.filename,
           type: att.contentType,
@@ -125,11 +125,11 @@ export function createSendGridProvider(config: ProviderConfig): EmailProvider {
       }
 
       if (options.sendAt) {
-        body.send_at = Math.floor(options.sendAt.getTime() / 1000)
+        body['send_at'] = Math.floor(options.sendAt.getTime() / 1000)
       }
 
       if (options.trackOpens !== undefined || options.trackClicks !== undefined) {
-        body.tracking_settings = {
+        body['tracking_settings'] = {
           ...(options.trackOpens !== undefined && {
             open_tracking: { enable: options.trackOpens },
           }),
@@ -140,11 +140,11 @@ export function createSendGridProvider(config: ProviderConfig): EmailProvider {
       }
 
       if (options.tags?.length) {
-        body.categories = options.tags
+        body['categories'] = options.tags
       }
 
       if (options.metadata) {
-        body.custom_args = options.metadata
+        body['custom_args'] = options.metadata
       }
 
       try {
@@ -158,8 +158,11 @@ export function createSendGridProvider(config: ProviderConfig): EmailProvider {
         })
 
         if (response.ok || response.status === 202) {
-          const messageId = response.headers.get('X-Message-Id') || undefined
-          return { success: true, messageId }
+          const messageId = response.headers.get('X-Message-Id')
+          return {
+            success: true,
+            ...(messageId !== null && { messageId }),
+          }
         }
 
         const errorData = await response.json().catch(() => ({}))

package/src/providers/finance/stripe.ts

@@ -27,6 +27,80 @@ import { defineProvider } from '../registry.js'
 
 const STRIPE_API_URL = 'https://api.stripe.com/v1'
 
+// =============================================================================
+// Stripe API Response Types
+// =============================================================================
+
+/** Stripe API error response */
+interface StripeErrorResponse {
+  error?: {
+    message?: string
+    type?: string
+    code?: string
+  }
+}
+
+/** Stripe status transitions for invoices */
+interface StripeStatusTransitions {
+  paid_at?: number
+}
+
+/** Stripe invoice from API */
+interface StripeInvoice {
+  id: string
+  number?: string
+  customer: string
+  status: string
+  currency: string
+  subtotal: number
+  tax?: number
+  total: number
+  amount_due: number
+  amount_paid: number
+  due_date?: number
+  status_transitions?: StripeStatusTransitions
+  hosted_invoice_url?: string
+  created: number
+}
+
+/** Stripe payment intent from API */
+interface StripePaymentIntent {
+  id: string
+  amount: number
+  currency: string
+  status: string
+  customer?: string
+  invoice?: string
+  payment_method?: string
+  description?: string
+  created: number
+}
+
+/** Stripe refund from API */
+interface StripeRefund {
+  id: string
+  payment_intent: string
+  amount: number
+  status: string
+  created: number
+}
+
+/** Stripe customer from API */
+interface StripeCustomer {
+  id: string
+  name?: string
+  email?: string
+  phone?: string
+  balance?: number
+  created: number
+}
+
+/** Stripe list response wrapper */
+interface StripeListResponse<T> {
+  data: T[]
+  has_more: boolean
+}
+
 /**
  * Stripe provider info
  */
@@ -88,14 +162,12 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
     const response = await fetch(url.toString(), {
       method,
       headers,
-      body: requestBody,
+      ...(requestBody !== undefined && { body: requestBody }),
     })
 
     if (!response.ok) {
-      const error = await response.json().catch(() => ({}))
-      throw new Error(
-        (error as any)?.error?.message || `Stripe API error: ${response.status}`
-      )
+      const error = (await response.json().catch(() => ({}))) as StripeErrorResponse
+      throw new Error(error.error?.message || `Stripe API error: ${response.status}`)
     }
 
     return response.json() as Promise<T>
@@ -115,7 +187,10 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       } else if (Array.isArray(value)) {
         value.forEach((item, index) => {
           if (typeof item === 'object' && item !== null) {
-            Object.assign(result, flattenParams(item as Record<string, unknown>, `${fullKey}[${index}]`))
+            Object.assign(
+              result,
+              flattenParams(item as Record<string, unknown>, `${fullKey}[${index}]`)
+            )
           } else {
             result[`${fullKey}[${index}]`] = String(item)
           }
@@ -168,14 +243,12 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
     const response = await fetch(url.toString(), {
       method,
       headers,
-      body: requestBody,
+      ...(requestBody !== undefined && { body: requestBody }),
     })
 
     if (!response.ok) {
-      const error = await response.json().catch(() => ({}))
-      throw new Error(
-        (error as any)?.error?.message || `Stripe API error: ${response.status}`
-      )
+      const error = (await response.json().catch(() => ({}))) as StripeErrorResponse
+      throw new Error(error.error?.message || `Stripe API error: ${response.status}`)
     }
 
     return response.json() as Promise<T>
@@ -226,11 +299,11 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       }
 
       if (invoice.dueDate) {
-        data.due_date = Math.floor(invoice.dueDate.getTime() / 1000)
+        data['due_date'] = Math.floor(invoice.dueDate.getTime() / 1000)
       }
 
       if (invoice.memo) {
-        data.description = invoice.memo
+        data['description'] = invoice.memo
       }
 
       // Create the invoice
@@ -264,14 +337,16 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
         status: mapStripeInvoiceStatus(updatedInvoice.status),
         currency: updatedInvoice.currency,
         subtotal: updatedInvoice.subtotal / 100,
-        tax: updatedInvoice.tax ? updatedInvoice.tax / 100 : undefined,
+        ...(updatedInvoice.tax !== undefined && { tax: updatedInvoice.tax / 100 }),
         total: updatedInvoice.total / 100,
         amountDue: updatedInvoice.amount_due / 100,
         amountPaid: updatedInvoice.amount_paid / 100,
-        dueDate: updatedInvoice.due_date ? new Date(updatedInvoice.due_date * 1000) : undefined,
-        paidAt: updatedInvoice.status_transitions?.paid_at
-          ? new Date(updatedInvoice.status_transitions.paid_at * 1000)
-          : undefined,
+        ...(updatedInvoice.due_date !== undefined && {
+          dueDate: new Date(updatedInvoice.due_date * 1000),
+        }),
+        ...(updatedInvoice.status_transitions?.paid_at !== undefined && {
+          paidAt: new Date(updatedInvoice.status_transitions.paid_at * 1000),
+        }),
         url: updatedInvoice.hosted_invoice_url,
         createdAt: new Date(updatedInvoice.created * 1000),
       }
@@ -288,14 +363,14 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
           status: mapStripeInvoiceStatus(invoice.status),
           currency: invoice.currency,
           subtotal: invoice.subtotal / 100,
-          tax: invoice.tax ? invoice.tax / 100 : undefined,
+          ...(invoice.tax !== undefined && { tax: invoice.tax / 100 }),
           total: invoice.total / 100,
           amountDue: invoice.amount_due / 100,
           amountPaid: invoice.amount_paid / 100,
-          dueDate: invoice.due_date ? new Date(invoice.due_date * 1000) : undefined,
-          paidAt: invoice.status_transitions?.paid_at
-            ? new Date(invoice.status_transitions.paid_at * 1000)
-            : undefined,
+          ...(invoice.due_date !== undefined && { dueDate: new Date(invoice.due_date * 1000) }),
+          ...(invoice.status_transitions?.paid_at !== undefined && {
+            paidAt: new Date(invoice.status_transitions.paid_at * 1000),
+          }),
           url: invoice.hosted_invoice_url,
           createdAt: new Date(invoice.created * 1000),
         }
@@ -311,11 +386,11 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       const data: Record<string, unknown> = {}
 
       if (updates.dueDate) {
-        data.due_date = Math.floor(updates.dueDate.getTime() / 1000)
+        data['due_date'] = Math.floor(updates.dueDate.getTime() / 1000)
       }
 
       if (updates.memo) {
-        data.description = updates.memo
+        data['description'] = updates.memo
       }
 
       const invoice = await stripeRequestWithParams<any>(`/invoices/${invoiceId}`, {
@@ -330,14 +405,14 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
         status: mapStripeInvoiceStatus(invoice.status),
         currency: invoice.currency,
         subtotal: invoice.subtotal / 100,
-        tax: invoice.tax ? invoice.tax / 100 : undefined,
+        ...(invoice.tax !== undefined && { tax: invoice.tax / 100 }),
         total: invoice.total / 100,
         amountDue: invoice.amount_due / 100,
         amountPaid: invoice.amount_paid / 100,
-        dueDate: invoice.due_date ? new Date(invoice.due_date * 1000) : undefined,
-        paidAt: invoice.status_transitions?.paid_at
-          ? new Date(invoice.status_transitions.paid_at * 1000)
-          : undefined,
+        ...(invoice.due_date !== undefined && { dueDate: new Date(invoice.due_date * 1000) }),
+        ...(invoice.status_transitions?.paid_at !== undefined && {
+          paidAt: new Date(invoice.status_transitions.paid_at * 1000),
+        }),
         url: invoice.hosted_invoice_url,
         createdAt: new Date(invoice.created * 1000),
       }
@@ -347,19 +422,19 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       const params: Record<string, string> = {}
 
       if (options.limit) {
-        params.limit = String(options.limit)
+        params['limit'] = String(options.limit)
       }
 
       if (options.cursor) {
-        params.starting_after = options.cursor
+        params['starting_after'] = options.cursor
       }
 
       if (options.customerId) {
-        params.customer = options.customerId
+        params['customer'] = options.customerId
       }
 
       if (options.status) {
-        params.status = options.status
+        params['status'] = options.status
       }
 
       const response = await stripeRequest<any>('/invoices', { params })
@@ -429,11 +504,11 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       }
 
       if (payment.customerId) {
-        data.customer = payment.customerId
+        data['customer'] = payment.customerId
       }
 
       if (payment.description) {
-        data.description = payment.description
+        data['description'] = payment.description
       }
 
       // For Stripe, we create a PaymentIntent
@@ -479,15 +554,15 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       const params: Record<string, string> = {}
 
       if (options.limit) {
-        params.limit = String(options.limit)
+        params['limit'] = String(options.limit)
       }
 
       if (options.cursor) {
-        params.starting_after = options.cursor
+        params['starting_after'] = options.cursor
       }
 
       if (options.customerId) {
-        params.customer = options.customerId
+        params['customer'] = options.customerId
       }
 
       const response = await stripeRequest<any>('/payment_intents', { params })
@@ -515,7 +590,7 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       }
 
       if (amount !== undefined) {
-        data.amount = Math.round(amount * 100)
+        data['amount'] = Math.round(amount * 100)
       }
 
       const refund = await stripeRequestWithParams<any>('/refunds', {
@@ -538,15 +613,15 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       }
 
       if (customer.email) {
-        data.email = customer.email
+        data['email'] = customer.email
       }
 
       if (customer.phone) {
-        data.phone = customer.phone
+        data['phone'] = customer.phone
       }
 
       if (customer.address) {
-        data.address = {
+        data['address'] = {
           line1: customer.address.line1,
           line2: customer.address.line2,
           city: customer.address.city,
@@ -566,7 +641,7 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
         name: stripeCustomer.name,
         email: stripeCustomer.email,
         phone: stripeCustomer.phone,
-        balance: stripeCustomer.balance ? stripeCustomer.balance / 100 : undefined,
+        ...(stripeCustomer.balance !== undefined && { balance: stripeCustomer.balance / 100 }),
         createdAt: new Date(stripeCustomer.created * 1000),
       }
     },
@@ -580,7 +655,7 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
           name: customer.name,
           email: customer.email,
           phone: customer.phone,
-          balance: customer.balance ? customer.balance / 100 : undefined,
+          ...(customer.balance !== undefined && { balance: customer.balance / 100 }),
           createdAt: new Date(customer.created * 1000),
         }
       } catch (error) {
@@ -588,15 +663,17 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
       }
     },
 
-    async listCustomers(options: PaginationOptions = {}): Promise<PaginatedResult<FinanceCustomerData>> {
+    async listCustomers(
+      options: PaginationOptions = {}
+    ): Promise<PaginatedResult<FinanceCustomerData>> {
       const params: Record<string, string> = {}
 
       if (options.limit) {
-        params.limit = String(options.limit)
+        params['limit'] = String(options.limit)
       }
 
       if (options.cursor) {
-        params.starting_after = options.cursor
+        params['starting_after'] = options.cursor
       }
 
       const response = await stripeRequest<any>('/customers', { params })
@@ -620,7 +697,9 @@ export function createStripeProvider(config: ProviderConfig): FinanceProvider {
 /**
  * Map Stripe invoice status to standard status
  */
-function mapStripeInvoiceStatus(status: string): 'draft' | 'open' | 'paid' | 'void' | 'uncollectible' {
+function mapStripeInvoiceStatus(
+  status: string
+): 'draft' | 'open' | 'paid' | 'void' | 'uncollectible' {
   switch (status) {
     case 'draft':
       return 'draft'