@de./sdk 1.0.4 → 2.0.0

package/src/allend/Utilities/common.ts

@@ -0,0 +1,63 @@
+import type {
+	UtilDistanceValidation,
+	UtilBatchDistanceMatrixValidation,
+	UtilSavingsMatrixValidation,
+	UtilAssignZoneValidation,
+	UtilETAValidation,
+	UtilBatchGeocodeValidation
+} from '@de./types'
+import { type Http, type Res, type Data } from '../../utils'
+
+// ─── Common Utilities ─────────────────────────────────────────────────────────
+
+export class UtilitiesCommon {
+	constructor( private http: Http ){}
+
+	async distance( body: UtilDistanceValidation['body'] ): Promise<UtilDistanceValidation['response']> {
+		return await this.http.request<UtilDistanceValidation['response']>({
+			url: '/utilities/distance',
+			method: 'POST',
+			body
+		})
+	}
+
+	async distanceMatrix( body: UtilBatchDistanceMatrixValidation['body'] ): Promise<UtilBatchDistanceMatrixValidation['response']> {
+		return await this.http.request<UtilBatchDistanceMatrixValidation['response']>({
+			url: '/utilities/distance/matrix',
+			method: 'POST',
+			body
+		})
+	}
+
+	async savingsMatrix( body: UtilSavingsMatrixValidation['body'] ): Promise<UtilSavingsMatrixValidation['response']> {
+		return await this.http.request<UtilSavingsMatrixValidation['response']>({
+			url: '/utilities/distance/savings',
+			method: 'POST',
+			body
+		})
+	}
+
+	async assignZone( body: UtilAssignZoneValidation['body'] ): Promise<UtilAssignZoneValidation['response']> {
+		return await this.http.request<UtilAssignZoneValidation['response']>({
+			url: '/utilities/zone',
+			method: 'POST',
+			body
+		})
+	}
+
+	async eta( body: UtilETAValidation['body'] ): Promise<UtilETAValidation['response']> {
+		return await this.http.request<UtilETAValidation['response']>({
+			url: '/utilities/eta',
+			method: 'POST',
+			body
+		})
+	}
+
+	async batchGeocode( body: UtilBatchGeocodeValidation['body'] ): Promise<UtilBatchGeocodeValidation['response']> {
+		return await this.http.request<UtilBatchGeocodeValidation['response']>({
+			url: '/utilities/geocode/batch',
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/Utilities/fares.ts

@@ -0,0 +1,45 @@
+import type {
+	UtilDeliveryFeesValidation,
+	UtilTransportFareValidation,
+	UtilRideFareValidation,
+	UtilCrossBorderFareValidation
+} from '@de./types'
+import { type Http, type Res, type Data } from '../../utils'
+
+// ─── Fares ────────────────────────────────────────────────────────────────────
+
+export class UtilitiesFares {
+	constructor( private http: Http ){}
+
+	async deliveryFees( body: UtilDeliveryFeesValidation['body'] ): Promise<UtilDeliveryFeesValidation['response']> {
+		return await this.http.request<UtilDeliveryFeesValidation['response']>({
+			url: '/utilities/fares/delivery',
+			method: 'POST',
+			body
+		})
+	}
+
+	async transportFare( body: UtilTransportFareValidation['body'] ): Promise<UtilTransportFareValidation['response']> {
+		return await this.http.request<UtilTransportFareValidation['response']>({
+			url: '/utilities/fares/transport',
+			method: 'POST',
+			body
+		})
+	}
+
+	async rideFare( body: UtilRideFareValidation['body'] ): Promise<UtilRideFareValidation['response']> {
+		return await this.http.request<UtilRideFareValidation['response']>({
+			url: '/utilities/fares/ride',
+			method: 'POST',
+			body
+		})
+	}
+
+	async crossBorderFare( body: UtilCrossBorderFareValidation['body'] ): Promise<UtilCrossBorderFareValidation['response']> {
+		return await this.http.request<UtilCrossBorderFareValidation['response']>({
+			url: '/utilities/fares/crossborder',
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/Utilities/index.ts

@@ -0,0 +1,52 @@
+import type { Env, Platform } from '../../types'
+import type { AccessOptions } from '../../types/access'
+import AccessManager from '../Access'
+import { UtilitiesCommon } from './common'
+import { UtilitiesFares } from './fares'
+import { UtilitiesNearby } from './nearby'
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+
+export type UtilitiesConfig = {
+	context: string
+	accessToken: string
+	env?: Env
+	platform?: Platform
+	remoteOrigin?: string
+	/** Per-request deadline in ms. See `AccessOptions.timeout`. */
+	timeout?: number
+	/** Explicit service origin, overriding the env table. See `AccessOptions.baseUrl`. */
+	baseUrl?: string
+	version?: number
+}
+
+// ─── Utilities ────────────────────────────────────────────────────────────────
+
+export default class Utilities extends AccessManager {
+	readonly common: UtilitiesCommon
+	readonly fares:  UtilitiesFares
+	readonly nearby: UtilitiesNearby
+
+	constructor( config: UtilitiesConfig ){
+		if( !config )             throw new Error('Undefined config')
+		if( !config.context )     throw new Error('Undefined context')
+		if( !config.accessToken ) throw new Error('Undefined accessToken')
+
+		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,
+			version:      config.version
+		}
+
+		super( access, 'API' )
+
+		this.common = new UtilitiesCommon( this )
+		this.fares  = new UtilitiesFares( this )
+		this.nearby = new UtilitiesNearby( this )
+	}
+}

package/src/allend/Utilities/nearby.ts

@@ -0,0 +1,36 @@
+import type {
+	UtilSearchNearbyValidation,
+	UtilSearchInBoundsValidation,
+	UtilFindNearestValidation
+} from '@de./types'
+import { type Http, type Res, type Data } from '../../utils'
+
+// ─── Nearby ───────────────────────────────────────────────────────────────────
+
+export class UtilitiesNearby {
+	constructor( private http: Http ){}
+
+	async search( body: UtilSearchNearbyValidation['body'] ): Promise<UtilSearchNearbyValidation['response']> {
+		return await this.http.request<UtilSearchNearbyValidation['response']>({
+			url: '/utilities/nearby/search',
+			method: 'POST',
+			body
+		})
+	}
+
+	async searchInBounds( body: UtilSearchInBoundsValidation['body'] ): Promise<UtilSearchInBoundsValidation['response']> {
+		return await this.http.request<UtilSearchInBoundsValidation['response']>({
+			url: '/utilities/nearby/bounds',
+			method: 'POST',
+			body
+		})
+	}
+
+	async findNearest( body: UtilFindNearestValidation['body'] ): Promise<UtilFindNearestValidation['response']> {
+		return await this.http.request<UtilFindNearestValidation['response']>({
+			url: '/utilities/nearby/nearest',
+			method: 'POST',
+			body
+		})
+	}
+}

package/src/allend/{DClient → Workflows}/Client.ts

@@ -1,13 +1,9 @@
 import type { AccessOptions } from '../../types/access'
-import type { HTTPRequestOptions, RTLocation, OrderService, HTTPResponse, Entity  } from '../../types'
+import type { HTTPRequestOptions, RTLocation, MSIEntity, HTTPResponse } from '../../types'
 import AccessManager from '../Access'
 
-type OrderServiceResponse = HTTPResponse & {
-  orders: OrderService[]
-}
-type NearbyResponse = HTTPResponse & {
-  nearby: Entity[]
-}
+type OrderServiceResponse = HTTPResponse<{ orders: any[] }>
+type NearbyResponse = HTTPResponse<{ nearby: MSIEntity[] }>
 
 export default class Client extends AccessManager {
   private clientId: string
@@ -30,11 +26,9 @@ export default class Client extends AccessManager {
     options: HTTPRequestOptions = {
       url: `/client/${this.clientId}/orders/actives`,
       method: 'GET'
-    },
-    { error, message, orders } = await this.request<OrderServiceResponse>( options )
-    if( error ) throw new Error( message )
-    
-    return orders
+    }
+
+    return await this.request<OrderServiceResponse>( options )
   }
 
   async fetchOrderHistory(){
@@ -45,11 +39,9 @@ export default class Client extends AccessManager {
     options: HTTPRequestOptions = {
       url: `/client/${this.clientId}/orders/history`,
       method: 'GET'
-    },
-    { error, message, orders } = await this.request<OrderServiceResponse>( options )
-    if( error ) throw new Error( message )
-    
-    return orders
+    }
+
+    return await this.request<OrderServiceResponse>( options )
   }
 
   async nearby( location: RTLocation ){
@@ -67,10 +59,8 @@ export default class Client extends AccessManager {
       url: `/client/${this.clientId}/nearby`,
       method: 'POST',
       body: location
-    },
-    { error, message, nearby } = await this.request<NearbyResponse>( options )
-    if( error ) throw new Error( message )
-    
-    return nearby
+    }
+
+    return await this.request<NearbyResponse>( options )
   }
 }

package/src/allend/Workflows/Delivery.ts

@@ -0,0 +1,94 @@
+import type LSP from '../LSP'
+import type { Coordinates } from '../../types'
+
+// ─── Input types ──────────────────────────────────────────────────────────────
+
+export type DeliveryContact = {
+	type?: string
+	reference: string
+	phone?: string
+	email?: string
+}
+
+export type DeliveryLocation = {
+	address: string
+	coordinates: Coordinates
+	contact?: DeliveryContact
+	description?: string
+}
+
+export type DeliveryPackage = {
+	waypointNo?: number
+	careLevel?: number
+	category?: string
+	weight?: number
+	note?: string
+}
+
+export type DeliveryPickupInput = {
+	clientId: string
+	from: DeliveryLocation
+	to: DeliveryLocation
+	packages?: DeliveryPackage[]
+	service?: Record<string, any>
+}
+
+export type DeliveryResult = {
+	intentToken: string
+	jrtoken: string
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// LAYER 2 — Delivery workflow.
+// Composes Lsp.orders calls into a single "get this from A to B" operation:
+//   intent → addWaypoint → addPackage? → initiate
+//
+// ─────────────────────────────────────────────────────────────────────────────
+
+export default class Delivery {
+	constructor( private lsp: LSP ){}
+
+	// async pickup({ clientId, from, to, packages, service = {} }: DeliveryPickupInput ): Promise<DeliveryResult> {
+	// 	if( !clientId ) throw new Error('<clientId> required for delivery pickup')
+	// 	if( !from )     throw new Error('<from> location required')
+	// 	if( !to )       throw new Error('<to> location required')
+
+	// 	// 1 — Create intent session
+	// 	const intentToken = await this.lsp.orders.intent( clientId )
+
+	// 	// 2 — Register pickup + dropoff waypoints
+	// 	await this.lsp.orders.addWaypoint([
+	// 		{
+	// 			no: 1,
+	// 			type: 'pickup',
+	// 			description: from.description || from.address,
+	// 			coordinates: from.coordinates,
+	// 			address: from.address,
+	// 			contact: from.contact || { type: 'sender', reference: clientId }
+	// 		},
+	// 		{
+	// 			no: 2,
+	// 			type: 'dropoff',
+	// 			description: to.description || to.address,
+	// 			coordinates: to.coordinates,
+	// 			address: to.address,
+	// 			contact: to.contact || { type: 'receiver', reference: '' }
+	// 		}
+	// 	], intentToken )
+
+	// 	// 3 — Attach packages when provided
+	// 	if( packages?.length ){
+	// 		const stamped = packages.map(( pkg, i ) => ({
+	// 			...pkg,
+	// 			waypointNo: pkg.waypointNo ?? 2 // defaults to dropoff
+	// 		}))
+	// 		await this.lsp.orders.addPackage( stamped, intentToken )
+	// 	}
+
+	// 	// 4 — Initiate the order and get the job-reference token
+	// 	const jrtoken = await this.lsp.orders.initiate( service, intentToken )
+
+	// 	return { intentToken, jrtoken }
+	// }
+}

package/src/allend/Workflows/index.ts

@@ -0,0 +1,31 @@
+import type LSP from '../LSP'
+import type MSI from '../MSI'
+import Delivery from './Delivery'
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+
+export type WorkflowsConfig = {
+	lsp: LSP
+	msi?: MSI
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// LAYER 2 — Workflows: use-case composition, many API calls in one.
+// Sits explicitly on top of Core — the consumer passes core to it,
+// making the dependency chain visible and testable.
+//
+//   const wf = new Workflows({ core })
+//   const { jrtoken } = await wf.delivery.pickup({ clientId, from, to, packages })
+//
+// ─────────────────────────────────────────────────────────────────────────────
+
+export default class Workflows {
+	readonly delivery: Delivery
+
+	constructor({ lsp }: WorkflowsConfig ){
+		if( !lsp ) throw new Error('<core> instance required. Pass a Core instance to Workflows.')
+
+		this.delivery = new Delivery( lsp )
+	}
+}