@faststore/api 4.3.0-dev.0 → 4.3.0-dev.2

package/src/platforms/vtex/resolvers/getOrderEntryOperation.ts

@@ -0,0 +1,15 @@
+import type { GraphqlContext } from '..'
+import type { QueryOrderEntryOperationArgs } from '../../../__generated__/schema'
+import { BadRequestError } from '../../errors'
+
+export const getOrderEntryOperation = async (
+  _: unknown,
+  { operationId }: QueryOrderEntryOperationArgs,
+  { clients: { commerce } }: GraphqlContext
+) => {
+  if (!operationId) {
+    throw new BadRequestError('Missing operationId')
+  }
+
+  return commerce.orderEntry.getOperation({ operationId })
+}

package/src/platforms/vtex/resolvers/getOrderFormItems.ts

@@ -0,0 +1,26 @@
+import type { GraphqlContext } from '..'
+import type { QueryOrderFormItemsArgs } from '../../../__generated__/schema'
+import { BadRequestError } from '../../errors'
+
+export const getOrderFormItems = async (
+  _: unknown,
+  { orderFormId }: QueryOrderFormItemsArgs,
+  { clients: { commerce } }: GraphqlContext
+) => {
+  if (!orderFormId) {
+    throw new BadRequestError('Missing orderFormId')
+  }
+
+  const { items } = await commerce.orderEntry.getOrderFormItems({ orderFormId })
+  return (items ?? []).map((item) => ({
+    id: item.id,
+    name: item.name,
+    price: item.price,
+    listPrice: item.listPrice,
+    quantity: item.quantity,
+    imageUrl: item.imageUrl ?? null,
+    availability: item.availability,
+    seller: item.seller,
+    unitMultiplier: item.unitMultiplier ?? 1,
+  }))
+}

package/src/platforms/vtex/resolvers/mutation.ts

@@ -1,6 +1,8 @@
 import { cancelOrder } from './cancelOrder'
 import { processOrderAuthorization } from './processOrderAuthorization'
+import { startOrderEntryOperation } from './startOrderEntryOperation'
 import { subscribeToNewsletter } from './subscribeToNewsletter'
+import { uploadFileToOrderEntry } from './uploadFileToOrderEntry'
 import { validateCart } from './validateCart'
 import { validateSession } from './validateSession'
 
@@ -10,4 +12,6 @@ export const Mutation = {
   subscribeToNewsletter,
   cancelOrder,
   processOrderAuthorization,
+  uploadFileToOrderEntry,
+  startOrderEntryOperation,
 }

package/src/platforms/vtex/resolvers/query.ts

@@ -16,6 +16,8 @@ import type {
   QueryUserOrderArgs,
   UserOrderFromList,
 } from '../../../__generated__/schema'
+import { getOrderEntryOperation } from './getOrderEntryOperation'
+import { getOrderFormItems } from './getOrderFormItems'
 import {
   BadRequestError,
   ForbiddenError,
@@ -671,4 +673,6 @@ export const Query = {
 
     return result
   },
+  orderEntryOperation: getOrderEntryOperation,
+  orderFormItems: getOrderFormItems,
 }

package/src/platforms/vtex/resolvers/startOrderEntryOperation.ts

@@ -0,0 +1,23 @@
+import type { GraphqlContext } from '..'
+import type { MutationStartOrderEntryOperationArgs } from '../../../__generated__/schema'
+import { BadRequestError } from '../../errors'
+
+export const startOrderEntryOperation = async (
+  _: unknown,
+  { data }: MutationStartOrderEntryOperationArgs,
+  { clients: { commerce } }: GraphqlContext
+) => {
+  if (!data?.objectKey) {
+    throw new BadRequestError('Missing objectKey')
+  }
+
+  const orderFormId =
+    data.orderFormId ||
+    (await commerce.orderEntry.createOrderForm()).orderFormId
+
+  return commerce.orderEntry.startOperation({
+    objectKey: data.objectKey,
+    orderFormId,
+    sessionToken: data.sessionToken ?? undefined,
+  })
+}

package/src/platforms/vtex/resolvers/uploadFileToOrderEntry.ts

