@de./sdk 1.0.5 → 2.1.0

package/src/allend/Shared/invitation.ts

@@ -10,7 +10,7 @@ import type {
 	LSPSharedInvitationAcceptValidation
 } from '@de./types/shared/invitation'
 import type { UserContextType } from '@de./types'
-import { type Http, type Res } from '../../utils'
+import { type Http, type Res, type Data } from '../../utils'
 
 // ─── Validation map ───────────────────────────────────────────────────────────
 
@@ -40,35 +40,38 @@ type InvitationV<C extends UserContextType> = {
 // ─── Class ────────────────────────────────────────────────────────────────────
 
 export default class SharedInvitation<C extends UserContextType> {
-	constructor( private http: Http, private prefix: string ){}
+	/**
+	 * Lowercased, like every other shared client.
+	 *
+	 * This one took the context type as a raw `prefix` and used it verbatim, so
+	 * an LSP client addressed `/LSP/invitation/agent` — de.arch mounts `/lsp`,
+	 * and every invitation a workspace ever sent through the SDK came back 404.
+	 */
+	constructor( private http: Http, private ctype: UserContextType ){}
+
+	private get prefix(): string { return this.ctype.toLowerCase() }
 
 	async send( as: string, body: InvitationV<C>['send']['body'] ): Promise<InvitationV<C>['send']['response']> {
-		const { error, message, data } = await this.http.request<Res<InvitationV<C>['send']['response']>>({
+		return await this.http.request<InvitationV<C>['send']['response']>({
 			url: `/${this.prefix}/invitation/${as}`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async cancel( body: InvitationV<C>['cancel']['body'] ): Promise<InvitationV<C>['cancel']['response']> {
-		const { error, message, data } = await this.http.request<Res<InvitationV<C>['cancel']['response']>>({
+		return await this.http.request<InvitationV<C>['cancel']['response']>({
 			url: `/${this.prefix}/invitation/cancel`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async accept( body: InvitationV<C>['accept']['body'] ): Promise<InvitationV<C>['accept']['response']> {
-		const { error, message, data } = await this.http.request<Res<InvitationV<C>['accept']['response']>>({
+		return await this.http.request<InvitationV<C>['accept']['response']>({
 			url: `/${this.prefix}/invitation/accept`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Shared/operators.ts

@@ -16,7 +16,7 @@ import type {
 	IoTSPSharedOperatorUpdateValidation,
 	IoTSPSharedOperatorRemoveValidation
 } from '@de./types/shared/operator'
-import { qs, type Http, type Res } from '../../utils'
+import { qs, type Http, type Res, type Data } from '../../utils'
 import type { OperatorContextType } from '@de./types'
 
 // ─── Validation map ───────────────────────────────────────────────────────────
@@ -54,39 +54,31 @@ export default class SharedOperators<C extends OperatorContextType> {
 	constructor( private http: Http, private ctype: OperatorContextType ){}
 
 	async list( querystring?: OperatorV<C>['fetch']['querystring'] ): Promise<OperatorV<C>['fetch']['response']> {
-		const { error, message, data } = await this.http.request<Res<OperatorV<C>['fetch']['response']>>({
+		return await this.http.request<OperatorV<C>['fetch']['response']>({
 			url: `/${this.ctype.toLowerCase()}/operators${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async retrieve( id: string ): Promise<OperatorV<C>['retrieve']['response']> {
-		const { error, message, data } = await this.http.request<Res<OperatorV<C>['retrieve']['response']>>({
+		return await this.http.request<OperatorV<C>['retrieve']['response']>({
 			url: `/${this.ctype.toLowerCase()}/operators/${id}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async update( id: string, body: OperatorV<C>['update']['body'] ): Promise<OperatorV<C>['update']['response']> {
-		const { error, message, data } = await this.http.request<Res<OperatorV<C>['update']['response']>>({
+		return await this.http.request<OperatorV<C>['update']['response']>({
 			url: `/${this.ctype.toLowerCase()}/operators/${id}`,
 			method: 'PATCH',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async remove( id: string ): Promise<OperatorV<C>['remove']['response']> {
-		const { error, message, data } = await this.http.request<Res<OperatorV<C>['remove']['response']>>({
+		return await this.http.request<OperatorV<C>['remove']['response']>({
 			url: `/${this.ctype.toLowerCase()}/operators/${id}`,
 			method: 'DELETE'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Shared/users.ts

@@ -4,35 +4,29 @@ import type {
 	SharedUserRemoveValidation
 } from '@de./types/shared/user'
 import type { ContextType } from '@de./types'
-import { qs, type Http, type Res } from '../../utils'
+import { qs, type Http, type Res, type Data } from '../../utils'
 
 export default class SharedUsers {
 	constructor( private http: Http, private ctype: ContextType ){}
 
 	async list( querystring?: SharedUserFetchValidation['querystring'] ): Promise<SharedUserFetchValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<SharedUserFetchValidation['response']>>({
+		return await this.http.request<SharedUserFetchValidation['response']>({
 			url: `/${this.ctype.toLowerCase()}/users${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async retrieve( uid: string ): Promise<SharedUserRetrieveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<SharedUserRetrieveValidation['response']>>({
+		return await this.http.request<SharedUserRetrieveValidation['response']>({
 			url: `/${this.ctype.toLowerCase()}/users/${uid}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async remove( uid: string ): Promise<SharedUserRemoveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<SharedUserRemoveValidation['response']>>({
+		return await this.http.request<SharedUserRemoveValidation['response']>({
 			url: `/${this.ctype.toLowerCase()}/users/${uid}`,
 			method: 'DELETE'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Tracking/index.ts

@@ -1,7 +1,7 @@
 import type { AccessOptions } from '../../types/access'
 import type { SharedTrackingSessionValidation } from '@de./types/shared/tracking'
 import AccessManager from '../Access'
-import { qs, type Res } from '../../utils'
+import { qs, type Res, type Data } from '../../utils'
 
 export type TrackingConfig = {
 	accessToken: string
@@ -9,6 +9,10 @@ export type TrackingConfig = {
 	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
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -28,17 +32,17 @@ export default class Tracking extends AccessManager {
 			accessToken:  config.accessToken,
 			env:          config.env      || 'dev',
 			platform:     config.platform || 'proxy',
-			remoteOrigin: config.remoteOrigin
+			remoteOrigin: config.remoteOrigin,
+			timeout:      config.timeout,
+			baseUrl:      config.baseUrl
 		}
 		super( access, 'API' )
 	}
 
 	async getSession( reference: string, role: SharedTrackingSessionValidation['querystring']['role'] ): Promise<SharedTrackingSessionValidation['response']> {
-		const { error, message, data } = await this.request<Res<SharedTrackingSessionValidation['response']>>({
+		return await this.request<SharedTrackingSessionValidation['response']>({
 			url: `/tracking/${reference}${qs({ role })}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Utilities/common.ts

@@ -6,7 +6,7 @@ import type {
 	UtilETAValidation,
 	UtilBatchGeocodeValidation
 } from '@de./types'
-import { type Http, type Res } from '../../utils'
+import { type Http, type Res, type Data } from '../../utils'
 
 // ─── Common Utilities ─────────────────────────────────────────────────────────
 
@@ -14,62 +14,50 @@ export class UtilitiesCommon {
 	constructor( private http: Http ){}
 
 	async distance( body: UtilDistanceValidation['body'] ): Promise<UtilDistanceValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilDistanceValidation['response']>>({
+		return await this.http.request<UtilDistanceValidation['response']>({
 			url: '/utilities/distance',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async distanceMatrix( body: UtilBatchDistanceMatrixValidation['body'] ): Promise<UtilBatchDistanceMatrixValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilBatchDistanceMatrixValidation['response']>>({
+		return await this.http.request<UtilBatchDistanceMatrixValidation['response']>({
 			url: '/utilities/distance/matrix',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async savingsMatrix( body: UtilSavingsMatrixValidation['body'] ): Promise<UtilSavingsMatrixValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilSavingsMatrixValidation['response']>>({
+		return await this.http.request<UtilSavingsMatrixValidation['response']>({
 			url: '/utilities/distance/savings',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async assignZone( body: UtilAssignZoneValidation['body'] ): Promise<UtilAssignZoneValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilAssignZoneValidation['response']>>({
+		return await this.http.request<UtilAssignZoneValidation['response']>({
 			url: '/utilities/zone',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async eta( body: UtilETAValidation['body'] ): Promise<UtilETAValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilETAValidation['response']>>({
+		return await this.http.request<UtilETAValidation['response']>({
 			url: '/utilities/eta',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async batchGeocode( body: UtilBatchGeocodeValidation['body'] ): Promise<UtilBatchGeocodeValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilBatchGeocodeValidation['response']>>({
+		return await this.http.request<UtilBatchGeocodeValidation['response']>({
 			url: '/utilities/geocode/batch',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Utilities/fares.ts

@@ -4,7 +4,7 @@ import type {
 	UtilRideFareValidation,
 	UtilCrossBorderFareValidation
 } from '@de./types'
-import { type Http, type Res } from '../../utils'
+import { type Http, type Res, type Data } from '../../utils'
 
 // ─── Fares ────────────────────────────────────────────────────────────────────
 
@@ -12,42 +12,34 @@ export class UtilitiesFares {
 	constructor( private http: Http ){}
 
 	async deliveryFees( body: UtilDeliveryFeesValidation['body'] ): Promise<UtilDeliveryFeesValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilDeliveryFeesValidation['response']>>({
+		return await this.http.request<UtilDeliveryFeesValidation['response']>({
 			url: '/utilities/fares/delivery',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async transportFare( body: UtilTransportFareValidation['body'] ): Promise<UtilTransportFareValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilTransportFareValidation['response']>>({
+		return await this.http.request<UtilTransportFareValidation['response']>({
 			url: '/utilities/fares/transport',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async rideFare( body: UtilRideFareValidation['body'] ): Promise<UtilRideFareValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilRideFareValidation['response']>>({
+		return await this.http.request<UtilRideFareValidation['response']>({
 			url: '/utilities/fares/ride',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async crossBorderFare( body: UtilCrossBorderFareValidation['body'] ): Promise<UtilCrossBorderFareValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilCrossBorderFareValidation['response']>>({
+		return await this.http.request<UtilCrossBorderFareValidation['response']>({
 			url: '/utilities/fares/crossborder',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Utilities/index.ts

@@ -13,6 +13,10 @@ export type UtilitiesConfig = {
 	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
 }
 
@@ -34,6 +38,8 @@ export default class Utilities extends AccessManager {
 			env:          config.env      || 'dev',
 			platform:     config.platform || 'proxy',
 			remoteOrigin: config.remoteOrigin,
+			timeout:      config.timeout,
+			baseUrl:      config.baseUrl,
 			version:      config.version
 		}
 

package/src/allend/Utilities/nearby.ts

@@ -3,7 +3,7 @@ import type {
 	UtilSearchInBoundsValidation,
 	UtilFindNearestValidation
 } from '@de./types'
-import { type Http, type Res } from '../../utils'
+import { type Http, type Res, type Data } from '../../utils'
 
 // ─── Nearby ───────────────────────────────────────────────────────────────────
 
@@ -11,32 +11,26 @@ export class UtilitiesNearby {
 	constructor( private http: Http ){}
 
 	async search( body: UtilSearchNearbyValidation['body'] ): Promise<UtilSearchNearbyValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilSearchNearbyValidation['response']>>({
+		return await this.http.request<UtilSearchNearbyValidation['response']>({
 			url: '/utilities/nearby/search',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async searchInBounds( body: UtilSearchInBoundsValidation['body'] ): Promise<UtilSearchInBoundsValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilSearchInBoundsValidation['response']>>({
+		return await this.http.request<UtilSearchInBoundsValidation['response']>({
 			url: '/utilities/nearby/bounds',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async findNearest( body: UtilFindNearestValidation['body'] ): Promise<UtilFindNearestValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<UtilFindNearestValidation['response']>>({
+		return await this.http.request<UtilFindNearestValidation['response']>({
 			url: '/utilities/nearby/nearest',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Workflows/Client.ts

@@ -26,11 +26,9 @@ export default class Client extends AccessManager {
     options: HTTPRequestOptions = {
       url: `/client/${this.clientId}/orders/actives`,
       method: 'GET'
-    },
-    { error, message, data } = await this.request<OrderServiceResponse>( options )
-    if( error ) throw new Error( message )
-    
-    return data.orders
+    }
+
+    return await this.request<OrderServiceResponse>( options )
   }
 
   async fetchOrderHistory(){
@@ -41,11 +39,9 @@ export default class Client extends AccessManager {
     options: HTTPRequestOptions = {
       url: `/client/${this.clientId}/orders/history`,
       method: 'GET'
-    },
-    { error, message, data } = await this.request<OrderServiceResponse>( options )
-    if( error ) throw new Error( message )
-    
-    return data.orders
+    }
+
+    return await this.request<OrderServiceResponse>( options )
   }
 
   async nearby( location: RTLocation ){
@@ -63,10 +59,8 @@ export default class Client extends AccessManager {
       url: `/client/${this.clientId}/nearby`,
       method: 'POST',
       body: location
-    },
-    { error, message, data } = await this.request<NearbyResponse>( options )
-    if( error ) throw new Error( message )
-    
-    return data.nearby
+    }
+
+    return await this.request<NearbyResponse>( options )
   }
 }