Your own types

In case you are using your own types or types from external library, the SDK provides a way to convert the SDK types to and from your own types.

The conversion is handled by "type handlers". You need to pass typeHandlers when you create a new SDK instance.

A type handler is an object containing the following properties:

Property	Description
`sdkType`	The SDK type.
`appType`	The application specific type to convert SDK type to/from.
`canHandle`	A predicate function (i.e. function that returns truthy or falsy) that defines whether the this handler should be used. The SDK makes sure that `canHandle` will be called only for not `null` Object values, thus `null` check can be safely omitted.
`reader`	Conversion function. Gets an instance of `sdkType` as an argument, should return instance of `appType`.
`writer`	Conversion function. Gets an instance of `appType` as an argument, should return instance of `sdkType`.

Either appType or canHandle should be provider, but not both.

Please note: v1.4.0 renamed type to sdkType and customType to appType.

Example: Convert google.maps.LatLng to/from LatLng, Decimal.js Decimal to/from BigDecimal and own plain object UUID representation to UUID type class instance.

const { BigDecimal, LatLng } = require('sharetribe-flex-sdk').types;

const integrationSdk = createInstance({
  clientId: "<your client ID>",
  clientSecret: "<your client secret>",
  typeHandlers: [
    {
      sdkType: BigDecimal,
      appType: Decimal,
      writer: v => new BigDecimal(v.toString()),
      reader: v => new Decimal(v.value),
    },
      sdkType: LatLng,
      appType: google.maps.LatLng,
      writer: v => new LatLng(v.lat(), v.lng()),
      reader: v => new google.maps.LatLng(v.lat, v.lng)
    },
    {
      sdkType: UUID,
      canHandle: v => v.isMyOwnUuidType,
      writer: v => new UUID(v.myOwnUuidValue),
      reader: v => ({myOwnUuidValue: v.uuid,
                     isMyOwnUuidType: true})
    }
  ]
});

Caveat: Only body parameters are converted. An error Don't know how to serialize query parameter will be thrown if query parameters contain your own types.