[Seller Quotes] feat: get seller quotes paginated api

CHANGELOG.md

@@ -7,34 +7,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Provides a route for seller get paginated list of quotes at marketplace
+
+### Added
+
+- Add field quotesManagedBy on appSettings to handle splitting quotes
+- Process splitting quote by seller if it accepts to manage quotes
+- Notify seller with quote reference data as payload
+- Provides a route for seller get a quote by id at marketplace
+
 ## [2.6.4] - 2024-10-31
 
 ### Fixed
+
 - Only update Status, LastUpdate and UpdateHistory, in expired quotes
 
 ## [2.6.3] - 2024-10-30
 
 ### Fixed
+
 - Set viewedByCustomer value False when value is null
 
 ## [2.6.2] - 2024-10-02
 
 ### Added
+
 - Add audit access metrics to all graphql APIs
 
 ## [2.6.1] - 2024-09-09
 
 ### Fixed
+
 - Set viewedByCustomer value corectly on quote creation
 
 ## [2.6.0] - 2024-09-04
 
 ### Added
+
 - Add getQuoteEnabledForUser query to be used by the b2b-quotes app
 
 ## [2.5.4] - 2024-08-20
 
 ### Fixed
+
 - Use listUsersPaginated internally instead of deprecated listUsers
 
 ## [2.5.3] - 2024-06-10
@@ -76,15 +93,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [2.3.1] - 2023-09-13
 
 ### Fixed
+
 - Use the account to get the token in the header and send it to clear the cart and order
 
 ## [2.3.0] - 2023-08-14
 
 ### Added
+
 - Send metrics to Analytics (Create Quote and Send Message events)
-- Send use quote metrics to Analytics 
-  
+- Send use quote metrics to Analytics
+
 ### Removed
+
 - [ENGINEERS-1247] - Disable cypress tests in PR level
 
 ### Changed

graphql/appSettings.graphql

@@ -3,7 +3,13 @@ type AppSettings {
 }
 type AdminSetup {
   cartLifeSpan: Int
+  quotesManagedBy: QuotesManagedBy!
 }
 input AppSettingsInput {
   cartLifeSpan: Int
+  quotesManagedBy: QuotesManagedBy
 }
+enum QuotesManagedBy {
+  MARKETPLACE
+  SELLER
+}

graphql/quote.graphql

