@faststore/api 4.4.1-dev.0 → 4.5.0-dev.1

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

@@ -430,6 +430,46 @@ type Query {
     @auth
     @cacheControl(scope: "private", sMaxAge: 300, staleWhileRevalidate: 3600)
 
+  """
+  Returns the list of Quotes that the authenticated Buyer can view.
+  """
+  listUserQuotes(
+    """
+    Page number (1-based).
+    """
+    page: Int
+    """
+    Number of items per page.
+    """
+    perPage: Int
+    """
+    Filter by quote status values.
+    """
+    status: [String]
+    """
+    Filter quotes created on or after this ISO 8601 date-time.
+    """
+    createdAtFrom: String
+    """
+    Filter quotes created on or before this ISO 8601 date-time.
+    """
+    createdAtTo: String
+    """
+    Filter quotes expiring on or after this ISO 8601 date-time.
+    """
+    expiresAtFrom: String
+    """
+    Filter quotes expiring on or before this ISO 8601 date-time.
+    """
+    expiresAtTo: String
+    """
+    Filter quotes by label (partial match).
+    """
+    label: String
+  ): UserQuoteListResult
+    @auth
+    @cacheControl(scope: "private", sMaxAge: 300, staleWhileRevalidate: 3600)
+
   """
   Returns information about the current user details.
   """
@@ -451,6 +491,25 @@ type Query {
     @auth
     @cacheControl(scope: "private", sMaxAge: 300, staleWhileRevalidate: 3600)
 
+  """
+  Lists the commercial contracts associated with the given Organization Unit,
+  resolved to human-readable corporate names. Governed: only contracts associated
+  with the authenticated buyer's Organization Unit are returned.
+  """
+  availableContracts(
+    """
+    The Organization Unit identifier whose contracts will be listed.
+    """
+    orgUnitId: String!
+  ): [StoreContract!]! @auth @cacheControl(scope: "private", sMaxAge: 0)
+
+  """
+  Returns whether the current authenticated user belongs to a B2B organization unit.
+  """
+  isOrganizationMember: Boolean!
+    @auth
+    @cacheControl(scope: "private", sMaxAge: 300, staleWhileRevalidate: 3600)
+
   """
   Returns a list of pickup points near to the given geo coordinates.
   """
@@ -470,6 +529,15 @@ type Query {
   Returns the items in an orderForm by its ID.
   """
   orderFormItems(orderFormId: String!): [StoreOrderFormCartItem!]! @auth
+  """
+  Returns personalized product recommendations for a given campaign.
+  """
+  recommendations(
+    campaignVrn: String!
+    userId: String
+    products: [String!]
+  ): RecommendationResponse!
+    @cacheControl(scope: "private", sMaxAge: 120, staleWhileRevalidate: 3600)
 }
 
 type ValidateUserData {

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

@@ -0,0 +1,65 @@
+"""
+Summary of a quote returned in list results.
+"""
+type UserQuoteSummary {
+  """
+  Unique identifier of the quote.
+  """
+  id: String!
+  """
+  Status of the quote.
+  """
+  status: String!
+  """
+  Optional label assigned to the quote.
+  """
+  label: String
+  """
+  ISO 8601 date-time when the quote was created.
+  """
+  createdAt: String!
+  """
+  ISO 8601 date-time when the quote expires.
+  """
+  expiresAt: String!
+  """
+  Total amount of the quote.
+  """
+  amount: Float!
+  """
+  Name or email of the user who created the quote.
+  """
+  createdBy: String
+}
+
+"""
+Result returned by the listUserQuotes query.
+"""
+type UserQuoteListResult {
+  """
+  Array of quote summaries for the current page.
+  """
+  list: [UserQuoteSummary!]!
+  """
+  Pagination information.
+  """
+  paging: UserQuoteListPaging!
+}
+
+"""
+Pagination metadata for the quotes list.
+"""
+type UserQuoteListPaging {
+  """
+  Total number of quotes matching the query.
+  """
+  total: Int!
+  """
+  Current page number (1-based).
+  """
+  currentPage: Int!
+  """
+  Number of items per page.
+  """
+  perPage: Int!
+}

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

@@ -0,0 +1,11 @@
+type RecommendationResponse {
+  products: [StoreProduct!]!
+  correlationId: String!
+  campaign: RecommendationCampaign!
+}
+
+type RecommendationCampaign {
+  id: String!
+  title: String
+  type: String!
+}

package/src/platforms/vtex/utils/contract.ts

@@ -0,0 +1,144 @@
+import type { ContractResponse } from '../clients/commerce/Contract'
+import type {
+  SessionAvailableContract,
+  Shopper,
+} from '../clients/commerce/types/Session'
+
+type ProfileNameFields = {
+  firstName?: { value?: string | null } | null
+  lastName?: { value?: string | null } | null
+} | null
+
+/**
+ * Display name from Master Data, aligned with buyer-portal `personalDataToContract`.
+ */
+export const resolveContractDisplayNameFromMd = (
+  contract: ContractResponse | null | undefined
+): string => {
+  const corporateName = (contract?.corporateName ?? '').trim()
+
+  if (corporateName) {
+    return corporateName
+  }
+
+  return (contract?.firstName ?? '').trim()
+}
+
+const isSessionAvailableContract = (
+  value: unknown
+): value is SessionAvailableContract => {
+  if (!value || typeof value !== 'object') {
+    return false
+  }
+
+  const contract = value as Record<string, unknown>
+
+  return (
+    typeof contract.customerId === 'string' &&
+    contract.customerId.trim() !== '' &&
+    typeof contract.contractName === 'string' &&
+    typeof contract.isActive === 'boolean' &&
+    typeof contract.isCurrent === 'boolean'
+  )
+}
+
+/**
+ * Parses VTEX session `shopper.availableContracts` into a typed list.
+ */
+export const parseSessionAvailableContracts = (
+  shopper: Shopper | null | undefined
+): SessionAvailableContract[] => {
+  const raw = shopper?.availableContracts?.value
+
+  if (!Array.isArray(raw)) {
+    return []
+  }
+
+  return raw.filter(isSessionAvailableContract)
+}
+
+/**
+ * Whether a session contract is eligible for the switcher list.
+ */
+export const isSwitchableSessionContract = (
+  contract: SessionAvailableContract | null | undefined
+): boolean => {
+  if (!contract?.customerId) {
+    return false
+  }
+
+  const name = (contract.contractName ?? '').trim()
+
+  return Boolean(name && contract.isActive)
+}
+
+/**
+ * Resolves the active contract id from VTEX session namespaces.
+ */
+export const resolveActiveContractIdFromSession = (
+  sessionData: {
+    namespaces?: {
+      shopper?: Shopper | null
+      authentication?: { customerId?: { value?: string | null } | null } | null
+      profile?: { id?: { value?: string | null } | null } | null
+    } | null
+  } | null
+): string => {
+  return (
+    sessionData?.namespaces?.shopper?.activeContractId?.value?.trim() ??
+    sessionData?.namespaces?.authentication?.customerId?.value?.trim() ??
+    sessionData?.namespaces?.profile?.id?.value?.trim() ??
+    ''
+  )
+}
+
+/**
+ * Maps session contracts to GraphQL `StoreContract` entries.
+ */
+export const mapSessionContractsToStoreContracts = (
+  contracts: SessionAvailableContract[],
+  activeContractId = ''
+): Array<{ id: string; corporateName: string; isActive: boolean }> => {
+  const normalizedActiveId = activeContractId.trim()
+
+  return contracts.filter(isSwitchableSessionContract).map((contract) => ({
+    id: contract.customerId,
+    corporateName: contract.contractName.trim(),
+    isActive: normalizedActiveId
+      ? contract.customerId === normalizedActiveId
+      : contract.isCurrent,
+  }))
+}
+
+/**
+ * Whether a CL record is eligible for contract switcher summaries (attached list).
+ */
+export const isSwitchableContractSummary = (
+  contract: ContractResponse | null | undefined
+): boolean => {
+  if (!contract) {
+    return false
+  }
+
+  const name = resolveContractDisplayNameFromMd(contract)
+  const email = (contract.email ?? '').trim()
+
+  return Boolean(name && email)
+}
+
+/**
+ * Resolves the active contract name: Master Data first, then VTEX session profile.
+ * Matches `accountProfile` / buyer-portal behavior when CL lookup fails.
+ */
+export const resolveActiveContractDisplayName = (
+  contract: ContractResponse | null | undefined,
+  profile: ProfileNameFields
+): string => {
+  const fromMasterData = resolveContractDisplayNameFromMd(contract)
+
+  if (fromMasterData) {
+    return fromMasterData
+  }
+
+  return (profile?.firstName?.value ?? '').trim()
+}