simstudioai--sim/apps/sim/tools/sendgrid/create_template_version.ts

import type {
  CreateTemplateVersionParams,
  SendGridTemplateVersionRequest,
  TemplateVersionResult,
} from '@/tools/sendgrid/types'
import type { ToolConfig } from '@/tools/types'

const INACTIVE_VALUES: unknown[] = [false, 'false', 0, '0']

/** Coerces any dynamic-reference form of SendGrid's active flag (boolean, string, or
 *  number) to the 0/1 integer the API requires. Shared with the block's own
 *  pre-coercion in blocks/blocks/sendgrid.ts so both layers stay in sync. */
export function toActiveFlag(active: unknown): 0 | 1 {
  if (active === undefined) return 1
  return INACTIVE_VALUES.includes(active) ? 0 : 1
}

export const sendGridCreateTemplateVersionTool: ToolConfig<
  CreateTemplateVersionParams,
  TemplateVersionResult
> = {
  id: 'sendgrid_create_template_version',
  name: 'SendGrid Create Template Version',
  description: 'Create a new version of an email template in SendGrid',
  version: '1.0.0',

  params: {
    apiKey: {
      type: 'string',
      required: true,
      visibility: 'user-only',
      description: 'SendGrid API key',
    },
    templateId: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Template ID',
    },
    name: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Version name',
    },
    subject: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Email subject line',
    },
    htmlContent: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'HTML content of the template',
    },
    plainContent: {
      type: 'string',
      required: false,
      visibility: 'user-or-llm',
      description: 'Plain text content of the template',
    },
    active: {
      type: 'boolean',
      required: false,
      visibility: 'user-or-llm',
      description: 'Whether this version is active (default: true)',
    },
  },

  request: {
    url: (params) => `https://api.sendgrid.com/v3/templates/${params.templateId}/versions`,
    method: 'POST',
    headers: (params) => ({
      Authorization: `Bearer ${params.apiKey}`,
      'Content-Type': 'application/json',
    }),
    body: (params) => {
      const body: SendGridTemplateVersionRequest = {
        name: params.name,
        subject: params.subject,
        active: toActiveFlag(params.active),
      }

      if (params.htmlContent) {
        body.html_content = params.htmlContent
      }

      if (params.plainContent) {
        body.plain_content = params.plainContent
      }

      return { body: JSON.stringify(body) }
    },
  },

  transformResponse: async (response): Promise<TemplateVersionResult> => {
    if (!response.ok) {
      const error = await response.json()
      throw new Error(error.errors?.[0]?.message || 'Failed to create template version')
    }

    const data = await response.json()

    return {
      success: true,
      output: {
        id: data.id,
        templateId: data.template_id,
        name: data.name,
        subject: data.subject,
        active: data.active === 1,
        htmlContent: data.html_content ?? null,
        plainContent: data.plain_content ?? null,
        updatedAt: data.updated_at ?? null,
      },
    }
  },

  outputs: {
    id: { type: 'string', description: 'Version ID' },
    templateId: { type: 'string', description: 'Template ID' },
    name: { type: 'string', description: 'Version name' },
    subject: { type: 'string', description: 'Email subject' },
    active: { type: 'boolean', description: 'Whether this version is active' },
    htmlContent: { type: 'string', description: 'HTML content', optional: true },
    plainContent: { type: 'string', description: 'Plain text content', optional: true },
    updatedAt: { type: 'string', description: 'Last update timestamp', optional: true },
  },
}