simstudioai--sim/apps/sim/tools/pipedrive/get_projects.ts

import { createLogger } from '@sim/logger'
import type {
  PipedriveGetProjectsParams,
  PipedriveGetProjectsResponse,
} from '@/tools/pipedrive/types'
import { getPipedriveAuthHeaders } from '@/tools/pipedrive/utils'
import type { ToolConfig } from '@/tools/types'

const logger = createLogger('PipedriveGetProjects')

export const pipedriveGetProjectsTool: ToolConfig<
  PipedriveGetProjectsParams,
  PipedriveGetProjectsResponse
> = {
  id: 'pipedrive_get_projects',
  name: 'Get Projects from Pipedrive',
  description: 'Retrieve all projects or a specific project from Pipedrive',
  version: '1.0.0',

  params: {
    accessToken: {
      type: 'string',
      required: true,
      visibility: 'hidden',
      description: 'The access token for the Pipedrive API',
    },
    authStyle: {
      type: 'string',
      required: false,
      visibility: 'hidden',
      description:
        'Auth scheme for the token; set by the credential resolver for API-token service accounts',
    },
    project_id: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Optional: ID of a specific project to retrieve (e.g., "123")',
    },
    status: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Filter by project status: open, completed, deleted (only for listing all)',
    },
    limit: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description:
        'Number of results to return (e.g., "50", default: 100, max: 500, only for listing all)',
    },
    cursor: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'For pagination, the marker representing the first item on the next page',
    },
  },

  request: {
    url: (params) => {
      // If project_id is provided, get specific project
      if (params.project_id) {
        return `https://api.pipedrive.com/v1/projects/${params.project_id}`
      }

      // Otherwise, get all projects with optional filters
      const baseUrl = 'https://api.pipedrive.com/v1/projects'
      const queryParams = new URLSearchParams()

      if (params.status) queryParams.append('status', params.status)
      if (params.limit) queryParams.append('limit', params.limit)
      if (params.cursor) queryParams.append('cursor', params.cursor)

      const queryString = queryParams.toString()
      return queryString ? `${baseUrl}?${queryString}` : baseUrl
    },
    method: 'GET',
    headers: (params) => getPipedriveAuthHeaders(params),
  },

  transformResponse: async (response: Response, params) => {
    const data = await response.json()

    if (!data.success) {
      logger.error('Pipedrive API request failed', { data })
      throw new Error(data.error || 'Failed to fetch project(s) from Pipedrive')
    }

    // If project_id was provided, return single project
    if (params?.project_id) {
      return {
        success: true,
        output: {
          project: data.data ?? null,
          success: true,
        },
      }
    }

    // Otherwise, return list of projects
    const projects = data.data || []
    const nextCursor = data.additional_data?.next_cursor ?? null
    const hasMore = nextCursor !== null

    return {
      success: true,
      output: {
        projects,
        total_items: projects.length,
        has_more: hasMore,
        next_cursor: nextCursor,
        success: true,
      },
    }
  },

  outputs: {
    projects: {
      type: 'array',
      description: 'Array of project objects (when listing all)',
      optional: true,
    },
    project: {
      type: 'object',
      description: 'Single project object (when project_id is provided)',
      optional: true,
    },
    total_items: {
      type: 'number',
      description: 'Total number of projects returned',
      optional: true,
    },
    has_more: {
      type: 'boolean',
      description: 'Whether more projects are available',
      optional: true,
    },
    next_cursor: {
      type: 'string',
      description: 'Cursor for fetching the next page',
      optional: true,
    },
    success: { type: 'boolean', description: 'Operation success status' },
  },
}