@farthershore/farthershore-js 0.8.7 → 0.10.0

package/CHANGELOG.md

@@ -3,7 +3,92 @@
 All notable changes to `@farthershore/farthershore-js` are documented here.
 This project adheres to Semantic Versioning (pre-1.0: minors may break).
 
-## [Unreleased]
+## [0.10.0] - 2026-07-02
+
+Frontend SDK ergonomics redesign — the headless client + hooks are now the
+default surface and the styled portal is an opt-in layer.
+
+### Changed (BREAKING)
+
+- **`productId` → `businessId`** across the public surface (config,
+  `ClientContext`, resources, hooks, params). No `productId` remains in the
+  public API.
+- **Ecosystem hook shape:** every data hook returns
+  `{ data, error, isLoading, isError, isSuccess, refetch, queryKey }`. The bare
+  `loading` field and `refresh` alias are removed (use `isLoading` / `refetch`).
+- **`/errors` subpath:** the full error taxonomy + parse/predicate helpers moved
+  to `@farthershore/farthershore-js/errors`. The root re-exports only
+  `FartherShoreError`, `FartherShoreApiError`, `LimitExceededError`,
+  `FartherShoreRateLimitedError`, and `FartherShoreConfigError`.
+- **`format` namespace:** the catalog display/derivation helpers are grouped
+  under `format` (`import { format } from "@farthershore/farthershore-js"`);
+  they are no longer flat root exports.
+- Removed the SSR/`createServerClient` surface (platform is browser-only).
+
+### Added
+
+- **Zero-config client:** `createFartherShoreClient()` with no args on-platform
+  (lazy `window.__FS_CONFIG__`, `businessId` discovered from the portal host);
+  manual `{ coreUrl, portalHost, businessId, getToken }` is a documented
+  dev/test escape hatch.
+- **`fs.fetch(url, opts)`** drop-in secure fetch with a client-side variable
+  registry + `PROVIDER_CATALOG` host inference.
+- **`/react`:** prop-free `<FartherShoreProvider>`; `useReadScope()`;
+  `useFetch()`; a TanStack-Query / SWR adapter (`fsQueryOptions`,
+  `createFsFetcher`) with no runtime dependency on either library.
+- **Composable components:** data components render under a bare
+  `<FartherShoreProvider>` (no forced `FartherShoreRoot`);
+  `PlansTable`/`UsageCard` gain `renderRow`, `BillingSummary` gains
+  `slots.actions`; themeable z-index via `--fs-*-z` CSS variables.
+- **`FartherShoreRoot`** is now a composition of `FsBootGate` /
+  `FsAuthProvider` / `FsThemeProvider` with `skipAuth` / `skipTheme` /
+  `skipBootGate` flags.
+- **`/test-utils` subpath:** `createMockFartherShoreClient`,
+  `<FartherShoreTestProvider>`, and typed error builders
+  (`mockLimitExceeded` / `mockRateLimited` / `mockApiError`).
+
+### Fixed
+
+- `<OrgSwitcher>` read a non-existent `organizationName` field and showed raw
+  organization ids; it now reads the `name` field the platform actually sends.
+- `fs.fetch` variable resolution no longer silently hands a lone host-less
+  variable to a call targeting a _different_ recognized provider host (e.g. a
+  sole `STRIPE_SECRET_KEY` against `api.openai.com`) — it throws
+  `FartherShoreConfigError` on that ambiguity, as documented.
+- `sideEffects` now allowlists `*.css` (was `false`), so webpack-based
+  consumers no longer tree-shake away the `./components/styles.css` /
+  `./components/docs.css` side-effect imports in production builds.
+
+## [0.9.0] - 2026-06-29
+
+### Changed (BREAKING)
+
+- Removed the no-code theming surface as part of the platform/repo branding
+  separation: `FsAppearance` is trimmed to `{ theme, brandColor, variables }`
+  (the `fontFamily`/`radius`/`density`/`colorScheme` dimensions and the
+  `FsFontFamily`/`FsRadius`/`FsDensity`/`FsColorScheme` types are gone), and
+  `BusinessAppearance` + `primaryColor` are dropped from the branding/bootstrap
+  types. Theme color is now the hardcoded base token `--fs-color-brand: #6366f1`;
+  fonts/radius/density are editable template CSS. Light/dark mode + the
+  `variables` escape hatch are unchanged.
+
+### Added
+
+- `<CodeGroup>` component: a tabbed code block container for the docs surface.
+- Open-languages docs boot: the SDK now accepts and forwards an
+  `openLanguages` hint to the docs primitives so the builder's configured
+  language tabs open on first load.
+- `docsEnabled` boot bit: bootstrapped `Business` now carries a `docsEnabled`
+  flag; the docs surface renders only when this is `true`.
+
+## [0.8.7] - 2026-06-28
+
+### Fixed
+
+- Best-effort authenticated reads (`/me/*` etc.) no longer trip the
+  `onUnauthorized` redirect on a transient 401: a `recoverAuth` transport flag
+  lets those reads fail soft instead of bouncing the portal through sign-in
+  (fixes the dev-portal `/docs` auth loop).
 
 ## [0.8.6] - 2026-06-28