@bookr-cl/widget 0.0.1

package/README.md

@@ -0,0 +1,34 @@
+# @bookr-cl/widget
+
+Shared booking-flow logic (typed API client, auth helpers, and React hooks) used by Bookr client widgets (ko-pilates, magnolia, and future clients — including third-party integrators). Each site keeps its own JSX/Tailwind presentation layer — this package only owns the parts that cause bugs when duplicated: API calls, validation, state machines, and auth/token handling.
+
+## Install
+
+Published on the public npm registry — no auth or custom `.npmrc` needed:
+
+```bash
+npm install @bookr-cl/widget
+```
+
+Requires React 19+ (see `peerDependencies`).
+
+## What's exported
+
+- `api.ts` — thin typed functions for every Bookr endpoint the widgets call (`listLocations`, `createBooking`, `sendMagicLink`, etc.), each taking an explicit `{ apiBase, apiKey }` config.
+- `clientAuth.ts` — `getClientToken`/`setClientToken`/`clearClientToken`/`fetchMe`.
+- `dateUtils.ts` — week/date helpers and the default provider-color palette used by class-schedule UIs.
+- `hooks/useBookingFlow` — locations→services→providers→slots fetch chain, validation, submit with 409 handling. Anonymous submissions are resolved server-side by contact fields (rut/email); a caller-supplied `client_id` is only honored alongside a client or staff auth token.
+- `hooks/useClassSchedule` — weekly group-class schedule fetch/submit logic, same anonymous-booking contract as `useBookingFlow`.
+- `hooks/useMagicLinkAuth` — passwordless (magic-link) auth; also accepts optional profile fields (`firstName`/`lastName`/`phone`/`rut`) for signup-style forms, linked server-side by rut first, then email.
+- `hooks/useRegisterForm`, `useClientAccount` — the client account/auth pages' remaining logic.
+
+## Publishing a new version
+
+Publishing happens under the `bookr-cl` npm account (a service account for the product, not any individual's personal npm login):
+
+```bash
+npm run build
+npm version patch   # or minor/major
+npm publish
+git push --tags
+```