chore: import upstream snapshot with attribution

apps/sim/tools/sendgrid/create_template_version.ts

@@ -0,0 +1,131 @@
+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 },
+  },
+}