digital-tools 2.1.1 → 2.3.0

package/src/providers/support/zendesk.ts

@@ -20,6 +20,137 @@ import type {
 } from '../types.js'
 import { defineProvider } from '../registry.js'
 
+// =============================================================================
+// Zendesk API Response Types
+// =============================================================================
+
+/**
+ * Zendesk API error response
+ */
+interface ZendeskErrorResponse {
+  error?: string
+  description?: string
+  details?: Record<string, unknown>
+}
+
+/**
+ * Zendesk ticket from API
+ */
+interface ZendeskTicket {
+  id: number
+  subject: string
+  description: string
+  status: string
+  priority: string | null
+  type: string | null
+  requester_id: number | null
+  assignee_id: number | null
+  tags: string[]
+  created_at: string
+  updated_at: string
+  solved_at: string | null
+}
+
+/**
+ * Zendesk single ticket response
+ */
+interface ZendeskTicketResponse {
+  ticket: ZendeskTicket
+}
+
+/**
+ * Zendesk tickets list response
+ */
+interface ZendeskTicketsListResponse {
+  tickets: ZendeskTicket[]
+  count?: number
+  next_page: string | null
+  after_cursor?: string
+}
+
+/**
+ * Zendesk comment from API
+ */
+interface ZendeskComment {
+  id: number
+  body: string
+  plain_body?: string
+  author_id: number | null
+  public: boolean
+  created_at: string
+}
+
+/**
+ * Zendesk comments list response
+ */
+interface ZendeskCommentsResponse {
+  comments: ZendeskComment[]
+}
+
+/**
+ * Zendesk audit event
+ */
+interface ZendeskAuditEvent {
+  type: string
+  id?: number
+}
+
+/**
+ * Zendesk audit from ticket update
+ */
+interface ZendeskAudit {
+  id?: number
+  author_id?: number
+  created_at?: string
+  events?: ZendeskAuditEvent[]
+}
+
+/**
+ * Zendesk ticket update response with audit
+ */
+interface ZendeskTicketUpdateResponse {
+  ticket: ZendeskTicket
+  audit?: ZendeskAudit
+}
+
+/**
+ * Zendesk user from API
+ */
+interface ZendeskUser {
+  id: number
+  name: string
+  email: string
+  role: string
+  created_at: string
+}
+
+/**
+ * Zendesk single user response
+ */
+interface ZendeskUserResponse {
+  user: ZendeskUser
+}
+
+/**
+ * Zendesk users search response
+ */
+interface ZendeskUsersSearchResponse {
+  users: ZendeskUser[]
+}
+
+/**
+ * Zendesk ticket update request body
+ */
+interface ZendeskTicketUpdateBody {
+  subject?: string
+  priority?: string
+  type?: string
+  assignee_id?: string
+  tags?: string[]
+  custom_fields?: Record<string, unknown>
+  comment?: { body: string }
+}
+
 /**
  * Zendesk provider info
  */
@@ -47,9 +178,9 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
     info: zendeskInfo,
 
     async initialize(cfg: ProviderConfig): Promise<void> {
-      subdomain = cfg.subdomain as string
-      apiKey = cfg.apiKey as string
-      email = cfg.email as string
+      subdomain = cfg['subdomain'] as string
+      apiKey = cfg['apiKey'] as string
+      email = cfg['email'] as string
 
       if (!subdomain || !apiKey || !email) {
         throw new Error('Zendesk subdomain, API key, and email are required')
@@ -113,14 +244,16 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
         })
 
         if (!response.ok) {
-          const error = await response.json().catch(() => ({}))
-          throw new Error((error as any)?.error || `HTTP ${response.status}`)
+          const error = (await response.json().catch(() => ({}))) as ZendeskErrorResponse
+          throw new Error(error.error || `HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ZendeskTicketResponse
         return mapZendeskTicket(data.ticket)
       } catch (error) {
-        throw new Error(`Failed to create ticket: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        throw new Error(
+          `Failed to create ticket: ${error instanceof Error ? error.message : 'Unknown error'}`
+        )
       }
     },
 
