Installation

``
npm i @karhoo/demand-deeplink
`

Warnings

This library uses URLSearchParams. For old browsers, e.g. IE11 you must bring your own polyfill. You can use either js-core@3 or url-search-params-polyfill(version 8 and above)

This library uses Promise. For old browsers, e.g. IE11 you must bring your own polyfill. You can use js-core@3 to polyfill Promise

Usage

`js
import { parse, validate, generate, Deeplink } from '@karhoo/demand-deeplink'
`

Parse deeplink:

`js
const deeplinkData = parse(window.location.search)
`

Validate deeplink:

`js
const { ok, errors } = validate(deeplinkData)
`

Generate deeplink:

`js
const queryString = generate(deeplinkData)
`

Resolve deeplink:

To use Deeplink class api parameter (see Api type here) should be passed as a second argument of Deeplink constructor. For this purposes @karhoo/demand-api can be used.

`js
import { getApi } from '@karhoo/demand-api'

const api = getApi()

const subscriber = data => console.log(data)

const deeplink = new Deeplink(window.location.search, api)

deeplink.resolve(subscriber)
`

$3

A lot of deeplink examples can be find here

Let's imagine, you want to deeplink from a hotel booking website to a Karhoo cab booking website.

Your customer booked a hotel room and reached their booking confirmation page. From here you can offer a complementary service to book a cab to a hotel's location.

At this stage, you know:

1. Hotel address
2. Time when a cab required _(based on hotel check-in hours)_
3. Number of passengers
4. Passenger first and last name _(if you're willing to pass it)_

All these parameters can be embedded to a Deeplink and passed to a Karhoo booking app.

_Step 1. Compose deeplink data_

`js
const deeplinkData = {
legs: [
{
dropoff: 'Hotel Ermitage, London, UK',
pickupTime: '2020-03-12T12:00:00+01:00',
},
],
passengerInfo: {
passengers: 3,
firstName: 'Jon',
},
bookingType: 'PRE-BOOK',
meta: {},
}
`

_Step 2. Validate deeplink data_

`js
import { validate } from '@karhoo/demand-deeplink'

const { ok, errors } = validate(deeplinkData)

if (!ok) {
console.log('Deeplink data is invalid', errors)
}
`

_Step 3. Generate a deeplink_

`js
import { validate, generate } from '@karhoo/demand-deeplink'

const { ok, errors } = validate(deeplinkData)

if (!ok) {
console.log('Deeplink data is invalid', errors)
return
}

const deeplink = generate(deeplinkData)
`

`js
console.log(deeplink) // ?leg-1-dropoff=Hotel+Ermitage%2C+London%2C+UK&leg-1-pickup-time=2020-03-12T12%3A00%3A00%2B01%3A00&passengers=3&first-name=Jon&booking-type=PRE-BOOK
`

When you get a deeplink you can navigate your user from your website by adding the link to href attribute.

For example, Book a cab to a hotel

Issues

_Looking to contribute?_

$3

Please file an issue for bugs, missing documentation, or unexpected behavior with a label DEEPLINK

$3

Please file an issue to suggest new features with a label DEEPLINK. Vote on feature requests by adding
a 👍. This helps maintainers prioritize what to work on.

$3

For questions related to using the library, please re-visit a documentation first. If there are no answer, please create an issue with a label help needed and DEEPLINK`.

Contributing

$3

BSD-2-Clause