chore: import upstream snapshot with attribution

apps/sim/tools/shopify/create_fulfillment.ts

@@ -0,0 +1,214 @@
+import type {
+  ShopifyCreateFulfillmentParams,
+  ShopifyFulfillmentResponse,
+} from '@/tools/shopify/types'
+import { FULFILLMENT_OUTPUT_PROPERTIES } from '@/tools/shopify/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const shopifyCreateFulfillmentTool: ToolConfig<
+  ShopifyCreateFulfillmentParams,
+  ShopifyFulfillmentResponse
+> = {
+  id: 'shopify_create_fulfillment',
+  name: 'Shopify Create Fulfillment',
+  description:
+    'Create a fulfillment to mark order items as shipped. Requires a fulfillment order ID (get this from the order details).',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'shopify',
+  },
+
+  params: {
+    shopDomain: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Your Shopify store domain (e.g., mystore.myshopify.com)',
+    },
+    fulfillmentOrderId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The fulfillment order ID (e.g., gid://shopify/FulfillmentOrder/123456789)',
+    },
+    trackingNumber: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Tracking number for the shipment',
+    },
+    trackingCompany: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Shipping carrier name (e.g., UPS, FedEx, USPS, DHL)',
+    },
+    trackingUrl: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'URL to track the shipment',
+    },
+    notifyCustomer: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether to send a shipping confirmation email to the customer (default: true)',
+    },
+  },
+
+  request: {
+    url: (params) =>
+      `https://${params.shopDomain || params.idToken}/admin/api/2024-10/graphql.json`,
+    method: 'POST',
+    headers: (params) => {
+      if (!params.accessToken) {
+        throw new Error('Missing access token for Shopify API request')
+      }
+      return {
+        'Content-Type': 'application/json',
+        'X-Shopify-Access-Token': params.accessToken,
+      }
+    },
+    body: (params) => {
+      // Build tracking info if any tracking details provided
+      const trackingInfo: {
+        number?: string
+        company?: string
+        url?: string
+      } = {}
+
+      if (params.trackingNumber) {
+        trackingInfo.number = params.trackingNumber
+      }
+      if (params.trackingCompany) {
+        trackingInfo.company = params.trackingCompany
+      }
+      if (params.trackingUrl) {
+        trackingInfo.url = params.trackingUrl
+      }
+
+      const fulfillmentInput: {
+        lineItemsByFulfillmentOrder: Array<{ fulfillmentOrderId: string }>
+        notifyCustomer?: boolean
+        trackingInfo?: typeof trackingInfo
+      } = {
+        lineItemsByFulfillmentOrder: [
+          {
+            fulfillmentOrderId: params.fulfillmentOrderId.trim(),
+          },
+        ],
+        notifyCustomer: params.notifyCustomer !== false, // Default to true
+      }
+
+      // Only include trackingInfo if we have at least one tracking field
+      if (Object.keys(trackingInfo).length > 0) {
+        fulfillmentInput.trackingInfo = trackingInfo
+      }
+
+      return {
+        query: `
+          mutation fulfillmentCreate($fulfillment: FulfillmentInput!) {
+            fulfillmentCreate(fulfillment: $fulfillment) {
+              fulfillment {
+                id
+                status
+                createdAt
+                updatedAt
+                trackingInfo {
+                  company
+                  number
+                  url
+                }
+                fulfillmentLineItems(first: 50) {
+                  edges {
+                    node {
+                      id
+                      quantity
+                      lineItem {
+                        title
+                      }
+                    }
+                  }
+                }
+              }
+              userErrors {
+                field
+                message
+              }
+            }
+          }
+        `,
+        variables: {
+          fulfillment: fulfillmentInput,
+        },
+      }
+    },
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+
+    if (data.errors) {
+      return {
+        success: false,
+        error: data.errors[0]?.message || 'Failed to create fulfillment',
+        output: {},
+      }
+    }
+
+    const result = data.data?.fulfillmentCreate
+    if (!result) {
+      return {
+        success: false,
+        error: 'Failed to create fulfillment',
+        output: {},
+      }
+    }
+
+    if (result.userErrors && result.userErrors.length > 0) {
+      return {
+        success: false,
+        error: result.userErrors.map((e: { message: string }) => e.message).join(', '),
+        output: {},
+      }
+    }
+
+    const fulfillment = result.fulfillment
+    if (!fulfillment) {
+      return {
+        success: false,
+        error: 'No fulfillment returned',
+        output: {},
+      }
+    }
+
+    // Transform fulfillment line items from edges format
+    const fulfillmentLineItems =
+      fulfillment.fulfillmentLineItems?.edges?.map((edge: { node: unknown }) => edge.node) || []
+
+    return {
+      success: true,
+      output: {
+        fulfillment: {
+          id: fulfillment.id,
+          status: fulfillment.status,
+          createdAt: fulfillment.createdAt,
+          updatedAt: fulfillment.updatedAt,
+          trackingInfo: fulfillment.trackingInfo || [],
+          fulfillmentLineItems,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    fulfillment: {
+      type: 'object',
+      description: 'The created fulfillment with tracking info and fulfilled items',
+      properties: FULFILLMENT_OUTPUT_PROPERTIES,
+    },
+  },
+}