leasy v0.1.0

Leasy JS SDK

This library implements helpers to interact with the Leasy API without any knowledge about the API itself. It comes with TypeScript types and comprehensive JSDoc comments to integrate nicely with your IDE of choice. The library works in the browser as well as in Node.js. In the browser, this library should be used with caution: The bundle size is large and expected to grow. The current design choice of wrapping methods in a class does not allow for code splitting. If you only need to make simple read operations, we recommend direct GraphQL calls to the API endpoint with a read key.

Installation

Install the Leasy JavaScript SDK with npm or yarn:

$ npm install leasy
# or
$ yarn add leasy

Usage

To be able to connect to Leasy, you will have to create an API key. Currently, the SDK supports operations that need at most WRITE permissions. If you use this SDK in the frontend, the default should be to use only the READ permission level and do the booking operations in the backend, unless you want your users to make bookings freely. After you created a key, you can pass it to a new Leasy Client instance:

import { Client } from 'leasy';

const leasy = new Client({ apiKey: '<YOUR_API_KEY_HERE>' });

Example

import { Client } from 'leasy';

const leasy = new Client({ apiKey: '<YOUR_API_KEY_HERE>' });
const resourceId = '<SOME_RESOURCE_ID>';

const example = async () => {
  // Load all upcoming available slots
  const slots = await leasy.timeSlots.byResource({
    resourceId,
    filter: { available: true },
  });
  const nextAvailableSlot = slots.nodes[0];

  if (nextAvailableSlot) {
    // Attempt to create a reservation, this line might throw if unsuccessful
    // After this, the reservation is ours, we have to complete it within the next 15 minutes
    const reservation = await leasy.reservations.create({
      bookings: [
        {
          bookableId: resourceId,
          start: nextAvailableSlot.startTime,
          end: nextAvailableSlot.endTime,
        },
      ],
    });

    // in this example we complete the reservation immediately, in the real world, you might want to
    // guide the customer through some kind of checkout process and e.g. receive some payments
    await leasy.reservations.update(reservation.id, reservation => [reservation.complete()]);
  }
};