chore: import upstream snapshot with attribution

apps/sim/tools/square/update_customer.ts

@@ -0,0 +1,138 @@
+import { ErrorExtractorId } from '@/tools/error-extractors'
+import type { CustomerResponse, UpdateCustomerParams } from '@/tools/square/types'
+import {
+  CUSTOMER_METADATA_OUTPUT_PROPERTIES,
+  CUSTOMER_OUTPUT,
+  SQUARE_BASE_URL,
+  squareHeaders,
+} from '@/tools/square/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const squareUpdateCustomerTool: ToolConfig<UpdateCustomerParams, CustomerResponse> = {
+  id: 'square_update_customer',
+  name: 'Square Update Customer',
+  description: 'Update fields on an existing customer profile',
+  version: '1.0.0',
+  errorExtractor: ErrorExtractorId.SQUARE_ERRORS,
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Square access token (personal access token)',
+    },
+    customerId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'ID of the customer to update',
+    },
+    givenName: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'First name of the customer',
+    },
+    familyName: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Last name of the customer',
+    },
+    companyName: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Business name of the customer',
+    },
+    nickname: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Nickname of the customer',
+    },
+    emailAddress: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Email address of the customer',
+    },
+    phoneNumber: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Phone number of the customer',
+    },
+    birthday: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Birthday in YYYY-MM-DD or MM-DD format',
+    },
+    note: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Note about the customer',
+    },
+    referenceId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Optional external reference for the customer',
+    },
+    address: {
+      type: 'json',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Square address object for the customer',
+    },
+  },
+
+  request: {
+    url: (params) => `${SQUARE_BASE_URL}/v2/customers/${encodeURIComponent(params.customerId)}`,
+    method: 'PUT',
+    headers: (params) => squareHeaders(params.apiKey),
+    body: (params) => {
+      const body: Record<string, unknown> = {}
+      if (params.givenName !== undefined) body.given_name = params.givenName
+      if (params.familyName !== undefined) body.family_name = params.familyName
+      if (params.companyName !== undefined) body.company_name = params.companyName
+      if (params.nickname !== undefined) body.nickname = params.nickname
+      if (params.emailAddress !== undefined) body.email_address = params.emailAddress
+      if (params.phoneNumber !== undefined) body.phone_number = params.phoneNumber
+      if (params.birthday !== undefined) body.birthday = params.birthday
+      if (params.note !== undefined) body.note = params.note
+      if (params.referenceId !== undefined) body.reference_id = params.referenceId
+      if (params.address !== undefined) body.address = params.address
+      return body
+    },
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+    const customer = data.customer ?? {}
+    return {
+      success: true,
+      output: {
+        customer,
+        metadata: {
+          id: customer.id,
+          email_address: customer.email_address ?? null,
+          given_name: customer.given_name ?? null,
+          family_name: customer.family_name ?? null,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    customer: { ...CUSTOMER_OUTPUT, description: 'The updated customer object' },
+    metadata: {
+      type: 'json',
+      description: 'Customer summary metadata',
+      properties: CUSTOMER_METADATA_OUTPUT_PROPERTIES,
+    },
+  },
+}