@de./sdk 1.0.4 → 2.0.0

package/src/allend/Agent/index.ts

@@ -0,0 +1,113 @@
+import type { AccessOptions, UserSession } from '../../types/access'
+import type {
+	AgentInfoValidation,
+	AgentAvailabilityValidation,
+	AgentUpdateValidation
+} from '@de./types'
+import AccessManager from '../Access'
+import { type Res, type Data } from '../../utils'
+import AgentRides from './rides'
+import AgentDelivery from './delivery'
+import AgentShipping from './shipping'
+import AgentNavigation from './navigation'
+import AgentConsolidation from './consolidation'
+import AgentReallocation from './reallocation'
+import AgentDispatch from './dispatch'
+import AgentOrigin from './origin'
+import AgentRealtime from './realtime'
+
+export type AgentConfig = {
+	context: string
+	accessToken: string
+	env?: 'dev' | 'staging' | 'prod'
+	platform?: 'web' | 'mobile' | 'server' | 'proxy'
+	remoteOrigin?: string
+	/** Per-request deadline in ms. See `AccessOptions.timeout`. */
+	timeout?: number
+	/** Explicit service origin, overriding the env table. See `AccessOptions.baseUrl`. */
+	baseUrl?: string
+	/** Host to substitute for `localhost` in `dev` (Eg. a native emulator) */
+	devHostname?: string
+	/**
+	 * The signed-in rider.
+	 *
+	 * Required in practice: AUX agent routes authenticate the caller with
+	 * `isConnected` + `isAgent`, which read `de-auth-token` / `de-auth-device`
+	 * and ignore the bearer token entirely. Without this, every call here
+	 * fails authorization no matter how valid the access token is.
+	 */
+	session?: UserSession
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Agent: Agent Operation Interfaces — de.arch AUX/agent routes.
+// Covers profile, availability, orders (ride/delivery/shipping),
+// navigation, consolidation, reallocation, dispatch, and origin — plus the
+// realtime socket channel (order rooms + proactive-consolidation responses).
+//
+// ─────────────────────────────────────────────────────────────────────────────
+
+export default class Agent extends AccessManager {
+	readonly rides:         AgentRides
+	readonly delivery:      AgentDelivery
+	readonly shipping:      AgentShipping
+	readonly navigation:    AgentNavigation
+	readonly consolidation: AgentConsolidation
+	readonly reallocation:  AgentReallocation
+	readonly dispatch:      AgentDispatch
+	readonly origin:        AgentOrigin
+	readonly realtime:      AgentRealtime
+
+	constructor( config: AgentConfig ){
+		if( !config.context )     throw new Error('Undefined context. See https://doc.dedot.io/sdk/aux')
+		if( !config.accessToken ) throw new Error('Undefined accessToken. See https://doc.dedot.io/sdk/auth')
+
+		const access: AccessOptions = {
+			context:      config.context,
+			accessToken:  config.accessToken,
+			env:          config.env      || 'dev',
+			platform:     config.platform || 'proxy',
+			remoteOrigin: config.remoteOrigin,
+			timeout:      config.timeout,
+			baseUrl:      config.baseUrl,
+			devHostname:  config.devHostname,
+			session:      config.session
+		}
+		super( access, 'API' )
+
+		this.rides         = new AgentRides( this )
+		this.delivery      = new AgentDelivery( this )
+		this.shipping      = new AgentShipping( this )
+		this.navigation    = new AgentNavigation( this )
+		this.consolidation = new AgentConsolidation( this )
+		this.reallocation  = new AgentReallocation( this )
+		this.dispatch      = new AgentDispatch( this )
+		this.origin        = new AgentOrigin( this )
+		this.realtime      = new AgentRealtime( access )
+	}
+
+	// ── Agent profile ─────────────────────────────────────────────────────────
+
+	async info(): Promise<AgentInfoValidation['response']> {
+		return await this.request<AgentInfoValidation['response']>({
+			url: '/agent',
+			method: 'GET'
+		})
+	}
+
+	async update( body: AgentUpdateValidation['body'] ): Promise<AgentUpdateValidation['response']> {
+		return await this.request<AgentUpdateValidation['response']>({
+			url: '/agent',
+			method: 'PATCH',
+			body
+		})
+	}
+
+	async availability( status: AgentAvailabilityValidation['params']['availability'] ): Promise<AgentAvailabilityValidation['response']> {
+		return await this.request<AgentAvailabilityValidation['response']>({
+			url: `/agent/${status}`,
+			method: 'GET'
+		})
+	}
+}

package/src/allend/Agent/navigation.ts

@@ -0,0 +1,27 @@
+import type {
+	AgentLocationValidation,
+	AgentNearbyValidation
+} from '@de./types'
+import { qs, type Http, type Res, type Data } from '../../utils'
+
+// ─── Agent Navigation ─────────────────────────────────────────────────────────
+
+export default class AgentNavigation {
+	constructor( private http: Http ){}
+
+	async location( body: AgentLocationValidation['body'] ): Promise<AgentLocationValidation['response']> {
+		return await this.http.request<AgentLocationValidation['response']>({
+			url: '/agent/navigation/location',
+			method: 'POST',
+			body
+		})
+	}
+
+	async nearby( body: AgentNearbyValidation['body'], querystring?: AgentNearbyValidation['querystring'] ): Promise<AgentNearbyValidation['response']> {
+		return await this.http.request<AgentNearbyValidation['response']>({
+			url: `/agent/navigation/nearby${qs( querystring )}`,
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/Agent/origin.ts

@@ -0,0 +1,36 @@
+import type {
+	AgentOriginStatusReportValidation,
+	AgentRegisterPoiValidation,
+	AgentAddPoiNoteValidation
+} from '@de./types'
+import { type Http, type Res, type Data } from '../../utils'
+
+// ─── Agent Origin ─────────────────────────────────────────────────────────────
+
+export default class AgentOrigin {
+	constructor( private http: Http ){}
+
+	async statusReport( body: AgentOriginStatusReportValidation['body'] ): Promise<AgentOriginStatusReportValidation['response']> {
+		return await this.http.request<AgentOriginStatusReportValidation['response']>({
+			url: '/agent/origin/status',
+			method: 'POST',
+			body
+		})
+	}
+
+	async registerPoi( body: AgentRegisterPoiValidation['body'] ): Promise<AgentRegisterPoiValidation['response']> {
+		return await this.http.request<AgentRegisterPoiValidation['response']>({
+			url: '/agent/origin/poi/register',
+			method: 'POST',
+			body
+		})
+	}
+
+	async addPoiNote( body: AgentAddPoiNoteValidation['body'] ): Promise<AgentAddPoiNoteValidation['response']> {
+		return await this.http.request<AgentAddPoiNoteValidation['response']>({
+			url: '/agent/origin/poi/note',
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/Agent/reallocation.ts

@@ -0,0 +1,16 @@
+import type { AgentReallocationRespondValidation } from '@de./types'
+import { type Http, type Res, type Data } from '../../utils'
+
+// ─── Agent Reallocation ───────────────────────────────────────────────────────
+
+export default class AgentReallocation {
+	constructor( private http: Http ){}
+
+	async respond( body: AgentReallocationRespondValidation['body'] ): Promise<AgentReallocationRespondValidation['response']> {
+		return await this.http.request<AgentReallocationRespondValidation['response']>({
+			url: '/agent/reallocation/respond',
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/Agent/realtime.ts

@@ -0,0 +1,140 @@
+import type { OrderTrackingEvent } from '@de./types'
+import type { RTLocation, Message, Peer } from '../../types'
+import type { SocketAuthCredentials } from '../../types/auth'
+import type { AccessOptions } from '../../types/access'
+
+import io, { Socket } from 'socket.io-client'
+import AccessManager from '../Access'
+import { baseURL } from '../../baseUrl'
+
+// ─── Agent Realtime ───────────────────────────────────────────────────────────
+//
+// Socket channel for riders. Two jobs:
+//
+// 1. Order rooms — after `join(jrtoken)` (token from the platform's tracking
+//    session, role=agent) the rider streams LOCATION-CHANGE / MESSAGE into
+//    the room and receives ORDER_UPDATE events for the order.
+//
+// 2. Proactive-consolidation responses — CONSOLIDATION_ACK / NACK / POSITION
+//    go over the socket, NOT the REST respond endpoints (those serve relay
+//    and dispatch offers). See de.arch consolidation README: response channels.
+//
+// NOTE — dispatch/consolidation OFFERS do not arrive on this socket: De.
+// emits RALLY_EVENT to service connections only, and the operating platform
+// (e.g. its backend SSE) relays offers to the rider app. Respond to relayed
+// offers via `agent.dispatch.respond(...)` / `agent.consolidation.respond(...)`.
+//
+// Distinct from `Realtime` (allend/Realtime), which is the client-role socket.
+
+export type AgentRealtimeContext = {
+  wid: string
+  type: string
+  xcode: string
+}
+
+export default class AgentRealtime extends AccessManager {
+  private nsp?: Socket
+  private iosHost: string
+  private agentId?: string
+
+  constructor( access: AccessOptions ){
+    super( access, 'API' )
+
+    // Socket.io is served by the same de.arch API server, so an explicit
+    // origin governs the socket exactly as it governs the requests — without
+    // this, a client pointed at a self-hosted De. still opened its socket
+    // against the environment table's host.
+    this.iosHost = access.baseUrl?.replace( /\/+$/, '' )
+                    || baseURL('API', access.env || 'dev', access.devHostname )
+  }
+
+  connect( agentId: string ): Promise<void> {
+    return new Promise( ( resolve, reject ) => {
+      const auth: SocketAuthCredentials = {
+        utype: 'agent',
+        id: agentId,
+        remoteOrigin: this.remoteOrigin as string,
+        accessToken: this.accessToken as string
+      }
+
+      this.agentId = agentId
+      this.nsp = io( this.iosHost, { auth } )
+      this.nsp.on('connect', resolve )
+      this.nsp.on('connect_error', reject )
+    } )
+  }
+
+  disconnect(){
+    this.nsp?.disconnect()
+    return true
+  }
+
+  /**
+   * Join an order tracking room with a Join Room Token issued by
+   * GET /v1/tracking/:reference (role must match this socket's utype)
+   */
+  join( jrtoken: string ): Promise<boolean> {
+    return new Promise( ( resolve, reject ) => {
+      this.nsp?.emit('JOIN', jrtoken, ( errmess?: string ) => {
+        errmess ? reject( new Error( errmess ) ) : resolve( true )
+      } )
+    } )
+  }
+
+  // ── Order room streams (after join) ─────────────────────────────────────
+
+  sendLocation( location: RTLocation ){
+    this.nsp?.emit('LOCATION-CHANGE', location )
+    return this
+  }
+
+  sendMessage( message: Message ){
+    this.nsp?.emit('MESSAGE', message )
+    return this
+  }
+
+  onOrderUpdate( fn: ( event: OrderTrackingEvent ) => void ){
+    this.nsp?.on('ORDER_UPDATE', fn )
+    return this
+  }
+
+  onMessage( fn: ( message: Message ) => void ){
+    this.nsp?.on('MESSAGE', fn )
+    return this
+  }
+
+  onConnected( fn: ( peer: Peer ) => void ){
+    this.nsp?.on('CONNECTED', fn )
+    return this
+  }
+
+  onDisconnected( fn: ( peer: Peer ) => void ){
+    this.nsp?.on('DISCONNECTED', fn )
+    return this
+  }
+
+  // ── Proactive consolidation channel (socket-only responses) ─────────────
+
+  ackConsolidation( context: AgentRealtimeContext, offerId: string ){
+    if( !this.agentId ) throw new Error('Not connected')
+    this.nsp?.emit('CONSOLIDATION_ACK', { context, offerId, agentId: this.agentId } )
+    return this
+  }
+
+  nackConsolidation( context: AgentRealtimeContext, offerId: string, nackReason?: string ){
+    if( !this.agentId ) throw new Error('Not connected')
+    this.nsp?.emit('CONSOLIDATION_NACK', { context, offerId, agentId: this.agentId, nackReason } )
+    return this
+  }
+
+  /**
+   * Stream the rider's position into the proactive consolidation engine —
+   * feeds trajectory tracking (ARRIVED / DIVERGING / STATIONARY) for
+   * committed handoffs. Distinct from order-room sendLocation().
+   */
+  positionUpdate( context: AgentRealtimeContext, location: RTLocation, status?: string ){
+    if( !this.agentId ) throw new Error('Not connected')
+    this.nsp?.emit('CONSOLIDATION_POSITION', { context, agentId: this.agentId, location, status } )
+    return this
+  }
+}

package/src/allend/Agent/rides.ts

@@ -0,0 +1,61 @@
+import type {
+	AgentRideListValidation,
+	AgentRideGetValidation,
+	AgentRideAcceptValidation,
+	AgentRideStartValidation,
+	AgentRideCompleteValidation,
+	AgentRideCancelValidation
+} from '@de./types'
+import { qs, type Http, type Res, type Data } from '../../utils'
+
+// ─── Agent Ride Orders ────────────────────────────────────────────────────────
+
+export default class AgentRides {
+	constructor( private http: Http ){}
+
+	async list( querystring?: AgentRideListValidation['querystring'] ): Promise<AgentRideListValidation['response']> {
+		return await this.http.request<AgentRideListValidation['response']>({
+			url: `/agent/ride/orders${qs( querystring )}`,
+			method: 'GET'
+		})
+	}
+
+	async get( reference: string ): Promise<AgentRideGetValidation['response']> {
+		return await this.http.request<AgentRideGetValidation['response']>({
+			url: `/agent/ride/orders/${reference}`,
+			method: 'GET'
+		})
+	}
+
+	async accept( reference: string, body: AgentRideAcceptValidation['body'] ): Promise<AgentRideAcceptValidation['response']> {
+		return await this.http.request<AgentRideAcceptValidation['response']>({
+			url: `/agent/ride/orders/${reference}/accept`,
+			method: 'POST',
+			body
+		})
+	}
+
+	async start( reference: string, body: AgentRideStartValidation['body'] ): Promise<AgentRideStartValidation['response']> {
+		return await this.http.request<AgentRideStartValidation['response']>({
+			url: `/agent/ride/orders/${reference}/start`,
+			method: 'POST',
+			body
+		})
+	}
+
+	async complete( reference: string, body: AgentRideCompleteValidation['body'] ): Promise<AgentRideCompleteValidation['response']> {
+		return await this.http.request<AgentRideCompleteValidation['response']>({
+			url: `/agent/ride/orders/${reference}/complete`,
+			method: 'POST',
+			body
+		})
+	}
+
+	async cancel( reference: string, body: AgentRideCancelValidation['body'] ): Promise<AgentRideCancelValidation['response']> {
+		return await this.http.request<AgentRideCancelValidation['response']>({
+			url: `/agent/ride/orders/${reference}/cancel`,
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/Agent/shipping.ts

@@ -0,0 +1,51 @@
+import type {
+	AgentShippingListValidation,
+	AgentShippingGetValidation,
+	AgentShippingAcceptValidation,
+	AgentShippingUpdateStatusValidation,
+	AgentShippingReportIssueValidation
+} from '@de./types'
+import { qs, type Http, type Res, type Data } from '../../utils'
+
+// ─── Agent Shipping Orders ────────────────────────────────────────────────────
+
+export default class AgentShipping {
+	constructor( private http: Http ){}
+
+	async list( querystring?: AgentShippingListValidation['querystring'] ): Promise<AgentShippingListValidation['response']> {
+		return await this.http.request<AgentShippingListValidation['response']>({
+			url: `/agent/shipping/orders${qs( querystring )}`,
+			method: 'GET'
+		})
+	}
+
+	async get( reference: string ): Promise<AgentShippingGetValidation['response']> {
+		return await this.http.request<AgentShippingGetValidation['response']>({
+			url: `/agent/shipping/orders/${reference}`,
+			method: 'GET'
+		})
+	}
+
+	async accept( reference: string ): Promise<AgentShippingAcceptValidation['response']> {
+		return await this.http.request<AgentShippingAcceptValidation['response']>({
+			url: `/agent/shipping/orders/${reference}/accept`,
+			method: 'POST'
+		})
+	}
+
+	async updateStatus( reference: string, body: AgentShippingUpdateStatusValidation['body'] ): Promise<AgentShippingUpdateStatusValidation['response']> {
+		return await this.http.request<AgentShippingUpdateStatusValidation['response']>({
+			url: `/agent/shipping/orders/${reference}/status`,
+			method: 'PATCH',
+			body
+		})
+	}
+
+	async reportIssue( reference: string, body: AgentShippingReportIssueValidation['body'] ): Promise<AgentShippingReportIssueValidation['response']> {
+		return await this.http.request<AgentShippingReportIssueValidation['response']>({
+			url: `/agent/shipping/orders/${reference}/issue`,
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/CSP/analytics.ts

@@ -0,0 +1,61 @@
+import type {
+	CSPAnalyticsOrdersValidation,
+	CSPAnalyticsFulfillmentValidation,
+	CSPAnalyticsProvidersValidation,
+	CSPAnalyticsGenerateReportValidation,
+	CSPAnalyticsGetReportValidation,
+	CSPAnalyticsListReportsValidation
+} from '@de./types/csp/analytics'
+import { qs, type Http, type Res, type Data } from '../../utils'
+
+// ── CSP Analytics ─────────────────────────────────────────────────────────
+
+export default class CSPAnalytics {
+	constructor( private http: Http ){}
+
+	async orders( body: CSPAnalyticsOrdersValidation['body'] ): Promise<CSPAnalyticsOrdersValidation['response']> {
+		return await this.http.request<CSPAnalyticsOrdersValidation['response']>({
+			url: '/csp/analytics/orders',
+			method: 'POST',
+			body
+		})
+	}
+
+	async fulfillment( body: CSPAnalyticsFulfillmentValidation['body'] ): Promise<CSPAnalyticsFulfillmentValidation['response']> {
+		return await this.http.request<CSPAnalyticsFulfillmentValidation['response']>({
+			url: '/csp/analytics/fulfillment',
+			method: 'POST',
+			body
+		})
+	}
+
+	async providers( body: CSPAnalyticsProvidersValidation['body'] ): Promise<CSPAnalyticsProvidersValidation['response']> {
+		return await this.http.request<CSPAnalyticsProvidersValidation['response']>({
+			url: '/csp/analytics/providers',
+			method: 'POST',
+			body
+		})
+	}
+
+	async generateReport( body: CSPAnalyticsGenerateReportValidation['body'] ): Promise<CSPAnalyticsGenerateReportValidation['response']> {
+		return await this.http.request<CSPAnalyticsGenerateReportValidation['response']>({
+			url: '/csp/analytics/reports',
+			method: 'POST',
+			body
+		})
+	}
+
+	async getReport( id: string ): Promise<CSPAnalyticsGetReportValidation['response']> {
+		return await this.http.request<CSPAnalyticsGetReportValidation['response']>({
+			url: `/csp/analytics/reports/${id}`,
+			method: 'GET'
+		})
+	}
+
+	async listReports( querystring?: CSPAnalyticsListReportsValidation['querystring'] ): Promise<CSPAnalyticsListReportsValidation['response']> {
+		return await this.http.request<CSPAnalyticsListReportsValidation['response']>({
+			url: `/csp/analytics/reports${qs( querystring )}`,
+			method: 'GET'
+		})
+	}
+}

package/src/allend/CSP/index.ts

@@ -0,0 +1,57 @@
+import type { AccessOptions } from '../../types/access'
+import SharedContextClient from '../Shared/context'
+import SharedOperators from '../Shared/operators'
+import CSPOrders from './orders'
+import CSPWebhooks from './webhooks'
+import CSPAnalytics from './analytics'
+import CSPInventory from './inventory'
+
+export type CSPConfig = {
+	context: string
+	accessToken: string
+	env?: 'dev' | 'staging' | 'prod'
+	platform?: 'web' | 'mobile' | 'server' | 'proxy'
+	remoteOrigin?: string
+	/** Per-request deadline in ms. See `AccessOptions.timeout`. */
+	timeout?: number
+	/** Explicit service origin, overriding the env table. See `AccessOptions.baseUrl`. */
+	baseUrl?: string
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// CSP: Commerce Service Provider API — de.arch /csp routes.
+// Covers orders, inventory, webhooks, analytics, plus shared faqs/users/account/
+// invitation (SharedContextClient) and operators.
+//
+// ─────────────────────────────────────────────────────────────────────────────
+
+export default class CSP extends SharedContextClient<'CSP'> {
+	readonly operators: SharedOperators<'CSP'>
+	readonly orders:    CSPOrders
+	readonly webhooks:  CSPWebhooks
+	readonly analytics: CSPAnalytics
+	readonly inventory: CSPInventory
+
+	constructor( config: CSPConfig ){
+		if( !config.context )     throw new Error('Undefined context. See https://doc.dedot.io/sdk/csp')
+		if( !config.accessToken ) throw new Error('Undefined accessToken. See https://doc.dedot.io/sdk/auth')
+
+		const access: AccessOptions = {
+			context:      config.context,
+			accessToken:  config.accessToken,
+			env:          config.env      || 'dev',
+			platform:     config.platform || 'proxy',
+			remoteOrigin: config.remoteOrigin,
+			timeout:      config.timeout,
+			baseUrl:      config.baseUrl
+		}
+		super( access, 'CSP' )
+
+		this.operators = new SharedOperators( this, 'CSP' )
+		this.orders    = new CSPOrders( this )
+		this.webhooks  = new CSPWebhooks( this )
+		this.analytics = new CSPAnalytics( this )
+		this.inventory = new CSPInventory( this )
+	}
+}

package/src/allend/CSP/inventory.ts

@@ -0,0 +1,96 @@
+import type {
+	CSPInventorySyncCatalogValidation,
+	CSPInventoryCheckAvailabilityValidation,
+	CSPInventoryBulkPushValidation,
+	CSPInventoryBulkPullValidation,
+	CSPInventoryGetSyncStatusValidation,
+	CSPInventoryReserveValidation,
+	CSPInventoryCommitValidation,
+	CSPInventoryReleaseValidation,
+	CSPInventoryListReservationsValidation,
+	CSPInventoryGetReservationValidation
+} from '@de./types/csp/inventory'
+import { qs, type Http, type Res, type Data } from '../../utils'
+
+// ── CSP Inventory ────────────────────────────────────────────────────────
+
+export default class CSPInventory {
+	constructor( private http: Http ){}
+
+	async syncCatalog( body: CSPInventorySyncCatalogValidation['body'] ): Promise<CSPInventorySyncCatalogValidation['response']> {
+		return await this.http.request<CSPInventorySyncCatalogValidation['response']>({
+			url: '/csp/inventory/sync',
+			method: 'POST',
+			body
+		})
+	}
+
+	async checkAvailability( body: CSPInventoryCheckAvailabilityValidation['body'] ): Promise<CSPInventoryCheckAvailabilityValidation['response']> {
+		return await this.http.request<CSPInventoryCheckAvailabilityValidation['response']>({
+			url: '/csp/inventory/availability',
+			method: 'POST',
+			body
+		})
+	}
+
+	async bulkPush( body: CSPInventoryBulkPushValidation['body'] ): Promise<CSPInventoryBulkPushValidation['response']> {
+		return await this.http.request<CSPInventoryBulkPushValidation['response']>({
+			url: '/csp/inventory/bulk/push',
+			method: 'POST',
+			body
+		})
+	}
+
+	async bulkPull( body: CSPInventoryBulkPullValidation['body'] ): Promise<CSPInventoryBulkPullValidation['response']> {
+		return await this.http.request<CSPInventoryBulkPullValidation['response']>({
+			url: '/csp/inventory/bulk/pull',
+			method: 'POST',
+			body
+		})
+	}
+
+	async getSyncStatus( syncId: string ): Promise<CSPInventoryGetSyncStatusValidation['response']> {
+		return await this.http.request<CSPInventoryGetSyncStatusValidation['response']>({
+			url: `/csp/inventory/sync/${syncId}`,
+			method: 'GET'
+		})
+	}
+
+	async reserve( body: CSPInventoryReserveValidation['body'] ): Promise<CSPInventoryReserveValidation['response']> {
+		return await this.http.request<CSPInventoryReserveValidation['response']>({
+			url: '/csp/inventory/reservations',
+			method: 'POST',
+			body
+		})
+	}
+
+	async commit( body: CSPInventoryCommitValidation['body'] ): Promise<CSPInventoryCommitValidation['response']> {
+		return await this.http.request<CSPInventoryCommitValidation['response']>({
+			url: '/csp/inventory/reservations/commit',
+			method: 'POST',
+			body
+		})
+	}
+
+	async release( body: CSPInventoryReleaseValidation['body'] ): Promise<CSPInventoryReleaseValidation['response']> {
+		return await this.http.request<CSPInventoryReleaseValidation['response']>({
+			url: '/csp/inventory/reservations/release',
+			method: 'POST',
+			body
+		})
+	}
+
+	async listReservations( querystring?: CSPInventoryListReservationsValidation['querystring'] ): Promise<CSPInventoryListReservationsValidation['response']> {
+		return await this.http.request<CSPInventoryListReservationsValidation['response']>({
+			url: `/csp/inventory/reservations${qs( querystring )}`,
+			method: 'GET'
+		})
+	}
+
+	async getReservation( id: string ): Promise<CSPInventoryGetReservationValidation['response']> {
+		return await this.http.request<CSPInventoryGetReservationValidation['response']>({
+			url: `/csp/inventory/reservations/${id}`,
+			method: 'GET'
+		})
+	}
+}