@farthershore/farthershore-js 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to `@farthershore/farthershore-js` are documented here.
+This project adheres to Semantic Versioning (pre-1.0: minors may break).
+
+## [Unreleased]
+
+## [0.1.1] - 2026-06-09
+
+### Added
+
+- `createServerClient()` — a documented SSR/server entry point (explicit `portalHost` + injectable `fetch` + per-request `getToken`; no `window`/`location` assumption).
+- Request cancellation: the read methods (`auth.getSession`, `keys.list`, `usage.*`, `billing.subscription`/`creditBalance`) accept `{ signal }`, and the React hooks abort the in-flight request on unmount / dep-change.
+- `FartherShoreAbortError` — mapped from a fetch `AbortError`; ignored by the hooks (a cancelled read is never a user-facing error).
+- `FartherShoreConfigError` for construction/misconfiguration; an ESLint guard on `src/**` ensures every failure stays a typed `FartherShore*` error.
+- Contract **drift-detection** test that guards the SDK's mapped shapes against `@farthershore/contracts` (compile-time + runtime), plus exhaustive unit coverage (35 → 65 tests) and a tree-shaking verification test.
+- Docs: Getting Started, Versioning & stability sections, and this CHANGELOG.
+
+## [0.1.0] - 2026-06-08
+
+### Added
+
+- Initial public release: a framework-agnostic client + `/react` hooks + `catalog.ts` display helpers; the `auth` (Clerk `setToken` + persona `signIn`), `keys`, `usage`, `billing`, `plans`, `product`, and Gateway `feature()` resources. ESM, tree-shakeable (`sideEffects: false`), with the domain types re-exported from the `/react` subpath.

package/README.md

@@ -4,11 +4,16 @@ The **Farther Shore Frontend SDK** — the canonical browser integration layer
 between a static frontend artifact (the default dev-portal template, generated
 frontends, managed components, custom frontends) and the Farther Shore platform.
 
-> **Internal & experimental.** Not published to npm yet (`private: true`).
-> Breaking changes are expected while we validate the API against the dev portal,
-> managed components, and a real builder-defined feature. The eventual public
-> name is `@farthershore/farthershore-js` (the `@stripe/stripe-js` analog to the
-> server-side `@farthershore/sdk`).
+> **Status: `0.1.0` (early release).** Published to npm. Pre-1.0, so minor
+> versions may include breaking changes while the API stabilizes against the dev
+> portal, managed template, and real builder features. See [`PUBLISHING.md`](./PUBLISHING.md)
+> for the gates to `1.0.0` (wire-contract lock, browser token exchange, gateway
+> CORS, stage e2e). The `@stripe/stripe-js` analog to the server-side
+> `@farthershore/sdk`.
+
+```bash
+pnpm add @farthershore/farthershore-js   # React is an optional peer (for /react)
+```
 
 ## Philosophy
 
@@ -31,6 +36,45 @@ The SDK decides **where** each request goes (Core for platform concerns, the
 Gateway for builder features), **how** it's authenticated, and the host/env
 scoping headers Core needs.
 
