@staycore/booking-sdk

TypeScript SDK for the Stay'Core PMS public booking engine API (v1).

Connect any web app (Vite / Next.js / Remix / Astro / vanilla browser / Node service / edge runtime) to the Stay'Core direct booking engine in a few lines.

Install

pnpm add @staycore/booking-sdk
# or
npm install @staycore/booking-sdk

Quickstart (vanilla)

import { createPmsClient } from '@staycore/booking-sdk';

const pms = createPmsClient({ orgSlug: 'mon-org' });

const config = await pms.config();
const properties = await pms.properties.list();
const price = await pms.price.compute(properties[0].id, {
  check_in: '2026-08-01',
  check_out: '2026-08-05',
  guests_count: 2,
});

const checkout = await pms.checkout.create({
  property_id: properties[0].id,
  guest_name: 'Jean Dupont',
  guest_email: '[email protected]',
  check_in: '2026-08-01',
  check_out: '2026-08-05',
  guests_count: 2,
});

// checkout.client_secret → Stripe Elements

React hooks

import {
  StayCoreProvider,
  useProperties,
  useAvailability,
  usePrice,
  useCheckout,
} from '@staycore/booking-sdk/react';

function App() {
  return (
    <StayCoreProvider orgSlug="mon-org">
      <Booking />
    </StayCoreProvider>
  );
}

function Booking() {
  const { data: properties, isLoading } = useProperties();
  // …
}

API surface

pms.config()                                          // GET /book/{slug}
pms.properties.list()                                 // GET /book/{slug}/properties
pms.availability.get(propertyId)                      // GET /book/{slug}/properties/{id}/availability
pms.price.compute(propertyId, params)                 // GET /book/{slug}/properties/{id}/price?...
pms.checkout.create(payload)                          // POST /book/{slug}/checkout
pms.coupon.validate(payload)                          // POST /book/{slug}/validate-coupon
pms.booking.get(token)                                // GET /book/{slug}/booking/{token}
pms.booking.confirm(token)                            // POST /book/{slug}/booking/{token}/confirm

Error handling

import { StayCoreApiError } from '@staycore/booking-sdk';

try {
  await pms.checkout.create(payload);
} catch (err) {
  if (err instanceof StayCoreApiError) {
    console.error(err.status, err.message, err.body);
    if (err.isClientError) /* show user error */;
  }
}

Custom base URL / advanced options

createPmsClient({
  orgSlug: 'mon-org',
  baseUrl: 'https://api.stay-core.com/api/v1', // default
  timeoutMs: 30000,
  defaultHeaders: { 'Accept-Language': 'fr' },
  fetch: customFetch, // node < 18 / monkey-patched
});

Versioning

The SDK targets /api/v1/book/... — a frozen, additive route group on the Stay'Core backend, guarded by BookingContractTest.php.

Breaking changes would require /api/v2/... and a major version bump (@staycore/[email protected]).

License

MIT © Keenqo — Stay'Core