@@ -0,0 +1,45 @@
+import type { GraphqlContext } from '..'
+import type { MutationUploadFileToOrderEntryArgs } from '../../../__generated__/schema'
+import { BadRequestError } from '../../errors'
+
+export const uploadFileToOrderEntry = async (
+  _: unknown,
+  { data }: MutationUploadFileToOrderEntryArgs,
+  { clients: { commerce } }: GraphqlContext
+) => {
+  const { fileContent, fileName, mimeType } = data
+
+  if (!fileContent || !fileName || !mimeType) {
+    throw new BadRequestError(
+      'Missing required fields: fileContent, fileName, mimeType'
+    )
+  }
+
+  const normalized = fileContent.replaceAll(/\s/g, '')
+
+  const MAX_FILE_BYTES = 5 * 1024 * 1024
+  const estimatedBytes = Math.floor((normalized.length * 3) / 4)
+
+  if (estimatedBytes > MAX_FILE_BYTES) {
+    throw new BadRequestError('File exceeds maximum allowed size of 5MB')
+  }
+
+  const isValidBase64 =
+    /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(
+      normalized
+    )
+
+  if (!isValidBase64) {
+    throw new BadRequestError('Invalid Base64 fileContent')
+  }
+
+  const fileBuffer = Buffer.from(normalized, 'base64')
+
+  const result = await commerce.orderEntry.uploadFile({
+    fileBuffer,
+    fileName,
+    mimeType,
+  })
+
+  return result
+}

package/src/platforms/vtex/typeDefs/mutation.graphql

@@ -21,4 +21,18 @@ type Mutation {
   processOrderAuthorization(
     data: IProcessOrderAuthorization!
   ): ProcessOrderAuthorizationResponse
+  """
+  Uploads a file to the Order Entry Service and returns the S3 object key.
+  The file must be Base64-encoded and passed via the `data` input.
+  The returned `objectKey` is required to start an order entry operation.
+  """
+  uploadFileToOrderEntry(data: IOrderEntryUpload!): StoreOrderEntryUploadResult
+    @auth
+  """
+  Submits an uploaded file for bulk import into a VTEX cart via the Order Entry Service.
+  Returns an operationId to poll for the operation status.
+  """
+  startOrderEntryOperation(
+    data: IOrderEntryOperation!
+  ): StoreOrderEntryOperationResult @auth
 }

package/src/platforms/vtex/typeDefs/orderEntry.graphql

@@ -0,0 +1,61 @@
+"""
+Input for uploading a file to the Order Entry Service.
+The file is transmitted as a Base64-encoded string so it can travel
+through the standard GraphQL JSON pipeline without multipart support.
+"""
+input IOrderEntryUpload {
+  """
+  Base64-encoded file content.
+  """
+  fileContent: String!
+  """
+  Original file name (e.g. "order.csv").
+  """
+  fileName: String!
+  """
+  MIME type of the file (e.g. "text/csv", "image/png").
+  """
+  mimeType: String!
+}
+
+"""
+Result returned after uploading a file to the Order Entry Service.
+"""
+type StoreOrderEntryUploadResult {
+  objectKey: String!
+}
+
+input IOrderEntryOperation {
+  objectKey: String!
+  orderFormId: String
+  sessionToken: String
+}
+
+type StoreOrderEntryOperationResult {
+  operationId: String!
+}
+
+type StoreOrderEntryMissingItem {
+  itemId: String!
+  itemName: String
+  reason: String!
+}
+
+type StoreOrderEntryOperationStatus {
+  status: String!
+  entityId: String
+  message: String
+  missingItems: [StoreOrderEntryMissingItem!]
+}
+
+type StoreOrderFormCartItem {
+  id: String!
+  name: String!
+  price: Int!
+  listPrice: Int!
+  quantity: Int!
+  imageUrl: String
+  availability: String!
+  seller: String!
+  unitMultiplier: Float
+}

package/src/platforms/vtex/typeDefs/query.graphql

@@ -461,6 +461,15 @@ type Query {
     geoCoordinates: IStoreGeoCoordinates
   ): PickupPoints
     @cacheControl(scope: "public", sMaxAge: 300, staleWhileRevalidate: 3600)
+  """
+  Returns the status of an Order Entry Service operation by its ID.
+  """
+  orderEntryOperation(operationId: String!): StoreOrderEntryOperationStatus
+    @auth
+  """
+  Returns the items in an orderForm by its ID.
+  """
+  orderFormItems(orderFormId: String!): [StoreOrderFormCartItem!]! @auth
 }
 
 type ValidateUserData {