+## Getting started
+
+```bash
+pnpm add @farthershore/farthershore-js
+```
+
+```ts
+import { createFartherShoreClient } from "@farthershore/farthershore-js";
+
+// 1. Create the client. In the browser, `coreUrl` is usually the only required
+//    field — `portalHost` defaults to `window.location.host`.
+const fs = createFartherShoreClient({
+  coreUrl: "https://core.farthershore.com",
+});
+
+// 2. Discover the product/env/plans for this host (memoized; safe to re-call).
+const { product, plans } = await fs.bootstrap();
+
+// 3. Authenticate. In a preview/test env, exchange a persona access key for a
+//    session (Clerk envs instead pass `getToken` to the config / `setToken`).
+await fs.auth.signIn({ apiKey: "fsk_test_…" });
+
+// 4. Read platform state through the typed resources (→ Core).
+const keys = await fs.keys.list(); // ApiKey[]
+const usage = await fs.usage.snapshot(); // { summary, events, billingBasis }
+
+// 5. Call a builder-defined feature (→ Gateway). Set the consumer API key once,
+//    then express intent by feature name + path — no Gateway URL in app code.
+fs.setApiKey("fsk_live_…");
+const forecast = await fs.feature("weather").json("/forecast?city=NYC");
+```
+
+In React, the same calls are hooks that return `{ data, loading, error, refresh }`
+(plus mutations) — see [React](#react-farthershorefarthershore-jsreact) below:
+
+```tsx
+const { data, loading, error, refresh } = useApiKeys();
+```
+
 ## Surface
 
 | Namespace                              | Routes to             | Methods                                                                 |
@@ -41,6 +85,7 @@ scoping headers Core needs.
 | `fs.keys`                              | Core                  | `list()`, `create()`, `revoke()`, `rotate()`                            |
 | `fs.usage`                             | Core                  | `summary()`, `events()`, `snapshot()`                                   |
 | `fs.billing`                           | Core                  | `subscription()`, `openBillingPortal()`, `creditBalance()`             |
+| `fs.plans`                             | Core / (bootstrap)    | `list()`, `subscribe()`                                                 |
 | `fs.feature(name)` / `fs.invoke(path)` | **Gateway**           | `fetch(path)`, `json(path)`                                             |
 
 ## Auth
@@ -71,6 +116,29 @@ createFartherShoreClient({
 });
 ```
 
+## SSR / server usage
+
+On a server there is no `window`/`location` to infer the portal host from and no
+ambient browser session — so use `createServerClient`, a documented alias for
+`createFartherShoreClient` that makes that contract explicit. Pass `portalHost`
+and `fetch` instead of relying on globals, and resolve the per-request session
+via `getToken` (each request authenticates as a different user). Behaviour is
+identical to the browser client — the config already guards `globalThis.location`
+and requires an injectable `fetch` — so this is purely a discoverable entry point.
+
+```ts
+import { createServerClient } from "@farthershore/farthershore-js";
+
+const fs = createServerClient({
+  coreUrl: process.env.FS_CORE_URL!,
+  portalHost: "weather.farthershore.com", // no window.location on the server
+  getToken: () => sessionTokenForThisRequest, // per-request bearer
+  fetch, // Node 18+ global, or an injected impl
+});
+
+const sub = await fs.billing.subscription();
+```
+
 ## React (`@farthershore/farthershore-js/react`)
 
 The hooks live in a **subpath** of the same package — `react` is an _optional_
@@ -117,6 +185,28 @@ client. They're thin wrappers over the client — no duplicated logic.
 - A browser-safe **short-lived gateway token** (vs. a long-lived `fsk_` key in the
   page) — the platform's `fsc_` context token is server-minted today.
 
+## Versioning & stability
+
+This package is **pre-1.0 (`0.x`)**. Under SemVer's 0.x rules a **minor** bump
+(`0.1.x` → `0.2.0`) may include **breaking changes**, so the usual caret range is
+unsafe here:
+
+- ❌ `^0.1` / `^0.1.0` — caret does **not** lock the minor across `0.x`; it would
+  silently accept a breaking `0.2.0`.
+- ✅ Pin **exact** (`0.1.0`) or use a patch-only tilde (`~0.1.0`) until `1.0.0`.
+
+Breaking changes within `0.x` are recorded in [`CHANGELOG.md`](./CHANGELOG.md)
+(Keep a Changelog format) — read it before bumping.
+
+**Path to `1.0.0`:** the API graduates to a stable major once the
+[`PUBLISHING.md`](./PUBLISHING.md) gates clear — wire-contract lock (generated
+from / pinned to `@farthershore/contracts`), the browser-safe gateway token
+exchange, gateway CORS for product origins, and a live-stage e2e. At `1.0.0`,
+caret ranges become safe again.
+
+The `/react` subpath ships in the same package and version; **`react` is an
+_optional_ peer dependency**, so non-React consumers never pull it in.
+
 ## Scripts
 
 ```bash

package/dist/client.d.ts

@@ -6,8 +6,9 @@ import { type KeysResource } from "./resources/keys.js";
 import { type UsageResource } from "./resources/usage.js";
 import { type BillingResource } from "./resources/billing.js";
 import { type PlansResource } from "./resources/plans.js";
+import { type AuditLogsResource, type OrganizationsResource, type TeamResource } from "./resources/account.js";
 import { type FeatureHandle, type GatewayRequestInit } from "./resources/feature.js";
-import type { Bootstrap } from "./types.js";
+import type { Bootstrap, SubscriberContext } from "./types.js";
 export interface FartherShoreClient {
     /** Resolve + cache the product/env/gateway for the current portal host. Safe
      *  to call repeatedly (memoized). */
@@ -16,13 +17,38 @@ export interface FartherShoreClient {
     setApiKey(key: string | null): void;
     /** Set the Core session bearer directly (e.g. from the Clerk browser SDK). */
     setSessionToken(token: string | null): void;
+    /** Install/replace a live token source resolved per request (short-lived
+     *  Clerk JWTs). `<FartherShoreRoot>` wires this automatically in Clerk
+     *  environments; pass null to uninstall. */
+    setTokenProvider(provider: (() => string | null | Promise<string | null>) | null): void;
+    /** Rescope subsequent Core calls to an owning org (the multi-org
+     *  subscription-context switcher) — sets the `x-fs-organization-id` header.
+     *  Pass null to return to the user's default subscription. */
+    setOrganizationId(organizationId: string | null): void;
+    /** The product this frontend runs for (resolved via bootstrap). */
     readonly product: ProductResource;
+    /** Consumer session: persona/Clerk sign-in, the current session, sign-out. */
     readonly auth: AuthResource;
+    /** The consumer's API keys (list / create / revoke / rotate). */
     readonly keys: KeysResource;
+    /** Per-dimension usage totals + recent events for this product. */
     readonly usage: UsageResource;
+    /** The consumer's subscription, the Stripe billing portal, and credit balance. */
     readonly billing: BillingResource;
     /** The product's plan catalog + the subscribe/checkout flow. */
     readonly plans: PlansResource;
+    /** Full subscriber context (`GET /me`): lifecycle, trial, scheduled
+     *  transition, eligibility-scoped plans. Null when signed out / no
+     *  subscriber. */
+    me(opts?: {
+        signal?: AbortSignal;
+    }): Promise<SubscriberContext | null>;
+    /** Multi-org subscription contexts (the org switcher's data). */
+    readonly organizations: OrganizationsResource;
+    /** Team management on the current subscription. */
+    readonly team: TeamResource;
+    /** The subscriber-side audit log (cursor-paged). */
+    readonly auditLogs: AuditLogsResource;
     /** A handle to a builder-defined feature, routed through the Gateway. */
     feature(name: string): FeatureHandle;
     /** Generic Gateway call (alias for `feature("…").fetch`). */
@@ -38,5 +64,51 @@ export interface FartherShoreClient {
      */
     core<T>(req: CoreRequest): Promise<T>;
 }
+/**
+ * SSR / server-side entry point. A thin, documented alias for
+ * {@link createFartherShoreClient} that makes the server contract explicit:
+ * there is **no `window`/`location`** to fall back on, so a server caller must
+ * supply what the browser would otherwise provide implicitly —
+ *
+ * - `portalHost` — the product/env host (no `globalThis.location.host` default
+ *   exists on the server);
+ * - `fetch` — an injectable fetch (the platform doesn't assume a global one);
+ * - `getToken` — the per-request session bearer (each request authenticates as a
+ *   different user, so resolve the token per call rather than via the browser's
+ *   ambient session).
+ *
+ * Behaviour is identical to {@link createFartherShoreClient} — `buildContext`
+ * already guards `globalThis.location` and requires an injectable `fetch` — so
+ * this adds no runtime behaviour; it's a discoverable, self-documenting entry
+ * point for SSR/server usage.
+ *
+ * @example
+ * ```ts
+ * const fs = createServerClient({
+ *   coreUrl: process.env.FS_CORE_URL!,
+ *   portalHost: "weather.farthershore.com",
+ *   getToken: () => sessionTokenForThisRequest,
+ *   fetch, // Node 18+ global, or an injected impl
+ * });
+ * const sub = await fs.billing.subscription();
+ * ```
+ */
+export declare function createServerClient(config: FartherShoreConfig): FartherShoreClient;
+/**
+ * Create a {@link FartherShoreClient}. In the browser the minimal config is
+ * `{ coreUrl }` — the platform Core base URL; `portalHost` defaults to
+ * `window.location.host` and the product is discovered at {@link
+ * FartherShoreClient.bootstrap}. The returned client owns all routing (Core vs
+ * Gateway), auth, and host/env scoping; app code only expresses intent via its
+ * typed resources (`fs.usage`, `fs.keys`, `fs.feature(…)`, …). For SSR/server
+ * use, prefer {@link createServerClient}.
+ *
+ * @example
+ * ```ts
+ * const fs = createFartherShoreClient({ coreUrl: "https://core.farthershore.com" });
+ * const { product } = await fs.bootstrap();
+ * const keys = await fs.keys.list();
+ * ```
+ */
 export declare function createFartherShoreClient(config: FartherShoreConfig): FartherShoreClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC;yCACqC;IACrC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,+DAA+D;IAC/D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,8EAA8E;IAC9E,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAE5C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAE9B,yEAAyE;IACzE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACrC,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnE;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvC;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,GACzB,kBAAkB,CAwCpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -6,14 +6,66 @@ import { buildContext, } from "./config.js";
 import { resolveBootstrap } from "./bootstrap.js";
 import { coreFetch, gatewayFetch } from "./http.js";
 import { createProductResource, } from "./resources/product.js";
-import { createAuthResource } from "./resources/auth.js";
+import { createAuthResource, primePersistedPersona, } from "./resources/auth.js";
 import { createKeysResource } from "./resources/keys.js";
 import { createUsageResource } from "./resources/usage.js";
 import { createBillingResource, } from "./resources/billing.js";
 import { createPlansResource } from "./resources/plans.js";
+import { createAccountSurface, } from "./resources/account.js";
 import { createFeature, } from "./resources/feature.js";
+/**
+ * SSR / server-side entry point. A thin, documented alias for
+ * {@link createFartherShoreClient} that makes the server contract explicit:
+ * there is **no `window`/`location`** to fall back on, so a server caller must
+ * supply what the browser would otherwise provide implicitly —
+ *
+ * - `portalHost` — the product/env host (no `globalThis.location.host` default
+ *   exists on the server);
+ * - `fetch` — an injectable fetch (the platform doesn't assume a global one);
+ * - `getToken` — the per-request session bearer (each request authenticates as a
+ *   different user, so resolve the token per call rather than via the browser's
+ *   ambient session).
+ *
+ * Behaviour is identical to {@link createFartherShoreClient} — `buildContext`
+ * already guards `globalThis.location` and requires an injectable `fetch` — so
+ * this adds no runtime behaviour; it's a discoverable, self-documenting entry
+ * point for SSR/server usage.
+ *
+ * @example
+ * ```ts
+ * const fs = createServerClient({
+ *   coreUrl: process.env.FS_CORE_URL!,
+ *   portalHost: "weather.farthershore.com",
+ *   getToken: () => sessionTokenForThisRequest,
+ *   fetch, // Node 18+ global, or an injected impl
+ * });
+ * const sub = await fs.billing.subscription();
+ * ```
+ */
+export function createServerClient(config) {
+    return createFartherShoreClient(config);
+}
+/**
+ * Create a {@link FartherShoreClient}. In the browser the minimal config is
+ * `{ coreUrl }` — the platform Core base URL; `portalHost` defaults to
+ * `window.location.host` and the product is discovered at {@link
+ * FartherShoreClient.bootstrap}. The returned client owns all routing (Core vs
+ * Gateway), auth, and host/env scoping; app code only expresses intent via its
+ * typed resources (`fs.usage`, `fs.keys`, `fs.feature(…)`, …). For SSR/server
+ * use, prefer {@link createServerClient}.
+ *
+ * @example
+ * ```ts
+ * const fs = createFartherShoreClient({ coreUrl: "https://core.farthershore.com" });
+ * const { product } = await fs.bootstrap();
+ * const keys = await fs.keys.list();
+ * ```
+ */
 export function createFartherShoreClient(config) {
     const ctx = buildContext(config);
+    // Self-managed persona sessions: restore a persisted (unexpired) session so
+    // reloads stay signed in without any host wiring. No-op outside the browser.
+    primePersistedPersona(ctx);
     let cached = null;
     let inflight = null;
     function ensureBootstrap() {
@@ -33,6 +85,7 @@ export function createFartherShoreClient(config) {
         }
         return inflight;
     }
+    const account = createAccountSurface(ctx);
     return {
         bootstrap: ensureBootstrap,
         setApiKey(key) {
@@ -41,12 +94,22 @@ export function createFartherShoreClient(config) {
         setSessionToken(token) {
             ctx.sessionToken = token;
         },
+        setTokenProvider(provider) {
+            ctx.tokenProvider = provider;
+        },
+        setOrganizationId(organizationId) {
+            ctx.organizationId = organizationId;
+        },
         product: createProductResource(ensureBootstrap),
         auth: createAuthResource(ctx),
         keys: createKeysResource(ctx),
         usage: createUsageResource(ctx),
         billing: createBillingResource(ctx),
         plans: createPlansResource(ctx, ensureBootstrap),
+        me: account.me,
+        organizations: account.organizations,
+        team: account.team,
+        auditLogs: account.auditLogs,
         feature: (name) => createFeature(ctx, name),
         invoke: (path, init) => gatewayFetch(ctx, path, init),
         core: (req) => coreFetch(ctx, req),

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,+EAA+E;AAC/E,sCAAsC;AAEtC,OAAO,EAGL,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,qBAAqB,GAEtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,aAAa,GAGd,MAAM,wBAAwB,CAAC;AAoChC,MAAM,UAAU,wBAAwB,CACtC,MAA0B;IAE1B,MAAM,GAAG,GAAkB,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAA8B,IAAI,CAAC;IAC/C,SAAS,eAAe;QACtB,IAAI,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC;iBAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,MAAM,GAAG,CAAC,CAAC;gBACX,QAAQ,GAAG,IAAI,CAAC;gBAChB,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;gBACpB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,eAAe;QAC1B,SAAS,CAAC,GAAG;YACX,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QACnB,CAAC;QACD,eAAe,CAAC,KAAK;YACnB,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,qBAAqB,CAAC,eAAe,CAAC;QAC/C,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAC7B,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC;QAC7B,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC;QAC/B,OAAO,EAAE,qBAAqB,CAAC,GAAG,CAAC;QACnC,KAAK,EAAE,mBAAmB,CAAC,GAAG,EAAE,eAAe,CAAC;QAChD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC;QAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;QACrD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;KACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/components/_internal.d.ts

@@ -0,0 +1,8 @@
+/** Join class names, skipping falsy — the host-extension contract: every
+ *  public component accepts `className` and appends it to its root. */
+export declare function cx(...parts: Array<string | null | undefined | false>): string;
+export declare function ArrowIcon(): import("react/jsx-runtime").JSX.Element;
+export declare function CheckIcon({ className }: {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=_internal.d.ts.map

package/dist/components/_internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_internal.d.ts","sourceRoot":"","sources":["../../src/components/_internal.tsx"],"names":[],"mappings":"AAIA;uEACuE;AACvE,wBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,GAAG,MAAM,CAE7E;AAED,wBAAgB,SAAS,4CAMxB;AAED,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,2CAM9D"}

package/dist/components/_internal.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Internal shared bits for the components package — NOT exported from the
+// package. Public components live one-per-file; this holds the tiny pieces
+// several of them share.
+/** Join class names, skipping falsy — the host-extension contract: every
+ *  public component accepts `className` and appends it to its root. */
+export function cx(...parts) {
+    return parts.filter(Boolean).join(" ");
+}
+export function ArrowIcon() {
+    return (_jsx("svg", { className: "fs-btn__arrow", fill: "none", viewBox: "0 0 24 24", strokeWidth: 2.5, stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M13.5 4.5L21 12m0 0l-7.5 7.5M21 12H3" }) }));
+}
+export function CheckIcon({ className }) {
+    return (_jsx("svg", { className: className, fill: "none", viewBox: "0 0 24 24", strokeWidth: 2.5, stroke: "currentColor", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", d: "M4.5 12.75l6 6 9-13.5" }) }));
+}
+//# sourceMappingURL=_internal.js.map

package/dist/components/_internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_internal.js","sourceRoot":"","sources":["../../src/components/_internal.tsx"],"names":[],"mappings":";AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,yBAAyB;AAEzB;uEACuE;AACvE,MAAM,UAAU,EAAE,CAAC,GAAG,KAA+C;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CACL,cAAK,SAAS,EAAC,eAAe,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,EAAC,WAAW,EAAC,WAAW,EAAE,GAAG,EAAE,MAAM,EAAC,cAAc,YACpG,eAAM,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,CAAC,EAAC,sCAAsC,GAAG,GAC1F,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAE,SAAS,EAA0B;IAC7D,OAAO,CACL,cAAK,SAAS,EAAE,SAAS,EAAE,IAAI,EAAC,MAAM,EAAC,OAAO,EAAC,WAAW,EAAC,WAAW,EAAE,GAAG,EAAE,MAAM,EAAC,cAAc,YAChG,eAAM,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,CAAC,EAAC,uBAAuB,GAAG,GAC3E,CACP,CAAC;AACJ,CAAC"}

package/dist/components/app.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from "react";
+import type { Bootstrap } from "../types.js";
+import { type FsAppearance } from "./theme.js";
+import { type FsClerkConfig } from "./auth.js";
+/**
+ * The entire portal in one tag. Resolves the product, mounts theme + managed
+ * auth, and renders the marketing landing (signed-out) or the account
+ * dashboard (signed-in). Pass `appearance` to retheme; drop to the standalone
+ * components for custom layouts.
+ *
+ * `renderDashboard` is the chrome escape hatch: when authenticated, the app
+ * renders this instead of the built-in card stack (the default template
+ * supplies its full sidebar app shell this way), still inside the resolved
+ * bootstrap + theme + auth context.
+ */
+export declare function FartherShoreApp({ appearance, clerk, renderDashboard, }: {
+    appearance?: FsAppearance;
+    /** Clerk connection config (public values) for clerk-strategy environments. */
+    clerk?: FsClerkConfig;
+    renderDashboard?: (boot: Bootstrap) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** The landing's pricing section: heading chrome around the standalone
+ *  `<PlansTable/>`. */
+export declare function FsPricing({ className }?: {
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=app.d.ts.map

package/dist/components/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/components/app.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAa/D;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,KAAK,EACL,eAAe,GAChB,EAAE;IACD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,SAAS,CAAC;CAClD,2CAoBA;AAyKD;uBACuB;AACvB,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,2CAWnE"}

package/dist/components/app.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useBootstrap, useSession } from "../react/index.js";
+import { FsThemeProvider } from "./theme.js";
+import { FsAuthProvider } from "./auth.js";
+import { PlansTable } from "./plans-table.js";
+import { FsSignIn } from "./sign-in.js";
+import { FsBranding, FsThemeToggle, FsFooter } from "./chrome.js";
+import { ApiKeysPanel } from "./keys.js";
+import { UsageCard } from "./usage.js";
+import { BillingSummary } from "./billing.js";
+import { CreditBalance } from "./credit.js";
+import { DocsLegal } from "./docs.js";
+import { ArrowIcon } from "./_internal.js";
+/* ── Composite ─────────────────────────────────────────────────── */
+/**
+ * The entire portal in one tag. Resolves the product, mounts theme + managed
+ * auth, and renders the marketing landing (signed-out) or the account
+ * dashboard (signed-in). Pass `appearance` to retheme; drop to the standalone
+ * components for custom layouts.
+ *
+ * `renderDashboard` is the chrome escape hatch: when authenticated, the app
+ * renders this instead of the built-in card stack (the default template
+ * supplies its full sidebar app shell this way), still inside the resolved
+ * bootstrap + theme + auth context.
+ */
+export function FartherShoreApp({ appearance, clerk, renderDashboard, }) {
+    const boot = useBootstrap();
+    if (boot.loading)
+        return _jsx(FsSplash, { label: "Loading\u2026" });
+    if (boot.error || !boot.data) {
+        return _jsx(FsSplash, { label: boot.error?.message ?? "Portal unavailable" });
+    }
+    const merged = {
+        brandColor: boot.data.branding.primaryColor ?? undefined,
+        ...appearance,
+    };
+    return (_jsx(FsThemeProvider, { appearance: merged, children: _jsx(FsAuthProvider, { strategy: boot.data.environment?.authStrategy ?? "clerk", clerk: clerk, children: _jsx(AppBody, { boot: boot.data, renderDashboard: renderDashboard }) }) }));
+}
+function AppBody({ boot, renderDashboard, }) {
+    const session = useSession();
+    const authenticated = Boolean(session.data?.authenticated);
+    if (!authenticated) {
+        return (_jsxs("main", { className: "fs-anim-in", children: [_jsx(FsHeader, {}), _jsx(FsHero, { boot: boot }), _jsx(FsPricing, {}), _jsx(FsSignIn, { onSignedIn: session.refresh }), _jsx(FsBottomCta, {}), _jsx(FsFooter, { boot: boot })] }));
+    }
+    if (renderDashboard)
+        return _jsx(_Fragment, { children: renderDashboard(boot) });
+    return _jsx(FsDefaultDashboard, { boot: boot, onSignOut: () => void session.signOut() });
+}
+/** The built-in signed-in view: a centered stack of the standalone data
+ *  components. Used when no `renderDashboard` is supplied. */
+function FsDefaultDashboard({ boot, onSignOut }) {
+    return (_jsxs("main", { className: "fs-anim-in", children: [_jsx(FsHeader, { authenticated: true, onSignOut: onSignOut }), _jsxs("div", { className: "fs-container", style: { padding: "32px 24px", display: "flex", flexDirection: "column", gap: 18 }, children: [_jsxs("div", { children: [_jsx("h1", { style: { fontSize: 30, fontWeight: 300, letterSpacing: "-0.02em", margin: 0 }, children: boot.branding.displayName }), _jsx("p", { className: "fs-muted", style: { marginTop: 4, fontSize: 14 }, children: "Your account" })] }), _jsx(ApiKeysPanel, {}), _jsx(UsageCard, {}), _jsx(BillingSummary, {}), _jsx(CreditBalance, {}), _jsx(DocsLegal, {})] }), _jsx(FsFooter, { boot: boot })] }));
+}
+/* ── Composite-private sections ────────────────────────────────── */
+function FsHeader({ authenticated, onSignOut, }) {
+    return (_jsx("header", { className: "fs-header", children: _jsxs("div", { className: "fs-header__inner", children: [_jsx(FsBranding, {}), _jsxs("nav", { className: "fs-header__nav", children: [!authenticated && (_jsx("a", { href: "#pricing", className: "fs-btn fs-btn--ghost fs-btn--sm", children: "Pricing" })), _jsx(FsThemeToggle, {}), authenticated ? (_jsx("button", { className: "fs-btn fs-btn--outline fs-btn--sm", onClick: onSignOut, children: "Sign out" })) : (_jsx("a", { href: "#signin", className: "fs-btn fs-btn--cta fs-btn--sm", children: "Sign in" }))] })] }) }));
+}
+function FsHero({ boot }) {
+    const brand = boot.branding;
+    const product = boot.product;
+    const authHeaderName = product.authHeaderName ?? "x-api-key";
+    const baseUrl = product.runtimeHostname
+        ? `https://${product.runtimeHostname}`
+        : "https://api.example.com";
+    return (_jsxs("section", { className: "fs-hero", children: [_jsx("div", { className: "fs-hero__glow" }), _jsxs("div", { className: "fs-hero__grid", children: [_jsxs("div", { style: { textAlign: "left" }, children: [_jsxs("span", { className: "fs-hero__pill", children: [_jsx("span", { className: "fs-dot fs-dot--pulse" }), "API Available"] }), _jsx("h1", { className: "fs-hero__title", children: brand.displayName }), _jsx("p", { className: "fs-hero__sub", children: brand.description ||
+                                    "Build powerful integrations with our API. Get your key and start making requests in minutes." }), _jsxs("div", { className: "fs-hero__actions", children: [_jsxs("a", { href: "#pricing", className: "fs-btn fs-btn--cta", children: ["Start Building Free", _jsx(ArrowIcon, {})] }), _jsx("a", { href: "#pricing", className: "fs-btn fs-btn--outline", children: "See Pricing" })] })] }), _jsx(FsCodeSample, { baseUrl: baseUrl, authHeaderName: authHeaderName })] })] }));
+}
+function FsCodeSample({ baseUrl, authHeaderName }) {
+    const name = authHeaderName.trim() || "x-api-key";
+    const value = name.toLowerCase() === "authorization" ? "Bearer fsk_..." : "fsk_...";
+    return (_jsxs("div", { className: "fs-code", children: [_jsxs("div", { className: "fs-code__bar", children: [_jsx("span", { className: "fs-code__dot" }), _jsx("span", { className: "fs-code__dot" }), _jsx("span", { className: "fs-code__dot" }), _jsx("span", { className: "fs-code__name", children: "quickstart.sh" })] }), _jsxs("pre", { className: "fs-code__body", children: [_jsx("span", { className: "fs-code__c", children: "# Make your first request" }), "\n", _jsx("span", { className: "fs-code__ok", children: "$" }), " ", _jsx("span", { className: "fs-code__m", children: `curl ${baseUrl}/v1/hello` }), "\n  ", _jsx("span", { className: "fs-code__m", children: `-H "${name}: ${value}"` }), "\n\n", _jsx("span", { className: "fs-code__c", children: "// Response" }), "\n", _jsx("span", { className: "fs-code__c", children: "{" }), "\n  ", _jsx("span", { className: "fs-code__m", children: "\"status\": " }), _jsx("span", { className: "fs-code__ok", children: "\"ok\"" }), _jsx("span", { className: "fs-code__c", children: "," }), "\n  ", _jsx("span", { className: "fs-code__m", children: "\"message\": " }), _jsx("span", { className: "fs-code__warn", children: "\"Hello, developer!\"" }), "\n", _jsx("span", { className: "fs-code__c", children: "}" })] })] }));
+}
+/** The landing's pricing section: heading chrome around the standalone
+ *  `<PlansTable/>`. */
+export function FsPricing({ className } = {}) {
+    return (_jsxs("section", { id: "pricing", className: "fs-section fs-section--surface" + (className ? ` ${className}` : ""), children: [_jsxs("div", { className: "fs-section__head", children: [_jsx("p", { className: "fs-eyebrow", children: "Pricing" }), _jsx("h2", { className: "fs-section__title", children: "Simple, transparent pricing" }), _jsx("p", { className: "fs-section__sub", children: "Start free. Scale as you grow. No hidden fees." })] }), _jsx(PlansTable, {})] }));
+}
+function FsBottomCta() {
+    return (_jsx("section", { className: "fs-section", children: _jsxs("div", { className: "fs-cta", children: [_jsx("h2", { className: "fs-section__title", children: "Ready to get started?" }), _jsx("p", { className: "fs-section__sub", style: { fontSize: 16 }, children: "Create your free account and start making API calls in under a minute." }), _jsx("div", { style: { marginTop: 32 }, children: _jsxs("a", { href: "#signin", className: "fs-btn fs-btn--cta", style: { padding: "0 40px" }, children: ["Create Free Account", _jsx(ArrowIcon, {})] }) })] }) }));
+}
+function FsSplash({ label }) {
+    return _jsx("div", { className: "fs-app fs-splash", children: label });
+}
+//# sourceMappingURL=app.js.map

package/dist/components/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/components/app.tsx"],"names":[],"mappings":"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"}

package/dist/components/auth.d.ts

@@ -0,0 +1,66 @@
+import { type ReactNode } from "react";
+import type { AuthStrategy } from "../types.js";
+/** Clerk connection config — public values, baked per environment (e.g. from
+ *  VITE_CLERK_* vars). `satelliteDomain` defaults to the current host minus its
+ *  first label (`aurora.farthershore.io` → `farthershore.io`). Satellite mode
+ *  engages only when the full trio resolves; otherwise single-domain Clerk. */
+export interface FsClerkConfig {
+    publishableKey: string;
+    signInUrl?: string;
+    satelliteDomain?: string;
+}
+export interface FsAuth {
+    strategy: AuthStrategy;
+    /** False while auth is initializing (Clerk JS loading / first session read). */
+    loaded: boolean;
+    signedIn: boolean;
+    /** Clerk → redirect to the primary hosted sign-in (returning here);
+     *  persona → no-op (render a persona sign-in form via `useSession().signIn`). */
+    signIn(): void;
+    signOut(): Promise<void>;
+    /** Clerk user object (or the persisted persona view user), when signed in. */
+    user: unknown;
+    /** Re-read the session (persona only; Clerk pushes its own state). */
+    refresh(): void;
+}
+export declare function useFsAuth(): FsAuth;
+/** Like {@link useFsAuth} but null outside the managed auth layer — lets
+ *  components degrade instead of throwing when mounted without a Root. */
+export declare function useOptionalFsAuth(): FsAuth | null;
+/** Renders children only when a user is signed in. */
+export declare function SignedIn({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** Renders children only when signed out (and auth has finished loading —
+ *  nothing flashes during init). */
+export declare function SignedOut({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** Renders children only while the auth layer is initializing. */
+export declare function AuthLoading({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+/** A managed sign-in button: Clerk → redirect to the primary-domain hosted
+ *  sign-in (returning to the current page); persona → scrolls to the sign-in
+ *  form. Style with className (defaults to the SDK CTA button). */
+export declare function FsSignInButton({ className, children, }: {
+    className?: string;
+    children?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** A managed sign-out button (any strategy). */
+export declare function FsSignOutButton({ className, children, }: {
+    className?: string;
+    children?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** The managed auth layer — mounted by `<FartherShoreRoot>`; mountable directly
+ *  by custom roots. Picks the implementation from the environment's strategy. */
+export declare function FsAuthProvider({ strategy, clerk, children, }: {
+    strategy: AuthStrategy;
+    clerk?: FsClerkConfig;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** The signed-in account control. Clerk mode → Clerk's <UserButton/> (avatar
+ *  menu with manage-account + sign-out) behind a loading skeleton; persona
+ *  mode → null (persona chrome is host-routed — render your own pill). */
+export declare function FsUserButton(): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=auth.d.ts.map

package/dist/components/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/components/auth.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;;+EAG+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB;qFACiF;IACjF,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,8EAA8E;IAC9E,IAAI,EAAE,OAAO,CAAC;IACd,sEAAsE;IACtE,OAAO,IAAI,IAAI,CAAC;CACjB;AAID,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AAED;0EAC0E;AAC1E,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD;AAID,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,kDAG7D;AAED;oCACoC;AACpC,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,kDAG9D;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,kDAGhE;AAED;;mEAEmE;AACnE,wBAAgB,cAAc,CAAC,EAC7B,SAA2C,EAC3C,QAAoB,GACrB,EAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,2CAOA;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,EAC9B,SAA+C,EAC/C,QAAqB,GACtB,EAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,2CAOA;AAoPD;iFACiF;AACjF,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAK,EACL,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB,2CAWA;AAID;;0EAE0E;AAC1E,wBAAgB,YAAY,mDA0B3B"}