@@ -59,6 +59,9 @@ type Quote {
   viewedBySales: Boolean
   viewedByCustomer: Boolean
   salesChannel: String
+  seller: String
+  parentQuote: String
+  hasChildren: Boolean
 }
 
 type QuoteUpdate {

node/clients/SellerQuotesClient.ts

@@ -0,0 +1,62 @@
+import type { InstanceOptions, IOContext } from '@vtex/api'
+import { ExternalClient } from '@vtex/api'
+
+const SELLER_CLIENT_OPTIONS: InstanceOptions = {
+  retries: 5,
+  timeout: 5000,
+  exponentialTimeoutCoefficient: 2,
+  exponentialBackoffCoefficient: 2,
+  initialBackoffDelay: 100,
+}
+
+const BASE_PATH = 'b2b-seller-quotes/_v/0'
+
+const ROUTES = {
+  verifyQuoteSettings: 'verify-quote-settings',
+  notifyNewQuote: 'notify-new-quote',
+}
+
+export default class SellerQuotesClient extends ExternalClient {
+  constructor(ctx: IOContext, options?: InstanceOptions) {
+    super('', ctx, {
+      ...options,
+      ...SELLER_CLIENT_OPTIONS,
+      headers: {
+        Accept: 'application/json',
+        'Content-Type': 'application/json',
+        VtexIdclientAutCookie: ctx.authToken,
+      },
+    })
+  }
+
+  private getRoute(sellerAccount: string, path: string) {
+    const subdomain = this.context.production
+      ? sellerAccount
+      : `${this.context.workspace}--${sellerAccount}`
+
+    return `http://${subdomain}.myvtex.com/${BASE_PATH}/${path}`
+  }
+
+  public async verifyQuoteSettings(sellerAccount: string) {
+    return this.http.get<VerifyQuoteSettingsResponse>(
+      this.getRoute(sellerAccount, ROUTES.verifyQuoteSettings)
+    )
+  }
+
+  public async notifyNewQuote(
+    sellerAccount: string,
+    quoteId: string,
+    creationDate: string
+  ) {
+    const payload: SellerQuoteNotifyInput = {
+      quoteId,
+      creationDate,
+      marketplaceAccount: this.context.account,
+    }
+
+    return this.http.postRaw(
+      this.getRoute(sellerAccount, ROUTES.notifyNewQuote),
+      payload
+    )
+  }
+}

node/clients/index.ts

@@ -13,6 +13,7 @@ import OrdersClient from './OrdersClient'
 import Organizations from './organizations'
 import StorefrontPermissions from './storefrontPermissions'
 import VtexId from './vtexId'
+import SellerQuotesClient from './SellerQuotesClient'
 
 export const getTokenToHeader = (ctx: IOContext) => {
   // provide authToken (app token) as an admin token as this is a call
@@ -86,4 +87,8 @@ export class Clients extends IOClients {
   public get identity() {
     return this.getOrSet('identity', Identity)
   }
+
+  public get sellerQuotes() {
+    return this.getOrSet('sellerQuotes', SellerQuotesClient)
+  }
 }

node/constants.ts

@@ -22,6 +22,9 @@ export const QUOTE_FIELDS = [
   'viewedBySales',
   'viewedByCustomer',
   'salesChannel',
+  'seller',
+  'parentQuote',
+  'hasChildren',
 ]
 
 export const routes = {
@@ -134,6 +137,18 @@ export const schema = {
       title: 'Viewed by Sales',
       type: 'boolean',
     },
+    seller: {
+      title: 'Seller',
+      type: ['null', 'string'],
+    },
+    parentQuote: {
+      title: 'Parent quote',
+      type: ['null', 'string'],
+    },
+    hasChildren: {
+      title: 'Has children',
+      type: ['null', 'boolean'],
+    },
   },
   'v-cache': false,
   'v-default-fields': [
@@ -145,6 +160,9 @@ export const schema = {
     'items',
     'subtotal',
     'status',
+    'seller',
+    'parentQuote',
+    'hasChildren',
   ],
   'v-immediate-indexing': true,
   'v-indexed': [
@@ -157,5 +175,8 @@ export const schema = {
     'organization',
     'costCenter',
     'salesChannel',
+    'seller',
+    'parentQuote',
+    'hasChildren',
   ],
 }

node/index.ts

@@ -1,6 +1,7 @@
 import type {
   ClientsConfig,
   EventContext,
+  IOContext,
   ParamsContext,
   RecorderState,
   ServiceContext,
@@ -11,6 +12,7 @@ import { Clients } from './clients'
 import { orderHandler } from './middlewares/order'
 import { resolvers } from './resolvers'
 import { schemaDirectives } from './resolvers/directives'
+import type SellerQuotesController from './resolvers/utils/sellerQuotesController'
 
 const TIMEOUT_MS = 5000
 
@@ -39,7 +41,13 @@ const clients: ClientsConfig<Clients> = {
 
 declare global {
   // We declare a global Context type just to avoid re-writing ServiceContext<Clients, State> in every handler and resolver
-  type Context = ServiceContext<Clients>
+  type Context = ServiceContext<Clients> & {
+    vtex: IOContext & {
+      sellerQuotesController?: SellerQuotesController
+    }
+  }
+
+  type NextFn = () => Promise<unknown>
 
   // The shape of our State object found in `ctx.state`. This is used as state bag to communicate between middlewares.
   interface State {

node/metrics/createQuote.ts

@@ -7,18 +7,6 @@ type UserData = {
   roleId: string
 }
 
-type SessionData = {
-  namespaces: {
-    profile: {
-      id: { value: string }
-      email: { value: string }
-    }
-    account: {
-      accountName: { value: string }
-    }
-  }
-}
-
 type CreateQuoteMetricParam = {
   sessionData: SessionData
   sendToSalesRep: boolean

node/package.json

@@ -9,7 +9,7 @@
     "ramda": "^0.25.0",
     "atob": "^2.1.2",
     "axios": "0.27.2",
-    "@vtex/api": "6.47.0"
+    "@vtex/api": "6.48.0"
   },
   "devDependencies": {
     "@types/atob": "^2.1.2",