sdk-v0.1.2

Full Changelog: sdk-v0.1.1...sdk-v0.1.2

sdk-v0.1.1

Full Changelog: sdk-v0.1.0...sdk-v0.1.1

@calemly/sdk v0.1.1 (sdk-v0.1.1)

Why

Fixes UI inconsistency when embedding the SDK in external apps where host CSS previously overrode SDK styling.

What changed

• Scoped Tailwind utilities under .calemly-sdk for style isolation.
• Added .calemly-sdk wrappers across SDK render roots.
• Added scoped base normalization for typography/form elements/box-sizing.
• Fixed invalid utility class in conflict resolver spacing (pl-[3.25rem]).
• Updated troubleshooting docs for style import + CSS pipeline behavior.

Impact

• No API contract changes.
• No breaking changes for component usage.
• Consumers should import @calemly/sdk/styles.css once at app entrypoint.

Consumer action

• Upgrade to @calemly/sdk@0.1.1.
• Ensure one global SDK stylesheet import at app entry.
• Rebuild and run UI smoke tests for booking flows.

Calemly React SDK v0.1.0

Calemly React SDK v0.1.0

The first production release of @calemly/sdk, a React SDK that embeds Calemly's booking experience with the same core flow and layout used in the native widget.

Highlights

• Full booking flow parity:

  • event selection
  • slot picking
  • guest confirmation
  • conflict resolution
  • custom form fields
  • optional payment checkout
  • booking success state

• Flexible embed options:

  • SchedulerWidget for fast integration
  • SchedulerProvider + useBooking for custom layouts
  • inline and modal modes
  • event slug mode (without embed key)

• Production-ready behavior:

  • idempotent booking submissions (client_request_id)
  • short-lived signed widget token support
  • conflict suggestion and recovery UX
  • template reuse ("Book same as last time")
  • graceful rate-limit handling (429 + Retry-After)
  • offline-safe error handling

Payments

• Paid event support with Stripe and PayPal flows
• Stripe checkout support via stripePublishableKey
• PayPal order create/approval/capture flow with return handling
• Booking finalization integrated with payment lifecycle

Security and Tokening

• Signed widget token flow supported and recommended
• tokenProvider support for server-issued tokens
• Automatic widget-token path available for embed key mode

SDK Exports

• SchedulerWidget
• SchedulerProvider
• useBooking
• BOOKING_STEPS
• SlotPicker
• BookingForm
• BookingSuccess
• CustomFormRenderer
• validateFormAnswers
• ConflictResolver
• PaymentCheckout

API Coverage

The SDK integrates with public booking and billing endpoints including:

• /embed/public/event-types
• /embed/public/widget-token
• /bookings/public/event/:slug
• /bookings/public/slots
• /bookings/public/recent-templates
• /bookings/auto-suggest
• /bookings/suggestions
• /bookings/public/preferences
• /bookings/public
• /billing/public/event-payment/:eventTypeId
• /billing/public/create-payment-intent
• /billing/public/create-paypal-order
• /billing/public/capture-paypal-order

UX and Styling

• Tailwind-based packaged stylesheet (@calemly/sdk/styles.css)
• Responsive booking UX for desktop and mobile
• Theming support: light, dark, system

Release Hardening and Verification

• CI and publish workflows validated
• npm provenance publish path validated and fixed
• Runtime dependency audit passed (0 vulnerabilities)
• Package published successfully to npm registry

Install

npm install @calemly/sdk

Then import styles once:

import '@calemly/sdk/styles.css';

---

This release is focused on stable production readiness while preserving UI behavior and layout parity with the existing Calemly booking experience.