@de./sdk 1.0.5 → 2.1.0

package/src/allend/CSP/webhooks.ts

@@ -7,7 +7,7 @@ import type {
 	CSPWebhookLogsValidation,
 	CSPWebhookTestValidation
 } from '@de./types/csp/webhook'
-import { qs, type Http, type Res } from '../../utils'
+import { qs, type Http, type Res, type Data } from '../../utils'
 
 // ── CSP Webhooks ──────────────────────────────────────────────────────────
 
@@ -15,68 +15,54 @@ export default class CSPWebhooks {
 	constructor( private http: Http ){}
 
 	async create( body: CSPWebhookCreateValidation['body'] ): Promise<CSPWebhookCreateValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookCreateValidation['response']>>({
+		return await this.http.request<CSPWebhookCreateValidation['response']>({
 			url: '/csp/webhooks',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async list( querystring?: CSPWebhookListValidation['querystring'] ): Promise<CSPWebhookListValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookListValidation['response']>>({
+		return await this.http.request<CSPWebhookListValidation['response']>({
 			url: `/csp/webhooks${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async retrieve( id: string ): Promise<CSPWebhookRetrieveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookRetrieveValidation['response']>>({
+		return await this.http.request<CSPWebhookRetrieveValidation['response']>({
 			url: `/csp/webhooks/${id}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async update( id: string, body: CSPWebhookUpdateValidation['body'] ): Promise<CSPWebhookUpdateValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookUpdateValidation['response']>>({
+		return await this.http.request<CSPWebhookUpdateValidation['response']>({
 			url: `/csp/webhooks/${id}`,
 			method: 'PATCH',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async remove( id: string ): Promise<CSPWebhookRemoveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookRemoveValidation['response']>>({
+		return await this.http.request<CSPWebhookRemoveValidation['response']>({
 			url: `/csp/webhooks/${id}`,
 			method: 'DELETE'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async logs( id: string, querystring?: CSPWebhookLogsValidation['querystring'] ): Promise<CSPWebhookLogsValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookLogsValidation['response']>>({
+		return await this.http.request<CSPWebhookLogsValidation['response']>({
 			url: `/csp/webhooks/${id}/logs${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async test( id: string, body?: CSPWebhookTestValidation['body'] ): Promise<CSPWebhookTestValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CSPWebhookTestValidation['response']>>({
+		return await this.http.request<CSPWebhookTestValidation['response']>({
 			url: `/csp/webhooks/${id}/test`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Customer/index.ts

@@ -1,4 +1,4 @@
-import type { AccessOptions } from '../../types/access'
+import type { AccessOptions, UserSession } from '../../types/access'
 import AccessManager from '../Access'
 import CustomerIntents from './intents'
 import CustomerOrders from './orders'
@@ -10,6 +10,15 @@ export type CustomerConfig = {
 	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
+	/**
+	 * The signed-in customer, when the client acts on their behalf rather
+	 * than as the integration itself.
+	 */
+	session?: UserSession
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -33,7 +42,10 @@ export default class Customer 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,
+			session:      config.session
 		}
 		super( access, 'API' )
 

package/src/allend/Customer/intents.ts

@@ -6,7 +6,7 @@ import type {
 	CustomerIntentSubmitValidation,
 	CustomerIntentCancelValidation
 } from '@de./types'
-import { type Http, type Res } from '../../utils'
+import { type Http, type Res, type Data } from '../../utils'
 
 // ─── Customer Intents ─────────────────────────────────────────────────────────
 
@@ -14,65 +14,53 @@ export default class CustomerIntents {
 	constructor( private http: Http ){}
 
 	async create( body: CustomerIntentCreateValidation['body'] ): Promise<CustomerIntentCreateValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerIntentCreateValidation['response']>>({
+		return await this.http.request<CustomerIntentCreateValidation['response']>({
 			url: '/customer/intents',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async get( intentToken: string ): Promise<CustomerIntentGetValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerIntentGetValidation['response']>>({
+		return await this.http.request<CustomerIntentGetValidation['response']>({
 			url: '/customer/intents',
 			method: 'GET',
 			headers: { 'x-intent-token': intentToken }
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async addWaypoints( intentToken: string, body: CustomerIntentAddWaypointsValidation['body'] ): Promise<CustomerIntentAddWaypointsValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerIntentAddWaypointsValidation['response']>>({
+		return await this.http.request<CustomerIntentAddWaypointsValidation['response']>({
 			url: '/customer/intents/waypoints',
 			method: 'POST',
 			headers: { 'x-intent-token': intentToken },
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async addPackages( intentToken: string, body: CustomerIntentAddPackagesValidation['body'] ): Promise<CustomerIntentAddPackagesValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerIntentAddPackagesValidation['response']>>({
+		return await this.http.request<CustomerIntentAddPackagesValidation['response']>({
 			url: '/customer/intents/packages',
 			method: 'POST',
 			headers: { 'x-intent-token': intentToken },
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async submit( intentToken: string, body: CustomerIntentSubmitValidation['body'] ): Promise<CustomerIntentSubmitValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerIntentSubmitValidation['response']>>({
+		return await this.http.request<CustomerIntentSubmitValidation['response']>({
 			url: '/customer/intents/submit',
 			method: 'POST',
 			headers: { 'x-intent-token': intentToken },
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async cancel( intentToken: string ): Promise<CustomerIntentCancelValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerIntentCancelValidation['response']>>({
+		return await this.http.request<CustomerIntentCancelValidation['response']>({
 			url: '/customer/intents',
 			method: 'DELETE',
 			headers: { 'x-intent-token': intentToken }
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Customer/orders.ts

@@ -5,7 +5,7 @@ import type {
 	CustomerOrderCancelValidation,
 	CustomerOrderRatingValidation
 } from '@de./types'
-import { qs, type Http, type Res } from '../../utils'
+import { qs, type Http, type Res, type Data } from '../../utils'
 
 // ─── Customer Orders ──────────────────────────────────────────────────────────
 
@@ -13,49 +13,39 @@ export default class CustomerOrders {
 	constructor( private http: Http ){}
 
 	async list( querystring?: CustomerOrderListValidation['querystring'] ): Promise<CustomerOrderListValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerOrderListValidation['response']>>({
+		return await this.http.request<CustomerOrderListValidation['response']>({
 			url: `/customer/orders${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async get( reference: string, querystring?: CustomerOrderGetValidation['querystring'] ): Promise<CustomerOrderGetValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerOrderGetValidation['response']>>({
+		return await this.http.request<CustomerOrderGetValidation['response']>({
 			url: `/customer/orders/${reference}${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async tracking( reference: string ): Promise<CustomerOrderTrackingValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerOrderTrackingValidation['response']>>({
+		return await this.http.request<CustomerOrderTrackingValidation['response']>({
 			url: `/customer/orders/${reference}/tracking`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async cancel( reference: string, body: CustomerOrderCancelValidation['body'] ): Promise<CustomerOrderCancelValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerOrderCancelValidation['response']>>({
+		return await this.http.request<CustomerOrderCancelValidation['response']>({
 			url: `/customer/orders/${reference}/cancel`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async rating( reference: string, body: CustomerOrderRatingValidation['body'] ): Promise<CustomerOrderRatingValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerOrderRatingValidation['response']>>({
+		return await this.http.request<CustomerOrderRatingValidation['response']>({
 			url: `/customer/orders/${reference}/rating`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/Customer/rides.ts

@@ -6,7 +6,7 @@ import type {
 	CustomerRideCancelValidation,
 	CustomerRideRatingValidation
 } from '@de./types'
-import { qs, type Http, type Res } from '../../utils'
+import { qs, type Http, type Res, type Data } from '../../utils'
 
 // ─── Customer Rides ───────────────────────────────────────────────────────────
 
@@ -14,59 +14,47 @@ export default class CustomerRides {
 	constructor( private http: Http ){}
 
 	async request( body: CustomerRideRequestValidation['body'] ): Promise<CustomerRideRequestValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerRideRequestValidation['response']>>({
+		return await this.http.request<CustomerRideRequestValidation['response']>({
 			url: '/customer/rides',
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async list( querystring?: CustomerRideListValidation['querystring'] ): Promise<CustomerRideListValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerRideListValidation['response']>>({
+		return await this.http.request<CustomerRideListValidation['response']>({
 			url: `/customer/rides${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async get( reference: string ): Promise<CustomerRideGetValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerRideGetValidation['response']>>({
+		return await this.http.request<CustomerRideGetValidation['response']>({
 			url: `/customer/rides/${reference}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async tracking( reference: string ): Promise<CustomerRideTrackingValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerRideTrackingValidation['response']>>({
+		return await this.http.request<CustomerRideTrackingValidation['response']>({
 			url: `/customer/rides/${reference}/tracking`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async cancel( reference: string, body: CustomerRideCancelValidation['body'] ): Promise<CustomerRideCancelValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerRideCancelValidation['response']>>({
+		return await this.http.request<CustomerRideCancelValidation['response']>({
 			url: `/customer/rides/${reference}/cancel`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async rating( reference: string, body: CustomerRideRatingValidation['body'] ): Promise<CustomerRideRatingValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<CustomerRideRatingValidation['response']>>({
+		return await this.http.request<CustomerRideRatingValidation['response']>({
 			url: `/customer/rides/${reference}/rating`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/DEV/developers.ts

@@ -1,9 +1,10 @@
+import type { APIResponseBase } from '@de./types'
 import type {
 	DEVDeveloperRetrieveValidation,
 	DEVDeveloperFetchValidation,
 	DEVDeveloperUpdateValidation
 } from '@de./types/dev/developer'
-import { type Http, type Res } from '../../utils'
+import { type Http, type Res, type Data } from '../../utils'
 
 // ── DEV Developers ──────────────────────────────────────────────────────────────
 
@@ -11,38 +12,31 @@ export default class DEVDevelopers {
 	constructor( private http: Http ){}
 
 	async list(): Promise<DEVDeveloperFetchValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<DEVDeveloperFetchValidation['response']>>({
+		return await this.http.request<DEVDeveloperFetchValidation['response']>({
 			url: '/dev/developers',
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async retrieve( id: string ): Promise<DEVDeveloperRetrieveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<DEVDeveloperRetrieveValidation['response']>>({
+		return await this.http.request<DEVDeveloperRetrieveValidation['response']>({
 			url: `/dev/developers/${id}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async update( id: string, body: DEVDeveloperUpdateValidation['body'] ): Promise<DEVDeveloperUpdateValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<DEVDeveloperUpdateValidation['response']>>({
+		return await this.http.request<DEVDeveloperUpdateValidation['response']>({
 			url: `/dev/developers/${id}`,
 			method: 'PATCH',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
-	async remove( id: string ): Promise<void> {
-		const { error, message } = await this.http.request<Res<unknown>>({
+	async remove( id: string ): Promise<APIResponseBase> {
+		return await this.http.request<APIResponseBase>({
 			url: `/dev/developers/${id}`,
 			method: 'DELETE'
 		})
-		if( error ) throw new Error( message )
 	}
 }

package/src/allend/DEV/index.ts

@@ -9,6 +9,10 @@ export type DEVConfig = {
 	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
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -32,7 +36,9 @@ export default class DEV extends SharedContextClient<'DEV'> {
 			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, 'DEV' )
 

package/src/allend/IoTSP/backend.ts

@@ -1,5 +1,5 @@
 import { io, type Socket } from 'socket.io-client'
-import { IOT_SERVER_BASEURL } from '../../baseUrl'
+import { baseURL as resolveBaseURL } from '../../baseUrl'
 
 // ─── Config ───────────────────────────────────────────────────────────────────
 
@@ -7,6 +7,8 @@ export type IoTBackendConfig = {
 	channel: string
 	accessToken: string
 	env?: 'dev' | 'staging' | 'prod'
+	/** Host to substitute for `localhost` in `dev` (Eg. a native emulator) */
+	devHostname?: string
 }
 
 // ─── Record API ───────────────────────────────────────────────────────────────
@@ -84,8 +86,8 @@ export default class IoTBackend {
 
 	connect(): { socket: Socket, records: Records } {
 		const
-		baseURL = IOT_SERVER_BASEURL[ this.config.env || 'dev' ],
-		socket  = io(`${baseURL}/${this.config.channel}`, {
+		host   = resolveBaseURL('IOT', this.config.env || 'dev', this.config.devHostname ),
+		socket = io(`${host}/${this.config.channel}`, {
 			auth: { accessToken: this.config.accessToken }
 		})
 

package/src/allend/IoTSP/devices.ts

@@ -7,7 +7,7 @@ import type {
 	IoTDeviceStatusValidation,
 	IoTDeviceUpdateValidation
 } from '@de./types/iotsp/device'
-import { qs, type Http, type Res } from '../../utils'
+import { qs, type Http, type Res, type Data } from '../../utils'
 
 // ── Devices ───────────────────────────────────────────────────────────────
 
@@ -15,76 +15,60 @@ export default class IoTDevices {
 	constructor( private http: Http ){}
 
 	async add( body: IoTDeviceAddValidation['body'] ): Promise<IoTDeviceAddValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceAddValidation['response']>>({
+		return await this.http.request<IoTDeviceAddValidation['response']>({
 			url: `/iotsp/devices/add`,
 			method: 'POST',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async update( id: string, body: IoTDeviceUpdateValidation['body'] ): Promise<IoTDeviceUpdateValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceUpdateValidation['response']>>({
+		return await this.http.request<IoTDeviceUpdateValidation['response']>({
 			url: `/iotsp/devices/${id}`,
 			method: 'PATCH',
 			body
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async list( querystring?: IoTDeviceListValidation['querystring'] ): Promise<IoTDeviceListValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceListValidation['response']>>({
+		return await this.http.request<IoTDeviceListValidation['response']>({
 			url: `/iotsp/devices${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async find( querystring: IoTDeviceFindValidation['querystring'] ): Promise<IoTDeviceFindValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceFindValidation['response']>>({
+		return await this.http.request<IoTDeviceFindValidation['response']>({
 			url: `/iotsp/devices/find${qs( querystring )}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async get( id: string ): Promise<IoTDeviceRetrieveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceRetrieveValidation['response']>>({
+		return await this.http.request<IoTDeviceRetrieveValidation['response']>({
 			url: `/iotsp/devices/${id}`,
 			method: 'GET'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async enable( id: string ): Promise<IoTDeviceStatusValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceStatusValidation['response']>>({
+		return await this.http.request<IoTDeviceStatusValidation['response']>({
 			url: `/iotsp/devices/${id}/enable`,
 			method: 'PATCH'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
  
 	async disable( id: string ): Promise<IoTDeviceStatusValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceStatusValidation['response']>>({
+		return await this.http.request<IoTDeviceStatusValidation['response']>({
 			url: `/iotsp/devices/${id}/disable`,
 			method: 'PATCH'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 
 	async delete( id: string ): Promise<IoTDeviceRemoveValidation['response']> {
-		const { error, message, data } = await this.http.request<Res<IoTDeviceRemoveValidation['response']>>({
+		return await this.http.request<IoTDeviceRemoveValidation['response']>({
 			url: `/iotsp/devices/${id}`,
 			method: 'DELETE'
 		})
-		if( error ) throw new Error( message )
-		return data
 	}
 }

package/src/allend/IoTSP/index.ts

@@ -14,6 +14,10 @@ export type IoTSPConfig = {
 	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
 	backend?: IoTBackendConfig
 }
 
@@ -41,7 +45,9 @@ export default class IoTSP extends SharedContextClient<'IoTSP'> {
 			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, 'IoTSP' )