@@ -138,30 +271,33 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           throw new Error(`HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ZendeskTicketResponse
         return mapZendeskTicket(data.ticket)
       } catch {
         return null
       }
     },
 
-    async updateTicket(ticketId: string, updates: Partial<CreateTicketOptions>): Promise<TicketData> {
-      const body: Record<string, unknown> = {
-        ticket: {
-          ...(updates.subject && { subject: updates.subject }),
-          ...(updates.priority && { priority: updates.priority }),
-          ...(updates.type && { type: updates.type }),
-          ...(updates.assigneeId && { assignee_id: updates.assigneeId }),
-          ...(updates.tags && { tags: updates.tags }),
-          ...(updates.customFields && { custom_fields: updates.customFields }),
-        },
+    async updateTicket(
+      ticketId: string,
+      updates: Partial<CreateTicketOptions>
+    ): Promise<TicketData> {
+      const ticketBody: ZendeskTicketUpdateBody = {
+        ...(updates.subject && { subject: updates.subject }),
+        ...(updates.priority && { priority: updates.priority }),
+        ...(updates.type && { type: updates.type }),
+        ...(updates.assigneeId && { assignee_id: updates.assigneeId }),
+        ...(updates.tags && { tags: updates.tags }),
+        ...(updates.customFields && { custom_fields: updates.customFields }),
       }
 
       // Add comment if description is provided
       if (updates.description) {
-        (body.ticket as any).comment = { body: updates.description }
+        ticketBody.comment = { body: updates.description }
       }
 
+      const body = { ticket: ticketBody }
+
       try {
         const response = await fetch(`${baseUrl}/tickets/${ticketId}.json`, {
           method: 'PUT',
@@ -173,14 +309,16 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
         })
 
         if (!response.ok) {
-          const error = await response.json().catch(() => ({}))
-          throw new Error((error as any)?.error || `HTTP ${response.status}`)
+          const error = (await response.json().catch(() => ({}))) as ZendeskErrorResponse
+          throw new Error(error.error || `HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ZendeskTicketResponse
         return mapZendeskTicket(data.ticket)
       } catch (error) {
-        throw new Error(`Failed to update ticket: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        throw new Error(
+          `Failed to update ticket: ${error instanceof Error ? error.message : 'Unknown error'}`
+        )
       }
     },
 
@@ -208,17 +346,19 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           throw new Error(`HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ZendeskTicketsListResponse
         const tickets = (data.tickets || []).map(mapZendeskTicket)
 
         return {
           items: tickets,
-          total: data.count,
+          ...(data.count !== undefined && { total: data.count }),
           hasMore: data.next_page !== null,
-          nextCursor: data.after_cursor,
+          ...(data.after_cursor !== undefined && { nextCursor: data.after_cursor }),
         }
       } catch (error) {
-        throw new Error(`Failed to list tickets: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        throw new Error(
+          `Failed to list tickets: ${error instanceof Error ? error.message : 'Unknown error'}`
+        )
       }
     },
 
@@ -243,7 +383,11 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
       }
     },
 
-    async addTicketComment(ticketId: string, body: string, isPublic: boolean = true): Promise<TicketCommentData> {
+    async addTicketComment(
+      ticketId: string,
+      body: string,
+      isPublic: boolean = true
+    ): Promise<TicketCommentData> {
       try {
         const response = await fetch(`${baseUrl}/tickets/${ticketId}.json`, {
           method: 'PUT',
@@ -262,13 +406,13 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
         })
 
         if (!response.ok) {
-          const error = await response.json().catch(() => ({}))
-          throw new Error((error as any)?.error || `HTTP ${response.status}`)
+          const error = (await response.json().catch(() => ({}))) as ZendeskErrorResponse
+          throw new Error(error.error || `HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
-        const audit = data.audit || {}
-        const comment = audit.events?.find((e: any) => e.type === 'Comment')
+        const data = (await response.json()) as ZendeskTicketUpdateResponse
+        const audit: ZendeskAudit = data.audit || {}
+        const comment = audit.events?.find((e: ZendeskAuditEvent) => e.type === 'Comment')
 
         return {
           id: audit.id?.toString() || '',
@@ -279,7 +423,9 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           createdAt: new Date(audit.created_at || Date.now()),
         }
       } catch (error) {
-        throw new Error(`Failed to add comment: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        throw new Error(
+          `Failed to add comment: ${error instanceof Error ? error.message : 'Unknown error'}`
+        )
       }
     },
 
@@ -296,8 +442,8 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           throw new Error(`HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
-        return (data.comments || []).map((comment: any) => ({
+        const data = (await response.json()) as ZendeskCommentsResponse
+        return (data.comments || []).map((comment: ZendeskComment) => ({
           id: comment.id.toString(),
           ticketId,
           body: comment.body || comment.plain_body || '',
@@ -306,7 +452,9 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           createdAt: new Date(comment.created_at),
         }))
       } catch (error) {
-        throw new Error(`Failed to list comments: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        throw new Error(
+          `Failed to list comments: ${error instanceof Error ? error.message : 'Unknown error'}`
+        )
       }
     },
 
@@ -324,7 +472,7 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           throw new Error(`HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ZendeskUserResponse
         return mapZendeskUser(data.user)
       } catch {
         return null
@@ -345,10 +493,12 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
           throw new Error(`HTTP ${response.status}`)
         }
 
-        const data = (await response.json()) as any
+        const data = (await response.json()) as ZendeskUsersSearchResponse
         return (data.users || []).map(mapZendeskUser)
       } catch (error) {
-        throw new Error(`Failed to search users: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        throw new Error(
+          `Failed to search users: ${error instanceof Error ? error.message : 'Unknown error'}`
+        )
       }
     },
   }
@@ -357,20 +507,20 @@ export function createZendeskProvider(config: ProviderConfig): SupportProvider {
 /**
  * Map Zendesk ticket to TicketData
  */
-function mapZendeskTicket(ticket: any): TicketData {
+function mapZendeskTicket(ticket: ZendeskTicket): TicketData {
   return {
     id: ticket.id.toString(),
     subject: ticket.subject || '',
     description: ticket.description || '',
     status: mapZendeskStatus(ticket.status),
     priority: ticket.priority || 'normal',
-    type: ticket.type,
-    requesterId: ticket.requester_id?.toString(),
-    assigneeId: ticket.assignee_id?.toString(),
+    ...(ticket.type !== null && { type: ticket.type }),
+    ...(ticket.requester_id !== null && { requesterId: ticket.requester_id.toString() }),
+    ...(ticket.assignee_id !== null && { assigneeId: ticket.assignee_id.toString() }),
     tags: ticket.tags || [],
     createdAt: new Date(ticket.created_at),
     updatedAt: new Date(ticket.updated_at),
-    solvedAt: ticket.solved_at ? new Date(ticket.solved_at) : undefined,
+    ...(ticket.solved_at !== null && { solvedAt: new Date(ticket.solved_at) }),
   }
 }
 
@@ -399,7 +549,7 @@ function mapZendeskStatus(status: string): TicketData['status'] {
 /**
  * Map Zendesk user to SupportUserData
  */
-function mapZendeskUser(user: any): SupportUserData {
+function mapZendeskUser(user: ZendeskUser): SupportUserData {
   return {
     id: user.id.toString(),
     name: user.name || '',

package/src/providers/tasks/todoist.ts

@@ -100,10 +100,7 @@ export function createTodoistProvider(config: ProviderConfig): TaskProvider {
   /**
    * Make authenticated request to Todoist API
    */
-  async function todoistRequest<T>(
-    endpoint: string,
-    options: RequestInit = {}
-  ): Promise<T> {
+  async function todoistRequest<T>(endpoint: string, options: RequestInit = {}): Promise<T> {
     const response = await fetch(`${TODOIST_API_URL}${endpoint}`, {
       ...options,
       headers: {
@@ -134,7 +131,7 @@ export function createTodoistProvider(config: ProviderConfig): TaskProvider {
       id: project.id,
       name: project.name,
       color: project.color,
-      parentId: project.parent_id,
+      ...(project.parent_id !== undefined && { parentId: project.parent_id }),
     }
   }
 
@@ -154,9 +151,9 @@ export function createTodoistProvider(config: ProviderConfig): TaskProvider {
       content: task.content,
       description: task.description,
       projectId: task.project_id,
-      parentId: task.parent_id,
+      ...(task.parent_id !== undefined && { parentId: task.parent_id }),
       priority: task.priority,
-      dueDate,
+      ...(dueDate !== undefined && { dueDate }),
       completed: task.is_completed,
       labels: task.labels,
       createdAt: new Date(task.created_at),
@@ -224,33 +221,33 @@ export function createTodoistProvider(config: ProviderConfig): TaskProvider {
       }
 
       if (task.description) {
-        body.description = task.description
+        body['description'] = task.description
       }
 
       if (task.projectId) {
-        body.project_id = task.projectId
+        body['project_id'] = task.projectId
       }
 
       if (task.parentId) {
-        body.parent_id = task.parentId
+        body['parent_id'] = task.parentId
       }
 
       if (task.priority) {
-        body.priority = task.priority
+        body['priority'] = task.priority
       }
 
       if (task.dueDate) {
-        body.due_date = task.dueDate.toISOString().split('T')[0]
+        body['due_date'] = task.dueDate.toISOString().split('T')[0]
       } else if (task.dueString) {
-        body.due_string = task.dueString
+        body['due_string'] = task.dueString
       }
 
       if (task.labels && task.labels.length > 0) {
-        body.labels = task.labels
+        body['labels'] = task.labels
       }
 
       if (task.assigneeId) {
-        body.assignee_id = task.assigneeId
+        body['assignee_id'] = task.assigneeId
       }
 
       const created = await todoistRequest<TodoistTask>('/tasks', {
@@ -274,36 +271,33 @@ export function createTodoistProvider(config: ProviderConfig): TaskProvider {
       }
     },
 
-    async updateTask(
-      taskId: string,
-      updates: Partial<CreateTaskOptions>
-    ): Promise<TaskData> {
+    async updateTask(taskId: string, updates: Partial<CreateTaskOptions>): Promise<TaskData> {
       const body: Record<string, unknown> = {}
 
       if (updates.content !== undefined) {
-        body.content = updates.content
+        body['content'] = updates.content
       }
 
       if (updates.description !== undefined) {
-        body.description = updates.description
+        body['description'] = updates.description
       }
 
       if (updates.priority !== undefined) {
-        body.priority = updates.priority
+        body['priority'] = updates.priority
       }
 
       if (updates.dueDate) {
-        body.due_date = updates.dueDate.toISOString().split('T')[0]
+        body['due_date'] = updates.dueDate.toISOString().split('T')[0]
       } else if (updates.dueString) {
-        body.due_string = updates.dueString
+        body['due_string'] = updates.dueString
       }
 
       if (updates.labels !== undefined) {
-        body.labels = updates.labels
+        body['labels'] = updates.labels
       }
 
       if (updates.assigneeId !== undefined) {
-        body.assignee_id = updates.assigneeId
+        body['assignee_id'] = updates.assigneeId
       }
 
       await todoistRequest<void>(`/tasks/${taskId}`, {

package/src/providers/video-conferencing/google-meet.ts

@@ -151,10 +151,7 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
   /**
    * Make authenticated API request
    */
-  async function apiRequest<T>(
-    endpoint: string,
-    options: RequestInit = {}
-  ): Promise<T> {
+  async function apiRequest<T>(endpoint: string, options: RequestInit = {}): Promise<T> {
     const token = await getAccessToken()
     const url = `${CALENDAR_API_URL}${endpoint}`
 
@@ -170,7 +167,9 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
     if (!response.ok) {
       const errorData = await response.json().catch(() => ({}))
       throw new Error(
-        `Google Calendar API error: ${response.status} - ${(errorData as any)?.error?.message || response.statusText}`
+        `Google Calendar API error: ${response.status} - ${
+          (errorData as any)?.error?.message || response.statusText
+        }`
       )
     }
 
@@ -190,8 +189,8 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
       topic: event.summary,
       startTime,
       duration,
-      timezone: event.start.timeZone,
-      agenda: event.description,
+      ...(event.start.timeZone !== undefined && { timezone: event.start.timeZone }),
+      ...(event.description !== undefined && { agenda: event.description }),
       joinUrl: event.hangoutLink || event.conferenceData?.entryPoints?.[0]?.uri || '',
       hostId: event.creator?.id || event.creator?.email || '',
       status: event.status === 'confirmed' ? 'waiting' : 'finished',
@@ -204,8 +203,8 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
 
     async initialize(cfg: ProviderConfig): Promise<void> {
       accessToken = cfg.accessToken as string
-      clientId = cfg.clientId as string | undefined
-      clientSecret = cfg.clientSecret as string | undefined
+      clientId = cfg['clientId'] as string | undefined
+      clientSecret = cfg['clientSecret'] as string | undefined
       refreshToken = cfg.refreshToken as string | undefined
 
       if (!accessToken) {
@@ -213,8 +212,8 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
       }
 
       // Override calendar ID if provided
-      if (cfg.calendarId) {
-        calendarId = cfg.calendarId as string
+      if (cfg['calendarId']) {
+        calendarId = cfg['calendarId'] as string
       }
     },
 
@@ -309,18 +308,18 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
 
       const body: Record<string, unknown> = {}
 
-      if (updates.topic) body.summary = updates.topic
-      if (updates.agenda !== undefined) body.description = updates.agenda
+      if (updates.topic) body['summary'] = updates.topic
+      if (updates.agenda !== undefined) body['description'] = updates.agenda
 
       if (updates.startTime) {
         const endTime = new Date(
           updates.startTime.getTime() + (updates.duration || current.duration || 60) * 60000
         )
-        body.start = {
+        body['start'] = {
           dateTime: updates.startTime.toISOString(),
           timeZone: updates.timezone || current.timezone || 'UTC',
         }
-        body.end = {
+        body['end'] = {
           dateTime: endTime.toISOString(),
           timeZone: updates.timezone || current.timezone || 'UTC',
         }
@@ -373,18 +372,16 @@ export function createGoogleMeetProvider(config: ProviderConfig): VideoConferenc
       )
 
       // Filter to only events with Meet links
-      const meetEvents = response.items.filter(
-        (event) => event.hangoutLink || event.conferenceData
-      )
+      const meetEvents = response.items.filter((event) => event.hangoutLink || event.conferenceData)
 
       return {
         items: meetEvents.map(convertEvent),
         hasMore: !!response.nextPageToken,
-        nextCursor: response.nextPageToken,
+        ...(response.nextPageToken !== undefined && { nextCursor: response.nextPageToken }),
       }
     },
 
-    endMeeting: async function(meetingId: string): Promise<boolean> {
+    endMeeting: async function (meetingId: string): Promise<boolean> {
       // Google Meet doesn't support programmatically ending meetings
       // We can delete the calendar event instead
       return await this.deleteMeeting!(meetingId)

package/src/providers/video-conferencing/jitsi.ts

@@ -136,14 +136,14 @@ export function createJitsiProvider(config: ProviderConfig): VideoConferencingPr
     return {
       id: meeting.id,
       topic: meeting.topic,
-      startTime: meeting.startTime,
-      duration: meeting.duration,
-      timezone: meeting.timezone,
-      agenda: meeting.agenda,
+      ...(meeting.startTime !== undefined && { startTime: meeting.startTime }),
+      ...(meeting.duration !== undefined && { duration: meeting.duration }),
+      ...(meeting.timezone !== undefined && { timezone: meeting.timezone }),
+      ...(meeting.agenda !== undefined && { agenda: meeting.agenda }),
       joinUrl: meeting.joinUrl,
       hostId: meeting.hostId,
       status: meeting.status,
-      password: meeting.password,
+      ...(meeting.password !== undefined && { password: meeting.password }),
       createdAt: meeting.createdAt,
     }
   }
@@ -152,9 +152,9 @@ export function createJitsiProvider(config: ProviderConfig): VideoConferencingPr
     info: jitsiInfo,
 
     async initialize(cfg: ProviderConfig): Promise<void> {
-      serverUrl = (cfg.serverUrl as string) || DEFAULT_JITSI_SERVER
-      jwtSecret = cfg.jwtSecret as string | undefined
-      hostId = (cfg.hostId as string) || 'default-host'
+      serverUrl = (cfg['serverUrl'] as string) || DEFAULT_JITSI_SERVER
+      jwtSecret = cfg['jwtSecret'] as string | undefined
+      hostId = (cfg['hostId'] as string) || 'default-host'
 
       // Remove trailing slash from server URL
       serverUrl = serverUrl.replace(/\/$/, '')
@@ -202,14 +202,14 @@ export function createJitsiProvider(config: ProviderConfig): VideoConferencingPr
       const storedMeeting: StoredMeeting = {
         id,
         topic: meeting.topic,
-        startTime: meeting.startTime,
-        duration: meeting.duration,
-        timezone: meeting.timezone,
-        agenda: meeting.agenda,
+        ...(meeting.startTime !== undefined && { startTime: meeting.startTime }),
+        ...(meeting.duration !== undefined && { duration: meeting.duration }),
+        ...(meeting.timezone !== undefined && { timezone: meeting.timezone }),
+        ...(meeting.agenda !== undefined && { agenda: meeting.agenda }),
         joinUrl,
         hostId,
         status: 'waiting',
-        password: meeting.password,
+        ...(meeting.password !== undefined && { password: meeting.password }),
         createdAt: new Date(),
         roomName,
       }
@@ -285,7 +285,7 @@ export function createJitsiProvider(config: ProviderConfig): VideoConferencingPr
       return {
         items: paginatedItems.map(convertMeeting),
         hasMore: offset + limit < items.length,
-        nextCursor: offset + limit < items.length ? (offset + limit).toString() : undefined,
+        ...(offset + limit < items.length && { nextCursor: (offset + limit).toString() }),
       }
     },